/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright (c) 2006-2010 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://glassfish.dev.java.net/public/CDDL+GPL_1_1.html
* or packager/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 packager/legal/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 com.sun.enterprise.deploy.shared;
import com.sun.logging.LogDomains;
import org.glassfish.api.ContractProvider;
import org.glassfish.api.deployment.DeployCommandParameters;
import org.glassfish.api.deployment.archive.ReadableArchive;
import org.glassfish.api.deployment.archive.ReadableArchiveFactory;
import org.glassfish.api.deployment.archive.WritableArchive;
import org.glassfish.deployment.common.DeploymentUtils;
import org.jvnet.hk2.annotations.Inject;
import org.jvnet.hk2.annotations.Scoped;
import org.jvnet.hk2.annotations.Service;
import org.jvnet.hk2.component.ComponentException;
import org.jvnet.hk2.component.Habitat;
import org.jvnet.hk2.component.Singleton;
import java.io.File;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.net.MalformedURLException;
import java.net.URI;
import java.net.URISyntaxException;
import java.util.logging.Level;
import java.util.logging.Logger;
/**
* This implementation of the ArchiveFactory interface
* is capable of creating the right abstraction of the Archive
* interface depending on the protocol used in the URL.
*
* @author Jerome Dochez
*/
@Service
@Scoped(Singleton.class)
public class ArchiveFactory implements ContractProvider {
@Inject
Habitat habitat;
final static Logger logger = LogDomains.getLogger(DeploymentUtils.class, LogDomains.DPL_LOGGER);
public WritableArchive createArchive(File path) throws java.io.IOException {
try {
/*
*Use the expanded constructor so illegal characters (such as embedded blanks) in the path
*will be encoded.
*/
return createArchive(prepareArchiveURI(path));
} catch(java.net.URISyntaxException e) {
return null;
}
}
public WritableArchive createArchive(String protocol, File path) throws java.io.IOException {
try {
/*
*Use the expanded constructor so illegal characters (such as embedded blanks) in the path
*will be encoded.
*/
return createArchive(protocol, prepareArchiveURI(path));
} catch(java.net.URISyntaxException e) {
return null;
}
}
public ReadableArchive openArchive(File path) throws java.io.IOException {
try {
return openArchive(prepareArchiveURI(path));
} catch(java.net.URISyntaxException e) {
return null;
}
}
/**
* Creates a new archivist using the URL as the path. The URL
* protocol will define the type of desired archive (jar, file, etc)
* @param path to the archive
* @return the apropriate archive
*/
public WritableArchive createArchive(URI path) throws IOException {
String protocol = path.getScheme();
return createArchive(protocol, path);
}
public WritableArchive createArchive(String protocol, URI path) throws IOException {
try {
WritableArchive archive = habitat.getComponent(WritableArchive.class, protocol);
if (archive==null) {
logger.log(Level.SEVERE, "Cannot find an archive implementation for " + protocol);
throw new MalformedURLException("Protocol not supported : " + protocol);
}
archive.create(path);
return archive;
} catch (ComponentException e) {
logger.log(Level.SEVERE, "Cannot find an archive implementation for " + protocol, e);
throw new MalformedURLException("Protocol not supported : " + protocol);
}
}
/**
* It first consults {@link ReadableArchiveFactory} to get an archive, if it does not get then delegates to
* {@link #openArchive(java.net.URI)}.
* @param path Application archive, never null
* @param properties property bag, can contain for example deploy time properties. Never null
* @return Gives {@link ReadableArchive}.
* @throws IOException
*/
public ReadableArchive openArchive(File path, DeployCommandParameters properties) throws IOException {
URI uri;
try {
uri = prepareArchiveURI(path);
} catch (URISyntaxException e) {
return null;
}
for (ReadableArchiveFactory fac : habitat.getAllByContract(ReadableArchiveFactory.class)) {
//get the first ReadableArchive and move
ReadableArchive archive=null;
try{
archive = fac.open(uri, properties);
}catch(Exception e){
//ignore?
}
if(archive == null)
continue;
return archive;
}
return openArchive(path);
}
/**
* Opens an existing archivist using the URL as the path.
* The URL protocol will defines the type of desired archive
* (jar, file, memory, etc...)
* @param path url to the existing archive
* @return the appropriate archive
*/
public ReadableArchive openArchive(URI path) throws IOException {
String provider = path.getScheme();
if (provider.equals("file")) {
// this could be a jar file or a directory
File f = new File(path);
if (!f.exists()) throw new FileNotFoundException(f.getPath());
if (f.isFile()) {
provider = "jar";
}
}
try {
ReadableArchive archive = habitat.getComponent(ReadableArchive.class, provider);
if (archive==null) {
logger.log(Level.SEVERE, "Cannot find an archive implementation for " + provider);
throw new MalformedURLException("Protocol not supported : " + provider);
}
archive.open(path);
return archive;
} catch (ComponentException e) {
logger.log(Level.SEVERE, "Cannot find an archive implementation for " + provider, e);
throw new MalformedURLException("Protocol not supported : " + provider);
}
}
/**
*Create a URI for the jar specified by the path string.
*<p>
*The steps used here correctly encode "illegal" characters - such as embedded blanks - in
*the path string that otherwise would render the URI unusable. The URI constructor that
*accepts just the path string does not perform this encoding.
*@param path string for the archive
*@return URI with any necessary encoding of special characters
*/
static java.net.URI prepareArchiveURI(File path) throws java.net.URISyntaxException, java.io.UnsupportedEncodingException, java.io.IOException {
URI archiveURI = path.toURI();
URI answer = new URI(archiveURI.getScheme(), null /* authority */, archiveURI.getPath(), null /* query */, null /* fragment */);
return answer;
}
}