weblogic.deploy.api.spi weblogic.deploy.api.spi.factories

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