|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Event factory home for retrieving event factories.
EventFactoryHome
instances provide resolution of named
EventFactory
instances, configuration updates based on a
specific type of configuration template for the EventFactory
instances and releasing cached named EventFactory
instances.
EventFactoryHome
instances also provide an anonymous
EventFactory
for retrieving an unnamed
EventFactory
for component independent event creation. The
anonymous EventFactory
may be retrieved and potentially
updated based on a specific type of configuration template for the
EventFactory
instances, if one exists for unnamed
EventFactory
instances. Note, the anonymous
EventFactory
instance cannot be released once created.
EventFactory
Method Summary | |
---|---|
void |
checkAccess()
Deprecated. As of Hyades M10, Java permission-based security is no longer supported. |
EventFactory |
getAnonymousEventFactory()
Retrieves an instance of the anonymous EventFactory .
|
EventFactory |
getEventFactory(java.lang.String factoryName)
Retrieves an instance of the named EventFactory .
|
void |
releaseEventFactory(java.lang.String factoryName)
Releases the reference to the instance of the named EventFactory .
|
void |
updateAnonymousEventFactory()
Updates the configuration on the instance of the anonymous EventFactory .
|
void |
updateEventFactory(java.lang.String factoryName)
Updates the configuration on the instance of the named EventFactory .
|
Method Detail |
public EventFactory getAnonymousEventFactory()
EventFactory
.
An instance of the anonymous EventFactory
is created if
the anonymous EventFactory
instance currently does not exist.
Once the anonymous EventFactory
is created, the instance
is cached for future calls to retrieve the same anonymous
EventFactory
.
The anonymous EventFactory
is used to for component
independent event creation and is unnamed. The anonymous
EventFactory
may be assigned a ContentHandler
for configuration updates based on a specific type of configuration
template for the EventFactory
instances, if one exists for
unnamed EventFactory
instances.
EventFactory
.public EventFactory getEventFactory(java.lang.String factoryName)
EventFactory
.
An instance of a named EventFactory
is created if no named
instance current exists or a named instance is released.
Once a named EventFactory
is created, the instance is
cached for future calls to retrieve the same named
EventFactory
.
The name of the EventFactory
uniquely identifies an
instance of an EventFactory
. All subsequent calls will
return the same instance of the named EventFactory
.
EventFactory
names are hierarchal represented using the
standard Java dot-delimited name-space naming conventions.
Passing a null
EventFactory
name parameter
in will be equivalent to calling the
getAnonymousEventFactory()
API.
factoryName
- The name of the EventFactory
.
EventFactory
.public void updateAnonymousEventFactory()
EventFactory
.
If the EventFactoryHome
instance does not support
ContentHandler
s for unnamed EventFactory
instances, no update occurs.
The anonymous EventFactory
is used to for component
independent event creation and is unnamed. The anonymous
EventFactory
may be assigned a ContentHandler
for configuration updates based on a specific type of configuration
template for the EventFactory
instances, if one exists for
unnamed EventFactory
instances.
public void updateEventFactory(java.lang.String factoryName)
EventFactory
.
If no named EventFactory
instance exists, no update
occurs.
The name of the EventFactory
uniquely identifies an
instance of an EventFactory
. All calls will update the
configuration on the same named instance of the EventFactory
.
EventFactory
names are hierarchal represented using the
standard Java dot-delimited name-space naming conventions.
Passing a null
EventFactory
name parameter
in will be equivalent to calling the
updateAnonymousEventFactory()
API.
Passing an empty string (e.g. "") with or without white space or a single
asterisk (e.g. *
) as the name parameter updates the configuration
on all cached EventFactory
instances.
factoryName
- The name of the EventFactory
.public void releaseEventFactory(java.lang.String factoryName)
EventFactory
.
If no named EventFactory
instance exists, no release
occurs.
The name of the EventFactory
uniquely identifies an
instance of an EventFactory
.
EventFactory
names are hierarchal represented using the
standard Java dot-delimited name-space naming conventions.
Passing an empty string (e.g. "") with or without white space or a single
asterisk (e.g. *
) as the name parameter releases all cached
EventFactory
instances.
factoryName
- The name of the EventFactory
.public void checkAccess() throws java.lang.SecurityException
SecurityManager
for the context of the
currently executing thread to see if the caller has permission to create,
retrieve, update and release Event Factory instances from the Event
Factory Home. The caller has permission if the
EventPermission("factory")
permission has been explicitly
granted to the caller.
If the caller has been granted permission the method quietly returns.
Otherwise, the method throws a SecurityException
.
java.lang.SecurityException
- If the SecurityManager
exists and if the
caller does not have permission (e.g.
EventPermission("factory")
).
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |