planet.commonapi.factory
Interface ApplicationFactory

All Known Implementing Classes:
ApplicationFactoryImpl

public interface ApplicationFactory

This interface abstracts the task of generate new instances of Application, using the factory method design pattern.

Any future implementation must contain the no argument constructor.

Author:
Jordi Pujol 07-jul-2005
See Also:
Application

Method Summary
 Application buildApplication()
          Generates a new instance of the actual Application class.
 Application buildApplication(java.lang.String app)
          Generates a new instance of the Application class app.
 Application buildApplicationWithName(java.lang.String name)
          Generates a new instance of the actual Application class.
 Application buildApplicationWithName(java.lang.String app, java.lang.String name)
          Generates a new instance of the Application class app.
 ApplicationFactory setValues(java.lang.Class application)
          Initializes the ApplicationFactory with the specified values.
 

Method Detail

setValues

public ApplicationFactory setValues(java.lang.Class application)
                             throws InitializationException
Initializes the ApplicationFactory with the specified values.

Parameters:
application - Related Class instance for the current Application in use.
Returns:
The same instance once it has been updated.
Throws:
InitializationException - if any error occurs during the initialization process.

buildApplication

public Application buildApplication()
                             throws InitializationException
Generates a new instance of the actual Application class. The name of Application is setting the default one by its implementation.

Returns:
A new instance of the Application
Throws:
InitializationException
See Also:
Application

buildApplication

public Application buildApplication(java.lang.String app)
                             throws InitializationException
Generates a new instance of the Application class app. This value must be an existing Application implementation. The Application's name is setting by the implementation owner.

Parameters:
app - Class completly defined of the Application to generate only by this method call.
Returns:
A new instance of Application. Its class is app
Throws:
InitializationException
See Also:
Application

buildApplicationWithName

public Application buildApplicationWithName(java.lang.String name)
                                     throws InitializationException
Generates a new instance of the actual Application class. The name of Application is overwriting by name.

Parameters:
name - Name for the application to generate.
Returns:
A new instance of the Application
Throws:
InitializationException
See Also:
Application

buildApplicationWithName

public Application buildApplicationWithName(java.lang.String app,
                                            java.lang.String name)
                                     throws InitializationException
Generates a new instance of the Application class app. This value must be an existing Application implementation. The name of Application is overwriting by name.

Parameters:
app - Class completly defined of the Application to generate only by this method call.
name - Name for the application to generate.
Returns:
A new instance of Application. Its class is app
Throws:
InitializationException
See Also:
Application