fix(interactive): Support Http Gremlin Service (#4394)

<!--
Thanks for your contribution! please review
https://github.com/alibaba/GraphScope/blob/main/CONTRIBUTING.md before
opening an issue.
-->

## What do these changes do?
1. Support sending Gremlin queries via HTTP requests. Clients can submit
queries using curl as shown below:

```
curl -X POST \
    -H "Connection: close" \
    -H "Content-Type: application/json" \
    -d '{"gremlin": "g.V().limit(2)"}' \
    http://localhost:8182/gremlin
```

The response will be in JSON format like:

```
{"requestId":"bb66ad80-336d-4541-8bd3-de0a40451436","status":{"message":"","code":200,"attributes":{"@type":"g:Map","@value":[]}},"result":{"data":{"@type":"g:List","@value":[{"@type":"g:Vertex","@value":{"id":{"@type":"g:Int64","@value":1},"label":"person"}},{"@type":"g:Vertex","@value":{"id":{"@type":"g:Int64","@value":2},"label":"person"}}]},"meta":{"@type":"g:Map","@value":[]}}}
```

If error occurs, the error message with the error code will be returned
in json format like:

```
{"requestId":"1882cbfd-a0b4-419d-924e-2ca3a63e209a","status":{"message":"ErrorCode: GREMLIN_INVALID_RESULT\nMessage: getKeyName fail code is TableNotExistError, msg is entity label_id 2 is not found\nEC: 03-0108\nQueryId: 9132153615669087179\n","code":500,"attributes":{"@type":"g:Map","@value":[]}},"result":{"data":null,"meta":{"@type":"g:Map","@value":[]}}}
```

2. The HTTP API also supports streaming results using HTTP Chunked
Transfer Encoding. You can use curl or other SDKs to check the streamed
results.

3. If the Gremlin service requires authentication, the request must
include the Authorization header, as shown below:

```
curl -X POST \
    -H "Authorization: Basic YWRtaW46YWRtaW4=" \
    -H "Connection: close" \
    -H "Content-Type: application/json" \
    -d '{"gremlin": "g.V().limit(5)"}' \
    http://localhost:8182/gremlin
```

The expected format for the Authorization header is:

```
Authorization: Basic <Base64(user:password)>
```

In this example, `YWRtaW46YWRtaW4=` is the Base64 encoding of
`admin:admin`.

<!-- Please give a short brief about these changes. -->

## Related issue number

<!-- Are there any issues opened that will be resolved by merging this
change? -->

Fixes

Author: shirly121

interactive_engine/compiler/src/main/java/com/alibaba/graphscope/gremlin/auth/IrAuthenticationHandler.java

@@ -28,6 +28,8 @@
 import io.netty.channel.Channel;
 import io.netty.channel.ChannelHandler;
 import io.netty.channel.ChannelHandlerContext;
+import io.netty.handler.codec.http.FullHttpMessage;
+import io.netty.handler.codec.http.HttpResponseStatus;
 import io.netty.util.Attribute;
 import io.netty.util.AttributeMap;
 
@@ -42,6 +44,7 @@
 import org.apache.tinkerpop.gremlin.server.auth.Authenticator;
 import org.apache.tinkerpop.gremlin.server.authz.Authorizer;
 import org.apache.tinkerpop.gremlin.server.handler.AbstractAuthenticationHandler;
+import org.apache.tinkerpop.gremlin.server.handler.HttpHandlerUtils;
 import org.apache.tinkerpop.gremlin.server.handler.SaslAuthenticationHandler;
 import org.apache.tinkerpop.gremlin.server.handler.StateKey;
 import org.slf4j.Logger;
@@ -50,6 +53,7 @@
 import java.net.InetAddress;
 import java.net.InetSocketAddress;
 import java.net.SocketAddress;
+import java.nio.charset.Charset;
 import java.util.Base64;
 import java.util.HashMap;
 import java.util.Map;
@@ -205,9 +209,70 @@ public void channelRead(final ChannelHandlerContext ctx, final Object msg) throw
                     ctx.writeAndFlush(error);
                 }
             }
+        } else if (msg instanceof FullHttpMessage) { // add Authentication for HTTP requests
+            FullHttpMessage request = (FullHttpMessage) msg;
+
+            if (!authenticator.requireAuthentication()) {
+                ctx.fireChannelRead(request);
+                return;
+            }
+
+            String errorMsg =
+                    "Invalid HTTP Header for Authentication. Expected format: 'Authorization: Basic"
+                            + " <Base64(user:password)>'";
+
+            if (!request.headers().contains("Authorization")) {
+                sendError(ctx, errorMsg, request);
+                return;
+            }
+
+            String authorizationHeader = request.headers().get("Authorization");
+            if (!authorizationHeader.startsWith("Basic ")) {
+                sendError(ctx, errorMsg, request);
+                return;
+            }
+
+            String authorization;
+            byte[] decodedUserPass;
+            try {
+                authorization = authorizationHeader.substring("Basic ".length());
+                decodedUserPass = BASE64_DECODER.decode(authorization);
+            } catch (Exception e) {
+                sendError(ctx, errorMsg, request);
+                return;
+            }
+
+            authorization = new String(decodedUserPass, Charset.forName("UTF-8"));
+            String[] split = authorization.split(":");
+            if (split.length != 2) {
+                sendError(
+                        ctx,
+                        "Invalid username or password after decoding the Base64 Authorization"
+                                + " header.",
+                        request);
+                return;
+            }
+
+            Map<String, String> credentials = new HashMap();
+            credentials.put("username", split[0]);
+            credentials.put("password", split[1]);
+            String address = ctx.channel().remoteAddress().toString();
+            if (address.startsWith("/") && address.length() > 1) {
+                address = address.substring(1);
+            }
+
+            credentials.put("address", address);
+
+            try {
+                AuthenticatedUser user = authenticator.authenticate(credentials);
+                ctx.channel().attr(StateKey.AUTHENTICATED_USER).set(user);
+                ctx.fireChannelRead(request);
+            } catch (AuthenticationException e) {
+                sendError(ctx, e.getMessage(), request);
+            }
         } else {
             logger.warn(
-                    "{} only processes RequestMessage instances - received {} - channel closing",
+                    "{} received invalid request message {} - channel closing",
                     this.getClass().getSimpleName(),
                     msg.getClass());
             ctx.close();
@@ -226,4 +291,17 @@ private InetAddress getRemoteInetAddress(final ChannelHandlerContext ctx) {
 
         return ((InetSocketAddress) genericSocketAddr).getAddress();
     }
+
+    private void sendError(
+            final ChannelHandlerContext ctx, String errorMsg, FullHttpMessage request) {
+        HttpHandlerUtils.sendError(ctx, HttpResponseStatus.UNAUTHORIZED, errorMsg, false);
+        if (request.refCnt() > 0) {
+            boolean fullyReleased = request.release();
+            if (!fullyReleased) {
+                logger.warn(
+                        "http request message was not fully released, may cause a"
+                                + " memory leak");
+            }
+        }
+    }
 }

interactive_engine/compiler/src/main/java/com/alibaba/graphscope/gremlin/plugin/processor/HttpContext.java

@@ -0,0 +1,109 @@
+/*
+ *
+ *  * Copyright 2020 Alibaba Group Holding Limited.
+ *  *
+ *  * Licensed under the Apache License, Version 2.0 (the "License");
+ *  * you may not use this file except in compliance with the License.
+ *  * You may obtain a copy of the License at
+ *  *
+ *  * http://www.apache.org/licenses/LICENSE-2.0
+ *  *
+ *  * Unless required by applicable law or agreed to in writing, software
+ *  * distributed under the License is distributed on an "AS IS" BASIS,
+ *  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  * See the License for the specific language governing permissions and
+ *  * limitations under the License.
+ *
+ */
+
+package com.alibaba.graphscope.gremlin.plugin.processor;
+
+import io.netty.buffer.ByteBuf;
+import io.netty.buffer.Unpooled;
+import io.netty.channel.ChannelFuture;
+import io.netty.channel.ChannelFutureListener;
+import io.netty.channel.ChannelHandlerContext;
+import io.netty.handler.codec.http.DefaultFullHttpResponse;
+import io.netty.handler.codec.http.FullHttpResponse;
+import io.netty.handler.codec.http.HttpResponseStatus;
+import io.netty.handler.codec.http.HttpVersion;
+
+import org.apache.tinkerpop.gremlin.driver.message.RequestMessage;
+import org.apache.tinkerpop.gremlin.driver.message.ResponseMessage;
+import org.apache.tinkerpop.gremlin.driver.message.ResponseStatusCode;
+import org.apache.tinkerpop.gremlin.driver.ser.MessageTextSerializer;
+import org.apache.tinkerpop.gremlin.groovy.engine.GremlinExecutor;
+import org.apache.tinkerpop.gremlin.server.Context;
+import org.apache.tinkerpop.gremlin.server.GraphManager;
+import org.apache.tinkerpop.gremlin.server.Settings;
+import org.apache.tinkerpop.gremlin.server.handler.HttpHandlerUtils;
+import org.javatuples.Pair;
+
+import java.nio.charset.StandardCharsets;
+import java.util.Objects;
+import java.util.concurrent.ScheduledExecutorService;
+import java.util.concurrent.atomic.AtomicReference;
+
+/**
+ * Maintain the gremlin execution context for http request.
+ */
+public class HttpContext extends Context {
+    private final Pair<String, MessageTextSerializer<?>> serializer;
+    private final boolean keepAlive;
+    private final AtomicReference<Boolean> finalResponse;
+
+    public HttpContext(
+            RequestMessage requestMessage,
+            ChannelHandlerContext ctx,
+            Settings settings,
+            GraphManager graphManager,
+            GremlinExecutor gremlinExecutor,
+            ScheduledExecutorService scheduledExecutorService,
+            Pair<String, MessageTextSerializer<?>> serializer,
+            boolean keepAlive) {
+        super(
+                requestMessage,
+                ctx,
+                settings,
+                graphManager,
+                gremlinExecutor,
+                scheduledExecutorService);
+        this.serializer = Objects.requireNonNull(serializer);
+        this.keepAlive = keepAlive;
+        this.finalResponse = new AtomicReference<>(false);
+    }
+
+    /**
+     * serialize the response message to http response and write to http channel.
+     * @param responseMessage
+     */
+    @Override
+    public void writeAndFlush(final ResponseMessage responseMessage) {
+        try {
+            if (finalResponse.compareAndSet(
+                    false, responseMessage.getStatus().getCode().isFinalResponse())) {
+                ByteBuf byteBuf =
+                        Unpooled.wrappedBuffer(
+                                serializer
+                                        .getValue1()
+                                        .serializeResponseAsString(responseMessage)
+                                        .getBytes(StandardCharsets.UTF_8));
+                FullHttpResponse response =
+                        new DefaultFullHttpResponse(
+                                HttpVersion.HTTP_1_1, HttpResponseStatus.OK, byteBuf);
+                ChannelFuture channelFuture =
+                        this.getChannelHandlerContext().writeAndFlush(response);
+                ResponseStatusCode statusCode = responseMessage.getStatus().getCode();
+                if (!keepAlive && statusCode.isFinalResponse()) {
+                    channelFuture.addListener(ChannelFutureListener.CLOSE);
+                }
+            }
+        } catch (Exception e) {
+            HttpHandlerUtils.sendError(
+                    this.getChannelHandlerContext(),
+                    HttpResponseStatus.INTERNAL_SERVER_ERROR,
+                    e.getMessage(),
+                    keepAlive);
+        }
+    }
+}