Package org.web3d.x3d.jsail.fields

Class SFTime

java.lang.Object
org.web3d.x3d.jsail.fields.X3DConcreteField
org.web3d.x3d.jsail.fields.SFTime
All Implemented Interfaces:
SFTime, X3DField
public class SFTime extends X3DConcreteField implements SFTime
This utility class provides a concrete implementation corresponding to SFTime X3D field type.

Warning: this is an abstract interface that cannot be instantiated as a concrete object. Java programmers typically only need to use concrete objects provided by the org.web3d.x3d.jsail classes.
Package hint: This specification class is defined by the X3D Java Language Binding Specification for the Scene Authoring Interface (SAI). SFTime specifies a single time value, expressed as a double-precision floating point number. Typically, SFTime fields represent the number of seconds since Jan 1, 1970, 00:00:00 GMT.

Related field object: MFTime
See Also:

  • Field Details

  • Constructor Details

    • SFTime

      public SFTime()
      Constructor for SFTime performs value initialization.

    • SFTime

      public SFTime(SFTime newValue)
      Constructor to copy an SFTime value as initial value for this new field object.
      Parameters:
      newValue - The newValue to apply

    • SFTime

      public SFTime(double newValue)
      Constructor for SFTime using a corresponding Java primitive double as new initial value.
      Parameters:
      newValue - is new value to assign setContainerFieldOverride(containerFieldName); // apply checksConcreteField#getTupleSize(String)

    • SFTime

      public SFTime(float newValue)
      Constructor using float as new initial value.
      Parameters:
      newValue - is new value to assign

    • SFTime

      public SFTime(int newValue)
      Constructor using int as new initial value.
      Parameters:
      newValue - is new value to assign

  • Method Details

    • isArray

      public static final boolean isArray()
      Whether or not this field type is an array (false)
      Returns:
      true if array type

    • initialize

      public final void initialize()
      Initialization for SFTime applies default initial value. Static initializer also provided to verify that the regex pattern compiles and matches that default value.
      Specified by:
      initialize in class X3DConcreteField
      See Also:

    • equals

      public boolean equals(SFTime comparisonSFTime)
      Determine whether two objects contain equal values.
      Parameters:
      comparisonSFTime - field type to compare
      Returns:
      true if equivalent, false otherwise

    • validate

      public final String validate()
      Validate current value via get/set comparison tests
      Returns:
      empty string if get/set testing passes, warning otherwise
      See Also:

    • validateRegex

      public final String validateRegex()
      Validate current value via regular expression (regex) check of current object's toString() value, reporting errors only if found.
      Returns:
      empty string if PATTERN matches, warning otherwise
      See Also:

    • matches

      public final boolean matches()
      Test PATTERN match via regular expression (regex) check of current object's toString() value.
      Returns:
      true if PATTERN matches, false otherwise
      See Also:

    • matches

      public static final boolean matches(String value)
      Test PATTERN match with regular expression (regex) of provided value.
      Parameters:
      value - String to check against regex pattern for successful match
      Returns:
      true if PATTERN matches, false otherwise
      See Also:

    • setValueByString

      public SFTime setValueByString(String newValue) throws InvalidFieldValueException
      Utility accessor for SFTime using String value (which must pass parsing validation checks).

      Warning: this method is not type safe at compile time! Best practice for X3DJSAIL programmers is to use strongly typed methods instead, in order to avoid potential for run-time errors.
      Parameters:
      newValue - is new value to assign, if empty then assign DEFAULT_VALUE
      Returns:
      MFMatrix4d - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same node object).
      Throws:
      InvalidFieldValueException
      See Also:

    • toString

      public static String toString(double value)
      Static utility method to provide String representation of a correctly typed input value.
      Parameters:
      value - The value to convert to a String
      Returns:
      String version of the provided value
      See Also:

    • getValue

      public double getValue()
      Get the current value.
      Specified by:
      getValue in interface SFTime
      Returns:
      current value

    • getPrimitiveValue

      public double getPrimitiveValue()
      Provides current value of the field as a Java primitive type.
      Returns:
      current value

    • toString

      public String toString()
      Provides current value as a String.
      Overrides:
      toString in class Object
      Returns:
      String version of the provided value
      See Also:

    • setValue

      public void setValue(double newValue)
      Assign a new value to this field.
      Specified by:
      setValue in interface SFTime
      Parameters:
      newValue - The replacement value to assign.
      See Also:

    • getJavaValue

      public long getJavaValue()
      Get the current value.
      Specified by:
      getJavaValue in interface SFTime
      Returns:
      current value

    • setValue

      public void setValue(long newValue)
      Assign a new value, converting seconds from (long) to (double).
      Specified by:
      setValue in interface SFTime
      Parameters:
      newValue - The replacement value to assign.

    • setValue

      public SFTime setValue(float newValue)
      Apply a float value to this double field type, note change in precision.
      Parameters:
      newValue - The float newValue to apply
      Returns:
      SFTime - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

    • setValue

      public SFTime setValue(int newValue)
      Apply an int value to this double field type, note change in precision.
      Parameters:
      newValue - The float newValue to apply
      Returns:
      SFTime - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

    • stripTrailingZeroes

      public String stripTrailingZeroes()
      Utility method to strip trailing fractional zeroes from String representations of the current object's value. Applicability: first converting an integer (such as 100) to double and then String results in trailing decimal point and zero (such as 100.0). Functionality can be globally enabled/disabled by ConfigurationProperties.setStripTrailingZeroes(boolean).
      Returns:
      string value with trailing zeros and decimal points stripped
      See Also:

    • stripTrailingZeroes

      public static String stripTrailingZeroes(double value)
      Utility method to always strip trailing fractional zeroes from String value of any given double. Applicability: first converting an integer (such as 100) to double and then String results in trailing decimal point and zero (such as 100.0). Note: not affected by ConfigurationProperties.setStripTrailingZeroes(boolean).
      Parameters:
      value - a double-precision number
      Returns:
      string value with trailing zeros and decimal points stripped
      See Also:

    • setValue

      public SFTime setValue(SFTime newValue)
      Apply an SFTime value to this field.
      Parameters:
      newValue - The newValue to apply
      Returns:
      SFTime - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

    • isDefaultValue

      public boolean isDefaultValue()
      Determine whether current value matches DEFAULT_VALUE
      Returns:
      whether current value matches DEFAULT_VALUE
      See Also: