| /* |
| * 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.sshd.common; |
| |
| import java.util.ArrayList; |
| import java.util.Collection; |
| import java.util.List; |
| import java.util.Map; |
| import java.util.Objects; |
| import java.util.Properties; |
| import java.util.Set; |
| import java.util.TreeSet; |
| |
| import org.apache.sshd.common.util.GenericUtils; |
| import org.apache.sshd.common.util.Pair; |
| |
| /** |
| * A wrapper that exposes a read-only {@link Map} access to the system |
| * properties. Any attempt to modify it will throw {@link UnsupportedOperationException}. |
| * The mapper uses the {@link #SYSPROPS_MAPPED_PREFIX} to filter and access' |
| * only these properties, ignoring all others |
| * |
| * @author <a href="mailto:dev@mina.apache.org">Apache MINA SSHD Project</a> |
| */ |
| public final class SyspropsMapWrapper implements Map<String, Object> { |
| /** |
| * Prefix of properties used by the mapper to identify SSHD related settings |
| */ |
| public static final String SYSPROPS_MAPPED_PREFIX = "org.apache.sshd.config"; |
| |
| /** |
| * The one and only wrapper instance |
| */ |
| public static final SyspropsMapWrapper INSTANCE = new SyspropsMapWrapper(); |
| |
| /** |
| * A {@link PropertyResolver} with no parent that exposes the system properties |
| */ |
| public static final PropertyResolver SYSPROPS_RESOLVER = new PropertyResolver() { |
| @Override |
| public Map<String, Object> getProperties() { |
| return SyspropsMapWrapper.INSTANCE; |
| } |
| |
| @Override |
| public PropertyResolver getParentPropertyResolver() { |
| return null; |
| } |
| |
| @Override |
| public String toString() { |
| return "SYSPROPS"; |
| } |
| }; |
| |
| private SyspropsMapWrapper() { |
| super(); |
| } |
| |
| @Override |
| public void clear() { |
| throw new UnsupportedOperationException("sysprops#clear() N/A"); |
| } |
| |
| @Override |
| public boolean containsKey(Object key) { |
| return get(key) != null; |
| } |
| |
| @Override |
| public boolean containsValue(Object value) { |
| // not the most efficient implementation, but we do not expect it to be called much |
| Properties props = System.getProperties(); |
| for (String key : props.stringPropertyNames()) { |
| if (!isMappedSyspropKey(key)) { |
| continue; |
| } |
| |
| Object v = props.getProperty(key); |
| if (Objects.equals(v, value)) { |
| return true; |
| } |
| } |
| |
| return false; |
| } |
| |
| @Override |
| public Set<Entry<String, Object>> entrySet() { |
| Properties props = System.getProperties(); |
| // return a copy in order to avoid concurrent modifications |
| Set<Entry<String, Object>> entries = |
| new TreeSet<Entry<String, Object>>(Pair.<String, Object>byKeyEntryComparator()); |
| for (String key : props.stringPropertyNames()) { |
| if (!isMappedSyspropKey(key)) { |
| continue; |
| } |
| |
| Object v = props.getProperty(key); |
| if (v != null) { |
| entries.add(new Pair<>(getUnmappedSyspropKey(key), v)); |
| } |
| } |
| |
| return entries; |
| } |
| |
| @Override |
| public Object get(Object key) { |
| return (key instanceof String) ? System.getProperty(getMappedSyspropKey(key)) : null; |
| } |
| |
| @Override |
| public boolean isEmpty() { |
| return GenericUtils.isEmpty(keySet()); |
| } |
| |
| @Override |
| public Set<String> keySet() { |
| Properties props = System.getProperties(); |
| Set<String> keys = new TreeSet<>(); |
| // filter out any non-SSHD properties |
| for (String key : props.stringPropertyNames()) { |
| if (isMappedSyspropKey(key)) { |
| keys.add(getUnmappedSyspropKey(key)); |
| } |
| } |
| |
| return keys; |
| } |
| |
| @Override |
| public Object put(String key, Object value) { |
| throw new UnsupportedOperationException("sysprops#put(" + key + ")[" + value + "] N/A"); |
| } |
| |
| @Override |
| public void putAll(Map<? extends String, ? extends Object> m) { |
| throw new UnsupportedOperationException("sysprops#putAll(" + m + ") N/A"); |
| } |
| |
| @Override |
| public Object remove(Object key) { |
| throw new UnsupportedOperationException("sysprops#remove(" + key + ") N/A"); |
| } |
| |
| @Override |
| public int size() { |
| return GenericUtils.size(keySet()); |
| } |
| |
| @Override |
| public Collection<Object> values() { |
| Properties props = System.getProperties(); |
| // return a copy in order to avoid concurrent modifications |
| List<Object> values = new ArrayList<>(props.size()); |
| for (String key : props.stringPropertyNames()) { |
| if (!isMappedSyspropKey(key)) { |
| continue; |
| } |
| Object v = props.getProperty(key); |
| if (v != null) { |
| values.add(v); |
| } |
| } |
| |
| return values; |
| } |
| |
| @Override |
| public String toString() { |
| return Objects.toString(System.getProperties(), null); |
| } |
| |
| /** |
| * @param key Key to be tested |
| * @return {@code true} if key starts with {@link #SYSPROPS_MAPPED_PREFIX} |
| * and continues with a dot followed by some characters |
| */ |
| public static boolean isMappedSyspropKey(String key) { |
| return (GenericUtils.length(key) > (SYSPROPS_MAPPED_PREFIX.length() + 1)) |
| && key.startsWith(SYSPROPS_MAPPED_PREFIX) |
| && (key.charAt(SYSPROPS_MAPPED_PREFIX.length()) == '.'); |
| } |
| |
| /** |
| * @param key Key to be transformed |
| * @return The "pure" key name if a mapped one, same as input otherwise |
| * @see #isMappedSyspropKey(String) |
| */ |
| public static String getUnmappedSyspropKey(Object key) { |
| String s = Objects.toString(key); |
| return isMappedSyspropKey(s) ? s.substring(SYSPROPS_MAPPED_PREFIX.length() + 1 /* skip dot */) : s; |
| } |
| |
| /** |
| * @param key The original key |
| * @return A key prefixed by {@link #SYSPROPS_MAPPED_PREFIX} |
| * @see #isMappedSyspropKey(String) |
| */ |
| public static String getMappedSyspropKey(Object key) { |
| return SYSPROPS_MAPPED_PREFIX + "." + key; |
| } |
| } |