A General purpose writer for serializing objects into a Stream using Avro. This class implements a default way of serializing objects. But one can derive a class from this and override different methods to acheive results that are different from the default implementation. More...

Inheritance diagram for Avro.Generic.DefaultWriter:

Public Member Functions
	DefaultWriter (Schema schema)
	Constructs a generic writer for the given schema. More...

void	Write< T > (T value, Encoder encoder)

virtual void	Write (Schema schema, object value, Encoder encoder)
	Examines the schema and dispatches the actual work to one of the other methods of this class. This allows the derived classes to override specific methods and get custom results. More...

Protected Member Functions
virtual void	WriteNull (object value, Encoder encoder)
	Serializes a "null" More...

virtual void	Write< S > (object value, Schema.Type tag, Writer< S > writer)
	A generic method to serialize primitive Avro types. More...

virtual void	WriteRecord (RecordSchema schema, object value, Encoder encoder)
	Serialized a record using the given RecordSchema. It uses GetField method to extract the field value from the given object. More...

virtual void	EnsureRecordObject (RecordSchema s, object value)

virtual object	GetField (object value, string fieldName, int fieldPos)
	Extracts the field value from the given object. In this default implementation, value should be of type GenericRecord. More...

virtual void	WriteEnum (EnumSchema es, object value, Encoder encoder)
	Serializes an enumeration. The default implementation expectes the value to be string whose value is the name of the enumeration. More...

virtual void	WriteArray (ArraySchema schema, object value, Encoder encoder)
	Serialized an array. The default implementation calls EnsureArrayObject() to ascertain that the given value is an array. It then calls GetArrayLength() and GetArrayElement() to access the members of the array and then serialize them. More...

virtual void	EnsureArrayObject (object value)
	Checks if the given object is an array. If it is a valid array, this function returns normally. Otherwise, it throws an exception. The default implementation checks if the value is an array. More...

virtual long	GetArrayLength (object value)
	Returns the length of an array. The default implementation requires the object to be an array of objects and returns its length. The defaul implementation gurantees that EnsureArrayObject() has been called on the value before this function is called. More...

virtual object	GetArrayElement (object value, long index)
	Returns the element at the given index from the given array object. The default implementation requires that the value is an object array and returns the element in that array. The defaul implementation gurantees that EnsureArrayObject() has been called on the value before this function is called. More...

virtual void	WriteMap (MapSchema schema, object value, Encoder encoder)
	Serialized a map. The default implementation first ensure that the value is indeed a map and then uses GetMapSize() and GetMapElements() to access the contents of the map. More...

virtual void	EnsureMapObject (object value)
	Checks if the given object is a map. If it is a valid map, this function returns normally. Otherwise, it throws an exception. The default implementation checks if the value is an IDictionary<string, object>. More...

virtual long	GetMapSize (object value)
	Returns the size of the map object. The default implementation gurantees that EnsureMapObject has been successfully called with the given value. The default implementation requires the value to be an IDictionary<string, object> and returns the number of elements in it. More...

virtual IEnumerable < KeyValuePair< string, object > >	GetMapValues (object value)
	Returns the contents of the given map object. The default implementation guarantees that EnsureMapObject has been called with the given value. The defualt implementation of this method requires that the value is an IDictionary<string, object> and returns its contents. More...

virtual void	WriteUnion (UnionSchema us, object value, Encoder encoder)
	Resolves the given value against the given UnionSchema and serializes the object against the resolved schema member. The default implementation of this method uses ResolveUnion to find the member schema within the UnionSchema. More...

virtual int	ResolveUnion (UnionSchema us, object obj)
	Finds the branch within the given UnionSchema that matches the given object. The default implementation calls Matches() method in the order of branches within the UnionSchema. If nothing matches, throws an exception. More...

virtual void	WriteFixed (FixedSchema es, object value, Encoder encoder)
	Serialized a fixed object. The default implementation requires that the value is a GenericFixed object with an identical schema as es. More...

AvroException	TypeMismatch (object obj, string schemaType, string type)

virtual bool	Matches (Schema sc, object obj)

Properties
Schema	Schema `[get]`

Detailed Description

A General purpose writer for serializing objects into a Stream using Avro. This class implements a default way of serializing objects. But one can derive a class from this and override different methods to acheive results that are different from the default implementation.

Constructor & Destructor Documentation

Avro.Generic.DefaultWriter.DefaultWriter ( Schema schema )

inline

Constructs a generic writer for the given schema.

Parameters

schema The schema for the object to be serialized

Member Function Documentation

virtual void Avro.Generic.DefaultWriter.EnsureArrayObject ( object value )

inlineprotectedvirtual

Checks if the given object is an array. If it is a valid array, this function returns normally. Otherwise, it throws an exception. The default implementation checks if the value is an array.

Parameters

value

virtual void Avro.Generic.DefaultWriter.EnsureMapObject ( object value )

inlineprotectedvirtual

Checks if the given object is a map. If it is a valid map, this function returns normally. Otherwise, it throws an exception. The default implementation checks if the value is an IDictionary<string, object>.

Parameters

value

virtual object Avro.Generic.DefaultWriter.GetArrayElement	(	object	value,
		long	index
	)

inlineprotectedvirtual

Returns the element at the given index from the given array object. The default implementation requires that the value is an object array and returns the element in that array. The defaul implementation gurantees that EnsureArrayObject() has been called on the value before this function is called.

Parameters

value	The array object
index	The index to look for

Returns: The array element at the index

virtual long Avro.Generic.DefaultWriter.GetArrayLength ( object value )

inlineprotectedvirtual

Returns the length of an array. The default implementation requires the object to be an array of objects and returns its length. The defaul implementation gurantees that EnsureArrayObject() has been called on the value before this function is called.

Parameters

value The object whose array length is required

Returns: The array length of the given object

virtual object Avro.Generic.DefaultWriter.GetField	(	object	value,
		string	fieldName,
		int	fieldPos
	)

inlineprotectedvirtual

Extracts the field value from the given object. In this default implementation, value should be of type GenericRecord.

Parameters

value	The record value from which the field needs to be extracted
fieldName	The name of the field in the record
fieldPos	The position of field in the record

Returns

virtual long Avro.Generic.DefaultWriter.GetMapSize ( object value )

inlineprotectedvirtual

Returns the size of the map object. The default implementation gurantees that EnsureMapObject has been successfully called with the given value. The default implementation requires the value to be an IDictionary<string, object> and returns the number of elements in it.

Parameters

value The map object whose size is desired

Returns: The size of the given map object

virtual IEnumerable<KeyValuePair<string, object> > Avro.Generic.DefaultWriter.GetMapValues ( object value )

inlineprotectedvirtual

Returns the contents of the given map object. The default implementation guarantees that EnsureMapObject has been called with the given value. The defualt implementation of this method requires that the value is an IDictionary<string, object> and returns its contents.

Parameters

value The map object whose size is desired

Returns: The contents of the given map object

virtual int Avro.Generic.DefaultWriter.ResolveUnion	(	UnionSchema	us,
		object	obj
	)

inlineprotectedvirtual

Finds the branch within the given UnionSchema that matches the given object. The default implementation calls Matches() method in the order of branches within the UnionSchema. If nothing matches, throws an exception.

Parameters

us	The UnionSchema to resolve against
obj	The object that should be used in matching

Returns

virtual void Avro.Generic.DefaultWriter.Write	(	Schema	schema,
		object	value,
		Encoder	encoder
	)

inlinevirtual

Examines the schema and dispatches the actual work to one of the other methods of this class. This allows the derived classes to override specific methods and get custom results.

Parameters

schema	The schema to use for serializing
value	The value to be serialized
encoder	The encoder to use during serialization

virtual void Avro.Generic.DefaultWriter.Write< S >	(	object	value,
		Schema.Type	tag,
		Writer< S >	writer
	)

inlineprotectedvirtual

A generic method to serialize primitive Avro types.

Template Parameters

S	Type of the C# type to be serialized

Parameters

value	The value to be serialized
tag	The schema type tag
writer	The writer which should be used to write the given type.

virtual void Avro.Generic.DefaultWriter.WriteArray	(	ArraySchema	schema,
		object	value,
		Encoder	encoder
	)

inlineprotectedvirtual

Serialized an array. The default implementation calls EnsureArrayObject() to ascertain that the given value is an array. It then calls GetArrayLength() and GetArrayElement() to access the members of the array and then serialize them.

Parameters

schema	The ArraySchema for serialization
value	The value being serialized
encoder	The encoder for serialization

Reimplemented in Avro.Specific.SpecificDefaultWriter.

virtual void Avro.Generic.DefaultWriter.WriteEnum	(	EnumSchema	es,
		object	value,
		Encoder	encoder
	)

inlineprotectedvirtual

Serializes an enumeration. The default implementation expectes the value to be string whose value is the name of the enumeration.

Parameters

es	The EnumSchema for serialization
value	Value to be written
encoder	Encoder for serialization

Reimplemented in Avro.Specific.SpecificDefaultWriter.

virtual void Avro.Generic.DefaultWriter.WriteFixed	(	FixedSchema	es,
		object	value,
		Encoder	encoder
	)

inlineprotectedvirtual

Serialized a fixed object. The default implementation requires that the value is a GenericFixed object with an identical schema as es.

Parameters

es	The schema for serialization
value	The value to be serialized
encoder	The encoder for serialization

Reimplemented in Avro.Specific.SpecificDefaultWriter.

virtual void Avro.Generic.DefaultWriter.WriteMap	(	MapSchema	schema,
		object	value,
		Encoder	encoder
	)

inlineprotectedvirtual

Serialized a map. The default implementation first ensure that the value is indeed a map and then uses GetMapSize() and GetMapElements() to access the contents of the map.

Parameters

schema	The MapSchema for serialization
value	The value to be serialized
encoder	The encoder for serialization

Reimplemented in Avro.Specific.SpecificDefaultWriter.

virtual void Avro.Generic.DefaultWriter.WriteNull	(	object	value,
		Encoder	encoder
	)

inlineprotectedvirtual

Serializes a "null"

Parameters

value	The object to be serialized using null schema
encoder	The encoder to use while serialization

virtual void Avro.Generic.DefaultWriter.WriteRecord	(	RecordSchema	schema,
		object	value,
		Encoder	encoder
	)

inlineprotectedvirtual

Serialized a record using the given RecordSchema. It uses GetField method to extract the field value from the given object.

Parameters

schema	The RecordSchema to use for serialization
value	The value to be serialized
encoder	The Encoder for serialization

Reimplemented in Avro.Specific.SpecificDefaultWriter.

virtual void Avro.Generic.DefaultWriter.WriteUnion	(	UnionSchema	us,
		object	value,
		Encoder	encoder
	)

inlineprotectedvirtual

Resolves the given value against the given UnionSchema and serializes the object against the resolved schema member. The default implementation of this method uses ResolveUnion to find the member schema within the UnionSchema.

Parameters

us	The UnionSchema to resolve against
value	The value to be serialized
encoder	The encoder for serialization

Reimplemented in Avro.Specific.SpecificDefaultWriter.

The documentation for this class was generated from the following file:

src/apache/main/Generic/GenericWriter.cs

Public Member Functions

Protected Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation