com.wl4g.infra.common.store.MapStore Maven / Gradle / Ivy
/*
* Copyright 2017 ~ 2025 the original author or authors. James Wong James Wong
*
* 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.wl4g.infra.common.store;
import java.io.Serializable;
import java.nio.charset.StandardCharsets;
import java.util.Iterator;
import java.util.Map.Entry;
import java.util.concurrent.Callable;
/**
* {@link MapStore}
*
* @author James Wong <[email protected], [email protected]>
* @version 2022-05-12 v3.0.0
* @since v1.0.0
*/
public interface MapStore {
Object getOriginalStore();
/**
* Returns an iterator over elements of entry data.
*
* @return
*/
Iterator> iterator();
/**
* Returns the value associated with {@code key} in this cache, or
* {@code null} if there is no cached value for {@code key}.
*
* @since 11.0
*/
T get(String key);
/**
* Associates {@code value} with {@code key} in this cache. If the cache
* previously contained a value associated with {@code key}, the old value
* is replaced by {@code value}.
*
*
* Prefer {@link #get(Serializable, Callable)} when using the conventional
* "if cached, return; otherwise create, cache and return" pattern.
*
* @since 11.0
*/
Boolean put(String key, T value);
/** Remove any cached value for key {@code key}. */
Long remove(String key);
/**
* Remove all entries in the cache.
*/
Boolean removeAll();
/** Returns the approximate number of entries in this cache. */
Long size();
static String copyHeadSerializableoString(byte[] value) {
byte[] head = new byte[64];
System.arraycopy(value, 0, head, 0, Math.min(value.length, head.length));
return new String(head, StandardCharsets.UTF_8);
}
}