Browse Source
* changes: Add utilities for smart HTTP error handling Strip leading slashes in RepositoryFilterstable-1.2
Shawn O. Pearce
13 years ago
committed by
Code Review
8 changed files with 357 additions and 98 deletions
@ -0,0 +1,309 @@ |
|||||||
|
/* |
||||||
|
* Copyright (C) 2011, 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.http.server; |
||||||
|
|
||||||
|
import static javax.servlet.http.HttpServletResponse.SC_FORBIDDEN; |
||||||
|
import static javax.servlet.http.HttpServletResponse.SC_INTERNAL_SERVER_ERROR; |
||||||
|
import static javax.servlet.http.HttpServletResponse.SC_NOT_FOUND; |
||||||
|
|
||||||
|
import java.io.ByteArrayOutputStream; |
||||||
|
import java.io.IOException; |
||||||
|
import java.util.Arrays; |
||||||
|
import java.util.Collections; |
||||||
|
import java.util.List; |
||||||
|
|
||||||
|
import javax.servlet.ServletOutputStream; |
||||||
|
import javax.servlet.http.HttpServletRequest; |
||||||
|
import javax.servlet.http.HttpServletResponse; |
||||||
|
|
||||||
|
import org.eclipse.jgit.lib.Constants; |
||||||
|
import org.eclipse.jgit.transport.PacketLineOut; |
||||||
|
|
||||||
|
/** |
||||||
|
* Utility functions for handling the Git-over-HTTP protocol. |
||||||
|
*/ |
||||||
|
public class GitSmartHttpTools { |
||||||
|
private static final String INFO_REFS = Constants.INFO_REFS; |
||||||
|
|
||||||
|
/** Name of the git-upload-pack service. */ |
||||||
|
public static final String UPLOAD_PACK = "git-upload-pack"; |
||||||
|
|
||||||
|
/** Name of the git-receive-pack service. */ |
||||||
|
public static final String RECEIVE_PACK = "git-receive-pack"; |
||||||
|
|
||||||
|
/** Content type supplied by the client to the /git-upload-pack handler. */ |
||||||
|
public static final String UPLOAD_PACK_REQUEST_TYPE = |
||||||
|
"application/x-git-upload-pack-request"; |
||||||
|
|
||||||
|
/** Content type returned from the /git-upload-pack handler. */ |
||||||
|
public static final String UPLOAD_PACK_RESULT_TYPE = |
||||||
|
"application/x-git-upload-pack-result"; |
||||||
|
|
||||||
|
/** Content type supplied by the client to the /git-receive-pack handler. */ |
||||||
|
public static final String RECEIVE_PACK_REQUEST_TYPE = |
||||||
|
"application/x-git-receive-pack-request"; |
||||||
|
|
||||||
|
/** Content type returned from the /git-receive-pack handler. */ |
||||||
|
public static final String RECEIVE_PACK_RESULT_TYPE = |
||||||
|
"application/x-git-receive-pack-result"; |
||||||
|
|
||||||
|
/** Git service names accepted by the /info/refs?service= handler. */ |
||||||
|
public static final List<String> VALID_SERVICES = |
||||||
|
Collections.unmodifiableList(Arrays.asList(new String[] { |
||||||
|
UPLOAD_PACK, RECEIVE_PACK })); |
||||||
|
|
||||||
|
private static final String INFO_REFS_PATH = "/" + INFO_REFS; |
||||||
|
private static final String UPLOAD_PACK_PATH = "/" + UPLOAD_PACK; |
||||||
|
private static final String RECEIVE_PACK_PATH = "/" + RECEIVE_PACK; |
||||||
|
|
||||||
|
private static final List<String> SERVICE_SUFFIXES = |
||||||
|
Collections.unmodifiableList(Arrays.asList(new String[] { |
||||||
|
INFO_REFS_PATH, UPLOAD_PACK_PATH, RECEIVE_PACK_PATH })); |
||||||
|
|
||||||
|
/** |
||||||
|
* Check a request for Git-over-HTTP indicators. |
||||||
|
* |
||||||
|
* @param req |
||||||
|
* the current HTTP request that may have been made by Git. |
||||||
|
* @return true if the request is likely made by a Git client program. |
||||||
|
*/ |
||||||
|
public static boolean isGitClient(HttpServletRequest req) { |
||||||
|
return isInfoRefs(req) || isUploadPack(req) || isReceivePack(req); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* Send an error to the Git client or browser. |
||||||
|
* <p> |
||||||
|
* Server implementors may use this method to send customized error messages |
||||||
|
* to a Git protocol client using an HTTP 200 OK response with the error |
||||||
|
* embedded in the payload. If the request was not issued by a Git client, |
||||||
|
* an HTTP response code is returned instead. |
||||||
|
* |
||||||
|
* @param req |
||||||
|
* current request. |
||||||
|
* @param res |
||||||
|
* current response. |
||||||
|
* @param httpStatus |
||||||
|
* HTTP status code to set if the client is not a Git client. |
||||||
|
* @throws IOException |
||||||
|
* the response cannot be sent. |
||||||
|
*/ |
||||||
|
public static void sendError(HttpServletRequest req, |
||||||
|
HttpServletResponse res, int httpStatus) throws IOException { |
||||||
|
sendError(req, res, httpStatus, null); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* Send an error to the Git client or browser. |
||||||
|
* <p> |
||||||
|
* Server implementors may use this method to send customized error messages |
||||||
|
* to a Git protocol client using an HTTP 200 OK response with the error |
||||||
|
* embedded in the payload. If the request was not issued by a Git client, |
||||||
|
* an HTTP response code is returned instead. |
||||||
|
* |
||||||
|
* @param req |
||||||
|
* current request. |
||||||
|
* @param res |
||||||
|
* current response. |
||||||
|
* @param httpStatus |
||||||
|
* HTTP status code to set if the client is not a Git client. |
||||||
|
* @param textForGit |
||||||
|
* plain text message to display on the user's console. This is |
||||||
|
* shown only if the client is likely to be a Git client. If null |
||||||
|
* or the empty string a default text is chosen based on the HTTP |
||||||
|
* response code. |
||||||
|
* @throws IOException |
||||||
|
* the response cannot be sent. |
||||||
|
*/ |
||||||
|
public static void sendError(HttpServletRequest req, |
||||||
|
HttpServletResponse res, int httpStatus, String textForGit) |
||||||
|
throws IOException { |
||||||
|
if (textForGit == null || textForGit.length() == 0) { |
||||||
|
switch (httpStatus) { |
||||||
|
case SC_FORBIDDEN: |
||||||
|
textForGit = HttpServerText.get().repositoryAccessForbidden; |
||||||
|
break; |
||||||
|
case SC_NOT_FOUND: |
||||||
|
textForGit = HttpServerText.get().repositoryNotFound; |
||||||
|
break; |
||||||
|
case SC_INTERNAL_SERVER_ERROR: |
||||||
|
textForGit = HttpServerText.get().internalServerError; |
||||||
|
break; |
||||||
|
default: |
||||||
|
textForGit = "HTTP " + httpStatus; |
||||||
|
break; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
ByteArrayOutputStream buf = new ByteArrayOutputStream(128); |
||||||
|
PacketLineOut pck = new PacketLineOut(buf); |
||||||
|
|
||||||
|
if (isInfoRefs(req)) { |
||||||
|
String svc = req.getParameter("service"); |
||||||
|
pck.writeString("# service=" + svc + "\n"); |
||||||
|
pck.end(); |
||||||
|
pck.writeString("ERR " + textForGit); |
||||||
|
send(res, infoRefsResultType(svc), buf.toByteArray()); |
||||||
|
} else if (isUploadPack(req)) { |
||||||
|
pck.writeString("ERR " + textForGit); |
||||||
|
send(res, UPLOAD_PACK_RESULT_TYPE, buf.toByteArray()); |
||||||
|
} else if (isReceivePack(req)) { |
||||||
|
pck.writeString("ERR " + textForGit); |
||||||
|
send(res, RECEIVE_PACK_RESULT_TYPE, buf.toByteArray()); |
||||||
|
} else { |
||||||
|
res.sendError(httpStatus); |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
private static void send(HttpServletResponse res, String type, byte[] buf) |
||||||
|
throws IOException { |
||||||
|
res.setStatus(HttpServletResponse.SC_OK); |
||||||
|
res.setContentType(type); |
||||||
|
res.setContentLength(buf.length); |
||||||
|
ServletOutputStream os = res.getOutputStream(); |
||||||
|
try { |
||||||
|
os.write(buf); |
||||||
|
} finally { |
||||||
|
os.close(); |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* Get the response Content-Type a client expects for the request. |
||||||
|
* <p> |
||||||
|
* This method should only be invoked if |
||||||
|
* {@link #isGitClient(HttpServletRequest)} is true. |
||||||
|
* |
||||||
|
* @param req |
||||||
|
* current request. |
||||||
|
* @return the Content-Type the client expects. |
||||||
|
* @throws IllegalArgumentException |
||||||
|
* the request is not a Git client request. See |
||||||
|
* {@link #isGitClient(HttpServletRequest)}. |
||||||
|
*/ |
||||||
|
public static String getResponseContentType(HttpServletRequest req) { |
||||||
|
if (isInfoRefs(req)) |
||||||
|
return infoRefsResultType(req.getParameter("service")); |
||||||
|
else if (isUploadPack(req)) |
||||||
|
return UPLOAD_PACK_RESULT_TYPE; |
||||||
|
else if (isReceivePack(req)) |
||||||
|
return RECEIVE_PACK_RESULT_TYPE; |
||||||
|
else |
||||||
|
throw new IllegalArgumentException(); |
||||||
|
} |
||||||
|
|
||||||
|
static String infoRefsResultType(String svc) { |
||||||
|
return "application/x-" + svc + "-advertisement"; |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* Strip the Git service suffix from a request path. |
||||||
|
* |
||||||
|
* Generally the suffix is stripped by the {@code SuffixPipeline} handling |
||||||
|
* the request, so this method is rarely needed. |
||||||
|
* |
||||||
|
* @param path |
||||||
|
* the path of the request. |
||||||
|
* @return the path up to the last path component before the service suffix; |
||||||
|
* the path as-is if it contains no service suffix. |
||||||
|
*/ |
||||||
|
public static String stripServiceSuffix(String path) { |
||||||
|
for (String suffix : SERVICE_SUFFIXES) { |
||||||
|
if (path.endsWith(suffix)) |
||||||
|
return path.substring(0, path.length() - suffix.length()); |
||||||
|
} |
||||||
|
return path; |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* Check if the HTTP request was for the /info/refs?service= Git handler. |
||||||
|
* |
||||||
|
* @param req |
||||||
|
* current request. |
||||||
|
* @return true if the request is for the /info/refs service. |
||||||
|
*/ |
||||||
|
public static boolean isInfoRefs(HttpServletRequest req) { |
||||||
|
return req.getRequestURI().endsWith(INFO_REFS_PATH) |
||||||
|
&& VALID_SERVICES.contains(req.getParameter("service")); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* Check if the HTTP request path ends with the /git-upload-pack handler. |
||||||
|
* |
||||||
|
* @param pathOrUri |
||||||
|
* path or URI of the request. |
||||||
|
* @return true if the request is for the /git-upload-pack handler. |
||||||
|
*/ |
||||||
|
public static boolean isUploadPack(String pathOrUri) { |
||||||
|
return pathOrUri != null && pathOrUri.endsWith(UPLOAD_PACK_PATH); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* Check if the HTTP request was for the /git-upload-pack Git handler. |
||||||
|
* |
||||||
|
* @param req |
||||||
|
* current request. |
||||||
|
* @return true if the request is for the /git-upload-pack handler. |
||||||
|
*/ |
||||||
|
public static boolean isUploadPack(HttpServletRequest req) { |
||||||
|
return isUploadPack(req.getRequestURI()) |
||||||
|
&& UPLOAD_PACK_REQUEST_TYPE.equals(req.getContentType()); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* Check if the HTTP request was for the /git-receive-pack Git handler. |
||||||
|
* |
||||||
|
* @param req |
||||||
|
* current request. |
||||||
|
* @return true if the request is for the /git-receive-pack handler. |
||||||
|
*/ |
||||||
|
public static boolean isReceivePack(HttpServletRequest req) { |
||||||
|
String uri = req.getRequestURI(); |
||||||
|
return uri != null && uri.endsWith(RECEIVE_PACK_PATH) |
||||||
|
&& RECEIVE_PACK_REQUEST_TYPE.equals(req.getContentType()); |
||||||
|
} |
||||||
|
|
||||||
|
private GitSmartHttpTools() { |
||||||
|
} |
||||||
|
} |
Loading…
Reference in new issue