schemaOfClass

Automatically creates an appropriate schema for the given class type.

This factory method uses reflection and type inspection to determine the most suitable schema for a given Java class. It handles the complete type system including primitives, collections, enums, and custom classes.

Supported Types

Primitive Types:

• int/Integer → IntSchema

• long/Long → LongSchema

• double/Double → DoubleSchema

• boolean/Boolean → BooleanSchema

• String → StringSchema

Collection Types:

• T[] → ArraySchema (recursive schema inference for element type)

• Enum<T> → EnumSchema

Class Types:

• Classes with companion object as_type property → TypedClassSchema

• All other classes → ReflectedClassSchema

Type Safety

The method uses unchecked casts internally but maintains type safety through careful type checking. The returned schema is guaranteed to be compatible with the input class type.

Performance Considerations

• Primitive type mapping is constant-time

• Enum and array detection uses class introspection

• Class schema creation involves reflection and field analysis

• Consider caching schemas for frequently used types

Usage Examples

// Primitive types
val intSchema = FateSchema.schemaOfClass(Int::class.java)        // IntSchema
val stringSchema = FateSchema.schemaOfClass(String::class.java)  // StringSchema

// Collections
val arraySchema = FateSchema.schemaOfClass(Array<String>::class.java)  // ArraySchema<String>
val enumSchema = FateSchema.schemaOfClass(MyEnum::class.java)           // EnumSchema<MyEnum>

// Custom classes
val userSchema = FateSchema.schemaOfClass(User::class.java)      // ReflectedClassSchema<User>
val typedSchema = FateSchema.schemaOfClass(TypedClass::class.java) // TypedClassSchema<TypedClass>

Parameters

See also

Throws

Automatically creates an appropriate schema for the given class type.

This factory method uses reflection and type inspection to determine the most suitable schema for a given Java class. It handles the complete type system including primitives, collections, enums, and custom classes.

Supported Types

Primitive Types:

• int/Integer → IntSchema

• long/Long → LongSchema

• double/Double → DoubleSchema

• boolean/Boolean → BooleanSchema

• String → StringSchema

Collection Types:

• T[] → ArraySchema (recursive schema inference for element type)

• Enum<T> → EnumSchema

Class Types:

• Classes with companion object as_type property → TypedClassSchema

• All other classes → ReflectedClassSchema

Type Safety

The method uses unchecked casts internally but maintains type safety through careful type checking. The returned schema is guaranteed to be compatible with the input class type.

Performance Considerations

• Primitive type mapping is constant-time

• Enum and array detection uses class introspection

• Class schema creation involves reflection and field analysis

• Consider caching schemas for frequently used types

Usage Examples

// Primitive types
val intSchema = FateSchema.schemaOfClass(Int::class.java)        // IntSchema
val stringSchema = FateSchema.schemaOfClass(String::class.java)  // StringSchema

// Collections
val arraySchema = FateSchema.schemaOfClass(Array<String>::class.java)  // ArraySchema<String>
val enumSchema = FateSchema.schemaOfClass(MyEnum::class.java)           // EnumSchema<MyEnum>

// Custom classes
val userSchema = FateSchema.schemaOfClass(User::class.java)      // ReflectedClassSchema<User>
val typedSchema = FateSchema.schemaOfClass(TypedClass::class.java) // TypedClassSchema<TypedClass>

Parameters

See also

Throws

Convenience method for creating a schema from a reified type parameter.

See also