|
936 | 936 | <t>
|
937 | 937 | Due to security and performance concerns, as well as the open-ended nature of
|
938 | 938 | possible content types, implementations MUST NOT automatically decode, parse,
|
939 |
| - and/or validate the string contents by default. This additionally supports |
940 |
| - the use case of embedded documents intended for processing by a different |
941 |
| - consumer than that which processed the containing document. |
| 939 | + and/or validate the string contents. Applications are expected to use these |
| 940 | + annotations to invoke the appropriate libraries (including JSON Schema for |
| 941 | + any further schema-based validation) separately. |
942 | 942 | </t>
|
943 | 943 | <t>
|
944 | 944 | All keywords in this section apply only to strings, and have no
|
945 | 945 | effect on other data types.
|
946 | 946 | </t>
|
947 |
| - <t> |
948 |
| - Implementations MAY offer the ability to decode, parse, and/or validate |
949 |
| - the string contents automatically. However, it MUST NOT perform these |
950 |
| - operations by default, and MUST provide the validation result of each |
951 |
| - string-encoded document separately from the enclosing document. This |
952 |
| - process SHOULD be equivalent to fully evaluating the instance against |
953 |
| - the original schema, followed by using the annotations to decode, parse, |
954 |
| - and/or validate each string-encoded document. |
955 |
| - <cref> |
956 |
| - For now, the exact mechanism of performing and returning parsed |
957 |
| - data and/or validation results from such an automatic decoding, parsing, |
958 |
| - and validating feature is left unspecified. Should such a feature |
959 |
| - prove popular, it may be specified more thoroughly in a future draft. |
960 |
| - </cref> |
961 |
| - </t> |
962 |
| - <t> |
963 |
| - See also the <xref target="security">Security Considerations</xref> |
964 |
| - sections for possible vulnerabilities introduced by automatically |
965 |
| - processing the instance string according to these keywords. |
966 |
| - </t> |
967 | 947 | </section>
|
968 | 948 |
|
969 | 949 | <section title="contentEncoding">
|
970 | 950 |
|
971 | 951 | <t>
|
972 | 952 | If the instance value is a string, this property defines that the string
|
973 |
| - SHOULD be interpreted as encoded binary data and decoded using the encoding |
974 |
| - named by this property. |
| 953 | + SHOULD be interpreted as encoded binary data and, and applications wishing |
| 954 | + to decode it SHOULD do so using the encoding named by this property. |
975 | 955 | </t>
|
976 | 956 |
|
977 | 957 | <t>
|
|
1023 | 1003 | </t>
|
1024 | 1004 | <t>
|
1025 | 1005 | This keyword MAY be used with any media type that can be mapped into
|
1026 |
| - JSON Schema's data model. |
| 1006 | + JSON Schema's data model. Specifying such mappings is outside of the |
| 1007 | + scope of this specification. |
1027 | 1008 | </t>
|
1028 | 1009 | <t>
|
1029 | 1010 | The value of this property MUST be a valid JSON schema. It SHOULD be ignored if
|
|
0 commit comments