001/*
002Copyright 2022 The OpenFunction Authors.
003
004Licensed under the Apache License, Version 2.0 (the "License");
005you may not use this file except in compliance with the License.
006You may obtain a copy of the License at
007
008    http://www.apache.org/licenses/LICENSE-2.0
009
010Unless required by applicable law or agreed to in writing, software
011distributed under the License is distributed on an "AS IS" BASIS,
012WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013See the License for the specific language governing permissions and
014limitations under the License.
015*/
016
017package dev.openfunction.functions;
018
019import java.util.Map;
020
021public interface Plugin {
022    /**
023     * name return the name of this plugin.
024     *
025     * @return Plugin name
026     */
027    String name();
028
029    /**
030     * version return the version of this plugin.
031     *
032     * @return Plugin name
033     */
034    String version();
035
036    /**
037     * init will create a new plugin, and execute hook in this calling.
038     * If you do not want to use a new plugin to execute hook, just return `this`.
039     *
040     * @return Plugin
041     */
042    Plugin init();
043
044
045    /**
046     * execPreHook executes a hook before the function called.
047     *
048     * @param ctx Runtime context
049     * @return error
050     */
051    Error execPreHook(Context ctx);
052
053    /**
054     * execPreHook executes a hook after the function called.
055     *
056     * @param ctx Runtime context
057     * @return error
058     */
059    Error execPostHook(Context ctx);
060
061    /**
062     * get return the value of the fieldName`
063     *
064     * @param fieldName Name of member
065     * @return Object
066     */
067    Object getField(String fieldName);
068
069    Boolean needToTracing();
070
071    Map<String, String> tagsAddToTracing();
072
073}