Kylin Java RESTful API

　　最近在做大数据方面的开发, 学习研究了一段时间的kylin系统, 对于前端开发需要使用 RESTful API ,但是官网并没有提供详细的Java  API. 经过几天的看文档,最终写出了 Java 的API,不敢私藏,特分享与大家.

 import java.io.BufferedReader;
 import java.io.InputStream;
 import java.io.InputStreamReader;
 import java.io.OutputStream;
 import java.net.HttpURLConnection;
 import java.net.URL;

 import org.apache.commons.codec.binary.Base64;  

 /**
  *
  * @author HennSun
  * www.shareideas.net
  * @Reference
  * http://kylin.apache.org/docs15/howto/howto_use_restapi.html#authentication
  *
  */
 public class KylinHttpBasic {

     private static String encoding;
     private static final String baseURL = "http://10.1.50.123:7070/kylin/api";
     public static String login(String user,String passwd){
         String method = "POST";
         String para = "/user/authentication";
         byte[] key = (user+":"+passwd).getBytes();
         encoding = new sun.misc.BASE64Encoder().encode(key);
         return  excute(para,method,null);
     }

     public static String listQueryableTables(String projectName){

         String method = "GET";
         String para = "/tables_and_columns?project="+projectName;

         return  excute(para,method,null);

     }

     /**
      *
      * @param offset required int Offset used by pagination
      * @param limit required int Cubes per page.
      * @param cubeName optional string Keyword for cube names. To find cubes whose name contains this keyword.
      * @param projectName optional string Project name.
      * @return
      */
     public static String listCubes(int offset,
                                    int limit,
                                    String cubeName,
                                    String projectName ){
         String method = "GET";
         String para = "/cubes?offset="+offset
                             +"&limit="+limit
                             +"&cubeName="+cubeName
                             +"&projectName="+projectName;
         return excute(para,method,null);
     }

     /**
      *
      * @param cubeName  Cube name.
      * @return
      */
     public static String getCubeDes(String cubeName){
         String method = "GET";
         String para = "/cube_desc/"+cubeName;
         return excute(para,method,null); 

     }

     /**
      *
      * @param cubeName
      * @return
      */
     public static String getCube(String cubeName){
         String method = "GET";
         String para = "/cubes/"+cubeName;
         return excute(para,method,null); 

     }

     /**
      *
      * @param modelName Data model name, by default it should be the same with cube name.
      * @return
      */
     public static String getDataModel(String modelName){
         String method = "GET";
         String para = "/model/"+modelName;
         return excute(para,method,null);  

     }

     /**
      *
      * @param cubeName cubeName Cube name.
      * @return
      */
     public static String enableCube(String cubeName){

         String method = "PUT";
         String para = "/cubes/"+cubeName+"/enable";
         return excute(para,method,null); 

     }

     /**
      *
      * @param cubeName Cube name.
      * @return
      */
     public static String disableCube(String cubeName){

         String method = "PUT";
         String para = "/cubes/"+cubeName+"/disable";
         return excute(para,method,null); 

     }

     /**
      *
      * @param cubeName Cube name.
      * @return
      */
     public static String purgeCube(String cubeName){

         String method = "PUT";
         String para = "/cubes/"+cubeName+"/purge";
         return excute(para,method,null); 

     }

     /**
      *
      * @param jobId Job id
      * @return
      */
     public static String resumeJob(String jobId){

         String method = "PUT";
         String para = "/jobs/"+jobId+"/resume";
         return excute(para,method,null); 

     }

     /**
      * startTime - required long Start timestamp of data to build, e.g. 1388563200000 for 2014-1-1
      * endTime - required long End timestamp of data to build
      * buildType - required string Supported build type: ‘BUILD’, ‘MERGE’, ‘REFRESH’
      * @param cubeName  Cube name.
      * @return
      */
     public static String buildCube(String cubeName,String body){
         String method = "PUT";
         String para = "/cubes/"+cubeName+"/rebuild";

         return excute(para,method,body);
     }

     /**
      *
      * @param jobId  Job id.
      * @return
      */
     public static String discardJob(String jobId){

         String method = "PUT";
         String para = "/jobs/"+jobId+"/cancel";
         return excute(para,method,null); 

     }

     /**
      *
      * @param jobId  Job id.
      * @return
      */
     public static String getJobStatus(String jobId){

         String method = "GET";
         String para = "/jobs/"+jobId;
         return excute(para,method,null); 

     }

     /**
      *
      * @param jobId Job id.
      * @param stepId  Step id; the step id is composed by jobId with step sequence id;
      * for example, the jobId is “fb479e54-837f-49a2-b457-651fc50be110”, its 3rd step id
      * is “fb479e54-837f-49a2-b457-651fc50be110-3”,
      * @return
      */
     public static String getJobStepOutput(String jobId,String stepId){
         String method = "GET";
         String para = "/"+jobId+"/steps/"+stepId+"/output";
         return excute(para,method,null);
     }

     /**
      *
      * @param tableName table name to find.
      * @return
      */
     public static String getHiveTable(String tableName){
         String method = "GET";
         String para = "/tables/"+tableName;
         return excute(para,method,null);
     }

     /**
      *
      * @param tableName  table name to find.
      * @return
      */
     public static String getHiveTableInfo(String tableName){
         String method = "GET";
         String para = "/tables/"+tableName+"/exd-map";
         return excute(para,method,null);
     }

     /**
      *
      * @param projectName will list all tables in the project.
      * @param extOptional boolean set true to get extend info of table.
      * @return
      */
     public static String getHiveTables(String projectName,boolean extOptional){
         String method = "GET";
         String para = "/tables?project="+projectName+"&ext="+extOptional;
         return excute(para,method,null);
     }

     /**
      *
      * @param tables  table names you want to load from hive, separated with comma.
      * @param project the project which the tables will be loaded into.
      * @return
      */
     public static String loadHiveTables(String tables,String project){
         String method = "POST";
         String para = "/tables/"+tables+"/"+project;
         return excute(para,method,null);
     }

     /**
      *
      * @param type ‘METADATA’ or ‘CUBE’
      * @param name  Cache key, e.g the cube name.
      * @param action ‘create’, ‘update’ or ‘drop’
      * @return
      */
     public static String wipeCache(String type,String name,String action){
         String method = "POST";
         String para = "/cache/"+type+"/"+name+"/"+action;
         return excute(para,method,null);
     }

     public static String query(String body){
         String  method = "POST";
         String para = "/query";

         return excute(para,method,body);
     }

     private  static String excute(String para,String method,String body){

         StringBuilder out = new StringBuilder();
         try {
             URL url = new URL(baseURL+para);
             HttpURLConnection connection = (HttpURLConnection) url.openConnection();
             connection.setRequestMethod(method);
             connection.setDoOutput(true);
             connection.setRequestProperty  ("Authorization", "Basic " + encoding);
             connection.setRequestProperty("Content-Type","application/json");
             if(body !=null){
                 byte[] outputInBytes = body.getBytes("UTF-8");
                 OutputStream os = connection.getOutputStream();
                 os.write(outputInBytes);
                 os.close();
             }
             InputStream content = (InputStream)connection.getInputStream();
             BufferedReader in  = new BufferedReader (new InputStreamReader (content));
             String line;
             while ((line = in.readLine()) != null) {
                 out.append(line);
             }
             in.close();
             connection.disconnect();

         } catch(Exception e) {
             e.printStackTrace();
         }
         return out.toString();
     }
 }

参考:

http://kylin.apache.org/docs15/howto/howto_use_restapi.html#authentication