/jboss-as-7.1.1.Final/ee-deployment/src/main/java/org/jboss/as/ee/deployment/spi/factories/DeploymentFactoryImpl.java
Java | 159 lines | 66 code | 13 blank | 80 comment | 6 complexity | 3161cde690f80339f23f7b91de1293ae MD5 | raw file
Possible License(s): LGPL-2.1, Apache-2.0
- /*
- * JBoss, Home of Professional Open Source.
- * Copyright 2008, Red Hat Middleware LLC, and individual contributors
- * as indicated by the @author tags. See the copyright.txt file in the
- * distribution for a full listing of individual contributors.
- *
- * This is free software; you can redistribute it and/or modify it
- * under the terms of the GNU Lesser General Public License as
- * published by the Free Software Foundation; either version 2.1 of
- * the License, or (at your option) any later version.
- *
- * This software is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this software; if not, write to the Free
- * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
- * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
- */
- package org.jboss.as.ee.deployment.spi.factories;
- import org.jboss.as.ee.deployment.spi.DeploymentManagerImpl;
- import javax.enterprise.deploy.shared.factories.DeploymentFactoryManager;
- import javax.enterprise.deploy.spi.DeploymentManager;
- import javax.enterprise.deploy.spi.exceptions.DeploymentManagerCreationException;
- import javax.enterprise.deploy.spi.factories.DeploymentFactory;
- import java.net.URI;
- import java.net.URISyntaxException;
- import static org.jboss.as.ee.deployment.spi.DeploymentManagerImpl.DEPLOYER_URI;
- import static org.jboss.as.ee.deployment.spi.DeploymentLogger.ROOT_LOGGER;
- /**
- * The DeploymentFactory interface is a deployment driver for a J2EE platform product.
- *
- * It returns a DeploymentManager object which represents a connection to a specific J2EE platform product. Each application
- * server vendor must provide an implementation of this class in order for the J2EE Deployment API to work with their product.
- *
- * The class implementing this interface should have a public no-argument constructor, and it should be stateless (two instances
- * of the class should always behave the same). It is suggested but not required that the class have a static initializer that
- * registers an instance of the class with the DeploymentFactoryManager class.
- *
- * A connected or disconnected DeploymentManager can be requested. A DeploymentManager that runs connected to the platform can
- * provide access to J2EE resources. A DeploymentManager that runs disconnected only provides module deployment configuration
- * support.
- *
- * @author Thomas.Diesler@jboss.com
- * @author Scott.Stark@jboss.com
- *
- */
- public class DeploymentFactoryImpl implements DeploymentFactory {
- // The name of the JBoss DeploymentFactory
- private static String DISPLAY_NAME;
- // The product version
- private static String PRODUCT_VERSION;
- /*
- * Register a DeploymentFactoryImpl instance with the DeploymentFactoryManager. This obtains the display name and version
- * from the Package object for org.jboss.deploy.spi.factories
- */
- static {
- DeploymentFactoryManager manager = DeploymentFactoryManager.getInstance();
- manager.registerDeploymentFactory(new DeploymentFactoryImpl());
- Package pkg = DeploymentFactoryImpl.class.getPackage();
- if (pkg != null) {
- DISPLAY_NAME = pkg.getImplementationVendor();
- PRODUCT_VERSION = pkg.getImplementationVersion();
- }
- if (DISPLAY_NAME == null || PRODUCT_VERSION == null) {
- DISPLAY_NAME = "DeploymentFactoryImpl";
- PRODUCT_VERSION = "1.1-DEV";
- }
- }
- /**
- * Register this deployment factory with the manager
- */
- public static synchronized void register() {
- // registration is actually done in the static block above
- }
- /**
- * Tests whether the factory can create a manager for the URI
- */
- public boolean handlesURI(String uri) {
- boolean handlesURI = uri.startsWith(DEPLOYER_URI);
- ROOT_LOGGER.debugf("handlesURI [%s]: %s", uri, handlesURI);
- return handlesURI;
- }
- /**
- * Get a connected deployment manager
- *
- * @param uri the uri of the deployment manager
- * @param userName the user name
- * @param password the password
- * @return the deployment manager
- * @throws javax.enterprise.deploy.spi.exceptions.DeploymentManagerCreationException
- *
- */
- public DeploymentManager getDeploymentManager(String uri, String userName, String password) throws DeploymentManagerCreationException {
- ROOT_LOGGER.debugf("getDeploymentManager (uri=%s)", uri);
- try {
- URI deployURI = parseURI(uri);
- return new DeploymentManagerImpl(deployURI, true, userName, password);
- } catch (URISyntaxException e) {
- DeploymentManagerCreationException ex = new DeploymentManagerCreationException("Failed to create DeploymentManagerImpl");
- ex.initCause(e);
- throw ex;
- }
- }
- /**
- * Get a disconnected version of the deployment manager
- *
- * @param uri the uri to connect to
- * @return the disconnected deployment manager
- * @throws javax.enterprise.deploy.spi.exceptions.DeploymentManagerCreationException
- *
- */
- public DeploymentManager getDisconnectedDeploymentManager(String uri) throws DeploymentManagerCreationException {
- ROOT_LOGGER.debugf("getDisconnectedDeploymentManager (uri=%s)", uri);
- try {
- URI deployURI = parseURI(uri);
- return new DeploymentManagerImpl(deployURI, false);
- } catch (URISyntaxException e) {
- DeploymentManagerCreationException ex = new DeploymentManagerCreationException("Failed to create DeploymentManagerImpl");
- ex.initCause(e);
- throw ex;
- }
- }
- /**
- * The name of the JBoss DeploymentFactory.
- *
- * @return the vendor name
- */
- public String getDisplayName() {
- return DISPLAY_NAME;
- }
- /**
- * The version of the deployment manager
- *
- * @return the version
- */
- public String getProductVersion() {
- return PRODUCT_VERSION;
- }
- private URI parseURI(String uri) throws URISyntaxException {
- URI deployURI = new URI(uri);
- return deployURI;
- }
- }