Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具

做为一个程序员可能在学习技术,了解行业新动态,解决问题时经常需要阅读英文的内容;而像我这样的英文小白就只能借助翻译工具才能理解个大概;不禁经常感慨,英文对学习计算机相关知识太重要了!最近发现IBM的云平台Blumemix,并且提供语言翻译的服务,感觉不错,就拿来研究学习一下;这里就分享一下我的研究学习过程,如何使用Java语言调用REST API打造自己的在线翻译工具,并演示如何把它发布到云平台上,让每个人都可以通过网络访问使用它。

应用效果展示

您可以通过点击效果图片的链接访问它。

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第1张图片

构建一个类似的应用程序的前提条件

一个 Bluemix 帐户,您还没有? 点击这里注册,已经有,点击这里登录;

对 HTML(超文本标记语言)的基本了解;

CSS (层叠样式表)的基本了解

对JavaScript(一种直译式脚本语言)的基本了解;

对Java(一种可以撰写跨平台应用程序的面向对象的程序设计语言的基本了解

apache-tomcat-8用于本地调试运行Java Web;

eclipse-jee-luna-SR2-win32-x86_64 开发工具;

Maven 3.3 项目依赖管理及打包工具;

Java SE Development Kit(JDK) Java 语言的软件开发工具包;

我提供了所有必要代码,但对这些技术的基本了解有助于您理解有关的细节。

步骤 1. 创建您的 Java 应用程序

  1. 1、在 Bluemix 用户界面中,转至“仪表板”。
  2. Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第2张图片
  3. 2、单击创建应用程序
  4. Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第3张图片
  5. 3、单击 Web,然后按照指导经验来选择入门模板,指定名称以及选择编码方式。
  6. Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第4张图片
  7. 输入应用程序名称
  8. Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第5张图片
  9. 应用程序名称是唯一的,接下来要通过它做为二级域名来访问你的应用!
  10. 点击完成之后,需要等待一会儿,然后可以看到下图的界面
  11. Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第6张图片
  12. 这时就可以访问你刚刚创建的应用了。如下图:
  13. Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第7张图片

步骤 2. 添加语言翻译服务

  1. 可以通过单击 Bluemix 用户界面中应用程序“概述”上的添加服务或 API,将服务添加到应用程序中。也可以使用 cf 命令行界面。请参阅处理应用程序的可用选项。
  2. Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第8张图片
  3. Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第9张图片
  4. Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第10张图片

获取服务信息

进入自己的应用程序》概述页面,找到已经添加的服务,点击“显示凭证”,可以查看服务的具体信息:

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第11张图片

在浏览器中访问服务URL如下图:

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第12张图片


步骤 3. 准备开发环境

Eclipes:我使用的是解压版的eclipse-jee-luna-SR2-win32-x86_64.zip,直接解压到一个目录 下就可以了;

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第13张图片

初次运行需要指定一个工作目录;

JDK:参考:Windows 7 x64环境下JDK8安装过程

Tomcat:也是解压就可以了;

Maven:Eclipse中自带的;

步骤 4.编写代码

1、下载初始Hello World示例代码

进入您的应用程序,点击左侧的开始编码,在右侧点击“下载起动器代码”。

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第14张图片

2、导入项目

将下载的示例代码解压到一个目录,不要解压到Eclipse的工作空间!

在Eclipse的项目浏览器视图上单击鼠标右键,选择导入:

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第15张图片

选择要导入的项目类型:

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第16张图片

选择项目文件位置:

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第17张图片

导入成功后如下图:

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第18张图片

3、编写代码

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第19张图片

index.html就是我们看到的首页的内容;

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第20张图片

示例还提供了一个Servlet例子;

了解了一些,相信我就不需要再多说了,上代码!

前台主要AJAX代码:调用后台的翻译Servlet,实现用户交互

//通过AJAX调用后台翻译程序
function doExecTrans(){
	var txt = $("#InputText").val();
	if (txt == ""){
		alert("请输入要翻译的文本!");
		return;
	}
	
	$("#ProgressDiv").show();
	$.ajax({
	   type: "GET",
	   url: "TransServlet",
	   dataType:"json",
	   data: {"txt":txt},
	   success: function(data){
		 $("#ProgressDiv").hide();
		 console.log(data);
		 if (data.error){
			alert(data.error);
		 }else{
			$("#OutputText").text(data.text);
		 }
	   },
	   error: function(data){
		 console.log(data);ssss
		 alert( "Error Msg: " + data );
		 $("#ProgressDiv").hide();
	   }
	});
}
后台主要代码:TransServlet,与翻译服务Web Service交互
package wasdev.sample.servlet;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.Authenticator;
import java.net.URL;

import javax.net.ssl.HttpsURLConnection;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
 * powered by: testcs_dn
 * Blog: http://blog.csdn.net/testcs_dn
 * Create time: 2015/12/12
 */

/**
 * Servlet implementation class TransServlet
 */
@WebServlet("/TransServlet")
public class TransServlet extends HttpServlet {
	private static final long serialVersionUID = 1L;

	/**
	 * 处理前台AJAX的GET请求
	 * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse
	 *      response)
	 */
	@Override
	protected void doGet(HttpServletRequest request,
			HttpServletResponse response) throws ServletException, IOException {
		response.setContentType("text/html");
		response.setCharacterEncoding("utf-8");
		
		//获取AJAX提交的需要翻译的文本
		String txt = request.getParameter("txt");
		if (txt == null || txt.length() == 0) {
			response.getWriter().print("{\"error\":\"请输入要翻译的文本!\"}");
			return;
		}
		
		//翻译服务的URL
		String servicesUrl = "https://gateway.watsonplatform.net/language-translation/api/v2/translate?source=en&target=es&text="
				+ txt;
		String errMsg = null;
		String result = "";

		BufferedReader in = null;
		try {
			URL realUrl = new URL(servicesUrl);
			
			//认证信息对象,用于包含访问翻译服务的用户名和密码
			Authenticator auth = new MyAuthenticator("c9819718-4660-441c-9df7-07398950ea44", "qUvrJPSdPgOx");
			Authenticator.setDefault(auth);
			
			// 打开和URL之间的连接
			HttpsURLConnection connection = (HttpsURLConnection)realUrl.openConnection();
			connection.setDoInput(true);  
	        connection.setDoOutput(true);//允许连接提交信息       
	        connection.setRequestMethod("GET");
	        
			// 建立实际的连接
			connection.connect();
			
			// 定义 BufferedReader输入流来读取URL的响应
			in = new BufferedReader(new InputStreamReader(
					connection.getInputStream()));
			String line;
			while ((line = in.readLine()) != null) {
				result += line;
			}
		} catch (Exception e) {
			errMsg = e.getMessage();
		}
		// 使用finally块来关闭输入流
		finally {
			try {
				if (in != null) {
					in.close();
				}
			} catch (Exception e2) {
				errMsg = e2.getMessage();
			}
		}
		
		if (errMsg != null){
			response.getWriter().print("{\"error\":\"" + errMsg + "\"}");
		}else{
			response.getWriter().print("{\"text\":\"" + result + "\"}");
		}
	}

}
认证信息对象:MyAuthenticator.java
package wasdev.sample.servlet;

import java.net.Authenticator;
import java.net.PasswordAuthentication;

/**
 * powered by: testcs_dn
 * Blog: http://blog.csdn.net/testcs_dn
 * Create time: 2015/12/12
 * 
 * 认证信息对象
 */
public class MyAuthenticator extends Authenticator{ 
	  String _userName=null; 
	  char[] _password=null; 
	    
	  public MyAuthenticator(){ 
	  } 
	  public MyAuthenticator(String username, String password) {  
	    this._userName = username;  
	    this._password = password.toCharArray();  
	  }  
	  protected PasswordAuthentication getPasswordAuthentication(){ 
	    return new PasswordAuthentication(_userName, _password); 
	  } 
}


步骤 5. 本地编译运行访问

编译运行

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第21张图片

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第22张图片

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第23张图片

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第24张图片

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第25张图片

访问

在浏览器中访问,查看效果,打开浏览器,输入:http://localhost:8080/JavaHelloWorldApp/

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第26张图片

步骤 6. 上传应用程序

注意:上传应用之前首先要对应用进行打包!

打包步骤:

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第27张图片

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第28张图片

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第29张图片

登录到 Bluemix™ 后,可以使用 cf push 命令来上传应用程序。

开始之前,您必须:
  1. 1、安装 Cloud Foundry 命令行界面。

  2. Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第30张图片
  3. 请根据自己使用的操作系统下载对应的版本;我使用的是Windows 7 64位操作系统,
  4. 下载Binaries版本的不需要安装,直接解压到Windows目录就可以了
  5. Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第31张图片
  6. 以下执行的命令你可以通过访问 https://www.ng.bluemix.net/docs/#starters/upload_app.html#upload_app__push
  7. 查看属于自己的命令;
  8. 2、连接到 Bluemix
  9. 打开命令提示符窗口:开始》运行,输入“cmd”,回车
  10. 执行:cf api https://api.ng.bluemix.net,如下图:
  11. Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第32张图片
  12. 3、登录到 Bluemix
  13. 注意,这里要换成对应你自己账户的命令!
  14.      
        
        
        
    cf login -u [email protected] -o [email protected] -s ivu4e

4、发出 cf push 命令时,cf 命令行界面将提供使用 buildpack 来构建并运行应用程序的 Bluemix 环境的工作目录。

  1. 从应用程序目录中,输入带有应用程序名称的 cf push 命令。在 Bluemix 环境中,应用程序名称必须是唯一的。
  2. 后面的"-m 512m"是修改应用程序内存配额的,可以不带这个参数,如下图:
  3. Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第33张图片
  4. 注意:执行cf push前将命令行当前目录切换到您刚刚创建的应用目录,例如我刚刚创建的
    C:\javaProject\javatrans,cf push 后面的goinfo要替换为您在Bluemix上创建的应用名称。
  5. 提示: 使用 cf push 命令时,cf 命令行界面会将当前目录中的所有文件和目录复制到 Bluemix。确保应用程序目录中只包含必需的文件。
  6. cf push 命令上传应用程序并将其部署到 Bluemix。有关 cf push 的更多信息,请参阅 cf 命令。有关 buildpack 的信息,请参阅使用社区 buildpack。

  7. 如果更改了应用程序,可以通过再次输入 cf push 命令来上传这些更改。 cf 命令行界面会使用您先前的选项以及您对提示的响应来通过新的代码段更新应用程序的任何运行中实例。
提示: 您还可以从  Bluemix DevOps Services 上传或部署应用程序。请参阅 在 Node.js 中使用 Web IDE 开发 Bluemix 应用程序。

步骤 7. 做个小小的测试

通过仪表板进入您刚刚创建的应用页面,点击左侧的开始编码,右侧顶部会显示:您的应用程序正在运行。http://javatrans.mybluemix.net/

点击后面的链接访问刚刚发布的应用。

Java中REST API使用示例——基于云平台+云服务打造自己的在线翻译工具_第34张图片

结束语

通过IBM的Bluemix云平台,我们可以轻松的将自己的应用共享到网络上;

创建Web应用之后会自动获得一个用来访问应用的二级域名;

通过应用程序概述中的应用程序运行状况,可以方便的查看和管理应用运行状态;

这里通过一个小例子展示如何将自己的应用发布到IBM的Bluemix云平台上,

如何与IBM云平台上提供的语言翻译服务交互。

如果您有更好的应用或想法,试试通过IBM的Bluemix云平台共享出来吧。

你可能感兴趣的:(java,Web,IBM,service,云平台,bluemix)