Class JavaPropsSchema
java.lang.Object
com.fasterxml.jackson.dataformat.javaprop.JavaPropsSchema
- All Implemented Interfaces:
com.fasterxml.jackson.core.FormatSchema
,Serializable
public class JavaPropsSchema
extends Object
implements com.fasterxml.jackson.core.FormatSchema, Serializable
Simple
FormatSchema
sub-type that defines details of things like:
- How are "flat" property names mapped to hierarchic POJO types, using separator-based naming convention.
- What indentation (if any) is used before key values, and between key/value
- If and how are Array values inferred from property names
- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescriptionprotected int
Specifies index number used when writing the first array entry (which in Java has index of 0).protected String
Optional header to prepend before any other output: typically a comment section or so.protected Markers
Default start marker for index access, if any; empty String may be used to indicate no marker-based index detection should be made.protected String
String added between key and value; needs to include the "equals character" (either '=' or ':', both allowed by Java Properties specification), may also include white before and/or after "equals character".protected String
String added after value, including at least one linefeed.protected String
String prepended before key value, as possible indentationprotected boolean
Whether 'simple' index-notation is supported for path segments or not: simple meaning that if a path segment is a textual representation of a non-negative integer value with length of 9 or less (that is, up to but no including one billion), it will be considered index, not property name.protected String
Default path separator to use for hierarchic paths, if any; empty String may be used to indicate that no hierarchy should be inferred using a simple separator (although index markers may still be used, if defined).protected JPropPathSplitter
Since splitter instances are slightly costly to build in some cases, we will lazily instantiate and cache them.protected boolean
Whether array-element paths are written using start/end markers (see_indexMarker
or "simple" index number: if set totrue
AND markers are specified as non-empty Strings, will use sequence ofprotected static final Markers
protected static final JavaPropsSchema
private static final long
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprivate <V> boolean
_equals
(V a, V b) static JavaPropsSchema
int
header()
boolean
Accessor for getting aJPropPathSplitter
instance that does splitting according to the settings of this instance.withFirstArrayOffset
(int v) withHeader
(String v) Mutant factory for constructing schema instance where specified header section (piece of text written out right before actual properties entries) will be used.Convenience method, functionally equivalent to:Mutant factory method for constructing a new instance that specifies that no "path splitting" is to be done: this is similar to default behavior ofProperties
in which keys are full Strings and there is no nesting of values.withParseSimpleIndexes
(boolean v) Mutant factory method for constructing a new instance with specified path separator; default being comma (".").withWriteIndexUsingMarkers
(boolean v) boolean
-
Field Details
-
serialVersionUID
private static final long serialVersionUID- See Also:
-
DEFAULT_INDEX_MARKER
-
EMPTY
-
_splitter
Since splitter instances are slightly costly to build in some cases, we will lazily instantiate and cache them. -
_firstArrayOffset
protected int _firstArrayOffsetSpecifies index number used when writing the first array entry (which in Java has index of 0). After this initial value, additional elements will have consecutive values, incremented by 1. Note that this setting has no effect on reading: input indexes are only used for sorting values, and their exact values have no meaning.Default value is 1.
-
_pathSeparator
Default path separator to use for hierarchic paths, if any; empty String may be used to indicate that no hierarchy should be inferred using a simple separator (although index markers may still be used, if defined). -
_indexMarker
Default start marker for index access, if any; empty String may be used to indicate no marker-based index detection should be made.Default value of "[" is usually combined with end marker of "]" to allow C/Java-style bracket notation, like "settings.path[1]".
-
_parseSimpleIndexes
protected boolean _parseSimpleIndexesWhether 'simple' index-notation is supported for path segments or not: simple meaning that if a path segment is a textual representation of a non-negative integer value with length of 9 or less (that is, up to but no including one billion), it will be considered index, not property name.Note that this settings does NOT control whether "start/end marker" indicated indexes are enabled or not; those depend on
_indexMarker
.Default value is
true
, "plain" index segments are supported. -
_writeIndexUsingMarkers
protected boolean _writeIndexUsingMarkersWhether array-element paths are written using start/end markers (see_indexMarker
or "simple" index number: if set totrue
AND markers are specified as non-empty Strings, will use sequence ofstartMarker index endMarker
to include index in path; otherwise will simply use textual representation of the index number as path segment, prefixed by path separator as necessary. -
_lineIndentation
String prepended before key value, as possible indentation -
_keyValueSeparator
String added between key and value; needs to include the "equals character" (either '=' or ':', both allowed by Java Properties specification), may also include white before and/or after "equals character". Default value is a single '=' character with no white spaces around -
_lineEnding
String added after value, including at least one linefeed. Default value is the 'Unix linefeed'. -
_header
Optional header to prepend before any other output: typically a comment section or so. Note that contents here are NOT modified in any way, meaning that any comment indicators (leading '#' or '!') and linefeeds MUST be specified by caller.
-
-
Constructor Details
-
JavaPropsSchema
public JavaPropsSchema() -
JavaPropsSchema
-
-
Method Details
-
pathSplitter
Accessor for getting aJPropPathSplitter
instance that does splitting according to the settings of this instance.Note that instance is constructed lazily as needed, but reused afterwards for this instance (and for these specific settings).
-
withFirstArrayOffset
-
withPathSeparator
Mutant factory method for constructing a new instance with specified path separator; default being comma ("."). Note that setting separator to `null` or empty String will basically disable handling of nesting, similar to callingwithoutPathSeparator()
. -
withoutPathSeparator
Mutant factory method for constructing a new instance that specifies that no "path splitting" is to be done: this is similar to default behavior ofProperties
in which keys are full Strings and there is no nesting of values. -
withIndexMarker
-
withoutIndexMarker
-
withParseSimpleIndexes
-
withWriteIndexUsingMarkers
-
withLineIndentation
-
withoutLineIndentation
- Since:
- 2.8
-
withKeyValueSeparator
-
withLineEnding
-
withHeader
Mutant factory for constructing schema instance where specified header section (piece of text written out right before actual properties entries) will be used. Note that caller must specify any and all linefeeds to use: generator will NOT modify header String contents in any way, and will not append a linefeed after contents (if any). -
withoutHeader
Convenience method, functionally equivalent to:withHeader("")
used to ensure that no header is prepended before actual property values are output.- Since:
- 2.8
-
getSchemaType
- Specified by:
getSchemaType
in interfacecom.fasterxml.jackson.core.FormatSchema
-
emptySchema
-
firstArrayOffset
public int firstArrayOffset() -
header
-
indexMarker
-
lineEnding
-
lineIndentation
-
keyValueSeparator
-
parseSimpleIndexes
public boolean parseSimpleIndexes() -
pathSeparator
-
writeIndexUsingMarkers
public boolean writeIndexUsingMarkers() -
_equals
private <V> boolean _equals(V a, V b)
-