flink-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From GitBox <...@apache.org>
Subject [GitHub] [flink] xuyang1706 commented on a change in pull request #9184: [FLINK-13339][ml] Add an implementation of pipeline's api
Date Sun, 13 Oct 2019 02:53:30 GMT
xuyang1706 commented on a change in pull request #9184: [FLINK-13339][ml] Add an implementation
of pipeline's api
URL: https://github.com/apache/flink/pull/9184#discussion_r334260628
 
 

 ##########
 File path: flink-ml-parent/flink-ml-lib/src/main/java/org/apache/flink/ml/common/MLEnvironmentFactory.java
 ##########
 @@ -0,0 +1,111 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you 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 org.apache.flink.ml.common;
+
+import java.util.HashMap;
+
+/**
+ * Factory to get the MLEnvironment using a MLEnvironmentId.
+ *
+ * <p>The following code snippet shows how to interact with MLEnvironmentFactory.
+ * <pre>
+ * {@code
+ * long mlEnvId = MLEnvironmentFactory.getNewMLEnvironmentId();
+ * MLEnvironment mlEnv = MLEnvironmentFactory.get(mlEnvId);
+ * }
+ * </pre>
+ */
+public class MLEnvironmentFactory {
+
+	/**
+	 * The default MLEnvironmentId.
+	 */
+	public static final Long DEFAULT_ML_ENVIRONMENT_ID = 0L;
+
+	/**
+	 * A monotonically increasing id for the MLEnvironments.
+	 * Each id uniquely identifies an MLEnvironment.
+	 */
+	private static Long nextId = 1L;
+
+	/**
+	 * Map that hold the MLEnvironment and use the MLEnvironmentId as its key.
+	 */
+	private static final HashMap<Long, MLEnvironment> map = new HashMap<>();
+
+	static {
+		map.put(DEFAULT_ML_ENVIRONMENT_ID, new MLEnvironment());
+	}
+
+	/**
+	 * Get the MLEnvironment using a MLEnvironmentId.
+	 *
+	 * @param mlEnvId the MLEnvironmentId
+	 * @return the MLEnvironment
+	 */
+	public static synchronized MLEnvironment get(Long mlEnvId) {
+		if (!map.containsKey(mlEnvId)) {
+			throw new IllegalArgumentException(
+				String.format("Cannot find MLEnvironment for MLEnvironmentId %s." +
+					" Did you get the MLEnvironmentId by calling getNewMLEnvironmentId?", mlEnvId));
+		}
+
+		return map.get(mlEnvId);
+	}
+
+	/**
+	 * Get the MLEnvironment use the default MLEnvironmentId.
+	 *
+	 * @return the default MLEnvironment.
+	 */
+	public static synchronized MLEnvironment getDefault() {
+		return get(DEFAULT_ML_ENVIRONMENT_ID);
+	}
+
+	/**
+	 * Create a unique MLEnvironment id and register a new MLEnvironment in the factory.
+	 *
+	 * @return the MLEnvironment id.
+	 */
+	public static synchronized Long getNewMLEnvironmentId() {
+		return registerMLEnvironment(new MLEnvironment());
+	}
+
+	/**
+	 * Register a new MLEnvironment to the factory and return a new MLEnvironment id.
+	 *
+	 * @param env the MLEnvironment that will be stored in the factory.
+	 * @return the MLEnvironment id.
+	 */
+	public static synchronized Long registerMLEnvironment(MLEnvironment env) {
+		map.put(nextId, env);
+		return nextId++;
+	}
+
+	/**
+	 * Remove the MLEnvironment using the MLEnvironmentId.
+	 *
+	 * @param mlEnvId the id.
+	 * @return the removed MLEnvironment
+	 */
+	public static synchronized MLEnvironment remove(Long mlEnvId) {
 
 Review comment:
   MLEnviromentFactory can create multi MLEnviroment, if some of them only used in a time
slot, user can use this API to release the resource. In most cases, user just use default
MLEnviroment. This API is rarely used. 

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

Mime
View raw message