wimaxing 2008-6-26 12:15
RFC5023-The Atom Publishing Protocol
【资料成文时间】: 2007
【语言】:英文
【页数】:53
【何人(公司)所著】:
【文件格式】: PDF
【文件原名】:The Atom Publishing Protocol
【摘要或目录】:
Table of Contents
1. Introduction ....................................................4
2. Notational Conventions ..........................................4
2.1. XML-Related Conventions ....................................4
2.1.1. Referring to Information Items ......................4
2.1.2. RELAX NG Schema .....................................4
2.1.3. Use of "xml:base" and "xml:lang" ....................5
3. Terminology .....................................................5
4. Protocol Model ..................................................6
4.1. Identity and Naming ........................................6
4.2. Documents and Resource Classification ......................7
4.3. Control and Publishing .....................................8
4.4. Client Implementation Considerations .......................9
5. Protocol Operations .............................................9
5.1. Retrieving a Service Document .............................10
5.2. Listing Collection Members ................................10
5.3. Creating a Resource .......................................11
5.4. Editing a Resource ........................................11
5.4.1. Retrieving a Resource ..............................11
5.4.2. Editing a Resource .................................12
5.4.3. Deleting a Resource ................................12
5.5. Use of HTTP Response Codes ................................12
6. Protocol Documents .............................................13
6.1. Document Types ............................................13
6.2. Document Extensibility ....................................13
7. Category Documents .............................................14
7.1. Example ...................................................14
7.2. Element Definitions .......................................14
7.2.1. The "app:categories" Element .......................14
8. Service Documents ..............................................15
8.1. Workspaces ................................................16
8.2. Example ...................................................16
8.3. Element Definitions .......................................17
8.3.1. The "app:service" Element ..........................17
8.3.2. The "app:workspace" Element ........................18
8.3.3. The "app:collection" Element .......................18
8.3.4. The "app:accept" Element ...........................19
8.3.5. Usage in Atom Feed Documents .......................19
8.3.6. The "app:categories" Element .......................20
9. Creating and Editing Resources .................................20
9.1. Member URIs ...............................................20
9.2. Creating Resources with POST ..............................20
9.2.1. Example ............................................21
9.3. Editing Resources with PUT ................................22
9.4. Deleting Resources with DELETE ............................22
9.5. Caching and Entity Tags ...................................22
9.5.1. Example ............................................23
9.6. Media Resources and Media Link Entries ....................25
9.6.1. Examples ...........................................26
9.7. The Slug Header ...........................................30
9.7.1. Slug Header Syntax .................................31
9.7.2. Example ............................................31
10. Listing Collections ...........................................32
10.1. Collection Partial Lists .................................32
10.2. The "app:edited" Element .................................33
11. Atom Format Link Relation Extensions ..........................34
11.1. The "edit" Link Relation .................................34
11.2. The "edit-media" Link Relation ...........................34
12. The Atom Format Type Parameter ................................34
12.1. The "type" parameter .....................................34
12.1.1. Conformance .......................................35
13. Atom Publishing Controls ......................................35
13.1. The "app:control" Element ................................35
13.1.1. The "app:draft" Element ...........................36
14. Securing the Atom Publishing Protocol .........................36
15. Security Considerations .......................................37
15.1. Denial of Service ........................................37
15.2. Replay Attacks ...........................................37
15.3. Spoofing Attacks .........................................37
15.4. Linked Resources .........................................38
15.5. Digital Signatures and Encryption ........................38
15.6. URIs and IRIs ............................................38
15.7. Code Injection and Cross Site Scripting ..................39
16. IANA Considerations ...........................................39
16.1. Content-Type Registration for ’application/atomcat+xml’ ..39
16.2. Content-Type Registration for ’application/atomsvc+xml’ ..40
16.3. Header Field Registration for ’SLUG’ .....................42
16.4. The Link Relation Registration "edit" ....................42
16.5. The Link Relation Registration "edit-media" ..............42
16.6. The Atom Format Media Type Parameter .....................43
17. References ....................................................43
17.1. Normative References .....................................43
17.2. Informative References ...................................44
Appendix A. Contributors ..........................................46
Appendix B. RELAX NG Compact Schema ...............................46