Deployment descriptor for Jini Service Group
Definition and accompanying instance definitions.
Definition of a group of related
services that can be run within one
name space if requested.
Service definitions representing
an individual Jini service.
Jini Service Group Definition, specifies a collection
of JSC services.
Provides a description of the
collection of Jini services.
Specifies order of jar files on the class path
of the Jini Service definition.
Jar files being part of the service definition and
not listed here are put on the class path in a
container implementation specific order, but
always after the jar files listed here.
Specifies order of download jar files on the
class path of the Jini Service definition.
Jar files being part of the service definition and
not listed here are put on the class path in a
container implementation specific order, but
always after the download jar files listed here.
Grants required for running the
general service code base.
Connector definitions defined
at development time and that
can be selected in the
deployment configuration.
Within this definition each component
represents a connector that can be
selected at deployment time.
In case the connector definitions
require additional grants these
have to be specified at the grant
definitions.
Template for general service configuration,
any expressions have to be substituted
before deployment.
The syntax used for the configuration is
that of Jini ConfigurationFile.
Unique OID (Object Identifier) for
the service group definition.
Version number.
Indicates whether these Jini services
are built to be used for shared name
spaces.
Service Instance Definition, used by JSC
implementation for creating service instances.
Provides a description of the purpose
of this particular service definition.
Grants required for running the
general service definition.
Template for general service configuration,
expressions have to be substituted
before deployment.
Full qualified class name of object
implementing org.cheiron.jsc.JiniService
Provides description for parent element.
The description may consist of a human readable
explanation of what the parent element servces
for, as well as icons and display names for use
by GUI tools.
Description for parent element.
Display name for use in GUI tools.
Icon representing the parent
element in GUI tools.
Help messages for expressions and
permissions defined in deployment
descriptor.
The description type is used by a description element to
provide text describing the parent element. The elements
that use this type should include any information that the
Deployment Component's Deployment File file producer wants
to provide to the consumer of the Deployment Component's
Deployment File (i.e., to the Deployer). Typically, the
tools used by such a Deployment File consumer will display
the description when processing the parent element that
contains the description.
This type is also used for comments in configuration objects
to provide information about the configurable entries.
The lang attribute defines the language that the
description is provided in. The default value is "en" (English).
The display-name type contains a short name
that is intended to be displayed by tools.
The lang attribute defines the language that the
display-name is provided in. The default value
is "en" (English).
The icon type contains small-icon and large-icon
elements that specify the file names for small and
large GIF or JPEG icon images used to represent
the parent element in a GUI.
The small-icon element contains the name of a file
containing a small (16 x 16) icon image. The file
name is a relative path within the Service ARchive
images directory.
The image may be either in the GIF, JPEG or PNG
format, with a file extension of gif, jpg, jpeg or png.
The large-icon element contains the name of a file
containing a large (32 x 32) icon image. The file
name is a relative path within the Service ARchive
images directory.
The image may be either in the GIF, JPEG or PNG
format, with a file extension of gif, jpg, jpeg or png.
General help message for element that
are related to administration tasks.
E.g. provides an explanation of the value
that has to be entered for the expression,
or the purpose of an permission. This
element can be seen as a help or tooltip.
The lang attribute defines the language that the
description is provided in. The default value is
"en" (English).
Identifier refering to element this is
a help message for.
Collection of permission that needs to be
granted to give access to system resources.
These grants may have unresolved
expressions that have to be substituted
by the deployment configuration.
Principal associated for this grant.
The permissions are only granted when
the named principals are executing the
code. In case no principal is provided
the service code base will be granted
all contained permissions.
Permission to be granted.
Content is the name component
of the permission.
Unique identifier for this grant so
principals can be assigned to it at
deployment time.
Indicates the alias for a certificate stored in
the keystore.
If specified the permissions will only be granted
if the digital signature on the code is valid.
Specifies a class name/principal name pair
representing a principal within the Java
security context.
Full qualified class implementing the
java.security.Principal interface.
Name principal can be identified with,
also called the alias.
Represents a permission that can grant a
particular type of access to a system resource.
The content for this element represents the name
attribute of the permission. In case there are
expressions used in it these have to be resolved
at deployment time, very much as with the
configuration definition.
Expression to be substituted at
deployment time by an expression
value.
Reference to expression for reuse.
Full qualified class extending the
java.security.Permission object or one
of its subclasses.
Action list telling the actions permitted.
Indicates the permission has to be signed by
the given alias(es) in order for the permission
to be granted.
If not specified 'any principal' will be used.
Unique identifier for permission to be
referenced by help messages.
Comma separated list of Identifiers of
connector definitions this permission is
associated with, if not don't specify it.
This permission will only be granted in
case the connector definition is being
deployed.
All categories an expression can have.
The category is an important indicator
for the deployer about the importance
to provide an expression value for that
particular expression.
Indicates that an expression value
should be provided for the service
deployed, or that the expression must
be emphasized that it is common to
provide a value other then the default
value.
Not doing so will likely result in failure
of the service or unexpected behavior,
like not being able to connect to
another service, database, etc.
Indicates a category for expressions
that don't belong to the REQUIRED or
EXPERT category.
This category is useful for out-of-the-box
expression values, that can be modified
for more advanced uses of the service
deployed.
Indicates that only in very rare cases
an expression value should be provided.
One can think about tuning parameters
for a service, or other properties that
require expert knowledge of the service
deployed.
Describes the expression to be substituted
at deployment time.
This expression may contain a valid value
that can server as the default, in case it is
not being substituted at deployment time.
Unique identifier for the expression
to be substituted.
Reference to already definied expression,
enables reuse of expressions within
grant definition, configuration definition, etc.
Reference to id of expression.
The scope is not limited to expressions
definied in the context of grants but
may refer to any expression within the
same context, e.g. service group definition
or service definitiont.
Reference to id of expression.
Configuration source according to the syntax of
net.jini.config.ConfigurationFile.
Expression to be substituted at
deployment time by an expression
value.
Reference to expression for reuse.
Unique identifier for the configuration
definition, can be used as ID for help
messages.
Specifies a serialized net.jini.core.entry.Entry
object.
The entry is an Entry object, or an Entry
contained in a java.rmi.MarshalledObject or
net.jini.io.MarshalledInstance object that has
been serialized as a Base64 byte stream.
Identifier for entry, can be useful in case
of exception when unmarshalling the entry.
Numerical object identifier as specified by the ITU
(International Telecommunication union). The use of
numerical OIDs will prevent from ambiguous identifiers.
One can obtain without much hasle and without
any costs a OID prefix (private enterprise number)
from IANA at:
http://www.iana.org/cgi-bin/enterprise.pl
The syntax for a numerical OID is in BNF:
numericoid ::= numericstring | numericstring "." numericoid
numericstring ::= digit | digit numericstring
digit ::= "0" | "1" | "2" | "3" | "4" |
"5" | "6" | "7" | "8" | "9"
Version number to keep track of evolution of
service definition.
The syntax for a version number is in BNF:
versionnumber ::= numericstring |
numericstring lowercasestring |
numericstring lowercasestring numericstring |
numericstring "." versionnumber
numericstring ::= digit | digit numericstring
lowercasestring ::= lower | lower lowercasestring
lower ::= "a" | "b" | "c" | "d" | "e" |
"f" | "g" | "h" | "i" | "j" |
"k" | "l" | "m" | "n" | "o" |
"p" | "q" | "r" | "s" | "t" |
"u" | "v" | "w" | "x" | "y" | "z"
digit ::= "0" | "1" | "2" | "3" | "4" |
"5" | "6" | "7" | "8" | "9"
The internationalized content element can be
used for creating elements that can have
multiple languages attached to it.
The lang attribute defines the language that the
content is provided in.
Language used for content, defaults to "en" (English).
Restricted string for use as
identifiers and the like.