/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright 1997-2007 Sun Microsystems, Inc. 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://glassfish.dev.java.net/public/CDDL+GPL.html
* or glassfish/bootstrap/legal/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 glassfish/bootstrap/legal/LICENSE.txt.
* Sun designates this particular file as subject to the "Classpath" exception
* as provided by Sun in the GPL Version 2 section of the License file that
* accompanied this code. If applicable, add the following below the License
* Header, with the fields enclosed by brackets [] replaced by your own
* identifying information: "Portions Copyrighted [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 com.sun.enterprise.deployapi;
import com.sun.enterprise.deployment.client.ServerConnectionIdentifier;
import com.sun.enterprise.deployment.util.DOLUtils;
import com.sun.enterprise.util.LocalStringManagerImpl;
import java.util.Hashtable;
import java.util.logging.Level;
import javax.enterprise.deploy.spi.DeploymentManager;
import javax.enterprise.deploy.spi.exceptions.DeploymentManagerCreationException;
import javax.enterprise.deploy.spi.factories.DeploymentFactory;
/**
*Concrete implementation of the JSR 88 DeploymentFactory interface.
* @author dochez
* @author tjquinn
*/
public class SunDeploymentFactory implements DeploymentFactory {
private static LocalStringManagerImpl xlocalStrings =
new LocalStringManagerImpl(SunDeploymentFactory.class);
private static String DMGR_NOT_CONNECTED = xlocalStrings.getLocalString(
"enterprise.deployapi.spi.DMgrnotconnected", // NOI18N
"Deployment Manager is not connected to J2EE Resources"); // NOI18N
// URI String that this factory can handle. May need to be rebuilt.
//The following URISTRING is what we supported in PE Beta. Keeping it for
//backward compatibility
private final static String PE_BETA_URISTRING = "deployer:Sun:S1AS::"; // NOI18N
//The following URISTRINNG is what we use for PE FCS and in the future
private final static String DEFAULT_URISTRING = "deployer:Sun:AppServer::"; // NOI18N
private final static String HTTPS = "https";
private final static String URI_SEPARATOR = ":";// NOI18N
private final static String LOCAL_HOST = "localhost";// NOI18N
private final static int HOST_PORT = 4848; // default DAS port
private final static String[] supportedURIs = { PE_BETA_URISTRING,
DEFAULT_URISTRING };
// All the registered mangers are shared by all instances of the Factory
private static Hashtable connectedDeploymentManagers;
private static Hashtable disconnectedDeploymentManagers;
private final static String HTTPS_PROTOCOL = "s1ashttps";
private final static String HTTP_PROTOCOL = "s1ashttp";
/** Creates a new instance of SunDeploymentFactory */
public SunDeploymentFactory() {
}
/** Return a <tt>connected</tt> DeploymentManager instance.
*
* @param uri The URI that specifies the connection parameters
* @param username An optional username (may be <tt>null</tt> if
* no authentication is required for this platform).
* @param password An optional password (may be <tt>null</yy> if
* no authentication is required for this platform).
* @return A ready DeploymentManager instance.
* @throws DeploymentManagerCreationException occurs when a
* DeploymentManager could not be returned (server down,
* unable to authenticate, etc).
*/
public DeploymentManager getDeploymentManager(String uri, String username, String password) throws DeploymentManagerCreationException {
if (handlesURI(uri)) {
ServerConnectionIdentifier hostInfo = null;
try {
hostInfo = parseURIForHostInfo(uri);
} catch(Exception ex) {
DeploymentManagerCreationException e = new DeploymentManagerCreationException(
xlocalStrings.getLocalString(
"enterprise.deployapi.spi.wronghostidentifier",
"Wrong host identifier in uri {0} ", new Object[] { uri }));
e.initCause(ex);
throw e;
}
try {
hostInfo.setUserName(username);
hostInfo.setPassword(password);
DeploymentManager answer = null;
answer = new SunDeploymentManager(hostInfo);
return answer;
} catch(Throwable t) {
DeploymentManagerCreationException e = new DeploymentManagerCreationException(xlocalStrings.getLocalString(
"enterprise.deployapi.spi.exceptionwhileconnecting", //NOI18N
"Exception while connecting to {0} : {1}", new Object[] { uri, t.getMessage() })); //NOI18N
e.initCause(t);
throw e;
}
} else {
return null;
}
}
/** Return a <tt>disconnected</tt> DeploymentManager instance.
*
* @param uri the uri of the DeploymentManager to return.
* @return A DeploymentManager <tt>disconnected</tt> instance.
* @throws DeploymentManagerCreationException occurs if the
* DeploymentManager could not be created.
*/
public DeploymentManager getDisconnectedDeploymentManager(String uri) throws DeploymentManagerCreationException {
if (handlesURI(uri)) {
return new SunDeploymentManager();
} else {
return null;
}
}
/** Provide a string with the name of this vendor's DeploymentManager.
* @return the name of the vendor's DeploymentManager.
*/
public String getDisplayName() {
return xlocalStrings.getLocalString(
"enterprise.deployapi.spi.DisplayName",
"Sun Java System Application Server");
}
/** Provide a string identifying version of this vendor's
* DeploymentManager.
* @return the name of the vendor's DeploymentManager.
*/
public String getProductVersion() {
return xlocalStrings.getLocalString(
"enterprise.deployapi.spi.ProductVersion", "9.0");
}
/** Tests whether this factory can create a DeploymentManager
* object based on the specificed URI. This does not indicate
* whether such an attempt will be successful, only whether the
* factory can handle the uri.
* @param uri The uri to check
* @return <tt>true</tt> if the factory can handle the uri.
*/
public boolean handlesURI(String uri) {
if (DOLUtils.getDefaultLogger().isLoggable(Level.FINE)) {
DOLUtils.getDefaultLogger().fine("handlesURI: URI ["+uri+"]");// NOI18N
}
if (uri != null) {
try {
return (parseURIForHostInfo(uri)!=null);
} catch (Exception ex) {
DOLUtils.getDefaultLogger().log(Level.SEVERE, "enterprise.deployment.backend.deplyomentManagerLoadFailure", // NOI18N
new Object[] {uri});
}
}
return false;
}
/**
* @return the host name/port from the URI passed see JSR88 paragraph 9.2.3
*/
public ServerConnectionIdentifier parseURIForHostInfo(String uri) throws Exception {
String targetURI = null;
for (int i=0;i<supportedURIs.length;i++) {
if (uri.indexOf(supportedURIs[i])==0) {
targetURI = supportedURIs[i];
}
}
//if the URI does not contain DEFAULT_URISTRINNG or PE_BETA_URISTRING,
//then the URI is not valid.
if (targetURI == null) {
throw new Exception(xlocalStrings.getLocalString(
"enterprise.deployapi.spi.invaliduri", // NOI18N
"Invalid URI")); // NOI18N
}
ServerConnectionIdentifier sci = new ServerConnectionIdentifier();
if(uri.length() == targetURI.length()) {
sci.setHostName(LOCAL_HOST);
sci.setHostPort(HOST_PORT);
} else {
String reminder = uri.substring(targetURI.length());
String[] splitted = reminder.split(URI_SEPARATOR);
if (splitted.length<2) {
throw new Exception(xlocalStrings.getLocalString(
"enterprise.deployapi.spi.invaliduri", // NOI18N
"Invalid URI")); // NOI18N
}
if ("".equals(splitted[0])) {
sci.setHostName(LOCAL_HOST);
} else {
sci.setHostName(splitted[0]);
}
if ("".equals(splitted[1])) {
sci.setHostPort(HOST_PORT);
} else {
sci.setHostPort(Integer.parseInt(splitted[1]));
}
if (splitted.length>2) {
if (HTTPS.equals(splitted[2])) {
sci.setSecure(true);
}
}
}
return sci;
}
}