IAsynchronousContentAdapter


1   /*******************************************************************************
2    * Copyright (c) 2005, 2006 IBM Corporation and others.
3    * All rights reserved. This program and the accompanying materials 
4    * are made available under the terms of the Eclipse Public License v1.0
5    * which accompanies this distribution, and is available at
6    * http://www.eclipse.org/legal/epl-v10.html
7    * 
8    * Contributors:
9    *     IBM Corporation - initial API and implementation
10   *******************************************************************************/
11  package org.eclipse.debug.internal.ui.viewers.provisional;
12  
13  import org.eclipse.debug.internal.ui.viewers.model.provisional.IPresentationContext;
14  
15  /**
16   * Provides content for elements in an asynchronous viewer. Note that implementations
17   * must provide content asynchronously. 
18   * <p>
19   * Clients may implement this interface.
20   * </p>
21   * @since 3.2
22   */
23  public interface IAsynchronousContentAdapter {
24  
25      /**
26       * Asynchronously retrieves the children of the given parent reporting to the
27       * given monitor. If unable to retrieve children, an exception should be reported
28       * to the monitor with an appropriate status.
29       * 
30       * @param parent the element to retrieve children for
31       * @param context the context in which children have been requested
32       * @param monitor request monitor to report children to
33       */
34      public void retrieveChildren(Object   parent, IPresentationContext context, IChildrenRequestMonitor result);
35      
36      /**
37       * Asynchronously determines whether the given element contains children in the specified
38       * context reporting the result to the given monitor. If unable to determine
39       * whether the element has children, an exception should be reported to the monitor
40       * with an appropriate status.
41       * 
42       * @param element the element on which children may exist 
43       * @param context the context in which children may exist
44       * @param monitor request monitor to report the result to
45       */
46      public void isContainer(Object   element, IPresentationContext context, IContainerRequestMonitor result);
47  
48  }
49
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags