/**
  * adds a find applications hplink {@see {@link LinkType} to the Links List
  * {@see {@link LinksListType}
  *
  * @param linksList
  *            the links list to update
  * @param apiUrl
  *            the public URL of the used API
  * @return the updated links list
  */
 public static LinksListType addFindAppsLink(LinksListType linksList, String apiUrl) {
   String url = formatApiURL(apiUrl) + "app/";
   LinkType createAppLink = new LinkType();
   createAppLink.setAction("GET");
   createAppLink.setLabel("findApplications");
   createAppLink.setDescription("this Link displays all existing applications");
   createAppLink.setType("hplink");
   createAppLink.setHref(url);
   linksList.getLink().add(createAppLink);
   return linksList;
 }
 /**
  * adds a stop application state link {@see {@link LinkType} to the Links
  * List {@see {@link LinksListType}
  *
  * @param linksList
  *            the links list to update
  * @param appId
  *            the application ID
  * @param apiUrl
  *            the public URL of the used API
  * @return the updated links list
  */
 public static LinksListType addStopAppLink(LinksListType linksList, String appId, String apiUrl) {
   String url = formatApiURL(apiUrl) + "app/" + appId + "/stop";
   LinkType stopAppLink = new LinkType();
   stopAppLink.setAction("POST");
   stopAppLink.setLabel("stopApplication");
   stopAppLink.setDescription("this Link stops the application");
   stopAppLink.setType("state");
   stopAppLink.setHref(url);
   linksList.getLink().add(stopAppLink);
   return linksList;
 }
 /**
  * adds a getEnvironmentsOfAnApp hplink {@see {@link LinkType} to the Links
  * List {@see {@link LinksListType}
  *
  * @param linksList
  *            the links list to update
  * @param appId
  *            the application ID
  * @param apiUrl
  *            the public URL of the used API
  * @return the updated links list
  */
 public static LinksListType addGetEnvsOfAppsLink(
     LinksListType linksList, String appId, String apiUrl) {
   String url = formatApiURL(apiUrl) + "app/" + appId + "/environment";
   LinkType createAppLink = new LinkType();
   createAppLink.setAction("GET");
   createAppLink.setLabel("getEnvironmentsOfAnApp");
   createAppLink.setDescription("this Link displays all environment of an application");
   createAppLink.setType("hplink");
   createAppLink.setHref(url);
   linksList.getLink().add(createAppLink);
   return linksList;
 }
 /**
  * adds a create application hplink {@see {@link LinkType} to the Links
  * List {@see {@link LinksListType}
  *
  * @param linksList
  *            the links list to update
  * @param apiUrl
  *            the public URL of the used API
  * @return the updated links list
  */
 public static LinksListType addCreateAppLink(LinksListType linksList, String apiUrl) {
   String url = formatApiURL(apiUrl) + "app/";
   LinkType createAppLink = new LinkType();
   createAppLink.setAction("POST");
   createAppLink.setLabel("createApplication");
   createAppLink.setDescription(
       "this Link allows the creation of an applications by providing its manifest");
   createAppLink.setType("hplink");
   createAppLink.setHref(url);
   linksList.getLink().add(createAppLink);
   return linksList;
 }
 /**
  * adds a describe application hplink {@see {@link LinkType} to the Links
  * List {@see {@link LinksListType}
  *
  * @param linksList
  *            the links list to update
  * @param appId
  *            the application ID
  * @param apiUrl
  *            the public URL of the used API
  * @return the updated links list
  */
 public static LinksListType addDescribeAppLink(
     LinksListType linksList, String appId, String apiUrl) {
   String url = formatApiURL(apiUrl) + "app/" + appId;
   LinkType describeAppLink = new LinkType();
   describeAppLink.setAction("GET");
   describeAppLink.setLabel("describeApplication");
   describeAppLink.setDescription("this Link provides a description of the application");
   describeAppLink.setType("hplink");
   describeAppLink.setHref(url);
   linksList.getLink().add(describeAppLink);
   return linksList;
 }
 /**
  * adds a destroy application state link {@see {@link LinkType} to the
  * Links List {@see {@link LinksListType}
  *
  * @param linksList
  *            the links list to update
  * @param appId
  *            the application ID
  * @param apiUrl
  *            the public URL of the used API
  * @return the updated links list
  */
 public static LinksListType addDestroyAppLink(
     LinksListType linksList, String appId, String apiUrl) {
   String url = formatApiURL(apiUrl) + "app/" + appId;
   LinkType destroyAppLink = new LinkType();
   destroyAppLink.setAction("DELETE");
   destroyAppLink.setLabel("destroyApplication");
   destroyAppLink.setDescription("this Link destroys the application");
   destroyAppLink.setType("state");
   destroyAppLink.setHref(url);
   linksList.getLink().add(destroyAppLink);
   return linksList;
 }