org.ops4j.pax.url.mvn.internal

Class Connection

java.lang.Object

java.net.URLConnection

org.ops4j.pax.url.mvn.internal.Connection

public class Connection
extends URLConnection

An URLConnection that supports mvn: protocol.
Syntax:
mvn:[repository_url!]groupId/artifactId[/version[/type]]
where:
- repository_url = an url that points to a maven 2 repository; optional, if not specified the repositories are resolved based on the repository/localRepository.
- groupId = group id of maven artifact; mandatory
- artifactId = artifact id of maven artifact; mandatory
- version = version of maven artifact; optional, if not specified uses LATEST and will try to resolve the version from available maven metadata. If version is a SNAPSHOT version, SNAPSHOT will be resolved from available maven metadata
- type = type of maven artifact; optional, if not specified uses JAR
Examples:
mvn:http://repository.ops4j.org/mvn-releases!org.ops4j.pax.runner/runner/0.4.0 - an artifact from an http repository
mvn:http://user:password@repository.ops4j.org/mvn-releases!org.ops4j.pax.runner/runner/0.4.0 - an artifact from an http repository with authentication
mvn:file://c:/localRepo!org.ops4j.pax.runner/runner/0.4.0 - an artifact from a directory
mvn:jar:file://c:/repo.zip!/repository!org.ops4j.pax.runner/runner/0.4.0 - an artifact from a zip file
mvn:org.ops4j.pax.runner/runner/0.4.0 - an artifact that will be resolved based on the configured repositories

The service can be configured in two ways: via configuration admin if available and via framework/system properties where the configuration via config admin has priority.
Service configuration:
- org.ops4j.pax.url.mvn.settings = the path to settings.xml;
- org.ops4j.pax.url.mvn.localRepository = the path to local repository directory;
- org.ops4j.pax.url.mvn.repository = a comma separated list for repositories urls;
- org.ops4j.pax.url.mvn.certificateCheck = true/false if the SSL certificate check should be done. Default false.

Since:

September 10, 2010

Author:

Toni Menzel, Alin Dreghiciu, Guillaume Nodet

Field Summary

Fields inherited from class java.net.URLConnection

allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches

Constructor Summary

Constructors

Constructor and Description
Connection(URL url, MavenResolver resolver) Creates a new connection.

Method Summary

Modifier and Type	Method and Description
void	connect() Does nothing.
InputStream	getInputStream() TODO doc

Methods inherited from class java.net.URLConnection

addRequestProperty, getAllowUserInteraction, getConnectTimeout, getContent, getContent, getContentEncoding, getContentLength, getContentLengthLong, getContentType, getDate, getDefaultAllowUserInteraction, getDefaultRequestProperty, getDefaultUseCaches, getDoInput, getDoOutput, getExpiration, getFileNameMap, getHeaderField, getHeaderField, getHeaderFieldDate, getHeaderFieldInt, getHeaderFieldKey, getHeaderFieldLong, getHeaderFields, getIfModifiedSince, getLastModified, getOutputStream, getPermission, getReadTimeout, getRequestProperties, getRequestProperty, getURL, getUseCaches, guessContentTypeFromName, guessContentTypeFromStream, setAllowUserInteraction, setConnectTimeout, setContentHandlerFactory, setDefaultAllowUserInteraction, setDefaultRequestProperty, setDefaultUseCaches, setDoInput, setDoOutput, setFileNameMap, setIfModifiedSince, setReadTimeout, setRequestProperty, setUseCaches, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Connection

public Connection(URL url,
                  MavenResolver resolver)
           throws MalformedURLException

Creates a new connection.

Parameters:

url - the url; cannot be null.

resolver - resolver service; cannot be null

Throws:

MalformedURLException - in case of a malformed url

Method Detail

connect

public void connect()

Does nothing.

Specified by:

connect in class URLConnection

See Also:

URLConnection.connect()

getInputStream

public InputStream getInputStream()
                           throws IOException

TODO doc

Overrides:

getInputStream in class URLConnection

Throws:

IOException