Tag (Brentcroft Materializer 00.00.08 API)

Type Parameters:

T - a context object

R - a member to be constructed, modified and/or validated

All Known Subinterfaces:

FlatTag<T>, StepTag<T,R>

All Known Implementing Classes:

PropertiesRootTag
```
public interface Tag<T,R>
```
Constructs, modifies and/or validates a member of type R on some context object of type T.
A Tag may have child tags of type <? super R, ?>.

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`void`	`close(Object o, String text)` Called by TagHandler.endElement to consume text.
`default Tag<? super R,?>[]`	`getChildren()` Provide no children by default.
`default java.util.function.BiConsumer<R,String>`	`getCloser()` Override to implement closing behaviour.
`R`	`getItem(T t)` Obtains a member R from a context object T.
`default java.util.function.BiConsumer<R,Attributes>`	`getOpener()` Override to implement opening behaviour.
`Tag<T,R>`	`getSelf()` Enforce implementation of a self member.
`String`	`getTag()`
`default TagModel<? super R>`	`getTagModel()` Obtain a new TagModel on the children or return `null` if there are no children.
`default java.util.function.BiConsumer<Tag<T,R>,R>`	`getValidator()` Override to implement validation behaviour.
`default boolean`	`isChoice()` True this Tag's children are choices (otherwise they're a sequence).
`default boolean`	`isMultiple()` True if this Tag is can be repeated.
`default boolean`	`isOptional()` True if this Tag is optional, and can be skipped if encountered unmatched.
`void`	`open(Object o, Attributes attributes)` Called by TagHandler.startElement to consume attributes.

- Method Detail
  - getTag
```
String getTag()
```
  - getItem
```
R getItem(T t)
```
    Obtains a member R from a context object T. NB: A FlatTag provides itself as the member.
    
    Parameters:
    
    t - a context object
    
    Returns:
    
    a member of the context object
  - getSelf
```
Tag<T,R> getSelf()
```
    Enforce implementation of a self member.
    
    Returns:
    
    the instantiation of this Tag.
  - open
```
void open(Object o,
          Attributes attributes)
```
    Called by TagHandler.startElement to consume attributes.
  - close
```
void close(Object o,
           String text)
```
    Called by TagHandler.endElement to consume text.
  - getChildren
```
default Tag<? super R,?>[] getChildren()
```
    Provide no children by default.
    
    Returns:
    
    null
  - getTagModel
```
default TagModel<? super R> getTagModel()
```
    Obtain a new TagModel on the children or return null if there are no children.
    
    Returns:
    
    a new TagModel on the children or null
  - isChoice
```
default boolean isChoice()
```
    True this Tag's children are choices (otherwise they're a sequence).
    
    Returns:
    
    if this Tag's children are choices (otherwise they're a sequence)
  - isOptional
```
default boolean isOptional()
```
    True if this Tag is optional, and can be skipped if encountered unmatched.
    
    Returns:
    
    true if this Tag is optional.
  - isMultiple
```
default boolean isMultiple()
```
    True if this Tag is can be repeated.
    
    Returns:
    
    true if this Tag can be repeated.
  - getOpener
```
default java.util.function.BiConsumer<R,Attributes> getOpener()
```
    Override to implement opening behaviour.
    
    Returns:
    
    null
  - getCloser
```
default java.util.function.BiConsumer<R,String> getCloser()
```
    Override to implement closing behaviour.
    
    Returns:
    
    null
  - getValidator
```
default java.util.function.BiConsumer<Tag<T,R>,R> getValidator()
```
    Override to implement validation behaviour.
    
    Returns:
    
    null

Interface Tag<T,R>

Method Summary

Method Detail

getTag

getItem

getSelf

open

close

getChildren

getTagModel

isChoice

isOptional

isMultiple

getOpener

getCloser

getValidator