edocs Home > Oracle WebLogic Server Documentation > Administration Console Online Help > Web Service: Overview

Web Service: Overview

Configuration Options     Related Tasks     Related Topics

A Web Service is a set of functions packaged into a single entity that is available to other systems on a network. It is implemented using a Java Web Service (JWS) file, which is a Java class that uses JWS metadata annotations to specify the shape and behavior of the Web Service.

This page displays the general configuration of a deployed Web Service, such as the name that appears in the Deployments table of the Administration Console, the name of the WAR or JAR file in which it is packaged, and name that appears in the WSDL that describes the Web Service.

Depending on the specific features that a Web Service implements, it is packaged as either a WAR or an EJB JAR file. Typically, the Web Service archive is packaged and deployed inside of an Enterprise Application EAR file, although the Web Service can also be deployed stand-alone.

WebLogic Web Services come in two flavors, based on the Sun specification that they implement: JAX-RPC or JAX-WS. Although the two types of Web Services differ slightly in how they are invoked and the other specifications that they support, the two types are very similar. For example, the programming model is essentially the same in that they both use JWS files and metadata annotations

The Web Service contains additional artifacts so that it can be invoked using SOAP: Web Service-specific deployment descriptors, a WSDL file (public contract of the Web Service) and data binding components to convert data between its internal Java representation and its external XML representation used in the request and response SOAP messages.

Configuration Options

Name Description
Deployment Name

The name of the Web Service as it appears in the Deployments table.

Module Name

The name of the Web Service archive file, either a WAR file or EJB JAR file depending on the Web Service features it implements.

Service Name

Name of Web Service. This name appears in the WSDL file that defines the public contract of this Web Service.

Name of

Name of Web Service.

Path

The path to the source of the deployable unit on the Administration Server.

Rules:

  • If InstallDir is null, the source path must be an absolute path.

  • If the source path is relative, it is resolved relative to InstallDir/app.

Use AbsoluteSourcePath to get a fully resolved value.

MBean Attribute:
AppDeploymentMBean.SourcePath

Changes take effect after you redeploy the module or restart the server.

Deployment Plan

The path to the deployment plan document on Administration Server.

Rules:

  • If PlanDir is null, the plan path must be an absolute path.

  • If the plan path is a relative path, it is resolved relative to PlanDir.

Use AbsolutePlanPath to get a fully resolved value.

If there is no plan, this returns no plan specified.

MBean Attribute:
AppDeploymentMBean.PlanPath

Staging Mode

The mode that specifies whether a deployment's files are copied from a source on the Administration Server to the Managed Server's staging area during application preparation.

Staging mode for an application can only be set the first time the application is deployed. Once staging mode for an application is set, it cannot be changed while the application is configured in the domain. The only way to change staging mode is to undeploy then redeploy the application.

This attribute overrides the server's staging mode.

MBean Attribute:
AppDeploymentMBean.StagingMode

Security Model

The security model that is used to secure a deployed module.

To set this value, you can use the weblogic.Deployer command-line tool, the Deployment Assistant in the Administration Console, the WebLogic Scripting Tool (WLST), or some other JMX client.

If you deploy a module using one of the previously mentioned tools and you do not specify a security model value, the module is secured with the security realm's default model ( see RealmMBean SecurityDDModel ).

If you deploy a module by modifying the domain's config.xml file and restarting the server, and if you do not specify a security model value for the module in config.xml, the module is secured with the DDOnly model, which is the default value of this AppDeploymentMBean attribute.

In summary, the order of precedence for the value of this attribute is as follows:

  • If you deploy a module using a runtime deployment utility, the order of precedence is:

    1. The value set by the deployment utility.

    2. The value set as the security realm's default security model.

  • If you deploy a module by modifying config.xml and restarting the server, the order of precedence is:

    1. The value that you specify for the module in config.xml.

    2. The default value of this AppDeploymentMBean SecurityDDModel attribute.

MBean Attribute:
AppDeploymentMBean.SecurityDDModel

Changes take effect after you redeploy the module or restart the server.

Deployment Order

An integer value that indicates when this unit is deployed, relative to other deployable units on a server, during startup.

Units with lower values are deployed before those with higher values.

MBean Attribute:
AppDeploymentMBean.DeploymentOrder

Changes take effect after you redeploy the module or restart the server.

Related Tasks

Related Topics