/** * The MIT License (MIT) * * Copyright (c) 2014-2017 Yegor Bugayenko * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included * in all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. */ package org.takes.facets.fork; import java.io.IOException; import java.net.HttpURLConnection; import java.util.Arrays; import java.util.Collection; import java.util.Collections; import lombok.EqualsAndHashCode; import lombok.ToString; import org.takes.HttpException; import org.takes.Request; import org.takes.Response; import org.takes.Take; import org.takes.misc.Opt; /** * Fork take. * * <p>This is the implementation of {@link org.takes.Take} that * routes the requests to another take, using a collection of forks * to pick the right one. The best example is a routing by regular * expression, for example: * * <pre> Take take = new TkFork( * new FkRegex("/home", new TkHome()), * new FkRegex("/account", new TkAccount()) * );</pre> * * <p>Here, {@link TkFork} will try to call these * "forks" one by one, asking whether they accept the request. The first * one that reacts will get control. Each "fork" is an implementation * of {@link org.takes.facets.fork.Fork}. * * <p>The class is immutable and thread-safe. * * @author Yegor Bugayenko (yegor256@gmail.com) * @version $Id: e7d4a7426c44742266940770513e4964b6b68815 $ * @since 0.4 * @see org.takes.facets.fork.FkMethods * @see org.takes.facets.fork.FkRegex * @see org.takes.facets.fork.FkParams */ @ToString(of = "forks") @EqualsAndHashCode public final class TkFork implements Take { /** * Patterns and their respective take. */ private final Collection<Fork> forks; /** * Ctor. */ public TkFork() { this(Collections.<Fork>emptyList()); } /** * Ctor. * @param frks Forks */ public TkFork(final Fork... frks) { this(Arrays.asList(frks)); } /** * Ctor. * @param frks Forks */ public TkFork(final Collection<Fork> frks) { this.forks = Collections.unmodifiableCollection(frks); } @Override public Response act(final Request request) throws IOException { final Opt<Response> response = new FkChain(this.forks).route(request); if (response.has()) { return response.get(); } throw new HttpException(HttpURLConnection.HTTP_NOT_FOUND); } }