org.eclipse.jet.transform
Interface IJETBundleManager


public interface IJETBundleManager

Define the interface to the manager for loading/unloading and describing JET transform bundles.


Method Summary
 void connect(java.lang.String id, org.eclipse.core.runtime.IProgressMonitor monitor)
          Record a connection to the specified JET transform bundle.
 void disconnect(java.lang.String id)
          Record a disconnection fromt he specified JET transform bundle.
 IJETBundleDescriptor[] getAllJETBundleDescriptors()
          Return descriptions of all available JET transforms.
 java.lang.String[] getAllTransformIds()
          Return an array of transform available ids.
 IJETBundleDescriptor getDescriptor(java.lang.String id)
          Return the descriptor for a given JET transform.
 IJETBundleDescriptor getDescriptorForProject(java.lang.String name)
          Return the descriptor for the give JET project
 java.lang.String getProjectForId(java.lang.String id)
          Return the Workspace project name for the given JET transform id.
 JET2TemplateLoader getTemplateLoader(java.lang.String id)
          Return the JET2TemplateLoader instance for the specified JET Transform.
 void run(java.lang.String id, IJETRunnable runnable, org.eclipse.core.runtime.IProgressMonitor monitor)
          Load the specified JET transform, execute an IJETRunnable, and then ensure the transform is unloaded again.
 

Method Detail

getAllJETBundleDescriptors

IJETBundleDescriptor[] getAllJETBundleDescriptors()
Return descriptions of all available JET transforms.

Returns:
an possibily empty array.

getDescriptor

IJETBundleDescriptor getDescriptor(java.lang.String id)
Return the descriptor for a given JET transform.

Parameters:
id - the transform (plug-in) id.
Returns:
the descriptor or null.

getDescriptorForProject

IJETBundleDescriptor getDescriptorForProject(java.lang.String name)
Return the descriptor for the give JET project

Parameters:
name - the project name.
Returns:
the descriptor or null.

getProjectForId

java.lang.String getProjectForId(java.lang.String id)
Return the Workspace project name for the given JET transform id. If the transform does not reside in a Workspace project, then null is returned.

Parameters:
id - the transform id
Returns:
the project name or null.

run

void run(java.lang.String id,
         IJETRunnable runnable,
         org.eclipse.core.runtime.IProgressMonitor monitor)
         throws org.osgi.framework.BundleException
Load the specified JET transform, execute an IJETRunnable, and then ensure the transform is unloaded again.

Parameters:
id - the transform id
runnable - a runnable
monitor - a progress monitor
Throws:
org.osgi.framework.BundleException - TODO

connect

void connect(java.lang.String id,
             org.eclipse.core.runtime.IProgressMonitor monitor)
             throws org.osgi.framework.BundleException
Record a connection to the specified JET transform bundle. If this is the first connection, the bundle is loaded.

Parameters:
id - the transform id
monitor - a progress monitor
Throws:
org.osgi.framework.BundleException - TODO

disconnect

void disconnect(java.lang.String id)
Record a disconnection fromt he specified JET transform bundle. If this is the last connection, the bundle is unloaded.

Parameters:
id - the transform id

getTemplateLoader

JET2TemplateLoader getTemplateLoader(java.lang.String id)
                                     throws org.osgi.framework.BundleException
Return the JET2TemplateLoader instance for the specified JET Transform. A call to this method must be bracketed by calls to connect(String, IProgressMonitor) and disconnect(String).

Parameters:
id - the JET transform
Returns:
the template loader instance
Throws:
org.osgi.framework.BundleException - TODO

getAllTransformIds

java.lang.String[] getAllTransformIds()
Return an array of transform available ids.

Returns:
a possibly empty array of strings.

Copyright 2006 IBM Corporation and others.
All Rights Reserved.