Appendix B Repository Properties Reference
Package
property names begin with com.sybase.jaguar.package
.
A package allows you to group related components together for the
purpose of access control or configuration. In Jaguar Manager, configure
package properties in the Package Properties dialog box.
Specifies a text description of the package.
desc
Where desc is the descriptive text.
In Jaguar Manager, set this property using the Description field on the General tab of the Package Properties dialog box.
Specifies the application that this package is installed in, if any.
The name of the application. If not set, the package is not in an application and may be installed directly in one or more servers.
A package may be installed in one application or one or more servers. A package installed in an application may not be installed directly in a server or in another application.
In Jaguar Manager, set this property by installing the package in an application or removing the package from an application.
com.sybase.jaguar.application.packages
Specifies the default for the com.sybase.jaguar.component.code.set component property.
Same as com.sybase.jaguar.component.code.set. The default is the server property com.sybase.jaguar.server.code.set.
In Jaguar Manager, set this property using the All Properties tab in the Package Properties dialog box.
com.sybase.jaguar.component.code.set,
com.sybase.jaguar.server.code.set
Specifies files to be included when the package is exported to a Jaguar JAR archive or replicated to another installation using synchronization.
Same as for com.sybase.jaguar.applicationclient.files. A package archive includes files for installed components, plus those specified by this property.
com.sybase.jaguar.component.files
Specifies Java classes and JAR files to be loaded by the package's custom class loader.
Same as for com.sybase.jaguar.application.java.classes.
EAServer uses custom class loaders to support hot-refresh of server-side code. This property defines classes to be custom loaded for components in the package. Components in a package can share common classes, yet still be refreshed by refreshing the package.
In Jaguar Manager, set this property using the Java Classes tab in the Package Properties dialog box.
com.sybase.jaguar.component.java.classes,
com.sybase.jaguar.application.java.classes,
com.sybase.jaguar.server.java.classes
Specifies the package name.
pack-name
Where package-name is the application name.
In Jaguar Manager, the package name is set when creating or importing a package and cannot be changed.
Specifies roles that a user must belong to in order to invoke the components (other than EJB components) installed in this package.
role1, role2, ...
Where role1, role2, and so forth are role names defined in the repository.
In Jaguar Manager, set this property using the File menu for the Roles folder displayed below the package icon.
Roles are attached to EAServer packages, components, and methods. Attaching a role to a package controls access to all non-EJB components in the package. Attaching a role to a component constrains access to all methods in the component's interfaces. Attaching a role to a method constrains access to that method.
For EJB components, configure access control at the method level by setting the method property com.sybase.jaguar.method.security-roles for each method.
com.sybase.jaguar.component.roles,
com.sybase.jaguar.method.roles,
com.sybase.jaguar.method.security-roles
Maps an identity name used in EJB (1.0 and 2.0) component configuration to an identity defined in the EAServer repository.
Specify the identity referenced in EJB component configuration in the property name, for example:
com.sybase.jaguar.package.runasidentity.ejbFooId
Specify the mapped EAServer identity as the value, for example:
fooId
In Jaguar Manager, you can set and view this property using the Run As Identity tab in the Component Properties dialog box, when the component type is an EJB 1.0 or 2.0 component that is installed in this package.
Security properties,
com.sybase.jaguar.component.runasidentity,
com.sybase.jaguar.component.security.runasidentity
Specifies a mapping from a J2EE role name used in the package to a role defined in the EAServer repository.
com.sybase.jaguar.package.security-role.j2ee-role=jag-role
Where:
In Jaguar Manager, set this property using the Role Mapping tab in the Package Properties dialog box.
Role names may also be specified at the component or application level.
com.sybase.jaguar.package.security-roles,
com.sybase.jaguar.application.security-roles,
com.sybase.jaguar.component.security-role-ref.<j2ee-role-ref>,
com.sybase.jaguar.component.security-role-refs
Specifies logical J2EE role names used in the package.
role1, role2, ...
Where role1, role2, and so forth are of the form:
(description=role-desc, name=role-name)
Where role-desc is an optional description of the role, and role-name is the name used in the application.
In Jaguar Manager, set this property using the Role Mapping tab in the Package Properties dialog box. Each J2EE role name must be mapped to an EAServer role name by setting or creating the corresponding com.sybase.jaguar.package.security-role.<j2ee-role> property.
J2EE role names may also be specified at the component or application level.
com.sybase.jaguar.package.security-role.<j2ee-role>,
com.sybase.jaguar.application.security-role.<j2ee-role>,
com.sybase.jaguar.component.security-role-ref.<j2ee-role-ref>,
com.sybase.jaguar.component.security-role-refs
Specifies the EJB 2.0 (or later) component that represents a schema name used in EJB-QL queries.
schema:schema-name=package/component
Where:
| schema-name | The schema name used in EJB-QL queries |
| package | The package that contains the component |
| component | The component name |
If not set, the default is this-package/schema-name
,
where this-package is the package name, and schema-name is
the schema name used in the EJB-QL query.
EJB-QL queries are used in EJB 2.0 entity beans that require container-managed persistence.
Chapter 25, "Managing Peristent Component State," in the EAServer Programmer's Guide.
| Copyright © 2002 Sybase, Inc. All rights reserved. |
| |