PropertyExportImpl (AndHow Core 0.4.2-rc3 API)

java.lang.Object
- org.yarnandtail.andhow.internal.export.PropertyExportImpl

All Implemented Interfaces:

PropertyExport
```
public class PropertyExportImpl
extends Object
implements PropertyExport
```
Implementation w/ wrapper inner subclass to simplify wrapped instances for mapXXX methods.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

protected static class PropertyExportImpl.PropertyExportWrap
A wrapper class that make it easy to wrap, delegate and override methods.

Nested Classes
Modifier and Type	Class and Description
`protected static class`	`PropertyExportImpl.PropertyExportWrap` A wrapper class that make it easy to wrap, delegate and override methods.

Constructor Summary

Constructors
Constructor and Description
`PropertyExportImpl(Property<?> property, Class<?> containingClass, Exporter.EXPORT_CANONICAL_NAME canonicalNameOpt, Exporter.EXPORT_OUT_ALIASES outAliasOpt)` Full state constructor.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected List<String>`	`buildExportNames()` Build the export names based on annotation options.
`Exporter.EXPORT_CANONICAL_NAME`	`getCanonicalNameOption()` Option read from the containing `ManualExportAllowed` annotation to determine if the canonical name of the Property should be included.
`Class<?>`	`getContainingClass()` The class directly containing the Property.
`List<String>`	`getExportNames()` The complete list of export names for this property, which may be null, empty or many.
`Exporter.EXPORT_OUT_ALIASES`	`getOutAliasOption()` Option read from the containing `ManualExportAllowed` annotation to determine if 'out' aliases of the Property should be included.
`Property<?>`	`getProperty()` The Property being exported.
`Object`	`getValue()` Fetch the Object value of the Property, e.g., an Integer Property will return an Integer.
`String`	`getValueAsString()` Fetch the value as a String from the Property.
`PropertyExport`	`mapNames(List<String> exportNames)` Intended for using with Java `stream()`s, this method maps this instance to a new one with new export names.
`protected static PropertyExport`	`mapNames(List<String> exportNames, PropertyExport inner)` Construct a new PropertyExport, overriding the getExportNames() method.
`PropertyExport`	`mapValue(Object value)` Intended for using with Java `stream()`s, this method maps this instance to a new one with a new Object value for the Property, i.e., the 'value' part of a key-value pair.
`protected static PropertyExport`	`mapValue(Object value, PropertyExport inner)` Construct a new PropertyExport, overriding the getValue() method.
`PropertyExport`	`mapValueAsString(String value)` Intended for using with Java `stream()`s, this method maps this instance to a new one with a new String value for the Property, i.e., the 'value' part of a key-value pair.
`protected static PropertyExport`	`mapValueAsString(String value, PropertyExport inner)` Construct a new PropertyExport, overriding the getValueAsString() method.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - PropertyExportImpl
```
public PropertyExportImpl(Property<?> property,
                          Class<?> containingClass,
                          Exporter.EXPORT_CANONICAL_NAME canonicalNameOpt,
                          Exporter.EXPORT_OUT_ALIASES outAliasOpt)
```
    Full state constructor.
    
    Parameters:
    
    property - The Property being exported.
    
    containingClass - The class immediately containing the Property.
    
    canonicalNameOpt - Option of if/when to include the canonical name in exports
    
    outAliasOpt - Option of if to include out alias names in the exports.
- Method Detail
  - getProperty
```
public Property<?> getProperty()
```
    Description copied from interface: PropertyExport
    
    The Property being exported.
    
    Specified by:
    
    getProperty in interface PropertyExport
    
    Returns:
    
    A Property instance. Not null.
  - getContainingClass
```
public Class<?> getContainingClass()
```
    Description copied from interface: PropertyExport
    
    The class directly containing the Property.
    
    Specified by:
    
    getContainingClass in interface PropertyExport
    
    Returns:
    
    The containing class. Not null.
  - getCanonicalNameOption
```
public Exporter.EXPORT_CANONICAL_NAME getCanonicalNameOption()
```
    Description copied from interface: PropertyExport
    
    Option read from the containing ManualExportAllowed annotation to determine if the canonical name of the Property should be included.
    If included, the canonical name would be included in the list of names returned from PropertyExport.getExportNames() and then ultimately as one of the names in the final key-value pairs.
    
    Specified by:
    
    getCanonicalNameOption in interface PropertyExport
    
    Returns:
    
    An EXPORT_CANONICAL_NAME value. Not null.
  - getOutAliasOption
```
public Exporter.EXPORT_OUT_ALIASES getOutAliasOption()
```
    Description copied from interface: PropertyExport
    
    Option read from the containing ManualExportAllowed annotation to determine if 'out' aliases of the Property should be included.
    'Out' aliases are alternate names for a Property for the purpose of export, so generally they are intended to be included.
    
    Specified by:
    
    getOutAliasOption in interface PropertyExport
    
    Returns:
    
    An EXPORT_OUT_ALIASES value. Not null.
  - getExportNames
```
public List<String> getExportNames()
```
    Description copied from interface: PropertyExport
    
    The complete list of export names for this property, which may be null, empty or many.
    This method builds and returns the default export name list based on the PropertyExport.getCanonicalNameOption() & PropertyExport.getOutAliasOption() options, or, if PropertyExport.mapNames(List) was used to construct this instance, the list of names specified.
    See AndHow.export(Class[]) for an example that remaps export names.
    
    Specified by:
    
    getExportNames in interface PropertyExport
    
    Returns:
    
    A list of names which may be empty or null.
  - getValue
```
public Object getValue()
```
    Description copied from interface: PropertyExport
    Fetch the Object value of the Property, e.g., an Integer Property will return an Integer.
    Nominally this is the same as getProperty().getValue(), however, PropertyExport.mapValue(Object) can be used to rewrite the value. Take care to map the method that will be used by the collector you have chosen:
    - 'String' collectors call PropertyExport.getValueAsString(): use PropertyExport.mapValueAsString(String)
    - 'Object' collectors call PropertyExport.getValue(): use PropertyExport.mapValue(Object)
    Specified by:
    
    getValue in interface PropertyExport
    
    Returns:
    
    The value return from the Property getValue() method or a custom value. May be null.
  - getValueAsString
```
public String getValueAsString()
```
    Description copied from interface: PropertyExport
    Fetch the value as a String from the Property.
    Nominally this is the same as getProperty().getValueAsString(), however, PropertyExport.mapValueAsString(String) can be used to rewrite the value. Take care to map the method that will be used by the collector you have chosen:
    - 'String' collectors call PropertyExport.getValueAsString(): use PropertyExport.mapValueAsString(String)
    - 'Object' collectors call PropertyExport.getValue(): use PropertyExport.mapValue(Object)
    Implementation note: The nominal implementation of this method should call getProperty().getValueAsString() and not delegate to PropertyExport.getValue(), since the type returned by getValue may be overridden and not match the Property type.
    Specified by:
    
    getValueAsString in interface PropertyExport
    
    Returns:
    
    The value returned from the Properties getValueAsString method or a custom value. May be null.
  - mapNames
```
public PropertyExport mapNames(List<String> exportNames)
```
    Description copied from interface: PropertyExport
    
    Intended for using with Java stream()s, this method maps this instance to a new one with new export names.
    Calling PropertyExport.getExportNames() on the new instance returns the new exportNames. Specifying an empty or null list of names will remove this Property from export.
    See AndHow.export(Class[]) for an example that remaps export names.
    
    Specified by:
    
    mapNames in interface PropertyExport
    
    Parameters:
    
    exportNames - A new list of export names to be used, rather than the default ones.
    
    Returns:
    
    A new instance identical to the original, except it has new names.
  - mapValue
```
public PropertyExport mapValue(Object value)
```
    Description copied from interface: PropertyExport
    Intended for using with Java stream()s, this method maps this instance to a new one with a new Object value for the Property, i.e., the 'value' part of a key-value pair.
    Calling PropertyExport.getValue() on the new instance returns the new value, which may be null.
    This example uses mapValue() to multiply Property values by 2 if they are integers:
```
 Map<String, Object> export =
  AndHow.instance().export(MyClass.class)
   .map(p -> p.mapValue(
     (p.getValue() != null && p.getValue() instanceof Integer)
       ? (Integer)p.getValue() * 2:p.getValue()) )
   .collect(ExportCollector.objectMap());
 
```
    Take care to map the method that will be used by the collector you have chosen:
    - 'String' collectors call PropertyExport.getValueAsString(): use PropertyExport.mapValueAsString(String)
    - 'Object' collectors call PropertyExport.getValue(): use PropertyExport.mapValue(Object)
    Specified by:
    
    mapValue in interface PropertyExport
    
    Parameters:
    
    value - The new value to return for the value of this Property.
    
    Returns:
    
    A new instance identical to the original, except it has a new object value.
  - mapValueAsString
```
public PropertyExport mapValueAsString(String value)
```
    Description copied from interface: PropertyExport
    Intended for using with Java stream()s, this method maps this instance to a new one with a new String value for the Property, i.e., the 'value' part of a key-value pair.
    Calling PropertyExport.getValueAsString() on the new instance returns the new value, which may be null.
    This example uses mapValueAsString() to convert Property values to uppercase:
```
 Map<String, String> export =
  AndHow.instance().export(MyClass.class)
   .map( p -> p.mapValueAsString( p.getValueAsString() != null
     ? p.getValueAsString().toUpperCase():null) )
       .collect(ExportCollector.stringMap());
 
```
    Take care to map the method that will be used by the collector you have chosen:
    - 'String' collectors call PropertyExport.getValueAsString(): use PropertyExport.mapValueAsString(String)
    - 'Object' collectors call PropertyExport.getValue(): use PropertyExport.mapValue(Object)
    Specified by:
    
    mapValueAsString in interface PropertyExport
    
    Parameters:
    
    value - The new value to return for the String value of this Property.
    
    Returns:
    
    A new instance identical to the original, except it has a new String value.
  - buildExportNames
```
protected List<String> buildExportNames()
```
    Build the export names based on annotation options.
    The ManualExportAllowed annotation on the class containing the Property or a class containing that class determines the export name options.
    See getCanonicalNameOption(), getOutAliasOption(), and ManualExportAllowed for details.
    
    Returns:
    
    A list of names as determined by the annotation options.
  - mapNames
```
protected static PropertyExport mapNames(List<String> exportNames,
                                         PropertyExport inner)
```
    Construct a new PropertyExport, overriding the getExportNames() method.
    
    Parameters:
    
    exportNames - The new list of export names to return from the getExportNames() method.
    
    inner - The inner instance to delegate to for other methods.
    
    Returns:
    
    A new instance wrapping the inner and returning the new export names.
  - mapValue
```
protected static PropertyExport mapValue(Object value,
                                         PropertyExport inner)
```
    Construct a new PropertyExport, overriding the getValue() method.
    
    Parameters:
    
    value - The new value to return from the getValue() method.
    
    inner - The inner instance to delegate to for other methods.
    
    Returns:
    
    A new instance wrapping the inner and returning the new value.
  - mapValueAsString
```
protected static PropertyExport mapValueAsString(String value,
                                                 PropertyExport inner)
```
    Construct a new PropertyExport, overriding the getValueAsString() method.
    
    Parameters:
    
    value - The new value to return from the getValueAsString() method.
    
    inner - The inner instance to delegate to for other methods.
    
    Returns:
    
    A new instance wrapping the inner and returning the new value.

Class PropertyExportImpl

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

PropertyExportImpl

Method Detail

getProperty

getContainingClass

getCanonicalNameOption

getOutAliasOption

getExportNames

getValue

getValueAsString

mapNames

mapValue

mapValueAsString

buildExportNames

mapNames

mapValue

mapValueAsString