Built!
This commit is contained in:
zeke
393
build/javascripts/swagger-service.js
Normal file
393
build/javascripts/swagger-service.js
Normal file
@@ -0,0 +1,393 @@
|
||||
function SwaggerService(baseUrl, _apiKey, statusCallback) {
|
||||
if (!baseUrl)
|
||||
throw new Error("baseUrl must be passed while creating SwaggerService");
|
||||
|
||||
// constants
|
||||
baseUrl = jQuery.trim(baseUrl);
|
||||
if (baseUrl.length == 0)
|
||||
throw new Error("baseUrl must be passed while creating SwaggerService");
|
||||
|
||||
if (! (baseUrl.toLowerCase().indexOf("http:") == 0 || baseUrl.toLowerCase().indexOf("https:") == 0)) {
|
||||
baseUrl = ("http://" + baseUrl);
|
||||
}
|
||||
baseUrl = baseUrl + "/resources.json";
|
||||
// log("using base url " + baseUrl);
|
||||
var apiHost = baseUrl.substr(0, baseUrl.lastIndexOf("/"));
|
||||
var rootResourcesApiName = baseUrl.substr(baseUrl.lastIndexOf("/") + 1, (baseUrl.lastIndexOf(".") - baseUrl.lastIndexOf("/") - 1));
|
||||
var formatString = ".{format}";
|
||||
var statusListener = statusCallback;
|
||||
var apiKey = _apiKey;
|
||||
|
||||
var apiKeySuffix = "";
|
||||
if (apiKey) {
|
||||
apiKey = jQuery.trim(apiKey);
|
||||
if (apiKey.length > 0)
|
||||
apiKeySuffix = "?api_key=" + apiKey;
|
||||
}
|
||||
// log("apiHost=" + apiHost);
|
||||
// log("apiKey=" + apiKey);
|
||||
// log("rootResourcesApiName = " + rootResourcesApiName);
|
||||
// utility functions
|
||||
function log(m) {
|
||||
if (window.console) console.log(m);
|
||||
}
|
||||
|
||||
function error(m) {
|
||||
if (window.console) console.log("ERROR: " + m);
|
||||
}
|
||||
|
||||
function updateStatus(status) {
|
||||
statusListener(status);
|
||||
}
|
||||
|
||||
// make some models public
|
||||
this.ApiResource = function() {
|
||||
return ApiResource;
|
||||
};
|
||||
|
||||
this.apiHost = function() {
|
||||
return apiHost;
|
||||
};
|
||||
|
||||
this.formatString = function() {
|
||||
return formatString;
|
||||
};
|
||||
|
||||
// Model: ApiResource
|
||||
var ApiResource = Spine.Model.setup("ApiResource", ["name", "baseUrl", "path", "path_json", "path_xml", "description", "apiLists", "modelList"]);
|
||||
ApiResource.include({
|
||||
path_json: null,
|
||||
path_xml: null,
|
||||
|
||||
init: function(atts) {
|
||||
if (atts) this.load(atts);
|
||||
this.path_json = this.path.replace("{format}", "json");
|
||||
this.path_xml = this.path.replace("{format}", "xml");
|
||||
this.baseUrl = apiHost;
|
||||
//execluded 9 letters to remove .{format} from name
|
||||
this.name = this.path.substr(1, this.path.length - formatString.length - 1);
|
||||
this.apiList = Api.sub();
|
||||
this.modelList = ApiModel.sub();
|
||||
},
|
||||
|
||||
addApis: function(apiObjects) {
|
||||
this.apiList.createAll(apiObjects);
|
||||
},
|
||||
|
||||
addModel: function(modelObject) {
|
||||
this.modelList.create(modelObject);
|
||||
},
|
||||
|
||||
toString: function() {
|
||||
return this.path_json + ": " + this.description;
|
||||
}
|
||||
});
|
||||
|
||||
// Model: Api
|
||||
var Api = Spine.Model.setup("Api", ["baseUrl", "path", "path_json", "path_xml", "name", "description", "operations", "path_json", "path_xml"]);
|
||||
Api.include({
|
||||
init: function(atts) {
|
||||
if (atts) this.load(atts);
|
||||
|
||||
this.baseUrl = apiHost;
|
||||
|
||||
var secondPathSeperatorIndex = this.path.indexOf("/", 1);
|
||||
if (secondPathSeperatorIndex > 0) {
|
||||
var prefix = this.path.substr(0, secondPathSeperatorIndex);
|
||||
var suffix = this.path.substr(secondPathSeperatorIndex, this.path.length);
|
||||
// log(this.path + ":: " + prefix + "..." + suffix);
|
||||
this.path_json = prefix.replace("{format}", "json") + suffix;
|
||||
this.path_xml = prefix.replace("{format}", "xml") + suffix;;
|
||||
|
||||
if (this.path.indexOf("/") == 0) {
|
||||
this.name = this.path.substr(1, secondPathSeperatorIndex - formatString.length - 1);
|
||||
} else {
|
||||
this.name = this.path.substr(0, secondPathSeperatorIndex - formatString.length - 1);
|
||||
}
|
||||
} else {
|
||||
this.path_json = this.path.replace("{format}", "json");
|
||||
this.path_xml = this.path.replace("{format}", "xml");
|
||||
|
||||
if (this.path.indexOf("/") == 0) {
|
||||
this.name = this.path.substr(1, this.path.length - formatString.length - 1);
|
||||
} else {
|
||||
this.name = this.path.substr(0, this.path.length - formatString.length - 1);
|
||||
}
|
||||
}
|
||||
|
||||
var value = this.operations;
|
||||
|
||||
this.operations = ApiOperation.sub();
|
||||
if (value) {
|
||||
for (var i = 0; i < value.length; i++) {
|
||||
var obj = value[i];
|
||||
obj.apiName = this.name;
|
||||
obj.path = this.path;
|
||||
obj.path_json = this.path_json;
|
||||
obj.path_xml = this.path_xml;
|
||||
|
||||
}
|
||||
|
||||
this.operations.refresh(value);
|
||||
}
|
||||
|
||||
updateStatus("Loading " + this.path + "...");
|
||||
|
||||
},
|
||||
|
||||
toString: function() {
|
||||
var opsString = "";
|
||||
for (var i = 0; i < this.operations.all().length; i++) {
|
||||
var e = this.operations.all()[i];
|
||||
|
||||
if (opsString.length > 0)
|
||||
opsString += ", ";
|
||||
|
||||
opsString += e.toString();
|
||||
}
|
||||
return this.path_json + "- " + this.operations.all().length + " operations: " + opsString;
|
||||
}
|
||||
|
||||
});
|
||||
|
||||
// Model: ApiOperation
|
||||
var ApiOperation = Spine.Model.setup("ApiOperation", ["baseUrl", "path", "path_json", "path_xml", "summary", "notes", "deprecated", "open", "httpMethod", "httpMethodLowercase", "nickname", "responseClass", "parameters", "apiName"]);
|
||||
ApiOperation.include({
|
||||
init: function(atts) {
|
||||
if (atts) this.load(atts);
|
||||
|
||||
this.baseUrl = apiHost;
|
||||
this.httpMethodLowercase = this.httpMethod.toLowerCase();
|
||||
|
||||
var value = this.parameters;
|
||||
this.parameters = ApiParameter.sub();
|
||||
if (value) this.parameters.refresh(value);
|
||||
},
|
||||
|
||||
toString: function() {
|
||||
var paramsString = "(";
|
||||
for (var i = 0; i < this.parameters.all().length; i++) {
|
||||
var e = this.parameters.all()[i];
|
||||
|
||||
if (paramsString.length > 1)
|
||||
paramsString += ", ";
|
||||
|
||||
paramsString += e.toString();
|
||||
}
|
||||
paramsString += ")";
|
||||
|
||||
return "{" + this.path_json + "| " + this.nickname + paramsString + ": " + this.summary + "}";
|
||||
},
|
||||
|
||||
invocationUrl: function(formValues) {
|
||||
var formValuesMap = new Object();
|
||||
for (var i = 0; i < formValues.length; i++) {
|
||||
var formValue = formValues[i];
|
||||
if (formValue.value && jQuery.trim(formValue.value).length > 0)
|
||||
formValuesMap[formValue.name] = formValue.value;
|
||||
}
|
||||
|
||||
var urlTemplateText = this.path_json.split("{").join("${");
|
||||
// log("url template = " + urlTemplateText);
|
||||
var urlTemplate = $.template(null, urlTemplateText);
|
||||
var url = $.tmpl(urlTemplate, formValuesMap)[0].data;
|
||||
// log("url with path params = " + url);
|
||||
|
||||
var queryParams = apiKeySuffix;
|
||||
this.parameters.each(function(param) {
|
||||
var paramValue = jQuery.trim(formValuesMap[param.name]);
|
||||
if (param.paramType == "query" && paramValue.length > 0) {
|
||||
queryParams += queryParams.length > 0 ? "&": "?";
|
||||
queryParams += param.name;
|
||||
queryParams += "=";
|
||||
queryParams += formValuesMap[param.name];
|
||||
}
|
||||
});
|
||||
|
||||
url = this.baseUrl + url + queryParams;
|
||||
// log("final url with query params and base url = " + url);
|
||||
|
||||
return url;
|
||||
}
|
||||
|
||||
});
|
||||
|
||||
// Model: ApiParameter
|
||||
var ApiParameter = Spine.Model.setup("ApiParameter", ["name", "description", "required", "dataType", "allowableValues", "paramType", "allowMultiple"]);
|
||||
ApiParameter.include({
|
||||
init: function(atts) {
|
||||
if (atts) this.load(atts);
|
||||
|
||||
this.name = this.name || this.dataType;
|
||||
},
|
||||
|
||||
toString: function() {
|
||||
if (this.allowableValues && this.allowableValues.length > 0)
|
||||
return this.name + ": " + this.dataType + " [" + this.allowableValues + "]";
|
||||
else
|
||||
return this.name + ": " + this.dataType;
|
||||
}
|
||||
|
||||
});
|
||||
|
||||
// Model: ApiModel
|
||||
var ApiModel = Spine.Model.setup("ApiModel", ["id", "fields"]);
|
||||
ApiModel.include({
|
||||
init: function(atts) {
|
||||
if (atts) this.load(atts);
|
||||
|
||||
if (!this.fields) {
|
||||
var propertiesListObject = this.properties;
|
||||
this.fields = ApiModelProperty.sub();
|
||||
|
||||
for (var propName in propertiesListObject) {
|
||||
if (propName != "parent") {
|
||||
var p = propertiesListObject[propName];
|
||||
p.name = propName;
|
||||
p.id = Spine.guid();
|
||||
// log(p);
|
||||
this.fields.create(p);
|
||||
}
|
||||
}
|
||||
//log("got " + this.fields.count() + " fields for " + this.id);
|
||||
}
|
||||
},
|
||||
|
||||
toString: function() {
|
||||
var propsString = "";
|
||||
|
||||
propsString += "(";
|
||||
for (var i = 0; i < this.fields.all().length; i++) {
|
||||
var e = this.fields.all()[i];
|
||||
|
||||
if (propsString.length > 1)
|
||||
propsString += ", ";
|
||||
|
||||
propsString += e.toString();
|
||||
}
|
||||
propsString += ")";
|
||||
|
||||
if (this.required)
|
||||
return this.id + " (required): " + propsString;
|
||||
else
|
||||
return this.id + ": " + propsString;
|
||||
}
|
||||
|
||||
});
|
||||
|
||||
|
||||
// Model: ApiModelProperty
|
||||
var ApiModelProperty = Spine.Model.setup("ApiModelProperty", ["name", "required", "dataType"]);
|
||||
ApiModelProperty.include({
|
||||
init: function(atts) {
|
||||
if (atts) this.load(atts);
|
||||
|
||||
if (!this.dataType) {
|
||||
if (atts.type == "any")
|
||||
this.dataType = "object";
|
||||
else if (atts.type == "array") {
|
||||
if (atts.items) {
|
||||
if (atts.items.$ref) {
|
||||
this.dataType = "array[" + atts.items.$ref + "]";
|
||||
} else {
|
||||
this.dataType = "array[" + atts.items.type + "]";
|
||||
}
|
||||
} else {
|
||||
this.dataType = "array";
|
||||
}
|
||||
} else
|
||||
this.dataType = atts.type;
|
||||
|
||||
}
|
||||
},
|
||||
|
||||
toString: function() {
|
||||
if (this.required)
|
||||
return this.name + ": " + this.dataType + " (required)";
|
||||
else
|
||||
return this.name + ": " + this.dataType;
|
||||
}
|
||||
|
||||
});
|
||||
|
||||
// Controller
|
||||
var ModelController = Spine.Controller.create({
|
||||
countLoaded: 0,
|
||||
proxied: ["fetchResources", "loadResources", "apisLoaded", "modelsLoaded"],
|
||||
|
||||
init: function() {
|
||||
// log("ModelController.init");
|
||||
|
||||
this.fetchEndpoints();
|
||||
},
|
||||
|
||||
fetchEndpoints: function() {
|
||||
var controller = this;
|
||||
|
||||
updateStatus("Fetching API List...");
|
||||
$.getJSON(apiHost + "/" + rootResourcesApiName + ".json" + apiKeySuffix,
|
||||
function(response) {
|
||||
//log(response);
|
||||
ApiResource.createAll(response.apis);
|
||||
|
||||
// get rid of the root resource list api since we're not going to document that
|
||||
var obj = ApiResource.findByAttribute("name", rootResourcesApiName);
|
||||
if (obj)
|
||||
obj.destroy();
|
||||
|
||||
|
||||
controller.fetchResources();
|
||||
});
|
||||
},
|
||||
|
||||
fetchResources: function() {
|
||||
//log("fetchResources");
|
||||
//ApiResource.logAll();
|
||||
for (var i = 0; i < ApiResource.all().length; i++) {
|
||||
var apiResource = ApiResource.all()[i];
|
||||
this.fetchResource(apiResource);
|
||||
}
|
||||
},
|
||||
|
||||
fetchResource: function(apiResource) {
|
||||
var controller = this;
|
||||
updateStatus("Fetching " + apiResource.name + "...");
|
||||
$.getJSON(apiHost + apiResource.path_json + apiKeySuffix,
|
||||
function(response) {
|
||||
controller.loadResources(response, apiResource);
|
||||
});
|
||||
},
|
||||
|
||||
loadResources: function(response, apiResource) {
|
||||
try {
|
||||
this.countLoaded++;
|
||||
// log(response);
|
||||
apiResource.addApis(response.apis);
|
||||
// updateStatus("Parsed Apis");
|
||||
//log(response.models);
|
||||
if (response.models) {
|
||||
// log("response.models.length = " + response.models.length);
|
||||
for (var modeName in response.models) {
|
||||
var m = response.models[modeName];
|
||||
// log("creating " + m.id);
|
||||
apiResource.addModel(m);
|
||||
// apiResource.modelList.create(m);
|
||||
}
|
||||
}
|
||||
|
||||
updateStatus();
|
||||
} finally {
|
||||
if (this.countLoaded == ApiResource.count()) {
|
||||
log("all models/api loaded");
|
||||
ApiResource.trigger("refresh");
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
});
|
||||
|
||||
this.init = function() {
|
||||
this.modelController = ModelController.init();
|
||||
};
|
||||
};
|
||||
|
||||
Reference in New Issue
Block a user