|
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