2-4 Programming Deployment for Oracle WebLogic Server
2.4 The Service Provider Interface Package
As a J2EE product provider, Oracle extends the Sun Microsystems javax Service Provider Interface SPI package to provide specific configuration and deployment
control for WebLogic Server. The core interface for this package is the DeploymentManager, from which all other deployment activities are initiated,
monitored, and controlled.
The WebLogicDeploymentManager interface provides WebLogic Server extensions to the javax.enterprise.deploy.spi.DeploymentManager interface. A
WebLogicDeploymentManager object is a stateless interface for the WebLogic Server deployment framework. It provides basic deployment features as well as
extended WebLogic Server deployment features such as production redeployment and partial deployment for modules in an enterprise application. You generally acquire a
WebLogicDeploymentManager object using SessionHelper.getDeploymentManager method from the SessionHelper
helper class from the Tools package. See
Section 3.3, Application Evaluation .
The following sections provide basic information on the functionality of the WebLogic Server SPI:
■
Section 2.4.1, weblogic.deploy.api.spi
■
Section 2.4.2, weblogic.deploy.api.spi.factories
■
Section 2.4.3, Module Targeting
■
Section 2.4.4, Support for Querying WebLogic Target Types
■
Section 2.4.5, Server Staging Modes
■
Section 2.4.6, DConfigBean Validation
2.4.1 weblogic.deploy.api.spi
The weblogic.deploy.api.spi package provides the interfaces required to configure and deploy applications to a target see
Section 2.4.4, Support for Querying WebLogic Target Types
for valid target types. This package enables you to create deployment tools that can implement a WebLogic Server-specific deployment
configuration for an enterprise application or stand-alone module. weblogic.deploy.api.spi includes the WebLogicDeploymentManager
interface. Use this deployment manager to perform all deployment-related operations such as distributing, starting, and stopping applications in WebLogic Server. The
WebLogicDeploymentManager also provides important extensions to the J2EE DeploymentManager interface for features such as module-level targeting for
enterprise application modules, production redeployment, application versioning, application staging modes, and constraints on Administrative access to deployed
applications.
The WebLogicDeploymentConfiguration and WebLogicDConfigBean classes in the weblogic.deploy.api.spi package represent the deployment and
configuration descriptors WebLogic Server deployment descriptors for an application.
■
A WebLogicDeploymentConfiguration object is a wrapper for a deployment plan.
■
A WebLogicDConfigBean encapsulates the properties in WebLogic deployment descriptors.
Understanding the WebLogic Deployment API 2-5
2.4.2 weblogic.deploy.api.spi.factories
This package contains only one interface, the WebLogicDeploymentFactory. This is a WebLogic extension to
javax.enterprise.deploy.spi.factories.DeploymentFactory. Use this factory interface to select and allocate DeploymentManager objects that have
different characteristics. The WebLogicDeploymentManager characteristics are defined by public fields in the WebLogicDeploymentFactory.
2.4.3 Module Targeting