DeploymentInfo (JBoss System API) - JBoss 3.2.7 system API Documentation 英文版文档

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.jboss.deployment
Class DeploymentInfo

java.lang.Object
  org.jboss.deployment.DeploymentInfo

All Implemented Interfaces:: Serializable

public class DeploymentInfo
extends Object
implements Serializable

Service Deployment Info . Every deployment (even the J2EE ones) should be seen at some point as Service Deployment info

Version:: $Revision: 1.14.2.22 $
Author:: Marc Fleury, David Maplesden, David Jencks, Daniel Schulze, Christoph G. Jung, Scott Stark
See Also:: Service, Serialized Form

Field Summary

Collection classpath
          The classpath declared by this xml descriptor, needs entry

HashMap context
          An arbitrary map of state associated with the deployment

Date date
          The initial construction timestamp

javax.management.ObjectName deployedObject
          The variable deployedObject can contain the MBean that is created through the deployment.

SubDeployer deployer
          The subdeployer that handles the deployment

Document document
          Each Deployment is really mapping one to one to a XML document, here in its parsed form.

URL documentUrl
          An optional URL to the URL of the document loaded

boolean isDirectory
          Does the deployment url point to a directory

boolean isScript


boolean isXML
          Is this a stand-alone service descriptor

long lastDeployed
          The last system time the deployment inited by the MainDeployer

long lastModified
          use for "should we redeploy failed"

URLClassLoader localCl
          local Cl is a CL that is used for metadata loading, if ejb-jar.xml is left in the parent CL through old deployments, this makes ensures that we use the local version.

URL localUrl
          An optional URL to a local copy of the deployment

Manifest manifest
          the manifest entry of the deployment (if any) manifest is not serializable ...

List mbeans
          The mbeans deployed

Object metaData
          We can hold "typed" metadata, really an interpretation of the bare XML document

DeploymentInfo parent
          And the subDeployments have a parent

org.jboss.mx.loading.LoaderRepositoryFactory.LoaderRepositoryConfig repositoryConfig
          The configuration of the loader repository for this deployment

String shortName
          The suffix of the deployment url

DeploymentState state
          The current state of the deployment

String status
          A free form status for the "state" can be Deployed/failed etc etc

Set subDeployments
          Anyone can have subdeployments

org.jboss.mx.loading.UnifiedClassLoader ucl
          Unified CL is a global scope class loader

URL url
          the URL identifing this SDI

URL watch
          The URL used to watch for changes when the deployment is unpacked

String webContext
          the web root context in case of war file

Constructor Summary

DeploymentInfo(URL url, DeploymentInfo parent, javax.management.MBeanServer server)


Method Summary

void addLibraryJar(URL libJar)
          All library jars referenced through either the manifest references or sar classpaths are added to the root DeploymentInfo class loader.

void cleanup()


void createClassLoaders()
          Create a UnifiedClassLoader for the deployment that loads from the localUrl and uses its parent deployments url as its orignal url.

boolean equals(Object other)


Manifest getManifest()
          getManifest returns (if present) the deployment's manifest it is lazy loaded to work from the localURL

javax.management.MBeanServer getServer()


static String getShortName(String name)


org.jboss.mx.loading.LoaderRepositoryFactory.LoaderRepositoryConfig getTopRepositoryConfig()
          The the class loader repository name of the top most DeploymentInfo

int hashCode()


void setRepositoryInfo(org.jboss.mx.loading.LoaderRepositoryFactory.LoaderRepositoryConfig config)
          Set the UnifiedLoaderRepository info for the deployment.

void setServer(javax.management.MBeanServer server)


String toString()


Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

date

public Date date

The initial construction timestamp

url

public URL url

the URL identifing this SDI

localUrl

public URL localUrl

An optional URL to a local copy of the deployment

watch

public URL watch

The URL used to watch for changes when the deployment is unpacked

shortName

public String shortName

The suffix of the deployment url

lastDeployed

public long lastDeployed

The last system time the deployment inited by the MainDeployer

lastModified

public long lastModified

use for "should we redeploy failed"

status

public String status

A free form status for the "state" can be Deployed/failed etc etc

state

public DeploymentState state

The current state of the deployment

deployer

public transient SubDeployer deployer

The subdeployer that handles the deployment

ucl

public transient org.jboss.mx.loading.UnifiedClassLoader ucl

Unified CL is a global scope class loader

localCl

public transient URLClassLoader localCl

local Cl is a CL that is used for metadata loading, if ejb-jar.xml is left in the parent CL through old deployments, this makes ensures that we use the local version. You must use the URLClassLoader.findResource method to restrict loading to the deployment URL.

classpath

public final Collection classpath

The classpath declared by this xml descriptor, needs entry

mbeans

public final List mbeans

The mbeans deployed

subDeployments

public final Set subDeployments

Anyone can have subdeployments

parent

public DeploymentInfo parent

And the subDeployments have a parent

webContext

public String webContext

the web root context in case of war file

manifest

public transient Manifest manifest

the manifest entry of the deployment (if any) manifest is not serializable ... is only needed at deployment time, so we mark it transient

document

public Document document

Each Deployment is really mapping one to one to a XML document, here in its parsed form. A xerces document (org.apache.xerces.dom.DocumentImpl) is serializable.

documentUrl

public URL documentUrl

An optional URL to the URL of the document loaded

metaData

public transient Object metaData

We can hold "typed" metadata, really an interpretation of the bare XML document

context

public transient HashMap context

An arbitrary map of state associated with the deployment

isXML

public boolean isXML

Is this a stand-alone service descriptor

isScript

public boolean isScript

isDirectory

public boolean isDirectory

Does the deployment url point to a directory

deployedObject

public javax.management.ObjectName deployedObject

The variable deployedObject can contain the MBean that is created through the deployment. for instance, deploying an ejb-jar results in an EjbModule mbean, which is stored here.

repositoryConfig

public org.jboss.mx.loading.LoaderRepositoryFactory.LoaderRepositoryConfig repositoryConfig

The configuration of the loader repository for this deployment

Constructor Detail

DeploymentInfo

public DeploymentInfo(URL url,
                      DeploymentInfo parent,
                      javax.management.MBeanServer server)
               throws DeploymentException

Method Detail

getServer

public javax.management.MBeanServer getServer()

setServer

public void setServer(javax.management.MBeanServer server)

createClassLoaders

public void createClassLoaders()
                        throws Exception

Create a UnifiedClassLoader for the deployment that loads from the localUrl and uses its parent deployments url as its orignal url. Previously xml descriptors simply used the TCL but since the UCLs are now registered as mbeans each must be unique.

Throws:: Exception

setRepositoryInfo

public void setRepositoryInfo(org.jboss.mx.loading.LoaderRepositoryFactory.LoaderRepositoryConfig config)
                       throws Exception

Set the UnifiedLoaderRepository info for the deployment. This can only be called for the parent deployment, and must be done early in the Subdeployer init(DeploymentInfo) method prior to any class loading.

Parameters:: config - the URL configuration settings
Throws:: Exception

addLibraryJar

public void addLibraryJar(URL libJar)

All library jars referenced through either the manifest references or sar classpaths are added to the root DeploymentInfo class loader. This is neccessary to avoid IllegalAccessErrors due to classes in a pkg being split across jars

getTopRepositoryConfig

public org.jboss.mx.loading.LoaderRepositoryFactory.LoaderRepositoryConfig getTopRepositoryConfig()

The the class loader repository name of the top most DeploymentInfo

getManifest

public Manifest getManifest()

getManifest returns (if present) the deployment's manifest it is lazy loaded to work from the localURL

cleanup

public void cleanup()

hashCode

public int hashCode()

equals

public boolean equals(Object other)

toString

public String toString()

getShortName

public static String getShortName(String name)