FlexRest

هناك العديد من المرشحات المخصصة المخصصة التي يمكن أن تجعل حياتك أسهل (يتطلب Flex 4).

CompositeserializationFilter

تنفيذ نمط التصميم المركب لمرشحات تسلسل HTTP . تجاوز أي من 5 أساليب SerializationFilter باستخدام مثيلات مرشح مختلفة:

 <mx:HTTPService>
	<mx:serializationFilter>
		<rest:CompositeSerializationFilter>
			<!-- Serialize requests in JSON -->
			<rest:bodySerializer>
				<rest:JSONSerializationFilter />
			</rest:bodySerializer>
			<!-- Deserialize replies in JSON -->
			<rest:resultDeserializer>
				<rest:JSONSerializationFilter />
			</rest:resultDeserializer>
			<!-- Build REST-style URLs dynamically -->
			<rest:urlSerializer>
				<rest:RESTSerializationFilter />
			</rest:urlSerializer>
			<!-- Use custom HTTP methods -->
			<rest:parametersSerializer>
				<rest:RESTSerializationFilter />
			</rest:parametersSerializer>
			<!-- Set request content type to application/json -->
			<rest:contentTypeProvider>
				<rest:RESTSerializationFilter requestContentType="application/json" />
			</rest:contentTypeProvider>
		</rest:CompositeSerializationFilter>
	</mx:serializationFilter>
</mx:HTTPMultiService>

أساليب SerializationFilter التي يمكن تجاوزها:

• deserializeResult
• getRequestContentType
• serializeParameters
• serializeBody
• serializeURL

يتم التعامل مع الطرق التي لم يتم تجاوزها باستخدام مسلسل متسلسل منتظم.

الاستراحة

ينفذ serializeParameters ، contentTypeProvider و serializeURL .

يتيح لك إرسال أفعال HTTP مخصصة ، بخلاف GET أو POST ، والتي لا تدعمها مشغل الفلاش افتراضيًا. يمكنك تحديد إحدى الطرق الثلاث الممكنة للقيام بذلك:

• أرسله في رأس X- http -method-override ( methodOverride="header" ). لا تنس تحديث ملف CrossDomain.xml الخاص بك للسماح بإرسال الرؤوس إلى مجالات أخرى.
• قم بإلحاق معلمة _method بجميع عناوين URL ( methodOverride="url" ).
• أرسله جسم طلب كمعلمة _method ( methodOverride="variable" ). سيجبر هذا على طلبك التسلسلي على أنه application/x-www-form-urlencoded .

يمكن أيضًا استخدام مرشح التسلسل هذا لإنشاء عناوين URL الديناميكية التي تتناسب مع معلمات رمزية (محاطة بأقواس مربعة).

 <fx:Declarations>
	<rest:RESTSerializationFilter 
		id="restSerializer" 
		methodOverride="variable"
		requestContentType="application/x-www-form-urlencoded" />
	<mx:HTTPMultiService
		id="service"
		baseURL="http://example.com/api/"	
	>
		<mx:serializationFilter>
			<!-- contentTypeProvider is required in order to convert custom HTTP verbs to POST 
			and to set content type to 'application/x-www-form-urlencoded'. -->
			<!-- urlSerializer will replace square bracket tokens in URLs. -->
			<!-- parametersSerializer will add a '_method' variable to your requests, if needed. -->
			<rest:CompositeSerializationFilter 
				contentTypeProvider="{restSerializer}" 
				urlSerializer="{restSerializer}"
				parametersSerializer="{restSerializer}" />
		</mx:serializationFilter>		
		<mx:operationList>
			<!-- 
				[ID] and any other token will be automatically 
				replaced by variables from operation arguments object 
			-->
			<mx:HTTPOperation
				name="getUser"
				url="User/[ID]" />			
			<!--
				Request will be sent as a POST request
				with a "_method"="DELETE" variable
			-->
			<mx:HTTPOperation
				name="deleteUser"
				url="User/[ID]"
				method="DELETE" />
		</mx:operationList>
	</mx:HTTPMultiService>
</fx:Declarations> 

 import mx.rpc.AbstractOperation;
import mx.rpc.AsyncToken;
		
import vo.User;
		
private function getUser(userId:uint):AsyncToken
{
	var operation:AbstractOperation = service.getOperation("getUser");
	operation.arguments = { ID: userId }; //replace URL tokens
			
	return operation.send();
	//You can also add your variable to requests:
	//return operation.send({ varname: "varvalue" });
}

jsonserializationFilter

ينفذ أساليب deserializeResult و contentTypeProvider و serializeBody .

تسلسل الطلبات وإردود Deserialize في JSON مع محلل JSON سريع (فقط في إصدار FP11 ؛ إصدار FP9 يعتمد على محلل JSOR من AS3CORELIB). يمكن تحويل الطلبات والردود من وإلى كائنات مملوءة بقوة أثناء الطيران. تتوفر ميزات تعيين الكائن التالية:

• يمكن تعيين المصفوفات الواردة إلى متجهات أو صفائف من الأشياء المكتوبة بقوة.
• يمكن استخدام ArrayElementType Metatag لتعيين صفائف الكائنات المكتوبة.
• يتم احترام metatag Transient في الطلبات والاستجابات.
• سلاسل التاريخ بتنسيق /Date(1325376000000)/ JSON (1325376000000) / يمكن تحويلها إلى كائنات Date ، والعكس صحيح.

على سبيل المثال ، عندما تتلقى هذا:

 {
	"owner":{
		"birthday":"/Date(1325376000000)/",
		"firstName":"John",
		"lastName":"Smith"
	}
	"wheels":[
		{ "position": { "x":1, "y":1 } },
		{ "position": { "x":1, "y":-1 } },
		{ "position": { "x":-1, "y":1 } },
		{ "position": { "x":-1, "y":-1 } }
	]
}

يمكن تحويله إلى هذه:

 public class User
{
	public var birthday:Date;		
	public var firstName:String;		
	public var lastName:String;
}	
public class Car
{
	public var owner:User;
	[ArrayElementType("vo.Wheel")] 
	public var wheels:Array;	
	//You can just use vectors instead
	//public var wheels:Vector.<Wheel>
}
import flash.geom.Point;
public class Wheel
{
	public var position:Point;
}

باستخدام الرمز التالي:

 <fx:Declarations>
	<mx:HTTPMultiService
		id="service"
		baseURL="http://example.com/api/"	
	>
		<mx:serializationFilter>
			<rest:CompositeSerializationFilter>
				<!-- Serialize requests from objects to JSON. -->
				<rest:bodySerializer>
					<rest:JSONSerializationFilter />
				</rest:bodySerializer>
				<!-- Deserialize replies from JSON to strongly-typed objects. -->
				<rest:resultDeserializer>
					<rest:JSONSerializationFilter />
				</rest:resultDeserializer>
				<!-- Forces requests content type to be 'application/json'.
				     This is required in order to encode requests in JSON.
				     If content type is not changed either this way, 
				     or manually on an operation, Flex will handle 
				     request body encoding by itself. -->
				<rest:contentTypeProvider>
					<rest:RESTSerializationFilter requestContentType="application/json" />
				</rest:contentTypeProvider>
				<!-- This serializer is required for JSON requests. -->
				<rest:parametersSerializer>
					<rest:RESTSerializationFilter />
				</rest:parametersSerializer>
			</rest:CompositeSerializationFilter>
		</mx:serializationFilter>		
		<mx:operationList>
			<!-- 
				Note that there is a resultElementType
				property set on the operation
			-->
			<mx:HTTPOperation
				name="getCar"
				url="Car/[ID]"
				method="GET"
				resultElementType="{Car}"
				result="onCarLoaded(event)" />
		</mx:operationList>
	</mx:HTTPMultiService>
</fx:Declarations> 

 import mx.rpc.events.ResultEvent;
		
import vo.Car;
import vo.User;
import vo.Wheel;
		
private function onCarLoaded(event:ResultEvent):void
{
	var car:Car = Car(event.result);
	var wheels:Vector.<Wheel> = car.wheels;
			
	var owner:User = car.owner;
	var birthday:Date = owner.birthday;
}

إذا كان لديك مجموعة من الأشياء ...

 [
	{ "x":1, "y":5 },
	{ "x":2, "y":4 },
	{ "x":3, "y":3 },
	{ "x":4, "y":2 },
	{ "x":5, "y":1 }
]

... يمكنك استلامها كمجموعة من الكائنات المغطاة بقوة عن طريق تعيين resultFormat="array" و resultElementType="{ElementClass}" . بشكل افتراضي ، يتم لف جميع المصفوفات في ArrayCollection . لتجنب هذا السلوك ، ما عليك سوى تعيين makeObjectsBindable="false" على مثيل التشغيل.

 <mx:HTTPOperation
	name="getPoints"
	url="Points/[FROM]/[TO]"
	resultFormat="array"
	makeObjectsBindable="false"
	resultElementType="{Point}"
	result="onPointsLoaded(event)" /> 

 private function onPointsLoaded(event:ResultEvent):void
{
	trace(event.result.length);
	
	for each(var point:Point in event.result)
		trace(point.x + point.y);
}

JSONSerializationFilter هو تنفيذ لمكافحة TypedSerializationFilter المجردة التي تتولى التحول ، في حين أن فئة الطفل الخرسانية تتعامل مع تسلسل البيانات الفعلية وفرزلها.

سيؤدي إعداد resultFormat إلى أي قيمة أخرى ، إلى جانب array object (الافتراضي) إلى JSONSerializationFilter (أو أي TypedSerializationFilter ) ليتم قمعه في HTTPOperation المحدد.

XMLSerializationFilter

ينفذ أساليب deserializeResult و contentTypeProvider و serializeBody .

يتصرف بنفس الطريقة مثل JSONSerializationFilter . يمكنك استخدام خصائص xmlEncode و xmlDecode الاختيارية لتعيين طرق التسلسل المخصصة:

 <mx:HTTPService>
	<mx:serializationFilter>
		<rest:CompositeSerializationFilter>
			<!-- Serialize requests from objects to XML. -->
			<rest:bodySerializer>
				<rest:XMLSerializationFilter xmlEncode="{doXmlEncode}" />
			</rest:bodySerializer>
			<!-- Deserialize replies from XML to strongly-typed objects. -->
			<rest:resultDeserializer>
				<rest:XMLSerializationFilter xmlDecode="{doXmlDecode}" />
			</rest:resultDeserializer>
			<!-- Forces requests content type to be 'application/xml'. -->
			<rest:contentTypeProvider>
				<rest:RESTSerializationFilter requestContentType="application/xml" />
			</rest:contentTypeProvider>
			<!-- This serializer is required for XML requests. -->
			<rest:parametersSerializer>
				<rest:RESTSerializationFilter />
			</rest:parametersSerializer>
		</rest:CompositeSerializationFilter>
	</mx:serializationFilter>
</mx:HTTPMultiService> 

 private function doXmlEncode(body:Object):XMLNode
{
	return new XMLNode(1, '<body id="' + body.id + '"/>');
}

private function doXmlDecode(node:XMLNode):Object
{
	return { id: node.attributes.id };
}

BasicauthenticationSerializationFilter

يمتد CompositeSerializationFilter مع خصائصين جديدين: username وكلمة password . سيضيف رأس مصادقة HTTP الأساسي إلى جميع الطلبات.

 <mx:HTTPService>
	<mx:serializationFilter>
		<rest:BasicAuthenticationSerializationFilter username="admin" password="qwerty">
			<rest:bodySerializer>
				<rest:XMLSerializationFilter />
			</rest:bodySerializer>
			<rest:resultDeserializer>
				<rest:XMLSerializationFilter />
			</rest:resultDeserializer>
			<rest:contentTypeProvider>
				<rest:RESTSerializationFilter requestContentType="application/xml" />
			</rest:contentTypeProvider>
			<rest:parametersSerializer>
				<rest:RESTSerializationFilter />
			</rest:parametersSerializer>
		</rest:BasicAuthenticationSerializationFilter>
	</mx:serializationFilter>
</mx:HTTPMultiService>

OauthserializationFilter

يمتد المركبات CompositeSerializationFilter . يمكن استخدامها لإنشاء وتخصيص رأس OAUTH لطلباتك.

 <mx:HTTPService>
	<mx:serializationFilter>
		<rest:OAuthSerializationFilter id="oauthFilter" keySecret="kAcSOqF21Fu85e7zjz7ZN2U4ZRhfV3WpwPAoE3Z7kBw" tokenSecret="LswwdoUaIvS8ltyTt5jkRh4J50vUPVVHtR2YPi5kE">
			<rest:bodySerializer>
				<rest:XMLSerializationFilter />
			</rest:bodySerializer>
			<rest:resultDeserializer>
				<rest:XMLSerializationFilter />
			</rest:resultDeserializer>
			<rest:contentTypeProvider>
				<rest:RESTSerializationFilter requestContentType="application/xml" />
			</rest:contentTypeProvider>
			<rest:parametersSerializer>
				<rest:RESTSerializationFilter />
			</rest:parametersSerializer>
		</rest:BasicAuthenticationSerializationFilter>
	</mx:serializationFilter>
	<mx:operationList>
		<mx:HTTPOperation
			name="getUser"
			url="User/[ID]" />			
	</mx:operationList>
</mx:HTTPMultiService> 

 import mx.rpc.AbstractOperation;
import mx.rpc.AsyncToken;
import mx.rpc.http.OAuthHeader;
import mx.rpc.utils.OAuthUtil;
		
import vo.User;
		
private function getUser(userId:uint):AsyncToken
{
	var oauthData:OAuthHeader = new OAuthHeader();
	oauthData.oauth_version = "1.0";
	oauthData.oauth_consumer_key = "xvz1evFS4wEEPTGEFPHBog";
	oauthData.oauth_token = "370773112-GmHxMAgYyLbNEtIKZeRNFsMKPR9EyMZeS9weJAEb";
	oauthData.oauth_nonce = OAuthUtil.generateNonce();
	oauthData.oauth_signature_method = OAuthHeader.SIGNATURE_METHOD_HMAC_SHA1;
	oauthData.oauth_timestamp = OAuthUtil.getTimestamp();

	var operation:AbstractOperation = service.getOperation("getUser");
	operation.arguments = { ID: userId }; //replace URL tokens

	oauthFilter.oauthData = oauthData;

	return operation.send();
}

---

يمكن استخدام فئة mx.utils.TypeUtil الثابت لجميع المسبوكات المذكورة أعلاه.

يمكن استخدام mx.rpc.OperationResponder لجعل معالجات التشغيل أكثر وضوحًا. إنه يحاكي فئة Flex's AsyncResponder ، ولكن مع توقيعات وظائف نتيجة مختلفة. توقيع معالج النتائج الصالح هو function(valueObject:Object):void . ستتلقى وظيفة معالج النتائج ResultEvent.result ، بحيث يمكنك فقط تعيين نوع النتيجة في معالج: function(valueObject:MyResultClass):void . توقيع معالج الصدع الصحيح هو function(fault:Fault):void .

 import mx.rpc.OperationResponder;
		
import vo.User;
		
private function getUser():void
{	
	service.getOperation("getUser").send().addResponder(new OperationResponder(onResult, onFault));
}

private function onResult(user:User):void
{
	trace(user.firstName);
}

private function onFault(fault:Fault):void
{
	trace(fault.faultDetail);
}