Properties

Class declarations contain properties. Each property has a type which can either be a type defined in the same namespace, an imported type, or a primitive type.

Primitive types

Concerto supports the following primitive types:

Type	Description
String	a UTF8 encoded String.
Double	a double precision 64 bit numeric value.
Integer	a 32 bit signed whole number.
Long	a 64 bit signed whole number.
DateTime	an ISO 8601 & RFC 3339 compatible date or dateTime instance, with UTC offset.
Boolean	a Boolean value, either true or false.

note

Supported date & date-time formats for the DateTime primitive type:

• YYYY-MM-DD
• YYYY-MM-DDTHH:mm:ssZ
• YYYY-MM-DDTHH:mm:ss±HH:mm
• YYYY-MM-DDTHH:mm:ss.SZ
• YYYY-MM-DDTHH:mm:ss.SSZ
• YYYY-MM-DDTHH:mm:ss.SSSZ
• YYYY-MM-DDTHH:mm:ss.S±HH:mm
• YYYY-MM-DDTHH:mm:ss.SS±HH:mm
• YYYY-MM-DDTHH:mm:ss.SSS±HH:mm

Milliseconds will be truncated at 3 digits.

We guarantee to support values that are included by the ISO 8601-1:2019, RFC 3339 and HTML Living Standard specifications. However, other formats may be accepted depending on your platforms, but are subject to change. During validation, DateTime values will be normalized to the YYYY-MM-DDTHH:mm:ss.SSSZ format.

Meta Properties

Property	Description
[]	declares that the property is an array
optional	declares that the property is not required for the instance to be valid
default	declares a default value for the property, if no value is specified
range	declares a valid range for numeric properties
regex	declares a validation regex for string properties
length	declares a minimum and maximum char length for string properties

String fields may include an optional regular expression, which is used to validate the contents of the field. Careful use of field validators allows Concerto to perform rich data validation, leading to fewer errors and less boilerplate application code.

The example below validates that a String variable starts with abc:

  o String myString regex=/abc.*/

String fields may also include an optional length expression, which is used to validate the number of characters in the string field. Both the minimum and maximum length bound are optional, however at least one must be specified. The maxLength must be greater than or equal to the minLength.

  o String stringLengthWithMinMaxLength length=[1,100] // greater than or equal to 1 and less than or equal to 100
  o String stringLengthWithMinLength length=[1,] // greater than or equal to 1
  o String stringLengthWithMaxLength length=[,100] // less than or equal to 100

Double, Long or Integer fields may include an optional range expression, which is used to validate the contents of the field. Both the lower and upper bound are optional, however at least one must be specified. The upper bound must be greater than or equal to the lower bound.

  o Integer intLowerUpper range=[-1,1] // greater than or equal to -1 and less than or equal to 1
  o Integer intLower range=[-1,] // greater than or equal to -1
  o Integer intUpper range=[,1] // less than or equal to 1

  o Long longLowerUpper range=[-1,1] // greater than or equal to -1 and less than or equal to 1
  o Long longLower range=[-1,] // greater than or equal to -1
  o Long longUpper range=[,1] // less than or equal to 1

  o Double doubleLowerUpper range=[-1.0,1.0] // greater than or equal to -1 and less than or equal to 1
  o Double doubleLower range=[-1.0,] // greater than or equal to -1
  o Double doubleUpper range=[,1.0] // less than or equal to 1

Example

asset Vehicle {
  o String model default="F150" length=[1,100]
  o String make default="FORD"
  o Integer year default=2016 range=[1990,] optional // model year must be 1990 or higher
  o String V5cID regex=/^[A-z][A-z][0-9]{7}/
}