/* * Copyright (C) 2009-2010, 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.glue; import static javax.servlet.http.HttpServletResponse.SC_NOT_FOUND; import java.io.IOException; import java.text.MessageFormat; import java.util.AbstractSet; import java.util.ArrayList; import java.util.IdentityHashMap; import java.util.Iterator; import java.util.List; import java.util.Map; import java.util.Set; import javax.servlet.ServletException; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import org.eclipse.jgit.http.server.HttpServerText; /** * Generic container servlet to manage routing to different pipelines. *

* Callers can create and configure a new processing pipeline by using one of * the {@link #serve(String)} or {@link #serveRegex(String)} methods to allocate * a binder for a particular URL pattern. *

* Registered filters and servlets are initialized lazily, usually during the * first request. Once initialized the bindings in this servlet cannot be * modified without destroying the servlet and thereby destroying all registered * filters and servlets. */ public class MetaServlet extends HttpServlet { private static final long serialVersionUID = 1L; static final String REGEX_GROUPS = "org.eclipse.jgit.http.server.glue.MetaServlet.serveRegex"; private final List bindings; private volatile UrlPipeline[] pipelines; /** Empty servlet with no bindings. */ public MetaServlet() { this.bindings = new ArrayList(); } /** * Construct a binding for a specific path. * * @param path * pattern to match. * @return binder for the passed path. */ public ServletBinder serve(String path) { if (path.startsWith("*")) return register(new SuffixPipeline.Binder(path.substring(1))); throw new IllegalArgumentException(MessageFormat.format(HttpServerText.get().pathNotSupported, path)); } /** * Construct a binding for a regular expression. * * @param expression * the regular expression to pattern match the URL against. * @return binder for the passed expression. */ public ServletBinder serveRegex(String expression) { return register(new RegexPipeline.Binder(expression)); } public void destroy() { if (pipelines != null) { Set destroyed = newIdentitySet(); for (UrlPipeline p : pipelines) p.destroy(destroyed); pipelines = null; } } private static Set newIdentitySet() { final Map m = new IdentityHashMap(); return new AbstractSet() { @Override public boolean add(Object o) { return m.put(o, o) == null; } @Override public boolean contains(Object o) { return m.keySet().contains(o); } @Override public Iterator iterator() { return m.keySet().iterator(); } @Override public int size() { return m.size(); } }; } @Override protected void service(final HttpServletRequest req, final HttpServletResponse rsp) throws ServletException, IOException { final UrlPipeline p = find(req); if (p != null) p.service(req, rsp); else rsp.sendError(SC_NOT_FOUND); } private UrlPipeline find(final HttpServletRequest req) throws ServletException { for (UrlPipeline p : getPipelines()) if (p.match(req)) return p; return null; } private ServletBinder register(ServletBinderImpl b) { synchronized (bindings) { if (pipelines != null) throw new IllegalStateException(HttpServerText.get().servletAlreadyInitialized); bindings.add(b); } return register((ServletBinder) b); } /** * Configure a newly created binder. * * @param b * the newly created binder. * @return binder for the caller, potentially after adding one or more * filters into the pipeline. */ protected ServletBinder register(ServletBinder b) { return b; } private UrlPipeline[] getPipelines() throws ServletException { UrlPipeline[] r = pipelines; if (r == null) { synchronized (bindings) { r = pipelines; if (r == null) { r = createPipelines(); pipelines = r; } } } return r; } private UrlPipeline[] createPipelines() throws ServletException { UrlPipeline[] array = new UrlPipeline[bindings.size()]; for (int i = 0; i < bindings.size(); i++) array[i] = bindings.get(i).create(); Set inited = newIdentitySet(); for (UrlPipeline p : array) p.init(getServletContext(), inited); return array; } }