er.extensions

Class ERXFrameworkPrincipal

java.lang.Object

er.extensions.ERXFrameworkPrincipal

Direct Known Subclasses:

Ajax, BTBusinessLogic, CayennePrincipal, ERAttachmentPrincipal, ERAttributeExtension, ERCaptchaPrincipal, ERCMail, ERCoreBusinessLogic, ERDirectToWeb, ERDistributionPrincipal, ERIndexing, ERJavaMail, ERJQMobile, ERJQueryMobile, ERPersistentSessionStorage, ERPlot, ERPrototypes, ERQSSchedulerServiceFrameworkPrincipal, ERSelenium, ERTaggablePrincipal, ERXExtensions, ERXiss, GCGoogleChart

public abstract class ERXFrameworkPrincipal
extends Object

Designated starter class for frameworks, adds support for dependency management.

Allows you to disregard your framework order in the class path (at least where startup is concerned, if you override actual classes you still need to take care.)

The initialize() method will be called directly after your principal is instantiated.
The finishInitialization() method will be called when the app finishes startup but before it will begin to process requests.

If you define

public static Class[] REQUIRES = Class[] {...}

all the classes (which must be assignable from this class) will get loaded before your principal.

NOTE: try to avoid putting code in static initializers. These may lead to unpredictable behaviour when launching. Use one of the methods above to do what you need to do.

Here is an example:

 public class ExampleFrameworkPrincipal extends ERXFrameworkPrincipal {
 
     public static final Logger log = Logger.getLogger(ExampleFrameworkPrincipal.class);
 
     protected static ExampleFrameworkPrincipal sharedInstance;
     
     public final static Class REQUIRES[] = new Class[] {ERXExtensions.class, ERDirectToWeb.class, ERJavaMail.class};
 
     // Registers the class as the framework principal
     static {
         setUpFrameworkPrincipalClass(ExampleFrameworkPrincipal.class);
     }
 
     public static ExampleFrameworkPrincipal sharedInstance() {
         if (sharedInstance == null) {
             sharedInstance = (ExampleFrameworkPrincipal)sharedInstance(ExampleFrameworkPrincipal.class);
         }
         return sharedInstance;
     }
 
     public void initialize() {
         // code during startup
     }
 
     public void finishInitialization() {
         // Initialized shared data
     }
 }

Finally, you also need to add an entry to your framework build.properties file to set the principal class:

 principalClass = com.sample.ExampleFrameworkPrincipal
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ERXFrameworkPrincipal.Observer

Field Summary

Fields

Modifier and Type	Field and Description
protected static NSMutableDictionary<String,ERXFrameworkPrincipal>	initializedFrameworks holds the mapping between framework principals classes and ERXFrameworkPrincipal objects
protected static NSMutableArray<ERXFrameworkPrincipal>	launchingFrameworks
protected org.apache.log4j.Logger	log logging support

Constructor Summary

Constructors

Constructor and Description
ERXFrameworkPrincipal()

Method Summary

Modifier and Type	Method and Description
void	didFinishInitialization() Overridden by subclasses to finalize framework initialization.
abstract void	finishInitialization() Overridden by subclasses to provide framework initialization.
static boolean	hasFrameworkInstalled(String frameworkName) 指定フレームワークがインストールされているかどうかを確認します。
protected void	initialize() Called directly after the constructor.
static void	setUpFrameworkPrincipalClass(Class c) Sets up a given framework principal class to receive notification when it is safe for the framework to be initialized.
static <T extends ERXFrameworkPrincipal> T	sharedInstance(Class<T> c) Gets the shared framework principal instance for a given class.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

log

protected final org.apache.log4j.Logger log

logging support

initializedFrameworks

protected static final NSMutableDictionary<String,ERXFrameworkPrincipal> initializedFrameworks

holds the mapping between framework principals classes and ERXFrameworkPrincipal objects

launchingFrameworks

protected static final NSMutableArray<ERXFrameworkPrincipal> launchingFrameworks

Constructor Detail

ERXFrameworkPrincipal

public ERXFrameworkPrincipal()

Method Detail

sharedInstance

public static <T extends ERXFrameworkPrincipal> T sharedInstance(Class<T> c)

Gets the shared framework principal instance for a given class.

Parameters:

c - principal class for a given framework

Returns:

framework principal initializer

setUpFrameworkPrincipalClass

public static void setUpFrameworkPrincipalClass(Class c)

Sets up a given framework principal class to receive notification when it is safe for the framework to be initialized.

Parameters:

c - principal class

initialize

protected void initialize()

Called directly after the constructor.

finishInitialization

public abstract void finishInitialization()

Overridden by subclasses to provide framework initialization.

didFinishInitialization

public void didFinishInitialization()

Overridden by subclasses to finalize framework initialization.

toString

public String toString()

Overrides:

toString in class Object

hasFrameworkInstalled

public static boolean hasFrameworkInstalled(String frameworkName)

指定フレームワークがインストールされているかどうかを確認します。

Returns:

ある場合には true が戻ります。