Notes on Java

Last updated: 2020-07-10 10:45:18

    SCF provides a Java 8 runtime environment.

    As the Java language can be executed in JVM only after compilation, it is used in SCF in a different way from scripting languages such as Python and Node.js, with the following restrictions:

    • Code upload is not supported: when Java is used, only developed, compiled, and packaged zip/jar packages can be uploaded. The SCF environment does not provide Java compiling capability.
    • Online editing is not supported: since code cannot be uploaded, online editing of code is not supported. The code page of a Java runtime function only lists the ways to upload the code through the page or submit the code through COS.

    Code Format

    The code form of a SCF function developed in Java is generally as follows:

    package example;
    
    public class Hello {
        public String mainHandler(KeyValueClass kv) {
            System.out.println("Hello world!");
            System.out.println(String.format("key1 = %s", kv.getKey1()));
            System.out.println(String.format("key2 = %s", kv.getKey2()));
            return String.format("Hello World");
        }
    }

    Create the parameter KeyValueClass class:

    package example;
    public class KeyValueClass {
        String key1;
        String key2;
    
        public String getKey1() {
            return this.key1;
        }   
        public void setKey1(String key1) {
            this.key1 = key1;
        }   
        public String getKey2() {
            return this.key2;
        }   
        public void setKey2(String key2) {
            this.key2 = key2;
        }   
    
        public KeyValueClass() {
        }   
    }

    Execution Method

    As Java has the concept of package, its execution method is different from other languages and requires package information. The corresponding execution method in the code example is example.Hello::mainHandler, where example is identified as the Java package, Hello the class, and mainHandler the class method.

    Deployment Package Upload

    You can create a zip deployment package with Gradle or create a jar deployment package with Maven. Then, you can upload the created package (if less than 10 MB) directly in the SCF Console, or upload it to a COS bucket and then specify the bucket and object information in the SCF Console.

    Input Parameters and Returns

    In the sample code, the input parameters used by mainHandler have two types: String and Context, and the return is in String type. The former type of the input parameters identifies the event input parameter, while the latter the function runtime information. Currently, types supported for event input parameters and function returns include Java base types and POJO type; the function runtime is currently in com.qcloud.scf.runtime.Context type, and its associated library files can be downloaded here.

    • Types supported for event input and return parameters
      • Java base types, including eight basic types and wrapper classes (byte, int, short, long, float, double, char, and boolen) and String type.
      • POJO (Plain Old Java Object) type. You should use variable POJOs and public getters and setters to provide implementations of the corresponding types in the code.
    • Context input parameters
      • To use Context, you need to use com.qcloud.scf.runtime.Context; in the code to import the package and include the jar package when it is packaged.
      • If this object is not used, you can ignore it in the function input parameters, which can be written as public String mainHandler(String name).

    The event structures of input parameters passed in by certain triggers have been defined and can be used directly. You can get and use the Java libraries through the Cloud Event Definition. If you have any questions during use, you can submit an issue or ticket for assistance.

    Log

    You can use the following statements in the program to output a log:

    System.out.println("Hello world!");

    You can also use java.util.logging.Logger as the log output:

    Logger logger = Logger.getLogger("AnyLoggerName");
    logger.setLevel(Level.INFO);
    logger.info("logging message here!");

    The output can be viewed at the log position in the function log.

    Test

    You can click the test button on the console page to open the testing page, trigger a function in real time, and view the execution result. For the sample code, since the input parameters are in String name string type, you need to enter the string content such as "Tencent Cloud" when you trigger and execute it on the testing page.
    If you modify the sample code and expect to receive JSON input parameters in a more complex format, you can use POJO type parameters to define the corresponding data structures in the code. When the SCF platform passes the corresponding JSON parameters to the entry function, it will convert them into an object instance, which can be used directly by the code.

    For more information on how to use relevant features, please see the following documents:

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help