123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147 |
- /*
- * 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() {
- }
- }
|