diff options
author | liamfallon <liam.fallon@est.tech> | 2020-10-16 13:09:11 +0100 |
---|---|---|
committer | liamfallon <liam.fallon@est.tech> | 2020-10-16 13:09:16 +0100 |
commit | 0cf967c0239a8ab9c8b8831b700b72d9a08f7b03 (patch) | |
tree | a4fbcd97008769d55ac443bc22abf517308bf6a7 /plugins/plugins-context/plugins-context-schema/plugins-context-schema-avro/src | |
parent | 9833876720ff14517ee78bda557e6021df723800 (diff) |
Remove apex asciidoc documents
Apex documentation has now all been ported to use the ONAP recommended
rst format. This review removes the old asciidoc documents.
Issue-ID: POLICY-2824
Change-Id: I562bd344cb7d6ff36e7d54bdb8f95e3b656468f8
Signed-off-by: liamfallon <liam.fallon@est.tech>
Diffstat (limited to 'plugins/plugins-context/plugins-context-schema/plugins-context-schema-avro/src')
-rw-r--r-- | plugins/plugins-context/plugins-context-schema/plugins-context-schema-avro/src/site-docs/adoc/fragments/ctx-schema-avro-config.adoc | 49 |
1 files changed, 0 insertions, 49 deletions
diff --git a/plugins/plugins-context/plugins-context-schema/plugins-context-schema-avro/src/site-docs/adoc/fragments/ctx-schema-avro-config.adoc b/plugins/plugins-context/plugins-context-schema/plugins-context-schema-avro/src/site-docs/adoc/fragments/ctx-schema-avro-config.adoc deleted file mode 100644 index 72bd8b9d9..000000000 --- a/plugins/plugins-context/plugins-context-schema/plugins-context-schema-avro/src/site-docs/adoc/fragments/ctx-schema-avro-config.adoc +++ /dev/null @@ -1,49 +0,0 @@ -// -// ============LICENSE_START======================================================= -// Copyright (C) 2016-2018 Ericsson. All rights reserved. -// ================================================================================ -// This file is licensed under the CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE -// Full license text at https://creativecommons.org/licenses/by/4.0/legalcode -// -// SPDX-License-Identifier: CC-BY-4.0 -// ============LICENSE_END========================================================= -// -// @author Sven van der Meer (sven.van.der.meer@ericsson.com) -// - -== Configure AVRO Schema Handler - -The AVRO schema handler is added to the configuration as follows: - -[source%nowrap,json] ----- -"engineServiceParameters":{ - "engineParameters":{ - "contextParameters":{ - "parameterClassName" : "org.onap.policy.apex.context.parameters.ContextParameters", - "schemaParameters":{ - "Avro":{ - "parameterClassName" : - "org.onap.policy.apex.plugins.context.schema.avro.AvroSchemaHelperParameters" - } - } - } - } -} ----- - -Using the AVRO schema handler has one limitation: AVRO only supports field names that represent valid Java class names. -This means only letters and the character `_` are supported. -Characters commonly used in field names, such as `.` and `-`, are not supported by AVRO. -for more information see link:https://avro.apache.org/docs/1.8.1/spec.html#names[Avro Spec: Names]. - -To work with this limitation, the APEX Avro plugin will parse a given AVRO definition and replace _all_ occurrences of `.` and `-` with a `_`. -This means that - -- In a policy model, if the AVRO schema defined a field as `my-name` the policy logic should access it as `my_name` -- In a policy model, if the AVRO schema defined a field as `my.name` the policy logic should access it as `my_name` -- There should be no field names that convert to the same internal name - ** For instance the simultaneous use of `my_name`, `my.name`, and `my-name` should be avoided - ** If not avoided, the event processing might create unwanted side effects -- If field names use any other not-supported character, the AVRO plugin will reject it - ** Since AVRO uses lazy initialization, this rejection might only become visible at runtime |