breeze-client
Version:
Breeze data management for JavaScript clients
92 lines (89 loc) • 13.3 kB
JavaScript
import { assertConfig } from './assert-param';
import { core } from './core';
import { config } from './config';
/**
A NamingConvention instance is used to specify the naming conventions under which a MetadataStore
will translate property names between the server and the javascript client.
The default NamingConvention does not perform any translation, it simply passes property names thru unchanged.
@dynamic
**/
export class NamingConvention {
/** Function that takes a server property name add converts it into a client side property name. __Read Only__ */
serverPropertyNameToClient;
/** Function that takes a client property name add converts it into a server side property name. __Read Only__ */
clientPropertyNameToServer;
/**
NamingConvention constructor
> // A naming convention that converts the first character of every property name to uppercase on the server
> // and lowercase on the client.
> var namingConv = new NamingConvention({
> serverPropertyNameToClient: function(serverPropertyName) {
> return serverPropertyName.substr(0, 1).toLowerCase() + serverPropertyName.substr(1);
> },
> clientPropertyNameToServer: function(clientPropertyName) {
> return clientPropertyName.substr(0, 1).toUpperCase() + clientPropertyName.substr(1);
> }
> });
> var ms = new MetadataStore({ namingConvention: namingConv });
> var em = new EntityManager( { metadataStore: ms });
**/
constructor(ncConfig) {
assertConfig(ncConfig || {})
.whereParam("name").isOptional().isString()
.whereParam("serverPropertyNameToClient").isFunction()
.whereParam("clientPropertyNameToServer").isFunction()
.applyAll(this);
if (!this.name) {
this.name = core.getUuid();
}
config._storeObject(this, "NamingConvention", this.name);
}
/**
/**
A noop naming convention - This is the default unless another is specified.
**/
static none = new NamingConvention({
name: "noChange",
serverPropertyNameToClient: (serverPropertyName) => {
return serverPropertyName;
},
clientPropertyNameToServer: (clientPropertyName) => {
return clientPropertyName;
}
});
/**
The "camelCase" naming convention - This implementation only lowercases the first character of the server property name
but leaves the rest of the property name intact. If a more complicated version is needed then one should be created via the ctor.
**/
static camelCase = new NamingConvention({
name: "camelCase",
serverPropertyNameToClient: (serverPropertyName) => {
return serverPropertyName.substr(0, 1).toLowerCase() + serverPropertyName.substr(1);
},
clientPropertyNameToServer: (clientPropertyName) => {
return clientPropertyName.substr(0, 1).toUpperCase() + clientPropertyName.substr(1);
}
});
/**
The default value whenever NamingConventions are not specified.
**/
static defaultInstance = new NamingConvention(NamingConvention.none);
/**
Sets the 'defaultInstance' by creating a copy of the current 'defaultInstance' and then applying all of the properties of the current instance.
The current instance is returned unchanged.
> var namingConv = new NamingConvention({
> serverPropertyNameToClient: function(serverPropertyName) {
> return serverPropertyName.substr(0, 1).toLowerCase() + serverPropertyName.substr(1);
> },
> clientPropertyNameToServer: function(clientPropertyName) {
> return clientPropertyName.substr(0, 1).toUpperCase() + clientPropertyName.substr(1);
> }
> });
> namingConv.setAsDefault();
**/
setAsDefault() {
return core.setAsDefault(this, NamingConvention);
}
}
NamingConvention.prototype._$typeName = "NamingConvention";
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibmFtaW5nLWNvbnZlbnRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbmFtaW5nLWNvbnZlbnRpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBQzlDLE9BQU8sRUFBRSxJQUFJLEVBQUUsTUFBTSxRQUFRLENBQUM7QUFDOUIsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLFVBQVUsQ0FBQztBQWNsQzs7Ozs7O0dBTUc7QUFDSCxNQUFNLE9BQU8sZ0JBQWdCO0lBSzNCLGtIQUFrSDtJQUNsSCwwQkFBMEIsQ0FBd0M7SUFDbEUsaUhBQWlIO0lBQ2pILDBCQUEwQixDQUF3QztJQUVsRTs7Ozs7Ozs7Ozs7Ozs7T0FjRztJQUNILFlBQVksUUFBZ0M7UUFDMUMsWUFBWSxDQUFDLFFBQVEsSUFBSSxFQUFFLENBQUM7YUFDdkIsVUFBVSxDQUFDLE1BQU0sQ0FBQyxDQUFDLFVBQVUsRUFBRSxDQUFDLFFBQVEsRUFBRTthQUMxQyxVQUFVLENBQUMsNEJBQTRCLENBQUMsQ0FBQyxVQUFVLEVBQUU7YUFDckQsVUFBVSxDQUFDLDRCQUE0QixDQUFDLENBQUMsVUFBVSxFQUFFO2FBQ3JELFFBQVEsQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUNwQixJQUFJLENBQUMsSUFBSSxDQUFDLElBQUksRUFBRTtZQUNkLElBQUksQ0FBQyxJQUFJLEdBQUcsSUFBSSxDQUFDLE9BQU8sRUFBRSxDQUFDO1NBQzVCO1FBQ0QsTUFBTSxDQUFDLFlBQVksQ0FBQyxJQUFJLEVBQUUsa0JBQWtCLEVBQUUsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQzNELENBQUM7SUFFRDs7Ozs7T0FLRztJQUNILE1BQU0sQ0FBQyxJQUFJLEdBQUcsSUFBSSxnQkFBZ0IsQ0FBQztRQUNqQyxJQUFJLEVBQUUsVUFBVTtRQUNoQiwwQkFBMEIsRUFBRSxDQUFDLGtCQUFrQixFQUFFLEVBQUU7WUFDakQsT0FBTyxrQkFBa0IsQ0FBQztRQUM1QixDQUFDO1FBQ0QsMEJBQTBCLEVBQUUsQ0FBQyxrQkFBa0IsRUFBRSxFQUFFO1lBQ2pELE9BQU8sa0JBQWtCLENBQUM7UUFDNUIsQ0FBQztLQUNGLENBQUMsQ0FBQztJQUVIOzs7T0FHRztJQUNILE1BQU0sQ0FBQyxTQUFTLEdBQUcsSUFBSSxnQkFBZ0IsQ0FBQztRQUN0QyxJQUFJLEVBQUUsV0FBVztRQUNqQiwwQkFBMEIsRUFBRSxDQUFDLGtCQUFrQixFQUFFLEVBQUU7WUFDakQsT0FBTyxrQkFBa0IsQ0FBQyxNQUFNLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLFdBQVcsRUFBRSxHQUFHLGtCQUFrQixDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsQ0FBQztRQUN0RixDQUFDO1FBQ0QsMEJBQTBCLEVBQUUsQ0FBQyxrQkFBa0IsRUFBRSxFQUFFO1lBQ2pELE9BQU8sa0JBQWtCLENBQUMsTUFBTSxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxXQUFXLEVBQUUsR0FBRyxrQkFBa0IsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLENBQUM7UUFDdEYsQ0FBQztLQUNGLENBQUMsQ0FBQztJQUVIOztPQUVHO0lBQ0gsTUFBTSxDQUFDLGVBQWUsR0FBRyxJQUFJLGdCQUFnQixDQUFDLGdCQUFnQixDQUFDLElBQUksQ0FBQyxDQUFDO0lBRXJFOzs7Ozs7Ozs7Ozs7T0FZRztJQUNILFlBQVk7UUFDVixPQUFPLElBQUksQ0FBQyxZQUFZLENBQUMsSUFBSSxFQUFFLGdCQUFnQixDQUFDLENBQUM7SUFDbkQsQ0FBQzs7QUFJSCxnQkFBZ0IsQ0FBQyxTQUFTLENBQUMsVUFBVSxHQUFHLGtCQUFrQixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgYXNzZXJ0Q29uZmlnIH0gZnJvbSAnLi9hc3NlcnQtcGFyYW0nO1xyXG5pbXBvcnQgeyBjb3JlIH0gZnJvbSAnLi9jb3JlJztcclxuaW1wb3J0IHsgY29uZmlnIH0gZnJvbSAnLi9jb25maWcnO1xyXG5cclxuLy8gVE9ETzogc3Ryb25nbHkgdHlwZSBjb250ZXh0IG9iamVjdCBwYXNzZWQgdG8gbmFtaW5nIGNvbnZlbnRpb24gY29udmVydGVyIGZucy5cclxuXHJcbi8qKiBDb25maWd1cmF0aW9uIGluZm8gdG8gYmUgcGFzc2VkIHRvIHRoZSBbW05hbWluZ0NvbnZlbnRpb25dXSBjb25zdHJ1Y3RvciAqL1xyXG5leHBvcnQgaW50ZXJmYWNlIE5hbWluZ0NvbnZlbnRpb25Db25maWcge1xyXG4gIC8qKiBUaGUgbmFtZSBvZiB0aGlzIE5hbWluZ0NvbnZlbnRpb24gKi9cclxuICBuYW1lPzogc3RyaW5nO1xyXG4gIC8qKiBGdW5jdGlvbiB0aGF0IHRha2VzIGEgc2VydmVyIHByb3BlcnR5IG5hbWUgYWRkIGNvbnZlcnRzIGl0IGludG8gYSBjbGllbnQgc2lkZSBwcm9wZXJ0eSBuYW1lLiAgKi9cclxuICBzZXJ2ZXJQcm9wZXJ0eU5hbWVUb0NsaWVudD86IChubTogc3RyaW5nLCBjb250ZXh0PzogYW55KSA9PiBzdHJpbmc7XHJcbiAgLyoqIEZ1bmN0aW9uIHRoYXQgdGFrZXMgYSBjbGllbnQgcHJvcGVydHkgbmFtZSBhZGQgY29udmVydHMgaXQgaW50byBhIHNlcnZlciBzaWRlIHByb3BlcnR5IG5hbWUuICovXHJcbiAgY2xpZW50UHJvcGVydHlOYW1lVG9TZXJ2ZXI/OiAobm06IHN0cmluZywgY29udGV4dD86IGFueSkgPT4gc3RyaW5nO1xyXG59XHJcblxyXG4vKipcclxuQSBOYW1pbmdDb252ZW50aW9uIGluc3RhbmNlIGlzIHVzZWQgdG8gc3BlY2lmeSB0aGUgbmFtaW5nIGNvbnZlbnRpb25zIHVuZGVyIHdoaWNoIGEgTWV0YWRhdGFTdG9yZVxyXG53aWxsIHRyYW5zbGF0ZSBwcm9wZXJ0eSBuYW1lcyBiZXR3ZWVuIHRoZSBzZXJ2ZXIgYW5kIHRoZSBqYXZhc2NyaXB0IGNsaWVudC5cclxuXHJcblRoZSBkZWZhdWx0IE5hbWluZ0NvbnZlbnRpb24gZG9lcyBub3QgcGVyZm9ybSBhbnkgdHJhbnNsYXRpb24sIGl0IHNpbXBseSBwYXNzZXMgcHJvcGVydHkgbmFtZXMgdGhydSB1bmNoYW5nZWQuXHJcbkBkeW5hbWljXHJcbioqL1xyXG5leHBvcnQgY2xhc3MgTmFtaW5nQ29udmVudGlvbiB7XHJcbiAgLyoqIEBoaWRkZW4gQGludGVybmFsICovXHJcbiAgZGVjbGFyZSBfJHR5cGVOYW1lOiBzdHJpbmc7XHJcbiAgLyoqIFRoZSBuYW1lIG9mIHRoaXMgTmFtaW5nQ29udmVudGlvbi4gX19SZWFkIE9ubHlfXyAqL1xyXG4gIGRlY2xhcmUgbmFtZTogc3RyaW5nO1xyXG4gIC8qKiBGdW5jdGlvbiB0aGF0IHRha2VzIGEgc2VydmVyIHByb3BlcnR5IG5hbWUgYWRkIGNvbnZlcnRzIGl0IGludG8gYSBjbGllbnQgc2lkZSBwcm9wZXJ0eSBuYW1lLiAgX19SZWFkIE9ubHlfXyAqL1xyXG4gIHNlcnZlclByb3BlcnR5TmFtZVRvQ2xpZW50OiAobm06IHN0cmluZywgY29udGV4dD86IGFueSkgPT4gc3RyaW5nO1xyXG4gIC8qKiBGdW5jdGlvbiB0aGF0IHRha2VzIGEgY2xpZW50IHByb3BlcnR5IG5hbWUgYWRkIGNvbnZlcnRzIGl0IGludG8gYSBzZXJ2ZXIgc2lkZSBwcm9wZXJ0eSBuYW1lLiBfX1JlYWQgT25seV9fICovXHJcbiAgY2xpZW50UHJvcGVydHlOYW1lVG9TZXJ2ZXI6IChubTogc3RyaW5nLCBjb250ZXh0PzogYW55KSA9PiBzdHJpbmc7XHJcblxyXG4gIC8qKlxyXG4gIE5hbWluZ0NvbnZlbnRpb24gY29uc3RydWN0b3JcclxuICA+ICAgICAgLy8gQSBuYW1pbmcgY29udmVudGlvbiB0aGF0IGNvbnZlcnRzIHRoZSBmaXJzdCBjaGFyYWN0ZXIgb2YgZXZlcnkgcHJvcGVydHkgbmFtZSB0byB1cHBlcmNhc2Ugb24gdGhlIHNlcnZlclxyXG4gID4gICAgICAvLyBhbmQgbG93ZXJjYXNlIG9uIHRoZSBjbGllbnQuXHJcbiAgPiAgICAgIHZhciBuYW1pbmdDb252ID0gbmV3IE5hbWluZ0NvbnZlbnRpb24oe1xyXG4gID4gICAgICAgICAgc2VydmVyUHJvcGVydHlOYW1lVG9DbGllbnQ6IGZ1bmN0aW9uKHNlcnZlclByb3BlcnR5TmFtZSkge1xyXG4gID4gICAgICAgICAgICAgIHJldHVybiBzZXJ2ZXJQcm9wZXJ0eU5hbWUuc3Vic3RyKDAsIDEpLnRvTG93ZXJDYXNlKCkgKyBzZXJ2ZXJQcm9wZXJ0eU5hbWUuc3Vic3RyKDEpO1xyXG4gID4gICAgICAgICAgfSxcclxuICA+ICAgICAgICAgIGNsaWVudFByb3BlcnR5TmFtZVRvU2VydmVyOiBmdW5jdGlvbihjbGllbnRQcm9wZXJ0eU5hbWUpIHtcclxuICA+ICAgICAgICAgICAgICByZXR1cm4gY2xpZW50UHJvcGVydHlOYW1lLnN1YnN0cigwLCAxKS50b1VwcGVyQ2FzZSgpICsgY2xpZW50UHJvcGVydHlOYW1lLnN1YnN0cigxKTtcclxuICA+ICAgICAgICAgIH0gICAgICAgICAgICBcclxuICA+ICAgICAgfSk7XHJcbiAgPiAgICAgIHZhciBtcyA9IG5ldyBNZXRhZGF0YVN0b3JlKHsgbmFtaW5nQ29udmVudGlvbjogbmFtaW5nQ29udiB9KTtcclxuICA+ICAgICAgdmFyIGVtID0gbmV3IEVudGl0eU1hbmFnZXIoIHsgbWV0YWRhdGFTdG9yZTogbXMgfSk7XHJcbiAgKiovXHJcbiAgY29uc3RydWN0b3IobmNDb25maWc6IE5hbWluZ0NvbnZlbnRpb25Db25maWcgKSB7XHJcbiAgICBhc3NlcnRDb25maWcobmNDb25maWcgfHwge30pXHJcbiAgICAgICAgLndoZXJlUGFyYW0oXCJuYW1lXCIpLmlzT3B0aW9uYWwoKS5pc1N0cmluZygpXHJcbiAgICAgICAgLndoZXJlUGFyYW0oXCJzZXJ2ZXJQcm9wZXJ0eU5hbWVUb0NsaWVudFwiKS5pc0Z1bmN0aW9uKClcclxuICAgICAgICAud2hlcmVQYXJhbShcImNsaWVudFByb3BlcnR5TmFtZVRvU2VydmVyXCIpLmlzRnVuY3Rpb24oKVxyXG4gICAgICAgIC5hcHBseUFsbCh0aGlzKTtcclxuICAgIGlmICghdGhpcy5uYW1lKSB7XHJcbiAgICAgIHRoaXMubmFtZSA9IGNvcmUuZ2V0VXVpZCgpO1xyXG4gICAgfVxyXG4gICAgY29uZmlnLl9zdG9yZU9iamVjdCh0aGlzLCBcIk5hbWluZ0NvbnZlbnRpb25cIiwgdGhpcy5uYW1lKTtcclxuICB9XHJcblxyXG4gIC8qKlxyXG5cclxuXHJcbiAgLyoqXHJcbiAgQSBub29wIG5hbWluZyBjb252ZW50aW9uIC0gVGhpcyBpcyB0aGUgZGVmYXVsdCB1bmxlc3MgYW5vdGhlciBpcyBzcGVjaWZpZWQuXHJcbiAgKiovXHJcbiAgc3RhdGljIG5vbmUgPSBuZXcgTmFtaW5nQ29udmVudGlvbih7XHJcbiAgICBuYW1lOiBcIm5vQ2hhbmdlXCIsXHJcbiAgICBzZXJ2ZXJQcm9wZXJ0eU5hbWVUb0NsaWVudDogKHNlcnZlclByb3BlcnR5TmFtZSkgPT4ge1xyXG4gICAgICByZXR1cm4gc2VydmVyUHJvcGVydHlOYW1lO1xyXG4gICAgfSxcclxuICAgIGNsaWVudFByb3BlcnR5TmFtZVRvU2VydmVyOiAoY2xpZW50UHJvcGVydHlOYW1lKSA9PiB7XHJcbiAgICAgIHJldHVybiBjbGllbnRQcm9wZXJ0eU5hbWU7XHJcbiAgICB9XHJcbiAgfSk7XHJcblxyXG4gIC8qKlxyXG4gIFRoZSBcImNhbWVsQ2FzZVwiIG5hbWluZyBjb252ZW50aW9uIC0gVGhpcyBpbXBsZW1lbnRhdGlvbiBvbmx5IGxvd2VyY2FzZXMgdGhlIGZpcnN0IGNoYXJhY3RlciBvZiB0aGUgc2VydmVyIHByb3BlcnR5IG5hbWVcclxuICBidXQgbGVhdmVzIHRoZSByZXN0IG9mIHRoZSBwcm9wZXJ0eSBuYW1lIGludGFjdC4gIElmIGEgbW9yZSBjb21wbGljYXRlZCB2ZXJzaW9uIGlzIG5lZWRlZCB0aGVuIG9uZSBzaG91bGQgYmUgY3JlYXRlZCB2aWEgdGhlIGN0b3IuXHJcbiAgKiovXHJcbiAgc3RhdGljIGNhbWVsQ2FzZSA9IG5ldyBOYW1pbmdDb252ZW50aW9uKHtcclxuICAgIG5hbWU6IFwiY2FtZWxDYXNlXCIsXHJcbiAgICBzZXJ2ZXJQcm9wZXJ0eU5hbWVUb0NsaWVudDogKHNlcnZlclByb3BlcnR5TmFtZSkgPT4ge1xyXG4gICAgICByZXR1cm4gc2VydmVyUHJvcGVydHlOYW1lLnN1YnN0cigwLCAxKS50b0xvd2VyQ2FzZSgpICsgc2VydmVyUHJvcGVydHlOYW1lLnN1YnN0cigxKTtcclxuICAgIH0sXHJcbiAgICBjbGllbnRQcm9wZXJ0eU5hbWVUb1NlcnZlcjogKGNsaWVudFByb3BlcnR5TmFtZSkgPT4ge1xyXG4gICAgICByZXR1cm4gY2xpZW50UHJvcGVydHlOYW1lLnN1YnN0cigwLCAxKS50b1VwcGVyQ2FzZSgpICsgY2xpZW50UHJvcGVydHlOYW1lLnN1YnN0cigxKTtcclxuICAgIH1cclxuICB9KTtcclxuXHJcbiAgLyoqXHJcbiAgVGhlIGRlZmF1bHQgdmFsdWUgd2hlbmV2ZXIgTmFtaW5nQ29udmVudGlvbnMgYXJlIG5vdCBzcGVjaWZpZWQuXHJcbiAgKiovXHJcbiAgc3RhdGljIGRlZmF1bHRJbnN0YW5jZSA9IG5ldyBOYW1pbmdDb252ZW50aW9uKE5hbWluZ0NvbnZlbnRpb24ubm9uZSk7XHJcblxyXG4gIC8qKlxyXG4gIFNldHMgdGhlICdkZWZhdWx0SW5zdGFuY2UnIGJ5IGNyZWF0aW5nIGEgY29weSBvZiB0aGUgY3VycmVudCAnZGVmYXVsdEluc3RhbmNlJyBhbmQgdGhlbiBhcHBseWluZyBhbGwgb2YgdGhlIHByb3BlcnRpZXMgb2YgdGhlIGN1cnJlbnQgaW5zdGFuY2UuXHJcbiAgVGhlIGN1cnJlbnQgaW5zdGFuY2UgaXMgcmV0dXJuZWQgdW5jaGFuZ2VkLlxyXG4gID4gICAgICB2YXIgbmFtaW5nQ29udiA9IG5ldyBOYW1pbmdDb252ZW50aW9uKHtcclxuICA+ICAgICAgICAgIHNlcnZlclByb3BlcnR5TmFtZVRvQ2xpZW50OiBmdW5jdGlvbihzZXJ2ZXJQcm9wZXJ0eU5hbWUpIHtcclxuICA+ICAgICAgICAgICAgICByZXR1cm4gc2VydmVyUHJvcGVydHlOYW1lLnN1YnN0cigwLCAxKS50b0xvd2VyQ2FzZSgpICsgc2VydmVyUHJvcGVydHlOYW1lLnN1YnN0cigxKTtcclxuICA+ICAgICAgICAgIH0sXHJcbiAgPiAgICAgICAgICBjbGllbnRQcm9wZXJ0eU5hbWVUb1NlcnZlcjogZnVuY3Rpb24oY2xpZW50UHJvcGVydHlOYW1lKSB7XHJcbiAgPiAgICAgICAgICAgICAgcmV0dXJuIGNsaWVudFByb3BlcnR5TmFtZS5zdWJzdHIoMCwgMSkudG9VcHBlckNhc2UoKSArIGNsaWVudFByb3BlcnR5TmFtZS5zdWJzdHIoMSk7XHJcbiAgPiAgICAgICAgICB9ICAgICAgICAgICAgXHJcbiAgPiAgICAgIH0pO1xyXG4gID4gICAgICBuYW1pbmdDb252LnNldEFzRGVmYXVsdCgpO1xyXG4gICoqL1xyXG4gIHNldEFzRGVmYXVsdCgpIHtcclxuICAgIHJldHVybiBjb3JlLnNldEFzRGVmYXVsdCh0aGlzLCBOYW1pbmdDb252ZW50aW9uKTtcclxuICB9XHJcblxyXG59XHJcblxyXG5OYW1pbmdDb252ZW50aW9uLnByb3RvdHlwZS5fJHR5cGVOYW1lID0gXCJOYW1pbmdDb252ZW50aW9uXCI7XHJcblxyXG5cclxuXHJcblxyXG4iXX0=