public class TransportHttp extends HttpTransport implements WalkTransport, PackTransport
If the transport is using HTTP and the remote HTTP service is Git-aware (speaks the "smart-http protocol") this client will automatically take advantage of the additional Git-specific HTTP extensions. If the remote service does not support these extensions, the client will degrade to direct file fetching.
If the remote (server side) repository does not have the specialized Git support, object files are retrieved directly through standard HTTP GET (or binary FTP GET) requests. This make it easy to serve a Git repository through a standard web host provider that does not offer specific support for Git.
WalkFetchConnection
Modifier and Type | Class and Description |
---|---|
static class |
TransportHttp.AcceptEncoding
Accept-Encoding header in the HTTP request
(https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
|
Transport.Operation
connectionFactory
DEFAULT_FETCH_THIN, DEFAULT_PUSH_THIN, local, REFSPEC_PUSH_ALL, REFSPEC_TAGS, uri
Modifier and Type | Method and Description |
---|---|
void |
close() |
protected HttpConnection |
httpOpen(String method,
URL u,
TransportHttp.AcceptEncoding acceptEncoding)
Open an HTTP connection.
|
FetchConnection |
openFetch()
Begins a new connection for fetching from the remote repository.
|
PushConnection |
openPush()
Begins a new connection for pushing into the remote repository.
|
void |
setAdditionalHeaders(Map<String,String> headers)
Set additional headers on the HTTP connection
|
protected void |
setURI(URIish uri)
Set uri a
URIish object. |
void |
setUseSmartHttp(boolean on)
Toggle whether or not smart HTTP transport should be used.
|
getConnectionFactory, setConnectionFactory
applyConfig, fetch, findRemoteRefUpdatesFor, findRemoteRefUpdatesFor, findRemoteRefUpdatesFor, findRemoteRefUpdatesFor, getCredentialsProvider, getFilterBlobLimit, getFilterSpec, getObjectChecker, getOptionReceivePack, getOptionUploadPack, getPackConfig, getPushOptions, getTagOpt, getTimeout, getTransportProtocols, getURI, isCheckFetchedObjects, isDryRun, isFetchThin, isPushAtomic, isPushThin, isRemoveDeletedRefs, open, open, open, open, open, open, open, openAll, openAll, openAll, openAll, push, push, register, setCheckFetchedObjects, setCredentialsProvider, setDryRun, setFetchThin, setFilterBlobLimit, setFilterSpec, setObjectChecker, setOptionReceivePack, setOptionUploadPack, setPackConfig, setPushAtomic, setPushOptions, setPushThin, setRemoveDeletedRefs, setTagOpt, setTimeout, unregister
protected void setURI(URIish uri) throws NotSupportedException
URIish
object.uri
- a URIish
object.NotSupportedException
public void setUseSmartHttp(boolean on)
This flag exists primarily to support backwards compatibility testing within a testing framework, there is no need to modify it in most applications.
on
- if true
(default), smart HTTP is enabled.public FetchConnection openFetch() throws TransportException, NotSupportedException
If the transport has no local repository, the fetch connection can only be used for reading remote refs.
openFetch
in class Transport
TransportException
- the remote connection could not be established.NotSupportedException
- the implementation does not support fetching.public PushConnection openPush() throws NotSupportedException, TransportException
openPush
in class Transport
NotSupportedException
- the implementation does not support pushing.TransportException
- the remote connection could not be establishedpublic void close()
Close any resources used by this transport.
If the remote repository is contacted by a network socket this method must close that network socket, disconnecting the two peers. If the remote repository is actually local (same system) this method must close any open file handles used to read the "remote" repository.
AutoClosable.close()
declares that it throws Exception
.
Implementers shouldn't throw checked exceptions. This override narrows
the signature to prevent them from doing so.
close
in interface AutoCloseable
close
in class Transport
public void setAdditionalHeaders(Map<String,String> headers)
headers
- a map of name:values that are to be set as headers on the HTTP
connectionprotected HttpConnection httpOpen(String method, URL u, TransportHttp.AcceptEncoding acceptEncoding) throws IOException
method
- HTTP request methodu
- url of the HTTP connectionacceptEncoding
- accept-encoding header optionIOException
Copyright © 2019 Eclipse JGit Project. All rights reserved.