转：http://www.cnblogs.com/dreamfactory/p/5588203.html
最近在做大数据方面的开发, 学习研究了一段时间的kylin系统, 对于前端开发需要使用 RESTful API ,但是官网并没有提供详细的Java API. 经过几天的看文档,最终写出了 Java 的API,不敢私藏,特分享与大家.
1 import java.io.BufferedReader;2 import java.io.InputStream;3 import java.io.InputStreamReader;4 import java.io.OutputStream;5 import java.net.HttpURLConnection;6 import java.net.URL;7 8 import org.apache.commons.codec.binary.Base64; 9 10 11 12 /**13 * 14 * @author HennSun 15 * www.shareideas.net16 * @Reference17 * http://kylin.apache.org/docs15/howto/howto_use_restapi.html#authentication18 *19 */20 public class KylinHttpBasic {21 22 private static String encoding;23 private static final String baseURL = "http://10.1.50.123:7070/kylin/api";24 public static String login(String user,String passwd){25 String method = "POST";26 String para = "/user/authentication";27 byte[] key = (user+":"+passwd).getBytes();28 encoding = Base64.encodeBase64String(key);29 return excute(para,method,null);30 }31 32 33 public static String listQueryableTables(String projectName){34 35 String method = "GET";36 String para = "/tables_and_columns?project="+projectName;37 38 return excute(para,method,null);39 40 }41 42 43 /**44 * 45 * @param offset required int Offset used by pagination46 * @param limit required int Cubes per page.47 * @param cubeName optional string Keyword for cube names. To find cubes whose name contains this keyword.48 * @param projectName optional string Project name.49 * @return50 */51 public static String listCubes(int offset,52 int limit,53 String cubeName,54 String projectName ){55 String method = "GET";56 String para = "/cubes?offset="+offset57 +"&limit="+limit58 +"&cubeName="+cubeName59 +"&projectName="+projectName;60 return excute(para,method,null); 61 }62 63 /**64 * 65 * @param cubeName Cube name.66 * @return67 */68 public static String getCubeDes(String cubeName){69 String method = "GET";70 String para = "/cube_desc/"+cubeName;71 return excute(para,method,null); 72 73 }74 75 76 /**77 * 78 * @param cubeName79 * @return80 */81 public static String getCube(String cubeName){82 String method = "GET";83 String para = "/cubes/"+cubeName;84 return excute(para,method,null); 85 86 }87 88 89 90 /**91 * 92 * @param modelName Data model name, by default it should be the same with cube name.93 * @return94 */95 public static String getDataModel(String modelName){96 String method = "GET";97 String para = "/model/"+modelName;98 return excute(para,method,null); 99
100 }
101
102 /**
103 *
104 * @param cubeName cubeName Cube name.
105 * @return
106 */
107 public static String enableCube(String cubeName){
108
109 String method = "PUT";
110 String para = "/cubes/"+cubeName+"/enable";
111 return excute(para,method,null);
112
113 }
114
115 /**
116 *
117 * @param cubeName Cube name.
118 * @return
119 */
120 public static String disableCube(String cubeName){
121
122 String method = "PUT";
123 String para = "/cubes/"+cubeName+"/disable";
124 return excute(para,method,null);
125
126 }
127
128 /**
129 *
130 * @param cubeName Cube name.
131 * @return
132 */
133 public static String purgeCube(String cubeName){
134
135 String method = "PUT";
136 String para = "/cubes/"+cubeName+"/purge";
137 return excute(para,method,null);
138
139 }
140
141
142 /**
143 *
144 * @param jobId Job id
145 * @return
146 */
147 public static String resumeJob(String jobId){
148
149 String method = "PUT";
150 String para = "/jobs/"+jobId+"/resume";
151 return excute(para,method,null);
152
153 }
154
155
156 /**
157 * startTime - required long Start timestamp of data to build, e.g. 1388563200000 for 2014-1-1
158 * endTime - required long End timestamp of data to build
159 * buildType - required string Supported build type: ‘BUILD’, ‘MERGE’, ‘REFRESH’
160 * @param cubeName Cube name.
161 * @return
162 */
163 public static String buildCube(String cubeName,String body){
164 String method = "PUT";
165 String para = "/cubes/"+cubeName+"/rebuild";
166
167 return excute(para,method,body);
168 }
169
170
171 /**
172 *
173 * @param jobId Job id.
174 * @return
175 */
176 public static String discardJob(String jobId){
177
178 String method = "PUT";
179 String para = "/jobs/"+jobId+"/cancel";
180 return excute(para,method,null);
181
182 }
183
184 /**
185 *
186 * @param jobId Job id.
187 * @return
188 */
189 public static String getJobStatus(String jobId){
190
191 String method = "GET";
192 String para = "/jobs/"+jobId;
193 return excute(para,method,null);
194
195 }
196
197 /**
198 *
199 * @param jobId Job id.
200 * @param stepId Step id; the step id is composed by jobId with step sequence id;
201 * for example, the jobId is “fb479e54-837f-49a2-b457-651fc50be110”, its 3rd step id
202 * is “fb479e54-837f-49a2-b457-651fc50be110-3”,
203 * @return
204 */
205 public static String getJobStepOutput(String jobId,String stepId){
206 String method = "GET";
207 String para = "/"+jobId+"/steps/"+stepId+"/output";
208 return excute(para,method,null);
209 }
210
211 /**
212 *
213 * @param tableName table name to find.
214 * @return
215 */
216 public static String getHiveTable(String tableName){
217 String method = "GET";
218 String para = "/tables/"+tableName;
219 return excute(para,method,null);
220 }
221
222 /**
223 *
224 * @param tableName table name to find.
225 * @return
226 */
227 public static String getHiveTableInfo(String tableName){
228 String method = "GET";
229 String para = "/tables/"+tableName+"/exd-map";
230 return excute(para,method,null);
231 }
232
233
234 /**
235 *
236 * @param projectName will list all tables in the project.
237 * @param extOptional boolean set true to get extend info of table.
238 * @return
239 */
240 public static String getHiveTables(String projectName,boolean extOptional){
241 String method = "GET";
242 String para = "/tables?project="+projectName+"&ext="+extOptional;
243 return excute(para,method,null);
244 }
245
246
247 /**
248 *
249 * @param tables table names you want to load from hive, separated with comma.
250 * @param project the project which the tables will be loaded into.
251 * @return
252 */
253 public static String loadHiveTables(String tables,String project){
254 String method = "POST";
255 String para = "/tables/"+tables+"/"+project;
256 return excute(para,method,null);
257 }
258
259 /**
260 *
261 * @param type ‘METADATA’ or ‘CUBE’
262 * @param name Cache key, e.g the cube name.
263 * @param action ‘create’, ‘update’ or ‘drop’
264 * @return
265 */
266 public static String wipeCache(String type,String name,String action){
267 String method = "POST";
268 String para = "/cache/"+type+"/"+name+"/"+action;
269 return excute(para,method,null);
270 }
271
272
273 public static String query(String body){
274 String method = "POST";
275 String para = "/query";
276
277 return excute(para,method,body);
278 }
279
280
281
282 private static String excute(String para,String method,String body){
283
284 StringBuilder out = new StringBuilder();
285 try {
286 URL url = new URL(baseURL+para);
287 HttpURLConnection connection = (HttpURLConnection) url.openConnection();
288 connection.setRequestMethod(method);
289 connection.setDoOutput(true);
290 connection.setRequestProperty ("Authorization", "Basic " + encoding);
291 connection.setRequestProperty("Content-Type","application/json");
292 if(body !=null){
293 byte[] outputInBytes = body.getBytes("UTF-8");
294 OutputStream os = connection.getOutputStream();
295 os.write(outputInBytes);
296 os.close();
297 }
298 InputStream content = (InputStream)connection.getInputStream();
299 BufferedReader in = new BufferedReader (new InputStreamReader (content));
300 String line;
301 while ((line = in.readLine()) != null) {
302 out.append(line);
303 }
304 in.close();
305 connection.disconnect();
306
307 } catch(Exception e) {
308 e.printStackTrace();
309 }
310 return out.toString();
311 }
312 }
