This Schema was generated by the OSS through Java XML Toolkit Doclet 3-30-2005 15:26
Similar to java.lang.UnsupportedOperationException,
except this inherits from Exception, not RuntimeException.
This new class is required because J2EE containers deal with
RuntimeException in a special way. See EJB specification.
<p>
This exception is thrown if a remote method is not implemented
(and the throws clause states that this exception may be thrown).
This exception is thrown for operations affecting
unsupported attributes. It is unchecked.
Indicates that there was a problem with a remote call to set the value of a Managed Entity.
This exception is thrown if a an update method (remote) contains
a stale value object.
Base interface from which each application specific <CODE>QueryValue</CODE>
type must be derived. A <CODE>QueryValue</CODE> interface is also a
generic attribute accessor (i.e., it extends AttributeAccess).
The <CODE>ManagedEntityValue</CODE> interface is the base interface for all more
detailed interfaces which represent any kind of object that is to be managed.
<p>
Classes which implement <CODE>ManagedEntityValue</CODE> or a
sub interface of <CODE>ManagedEntityValue</CODE>.
are also called value classes.
<P>All classes implementing a value interface provide several ways to access
the attributes:
<UL>
<LI>Attributes can be accessed through standard JavaBeans get/set (is/set)
methods.
<LI>Attributes can be accessed through the generic methods defined
in Attribute Access
<UL>
<LI><CODE>public Object getAttributeValue(String attributeName)</CODE>
<LI><CODE>public void setAttributeValue(String attributeName, Object newValue)</CODE>
</UL>
A base interface for every application specific <CODE><ManagedEntity>KeyResult</CODE>
interface.
<p>
A <CODE><ManagedEntity>KeyResult</CODE> interface must comply with the following template:
<pre>
public interface <ManagedEntity>KeyResult extends ManagedEntityKeyResult
{
public <ManagedEntity>Key get<ManagedEntity>Key();
}
</pre>
<p>
The managed entity key result encapsulates all the information necessary to
indicate the result of a BEST EFFORT operation on a specific managed entity.
<p>
The managed entity key result is used in operations involving the update of
multiple managed entities, in the deletion of multiple managed entities or in
the creation of multiple managed entities or in bulk business operations.
<p>
The base <CODE>ManagedEntityKeyResult</CODE> interface contains the managed entity key,
a boolean value indicating if the operation on the targeted managed entity was
succesful and finally the exception that would have been thrown if this operation
had been attempted on the individual Managed Entity.
A <CODE>ManagedEntityKey</CODE> is a unique identifier for a
<CODE>ManagedEntityValue</CODE>.
<p>
The Type, ApplicationDN and ApplicationContext
are included in <CODE>ManagedEntityKey</CODE>, because
a <CODE>primaryKey</CODE> is only unique within an
application instance as given by the ApplicationDN running
in a given naming system as given by the ApplicationContext URL.
Get the names of the optional operations supported by this JVT
Session Bean. The names of the optional operations are defined
in the <CODE>JVT<ApplicationType>SessionOptionalOps</CODE> interface as
defined by the API.
Get the Managed Entity types supported by a JVT Session Bean.
Get the Query type names supported by a JVT Session Bean
Get the Event Type names supported by the JVT Session Bean
Get the EventPropertyDescriptor associated with an event type name.
Query multiple Managed Entities using a QueryValue.
Similar to java.lang.IllegalStateException,
except this inherits from Exception, not RuntimeException.
This new class is required because J2EE containers deal with
RuntimeException in a special way. See EJB specification.
<p>
The IllegalStateException exception is thrown by a JVT Session Bean
to report that the invoked business method could not be completed because
the operation was invoked at an illegal or inappropriate time.
Similar to javax.oss.IllegalArgumentException,
except it specifically refers to a bad value associated
with an attribute name within an AttributeAccess object.
This exception is thrown if an AttributeAccess object passed
to a remote method contains an attribute with a bad value.
Similar to java.lang.IllegalArgumentException,
except this inherits from Exception, not RuntimeException.
This new class is required because J2EE containers deal with
RuntimeException in a special way. See EJB specification.
<p>
This exception is thrown if the argument of a remote
method is invalid.
<p>
The EventPropertyDescriptor is used to document and
specify the filterable properties of an event.
<p>
An Interface extending the base EventPropertyDescriptor
interface must be defined for each type of application
specific event emitted by a component.
<p>
The name of the specific EventPropertyDescriptor
interface should be <i>EventType</i>EventPropertyDescriptor
where the <i>EventType</i> is the name of the event type
interface.
<p>
Example:<br>
<UL>
<LI>NotifyAckStateChangedEvent
<LI>NotifyAckStateChangedEventEventPropertyDescriptor
</UL>
The ApplicationContext interface contains the URL and
other system properties required to set up an initial
connection with the JNDI provider into which the
components in charge of that managed entity are registered.
<p>
Security Credentials are not passed.
<p>
The MultiValuedList is used In oder to minimize the amount of
data required to add or remove a single attribute value from a
multi-valued attribute of a Managed Entity.
This is modifier is used to indicate the operation on a MultiValueList.
The CreateException exception can be
returned by all create(...) requests defined in the OSS
through Java XML/JMS interface. The exception is used as a
standard application-level exception to report a failure to
create a managed entity or a collection of managed
entities. This exception is thrown when a particular managed
entity or group of managed entities cannot be
created.
The DuplicateKeyException exception is
returned if a managed entity cannot be created because an
object with the same key already exists. This exception is
only used when a managed entity key is provided in a
create(...) request and when client controlled naming is
used. This exception is returned by the create requests
defined in the OSS through Java XML/JMS
interface.
The exception is used as a standard
application-level exception to report a failure to find the
requested managed entities. This exception is returned when a
collection of one or more entity cannot be found. This
exception should not be returned by requests that return a
collection of managed entitites using an associative lookup
approach (they should return a null list
instead).
The ObjectNotFoundException exception is
returned by an OSS through Java request to indicate that the
specified managed entity does not exist. Only the request that
are declared to return a single managed entity use this
exception. This exception should not be returned by methods
that return a collection of managed entitites. This exception
is returned when a singular managed entity cannot be
found.
The RemoveException exception is returned
at an attempt to remove a collection of one or more managed
entity when the XML/JMS interface does not allow the managed
entity to be removed. This exception is returned when a a
collection of one or more managed entity cannot be
removed
The RemoteException is returned when an
errors occurs during any remote object
operation.
The BaseException is the parent complexType of the Exceptions.
The Message element indicates the error message from the Exception. This is most
likely the results from a Exception.getMessage() call.
Base Event
This is a representation of a String
array.
This is a representation of an Iterator
Request.
This is a representation of an Iterator
Response.