package openfl.net {
/**
 * 	The ObjectEncoding class is used in defining serialization settings in
 * 	classes that serialize objects (such as FileStream, NetStream,
 * 	NetConnection, SharedObject, and ByteArray).
 * 
 * 	Object encoding controls how objects are represented in serialized
 * 	formats, such as the Active Message Format (AMF) used by the Flash
 * 	runtime. Flash Player uses AMF to enable efficient communication
 * 	between an application and a remote server. AMF encodes remote procedure
 * 	calls into a compact binary representation that can be transferred over
 * 	HTTP/HTTPS or the RTMP/RTMPS protocol used by Flash Media Server.
 * 	Objects and data values are serialized into this binary format, which
 * 	is generally more compact than other representations, such as XML.
 * 
 * 	OpenFL supports additional object encoding formats on non-Flash targets,
 * 	including the Haxe Serialization Format (HXSF) and JavaScript Object
 * 	Notation (JSON) for efficient communication for objects.
 * 
 * 	Although AMF support is included in the Flash runtime, use of AMF on
 * 	other targets requires the Haxe "format" library.
 * 
 * 	_You can add the "format" library to your project by using
 * 	`<haxelib name="format" />` in an OpenFL project XML file._
 * 
 * 	Adobe AIR and Flash Player 9 can serialize in two different formats:
 * 	AMF3 and AMF0. AMF3, the default serialization developed for
 * 	ActionScript 3.0, provides various advantages over AMF0, which is used
 * 	for ActionScript 1.0 and 2.0. AMF3 sends data over the network more
 * 	efficiently than AMF0. AMF3 supports sending `int` and `uint` objects as
 * 	integers and supports data types that are available only in
 * 	ActionScript 3.0, such as ByteArray, XML, and IExternalizable. It is
 * 	available only in ActionScript 3.0 and with servers that use AMF3
 * 	encoding, such as Flex 2.
 * 
 * 	The ByteArray, FileStream, NetConnection, NetStream, SharedObject,
 * 	Socket, and URLStream classes contain an `objectEncoding` property that is
 * 	assigned a constant from the ObjectEncoding class. The behavior of the
 * 	`objectEncoding` property differs depending on the object; each class's
 * 	`objectEncoding` property description explains the behavior more
 * 	thoroughly.
 * 
 * @externs
 */
public class ObjectEncoding {
	/**
	 * 		Allows greater control over the serialization of dynamic properties of
	 * 		dynamic objects. When this property is set to `null`, the default value,
	 * 		dynamic properties are serialized using native code, which writes all
	 * 		dynamic properties excluding those whose value is a function.
	 * 
	 * 		This value is called only for properties of a dynamic object (objects
	 * 		declared within a dynamic class) or for objects declared using the
	 * 		`new` operator.
	 * 
	 * 		You can use this property to exclude properties of dynamic objects from
	 * 		serialization; to write values to properties of dynamic objects; or to
	 * 		create new properties for dynamic objects. To do so, set this property
	 * 		to an object that implements the `IDynamicPropertyWriter` interface. For
	 * 		more information, see the `IDynamicPropertyWriter` interface.
	 * 	
	 */
	public static var dynamicPropertyWriter:openfl.net.IDynamicPropertyWriter;
	/**
	 * 		Specifies that objects are serialized using the
	 * 		Action Message Format for ActionScript 1.0 and 2.0.
	 * 	
	 */
	public static const AMF0:int = 0;
	/**
	 * 		Specifies that objects are serialized using the
	 * 		Action Message Format for ActionScript 3.0.
	 * 	
	 */
	public static const AMF3:int = 3;
	/**
	 * 		Specifies that objects are serialized using the
	 * 		Haxe Serialization Format (HXSF). Serialized objects 
	 * 		in this format are prefixed with a 16-bit length 
	 * 		header, which limits the maximum data size to 65,535 bytes.
	 * 	
	 */
	public static const HXSF:int = 10;
	/**
	 * 		Specifies that objects are serialized using the
	 * 		Haxe Serialization Format (HXSF). Serialized objects
	 * 		in this format are prefixed with a 32-bit length header.
	 * 	
	 */
	public static const LARGE_HXSF:int = 11;
	/**
	 * 		Specifies that objects are serialized using
	 * 		JavaScript Object Notation (JSON). Serialized objects 
	 * 		in this format are prefixed with a 16-bit length 
	 * 		header, which limits the maximum data size to 65,535 bytes.
	 * 	
	 */
	public static const JSON:int = 12;
	/**
	 * 		Specifies that objects are serialized using
	 * 		JavaScript Object Notation (JSON). Serialized objects 
	 * 		in this format are prefixed with a 32-bit length 
	 * 		header.
	 * 	
	 */
	public static const LARGE_JSON:int = 13;
	/**
	 * 		Specifies the default format for the current target and runtime.
	 * 
	 * 		Currently, the default on the Flash and AIR targets is AMF3, and
	 * 		the default on other targets is HXSF. If, in the future, a newer
	 * 		version of OpenFL introduces support for a new object encoding
	 * 		format, this may change. You can use this constant only if you're
	 * 		not concerned about interoperability with previous versions.
	 * 	
	 */
	public static const DEFAULT:int = 10;
}
}