org.takes.facets.fork

Class FkRegex

java.lang.Object

org.takes.facets.fork.FkRegex

All Implemented Interfaces:

Fork

public final class FkRegex
extends Object
implements Fork

Fork by regular expression pattern.

Use this class in combination with TkFork, for example:

 Take take = new TkFork(
   new FkRegex("/home", new TkHome()),
   new FkRegex("/account", new TkAccount())
 );

Each instance of FkRegex is being asked only once by TkFork whether the request is good enough to be processed. If the request is suitable for this particular fork, it will return the relevant Take.

Also, keep in mind that the second argument of the constructor may be of type TkRegex and accept an instance of RqRegex, which makes it very convenient to reuse regular expression matcher, for example:

 Take take = new TkFork(
   new FkRegex(
     "/file(.*)",
     new Target<RqRegex>() {
       @Override
       public Response act(final RqRegex req) {
         // Here we immediately getting access to the
         // matcher that was used during parsing of
         // the incoming request
         final String file = req.matcher().group(1);
       }
     }
   )
 );

The class is immutable and thread-safe.

Since:

0.4

Version:

$Id$

Author:

Yegor Bugayenko ([email protected])

See Also:

TkFork, TkRegex

Constructor Summary

Constructors

Constructor and Description
FkRegex(Pattern ptn, Response rsp) Ctor.
FkRegex(Pattern ptn, Take tks) Ctor.
FkRegex(Pattern ptn, TkRegex tgt) Ctor.
FkRegex(String ptn, Response rsp) Ctor.
FkRegex(String ptn, String text) Ctor.
FkRegex(String ptn, Take tks) Ctor.
FkRegex(String ptn, TkRegex tgt) Ctor.

Method Summary

Methods

Modifier and Type	Method and Description
Opt<Response>	route(Request req) Process this request or ignore it.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FkRegex

public FkRegex(String ptn,
       String text)

Ctor.

Parameters:

ptn - Pattern

text - Text

FkRegex

public FkRegex(String ptn,
       Response rsp)

Ctor.

Parameters:

ptn - Pattern

rsp - Response

Since:

0.16

FkRegex

public FkRegex(Pattern ptn,
       Response rsp)

Ctor.

Parameters:

ptn - Pattern

rsp - Response

Since:

0.16

FkRegex

public FkRegex(String ptn,
       Take tks)

Ctor.

Parameters:

ptn - Pattern

tks - Take

FkRegex

public FkRegex(Pattern ptn,
       Take tks)

Ctor.

Parameters:

ptn - Pattern

tks - Take

FkRegex

public FkRegex(String ptn,
       TkRegex tgt)

Ctor.

Parameters:

ptn - Pattern

tgt - Take

FkRegex

public FkRegex(Pattern ptn,
       TkRegex tgt)

Ctor.

Parameters:

ptn - Pattern

tgt - Take

Method Detail

route

public Opt<Response> route(Request req)
                    throws IOException

Description copied from interface: Fork

Process this request or ignore it.

Specified by:

route in interface Fork

Parameters:

req - Request

Returns:

Non-empty list of responses if it was processed

Throws:

IOException - If fails