org.apache.flume.formatter.output
Class BucketPath

java.lang.Object
  org.apache.flume.formatter.output.BucketPath

public class BucketPath
extends Object

Field Summary

static String	TAG_REGEX These are useful to other classes which might want to search for tags in strings.
static Pattern	tagPattern

Constructor Summary

BucketPath()

Method Summary

static boolean	containsTag(String in) Deprecated.
static String	escapeString(String in, Map<String,String> headers) Replace all substrings of form %{tagname} with get(tagname).toString() and all shorthand substrings of form %x with a special value.
static String	escapeString(String in, Map<String,String> headers, boolean needRounding, int unit, int roundDown) A wrapper around escapeString(String, Map, TimeZone, boolean, int, int, boolean) with the timezone set to the default.
static String	escapeString(String in, Map<String,String> headers, TimeZone timeZone, boolean needRounding, int unit, int roundDown, boolean useLocalTimeStamp) Replace all substrings of form %{tagname} with get(tagname).toString() and all shorthand substrings of form %x with a special value.
static String	expandShorthand(char c) Deprecated.
static Clock	getClock()
static Map<String,String>	getEscapeMapping(String in, Map<String,String> headers) Deprecated.
static Map<String,String>	getEscapeMapping(String in, Map<String,String> headers, boolean needRounding, int unit, int roundDown) Deprecated.
static String	replaceShorthand(char c, Map<String,String> headers) Deprecated.
static String	replaceShorthand(char c, Map<String,String> headers, boolean needRounding, int unit, int roundDown) Deprecated.
static String	replaceShorthand(char c, Map<String,String> headers, TimeZone timeZone, boolean needRounding, int unit, int roundDown, boolean useLocalTimestamp) Deprecated.
protected static String	replaceShorthand(char c, Map<String,String> headers, TimeZone timeZone, boolean needRounding, int unit, int roundDown, boolean useLocalTimestamp, long ts) Not intended as a public API
static void	setClock(Clock clk)

Methods inherited from class java.lang.Object

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

Field Detail

TAG_REGEX

public static final String TAG_REGEX

These are useful to other classes which might want to search for tags in strings.

See Also:

Constant Field Values

tagPattern

public static final Pattern tagPattern

Constructor Detail

BucketPath

public BucketPath()

Method Detail

containsTag

@Deprecated
public static boolean containsTag(String in)

Deprecated.

Returns true if in contains a substring matching TAG_REGEX (i.e. of the form %{...} or %x.

expandShorthand

@Deprecated
public static String expandShorthand(char c)

Deprecated.

replaceShorthand

@Deprecated
public static String replaceShorthand(char c,
                                                 Map<String,String> headers)

Deprecated.

Hardcoded lookups for %x style escape replacement. Add your own! All shorthands are Date format strings, currently. Returns the empty string if an escape is not recognized. Dates follow the same format as unix date, with a few exceptions.

This static method will be REMOVED in a future version of Flume

replaceShorthand

@Deprecated
public static String replaceShorthand(char c,
                                                 Map<String,String> headers,
                                                 boolean needRounding,
                                                 int unit,
                                                 int roundDown)

Deprecated.

A wrapper around replaceShorthand(char, Map, TimeZone, boolean, int, int, boolean) with the timezone set to the default.

This static method will be REMOVED in a future version of Flume

replaceShorthand

@Deprecated
public static String replaceShorthand(char c,
                                                 Map<String,String> headers,
                                                 TimeZone timeZone,
                                                 boolean needRounding,
                                                 int unit,
                                                 int roundDown,
                                                 boolean useLocalTimestamp)

Deprecated.

Hardcoded lookups for %x style escape replacement. Add your own! All shorthands are Date format strings, currently. Returns the empty string if an escape is not recognized. Dates follow the same format as unix date, with a few exceptions.

This static method will be REMOVED in a future version of Flume

Parameters:

c - - The character to replace.

headers - - Event headers

timeZone - - The timezone to use for formatting the timestamp

needRounding - - Should the timestamp be rounded down?

unit - - if needRounding is true, what unit to round down to. This must be one of the units specified by Calendar - HOUR, MINUTE or SECOND. Defaults to second, if none of these are present. Ignored if needRounding is false.

roundDown - - if needRounding is true, The time should be rounded to the largest multiple of this value, smaller than the time supplied, defaults to 1, if <= 0(rounds off to the second/minute/hour immediately lower than the timestamp supplied. Ignored if needRounding is false.

Returns:

replaceShorthand

protected static String replaceShorthand(char c,
                                         Map<String,String> headers,
                                         TimeZone timeZone,
                                         boolean needRounding,
                                         int unit,
                                         int roundDown,
                                         boolean useLocalTimestamp,
                                         long ts)

Not intended as a public API

escapeString

public static String escapeString(String in,
                                  Map<String,String> headers)

Replace all substrings of form %{tagname} with get(tagname).toString() and all shorthand substrings of form %x with a special value. Any unrecognized / not found tags will be replaced with the empty string. TODO(henry): we may want to consider taking this out of Event and into a more general class when we get more use cases for this pattern.

escapeString

public static String escapeString(String in,
                                  Map<String,String> headers,
                                  boolean needRounding,
                                  int unit,
                                  int roundDown)

A wrapper around escapeString(String, Map, TimeZone, boolean, int, int, boolean) with the timezone set to the default.

escapeString

public static String escapeString(String in,
                                  Map<String,String> headers,
                                  TimeZone timeZone,
                                  boolean needRounding,
                                  int unit,
                                  int roundDown,
                                  boolean useLocalTimeStamp)

Replace all substrings of form %{tagname} with get(tagname).toString() and all shorthand substrings of form %x with a special value. Any unrecognized / not found tags will be replaced with the empty string. TODO(henry): we may want to consider taking this out of Event and into a more general class when we get more use cases for this pattern.

Parameters:

needRounding - - Should the timestamp be rounded down?

unit - - if needRounding is true, what unit to round down to. This must be one of the units specified by Calendar - HOUR, MINUTE or SECOND. Defaults to second, if none of these are present. Ignored if needRounding is false.

roundDown - - if needRounding is true, The time should be rounded to the largest multiple of this value, smaller than the time supplied, defaults to 1, if <= 0(rounds off to the second/minute/hour immediately lower than the timestamp supplied. Ignored if needRounding is false.

Returns:

Escaped string.

getEscapeMapping

@Deprecated
public static Map<String,String> getEscapeMapping(String in,
                                                             Map<String,String> headers)

Deprecated.

Instead of replacing escape sequences in a string, this method returns a mapping of an attribute name to the value based on the escape sequence found in the argument string.

getEscapeMapping

@Deprecated
public static Map<String,String> getEscapeMapping(String in,
                                                             Map<String,String> headers,
                                                             boolean needRounding,
                                                             int unit,
                                                             int roundDown)

Deprecated.

setClock

public static void setClock(Clock clk)

getClock

public static Clock getClock()