Skip to Content

Changes for page ERRest In Depth

Last modified by Pascal Robert on 2012/06/10 16:01
From version 39.1
edited by Pascal Robert
on 2012/05/02 21:50
Change comment: There is no comment for this version
To version 36.1
edited by Pascal Robert
on 2012/03/11 21:01
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,98 +96,3 @@
1 -* ERXRestContext
2 -** contains the editing context and an userInfo dictionnary
3 -** will be populated with er.rest.dateFormat, er.rest.timestampFormatter and er.rest.timestampFormat (read only for non-HTML responses)
4 -*** want to change the time format for a specific controller?
5 -
6 -{{code}}
7 -
8 -protected ERXRestContext createRestContext() {
9 - ERXRestContext restContext = new ERXRestContext(editingContext());
10 - restContext.setUserInfoForKey("yyyy-MM-dd", "er.rest.dateFormat");
11 - restContext.setUserInfoForKey("yyyy-MM-dd", "er.rest.timestampFormat");
12 - return restContext;
13 - }
14 -
15 -{{/code}}
16 -
17 -*
18 -** you just need to override createRestContext() in your controller if you want to add other stuff to the context (a user, etc.)
19 -* Properties
20 -** ERXRest.idKey (ERXRestFormatDelegate)
21 -*** (default "id") Override this property if you want to use a different key for the 'id' attribute** ERXRest.typeKey**
22 -** ERXRest.nilKey (ERXRestFormatDelegate)
23 -** ERXRest.writeNilKey (ERXRestFormatDelegate)
24 -** ERXRest.pluralEntityNames (ERXRestFormatDelegate)
25 -** ERXRest.writeTypeKey (ERXRestFormatDelegate)
26 -** ERXRest.suppressTypeAttributesForSimpleTypes (ERXXmlRestWriter)
27 -*** (default "false") If set to true, primitive types, like type = "datetime", won't be added to the output
28 -** ERXRest.strictMode
29 -*** In ERXMissingRouteController: (default "true") If set to true, status code in the response will be 405 Not Allowed, if set to false, status code will be 404 Not Found
30 -*** In ERXRouteController: (default "true") If set to true, status code in the response will be 405 Not Allowed, if set to false, status code will be 404 Not Found
31 -*** ERXRouteResults: (default "true") If set to true, creating a ressource will return status code 201 Created, if set to false, will return 200 OK
32 -** ERXRest.pluralEntityNames (ERXRouteRequestHandler)
33 -** ERXRest.routeCase (ERXRouteRequestHandler)
34 -** ERXRest.lowercaseEntityNames (ERXRouteRequestHandler)
35 -** ERXRest.parseUnknownExtensions (ERXRouteRequestHandler)
36 -*** (default "true") If set to "false", will return a 404 status code if the format doesn't exist
37 -** ERXRest.missingControllerName (ERXRouteRequestHandler)
38 -*** (default "ERXMissingRouteController") Allow you to specify which controller to use when a route doesn't exist
39 -** er.rest.rfcDateFormat
40 -** er.rest.dateFormat
41 -** er.rest.dateFormat.primary
42 -** er.rest.dateFormat.secondary
43 -** er.rest.dateFormatter
44 -** er.rest.timestampFormat
45 -** er.rest.timestampFormat.primary
46 -** er.rest.timestampFormat.secondary
47 -** er.rest.timestampFormatter
48 -** er.rest.rfcDateFormat
49 -** ERXRest.transactionsEnabled (default 'false') ERXRestTransactionRequestAdaptor
50 -** ERXRest.maxEventsPerTransaction (default '50') ERXRestTransactionRequestAdaptor
51 -** ERXRest.accessControlAllowRequestHeaders (ERXRouteController)
52 -** ERXRest.accessControlAllowRequestMethods (ERXRouteController)
53 -** ERXRest.defaultFormat (ERXRouteController)
54 -*** (default "xml") Allow you to set the default format for all of your REST controllers
55 -** ERXRest.allowWindowNameCrossDomainTransport (ERXRouteController)
56 -** ERXRest.accessControlMaxAge (ERXRouteController)
57 -*** (default 1728000) This header indicates how long the results of a preflight request can be cached. For an example of a preflight request, see the above examples.
58 -** ERXRest.accessControlAllowOrigin (ERXRouteController)
59 -*** Set the value to '**' to enable all origins. See https:~/~/developer.mozilla.org/En/HTTP_access_control#Access-Control-Allow-Origin**
60 -* JSON Schema
61 -** {{code}}
62 -/something?schema=true
63 -
64 -public WOActionResults indexAction() {
65 -if (isSchemaRequest()) {
66 - return schemaResponse(showFilter());
67 -}
68 -protected boolean isSchemaRequest() {
69 - return request().stringFormValueForKey("schema") != null;
70 -}
71 -{{/code}}
72 -
73 -Same Origin policy
74 -Transactions
75 -HTML vs other formats
76 -Response representation
77 -Missing route
78 -Missing object
79 -POJO objects
80 -Headers
81 -Caching
82 -Adding new format
83 -Security
84 -strictMode
85 -Workflow
86 -Query arguments and RXRestFetchSpecification
87 -ERXRestNameRegistry
88 -MapClassDescription / NSDictionaryClassDescription
89 -
90 -ERXRestUtils
91 -Properties
92 -er.rest.dateFormat
93 -er.rest.timestampFormat
94 -er.rest.rfcDateFormat
95 -
96 96  request > route
97 97  
98 98  Application(ERXApplication).dispatchRequest(WORequest) line: 2051