Internet Engineering Task Force (IETF) D. Karp
Request for Comments: 5957 Zimbra
Updates: 5256 July 2010
Category: Standards Track
ISSN: 2070-1721
Internet Engineering Task Force (IETF) D. Karp
Request for Comments: 5957 Zimbra
Updates: 5256 July 2010
Category: Standards Track
ISSN: 2070-1721
Display-Based Address Sorting for the IMAP4 SORT Extension
IMAP4排序扩展的基于显示的地址排序
Abstract
摘要
This document describes an IMAP protocol extension enabling server-side message sorting on the commonly displayed portion of the From and To header fields.
本文档描述了一个IMAP协议扩展，该扩展支持在“发件人”和“收件人”标题字段的常用显示部分进行服务器端消息排序。
Status of This Memo
关于下段备忘
This is an Internet Standards Track document.
这是一份互联网标准跟踪文件。
This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on Internet Standards is available in Section 2 of RFC 5741.
本文件是互联网工程任务组（IETF）的产品。它代表了IETF社区的共识。它已经接受了公众审查，并已被互联网工程指导小组（IESG）批准出版。有关互联网标准的更多信息，请参见RFC 5741第2节。
Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at http://www.rfc-editor.org/info/rfc5957.
有关本文件当前状态、任何勘误表以及如何提供反馈的信息，请访问http://www.rfc-editor.org/info/rfc5957.
Copyright Notice
版权公告
Copyright (c) 2010 IETF Trust and the persons identified as the document authors. All rights reserved.
版权所有（c）2010 IETF信托基金和确定为文件作者的人员。版权所有。
This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.
本文件受BCP 78和IETF信托有关IETF文件的法律规定的约束(http://trustee.ietf.org/license-info)自本文件出版之日起生效。请仔细阅读这些文件，因为它们描述了您对本文件的权利和限制。从本文件中提取的代码组件必须包括信托法律条款第4.e节中所述的简化BSD许可证文本，并提供简化BSD许可证中所述的无担保。
Table of Contents
目录
1. Introduction ....................................................2
2. Conventions Used in This Document ...............................2
3. DISPLAY Sort Value for an Address ...............................2
4. The DISPLAYFROM and DISPLAYTO Sort Criteria .....................3
5. Formal Syntax ...................................................3
6. Security Considerations .........................................3
7. Internationalization Considerations .............................4
8. IANA Considerations .............................................4
9. Normative References ............................................4
1. Introduction ....................................................2
2. Conventions Used in This Document ...............................2
3. DISPLAY Sort Value for an Address ...............................2
4. The DISPLAYFROM and DISPLAYTO Sort Criteria .....................3
5. Formal Syntax ...................................................3
6. Security Considerations .........................................3
7. Internationalization Considerations .............................4
8. IANA Considerations .............................................4
9. Normative References ............................................4
The [SORT] extension to the [IMAP] protocol provides a means for the server-based sorting of messages. It defines a set of sort criteria and the mechanism for determining the sort value of a message for each such ordering.
[IMAP]协议的[SORT]扩展为基于服务器的消息排序提供了一种方法。它定义了一组排序标准和机制，用于为每个此类排序确定消息的排序值。
The [SORT] FROM and TO orderings sort messages lexically on the [IMAP] addr-mailbox of the first address in the message's From and To headers, respectively. This document provides two alternative orderings, DISPLAYFROM and DISPLAYTO, which sort messages based on the first From or To address's [IMAP] addr-name (generally the same as its [RFC5322] display-name), when present.
[SORT]FROM和TO orderings分别在邮件的FROM和TO头中第一个地址的[IMAP]addr邮箱中对邮件进行词汇排序。本文档提供了两种可选排序，DISPLAYFROM和DISPLAYTO，它们根据第一个From或To地址的[IMAP]地址名（通常与其[RFC5322]显示名相同）对消息进行排序。
A server that supports the full [SORT] extension as well as both the DISPLAYFROM and DISPLAYTO sort criteria indicates this by returning "SORT=DISPLAY" in its CAPABILITY response.
支持完整[SORT]扩展以及DISPLAYFROM和DISPLAYTO排序条件的服务器通过在其功能响应中返回“SORT=DISPLAY”来指示这一点。
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119].
本文件中的关键词“必须”、“不得”、“必需”、“应”、“不应”、“应”、“不应”、“建议”、“可”和“可选”应按照[RFC2119]中所述进行解释。
For the purposes of the sort criteria defined in this document, the sort value for an [IMAP] address structure is defined as follows:
就本文件中定义的排序标准而言，[IMAP]地址结构的排序值定义如下：
o If the address structure's [IMAP] addr-name is non-NIL, apply the procedure from [RFC5255], Section 4.6. (That is, decode any [RFC2047] encoded-words and convert the resulting character string into a charset valid for the currently active [RFC4790] collation, with a default of UTF-8.) If the resulting octet string is not the empty string, use it as the sort value for the address.
o 如果地址结构的[IMAP]地址名为非NIL，则应用第4.6节[RFC5255]中的程序。（即，解码任何[RFC2047]编码字，并将结果字符串转换为对当前活动的[RFC4790]排序规则有效的字符集，默认值为UTF-8。）如果结果八位字节字符串不是空字符串，则将其用作地址的排序值。
o Otherwise, if the address structure's [IMAP] addr-mailbox and [IMAP] addr-host are both non-NIL, the sort value for the address is addr-mailbox@addr-host.
o 否则，如果地址结构的[IMAP]addr邮箱和[IMAP]addr主机均为非NIL，则地址的排序值为addr-mailbox@addr-主持人。
o Otherwise, if the address structure's [IMAP] addr-mailbox is non-NIL, the sort value for the address is its addr-mailbox.
o 否则，如果地址结构的[IMAP]地址邮箱为非NIL，则地址的排序值为其地址邮箱。
o If none of the above conditions are met, the sort value for the address is the empty string.
o 如果上述条件均不满足，则地址的排序值为空字符串。
This document introduces two new [SORT] sort criteria, DISPLAYFROM and DISPLAYTO. A message's sort value under these orderings MUST be derived as follows:
本文档介绍了两个新的[SORT]排序标准DISPLAYFROM和DISPLAYTO。这些排序下的邮件排序值必须按如下方式派生：
A "derived-addr" value is created from the [IMAP] envelope structure resulting from a FETCH ENVELOPE on the message. For DISPLAYFROM, the derived-addr value is the [IMAP] env-from value. For DISPLAYTO, the derived-addr value is the [IMAP] env-to value.
“派生的addr”值是从[IMAP]信封结构创建的，该信封结构由消息上的获取信封生成。对于DISPLAYFROM，派生的addr值是[IMAP]env from值。对于DISPLAYTO，派生的addr值是[IMAP]env to值。
o If the derived-addr value is NIL, the message's sort value is the empty string.
o 如果派生的addr值为NIL，则消息的排序值为空字符串。
o Otherwise, the message's sort value is the DISPLAY sort value of the first [IMAP] address in the derived-addr value.
o 否则，消息的排序值是派生addr值中第一个[IMAP]地址的显示排序值。
The following syntax specification uses the Augmented Backus-Naur Form (ABNF) notation as specified in [RFC5234]. [IMAP] defines the non-terminal "capability", and [SORT] defines "sort-key".
以下语法规范使用[RFC5234]中指定的增广巴科斯诺尔形式（ABNF）表示法。[IMAP]定义非终端“能力，[SORT]定义“排序键”。
capability =/ "SORT=DISPLAY"
capability =/ "SORT=DISPLAY"
sort-key =/ "DISPLAYFROM" / "DISPLAYTO"
sort-key =/ "DISPLAYFROM" / "DISPLAYTO"
This document defines an additional IMAP4 capability. As such, it does not change the underlying security considerations of [IMAP]. The author believes that no new security issues are introduced with this additional IMAP4 capability.
本文档定义了额外的IMAP4功能。因此，它不会改变[IMAP]的基本安全考虑因素。作者认为，这种额外的IMAP4功能不会带来新的安全问题。
DISPLAYFROM and DISPLAYTO are string-based sort criteria. As stated in [SORT], the active [RFC4790] collation as per [RFC5255] MUST be used when sorting such strings.
DISPLAYFROM和DISPLAYTO是基于字符串的排序条件。如[SORT]中所述，对此类字符串进行排序时，必须使用[RFC5255]中的活动[RFC4790]排序规则。
The DISPLAYFROM and DISPLAYTO orderings sort on the full decoded [IMAP] addr-name, when present. They do not attempt to parse this string in a locale- or language-dependent manner in order to determine and sort on some semantically meaningful substring such as the surname.
DISPLAYFROM和DISPLAYTO订单按完整解码的[IMAP]地址名排序（如果存在）。他们不会试图以区域设置或语言相关的方式解析该字符串，以确定某些语义上有意义的子字符串（如姓氏）并对其进行排序。
[IMAP] capabilities are registered by publishing a Standards Track or IESG-approved Experimental RFC. This document constitutes registration of the SORT=DISPLAY capability in the [IMAP] capabilities registry.
[IMAP]功能通过发布标准跟踪或IESG批准的实验RFC进行注册。本文档构成[IMAP]功能注册表中SORT=显示功能的注册。
[IMAP] Crispin, M., "INTERNET MESSAGE ACCESS PROTOCOL - VERSION 4rev1", RFC 3501, March 2003.
[IMAP]Crispin，M.，“互联网消息访问协议-版本4rev1”，RFC 35012003年3月。
[RFC2047] Moore, K., "MIME (Multipurpose Internet Mail Extensions) Part Three: Message Header Extensions for Non-ASCII Text", RFC 2047, November 1996.
[RFC2047]Moore，K.，“MIME（多用途互联网邮件扩展）第三部分：非ASCII文本的消息头扩展”，RFC 2047，1996年11月。
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC2119]Bradner，S.，“RFC中用于表示需求水平的关键词”，BCP 14，RFC 2119，1997年3月。
[RFC4790] Newman, C., Duerst, M., and A. Gulbrandsen, "Internet Application Protocol Collation Registry", RFC 4790, March 2007.
[RFC4790]Newman，C.，Duerst，M.，和A.Gulbrandsen，“互联网应用协议整理注册表”，RFC 47902007年3月。
[RFC5234] Crocker, D., Ed., and P. Overell, "Augmented BNF for Syntax Specifications: ABNF", STD 68, RFC 5234, January 2008.
[RFC5234]Crocker，D.，Ed.，和P.Overell，“语法规范的扩充BNF:ABNF”，STD 68，RFC 5234，2008年1月。
[RFC5255] Newman, C., Gulbrandsen, A., and A. Melnikov, "Internet Message Access Protocol Internationalization", RFC 5255, June 2008.
[RFC5255]Newman，C.，Gulbrandsen，A.，和A.Melnikov，“互联网消息访问协议国际化”，RFC 52552008年6月。
[RFC5322] Resnick, P., Ed., "Internet Message Format", RFC 5322, October 2008.
[RFC5322]Resnick，P.，Ed.“互联网信息格式”，RFC5222008年10月。
[SORT] Crispin, M. and K. Murchison, "Internet Message Access Protocol - SORT and THREAD Extensions", RFC 5256, June 2008.
[SORT]Crispin，M.和K.Murchison，“互联网消息访问协议-排序和线程扩展”，RFC 5256，2008年6月。
Author's Address
作者地址
Dan Karp Zimbra 3401 Hillview Avenue Palo Alto, CA 94304 USA
美国加利福尼亚州帕洛阿尔托Hillview大道3401号Dan Karp Zimbra 94304
EMail: dkarp@zimbra.com
URI: http://www.zimbra.com
EMail: dkarp@zimbra.com
URI: http://www.zimbra.com