oracle.javatools.db.property

Annotation Type Nullable

@Retention(value=RUNTIME)
 @Target(value={FIELD,METHOD})
 @Inherited
public @interface Nullable

Annotation to define a property's default support for null as an allowed value. This can be overridden in a PropertyManager implementation if required.

You only need use this annotation if the default behaviour is not applicable to a given property. The default behaviour, based on the return type / property class is as follows:

• primitive - all primitives are NOT_NULLABLE
• child list - all array properties are NOT_NULLABLE by default. The DBObject property support will return an empty [] by default even if null is set.
• all other properties are NULL_MEANS_NOT_SPECIFIED by default.

If a property uses null to represent a specific state rather than simply allowing the database default the value then:

   @Nullable( Nullable.NullBehaviour.NULLABLE )
   public MyEnum getMyEnumProperty()
 

Properties can use this annotation to mark themselves not-nullable where required:

   @Nullable( Nullable.NullBehaviour.NOT_NULLABLE )
   public Integer getMyIntegerProperty()
 

Since:

12

See Also:

PropertyInfo.getAllowedValues(), PropertyManager.getAllowedPropertyValues(oracle.javatools.db.DBObject, oracle.javatools.db.DBObject, java.lang.String), PropertyInfo.getNullBehaviour()

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
Nullable.NullBehaviour	value Specifies the behaviour of the annotated property regarding null as a value.

Element Detail

value

public abstract Nullable.NullBehaviour value

Specifies the behaviour of the annotated property regarding null as a value.