carp84 commented on a change in pull request #9693: [FLINK-13984] Separate on-heap and off-heap managed memory pools URL: https://github.com/apache/flink/pull/9693#discussion_r335600770
########## File path: flink-runtime/src/main/java/org/apache/flink/runtime/util/KeyedBudgetManager.java ########## @@ -0,0 +1,238 @@ +/* + * 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.runtime.util; + +import org.apache.flink.types.Either; +import org.apache.flink.util.Preconditions; + +import javax.annotation.concurrent.GuardedBy; +import javax.annotation.concurrent.ThreadSafe; + +import java.util.Collections; +import java.util.HashMap; +import java.util.Map; +import java.util.Map.Entry; + +/** + * Manages {@code long} available budget per key (allocation/release). + * + * <p>This manager gets a certain maximum {@code long} budget per key. + * Users can allocate some budget for some key and release it later. + * The manager keeps track of allocated/released budget and prevents from over-allocating. + * + * <p>There is also a paged type of allocation where a certain number of pages can be allocated from a set of keys. + * The page has its budget size. The manager allocates randomly from all keys of a given set. + * At the end, sum of pages allocated from each key is either requested number of pages or none. + * Only integer number of pages are allocated from each key respecting its available budget (no page spans two or more keys) + * or nothing is allocated reporting the maximum number of pages which could be allocated per each given key at the moment. + * + * @param <K> type of the budget key + */ +@ThreadSafe +public class KeyedBudgetManager<K> { + private final Map<K, Long> maxBudgetByKey; + + private final long defaultPageSize; + + private final long totalNumberOfPages; + + @GuardedBy("lock") + private final Map<K, Long> availableBudgetByKey; + + private final Object lock = new Object(); + + public KeyedBudgetManager(Map<K, Long> maxBudgetByKey, long defaultPageSize) { + Preconditions.checkNotNull(maxBudgetByKey); + Preconditions.checkArgument(defaultPageSize > 0L, "The default page size has to be greater than zero"); + + this.maxBudgetByKey = new HashMap<>(maxBudgetByKey); + this.availableBudgetByKey = new HashMap<>(maxBudgetByKey); + this.defaultPageSize = defaultPageSize; + this.totalNumberOfPages = calculateTotalNumberOfPages(maxBudgetByKey, defaultPageSize); + } + + public long getDefaultPageSize() { + return defaultPageSize; + } + + /** + * Tries to acquire budget for a given key. + * + * <p>No budget is acquired if it was not possible to fully acquire the requested budget. + * + * @param key the key to acquire budget from + * @param size the size of budget to acquire from the given key + * @return the fully acquired budget for the key or max possible budget to acquire + * if it was not possible to acquire the requested budget. + */ + public long acquireBudgetForKey(K key, long size) { + Preconditions.checkNotNull(key); + Either<Map<K, Long>, Long> result = acquirePagedBudgetForKeys(Collections.singletonList(key), size, 1L); + return result.isLeft() ? result.left().get(key) : result.right(); + } + + /** + * Tries to acquire budget for given keys which equals to the number of pages times default page size. + * + * <p>See also {@link #acquirePagedBudgetForKeys(Iterable, long, long)} + */ + public Either<Map<K, Long>, Long> acquirePagedBudget(Iterable<K> keys, long numberOfPages) { + return acquirePagedBudgetForKeys(keys, numberOfPages, defaultPageSize); + } Review comment: Missing test coverage, suggest to add one. ---------------------------------------------------------------- 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: [email protected] With regards, Apache Git Services
