javax.enterprise.deploy.model.DeployableObject Maven / Gradle / Ivy
The newest version!
/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright (c) 1997-2018 Oracle and/or its affiliates. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common Development
* and Distribution License("CDDL") (collectively, the "License"). You
* may not use this file except in compliance with the License. You can
* obtain a copy of the License at
* https://oss.oracle.com/licenses/CDDL+GPL-1.1
* or LICENSE.txt. See the License for the specific
* language governing permissions and limitations under the License.
*
* When distributing the software, include this License Header Notice in each
* file and include the License file at LICENSE.txt.
*
* GPL Classpath Exception:
* Oracle designates this particular file as subject to the "Classpath"
* exception as provided by Oracle in the GPL Version 2 section of the License
* file that accompanied this code.
*
* Modifications:
* If applicable, add the following below the License Header, with the fields
* enclosed by brackets [] replaced by your own identifying information:
* "Portions Copyright [year] [name of copyright owner]"
*
* Contributor(s):
* If you wish your version of this file to be governed by only the CDDL or
* only the GPL Version 2, indicate your decision by adding "[Contributor]
* elects to include this software in this distribution under the [CDDL or GPL
* Version 2] license." If you don't indicate a single choice of license, a
* recipient has the option to distribute your version of this file under
* either the CDDL, the GPL Version 2 or to extend the choice of license to
* its licensees as provided above. However, if you add GPL Version 2 code
* and therefore, elected the GPL Version 2 license, then the option applies
* only if the new code is made subject to such option by the copyright
* holder.
*/
package javax.enterprise.deploy.model;
import javax.enterprise.deploy.shared.ModuleType;
import java.util.Enumeration;
import java.io.InputStream;
import java.io.IOException;
/**
* The DeployableObject interface is an abstract representation
* of a Java EE deployable module (JAR, WAR, RAR, EAR). A
* DeployableObject provides access to the module's deployment
* descriptor and class files.
*
* @author gfink
* @version 0.1
*/
public interface DeployableObject
{
/**
* Return the ModuleType of deployment descriptor (i.e., EAR,
* JAR, WAR, RAR) this deployable object represents.
* Values are found in DeploymentManager.
*
* @return The ModuleType of deployable object
*/
public ModuleType getType();
/**
* Return the top level standard bean representing
* the root of the deployment descriptor.
*
* @return A standard bean representing the deployment
* descriptor.
*/
public DDBeanRoot getDDBeanRoot();
/**
* Return an array of standard beans representing the
* XML content returned based upon the XPath.
*
* @param xpath An XPath string identifying the data to
* be extracted from the deployment descriptor.
* @return a array of DDBeans or 'null' if no matching data found.
*
*/
public DDBean[] getChildBean(String xpath);
/**
* Return the XML content associated with the XPath
* from a deployment descriptor.
*
* @param xpath An xpath string referring to a location in the
* deployment descriptor
* @return a list XML content or 'null' if no matching data found.
*/
public String[] getText(String xpath);
/**
* Retrieve the specified class from this deployable module.
*
* One use: to get all finder methods from an EJB
*
* If the tool is attempting to package an module
* and retrieve a class from the package, the class
* request may fail. The class may not yet be
* available. The tool should respect the manifest
* cross-path entries.
*
* @param className Class to retrieve.
* @return Class representation of the class
*/
public Class getClassFromScope(String className);
/**
* Returns the DTD version number given in the XML
* DOCTYPE text provided in every standard Java EE module's
* deployment descriptor file.
* @return a string containing the DTD version number
*
*
* A module's deployment descriptor file always contains
* a document type identifier, DOCTYPE. The DOCTYPE statement
* contains the module DTD version number in the label of the
* statement.
*
* The format of the DOCTYPE statement is:
*
* <!DOCTYPE root_element PUBLIC
* "-//organization//label//language" "location">
*
*
* root_element - is the name of the root document in the DTD.
* organization - is the name of the organization responsible
* for the creation and maintenance of the DTD
* being referenced.
* label - is a unique descriptive name for the public text being
* referenced.
* language - is the ISO 639 language id representing the natural
* language encoding of th DTD.
* location - is the URL of the DTD.
*
* An example Java EE deployment descriptor DOCTYPE statement is:
*
* <!DOCTYPE application-client PUBLIC
* "-//Sun Microsystems, Inc.//DTD J2EE Application Client 1.3//EN"
* "http://java.sun.com/dtd/application-client_1_3.dtd">
*
* In this example the label is, "DTD J2EE Application Client 1.3",
* and the DTD version number is 1.3. A call to getModuleDTDVersion
* would return a string containing, "1.3".
*