Browse Source
Since git-core ff5effd (v1.7.12.1) the native wire protocol transmits the server and client implementation and version strings using capability "agent=git/1.7.12.1" or similar. Support this in JGit and hang the implementation data off UploadPack and ReceivePack. On HTTP transports default to the User-Agent HTTP header until the client overrides this with the optional capability string in the first line. Extract the user agent string into a UserAgent class under transport where it can be specified to a different value if the application's build process has broken the Implementation-Version header in the JGit package. Change-Id: Icfc6524d84a787386d1786310b421b2f92ae9e65stable-4.1
Shawn Pearce
10 years ago
18 changed files with 392 additions and 27 deletions
@ -0,0 +1,80 @@
|
||||
/* |
||||
* Copyright (C) 2015, Google Inc. |
||||
* and other copyright owners as documented in the project's IP log. |
||||
* |
||||
* This program and the accompanying materials are made available |
||||
* under the terms of the Eclipse Distribution License v1.0 which |
||||
* accompanies this distribution, is reproduced below, and is |
||||
* available at http://www.eclipse.org/org/documents/edl-v10.php
|
||||
* |
||||
* All rights reserved. |
||||
* |
||||
* Redistribution and use in source and binary forms, with or |
||||
* without modification, are permitted provided that the following |
||||
* conditions are met: |
||||
* |
||||
* - Redistributions of source code must retain the above copyright |
||||
* notice, this list of conditions and the following disclaimer. |
||||
* |
||||
* - Redistributions in binary form must reproduce the above |
||||
* copyright notice, this list of conditions and the following |
||||
* disclaimer in the documentation and/or other materials provided |
||||
* with the distribution. |
||||
* |
||||
* - Neither the name of the Eclipse Foundation, Inc. nor the |
||||
* names of its contributors may be used to endorse or promote |
||||
* products derived from this software without specific prior |
||||
* written permission. |
||||
* |
||||
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND |
||||
* CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, |
||||
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
||||
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
||||
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR |
||||
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT |
||||
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; |
||||
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER |
||||
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, |
||||
* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) |
||||
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF |
||||
* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
||||
*/ |
||||
|
||||
package org.eclipse.jgit.transport; |
||||
|
||||
/** |
||||
* Internal API to to assist {@code org.eclipse.jgit.http.server}. |
||||
* <p> |
||||
* <b>Do not call.</b> |
||||
* |
||||
* @since 4.0 |
||||
*/ |
||||
public class InternalHttpServerGlue { |
||||
/** |
||||
* Apply a default user agent for a request. |
||||
* |
||||
* @param up |
||||
* current UploadPack instance. |
||||
* @param agent |
||||
* user agent string from the HTTP headers. |
||||
*/ |
||||
public static void setPeerUserAgent(UploadPack up, String agent) { |
||||
up.userAgent = agent; |
||||
} |
||||
|
||||
/** |
||||
* Apply a default user agent for a request. |
||||
* |
||||
* @param rp |
||||
* current ReceivePack instance. |
||||
* @param agent |
||||
* user agent string from the HTTP headers. |
||||
*/ |
||||
public static void setPeerUserAgent(ReceivePack rp, String agent) { |
||||
rp.userAgent = agent; |
||||
} |
||||
|
||||
private InternalHttpServerGlue() { |
||||
} |
||||
} |
@ -0,0 +1,147 @@
|
||||
/* |
||||
* Copyright (C) 2015, Google Inc. |
||||
* and other copyright owners as documented in the project's IP log. |
||||
* |
||||
* This program and the accompanying materials are made available |
||||
* under the terms of the Eclipse Distribution License v1.0 which |
||||
* accompanies this distribution, is reproduced below, and is |
||||
* available at http://www.eclipse.org/org/documents/edl-v10.php
|
||||
* |
||||
* All rights reserved. |
||||
* |
||||
* Redistribution and use in source and binary forms, with or |
||||
* without modification, are permitted provided that the following |
||||
* conditions are met: |
||||
* |
||||
* - Redistributions of source code must retain the above copyright |
||||
* notice, this list of conditions and the following disclaimer. |
||||
* |
||||
* - Redistributions in binary form must reproduce the above |
||||
* copyright notice, this list of conditions and the following |
||||
* disclaimer in the documentation and/or other materials provided |
||||
* with the distribution. |
||||
* |
||||
* - Neither the name of the Eclipse Foundation, Inc. nor the |
||||
* names of its contributors may be used to endorse or promote |
||||
* products derived from this software without specific prior |
||||
* written permission. |
||||
* |
||||
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND |
||||
* CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, |
||||
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
||||
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
||||
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR |
||||
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT |
||||
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; |
||||
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER |
||||
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, |
||||
* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) |
||||
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF |
||||
* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
||||
*/ |
||||
|
||||
package org.eclipse.jgit.transport; |
||||
|
||||
import static org.eclipse.jgit.transport.GitProtocolConstants.OPTION_AGENT; |
||||
|
||||
import java.util.Set; |
||||
|
||||
import org.eclipse.jgit.util.StringUtils; |
||||
|
||||
/** |
||||
* User agent to be reported by this JGit client and server on the network. |
||||
* <p> |
||||
* On HTTP transports this user agent string is always supplied by the JGit |
||||
* client in the {@code User-Agent} HTTP header. |
||||
* <p> |
||||
* On native transports this user agent string is always sent when JGit is a |
||||
* server. When JGit is a client the user agent string will be supplied to the |
||||
* remote server only if the remote server advertises its own agent identity. |
||||
* |
||||
* @since 4.0 |
||||
*/ |
||||
public class UserAgent { |
||||
private static volatile String userAgent = computeUserAgent(); |
||||
|
||||
private static String computeUserAgent() { |
||||
return clean("JGit/" + computeVersion()); //$NON-NLS-1$
|
||||
} |
||||
|
||||
private static String computeVersion() { |
||||
Package pkg = UserAgent.class.getPackage(); |
||||
if (pkg != null) { |
||||
String ver = pkg.getImplementationVersion(); |
||||
if (!StringUtils.isEmptyOrNull(ver)) { |
||||
return ver; |
||||
} |
||||
} |
||||
return "unknown"; //$NON-NLS-1$
|
||||
} |
||||
|
||||
private static String clean(String s) { |
||||
s = s.trim(); |
||||
StringBuilder b = new StringBuilder(s.length()); |
||||
for (int i = 0; i < s.length(); i++) { |
||||
char c = s.charAt(i); |
||||
if (c <= 32 || c >= 127) { |
||||
if (b.length() > 0 && b.charAt(b.length() - 1) == '.') |
||||
continue; |
||||
c = '.'; |
||||
} |
||||
b.append(c); |
||||
} |
||||
return b.length() > 0 ? b.toString() : null; |
||||
} |
||||
|
||||
/** |
||||
* Get the user agent string advertised by JGit. |
||||
* |
||||
* @return a string similar to {@code "JGit/4.0"}; null if the agent has |
||||
* been cleared and should not be shared with a peer. |
||||
*/ |
||||
public static String get() { |
||||
return userAgent; |
||||
} |
||||
|
||||
/** |
||||
* Change the user agent string advertised by JGit. |
||||
* <p> |
||||
* The new string should start with {@code "JGit/"} (for example |
||||
* {@code "JGit/4.0"}) to advertise the implementation as JGit based. |
||||
* <p> |
||||
* Spaces and other whitespace should be avoided as these will be |
||||
* automatically converted to {@code "."}. |
||||
* <p> |
||||
* User agent strings are restricted to printable ASCII. |
||||
* |
||||
* @param agent |
||||
* new user agent string for this running JGit library. Setting |
||||
* to null or empty string will avoid sending any identification |
||||
* to the peer. |
||||
*/ |
||||
public static void set(String agent) { |
||||
userAgent = StringUtils.isEmptyOrNull(agent) ? null : clean(agent); |
||||
} |
||||
|
||||
static String getAgent(Set<String> options, String transportAgent) { |
||||
if (options == null || options.isEmpty()) { |
||||
return transportAgent; |
||||
} |
||||
for (String o : options) { |
||||
if (o.startsWith(OPTION_AGENT) |
||||
&& o.length() > OPTION_AGENT.length() |
||||
&& o.charAt(OPTION_AGENT.length()) == '=') { |
||||
return o.substring(OPTION_AGENT.length() + 1); |
||||
} |
||||
} |
||||
return transportAgent; |
||||
} |
||||
|
||||
static boolean hasAgent(Set<String> options) { |
||||
return getAgent(options, null) != null; |
||||
} |
||||
|
||||
private UserAgent() { |
||||
} |
||||
} |
Loading…
Reference in new issue