/** * swagger-client - swagger.js is a javascript client for use with swaggering APIs. * @version v2.1.9-M1 * @link http://swagger.io * @license apache 2.0 */ (function(){ var ArrayModel = function(definition) { this.name = "arrayModel"; this.definition = definition || {}; this.properties = []; var requiredFields = definition.enum || []; var innerType = definition.items; if(innerType) { if(innerType.type) { this.type = typeFromJsonSchema(innerType.type, innerType.format); } else { this.ref = innerType.$ref; } } return this; }; ArrayModel.prototype.createJSONSample = function(modelsToIgnore) { var result; modelsToIgnore = (modelsToIgnore||{}); if(this.type) { result = this.type; } else if (this.ref) { var name = simpleRef(this.ref); if(typeof modelsToIgnore[name] === 'undefined') { modelsToIgnore[name] = this; result = models[name].createJSONSample(modelsToIgnore); } else { return name; } } return [ result ]; }; ArrayModel.prototype.getSampleValue = function(modelsToIgnore) { var result; modelsToIgnore = (modelsToIgnore || {}); if(this.type) { result = type; } else if (this.ref) { var name = simpleRef(this.ref); result = models[name].getSampleValue(modelsToIgnore); } return [ result ]; }; ArrayModel.prototype.getMockSignature = function(modelsToIgnore) { var propertiesStr = []; var i, prop; for (i = 0; i < this.properties.length; i++) { prop = this.properties[i]; propertiesStr.push(prop.toString()); } var strong = ''; var stronger = ''; var strongClose = ''; var classOpen = strong + 'array' + ' {' + strongClose; var classClose = strong + '}' + strongClose; var returnVal = classOpen + '
' + propertiesStr.join(',
') + '
' + classClose; if (!modelsToIgnore) modelsToIgnore = {}; modelsToIgnore[this.name] = this; for (i = 0; i < this.properties.length; i++) { prop = this.properties[i]; var ref = prop.$ref; var model = models[ref]; if (model && typeof modelsToIgnore[ref] === 'undefined') { returnVal = returnVal + ('
' + model.getMockSignature(modelsToIgnore)); } } return returnVal; }; /** * SwaggerAuthorizations applys the correct authorization to an operation being executed */ var SwaggerAuthorizations = function() { this.authz = {}; }; SwaggerAuthorizations.prototype.add = function(name, auth) { this.authz[name] = auth; return auth; }; SwaggerAuthorizations.prototype.remove = function(name) { return delete this.authz[name]; }; SwaggerAuthorizations.prototype.apply = function (obj, authorizations) { var status = null; var key, name, value, result; // if the "authorizations" key is undefined, or has an empty array, add all keys if (typeof authorizations === 'undefined' || Object.keys(authorizations).length === 0) { for (key in this.authz) { value = this.authz[key]; result = value.apply(obj, authorizations); if (result === true) status = true; } } else { // 2.0 support if (Array.isArray(authorizations)) { for (var i = 0; i < authorizations.length; i++) { var auth = authorizations[i]; for (name in auth) { for (key in this.authz) { if (key == name) { value = this.authz[key]; result = value.apply(obj, authorizations); if (result === true) status = true; } } } } } else { // 1.2 support for (name in authorizations) { for (key in this.authz) { if (key == name) { value = this.authz[key]; result = value.apply(obj, authorizations); if (result === true) status = true; } } } } } return status; }; /** * ApiKeyAuthorization allows a query param or header to be injected */ var ApiKeyAuthorization = function(name, value, type) { this.name = name; this.value = value; this.type = type; }; ApiKeyAuthorization.prototype.apply = function(obj, authorizations) { if (this.type === "query") { if (obj.url.indexOf('?') > 0) obj.url = obj.url + "&" + this.name + "=" + this.value; else obj.url = obj.url + "?" + this.name + "=" + this.value; return true; } else if (this.type === "header") { obj.headers[this.name] = this.value; return true; } }; var CookieAuthorization = function(cookie) { this.cookie = cookie; }; CookieAuthorization.prototype.apply = function(obj, authorizations) { obj.cookieJar = obj.cookieJar || CookieJar(); obj.cookieJar.setCookie(this.cookie); return true; }; /** * Password Authorization is a basic auth implementation */ var PasswordAuthorization = function(name, username, password) { this.name = name; this.username = username; this.password = password; this._btoa = null; if (typeof window !== 'undefined') this._btoa = btoa; else this._btoa = require("btoa"); }; PasswordAuthorization.prototype.apply = function(obj, authorizations) { var base64encoder = this._btoa; obj.headers.Authorization = "Basic " + base64encoder(this.username + ":" + this.password); return true; }; var __bind = function(fn, me){ return function(){ return fn.apply(me, arguments); }; }; fail = function(message) { log(message); }; log = function(){ log.history = log.history || []; log.history.push(arguments); if(this.console){ console.log( Array.prototype.slice.call(arguments)[0] ); } }; if (!Array.prototype.indexOf) { Array.prototype.indexOf = function(obj, start) { for (var i = (start || 0), j = this.length; i < j; i++) { if (this[i] === obj) { return i; } } return -1; }; } /** * allows override of the default value based on the parameter being * supplied **/ var applyParameterMacro = function (operation, parameter) { var e = (typeof window !== 'undefined' ? window : exports); if(e.parameterMacro) return e.parameterMacro(operation, parameter); else return parameter.defaultValue; }; /** * allows overriding the default value of an model property **/ var applyModelPropertyMacro = function (model, property) { var e = (typeof window !== 'undefined' ? window : exports); if(e.modelPropertyMacro) return e.modelPropertyMacro(model, property); else return property.defaultValue; }; /** * PrimitiveModel **/ var PrimitiveModel = function(definition) { this.name = "name"; this.definition = definition || {}; this.properties = []; var requiredFields = definition.enum || []; this.type = typeFromJsonSchema(definition.type, definition.format); }; PrimitiveModel.prototype.createJSONSample = function(modelsToIgnore) { var result = this.type; return result; }; PrimitiveModel.prototype.getSampleValue = function() { var result = this.type; return null; }; PrimitiveModel.prototype.getMockSignature = function(modelsToIgnore) { var propertiesStr = []; var i, prop; for (i = 0; i < this.properties.length; i++) { prop = this.properties[i]; propertiesStr.push(prop.toString()); } var strong = ''; var stronger = ''; var strongClose = ''; var classOpen = strong + this.name + ' {' + strongClose; var classClose = strong + '}' + strongClose; var returnVal = classOpen + '
' + propertiesStr.join(',
') + '
' + classClose; if (!modelsToIgnore) modelsToIgnore = {}; modelsToIgnore[this.name] = this; for (i = 0; i < this.properties.length; i++) { prop = this.properties[i]; var ref = prop.$ref; var model = models[ref]; if (model && typeof modelsToIgnore[ref] === 'undefined') { returnVal = returnVal + ('
' + model.getMockSignature(modelsToIgnore)); } } return returnVal; }; /** * Resolves a spec's remote references */ var Resolver = function (){}; Resolver.prototype.resolve = function(spec, callback, scope) { this.scope = (scope || this); var host, name, path, property, propertyName, type; var processedCalls = 0, resolvedRefs = {}, unresolvedRefs = {}; // store objects for dereferencing var resolutionTable = {}; // models for(name in spec.definitions) { var model = spec.definitions[name]; for(propertyName in model.properties) { property = model.properties[propertyName]; this.resolveTo(property, resolutionTable); } } // operations for(name in spec.paths) { var method, operation, responseCode; path = spec.paths[name]; for(method in path) { operation = path[method]; var i, parameters = operation.parameters; for(i in parameters) { var parameter = parameters[i]; if(parameter.in === 'body' && parameter.schema) { this.resolveTo(parameter.schema, resolutionTable); } if(parameter.$ref) { this.resolveInline(spec, parameter, resolutionTable, unresolvedRefs); } } for(responseCode in operation.responses) { var response = operation.responses[responseCode]; if(response.schema) { this.resolveTo(response.schema, resolutionTable); } } } } // get hosts var opts = {}, expectedCalls = 0; for(name in resolutionTable) { var parts = name.split('#'); if(parts.length == 2) { host = parts[0]; path = parts[1]; if(!Array.isArray(opts[host])) { opts[host] = []; expectedCalls += 1; } opts[host].push(path); } } for(name in opts) { var self = this, opt = opts[name]; host = name; var obj = { useJQuery: false, // TODO url: host, method: "get", headers: { accept: this.scope.swaggerRequestHeaders || 'application/json' }, on: { error: function(response) { processedCalls += 1; var i; for(i = 0; i < opt.length; i++) { // fail all of these var resolved = host + '#' + opt[i]; unresolvedRefs[resolved] = null; } if(processedCalls === expectedCalls) self.finish(spec, resolutionTable, resolvedRefs, unresolvedRefs, callback); }, response: function(response) { var i, j, swagger = response.obj; processedCalls += 1; for(i = 0; i < opt.length; i++) { var location = swagger, path = opt[i], parts = path.split('/'); for(j = 0; j < parts.length; j++) { var segment = parts[j]; if(typeof location === 'undefined') break; if(segment.length > 0) location = location[segment]; } var resolved = host + '#' + path, resolvedName = parts[j-1]; if(typeof location !== 'undefined') { resolvedRefs[resolved] = { name: resolvedName, obj: location }; } else unresolvedRefs[resolved] = null; } if(processedCalls === expectedCalls) self.finish(spec, resolutionTable, resolvedRefs, unresolvedRefs, callback); } } }; authorizations.apply(obj); new SwaggerHttp().execute(obj); } if(Object.keys(opts).length === 0) callback.call(this.scope, spec, unresolvedRefs); }; Resolver.prototype.finish = function(spec, resolutionTable, resolvedRefs, unresolvedRefs, callback) { // walk resolution table and replace with resolved refs var ref; for(ref in resolutionTable) { var i, locations = resolutionTable[ref]; for(i = 0; i < locations.length; i++) { var resolvedTo = resolvedRefs[locations[i].obj.$ref]; if(resolvedTo) { if(!spec.definitions) spec.definitions = {}; if(locations[i].resolveAs === '$ref') { spec.definitions[resolvedTo.name] = resolvedTo.obj; locations[i].obj.$ref = '#/definitions/' + resolvedTo.name; } else if (locations[i].resolveAs === 'inline') { var key; var targetObj = locations[i].obj; delete targetObj.$ref; for(key in resolvedTo.obj) { targetObj[key] = resolvedTo.obj[key]; } } } } } callback.call(this.scope, spec, unresolvedRefs); }; /** * immediately in-lines local refs, queues remote refs * for inline resolution */ Resolver.prototype.resolveInline = function (spec, property, objs, unresolvedRefs) { var ref = property.$ref; if(ref) { if(ref.indexOf('http') === 0) { if(Array.isArray(objs[ref])) { objs[ref].push({obj: property, resolveAs: 'inline'}); } else { objs[ref] = [{obj: property, resolveAs: 'inline'}]; } } else if (ref.indexOf('#') === 0) { // local resolve var shortenedRef = ref.substring(1); var i, parts = shortenedRef.split('/'), location = spec; for(i = 0; i < parts.length; i++) { var part = parts[i]; if(part.length > 0) { location = location[part]; } } if(location) { delete property.$ref; var key; for(key in location) { property[key] = location[key]; } } else unresolvedRefs[ref] = null; } } else if(property.type === 'array') { this.resolveTo(property.items, objs); } }; Resolver.prototype.resolveTo = function (property, objs) { var ref = property.$ref; if(ref) { if(ref.indexOf('http') === 0) { if(Array.isArray(objs[ref])) { objs[ref].push({obj: property, resolveAs: '$ref'}); } else { objs[ref] = [{obj: property, resolveAs: '$ref'}]; } } } else if(property.type === 'array') { var items = property.items; this.resolveTo(items, objs); } }; var addModel = function(name, model) { models[name] = model; }; var SwaggerClient = function(url, options) { this.isBuilt = false; this.url = null; this.debug = false; this.basePath = null; this.modelsArray = []; this.authorizations = null; this.authorizationScheme = null; this.isValid = false; this.info = null; this.useJQuery = false; this.resourceCount = 0; if(typeof url !== 'undefined') return this.initialize(url, options); }; SwaggerClient.prototype.initialize = function (url, options) { this.models = models = {}; options = (options||{}); if(typeof url === 'string') this.url = url; else if(typeof url === 'object') { options = url; this.url = options.url; } this.swaggerRequstHeaders = options.swaggerRequstHeaders || 'application/json;charset=utf-8,*/*'; this.defaultSuccessCallback = options.defaultSuccessCallback || null; this.defaultErrorCallback = options.defaultErrorCallback || null; if (typeof options.success === 'function') this.success = options.success; if (options.useJQuery) this.useJQuery = options.useJQuery; if (options.authorizations) { this.clientAuthorizations = options.authorizations; } else { this.clientAuthorizations = authorizations; } this.supportedSubmitMethods = options.supportedSubmitMethods || []; this.failure = options.failure || function() {}; this.progress = options.progress || function() {}; this.spec = options.spec; this.options = options; if (typeof options.success === 'function') { this.ready = true; this.build(); } }; SwaggerClient.prototype.build = function(mock) { if (this.isBuilt) return this; var self = this; this.progress('fetching resource list: ' + this.url); var obj = { useJQuery: this.useJQuery, url: this.url, method: "get", headers: { accept: this.swaggerRequstHeaders }, on: { error: function(response) { if (self.url.substring(0, 4) !== 'http') return self.fail('Please specify the protocol for ' + self.url); else if (response.status === 0) return self.fail('Can\'t read from server. It may not have the appropriate access-control-origin settings.'); else if (response.status === 404) return self.fail('Can\'t read swagger JSON from ' + self.url); else return self.fail(response.status + ' : ' + response.statusText + ' ' + self.url); }, response: function(resp) { var responseObj = resp.obj || JSON.parse(resp.data); self.swaggerVersion = responseObj.swaggerVersion; if(responseObj.swagger && parseInt(responseObj.swagger) === 2) { self.swaggerVersion = responseObj.swagger; new Resolver().resolve(responseObj, self.buildFromSpec, self); self.isValid = true; } else { if (self.swaggerVersion === '1.2') { return self.buildFrom1_2Spec(responseObj); } else { return self.buildFrom1_1Spec(responseObj); } } } } }; if(this.spec) { setTimeout(function() { new Resolver().resolve(self.spec, self.buildFromSpec, self); }, 10); } else { authorizations.apply(obj); if(mock) return obj; new SwaggerHttp().execute(obj); } return this; }; SwaggerClient.prototype.buildFromSpec = function(response) { if(this.isBuilt) return this; this.info = response.info || {}; this.title = response.title || ''; this.host = response.host || ''; this.schemes = response.schemes || []; this.basePath = response.basePath || ''; this.apis = {}; this.apisArray = []; this.consumes = response.consumes; this.produces = response.produces; this.securityDefinitions = response.securityDefinitions; // legacy support this.authSchemes = response.securityDefinitions; var definedTags = {}; if(Array.isArray(response.tags)) { definedTags = {}; for(k = 0; k < response.tags.length; k++) { var t = response.tags[k]; definedTags[t.name] = t; } } var location; if(typeof this.url === 'string') { location = this.parseUri(this.url); } if(typeof this.schemes === 'undefined' || this.schemes.length === 0) { this.scheme = location.scheme || 'http'; } else { this.scheme = this.schemes[0]; } if(typeof this.host === 'undefined' || this.host === '') { this.host = location.host; if (location.port) { this.host = this.host + ':' + location.port; } } this.definitions = response.definitions; var key; for(key in this.definitions) { var model = new Model(key, this.definitions[key]); if(model) { models[key] = model; } } // get paths, create functions for each operationId var path; var operations = []; for(path in response.paths) { if(typeof response.paths[path] === 'object') { var httpMethod; for(httpMethod in response.paths[path]) { if(['delete', 'get', 'head', 'options', 'patch', 'post', 'put'].indexOf(httpMethod) === -1) { continue; } var operation = response.paths[path][httpMethod]; var tags = operation.tags; if(typeof tags === 'undefined') { operation.tags = [ 'default' ]; tags = operation.tags; } var operationId = this.idFromOp(path, httpMethod, operation); var operationObject = new Operation ( this, operation.scheme, operationId, httpMethod, path, operation, this.definitions ); // bind this operation's execute command to the api if(tags.length > 0) { var i; for(i = 0; i < tags.length; i++) { var tag = this.tagFromLabel(tags[i]); var operationGroup = this[tag]; if(typeof this.apis[tag] === 'undefined') this.apis[tag] = {}; if(typeof operationGroup === 'undefined') { this[tag] = []; operationGroup = this[tag]; operationGroup.operations = {}; operationGroup.label = tag; operationGroup.apis = []; var tagObject = definedTags[tag]; if(typeof tagObject === 'object') { operationGroup.description = tagObject.description; operationGroup.externalDocs = tagObject.externalDocs; } this[tag].help = this.help.bind(operationGroup); this.apisArray.push(new OperationGroup(tag, operationGroup.description, operationGroup.externalDocs, operationObject)); } if(typeof this.apis[tag].help !== 'function') this.apis[tag].help = this.help.bind(operationGroup); // bind to the apis object this.apis[tag][operationId] = operationObject.execute.bind(operationObject); this.apis[tag][operationId].help = operationObject.help.bind(operationObject); this.apis[tag][operationId].asCurl = operationObject.asCurl.bind(operationObject); operationGroup[operationId] = operationObject.execute.bind(operationObject); operationGroup[operationId].help = operationObject.help.bind(operationObject); operationGroup[operationId].asCurl = operationObject.asCurl.bind(operationObject); operationGroup.apis.push(operationObject); operationGroup.operations[operationId] = operationObject; // legacy UI feature var j; var api; for(j = 0; j < this.apisArray.length; j++) { if(this.apisArray[j].tag === tag) { api = this.apisArray[j]; } } if(api) { api.operationsArray.push(operationObject); } } } else { log('no group to bind to'); } } } } this.isBuilt = true; if (this.success) { this.isValid = true; this.isBuilt = true; this.success(); } return this; }; SwaggerClient.prototype.parseUri = function(uri) { var urlParseRE = /^(((([^:\/#\?]+:)?(?:(\/\/)((?:(([^:@\/#\?]+)(?:\:([^:@\/#\?]+))?)@)?(([^:\/#\?\]\[]+|\[[^\/\]@#?]+\])(?:\:([0-9]+))?))?)?)?((\/?(?:[^\/\?#]+\/+)*)([^\?#]*)))?(\?[^#]+)?)(#.*)?/; var parts = urlParseRE.exec(uri); return { scheme: parts[4].replace(':',''), host: parts[11], port: parts[12], path: parts[15] }; }; SwaggerClient.prototype.help = function(dontPrint) { var i; var output = 'operations for the "' + this.label + '" tag'; for(i = 0; i < this.apis.length; i++) { var api = this.apis[i]; output += '\n * ' + api.nickname + ': ' + api.operation.summary; } if(dontPrint) return output; else { log(output); return output; } }; SwaggerClient.prototype.tagFromLabel = function(label) { return label; }; SwaggerClient.prototype.idFromOp = function(path, httpMethod, op) { var opId = op.operationId || (path.substring(1) + '_' + httpMethod); return opId.replace(/[\.,-\/#!$%\^&\*;:{}=\-_`~()\+\s]/g,'_'); }; SwaggerClient.prototype.fail = function(message) { this.failure(message); throw message; }; var OperationGroup = function(tag, description, externalDocs, operation) { this.tag = tag; this.path = tag; this.description = description; this.externalDocs = externalDocs; this.name = tag; this.operation = operation; this.operationsArray = []; }; var Operation = function(parent, scheme, operationId, httpMethod, path, args, definitions) { var errors = []; parent = parent||{}; args = args||{}; this.operations = {}; this.operation = args; this.deprecated = args.deprecated; this.consumes = args.consumes; this.produces = args.produces; this.parent = parent; this.host = parent.host || 'localhost'; this.schemes = parent.schemes; this.scheme = scheme || parent.scheme || 'http'; this.basePath = parent.basePath || '/'; this.nickname = (operationId||errors.push('Operations must have a nickname.')); this.method = (httpMethod||errors.push('Operation ' + operationId + ' is missing method.')); this.path = (path||errors.push('Operation ' + this.nickname + ' is missing path.')); this.parameters = args !== null ? (args.parameters||[]) : {}; this.summary = args.summary || ''; this.responses = (args.responses||{}); this.type = null; this.security = args.security; this.authorizations = args.security; this.description = args.description; this.useJQuery = parent.useJQuery; if(typeof this.deprecated === 'string') { switch(this.deprecated.toLowerCase()) { case 'true': case 'yes': case '1': { this.deprecated = true; break; } case 'false': case 'no': case '0': case null: { this.deprecated = false; break; } default: this.deprecated = Boolean(this.deprecated); } } var i, model; if(definitions) { // add to global models var key; for(key in this.definitions) { model = new Model(key, definitions[key]); if(model) { models[key] = model; } } } for(i = 0; i < this.parameters.length; i++) { var param = this.parameters[i]; if(param.type === 'array') { param.isList = true; param.allowMultiple = true; } var innerType = this.getType(param); if(innerType && innerType.toString().toLowerCase() === 'boolean') { param.allowableValues = {}; param.isList = true; param['enum'] = ["true", "false"]; } if(typeof param['enum'] !== 'undefined') { var id; param.allowableValues = {}; param.allowableValues.values = []; param.allowableValues.descriptiveValues = []; for(id = 0; id < param['enum'].length; id++) { var value = param['enum'][id]; var isDefault = (value === param.default) ? true : false; param.allowableValues.values.push(value); param.allowableValues.descriptiveValues.push({value : value, isDefault: isDefault}); } } if(param.type === 'array') { innerType = [innerType]; if(typeof param.allowableValues === 'undefined') { // can't show as a list if no values to select from delete param.isList; delete param.allowMultiple; } } param.signature = this.getModelSignature(innerType, models).toString(); param.sampleJSON = this.getModelSampleJSON(innerType, models); param.responseClassSignature = param.signature; } var defaultResponseCode, response, responses = this.responses; if(responses['200']) { response = responses['200']; defaultResponseCode = '200'; } else if(responses['201']) { response = responses['201']; defaultResponseCode = '201'; } else if(responses['202']) { response = responses['202']; defaultResponseCode = '202'; } else if(responses['203']) { response = responses['203']; defaultResponseCode = '203'; } else if(responses['204']) { response = responses['204']; defaultResponseCode = '204'; } else if(responses['205']) { response = responses['205']; defaultResponseCode = '205'; } else if(responses['206']) { response = responses['206']; defaultResponseCode = '206'; } else if(responses['default']) { response = responses['default']; defaultResponseCode = 'default'; } if(response && response.schema) { var resolvedModel = this.resolveModel(response.schema, definitions); delete responses[defaultResponseCode]; if(resolvedModel) { this.successResponse = {}; this.successResponse[defaultResponseCode] = resolvedModel; } else { this.successResponse = {}; this.successResponse[defaultResponseCode] = response.schema.type; } this.type = response; } if (errors.length > 0) { if(this.resource && this.resource.api && this.resource.api.fail) this.resource.api.fail(errors); } return this; }; OperationGroup.prototype.sort = function(sorter) { }; Operation.prototype.getType = function (param) { var type = param.type; var format = param.format; var isArray = false; var str; if(type === 'integer' && format === 'int32') str = 'integer'; else if(type === 'integer' && format === 'int64') str = 'long'; else if(type === 'integer') str = 'integer'; else if(type === 'string') { if(format === 'date-time') str = 'date-time'; else if(format === 'date') str = 'date'; else str = 'string'; } else if(type === 'number' && format === 'float') str = 'float'; else if(type === 'number' && format === 'double') str = 'double'; else if(type === 'number') str = 'double'; else if(type === 'boolean') str = 'boolean'; else if(type === 'array') { isArray = true; if(param.items) str = this.getType(param.items); } if(param.$ref) str = param.$ref; var schema = param.schema; if(schema) { var ref = schema.$ref; if(ref) { ref = simpleRef(ref); if(isArray) return [ ref ]; else return ref; } else return this.getType(schema); } if(isArray) return [ str ]; else return str; }; Operation.prototype.resolveModel = function (schema, definitions) { if(typeof schema.$ref !== 'undefined') { var ref = schema.$ref; if(ref.indexOf('#/definitions/') === 0) ref = ref.substring('#/definitions/'.length); if(definitions[ref]) { return new Model(ref, definitions[ref]); } } if(schema.type === 'array') return new ArrayModel(schema); else return null; }; Operation.prototype.help = function(dontPrint) { var out = this.nickname + ': ' + this.summary + '\n'; for(var i = 0; i < this.parameters.length; i++) { var param = this.parameters[i]; var typeInfo = param.signature; out += '\n * ' + param.name + ' (' + typeInfo + '): ' + param.description; } if(typeof dontPrint === 'undefined') log(out); return out; }; Operation.prototype.getModelSignature = function(type, definitions) { var isPrimitive, listType; if(type instanceof Array) { listType = true; type = type[0]; } else if(typeof type === 'undefined') type = 'undefined'; if(type === 'string') isPrimitive = true; else isPrimitive = (listType && definitions[listType]) || (definitions[type]) ? false : true; if (isPrimitive) { if(listType) return 'Array[' + type + ']'; else return type.toString(); } else { if (listType) return 'Array[' + definitions[type].getMockSignature() + ']'; else return definitions[type].getMockSignature(); } }; Operation.prototype.supportHeaderParams = function () { return true; }; Operation.prototype.supportedSubmitMethods = function () { return this.parent.supportedSubmitMethods; }; Operation.prototype.getHeaderParams = function (args) { var headers = this.setContentTypes(args, {}); for(var i = 0; i < this.parameters.length; i++) { var param = this.parameters[i]; if(typeof args[param.name] !== 'undefined') { if (param.in === 'header') { var value = args[param.name]; if(Array.isArray(value)) value = value.toString(); headers[param.name] = value; } } } return headers; }; Operation.prototype.urlify = function (args) { var formParams = {}; var requestUrl = this.path; // grab params from the args, build the querystring along the way var querystring = ''; for(var i = 0; i < this.parameters.length; i++) { var param = this.parameters[i]; if(typeof args[param.name] !== 'undefined') { if(param.in === 'path') { var reg = new RegExp('\{' + param.name + '\}', 'gi'); var value = args[param.name]; if(Array.isArray(value)) value = this.encodePathCollection(param.collectionFormat, param.name, value); else value = this.encodePathParam(value); requestUrl = requestUrl.replace(reg, value); } else if (param.in === 'query' && typeof args[param.name] !== 'undefined') { if(querystring === '') querystring += '?'; else querystring += '&'; if(typeof param.collectionFormat !== 'undefined') { var qp = args[param.name]; if(Array.isArray(qp)) querystring += this.encodeQueryCollection(param.collectionFormat, param.name, qp); else querystring += this.encodeQueryParam(param.name) + '=' + this.encodeQueryParam(args[param.name]); } else querystring += this.encodeQueryParam(param.name) + '=' + this.encodeQueryParam(args[param.name]); } else if (param.in === 'formData') formParams[param.name] = args[param.name]; } } var url = this.scheme + '://' + this.host; if(this.basePath !== '/') url += this.basePath; return url + requestUrl + querystring; }; Operation.prototype.getMissingParams = function(args) { var missingParams = []; // check required params, track the ones that are missing var i; for(i = 0; i < this.parameters.length; i++) { var param = this.parameters[i]; if(param.required === true) { if(typeof args[param.name] === 'undefined') missingParams = param.name; } } return missingParams; }; Operation.prototype.getBody = function(headers, args, opts) { var formParams = {}, body, key; for(var i = 0; i < this.parameters.length; i++) { var param = this.parameters[i]; if(typeof args[param.name] !== 'undefined') { if (param.in === 'body') { body = args[param.name]; } else if(param.in === 'formData') { formParams[param.name] = args[param.name]; } } } // handle form params if(headers['Content-Type'] === 'application/x-www-form-urlencoded') { var encoded = ""; for(key in formParams) { value = formParams[key]; if(typeof value !== 'undefined'){ if(encoded !== "") encoded += "&"; encoded += encodeURIComponent(key) + '=' + encodeURIComponent(value); } } body = encoded; } else if (headers['Content-Type'] && headers['Content-Type'].indexOf('multipart/form-data') >= 0) { if(opts.useJQuery) { var bodyParam = new FormData(); bodyParam.type = 'formData'; for (key in formParams) { value = args[key]; if (typeof value !== 'undefined') { // required for jquery file upload if(value.type === 'file' && value.value) { delete headers['Content-Type']; bodyParam.append(key, value.value); } else bodyParam.append(key, value); } } body = bodyParam; } } return body; }; /** * gets sample response for a single operation **/ Operation.prototype.getModelSampleJSON = function(type, models) { var isPrimitive, listType, sampleJson; listType = (type instanceof Array); isPrimitive = models[type] ? false : true; sampleJson = isPrimitive ? void 0 : models[type].createJSONSample(); if (sampleJson) { sampleJson = listType ? [sampleJson] : sampleJson; if(typeof sampleJson == 'string') return sampleJson; else if(typeof sampleJson === 'object') { var t = sampleJson; if(sampleJson instanceof Array && sampleJson.length > 0) { t = sampleJson[0]; } if(t.nodeName) { var xmlString = new XMLSerializer().serializeToString(t); return this.formatXml(xmlString); } else return JSON.stringify(sampleJson, null, 2); } else return sampleJson; } }; /** * legacy binding **/ Operation.prototype["do"] = function(args, opts, callback, error, parent) { return this.execute(args, opts, callback, error, parent); }; /** * executes an operation **/ Operation.prototype.execute = function(arg1, arg2, arg3, arg4, parent) { var args = arg1 || {}; var opts = {}, success, error; if(typeof arg2 === 'object') { opts = arg2; success = arg3; error = arg4; } if(typeof arg2 === 'function') { success = arg2; error = arg3; } success = (success||log); error = (error||log); if(opts.useJQuery) this.useJQuery = opts.useJQuery; var missingParams = this.getMissingParams(args); if(missingParams.length > 0) { var message = 'missing required params: ' + missingParams; fail(message); return; } var allHeaders = this.getHeaderParams(args); var contentTypeHeaders = this.setContentTypes(args, opts); var headers = {}, attrname; for (attrname in allHeaders) { headers[attrname] = allHeaders[attrname]; } for (attrname in contentTypeHeaders) { headers[attrname] = contentTypeHeaders[attrname]; } var body = this.getBody(headers, args, opts); var url = this.urlify(args); var obj = { url: url, method: this.method.toUpperCase(), body: body, useJQuery: this.useJQuery, headers: headers, on: { response: function(response) { return success(response, parent); }, error: function(response) { return error(response, parent); } } }; var status = authorizations.apply(obj, this.operation.security); if(opts.mock === true) return obj; else new SwaggerHttp().execute(obj, opts); }; Operation.prototype.setContentTypes = function(args, opts) { // default type var accepts = 'application/json'; var consumes = args.parameterContentType || 'application/json'; var allDefinedParams = this.parameters; var definedFormParams = []; var definedFileParams = []; var body; var headers = {}; // get params from the operation and set them in definedFileParams, definedFormParams, headers var i; for(i = 0; i < allDefinedParams.length; i++) { var param = allDefinedParams[i]; if(param.in === 'formData') { if(param.type === 'file') definedFileParams.push(param); else definedFormParams.push(param); } else if(param.in === 'header' && opts) { var key = param.name; var headerValue = opts[param.name]; if(typeof opts[param.name] !== 'undefined') headers[key] = headerValue; } else if(param.in === 'body' && typeof args[param.name] !== 'undefined') { body = args[param.name]; } } // if there's a body, need to set the consumes header via requestContentType if (body && (this.method === 'post' || this.method === 'put' || this.method === 'patch' || this.method === 'delete')) { if (opts.requestContentType) consumes = opts.requestContentType; } else { // if any form params, content type must be set if(definedFormParams.length > 0) { if(opts.requestContentType) // override if set consumes = opts.requestContentType; else if(definedFileParams.length > 0) // if a file, must be multipart/form-data consumes = 'multipart/form-data'; else // default to x-www-from-urlencoded consumes = 'application/x-www-form-urlencoded'; } else if (this.type == 'DELETE') body = '{}'; else if (this.type != 'DELETE') consumes = null; } if (consumes && this.consumes) { if (this.consumes.indexOf(consumes) === -1) { log('server doesn\'t consume ' + consumes + ', try ' + JSON.stringify(this.consumes)); } } if (opts.responseContentType) { accepts = opts.responseContentType; } else { accepts = 'application/json'; } if (accepts && this.produces) { if (this.produces.indexOf(accepts) === -1) { log('server can\'t produce ' + accepts); } } if ((consumes && body !== '') || (consumes === 'application/x-www-form-urlencoded')) headers['Content-Type'] = consumes; if (accepts) headers.Accept = accepts; return headers; }; Operation.prototype.asCurl = function (args) { var obj = this.execute(args, {mock: true}); authorizations.apply(obj); var results = []; results.push('-X ' + this.method.toUpperCase()); if (obj.headers) { var key; for (key in obj.headers) results.push('--header "' + key + ': ' + obj.headers[key] + '"'); } if(obj.body) { var body; if(typeof obj.body === 'object') body = JSON.stringify(obj.body); else body = obj.body; results.push('-d "' + body.replace(/"/g, '\\"') + '"'); } return 'curl ' + (results.join(' ')) + ' "' + obj.url + '"'; }; Operation.prototype.encodePathCollection = function(type, name, value) { var encoded = ''; var i; var separator = ''; if(type === 'ssv') separator = '%20'; else if(type === 'tsv') separator = '\\t'; else if(type === 'pipes') separator = '|'; else separator = ','; for(i = 0; i < value.length; i++) { if(i === 0) encoded = this.encodeQueryParam(value[i]); else encoded += separator + this.encodeQueryParam(value[i]); } return encoded; }; Operation.prototype.encodeQueryCollection = function(type, name, value) { var encoded = ''; var i; if(type === 'default' || type === 'multi') { for(i = 0; i < value.length; i++) { if(i > 0) encoded += '&'; encoded += this.encodeQueryParam(name) + '=' + this.encodeQueryParam(value[i]); } } else { var separator = ''; if(type === 'csv') separator = ','; else if(type === 'ssv') separator = '%20'; else if(type === 'tsv') separator = '\\t'; else if(type === 'pipes') separator = '|'; else if(type === 'brackets') { for(i = 0; i < value.length; i++) { if(i !== 0) encoded += '&'; encoded += this.encodeQueryParam(name) + '[]=' + this.encodeQueryParam(value[i]); } } if(separator !== '') { for(i = 0; i < value.length; i++) { if(i === 0) encoded = this.encodeQueryParam(name) + '=' + this.encodeQueryParam(value[i]); else encoded += separator + this.encodeQueryParam(value[i]); } } } return encoded; }; Operation.prototype.encodeQueryParam = function(arg) { return encodeURIComponent(arg); }; /** * TODO revisit, might not want to leave '/' **/ Operation.prototype.encodePathParam = function(pathParam) { var encParts, part, parts, i, len; pathParam = pathParam.toString(); if (pathParam.indexOf('/') === -1) { return encodeURIComponent(pathParam); } else { parts = pathParam.split('/'); encParts = []; for (i = 0, len = parts.length; i < len; i++) { encParts.push(encodeURIComponent(parts[i])); } return encParts.join('/'); } }; var Model = function(name, definition) { this.name = name; this.definition = definition || {}; this.properties = []; var requiredFields = definition.required || []; if(definition.type === 'array') { var out = new ArrayModel(definition); return out; } var key; var props = definition.properties; if(props) { for(key in props) { var required = false; var property = props[key]; if(requiredFields.indexOf(key) >= 0) required = true; this.properties.push(new Property(key, property, required)); } } }; Model.prototype.createJSONSample = function(modelsToIgnore) { var i, result = {}, representations = {}; modelsToIgnore = (modelsToIgnore||{}); modelsToIgnore[this.name] = this; for (i = 0; i < this.properties.length; i++) { prop = this.properties[i]; var sample = prop.getSampleValue(modelsToIgnore, representations); result[prop.name] = sample; } delete modelsToIgnore[this.name]; return result; }; Model.prototype.getSampleValue = function(modelsToIgnore) { var i, obj = {}, representations = {}; for(i = 0; i < this.properties.length; i++ ) { var property = this.properties[i]; obj[property.name] = property.sampleValue(false, modelsToIgnore, representations); } return obj; }; Model.prototype.getMockSignature = function(modelsToIgnore) { var i, prop, propertiesStr = []; for (i = 0; i < this.properties.length; i++) { prop = this.properties[i]; propertiesStr.push(prop.toString()); } var strong = ''; var stronger = ''; var strongClose = ''; var classOpen = strong + this.name + ' {' + strongClose; var classClose = strong + '}' + strongClose; var returnVal = classOpen + '
' + propertiesStr.join(',
') + '
' + classClose; if (!modelsToIgnore) modelsToIgnore = {}; modelsToIgnore[this.name] = this; for (i = 0; i < this.properties.length; i++) { prop = this.properties[i]; var ref = prop.$ref; var model = models[ref]; if (model && typeof modelsToIgnore[model.name] === 'undefined') { returnVal = returnVal + ('
' + model.getMockSignature(modelsToIgnore)); } } return returnVal; }; var Property = function(name, obj, required) { this.schema = obj; this.required = required; if(obj.$ref) this.$ref = simpleRef(obj.$ref); else if (obj.type === 'array' && obj.items) { if(obj.items.$ref) this.$ref = simpleRef(obj.items.$ref); else obj = obj.items; } this.name = name; this.description = obj.description; this.obj = obj; this.optional = true; this.optional = !required; this.default = obj.default || null; this.example = obj.example !== undefined ? obj.example : null; this.collectionFormat = obj.collectionFormat || null; this.maximum = obj.maximum || null; this.exclusiveMaximum = obj.exclusiveMaximum || null; this.minimum = obj.minimum || null; this.exclusiveMinimum = obj.exclusiveMinimum || null; this.maxLength = obj.maxLength || null; this.minLength = obj.minLength || null; this.pattern = obj.pattern || null; this.maxItems = obj.maxItems || null; this.minItems = obj.minItems || null; this.uniqueItems = obj.uniqueItems || null; this['enum'] = obj['enum'] || null; this.multipleOf = obj.multipleOf || null; }; Property.prototype.getSampleValue = function (modelsToIgnore, representations) { return this.sampleValue(false, modelsToIgnore, representations); }; Property.prototype.isArray = function () { var schema = this.schema; if(schema.type === 'array') return true; else return false; }; Property.prototype.sampleValue = function(isArray, ignoredModels, representations) { isArray = (isArray || this.isArray()); ignoredModels = (ignoredModels || {}); // representations = (representations || {}); var type = getStringSignature(this.obj, true); var output; if(this.$ref) { var refModelName = simpleRef(this.$ref); var refModel = models[refModelName]; if(typeof representations[type] !== 'undefined') { return representations[type]; } else if(refModel && typeof ignoredModels[type] === 'undefined') { ignoredModels[type] = this; output = refModel.getSampleValue(ignoredModels, representations); representations[type] = output; } else { output = (representations[type] || refModelName); } } else if(this.example) output = this.example; else if(this.default) output = this.default; else if(type === 'date-time') output = new Date().toISOString(); else if(type === 'date') output = new Date().toISOString().split("T")[0]; else if(type === 'string') output = 'string'; else if(type === 'integer') output = 0; else if(type === 'long') output = 0; else if(type === 'float') output = 0.0; else if(type === 'double') output = 0.0; else if(type === 'boolean') output = true; else output = {}; ignoredModels[type] = output; if(isArray) return [output]; else return output; }; getStringSignature = function(obj, baseComponent) { var str = ''; if(typeof obj.$ref !== 'undefined') str += simpleRef(obj.$ref); else if(typeof obj.type === 'undefined') str += 'object'; else if(obj.type === 'array') { if(baseComponent) str += getStringSignature((obj.items || obj.$ref || {})); else { str += 'Array['; str += getStringSignature((obj.items || obj.$ref || {})); str += ']'; } } else if(obj.type === 'integer' && obj.format === 'int32') str += 'integer'; else if(obj.type === 'integer' && obj.format === 'int64') str += 'long'; else if(obj.type === 'integer' && typeof obj.format === 'undefined') str += 'long'; else if(obj.type === 'string' && obj.format === 'date-time') str += 'date-time'; else if(obj.type === 'string' && obj.format === 'date') str += 'date'; else if(obj.type === 'string' && typeof obj.format === 'undefined') str += 'string'; else if(obj.type === 'number' && obj.format === 'float') str += 'float'; else if(obj.type === 'number' && obj.format === 'double') str += 'double'; else if(obj.type === 'number' && typeof obj.format === 'undefined') str += 'double'; else if(obj.type === 'boolean') str += 'boolean'; else if(obj.$ref) str += simpleRef(obj.$ref); else str += obj.type; return str; }; simpleRef = function(name) { if(typeof name === 'undefined') return null; if(name.indexOf("#/definitions/") === 0) return name.substring('#/definitions/'.length); else return name; }; Property.prototype.toString = function() { var str = getStringSignature(this.obj); if(str !== '') { str = '' + this.name + ' (' + str + ''; if(!this.required) str += ', optional'; str += ')'; } else str = this.name + ' (' + JSON.stringify(this.obj) + ')'; if(typeof this.description !== 'undefined') str += ': ' + this.description; if (this['enum']) { str += ' = [\'' + this['enum'].join('\' or \'') + '\']'; } if (this.descr) { str += ': ' + this.descr + ''; } var options = ''; var isArray = this.schema.type === 'array'; var type; if(isArray) { if(this.schema.items) type = this.schema.items.type; else type = ''; } else { type = this.schema.type; } if (this.default) options += optionHtml('Default', this.default); switch (type) { case 'string': if (this.minLength) options += optionHtml('Min. Length', this.minLength); if (this.maxLength) options += optionHtml('Max. Length', this.maxLength); if (this.pattern) options += optionHtml('Reg. Exp.', this.pattern); break; case 'integer': case 'number': if (this.minimum) options += optionHtml('Min. Value', this.minimum); if (this.exclusiveMinimum) options += optionHtml('Exclusive Min.', "true"); if (this.maximum) options += optionHtml('Max. Value', this.maximum); if (this.exclusiveMaximum) options += optionHtml('Exclusive Max.', "true"); if (this.multipleOf) options += optionHtml('Multiple Of', this.multipleOf); break; } if (isArray) { if (this.minItems) options += optionHtml('Min. Items', this.minItems); if (this.maxItems) options += optionHtml('Max. Items', this.maxItems); if (this.uniqueItems) options += optionHtml('Unique Items', "true"); if (this.collectionFormat) options += optionHtml('Coll. Format', this.collectionFormat); } if (this['enum']) { var enumString; if (type === 'number' || type === 'integer') enumString = this['enum'].join(', '); else { enumString = '"' + this['enum'].join('", "') + '"'; } options += optionHtml('Enum', enumString); } if (options.length > 0) str = '' + str + '' + options + '
' + this.name + '
'; return str; }; optionHtml = function(label, value) { return '' + label + ':' + value + ''; }; typeFromJsonSchema = function(type, format) { var str; if(type === 'integer' && format === 'int32') str = 'integer'; else if(type === 'integer' && format === 'int64') str = 'long'; else if(type === 'integer' && typeof format === 'undefined') str = 'long'; else if(type === 'string' && format === 'date-time') str = 'date-time'; else if(type === 'string' && format === 'date') str = 'date'; else if(type === 'number' && format === 'float') str = 'float'; else if(type === 'number' && format === 'double') str = 'double'; else if(type === 'number' && typeof format === 'undefined') str = 'double'; else if(type === 'boolean') str = 'boolean'; else if(type === 'string') str = 'string'; return str; }; var sampleModels = {}; var cookies = {}; var models = {}; SwaggerClient.prototype.buildFrom1_2Spec = function (response) { if (response.apiVersion !== null) { this.apiVersion = response.apiVersion; } this.apis = {}; this.apisArray = []; this.consumes = response.consumes; this.produces = response.produces; this.authSchemes = response.authorizations; this.info = this.convertInfo(response.info); var isApi = false, i, res; for (i = 0; i < response.apis.length; i++) { var api = response.apis[i]; if (api.operations) { var j; for (j = 0; j < api.operations.length; j++) { operation = api.operations[j]; isApi = true; } } } if (response.basePath) this.basePath = response.basePath; else if (this.url.indexOf('?') > 0) this.basePath = this.url.substring(0, this.url.lastIndexOf('?')); else this.basePath = this.url; if (isApi) { var newName = response.resourcePath.replace(/\//g, ''); this.resourcePath = response.resourcePath; res = new SwaggerResource(response, this); this.apis[newName] = res; this.apisArray.push(res); this.finish(); } else { var k; this.expectedResourceCount = response.apis.length; for (k = 0; k < response.apis.length; k++) { var resource = response.apis[k]; res = new SwaggerResource(resource, this); this.apis[res.name] = res; this.apisArray.push(res); } } this.isValid = true; return this; }; SwaggerClient.prototype.finish = function() { if (typeof this.success === 'function') { this.isValid = true; this.ready = true; this.isBuilt = true; this.selfReflect(); this.success(); } }; SwaggerClient.prototype.buildFrom1_1Spec = function (response) { log('This API is using a deprecated version of Swagger! Please see http://github.com/wordnik/swagger-core/wiki for more info'); if (response.apiVersion !== null) this.apiVersion = response.apiVersion; this.apis = {}; this.apisArray = []; this.produces = response.produces; this.info = this.convertInfo(response.info); var isApi = false, res; for (var i = 0; i < response.apis.length; i++) { var api = response.apis[i]; if (api.operations) { for (var j = 0; j < api.operations.length; j++) { operation = api.operations[j]; isApi = true; } } } if (response.basePath) { this.basePath = response.basePath; } else if (this.url.indexOf('?') > 0) { this.basePath = this.url.substring(0, this.url.lastIndexOf('?')); } else { this.basePath = this.url; } if (isApi) { var newName = response.resourcePath.replace(/\//g, ''); this.resourcePath = response.resourcePath; res = new SwaggerResource(response, this); this.apis[newName] = res; this.apisArray.push(res); this.finish(); } else { this.expectedResourceCount = response.apis.length; for (k = 0; k < response.apis.length; k++) { resource = response.apis[k]; res = new SwaggerResource(resource, this); this.apis[res.name] = res; this.apisArray.push(res); } } this.isValid = true; return this; }; SwaggerClient.prototype.convertInfo = function (resp) { if(typeof resp == 'object') { var info = {}; info.title = resp.title; info.description = resp.description; info.termsOfService = resp.termsOfServiceUrl; info.contact = {}; info.contact.name = resp.contact; info.license = {}; info.license.name = resp.license; info.license.url = resp.licenseUrl; return info; } }; SwaggerClient.prototype.selfReflect = function () { var resource, tag, ref; if (this.apis === null) { return false; } ref = this.apis; for (tag in ref) { api = ref[tag]; if (api.ready === null) { return false; } this[tag] = api; this[tag].help = __bind(api.help, api); } this.setConsolidatedModels(); this.ready = true; }; SwaggerClient.prototype.setConsolidatedModels = function () { var model, modelName, resource, resource_name, i, apis, models, results; this.models = {}; apis = this.apis; for (resource_name in apis) { resource = apis[resource_name]; for (modelName in resource.models) { if (typeof this.models[modelName] === 'undefined') { this.models[modelName] = resource.models[modelName]; this.modelsArray.push(resource.models[modelName]); } } } models = this.modelsArray; results = []; for (i = 0; i < models.length; i++) { model = models[i]; results.push(model.setReferencedModels(this.models)); } return results; }; var SwaggerResource = function (resourceObj, api) { var _this = this; this.api = api; this.swaggerRequstHeaders = api.swaggerRequstHeaders; this.path = (typeof this.api.resourcePath === 'string') ? this.api.resourcePath : resourceObj.path; this.description = resourceObj.description; this.authorizations = (resourceObj.authorizations || {}); var parts = this.path.split('/'); this.name = parts[parts.length - 1].replace('.{format}', ''); this.basePath = this.api.basePath; this.operations = {}; this.operationsArray = []; this.modelsArray = []; this.models = api.models || {}; this.rawModels = {}; this.useJQuery = (typeof api.useJQuery !== 'undefined') ? api.useJQuery : null; if ((resourceObj.apis) && this.api.resourcePath) { this.addApiDeclaration(resourceObj); } else { if (typeof this.path === 'undefined') { this.api.fail('SwaggerResources must have a path.'); } if (this.path.substring(0, 4) === 'http') { this.url = this.path.replace('{format}', 'json'); } else { this.url = this.api.basePath + this.path.replace('{format}', 'json'); } this.api.progress('fetching resource ' + this.name + ': ' + this.url); var obj = { url: this.url, method: 'GET', useJQuery: this.useJQuery, headers: { accept: this.swaggerRequstHeaders }, on: { response: function (resp) { var responseObj = resp.obj || JSON.parse(resp.data); _this.api.resourceCount += 1; return _this.addApiDeclaration(responseObj); }, error: function (response) { _this.api.resourceCount += 1; return _this.api.fail('Unable to read api \'' + _this.name + '\' from path ' + _this.url + ' (server returned ' + response.statusText + ')'); } } }; var e = typeof window !== 'undefined' ? window : exports; e.authorizations.apply(obj); new SwaggerHttp().execute(obj); } }; SwaggerResource.prototype.help = function (dontPrint) { var i; var output = 'operations for the "' + this.name + '" tag'; for(i = 0; i < this.operationsArray.length; i++) { var api = this.operationsArray[i]; output += '\n * ' + api.nickname + ': ' + api.description; } if(dontPrint) return output; else { log(output); return output; } }; SwaggerResource.prototype.getAbsoluteBasePath = function (relativeBasePath) { var pos, url; url = this.api.basePath; pos = url.lastIndexOf(relativeBasePath); var parts = url.split('/'); var rootUrl = parts[0] + '//' + parts[2]; if (relativeBasePath.indexOf('http') === 0) return relativeBasePath; if (relativeBasePath === '/') return rootUrl; if (relativeBasePath.substring(0, 1) == '/') { // use root + relative return rootUrl + relativeBasePath; } else { pos = this.basePath.lastIndexOf('/'); var base = this.basePath.substring(0, pos); if (base.substring(base.length - 1) == '/') return base + relativeBasePath; else return base + '/' + relativeBasePath; } }; SwaggerResource.prototype.addApiDeclaration = function (response) { if (typeof response.produces === 'string') this.produces = response.produces; if (typeof response.consumes === 'string') this.consumes = response.consumes; if ((typeof response.basePath === 'string') && response.basePath.replace(/\s/g, '').length > 0) this.basePath = response.basePath.indexOf('http') === -1 ? this.getAbsoluteBasePath(response.basePath) : response.basePath; this.resourcePath = response.resourcePath; this.addModels(response.models); if (response.apis) { for (var i = 0 ; i < response.apis.length; i++) { var endpoint = response.apis[i]; this.addOperations(endpoint.path, endpoint.operations, response.consumes, response.produces); } } this.api[this.name] = this; this.ready = true; if(this.api.resourceCount === this.api.expectedResourceCount) this.api.finish(); return this; }; SwaggerResource.prototype.addModels = function (models) { if (typeof models === 'object') { var modelName; for (modelName in models) { if (typeof this.models[modelName] === 'undefined') { var swaggerModel = new SwaggerModel(modelName, models[modelName]); this.modelsArray.push(swaggerModel); this.models[modelName] = swaggerModel; this.rawModels[modelName] = models[modelName]; } } var output = []; for (var i = 0; i < this.modelsArray.length; i++) { var model = this.modelsArray[i]; output.push(model.setReferencedModels(this.models)); } return output; } }; SwaggerResource.prototype.addOperations = function (resource_path, ops, consumes, produces) { if (ops) { var output = []; for (var i = 0; i < ops.length; i++) { var o = ops[i]; consumes = this.consumes; produces = this.produces; if (typeof o.consumes !== 'undefined') consumes = o.consumes; else consumes = this.consumes; if (typeof o.produces !== 'undefined') produces = o.produces; else produces = this.produces; var type = (o.type || o.responseClass); if (type === 'array') { ref = null; if (o.items) ref = o.items.type || o.items.$ref; type = 'array[' + ref + ']'; } var responseMessages = o.responseMessages; var method = o.method; if (o.httpMethod) { method = o.httpMethod; } if (o.supportedContentTypes) { consumes = o.supportedContentTypes; } if (o.errorResponses) { responseMessages = o.errorResponses; for (var j = 0; j < responseMessages.length; j++) { r = responseMessages[j]; r.message = r.reason; r.reason = null; } } o.nickname = this.sanitize(o.nickname); var op = new SwaggerOperation(o.nickname, resource_path, method, o.parameters, o.summary, o.notes, type, responseMessages, this, consumes, produces, o.authorizations, o.deprecated); this.operations[op.nickname] = op; output.push(this.operationsArray.push(op)); } return output; } }; SwaggerResource.prototype.sanitize = function (nickname) { var op; op = nickname.replace(/[\s!@#$%^&*()_+=\[{\]};:<>|.\/?,\\'""-]/g, '_'); op = op.replace(/((_){2,})/g, '_'); op = op.replace(/^(_)*/g, ''); op = op.replace(/([_])*$/g, ''); return op; }; var SwaggerModel = function (modelName, obj) { this.name = typeof obj.id !== 'undefined' ? obj.id : modelName; this.properties = []; var propertyName; for (propertyName in obj.properties) { if (obj.required) { var value; for (value in obj.required) { if (propertyName === obj.required[value]) { obj.properties[propertyName].required = true; } } } var prop = new SwaggerModelProperty(propertyName, obj.properties[propertyName], this); this.properties.push(prop); } }; SwaggerModel.prototype.setReferencedModels = function (allModels) { var results = []; for (var i = 0; i < this.properties.length; i++) { var property = this.properties[i]; var type = property.type || property.dataType; if (allModels[type]) results.push(property.refModel = allModels[type]); else if ((property.refDataType) && (allModels[property.refDataType])) results.push(property.refModel = allModels[property.refDataType]); else results.push(void 0); } return results; }; SwaggerModel.prototype.getMockSignature = function (modelsToIgnore) { var i, prop, propertiesStr = []; for (i = 0; i < this.properties.length; i++) { prop = this.properties[i]; propertiesStr.push(prop.toString()); } var strong = ''; var strongClose = ''; var classOpen = strong + this.name + ' {' + strongClose; var classClose = strong + '}' + strongClose; var returnVal = classOpen + '
' + propertiesStr.join(',
') + '
' + classClose; if (!modelsToIgnore) modelsToIgnore = []; modelsToIgnore.push(this.name); for (i = 0; i < this.properties.length; i++) { prop = this.properties[i]; if ((prop.refModel) && modelsToIgnore.indexOf(prop.refModel.name) === -1) { returnVal = returnVal + ('
' + prop.refModel.getMockSignature(modelsToIgnore)); } } return returnVal; }; SwaggerModel.prototype.createJSONSample = function (modelsToIgnore) { if (sampleModels[this.name]) { return sampleModels[this.name]; } else { var result = {}; modelsToIgnore = (modelsToIgnore || []); modelsToIgnore.push(this.name); for (var i = 0; i < this.properties.length; i++) { var prop = this.properties[i]; result[prop.name] = prop.getSampleValue(modelsToIgnore); } modelsToIgnore.pop(this.name); return result; } }; var SwaggerModelProperty = function (name, obj, model) { this.name = name; this.dataType = obj.type || obj.dataType || obj.$ref; this.isCollection = this.dataType && (this.dataType.toLowerCase() === 'array' || this.dataType.toLowerCase() === 'list' || this.dataType.toLowerCase() === 'set'); this.descr = obj.description; this.required = obj.required; this.defaultValue = applyModelPropertyMacro(obj, model); this.example = obj.example !== undefined ? obj.example : null; if (obj.items) { if (obj.items.type) { this.refDataType = obj.items.type; } if (obj.items.$ref) { this.refDataType = obj.items.$ref; } } this.dataTypeWithRef = this.refDataType ? (this.dataType + '[' + this.refDataType + ']') : this.dataType; if (obj.allowableValues) { this.valueType = obj.allowableValues.valueType; this.values = obj.allowableValues.values; if (this.values) { this.valuesString = '\'' + this.values.join('\' or \'') + '\''; } } if (obj['enum']) { this.valueType = 'string'; this.values = obj['enum']; if (this.values) { this.valueString = '\'' + this.values.join('\' or \'') + '\''; } } }; SwaggerModelProperty.prototype.getSampleValue = function (modelsToIgnore) { var result; if ((this.refModel) && (modelsToIgnore.indexOf(this.refModel.name) === -1)) { result = this.refModel.createJSONSample(modelsToIgnore); } else { if (this.isCollection) { result = this.toSampleValue(this.refDataType); } else { result = this.toSampleValue(this.dataType); } } if (this.isCollection) { return [result]; } else { return result; } }; SwaggerModelProperty.prototype.toSampleValue = function (value) { var result; if ((typeof this.defaultValue !== 'undefined') && this.defaultValue) { result = this.defaultValue; } else if (this.example) { result = this.example; } else if (value === 'integer') { result = 0; } else if (value === 'boolean') { result = false; } else if (value === 'double' || value === 'number') { result = 0.0; } else if (value === 'string') { result = ''; } else { result = value; } return result; }; SwaggerModelProperty.prototype.toString = function () { var req = this.required ? 'propReq' : 'propOpt'; var str = '' + this.name + ' (' + this.dataTypeWithRef + ''; if (!this.required) { str += ', optional'; } str += ')'; if (this.values) { str += ' = [\'' + this.values.join('\' or \'') + '\']'; } if (this.descr) { str += ': ' + this.descr + ''; } return str; }; var SwaggerOperation = function (nickname, path, method, parameters, summary, notes, type, responseMessages, resource, consumes, produces, authorizations, deprecated) { var _this = this; var errors = []; this.nickname = (nickname || errors.push('SwaggerOperations must have a nickname.')); this.path = (path || errors.push('SwaggerOperation ' + nickname + ' is missing path.')); this.method = (method || errors.push('SwaggerOperation ' + nickname + ' is missing method.')); this.parameters = parameters ? parameters : []; this.summary = summary; this.notes = notes; this.type = type; this.responseMessages = (responseMessages || []); this.resource = (resource || errors.push('Resource is required')); this.consumes = consumes; this.produces = produces; this.authorizations = typeof authorizations !== 'undefined' ? authorizations : resource.authorizations; this.deprecated = deprecated; this['do'] = __bind(this['do'], this); if(typeof this.deprecated === 'string') { switch(this.deprecated.toLowerCase()) { case 'true': case 'yes': case '1': { this.deprecated = true; break; } case 'false': case 'no': case '0': case null: { this.deprecated = false; break; } default: this.deprecated = Boolean(this.deprecated); } } if (errors.length > 0) { console.error('SwaggerOperation errors', errors, arguments); this.resource.api.fail(errors); } this.path = this.path.replace('{format}', 'json'); this.method = this.method.toLowerCase(); this.isGetMethod = this.method === 'get'; var i, j, v; this.resourceName = this.resource.name; if (typeof this.type !== 'undefined' && this.type === 'void') this.type = null; else { this.responseClassSignature = this.getSignature(this.type, this.resource.models); this.responseSampleJSON = this.getSampleJSON(this.type, this.resource.models); } for (i = 0; i < this.parameters.length; i++) { var param = this.parameters[i]; // might take this away param.name = param.name || param.type || param.dataType; // for 1.1 compatibility type = param.type || param.dataType; if (type === 'array') { type = 'array[' + (param.items.$ref ? param.items.$ref : param.items.type) + ']'; } param.type = type; if (type && type.toLowerCase() === 'boolean') { param.allowableValues = {}; param.allowableValues.values = ['true', 'false']; } param.signature = this.getSignature(type, this.resource.models); param.sampleJSON = this.getSampleJSON(type, this.resource.models); var enumValue = param['enum']; if (typeof enumValue !== 'undefined') { param.isList = true; param.allowableValues = {}; param.allowableValues.descriptiveValues = []; for (j = 0; j < enumValue.length; j++) { v = enumValue[j]; if (param.defaultValue) { param.allowableValues.descriptiveValues.push({ value: String(v), isDefault: (v === param.defaultValue) }); } else { param.allowableValues.descriptiveValues.push({ value: String(v), isDefault: false }); } } } else if (param.allowableValues) { if (param.allowableValues.valueType === 'RANGE') param.isRange = true; else param.isList = true; if (param.allowableValues) { param.allowableValues.descriptiveValues = []; if (param.allowableValues.values) { for (j = 0; j < param.allowableValues.values.length; j++) { v = param.allowableValues.values[j]; if (param.defaultValue !== null) { param.allowableValues.descriptiveValues.push({ value: String(v), isDefault: (v === param.defaultValue) }); } else { param.allowableValues.descriptiveValues.push({ value: String(v), isDefault: false }); } } } } } param.defaultValue = applyParameterMacro(this, param); } var defaultSuccessCallback = this.resource.api.defaultSuccessCallback || null; var defaultErrorCallback = this.resource.api.defaultErrorCallback || null; this.resource[this.nickname] = function (args, opts, callback, error) { var arg1, arg2, arg3, arg4; if(typeof args === 'function') { // right shift 3 arg1 = {}; arg2 = {}; arg3 = args; arg4 = opts; } else if(typeof args === 'object' && typeof opts === 'function') { // right shift 2 arg1 = args; arg2 = {}; arg3 = opts; arg4 = callback; } else { arg1 = args; arg2 = opts; arg3 = callback; arg4 = error; } return _this['do'](arg1 || {}, arg2 || {}, arg3 || defaultSuccessCallback, arg4 || defaultErrorCallback); }; this.resource[this.nickname].help = function (dontPrint) { return _this.help(dontPrint); }; this.resource[this.nickname].asCurl = function (args) { return _this.asCurl(args); }; }; SwaggerOperation.prototype.isListType = function (type) { if (type && type.indexOf('[') >= 0) { return type.substring(type.indexOf('[') + 1, type.indexOf(']')); } else { return void 0; } }; SwaggerOperation.prototype.getSignature = function (type, models) { var isPrimitive, listType; listType = this.isListType(type); isPrimitive = ((typeof listType !== 'undefined') && models[listType]) || (typeof models[type] !== 'undefined') ? false : true; if (isPrimitive) { return type; } else { if (typeof listType !== 'undefined') { return models[listType].getMockSignature(); } else { return models[type].getMockSignature(); } } }; SwaggerOperation.prototype.getSampleJSON = function (type, models) { var isPrimitive, listType, val; listType = this.isListType(type); isPrimitive = ((typeof listType !== 'undefined') && models[listType]) || (typeof models[type] !== 'undefined') ? false : true; val = isPrimitive ? void 0 : (listType ? models[listType].createJSONSample() : models[type].createJSONSample()); if (val) { val = listType ? [val] : val; if (typeof val == 'string') return val; else if (typeof val === 'object') { var t = val; if (val instanceof Array && val.length > 0) { t = val[0]; } if (t.nodeName) { var xmlString = new XMLSerializer().serializeToString(t); return this.formatXml(xmlString); } else return JSON.stringify(val, null, 2); } else return val; } }; SwaggerOperation.prototype['do'] = function (args, opts, callback, error) { var key, param, params, possibleParams = [], req, value; if (typeof error !== 'function') { error = function (xhr, textStatus, error) { return log(xhr, textStatus, error); }; } if (typeof callback !== 'function') { callback = function (response) { var content; content = null; if (response !== null) { content = response.data; } else { content = 'no data'; } return log('default callback: ' + content); }; } params = {}; params.headers = []; if (args.headers) { params.headers = args.headers; delete args.headers; } // allow override from the opts if(opts && opts.responseContentType) { params.headers['Content-Type'] = opts.responseContentType; } if(opts && opts.requestContentType) { params.headers.Accept = opts.requestContentType; } for (var i = 0; i < this.parameters.length; i++) { param = this.parameters[i]; if (param.paramType === 'header') { if (typeof args[param.name] !== 'undefined') params.headers[param.name] = args[param.name]; } else if (param.paramType === 'form' || param.paramType.toLowerCase() === 'file') possibleParams.push(param); else if (param.paramType === 'body' && param.name !== 'body' && typeof args[param.name] !== 'undefined') { if (args.body) { throw new Error('Saw two body params in an API listing; expecting a max of one.'); } args.body = args[param.name]; } } if (typeof args.body !== 'undefined') { params.body = args.body; delete args.body; } if (possibleParams) { for (key in possibleParams) { value = possibleParams[key]; if (args[value.name]) { params[value.name] = args[value.name]; } } } req = new SwaggerRequest(this.method, this.urlify(args), params, opts, callback, error, this); if (opts.mock) { return req; } else { return true; } }; SwaggerOperation.prototype.pathJson = function () { return this.path.replace('{format}', 'json'); }; SwaggerOperation.prototype.pathXml = function () { return this.path.replace('{format}', 'xml'); }; SwaggerOperation.prototype.encodePathParam = function (pathParam) { var encParts, part, parts, _i, _len; pathParam = pathParam.toString(); if (pathParam.indexOf('/') === -1) { return encodeURIComponent(pathParam); } else { parts = pathParam.split('/'); encParts = []; for (_i = 0, _len = parts.length; _i < _len; _i++) { part = parts[_i]; encParts.push(encodeURIComponent(part)); } return encParts.join('/'); } }; SwaggerOperation.prototype.urlify = function (args) { var i, j, param, url, paramValues, paramSeparator, paramAdded; // ensure no double slashing... if(this.resource.basePath.length > 1 && this.resource.basePath.slice(-1) === '/' && this.pathJson().charAt(0) === '/') url = this.resource.basePath + this.pathJson().substring(1); else url = this.resource.basePath + this.pathJson(); var params = this.parameters; for (i = 0; i < params.length; i++) { param = params[i]; if (param.paramType === 'path') { if (typeof args[param.name] !== 'undefined') { // apply path params and remove from args var reg = new RegExp('\\{\\s*?' + param.name + '[^\\{\\}\\/]*(?:\\{.*?\\}[^\\{\\}\\/]*)*\\}(?=(\\/?|$))', 'gi'); url = url.replace(reg, this.encodePathParam(args[param.name])); delete args[param.name]; } else throw '' + param.name + ' is a required path param.'; } } var queryParams = ''; for (i = 0; i < params.length; i++) { param = params[i]; if(param.paramType === 'query') { if (queryParams !== '') queryParams += '&'; if (Array.isArray(param)) { var output = ''; for(j = 0; j < param.length; j++) { if(j > 0) output += ','; output += encodeURIComponent(param[j]); } queryParams += encodeURIComponent(param.name) + '=' + output; } else { if (typeof args[param.name] !== 'undefined') { paramAdded = false; if(typeof param.collectionFormat !== 'undefined' && param.signature === 'array[string]') { paramSeparator = ''; if (param.collectionFormat === 'multi' || param.collectionFormat === 'csv') { paramSeparator = ',' } if ('' !== paramSeparator) { paramAdded = true; paramValues = args[param.name].split(paramSeparator); for (j = 0; j < paramValues.length; j++) { if (j !== 0) queryParams += '&'; queryParams += encodeURIComponent(param.name) + '[]=' + encodeURIComponent(paramValues[j]); } } } if (!paramAdded) { queryParams += encodeURIComponent(param.name) + '=' + encodeURIComponent(args[param.name]); } } else { if (param.required) throw '' + param.name + ' is a required query param.'; } } } } if ((queryParams) && queryParams.length > 0) url += '?' + queryParams; return url; }; SwaggerOperation.prototype.supportHeaderParams = function () { return this.resource.api.supportHeaderParams; }; SwaggerOperation.prototype.supportedSubmitMethods = function () { return this.resource.api.supportedSubmitMethods; }; SwaggerOperation.prototype.getQueryParams = function (args) { return this.getMatchingParams(['query'], args); }; SwaggerOperation.prototype.getHeaderParams = function (args) { return this.getMatchingParams(['header'], args); }; SwaggerOperation.prototype.getMatchingParams = function (paramTypes, args) { var matchingParams = {}; var params = this.parameters; for (var i = 0; i < params.length; i++) { param = params[i]; if (args && args[param.name]) matchingParams[param.name] = args[param.name]; } var headers = this.resource.api.headers; var name; for (name in headers) { var value = headers[name]; matchingParams[name] = value; } return matchingParams; }; SwaggerOperation.prototype.help = function (dontPrint) { var msg = this.nickname + ': ' + this.summary; var params = this.parameters; for (var i = 0; i < params.length; i++) { var param = params[i]; msg += '\n* ' + param.name + (param.required ? ' (required)' : '') + " - " + param.description; } if(dontPrint) return msg; else { console.log(msg); return msg; } }; SwaggerOperation.prototype.asCurl = function (args) { var results = []; var i; var headers = SwaggerRequest.prototype.setHeaders(args, {}, this); for(i = 0; i < this.parameters.length; i++) { var param = this.parameters[i]; if(param.paramType && param.paramType === 'header' && args[param.name]) { headers[param.name] = args[param.name]; } } var key; for (key in headers) { results.push('--header "' + key + ': ' + headers[key] + '"'); } return 'curl ' + (results.join(' ')) + ' ' + this.urlify(args); }; SwaggerOperation.prototype.formatXml = function (xml) { var contexp, formatted, indent, lastType, lines, ln, pad, reg, transitions, wsexp, _fn, _i, _len; reg = /(>)(<)(\/*)/g; wsexp = /[ ]*(.*)[ ]+\n/g; contexp = /(<.+>)(.+\n)/g; xml = xml.replace(reg, '$1\n$2$3').replace(wsexp, '$1\n').replace(contexp, '$1\n$2'); pad = 0; formatted = ''; lines = xml.split('\n'); indent = 0; lastType = 'other'; transitions = { 'single->single': 0, 'single->closing': -1, 'single->opening': 0, 'single->other': 0, 'closing->single': 0, 'closing->closing': -1, 'closing->opening': 0, 'closing->other': 0, 'opening->single': 1, 'opening->closing': 0, 'opening->opening': 1, 'opening->other': 1, 'other->single': 0, 'other->closing': -1, 'other->opening': 0, 'other->other': 0 }; _fn = function (ln) { var fromTo, j, key, padding, type, types, value; types = { single: Boolean(ln.match(/<.+\/>/)), closing: Boolean(ln.match(/<\/.+>/)), opening: Boolean(ln.match(/<[^!?].*>/)) }; type = ((function () { var _results; _results = []; for (key in types) { value = types[key]; if (value) { _results.push(key); } } return _results; })())[0]; type = type === void 0 ? 'other' : type; fromTo = lastType + '->' + type; lastType = type; padding = ''; indent += transitions[fromTo]; padding = ((function () { var _j, _ref5, _results; _results = []; for (j = _j = 0, _ref5 = indent; 0 <= _ref5 ? _j < _ref5 : _j > _ref5; j = 0 <= _ref5 ? ++_j : --_j) { _results.push(' '); } return _results; })()).join(''); if (fromTo === 'opening->closing') { formatted = formatted.substr(0, formatted.length - 1) + ln + '\n'; } else { formatted += padding + ln + '\n'; } }; for (_i = 0, _len = lines.length; _i < _len; _i++) { ln = lines[_i]; _fn(ln); } return formatted; }; var SwaggerRequest = function (type, url, params, opts, successCallback, errorCallback, operation, execution) { var _this = this; var errors = []; this.useJQuery = (typeof operation.resource.useJQuery !== 'undefined' ? operation.resource.useJQuery : null); this.type = (type || errors.push('SwaggerRequest type is required (get/post/put/delete/patch/options).')); this.url = (url || errors.push('SwaggerRequest url is required.')); this.params = params; this.opts = opts; this.successCallback = (successCallback || errors.push('SwaggerRequest successCallback is required.')); this.errorCallback = (errorCallback || errors.push('SwaggerRequest error callback is required.')); this.operation = (operation || errors.push('SwaggerRequest operation is required.')); this.execution = execution; this.headers = (params.headers || {}); if (errors.length > 0) { throw errors; } this.type = this.type.toUpperCase(); // set request, response content type headers var headers = this.setHeaders(params, opts, this.operation); var body = params.body; // encode the body for form submits if (headers['Content-Type']) { var key, value, values = {}, i; var operationParams = this.operation.parameters; for (i = 0; i < operationParams.length; i++) { var param = operationParams[i]; if (param.paramType === 'form') values[param.name] = param; } if (headers['Content-Type'].indexOf('application/x-www-form-urlencoded') === 0) { var encoded = ''; for (key in values) { value = this.params[key]; if (typeof value !== 'undefined') { if (encoded !== '') encoded += '&'; encoded += encodeURIComponent(key) + '=' + encodeURIComponent(value); } } body = encoded; } else if (headers['Content-Type'].indexOf('multipart/form-data') === 0) { // encode the body for form submits var data = ''; var boundary = '----SwaggerFormBoundary' + Date.now(); for (key in values) { value = this.params[key]; if (typeof value !== 'undefined') { data += '--' + boundary + '\n'; data += 'Content-Disposition: form-data; name="' + key + '"'; data += '\n\n'; data += value + '\n'; } } data += '--' + boundary + '--\n'; headers['Content-Type'] = 'multipart/form-data; boundary=' + boundary; body = data; } } var obj; if (!((this.headers) && (this.headers.mock))) { obj = { url: this.url, method: this.type, headers: headers, body: body, useJQuery: this.useJQuery, on: { error: function (response) { return _this.errorCallback(response, _this.opts.parent); }, redirect: function (response) { return _this.successCallback(response, _this.opts.parent); }, 307: function (response) { return _this.successCallback(response, _this.opts.parent); }, response: function (response) { return _this.successCallback(response, _this.opts.parent); } } }; var status = false; if (this.operation.resource && this.operation.resource.api && this.operation.resource.api.clientAuthorizations) { // Get the client authorizations from the resource declaration status = this.operation.resource.api.clientAuthorizations.apply(obj, this.operation.authorizations); } else { // Get the client authorization from the default authorization declaration var e; if (typeof window !== 'undefined') { e = window; } else { e = exports; } status = e.authorizations.apply(obj, this.operation.authorizations); } if (!opts.mock) { if (status !== false) { new SwaggerHttp().execute(obj); } else { obj.canceled = true; } } else { return obj; } } return obj; }; SwaggerRequest.prototype.setHeaders = function (params, opts, operation) { // default type var accepts = opts.responseContentType || 'application/json'; var consumes = opts.requestContentType || 'application/json'; var allDefinedParams = operation.parameters; var definedFormParams = []; var definedFileParams = []; var body = params.body; var headers = {}; // get params from the operation and set them in definedFileParams, definedFormParams, headers var i; for (i = 0; i < allDefinedParams.length; i++) { var param = allDefinedParams[i]; if (param.paramType === 'form') definedFormParams.push(param); else if (param.paramType === 'file') definedFileParams.push(param); else if (param.paramType === 'header' && this.params.headers) { var key = param.name; var headerValue = this.params.headers[param.name]; if (typeof this.params.headers[param.name] !== 'undefined') headers[key] = headerValue; } } // if there's a body, need to set the accepts header via requestContentType if (body && (this.type === 'POST' || this.type === 'PUT' || this.type === 'PATCH' || this.type === 'DELETE')) { if (this.opts.requestContentType) consumes = this.opts.requestContentType; } else { // if any form params, content type must be set if (definedFormParams.length > 0) { if (definedFileParams.length > 0) consumes = 'multipart/form-data'; else consumes = 'application/x-www-form-urlencoded'; } else if (this.type === 'DELETE') body = '{}'; else if (this.type != 'DELETE') consumes = null; } if (consumes && this.operation.consumes) { if (this.operation.consumes.indexOf(consumes) === -1) { log('server doesn\'t consume ' + consumes + ', try ' + JSON.stringify(this.operation.consumes)); } } if (this.opts && this.opts.responseContentType) { accepts = this.opts.responseContentType; } else { accepts = 'application/json'; } if (accepts && operation.produces) { if (operation.produces.indexOf(accepts) === -1) { log('server can\'t produce ' + accepts); } } if ((consumes && body !== '') || (consumes === 'application/x-www-form-urlencoded')) headers['Content-Type'] = consumes; if (accepts) headers.Accept = accepts; return headers; }; /** * SwaggerHttp is a wrapper for executing requests */ var SwaggerHttp = function() {}; SwaggerHttp.prototype.execute = function(obj, opts) { if(obj && (typeof obj.useJQuery === 'boolean')) this.useJQuery = obj.useJQuery; else this.useJQuery = this.isIE8(); if(obj && typeof obj.body === 'object') { if(obj.body.type && obj.body.type !== 'formData') obj.body = JSON.stringify(obj.body); else { obj.contentType = false; obj.processData = false; // delete obj.cache; delete obj.headers['Content-Type']; } } if(this.useJQuery) return new JQueryHttpClient(opts).execute(obj); else return new ShredHttpClient(opts).execute(obj); }; SwaggerHttp.prototype.isIE8 = function() { var detectedIE = false; if (typeof navigator !== 'undefined' && navigator.userAgent) { nav = navigator.userAgent.toLowerCase(); if (nav.indexOf('msie') !== -1) { var version = parseInt(nav.split('msie')[1]); if (version <= 8) { detectedIE = true; } } } return detectedIE; }; /* * JQueryHttpClient lets a browser take advantage of JQuery's cross-browser magic. * NOTE: when jQuery is available it will export both '$' and 'jQuery' to the global space. * Since we are using closures here we need to alias it for internal use. */ var JQueryHttpClient = function(options) { "use strict"; if(!jQuery){ var jQuery = window.jQuery; } }; JQueryHttpClient.prototype.execute = function(obj) { var cb = obj.on; var request = obj; obj.type = obj.method; obj.cache = false; delete obj.useJQuery; /* obj.beforeSend = function(xhr) { var key, results; if (obj.headers) { results = []; for (key in obj.headers) { if (key.toLowerCase() === "content-type") { results.push(obj.contentType = obj.headers[key]); } else if (key.toLowerCase() === "accept") { results.push(obj.accepts = obj.headers[key]); } else { results.push(xhr.setRequestHeader(key, obj.headers[key])); } } return results; } };*/ obj.data = obj.body; delete obj.body; obj.complete = function(response, textStatus, opts) { var headers = {}, headerArray = response.getAllResponseHeaders().split("\n"); for(var i = 0; i < headerArray.length; i++) { var toSplit = headerArray[i].trim(); if(toSplit.length === 0) continue; var separator = toSplit.indexOf(":"); if(separator === -1) { // Name but no value in the header headers[toSplit] = null; continue; } var name = toSplit.substring(0, separator).trim(), value = toSplit.substring(separator + 1).trim(); headers[name] = value; } var out = { url: request.url, method: request.method, status: response.status, statusText: response.statusText, data: response.responseText, headers: headers }; var contentType = (headers["content-type"]||headers["Content-Type"]||null); if(contentType) { if(contentType.indexOf("application/json") === 0 || contentType.indexOf("+json") > 0) { try { out.obj = response.responseJSON || JSON.parse(out.data) || {}; } catch (ex) { // do not set out.obj log("unable to parse JSON content"); } } } if(response.status >= 200 && response.status < 300) cb.response(out); else if(response.status === 0 || (response.status >= 400 && response.status < 599)) cb.error(out); else return cb.response(out); }; jQuery.support.cors = true; return jQuery.ajax(obj); }; /* * ShredHttpClient is a light-weight, node or browser HTTP client */ var ShredHttpClient = function(opts) { this.opts = (opts||{}); this.isInitialized = false; var identity, toString; if (typeof window !== 'undefined') { this.Shred = require("./shred"); this.content = require("./shred/content"); } else this.Shred = require("shred"); this.shred = new this.Shred(opts); }; ShredHttpClient.prototype.initShred = function () { this.isInitialized = true; this.registerProcessors(this.shred); }; ShredHttpClient.prototype.registerProcessors = function(shred) { var identity = function(x) { return x; }; var toString = function(x) { return x.toString(); }; if (typeof window !== 'undefined') { this.content.registerProcessor(["application/json; charset=utf-8", "application/json", "json"], { parser: identity, stringify: toString }); } else { this.Shred.registerProcessor(["application/json; charset=utf-8", "application/json", "json"], { parser: identity, stringify: toString }); } }; ShredHttpClient.prototype.execute = function(obj) { if(!this.isInitialized) this.initShred(); var cb = obj.on, res; var transform = function(response) { var out = { headers: response._headers, url: response.request.url, method: response.request.method, status: response.status, data: response.content.data }; var headers = response._headers.normalized || response._headers; var contentType = (headers["content-type"]||headers["Content-Type"]||null); if(contentType) { if(contentType.indexOf("application/json") === 0 || contentType.indexOf("+json") > 0) { if(response.content.data && response.content.data !== "") try{ out.obj = JSON.parse(response.content.data); } catch (e) { // unable to parse } else out.obj = {}; } } return out; }; // Transform an error into a usable response-like object var transformError = function (error) { var out = { // Default to a status of 0 - The client will treat this as a generic permissions sort of error status: 0, data: error.message || error }; if (error.code) { out.obj = error; if (error.code === 'ENOTFOUND' || error.code === 'ECONNREFUSED') { // We can tell the client that this should be treated as a missing resource and not as a permissions thing out.status = 404; } } return out; }; res = { error: function (response) { if (obj) return cb.error(transform(response)); }, // Catch the Shred error raised when the request errors as it is made (i.e. No Response is coming) request_error: function (err) { if (obj) return cb.error(transformError(err)); }, response: function (response) { if (obj) { return cb.response(transform(response)); } } }; if (obj) { obj.on = res; } return this.shred.request(obj); }; var e = (typeof window !== 'undefined' ? window : exports); e.authorizations = authorizations = new SwaggerAuthorizations(); e.ApiKeyAuthorization = ApiKeyAuthorization; e.PasswordAuthorization = PasswordAuthorization; e.CookieAuthorization = CookieAuthorization; e.SwaggerClient = SwaggerClient; e.SwaggerApi = SwaggerClient; e.Operation = Operation; e.Model = Model; e.addModel = addModel; e.Resolver = Resolver; })();