JarCasting
amf-helper-mixin
Common functions used by AMF components to compute AMF values. This mixin is safe to use in both Polymer and LitElement projects as well as pure web components.
Version compatibility
This version only works with AMF model version 2 (AMF parser >= 4.0.0). For compatibility with previous model version use 3.x.x version of the component.
Updating API's base URI
(Only applies when using _computeUri() function)
By default the component render the documentation as it is defined in the AMF model. Sometimes, however, you may need to replace the base URI of the API with something else. It is useful when the API does not have base URI property defined (therefore this component render relative paths instead of URIs) or when you want to manage different environments.
To update base URI value update the baseUri property.
When the component constructs the final URI for the endpoint it does the following:
- if
baseUriis set it uses this value as a base URI for the endpoint - else if
amfis set then it computes base URI value from main model document Then it concatenates computed base URI withendpoint's path property.
Using AMF keys
The mixin has AMF's model namespace defined under ns property. Use this structure to request AMF key (for example when calling _getAmfKey()). AMF keys may change over time. This way it allows to manage the keys change easier as the components don't have to change, just this mixin.
don't do this
const key = this._getAmfKey(this.ns.aml.vocabularies.document + 'encodes');
const key = shape[this.ns.aml.vocabularies.document + 'encodes'];
do this
const key = this._getAmfKey(this.ns.aml.vocabularies.document.encodes);
const value = model[key];
// acceptable only if AMF model is not compact.
const value = model[this.ns.aml.vocabularies.document.encodes];
Installation
npm i @api-components/amf-helper-mixin
Usage
import { LitElement } from 'lit-element';
import { AmfHelperMixin } from '@api-components/amf-helper-mixin/amf-helper-mixin.js';
class AmfHelperImpl extends AmfHelperMixin(LitElement) {
static get properties() {
return {
myProp: { type: String }
};
}
}
Testing
npm run test
Testing with Sauce Labs
npm run test:sl
Demo
npm start
