org.codehaus.jackson.format

枚举 MatchStrength

java.lang.Object

java.lang.Enum<MatchStrength>

org.codehaus.jackson.format.MatchStrength

所有已实现的接口:

Serializable, Comparable<MatchStrength>

public enum MatchStrength
extends Enum<MatchStrength>

Enumeration used to indicate strength of match between data format and piece of data (typically beginning of a data file). Values are in increasing match strength; and detectors should return "strongest" value: that is, it should start with strongest match criteria, and downgrading if criteria is not fulfilled.

从以下版本开始:

1.8

枚举常量概要

枚举常量

枚举常量和说明
FULL_MATCH Value that indicates that given data contains a signature that is deemed specific enough to uniquely indicate data format used.
INCONCLUSIVE Value that indicates that detector can not find out whether could be a match or not.
NO_MATCH Value that indicates that given data can not be in given format.
SOLID_MATCH Value that indicates that given data conforms to (one of) canonical form(s) of the data format.
WEAK_MATCH Value that indicates that given data could be of specified format (i.e.

方法概要

方法

限定符和类型	方法和说明
static MatchStrength	valueOf(String name) 返回带有指定名称的该类型的枚举常量。
static MatchStrength[]	values() 按照声明该枚举类型的常量的顺序, 返回 包含这些常量的数组。

从类继承的方法 java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

从类继承的方法 java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

枚举常量详细资料

NO_MATCH

public static final MatchStrength NO_MATCH

Value that indicates that given data can not be in given format.

INCONCLUSIVE

public static final MatchStrength INCONCLUSIVE

Value that indicates that detector can not find out whether could be a match or not. This can occur for example for textual data formats t when there are so many leading spaces that detector can not find the first data byte (because detectors typically limit lookahead to some smallish value).

WEAK_MATCH

public static final MatchStrength WEAK_MATCH

Value that indicates that given data could be of specified format (i.e. it can not be ruled out). This can occur for example when seen data is both not in canonical formats (for example: JSON data should be a JSON Array or Object not a scalar value, as per JSON specification) and there are known use case where a format detected is actually used (plain JSON Strings are actually used, even though specification does not indicate that as valid usage: as such, seeing a leading double-quote could indicate a JSON String, which plausibly could indicate non-standard JSON usage).

SOLID_MATCH

public static final MatchStrength SOLID_MATCH

Value that indicates that given data conforms to (one of) canonical form(s) of the data format.

For example, when testing for XML data format, seeing a less-than character ("<") alone (with possible leading spaces) would be a strong indication that data could be in xml format (but see below for FULL_MATCH description for more)

FULL_MATCH

public static final MatchStrength FULL_MATCH

Value that indicates that given data contains a signature that is deemed specific enough to uniquely indicate data format used.

For example, when testing for XML data format, seing "<xml" as the first data bytes ("XML declaration", as per XML specification) could give full confidence that data is indeed in XML format. Not all data formats have unique leading identifiers to allow full matches; for example, JSON only has heuristic matches and can have at most SOLID_MATCH) match.

方法详细资料

values

public static MatchStrength[] values()

按照声明该枚举类型的常量的顺序, 返回 包含这些常量的数组。该方法可用于迭代 常量, 如下所示:

for (MatchStrength c : MatchStrength.values())
    System.out.println(c);

valueOf

public static MatchStrength valueOf(String name)

返回带有指定名称的该类型的枚举常量。 字符串必须与用于声明该类型的枚举常量的 标识符完全匹配。(不允许有多余 的空格字符。)

参数:

name - 要返回的枚举常量的名称。

返回:

返回带有指定名称的枚举常量

抛出:

如果该枚举类型没有带有指定名称的常量, - 则抛出 IllegalArgumentException

如果参数为空值, - 则抛出 NullPointerException