org.formaria.aria
Class Project

java.lang.Object
  org.formaria.aria.Project

Direct Known Subclasses:

EditorProject

public class Project
extends java.lang.Object

A holder for references to the objects and resources used by an Aria project

Copyright (c) Formaria Ltd., 2008

$Revision: 2.40 $

License: see License.txt

Field Summary

protected java.lang.String	basePackageName The package where event hadlers can be found
protected java.util.Vector	bindingFactories Stores a Vector of DataBindingFactory Object for this Project instance
static int	CLOSING
static int	CREATED
protected java.util.Vector	customClassLoaders Vector of s used to locate resources for this Project instance
protected java.lang.String	defaultEncoding Encoding with which to read and write XML files.
protected java.lang.String	defaultFile
protected java.lang.Class	defaultModelClass The default DataModel based class to be used in this Project instance.
protected java.net.URL	documentBase The path to the startup directory for this Project instance
protected java.lang.String	eventHandlerClassName The name of the event handler class which is to be used
protected ExceptionHandler	exceptionHandler A generic handler for exceptions
protected java.util.Hashtable	imageCache Hashtable of images already accessed
static int	INITIALIZED
protected java.util.Hashtable	managerObjects Hashtable for storing other non-Aria object such as Routes and Services
protected MessageHelper	messageHelper Store a reference to the MessageHelper utility class
protected DataModel	modelRoot The root DataModel for this Project instance
protected PageManager	pageManager The PageManager for this Project instance
protected ResourceBundleLoader	resourceBundleLoader ResourceBundleLoader used to load ResourceBundles
static int	RESTARTING
static int	STARTED
protected java.util.Properties	startSettings Properties Object created from the statup properties
protected java.lang.String	startupFile The name of the startup file for this Project instance
protected StartupObject	startupObject
protected int	status
protected StyleManager	styleManager The StyleManager for this Project instance
static int	TERMINATED
static int	UNKNOWN
protected java.lang.String	widgetPackageName The package name of the components to be used (AWT or Swing)
protected XmlParserFactory	xmlParserFactory The XmlParserFactory to be used by this Project instance

Constructor Summary

protected

Project() Create a new project

Method Summary

void	addCustomClassLoader(java.lang.ClassLoader c) Add a custom class loader.
boolean	canAccessDefaultPackage(java.lang.ClassLoader cl, java.lang.String path) Can the project access the default package.
AriaEventHandler	createEventHandler(java.lang.Object owner, ValidationHandler validationHandler) Create the AriaEventHandler for the passed owner (Page) and set it's ValidationHandler
protected java.awt.Image	createImage(java.io.InputStream imgStream) Returns an Image, or null if the path was invalid.
java.net.URL	findResource(java.lang.String fileName) Find a resource
java.lang.String	findResourceAsString(java.lang.String fileName) Find a resource and get its filename (unencoded)
boolean	fixError(java.lang.Class klass, java.lang.String errorName, java.lang.Object sourceObj, java.lang.Throwable t) Attempt to fix an error when running a Aria application
boolean	fixError(java.lang.String errorName, java.lang.Object sourceObj, java.lang.Throwable t) Attempt to fix an error when running a Aria application
java.awt.Frame	getAppFrame() Get a areference to the applet's Frame
java.applet.Applet	getApplet() Get a reference to the applet object
ApplicationContext	getApplicationContext() Gets the application context for this project
java.awt.Window	getAppWindow() Get a reference to the application's main Window
java.util.Vector	getBindingsFactories() Get the binding factories.
java.io.BufferedInputStream	getBufferedInputStream(java.io.File file) Gets a buffered stream for a file
java.io.BufferedInputStream	getBufferedInputStream(java.lang.String s) Gets a buffered stream for a resource
java.io.BufferedOutputStream	getBufferedOutputStream(java.lang.String file) Gets a buffered stream for a file
java.io.BufferedOutputStream	getBufferedOutputStream(java.lang.String file, boolean useProjectParent) Gets a buffered stream for a file
java.io.BufferedReader	getBufferedReader(java.io.File file, java.lang.String encoding) Gets a BufferedReader for a resource
java.io.BufferedReader	getBufferedReader(java.lang.String file) Gets a BufferedReader for a resource
java.io.BufferedReader	getBufferedReader(java.lang.String file, java.lang.String encoding) Gets a BufferedReader for a resource
StyleFactory	getComponentFactory(java.lang.String packageName) Gets an instance of the component factory
java.util.Vector	getCustomerClassLoaders() Get the custom classloaders
java.lang.String	getDefaultEncoding() Get the default file encoding (UTF8 unless modified)
java.net.URL	getDocumentBase() Get the applet document base.
ExceptionHandler	getExceptionHandler() Set an exception handler for unhandled errors during method response method invocation
java.lang.Object	getIcon(java.lang.String name) Loads an image icon
void	getImage(ImageHolder holder, java.lang.String name) Loads an image resource in a background thread
java.awt.Image	getImage(java.lang.String name) Loads an image resource
java.io.InputStream	getInputStream(java.io.File file) Gets a stream for a file
java.io.InputStream	getInputStream(java.lang.String fileName) Gets a stream for a resource
MessageHelper	getMessageHelper() Get the message helper (for formatting messages)
DataModel	getModel() Get the root instance of the model.
java.lang.Object	getObject(java.lang.String key) Get a manager object
java.io.OutputStream	getOutputStream(java.lang.String file) Gets a stream for a file
java.io.OutputStream	getOutputStream(java.lang.String file, boolean useProjectParent) Gets a stream for a file
java.lang.String	getPackageName() Get the default package name
PageManager	getPageManager() Gets an instance of the page manager.
java.lang.ClassLoader	getProjectClassLoader() Gets the ProjectClassLoader object.
java.util.ResourceBundle	getResourceBundle(java.lang.String name) Get a resource bundle
ResourceBundleLoader	getResourceBundleLoader() Get the resource bundle loader
java.lang.String	getStartupFile() Get the name of the startup file.
StartupObject	getStartupObject() Get the startup object
java.lang.String	getStartupParam(java.lang.String name) Gets a startup parameter
int	getStartupParamAsInt(java.lang.String name) Gets a startup parameter
int	getStatus() Get the project status
StyleManager	getStyleManager() Get a reference to the StyleManager.
Translator	getTranslator() Get the default translation object
Translator	getTranslator(java.lang.String name) Get the translation object for the named bundle.
java.net.URL	getUrl(java.lang.String fileName) Gets a URL for a resource
java.lang.String	getWidgetPackageName() Get the default widget package name
XmlParserFactory	getXmlParserFactory() Get the XML parser factory
void	initialise(java.lang.String startFile) Setup the project and configure its resources
void	registerBindingFactory(DataBindingFactory fact) Register a data binding factory.
void	registerBindingFactory(DataBindingFactory fact, int pos) Register a binding factory with the project.
void	removeObject(java.lang.String key) Remove a manager object value
void	resetModel() Reset the model to its initial state.
void	setAppFrame(java.awt.Frame frame) Set the main Frame reference
void	setApplet(java.applet.Applet applet) Set tbe applet reference
void	setAppWindow(java.awt.Window window) Set the main Window reference
void	setComponentFactory(java.lang.String packageName, StyleFactory factory) Sets an instance of the component factory
void	setDefaultEncoding(java.lang.String encoding) Set the default file encoding (UTF8 unless modified) see http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html
void	setDefaultFile(java.lang.String file) Set the default file/directory specification used to locate files by the getOutputStream( String file, boolean useProjectParent ) method
void	setDefaultModel(java.lang.String className) Sets the default model class.
void	setDocumentBase(java.net.URL u) Set/Record the URL from which the applet was loaded
void	setEventHandlerClass(java.lang.String className) Set the name of the class which will handle events for this Project instance
void	setExceptionHandler(ExceptionHandler eh) Set an exception handler for unhandled errors during method response method invocation
void	setObject(java.lang.String key, java.lang.Object obj) Set an manager object value
void	setPackageName(java.lang.String pn) Set the default package name.
void	setResourceBundleLoader(ResourceBundleLoader loader) Set the object to load language resource bundles
void	setStartupFile(java.lang.String fileName) Sets the startup file and loads the associated resource.
void	setStartupObject(StartupObject so) Set tbe startup object reference
boolean	setStartupParam(java.lang.String name, java.lang.String value) Sets a startup parameter
void	setStatus(int newStatus) Set the application status
void	setWidgetPackageName(java.lang.String pn) Set the default widget package name.

Methods inherited from class java.lang.Object

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

Field Detail

UNKNOWN

public static final int UNKNOWN

See Also:

Constant Field Values

CREATED

public static final int CREATED

See Also:

Constant Field Values

INITIALIZED

public static final int INITIALIZED

See Also:

Constant Field Values

STARTED

public static final int STARTED

See Also:

Constant Field Values

CLOSING

public static final int CLOSING

See Also:

Constant Field Values

TERMINATED

public static final int TERMINATED

See Also:

Constant Field Values

RESTARTING

public static final int RESTARTING

See Also:

Constant Field Values

styleManager

protected StyleManager styleManager

The StyleManager for this Project instance

pageManager

protected PageManager pageManager

The PageManager for this Project instance

modelRoot

protected DataModel modelRoot

The root DataModel for this Project instance

xmlParserFactory

protected XmlParserFactory xmlParserFactory

The XmlParserFactory to be used by this Project instance

messageHelper

protected MessageHelper messageHelper

Store a reference to the MessageHelper utility class

bindingFactories

protected java.util.Vector bindingFactories

Stores a Vector of DataBindingFactory Object for this Project instance

startupFile

protected java.lang.String startupFile

The name of the startup file for this Project instance

startSettings

protected java.util.Properties startSettings

Properties Object created from the statup properties

documentBase

protected java.net.URL documentBase

The path to the startup directory for this Project instance

managerObjects

protected java.util.Hashtable managerObjects

Hashtable for storing other non-Aria object such as Routes and Services

defaultModelClass

protected java.lang.Class defaultModelClass

The default DataModel based class to be used in this Project instance. Defaulted to BaseModel

eventHandlerClassName

protected java.lang.String eventHandlerClassName

The name of the event handler class which is to be used

defaultFile

protected java.lang.String defaultFile

defaultEncoding

protected java.lang.String defaultEncoding

Encoding with which to read and write XML files. Defaulted to UTF-8

basePackageName

protected java.lang.String basePackageName

The package where event hadlers can be found

widgetPackageName

protected java.lang.String widgetPackageName

The package name of the components to be used (AWT or Swing)

startupObject

protected StartupObject startupObject

customClassLoaders

protected java.util.Vector customClassLoaders

Vector of s used to locate resources for this Project instance

resourceBundleLoader

protected ResourceBundleLoader resourceBundleLoader

ResourceBundleLoader used to load ResourceBundles

imageCache

protected java.util.Hashtable imageCache

Hashtable of images already accessed

exceptionHandler

protected ExceptionHandler exceptionHandler

A generic handler for exceptions

status

protected int status

Constructor Detail

Project

protected Project()

Create a new project

Method Detail

initialise

public void initialise(java.lang.String startFile)

Setup the project and configure its resources

Parameters:

startFile - the startup file

getStyleManager

public StyleManager getStyleManager()

Get a reference to the StyleManager. A new instance is created if required

Returns:

the style manager

Since:

1.03

getPageManager

public PageManager getPageManager()

Gets an instance of the page manager. A new instance is created if required

Returns:

the PageManager instance

Since:

1.03

getComponentFactory

public StyleFactory getComponentFactory(java.lang.String packageName)

Gets an instance of the component factory

Since:

3.5

setComponentFactory

public void setComponentFactory(java.lang.String packageName,
                                StyleFactory factory)

Sets an instance of the component factory

Since:

3.5

getApplicationContext

public ApplicationContext getApplicationContext()

Gets the application context for this project

Returns:

the ApplicationContext instance

Since:

3.0

getModel

public DataModel getModel()

Get the root instance of the model. This class is unique to the project so it should be unique. If no instance has been created then a new one is constructed.

Returns:

the root DataModel instance.

setDefaultModel

public void setDefaultModel(java.lang.String className)

Sets the default model class. By default the BaseModel is used. An instance is not constructed till the first call to getInstance(). If an instance has been constructed then this method will have no effect.

Parameters:

className - the name of the model class e.g. org.formaria.aria.data.BaseModel

resetModel

public void resetModel()

Reset the model to its initial state. Discard all the child nodess

getXmlParserFactory

public XmlParserFactory getXmlParserFactory()

Get the XML parser factory

Returns:

the parser factory

createEventHandler

public AriaEventHandler createEventHandler(java.lang.Object owner,
                                           ValidationHandler validationHandler)

Create the AriaEventHandler for the passed owner (Page) and set it's ValidationHandler

Parameters:

owner - The Page for which the passed ValidationHandler is working

validationHandler - The ValidationHandler for this Project instance

Returns:

The created AriaEventHandler

setEventHandlerClass

public void setEventHandlerClass(java.lang.String className)

Set the name of the class which will handle events for this Project instance

Parameters:

className - The name of the event handler class

getExceptionHandler

public ExceptionHandler getExceptionHandler()

Set an exception handler for unhandled errors during method response method invocation

Returns:

the exception handler

setExceptionHandler

public void setExceptionHandler(ExceptionHandler eh)

Set an exception handler for unhandled errors during method response method invocation

Parameters:

eh - the exception handler

getMessageHelper

public MessageHelper getMessageHelper()

Get the message helper (for formatting messages)

Returns:

the message helper

getBindingsFactories

public java.util.Vector getBindingsFactories()

Get the binding factories. The binding factories are requested to create component data bindings when a page is loaded from XML.

Returns:

the registered binding factories

registerBindingFactory

public void registerBindingFactory(DataBindingFactory fact,
                                   int pos)

Register a binding factory with the project. The factories are used to add bindings in the order in which they appear in the array of bindings and the iteration of factories stops once a binding is created.

Parameters:

fact - the new factory

pos - the postion in the array at which to add the factory.

registerBindingFactory

public void registerBindingFactory(DataBindingFactory fact)

Register a data binding factory. An add-on library or plug-in may wish to customize the data bindings, particularly if it provides extended model node types. Such extended nodes may need adapters to be useful for some or all widgets and other binding contexts. Registration of the binding factory allows the necessary adapters and bindings to be created on request.

Parameters:

fact - the new binding factory

getStartupFile

public java.lang.String getStartupFile()

Get the name of the startup file.

Returns:

the startup file name, normally startup.properties

setStartupFile

public void setStartupFile(java.lang.String fileName)

Sets the startup file and loads the associated resource.

Parameters:

fileName - the name of the startup resource file.

getStartupParam

public java.lang.String getStartupParam(java.lang.String name)

Gets a startup parameter

Parameters:

name - the paramenter name

Returns:

the value

setStartupParam

public boolean setStartupParam(java.lang.String name,
                               java.lang.String value)

Sets a startup parameter

Parameters:

name - the paramenter name

value - the new value

Returns:

true if the value is new or different from the old value

getStartupParamAsInt

public int getStartupParamAsInt(java.lang.String name)

Gets a startup parameter

Parameters:

name - the paramenter name

Returns:

the value

getStatus

public int getStatus()

Get the project status

Returns:

the current status

setStatus

public void setStatus(int newStatus)

Set the application status

Parameters:

newStatus - the new status

getObject

public java.lang.Object getObject(java.lang.String key)

Get a manager object

Parameters:

key - the name of the object e.g. "Routes", "Services"

Returns:

the object instance or null if it hasn't been added

setObject

public void setObject(java.lang.String key,
                      java.lang.Object obj)

Set an manager object value

Parameters:

key - the name of the object e.g. "Routes", "Services"

obj - the object instance

removeObject

public void removeObject(java.lang.String key)

Remove a manager object value

Parameters:

key - the name of the object e.g. "Routes", "Services"

getIcon

public java.lang.Object getIcon(java.lang.String name)

Loads an image icon

Parameters:

name - the image resource name

Returns:

the image

getImage

public java.awt.Image getImage(java.lang.String name)

Loads an image resource

Parameters:

name - the image resource name

Returns:

the image

getImage

public void getImage(ImageHolder holder,
                     java.lang.String name)

Loads an image resource in a background thread

Parameters:

holder - the component containing to display the image

name - the image resource name

getInputStream

public java.io.InputStream getInputStream(java.lang.String fileName)

Gets a stream for a resource

Parameters:

fileName - the resource file name

Returns:

the InputStream

findResourceAsString

public java.lang.String findResourceAsString(java.lang.String fileName)

Find a resource and get its filename (unencoded)

Parameters:

fileName - the resource file name

Returns:

the complete filename

findResource

public java.net.URL findResource(java.lang.String fileName)

Find a resource

Parameters:

fileName - the resource file name

Returns:

the resource URL or null if it is not found

getBufferedInputStream

public java.io.BufferedInputStream getBufferedInputStream(java.lang.String s)

Gets a buffered stream for a resource

Parameters:

s - the resource name

Returns:

the input stream

getUrl

public java.net.URL getUrl(java.lang.String fileName)

Gets a URL for a resource

Parameters:

fileName - the resource file name

Returns:

the InputStream

addCustomClassLoader

public void addCustomClassLoader(java.lang.ClassLoader c)

Add a custom class loader. Customer class loaders are sometimes added to help locate resources in file structures, jars, remote locations etc...

Parameters:

c - the classloader

getCustomerClassLoaders

public java.util.Vector getCustomerClassLoaders()

Get the custom classloaders

Returns:

the class loaders or null if none or specified

getProjectClassLoader

public java.lang.ClassLoader getProjectClassLoader()

Gets the ProjectClassLoader object. If any instance of ProjectClassLoader class was created, it is registered in this Project object.

Returns:

ProjectClassLoader object.

getInputStream

public java.io.InputStream getInputStream(java.io.File file)

Gets a stream for a file

Parameters:

file - the file

Returns:

the input stream

getBufferedInputStream

public java.io.BufferedInputStream getBufferedInputStream(java.io.File file)

Gets a buffered stream for a file

Parameters:

file - the file

Returns:

the input stream

getBufferedReader

public java.io.BufferedReader getBufferedReader(java.lang.String file)
                                         throws java.lang.Exception

Gets a BufferedReader for a resource

Parameters:

file - the resource file name

Returns:

the BufferedReader

Throws:

java.lang.Exception - throw an exception if there's a problem

getBufferedReader

public java.io.BufferedReader getBufferedReader(java.lang.String file,
                                                java.lang.String encoding)
                                         throws java.lang.Exception

Gets a BufferedReader for a resource

Parameters:

file - the resource file name

encoding - the input encoding e.g. "UTF8" or null for the default encoding (UTF8 unless it has been changed)

Returns:

the BufferedReader

Throws:

java.lang.Exception - throw an exception if there's a problem

getBufferedReader

public java.io.BufferedReader getBufferedReader(java.io.File file,
                                                java.lang.String encoding)
                                         throws java.lang.Exception

Gets a BufferedReader for a resource

Parameters:

file - the resource file

encoding - the input encoding e.g. "UTF8" or null for the default encoding (UTF8 unless it has been changed)

Returns:

the BufferedReader

Throws:

java.lang.Exception - throw an exception if there a problem

getOutputStream

public java.io.OutputStream getOutputStream(java.lang.String file)

Gets a stream for a file

Parameters:

file - the file

Returns:

the output stream

getBufferedOutputStream

public java.io.BufferedOutputStream getBufferedOutputStream(java.lang.String file)

Gets a buffered stream for a file

Parameters:

file - the file

Returns:

the output stream

getOutputStream

public java.io.OutputStream getOutputStream(java.lang.String file,
                                            boolean useProjectParent)

Gets a stream for a file

Parameters:

file - the file

useProjectParent - use the projects default file specification to locate the file

Returns:

the output stream

getBufferedOutputStream

public java.io.BufferedOutputStream getBufferedOutputStream(java.lang.String file,
                                                            boolean useProjectParent)

Gets a buffered stream for a file

Parameters:

file - the file

useProjectParent - use the projects default file specification to locate the file

Returns:

the output stream

setPackageName

public void setPackageName(java.lang.String pn)

Set the default package name. The default package when accessing user event handlers.

Parameters:

pn - The name of the package to be used

getPackageName

public java.lang.String getPackageName()

Get the default package name

Returns:

the default package name

setWidgetPackageName

public void setWidgetPackageName(java.lang.String pn)

Set the default widget package name. The default package name is used when constructing widgets.

Parameters:

pn - The name of the widget package to be used

getWidgetPackageName

public java.lang.String getWidgetPackageName()

Get the default widget package name

Returns:

the default widget package name

getDocumentBase

public java.net.URL getDocumentBase()

Get the applet document base.

Returns:

the url

setDocumentBase

public void setDocumentBase(java.net.URL u)

Set/Record the URL from which the applet was loaded

Parameters:

u - The path to the start directory

setApplet

public void setApplet(java.applet.Applet applet)

Set tbe applet reference

Parameters:

applet - The Applet

setStartupObject

public void setStartupObject(StartupObject so)

Set tbe startup object reference

Parameters:

so - the StartupObject

setAppFrame

public void setAppFrame(java.awt.Frame frame)

Set the main Frame reference

Parameters:

frame - The main application frame

setAppWindow

public void setAppWindow(java.awt.Window window)

Set the main Window reference

Parameters:

window - The main application window

getApplet

public java.applet.Applet getApplet()

Get a reference to the applet object

Returns:

a reference to the applet

getStartupObject

public StartupObject getStartupObject()

Get the startup object

Returns:

the startup object

getAppFrame

public java.awt.Frame getAppFrame()

Get a areference to the applet's Frame

Returns:

a reference to the frame

getAppWindow

public java.awt.Window getAppWindow()

Get a reference to the application's main Window

Returns:

a reference to the Window

createImage

protected java.awt.Image createImage(java.io.InputStream imgStream)

Returns an Image, or null if the path was invalid.

Parameters:

imgStream - The InputStream from which the image is to be read

Returns:

The Image created from the InputStream

getDefaultEncoding

public java.lang.String getDefaultEncoding()

Get the default file encoding (UTF8 unless modified)

Returns:

the encoding

setDefaultEncoding

public void setDefaultEncoding(java.lang.String encoding)

Set the default file encoding (UTF8 unless modified) see http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html

Parameters:

encoding - the encoding e.g. "UTF8" or "ISO-8859-1"

setResourceBundleLoader

public void setResourceBundleLoader(ResourceBundleLoader loader)

Set the object to load language resource bundles

Parameters:

loader - the new loader

getResourceBundleLoader

public ResourceBundleLoader getResourceBundleLoader()

Get the resource bundle loader

Returns:

the loader

getResourceBundle

public java.util.ResourceBundle getResourceBundle(java.lang.String name)

Get a resource bundle

Parameters:

name - the unqualified name of the resource bundle

Returns:

The ResourceBundle created from the passed name

getTranslator

public Translator getTranslator()

Get the default translation object

Returns:

the translation object that operates on the resource bundle

getTranslator

public Translator getTranslator(java.lang.String name)

Get the translation object for the named bundle.

Parameters:

name - the name of the resource used for translation

Returns:

the translation object that operates on the resource bundle

setDefaultFile

public void setDefaultFile(java.lang.String file)

Set the default file/directory specification used to locate files by the getOutputStream( String file, boolean useProjectParent ) method

Parameters:

file - the file or directory specification

fixError

public boolean fixError(java.lang.String errorName,
                        java.lang.Object sourceObj,
                        java.lang.Throwable t)

Attempt to fix an error when running a Aria application

Parameters:

errorName - the name of the error, this should correzpond to a fully qualified class name or a class within the org.formaria.selfhealing package

sourceObj - the instance of the class from which the error handler was invoked, or the object being repaired

t - throwable the exception that was trapped, or null

fixError

public boolean fixError(java.lang.Class klass,
                        java.lang.String errorName,
                        java.lang.Object sourceObj,
                        java.lang.Throwable t)

Attempt to fix an error when running a Aria application

Parameters:

klass - the class through which the healer wiull be loader

errorName - the name of the error, this should correzpond to a fully qualified class name or a class within the org.formaria.selfhealing package

sourceObj - the instance of the class from which the error handler was invoked, or the object being repaired

t - throwable the exception that was trapped, or null

canAccessDefaultPackage

public boolean canAccessDefaultPackage(java.lang.ClassLoader cl,
                                       java.lang.String path)

Can the project access the default package. Within the editor the NetBeans classloader causes problems if the default package is accessed!