< 文档首页
全部产品
弹性计算
存储服务
数据库
网络
视频与CDN
域名与网站
工商财税 知识产权
应用服务
互联网中间件
移动研发平台 EMAS
移动研发平台EMAS-专有云
云通信
安全
大数据
人工智能
ET大脑
物联网
物联网行业方案
数字金融
管理与监控
区块链
云市场
API与工具
解决方案
钉钉
会员服务
专有云
更多

    Java 运行环境

    更新时间：2020-03-31 10:59:37

    ★ 我的收藏
    本页目录

    函数计算目前支持 Java OpenJDK 1.8.0 (runtime = java8) 运行环境，本文介绍了 Java 运行环境的以下内容：

    打印日志

    函数通过 context.getLogger() 打印的内容会被收集到在创建服务时指定的 LogStore 中。

    1. package example;
    3. import com.aliyun.fc.runtime.Context;
    4. import com.aliyun.fc.runtime.StreamRequestHandler;
    6. import java.io.IOException;
    7. import java.io.InputStream;
    8. import java.io.OutputStream;
    10. public class HelloFC implements StreamRequestHandler {
    12.     @Override
    13.     public void handleRequest(
    14.             InputStream inputStream, OutputStream outputStream, Context context) throws IOException {
    16.         context.getLogger().info("hello world");
    17.         outputStream.write(new String("hello world").getBytes());
    18.     }
    19. }

    执行上面的代码输出的日志内容如下所示。

    1. message:2017-07-05T05:13:35.920Z a72df088-f738-cee3-e0fe-323ad89118e5 [INFO] hello world

    使用 context.getLogger().warn 和 context.getLogger().error 分别可以打包 WARN、ERROR 级别的日志。

    错误处理

    您的函数如果在执行过程抛出异常，函数计算会把异常捕获并将异常信息返回。

    1. package example;
    3. import com.aliyun.fc.runtime.Context;
    4. import com.aliyun.fc.runtime.StreamRequestHandler;
    6. import java.io.IOException;
    7. import java.io.InputStream;
    8. import java.io.OutputStream;
    10. public class HelloFC implements StreamRequestHandler {
    12.     @Override
    13.     public void handleRequest(InputStream inputStream, OutputStream outputStream, Context context) throws IOException {
    14.         throw new IOException("oops");
    15.     }
    16. }

    调用时收到的响应如下所示。

    1. >>> invk hello-java -f /tmp/a.json
    2. {
    3.   "errorMessage" : "oops",
    4.   "errorType" : "java.io.IOException",
    5.   "errorCause" : "oops",
    6.   "stackTrace" : [ "example.HelloFC.handleRequest(HelloFC.java:15)" ]
    7. }
    8. Error: Request id: 45dd8d90-6b78-cce3-087c-8bf4ebc6c9af. Error type: UnhandledInvocationError

    发生异常时，函数调用的响应的HTTP header 中会包含 X-Fc-Error-Type: UnhandledInvocationError。

    错误类型的更多信息，请参见错误类型。

    使用自定义模块

    如果您需要使用自定义的模块，则需要在打包 jar 时，将它们与代码一起打包。下文演示如何将 OSS Java SDK 打包到项目中。

    环境准备

    确保您已经安装 Java 和 Maven。您可以通过官网下载安装合适您系统的 JDK。
    Maven 安装详情请参见 Installing Apache Maven。

    使用 maven 命令安装依赖并打包上传

    1.创建一个 Java 项目，目录结构如下。

    1. test/src/main/java/example/App.java

    2.在 App.java 文件内输入如下内容。

    1. package example;
    3. import java.io.IOException;
    4. import java.io.InputStream;
    5. import java.io.OutputStream;
    7. import com.aliyun.fc.runtime.Context;
    8. import com.aliyun.fc.runtime.StreamRequestHandler;
    9. import com.aliyun.fc.runtime.FunctionInitializer;
    11. /**
    12.  * Hello world!
    13.  *
    14.  */
    15. public class App implements StreamRequestHandler, FunctionInitializer {
    17.     public void initialize(Context context) throws IOException {
    18.     }
    20.     public void handleRequest(
    21.             InputStream inputStream, OutputStream outputStream, Context context) throws IOException {
    22.         outputStream.write(new String("hello world\n").getBytes());
    23.     }
    24. }

    3.在项目文件夹根目录下创建 pom.xml 文件，在 pom.xml 中添加 maven-assembly-plugin 插件内容如下。

    1. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    2.   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    3.   <modelVersion>4.0.0</modelVersion>
    4.   <groupId>example</groupId>
    5.   <artifactId>Java-example</artifactId>
    6.   <packaging>jar</packaging>
    7.   <version>1.0-SNAPSHOT</version>
    8.   <name>Java-example</name>
    10.   <properties>
    11.     <maven.compiler.target>1.8</maven.compiler.target>
    12.     <maven.compiler.source>1.8</maven.compiler.source>
    13.     <maven.test.skip>true</maven.test.skip>
    14.   </properties>
    15. <build>
    16.   <plugins>
    17.       <plugin>
    18.           <artifactId>maven-assembly-plugin</artifactId>
    19.           <version>3.1.0</version>
    20.           <configuration>
    21.               <descriptorRefs>
    22.                   <descriptorRef>jar-with-dependencies</descriptorRef>
    23.               </descriptorRefs>
    24.               <appendAssemblyId>false</appendAssemblyId> <!-- this is used for not append id to the jar name -->
    25.           </configuration>
    26.           <executions>
    27.               <execution>
    28.                   <id>make-assembly</id> <!-- this is used for inheritance merges -->
    29.                   <phase>package</phase> <!-- bind to the packaging phase -->
    30.                   <goals>
    31.                       <goal>single</goal>
    32.                   </goals>
    33.               </execution>
    34.           </executions>
    35.       </plugin>
    36.       <plugin>
    37.           <groupId>org.apache.maven.plugins</groupId>
    38.           <artifactId>maven-compiler-plugin</artifactId>
    39.           <configuration>
    40.               <source>1.8</source>
    41.               <target>1.8</target>
    42.           </configuration>
    43.       </plugin>
    44.   </plugins>
    45.   </build>
    46. </project>

    4.项目需要引用 Maven Central 的外部包，可以根据需要添加依赖，下文以 OSS Java SDK 为例，pom.xml 文件内容如下。

    1. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    2.   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    3.   <modelVersion>4.0.0</modelVersion>
    4.   <groupId>example</groupId>
    5.   <artifactId>Java-example</artifactId>
    6.   <packaging>jar</packaging>
    7.   <version>1.0-SNAPSHOT</version>
    8.   <name>Java-example</name>
    10.   <dependencies>
    11.     <dependency>
    12.       <groupId>com.aliyun.fc.runtime</groupId>
    13.       <artifactId>fc-java-core</artifactId>
    14.       <version>1.3.0</version>
    15.     </dependency>
    16.     <dependency>
    17.      <groupId>com.aliyun.oss</groupId>
    18.      <artifactId>aliyun-sdk-oss</artifactId>
    19.      <version>2.6.1</version>
    20.    </dependency>
    21.   </dependencies>
    23.   <properties>
    24.     <maven.compiler.target>1.8</maven.compiler.target>
    25.     <maven.compiler.source>1.8</maven.compiler.source>
    26.     <maven.test.skip>true</maven.test.skip>
    27.   </properties>
    28. <build>
    29.   <plugins>
    30.       <plugin>
    31.           <artifactId>maven-assembly-plugin</artifactId>
    32.           <version>3.1.0</version>
    33.           <configuration>
    34.               <descriptorRefs>
    35.                   <descriptorRef>jar-with-dependencies</descriptorRef>
    36.               </descriptorRefs>
    37.               <appendAssemblyId>false</appendAssemblyId> <!-- this is used for not append id to the jar name -->
    38.           </configuration>
    39.           <executions>
    40.               <execution>
    41.                   <id>make-assembly</id> <!-- this is used for inheritance merges -->
    42.                   <phase>package</phase> <!-- bind to the packaging phase -->
    43.                   <goals>
    44.                       <goal>single</goal>
    45.                   </goals>
    46.               </execution>
    47.           </executions>
    48.       </plugin>
    49.       <plugin>
    50.           <groupId>org.apache.maven.plugins</groupId>
    51.           <artifactId>maven-compiler-plugin</artifactId>
    52.           <configuration>
    53.               <source>1.8</source>
    54.               <target>1.8</target>
    55.           </configuration>
    56.       </plugin>
    57.   </plugins>
    58.   </build>
    59. </project>

    5.在项目的根目录下执行mvn package命令打包，编译输出类似如下。

    1. $mvn package
    2. [INFO] Scanning for projects...
    3.  ...  ....   ....
    4. [INFO] --------------------------< example:example >---------------------------
    5. [INFO] Building Java-example 1.0-SNAPSHOT
    6. [INFO] --------------------------------[ jar ]---------------------------------
    7.  ...  ....   ....
    8. [INFO] ------------------------------------------------------------------------
    9. [INFO] BUILD SUCCESS
    10. [INFO] ------------------------------------------------------------------------
    11. [INFO] Total time:  11.681 s
    12. [INFO] Finished at: 2020-03-26T15:55:05+08:00
    13. [INFO] ------------------------------------------------------------------------

    如果显示编译失败，请根据输出的编译错误信息调整代码。
    编译后的 jar 包位于项目文件夹内的 target 目录内，并根据 pom.xml 内的 artifactId、version 字段命名为 Java-example-1.0-SNAPSHOT.jar。
    6.您通过函数计算控制台代码执行页面，选择 OSS 上传或者代码包上传方式上传上述步骤打包的 jar 包。

    您也可以使用 maven-shade-plugin 插件进行打包。
    通常上述的打包能够满足大多数的使用场景。但是如果您想把某些没有被 Maven 管理 JAR 包打入到最终的 JAR 中，比如您在 resources/lib 下引入的其他非 Maven 仓库中的 JAR，此时可以使用 maven-jar-plugin 和 maven-dependency-plugin 插件将其打入最终的 JAR 中。

    使用 IDEA 安装依赖并打包上传

    1. 本地创建 Java 项目，pom.xml 文件内容如下。
    1. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    2.   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    3.   <modelVersion>4.0.0</modelVersion>
    4.   <groupId>example</groupId>
    5.   <artifactId>Java-example</artifactId>
    6.   <packaging>jar</packaging>
    7.   <version>1.0-SNAPSHOT</version>
    8.   <name>Java-example</name>
    9.   <dependencies>
    10.     <dependency>
    11.       <groupId>com.aliyun.fc.runtime</groupId>
    12.       <artifactId>fc-java-core</artifactId>
    13.       <version>1.3.0</version>
    14.     </dependency>
    15.     <dependency>
    16.      <groupId>com.aliyun.oss</groupId>
    17.      <artifactId>aliyun-sdk-oss</artifactId>
    18.      <version>2.6.1</version>
    19.    </dependency>
    20.   </dependencies>
    21. </project>

    2.IDEA 导出 jar 包相关配置。

    • 选择 File -> Project Structure 。
    • 在弹出的窗口中左侧选中 Artifacts，单击 + 选择 JAR，然后选择 from modules with dependencies。
    • 在配置窗口中使用默认配置就好，直接单击 OK。
    • 回到 IDEA 的主菜单，选择 Build - Build Artifacts 下的Build 或者 Rebuild 即可生成 jar 包。

    3.您可以在项目根目录下 out/artifacts/example_jar 目录中将导出的 jar 包上传函数计算。
    您通过函数计算控制台代码执行页面，选择 OSS 上传或者代码包上传方式上传导出的 jar 包。

    使用 Fun 工具打包部署

    如果您使用 Fun 部署应用，可以使用 fun build 命令来构建。fun build 的详细信息，请参见使用 fun build 构建代码包。

    1.在工程的根目录下创建 template.yml 文件，内容如下。

    1. ROSTemplateFormatVersion: '2015-09-01'
    2. Transform: 'Aliyun::Serverless-2018-04-03'
    3. Resources:
    4.   JavaDemo:
    5.     Type: 'Aliyun::Serverless::Service'
    6.     Properties:
    7.       Description: 'helloworld'
    8.     test:
    9.       Type: 'Aliyun::Serverless::Function'
    10.       Properties:
    11.         Handler: example.App::handleRequest
    12.         Initializer: example.App::initialize
    13.         Runtime: java8
    14.         CodeUri: './'

    2.执行以下命令将工程打包。

    1. $fun build
    2. using template: template.yml
    3. start building function dependencies without docker
    5. building JavaDemo/test
    6. running task flow MavenTaskFlow
    7. running task: MavenCompileTask
    8. running task: MavenCopyDependencies
    9. running task: CopyMavenArtifacts
    11. Build Success
    13. Built artifacts: .fun/build/artifacts
    14. Built template: .fun/build/artifacts/template.yml
    16. Tips for next step
    17. ======================
    18. * Invoke Event Function: fun local invoke
    19. * Invoke Http Function: fun local start
    20. * Deploy Resources: fun deploy

    3.执行以下命令部署函数。

    1. $fun deploy -y
    2. using template: .fun/build/artifacts/template.yml
    3. using region: cn-qingdao
    4. using accountId: ***********3743
    5. using accessKeyId: ***********Ptgk
    6. using timeout: 60
    8. Collecting your services information, in order to caculate devlopment changes...
    10. Resources Changes(Beta version! Only FC resources changes will be displayed):
    12. ***********
    14. Waiting for service JavaDemo to be deployed...
    15.         Waiting for function test to be deployed...
    16.                 Waiting for packaging function test code...
    17.                 The function test has been packaged. A total of 3 files were compressed and the final size was 330.35 KB
    18.         function test deploy success
    19. service JavaDemo deploy success


    登录函数计算控制台，即可看到相关的服务、函数被创建成功，且触发执行可以返回正确的结果。

    上一篇：Java Initializer 函数
    下一篇：C# 事件函数
    相关文档