/*_############################################################################
  _## 
  _##  SNMP4J-Agent 3 - PropertyMOInput.java  
  _## 
  _##  Copyright (C) 2005-2026  Frank Fock (SNMP4J.org)
  _##  
  _##  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 org.snmp4j.agent.io.prop;

import java.io.*;
import java.text.ParseException;
import java.util.*;
import java.util.Map.Entry;

import org.snmp4j.SNMP4JSettings;
import org.snmp4j.agent.AgentConfigManager;
import org.snmp4j.agent.io.*;
import org.snmp4j.smi.*;
import org.snmp4j.agent.mo.util.VariableProvider;
import org.snmp4j.log.LogAdapter;
import org.snmp4j.log.LogFactory;
import org.snmp4j.util.OIDTextFormat;
import org.snmp4j.util.SimpleOIDTextFormat;

import java.util.regex.Pattern;
import java.util.regex.Matcher;

/**
 * The {@code PropertyMOInput} can be used to load MIB data from a properties file.
 * <p>
 * The format of the properties file is as follows:
 * </p>
 * <pre>
 *   snmp4j.agent.cfg.contexts={s|x}&lt;context1&gt;[,{s|x}&lt;context2&gt;...]
 *   snmp4j.agent.cfg.oid[.ctx.&lt;context&gt;].&lt;oid&gt;=[&lt;numRows&gt;:&lt;numCols&gt;]
 *   snmp4j.agent.cfg.oid[.ctx.&lt;context&gt;].&lt;oid&gt;=[{&lt;format&gt;}&lt;value&gt;]
 *   snmp4j.agent.cfg.index[.ctx.&lt;context&gt;].oid.&lt;rowIndex&gt;={o}&lt;index&gt;
 *   snmp4j.agent.cfg.value[.ctx.&lt;context&gt;].oid.&lt;rowIndex&gt;.&lt;colIndex&gt;=[{&lt;format&gt;}&lt;value&gt;]
 * </pre>
 * where text enclosed in [] is optional and
 * <ul>
 * <li>context1 - is a SNMPv3 context name as UTF-8 string (format {s}) or
 * a hexadecimal string (format {x}).
 * </li>
 * <li>context - is a SNMPv3 context name as UTF-8 string if that string does
 * not contain any ISO control characters, otherwise a hexdecimal representation separated by a colon (:).
 * </li>
 * <li>format - one of
 * <ul>
 * <li>u - an Unsigned32 value.</li>
 * <li>i - an Integer32 value.</li>
 * <li>s - an OctetString value.</li>
 * <li>x - an OctetString value in hexadecimal format (separated by :).</li>
 * <li>R[:LENGTH] - an OctetString value generated randomly.</li>
 * <li>r[:LENGTH] - a printable OctetString value generated randomly with a specified length.
 * The value is used as an index for generated random values, thus the first random value with that name can
 * be reused in later configurations. The random values will be printed to stdout on INFO level in clear text ('r' or hex 'R').
 * If the SNMP4JSettings.isSecretLoggingEnabled() is false, the random values will be printed to stderr in clear text.</li>
 * <li>d - an OctetString value in decimal format (separated by .).</li>
 * <li>b - an OctetString value in decimal format (separated by ' ' per byte).</li>
 * <li>n - a Null value.</li>
 * <li>o - an OID value as dotted string where string parts may be specified
 * directly enclosed in single quotes (') and the to an OID converted value of a variable/oid instance may be specified
 * in the format {@code [#]{&lt;name/oid&gt;}}. The value of the variable will be included into the OID with prependend
 * length if the # is used in the format string otherwise no length will be included.</li>
 * <li>t - a TimeTicks value as an unsigned long value.</li>
 * <li>a - a IpAddress value.</li>
 * <li>$ - gets the value from the variable or object instance specified by the
 * name/oid following the $.</li>
 * </ul>
 * </li>
 * <li>value - a variable value in the format specified by {@code format}.
 * </li>
 * <li>numRows - the number of rows in the table.</li>
 * <li>numCols - the number of columns in the table.</li>
 * <li>rowIndex - the row index as a zero based unsigned integer.</li>
 * <li>colIndex - the column index as a zero based unsigned integer.</li>
 * <li>index - the OID value of the row's index.</li>
 * </ul>
 * <p>
 * An example properties file is:
 * </p>
 * <pre>
 * snmp4j.agent.cfg.contexts=
 * snmp4j.agent.cfg.oid.1.3.6.1.2.1.1.2.0={o}1.3.6.1.4.1.4976
 * snmp4j.agent.cfg.oid.1.3.6.1.2.1.1.4.0={s}System Administrator
 * snmp4j.agent.cfg.oid.1.3.6.1.2.1.1.6.0={s}&lt;edit location&gt;
 * snmp4j.agent.cfg.oid.1.3.6.1.2.1.1.7.0={i}10
 * snmp4j.agent.cfg.oid.1.3.6.1.2.1.1.9.1=1:2
 * snmp4j.agent.cfg.index.1.3.6.1.2.1.1.9.1.0={o}1
 * snmp4j.agent.cfg.value.1.3.6.1.2.1.1.9.1.0.0={o}1.3.6.1.4.1.4976.10.1.1.100.4.1
 * snmp4j.agent.cfg.value.1.3.6.1.2.1.1.9.1.0.1=
 * ## VACM MIB
 * # security2Group
 * snmp4j.agent.cfg.oid.1.3.6.1.6.3.16.1.2.1=2:3
 * snmp4j.agent.cfg.index.1.3.6.1.6.3.16.1.2.1.0={o}2.6.'public'
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.2.1.0.0={s}v1v2cgroup
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.2.1.0.1={i}4
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.2.1.0.2={i}1
 * snmp4j.agent.cfg.index.1.3.6.1.6.3.16.1.2.1.1={o}3.6.'SHADES'
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.2.1.1.0={s}v3group
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.2.1.1.1={i}4
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.2.1.1.2={i}1
 * # access
 * snmp4j.agent.cfg.oid.1.3.6.1.6.3.16.1.4.1=2:6
 * snmp4j.agent.cfg.index.1.3.6.1.6.3.16.1.4.1.0={o}10.'v1v2cgroup'.0.2.1
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.4.1.0.0={i}1
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.4.1.0.1={s}unrestrictedReadView
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.4.1.0.2={s}unrestrictedWriteView
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.4.1.0.3={s}unrestrictedNotifyView
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.4.1.0.4={i}4
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.4.1.0.5={i}1
 * snmp4j.agent.cfg.index.1.3.6.1.6.3.16.1.4.1.1={o}7.'v3group'.0.3.3
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.4.1.1.0={i}1
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.4.1.1.1={s}unrestrictedReadView
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.4.1.1.2={s}unrestrictedWriteView
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.4.1.1.3={s}unrestrictedNotifyView
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.4.1.1.4={i}4
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.4.1.1.5={i}1
 * # view trees
 * snmp4j.agent.cfg.oid.1.3.6.1.6.3.16.1.5.2.1=3:4
 * snmp4j.agent.cfg.index.1.3.6.1.6.3.16.1.5.2.1.0={o}20.'unrestrictedReadView'.3.1.3.6
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.5.2.1.0.0={s}
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.5.2.1.0.1={i}1
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.5.2.1.0.2={i}4
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.5.2.1.0.3={i}1
 * snmp4j.agent.cfg.index.1.3.6.1.6.3.16.1.5.2.1.1={o}21.'unrestrictedWriteView'.3.1.3.6
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.5.2.1.1.0={s}
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.5.2.1.1.1={i}1
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.5.2.1.1.2={i}4
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.5.2.1.1.3={i}1
 * snmp4j.agent.cfg.index.1.3.6.1.6.3.16.1.5.2.1.2={o}22.'unrestrictedNotifyView'.3.1.3.6
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.5.2.1.2.0={s}
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.5.2.1.2.1={i}1
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.5.2.1.2.2={i}4
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.16.1.5.2.1.2.3={i}1
 * ## SNMP community MIB
 * snmp4j.agent.cfg.oid.1.3.6.1.6.3.18.1.1.1=1:7
 * snmp4j.agent.cfg.index.1.3.6.1.6.3.18.1.1.1.0={o}'public'
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.18.1.1.1.0.0={s}public
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.18.1.1.1.0.1={s}public
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.18.1.1.1.0.2={$1.3.6.1.6.3.10.2.1.1.0}
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.18.1.1.1.0.3={s}
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.18.1.1.1.0.4={s}
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.18.1.1.1.0.5={i}4
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.18.1.1.1.0.6={i}1
 * ## USM MIB
 * snmp4j.agent.cfg.oid.1.3.6.1.6.3.15.1.2.2.1=1:14
 * snmp4j.agent.cfg.index.1.3.6.1.6.3.15.1.2.2.1.0={o}$#{1.3.6.1.6.3.10.2.1.1.0}.6.'SHADES'
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.15.1.2.2.1.0.0={s}SHADES
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.15.1.2.2.1.0.1={o}
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.15.1.2.2.1.0.2={o}1.3.6.1.6.3.10.1.1.3
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.15.1.2.2.1.0.3={s}
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.15.1.2.2.1.0.4={s}
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.15.1.2.2.1.0.5={o}1.3.6.1.6.3.10.1.2.2
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.15.1.2.2.1.0.6={s}
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.15.1.2.2.1.0.7={s}
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.15.1.2.2.1.0.8={s}
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.15.1.2.2.1.0.9={i}4
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.15.1.2.2.1.0.10={i}1
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.15.1.2.2.1.0.11={r:16}
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.15.1.2.2.1.0.12={s}SHADESPrivPassword
 * snmp4j.agent.cfg.value.1.3.6.1.6.3.15.1.2.2.1.0.13=
 *
 * </pre>
 *
 * @author Frank Fock
 * @version 3.12.0
 */
public class PropertyMOInput implements MOInput {

    private static final LogAdapter logger = LogFactory.getLogger(PropertyMOInput.class);
    private static final LogAdapter randomValueLogger =
            LogFactory.getLogger(PropertyMOInput.class.getName() + ".RANDOM_VALUE");

    public static final String CONFIG_PREFIX = "snmp4j.agent.cfg.";
    public static final String CONTEXTS_ID = "contexts";
    public static final String OID_ID = "oid.";
    public static final String INDEX_ID = "index.";
    public static final String VERSION_ID = "version.";
    public static final String CTX_ID = "ctx.";
    public static final String VALUE_ID = "value.";

    private static final int STATE_ALL_CTX_DATA_SEQ = 0;
    private static final int STATE_ALL_CTX_DATA = 1;
    private static final int STATE_CTX_SEQ = 2;
    private static final int STATE_CTX_DATA_SEQ = 3;
    private static final int STATE_CTX_DATA = 4;

    private int importMode = ImportMode.RESTORE_CHANGES;

    private int state = STATE_ALL_CTX_DATA_SEQ;
    private final SortedMap<String, String> properties;
    private final ContextInfo contexts;
    private OIDInfo oids;
    private DataInfo<?> data;
    private VariableProvider variables;
    private OIDTextFormat oidTextFormat = new SimpleOIDTextFormat();

    private final Random random = new Random();
    private int randomOctetStringDefaultLength = 32;
    private final HashMap<String, OctetString> randomOctetStrings = new HashMap<>();

    public PropertyMOInput(Properties props) {
        properties = scanProperties(props);
        contexts = scanContexts(properties);
    }

    public PropertyMOInput(Properties props, VariableProvider variables) {
        this(props);
        this.variables = variables;
    }

    public PropertyMOInput(Properties props, VariableProvider variables, OIDTextFormat oidTextFormat) {
        this(props, variables);
        this.oidTextFormat = oidTextFormat;
    }

    public PropertyMOInput(Properties props, VariableProvider variables, ImportMode importMode) {
        this(props, variables);
        this.importMode = importMode.ordinal();
    }

    /**
     * Sets the OID text format to be used when parsing OIDs from properties files.
     * Default is {@link SimpleOIDTextFormat}
     * @param oidTextFormat
     *    an OID text format.
     * @since 3.5.4
     */
    public void setOidTextFormat(OIDTextFormat oidTextFormat) {
        this.oidTextFormat = oidTextFormat;
    }

    private ContextInfo scanContexts(Map<String, String> properties) {
        String ctx = properties.get(CONFIG_PREFIX + CONTEXTS_ID);
        StringTokenizer st = new StringTokenizer(ctx, ",");
        ArrayList<Context> l = new ArrayList<>(st.countTokens());
        while (st.hasMoreTokens()) {
            String token = st.nextToken();
            OctetString s = (OctetString)
                    createVariableFromString(token, OctetString.class);
            l.add(new Context(s));
        }
        return new ContextInfo(l.size(), l.iterator());
    }

    private OIDInfo scanOIDs(SortedMap<String, String> properties, OctetString ctx) {
        String prefix = CONFIG_PREFIX + OID_ID;
        String ctxPrefix = prefix+CTX_ID;
        String ctxSuffix = "";
        if (ctx != null) {
            ctxSuffix = CTX_ID + ctx + ".";
        }
        prefix += ctxSuffix;
        SortedMap<String, String> oids = properties.tailMap(prefix);
        ArrayList<MOInfo> l = new ArrayList<MOInfo>();
        for (Entry<String, String> e : oids.entrySet()) {
            String k = e.getKey();
            if (k.startsWith(prefix)) {
                String oid;
                oid = k.substring(prefix.length());
                String version = properties.get(CONFIG_PREFIX + VERSION_ID + ctxSuffix);
                if (k.startsWith(ctxPrefix)) {
                    String oidContext = k.substring(ctxPrefix.length(), k.indexOf('.', ctxPrefix.length()));
                    if (!(new OctetString(oidContext).equals(ctx))) {
                        continue;
                    }
                }
                OID oidInfo = parseOidWithReferenceResolving(oid);
                l.add(new MOInfo(oidInfo, version));
            } else {
                break;
            }
        }
        return new OIDInfo(ctx, l.size(), l.iterator());
    }

    private OID parseOidWithReferenceResolving(String oid) {
        OID oidInfo;
        try {
            oidInfo = parseOID(oid);
        } catch (Exception ex) {
            oidInfo = parseOID(resolveOidReference(oid));
        }
        return oidInfo;
    }

    private OID parseOID(String oid) {
        try {
            return new OID(oidTextFormat.parse(oid));
        } catch (ParseException pex) {
            throw new RuntimeException("OID '" + oid + "' cannot be parsed", pex);
        }
    }

    private void scanDataVariable(SortedMap<String, String> properties, OID oid, DataInfo<Variable> dataInfo) {
        String prefix = CONFIG_PREFIX + OID_ID;
        String ctxSuffix = "";
        if (dataInfo.context != null) {
            ctxSuffix = CTX_ID + dataInfo.context + ".";
        }
        prefix += ctxSuffix;
        prefix += oid.toDottedString();
        String value = properties.get(prefix);
        Variable v = createVariableFromString(value, Variable.class);
        dataInfo.add(v);
    }

    private void scanDataIndexVariables(SortedMap<String, String> properties, OID oid,
                                        DataInfo<IndexedVariables> dataInfo) {
        String prefix = CONFIG_PREFIX;
        String ctxSuffix = "";
        if (dataInfo.context != null) {
            ctxSuffix = CTX_ID + dataInfo.context + ".";
        }
        prefix += OID_ID + ctxSuffix;
        prefix += oid.toDottedString();
        String dimension = properties.get(prefix);
        if (dimension == null) {
            return;
        }
        StringTokenizer st = new StringTokenizer(dimension, ": ");
        int rows = Integer.parseInt(st.nextToken());
        int cols = Integer.parseInt(st.nextToken());
        String indexPrefix = CONFIG_PREFIX + INDEX_ID + ctxSuffix + oid.toDottedString();
        String valuePrefix = CONFIG_PREFIX + VALUE_ID + ctxSuffix + oid.toDottedString();
        for (int i = 0; i < rows; i++) {
            String indexString = properties.get(indexPrefix + "." + i);
            OID index = (OID) createVariableFromString(indexString, OID.class);
            Variable[] v = new Variable[cols];
            for (int j = 0; j < cols; j++) {
                String val = properties.get(valuePrefix + "." + i + "." + j);
                if (val != null) {
                    v[j] = createVariableFromString(val, Variable.class);
                }
            }
            dataInfo.add(new IndexedVariables(index, v));
        }
    }

    /**
     * Scans the supplied properties for config relevant properties and stores them into the returned LinkedHashMap.
     *
     * @param props
     *         a set of properties.
     *
     * @return a LinkedHashMap with properties whose key starts with {@link #CONFIG_PREFIX}.
     */
    private static SortedMap<String, String> scanProperties(Properties props) {
        SortedMap<String, String> map = new TreeMap<String, String>();
        for (Entry<Object, Object> e : props.entrySet()) {
            if (e.getKey().toString().startsWith(CONFIG_PREFIX)) {
                map.put(e.getKey().toString(), e.getValue().toString());
            }
        }
        return map;
    }

    /**
     * Returns the update mode, which might be one of the constants defined by {@link ImportMode}. By default, {@link
     * ImportMode#RESTORE_CHANGES} is returned.
     *
     * @return the constant denoting the update mode that should be used by a
     * {@code SerializableManagedObject} to import its content from
     * persistent storage.
     */
    public int getImportMode() {
        return importMode;
    }

    /**
     * Sets the {@link ImportMode} to be used when importing. By default, {@link ImportMode#RESTORE_CHANGES} is used.
     * @param importMode
     *    one of the integer constants defined by {@link ImportMode} defining how {@code SerializableManagedObject}
     *    should import its content from properties.
     * @since 3.5.4
     */
    public void setImportMode(int importMode) {
        this.importMode = importMode;
    }

    public Context readContext() throws IOException {
        if ((state <= STATE_CTX_SEQ) && (contexts != null)) {
            if (state < STATE_CTX_SEQ) {
                state = STATE_CTX_SEQ;
            }
            return contexts.next();
        } else if (state > STATE_CTX_DATA) {
            throw new IOException();
        }
        return contexts != null ? contexts.next() : null;
    }

    public IndexedVariables readIndexedVariables() throws IOException {
        if (data == null) {
            DataInfo<IndexedVariables> indexedVariablesDataInfo = new DataInfo<IndexedVariables>(oids.curContext);
            data = indexedVariablesDataInfo;
            scanDataIndexVariables(properties, oids.curOID.getOID(), indexedVariablesDataInfo);
        }
        IndexedVariables ivar = (IndexedVariables) data.next();
        if (logger.isDebugEnabled()) {
            logger.debug("Read indexed variables " + ivar + " for OID " +
                    oids.curOID.getOID() + " in context " + oids.curContext);
        }
        return ivar;
    }

    public MOInfo readManagedObject() throws IOException {
        MOInfo info = oids.next();
        data = null;
        if (logger.isDebugEnabled()) {
            logger.debug("Read MO " + info);
        }
        return info;
    }

    public Sequence readSequence() throws IOException {
        switch (state) {
            case STATE_ALL_CTX_DATA_SEQ: {
                state++;
                oids = scanOIDs(properties, null);
                return new Sequence(oids.numElements);
            }
            case STATE_ALL_CTX_DATA:
                if (data != null && !oids.iterator.hasNext()) {
                    state++;
                    // fall through
                } else {
                    DataInfo<IndexedVariables> indexedVariablesDataInfo = new DataInfo<IndexedVariables>(oids.curContext);
                    data = indexedVariablesDataInfo;
                    scanDataIndexVariables(properties, oids.curOID.getOID(), indexedVariablesDataInfo);
                    return new Sequence(data.size());
                }
            case STATE_CTX_SEQ: {
                state++;
                return new Sequence(contexts.numContexts);
            }
            case STATE_CTX_DATA_SEQ: {
                state++;
                oids = scanOIDs(properties, contexts.curContext.getContext());
                return new Sequence(oids.numElements);
            }
            case STATE_CTX_DATA:
                if (data != null && !oids.iterator.hasNext()) {
                    oids = scanOIDs(properties, contexts.curContext.getContext());
                    return new Sequence(oids.numElements);
                } else {
                    DataInfo<IndexedVariables> indexedVariablesDataInfo = new DataInfo<>(oids.curContext);
                    data = indexedVariablesDataInfo;
                    scanDataIndexVariables(properties, oids.curOID.getOID(), indexedVariablesDataInfo);
                    return new Sequence(data.size());
                }

        }
        return null;
    }

    public Variable readVariable() throws IOException {
        if (data == null) {
            DataInfo<Variable> variableDataInfo = new DataInfo<Variable>(oids.curContext);
            data = variableDataInfo;
            scanDataVariable(properties, oids.curOID.getOID(), variableDataInfo);
        }
        Variable v = (Variable) data.next();
        if (logger.isDebugEnabled()) {
            logger.debug("Read variable " + v + " for OID " + oids.curOID.getOID() +
                    " in context " + oids.curContext);
        }
        return v;
    }

    public void skipContext(Context context) throws IOException {

    }

    public void skipManagedObject(MOInfo mo) throws IOException {
    }

    /**
     * Parses a string of the format
     * <pre>
     * OID={type}value where &lt;type&gt; is one of
     * the following single characters enclosed by '{' and '}':
     *  i                     Integer32
     *  u                     UnsignedInteger32, Gauge32
     *  s                     OCTET STRING
     *  x                     OCTET STRING specified as hex string where
     *                        bytes separated by colons (':').
     *  r[:length]            Random (printable) OctetString with specified length.
     *  R[:length]            Random (full 8bit) OctetString with specified length.
     *  d                     OCTET STRING specified as decimal string
     *                        where bytes are separated by dots ('.').
     *  n                     Null
     *  o                     OBJECT IDENTIFIER
     *  t                     TimeTicks
     *  a                     IpAddress
     *  b                     OCTET STRING specified as binary string where
     *                        bytes are separated by spaces.
     *  $&lt;variableName&gt;     where &lt;variableName&gt; is the name of a predefined
     *                        variable or the OID of a variable of the agent's
     *                        MIB.
     * </pre>
     * and returns the corresponding variable.
     *
     * @param value
     *         the variable value string.
     * @param returnType
     *         the expected Variable class to return.
     *
     * @return {@code null} if {@code value} is {@code null} and the {@code Variable} corresponding to {@code value}
     * otherwise.
     */
    public Variable createVariableFromString(String value, Class<? extends Variable> returnType) {
        if (value != null) {
            char type = ' ';
            String varName = null;
            String randomLength = null;
            if (value.length() >= 3) {
                type = value.charAt(1);
                int pos = value.indexOf('}');
                if (type == '$') {
                    varName = value.substring(2, pos);
                }
                if ((type == 'r' || type == 'R') && (pos > 2) && (value.charAt(2) == ':')) {
                    randomLength = value.substring(3, pos);
                }
                value = value.substring(pos + 1);
            }
            Variable variable;
            switch (type) {
                case 'i':
                    variable = new Integer32(Integer.parseInt(value));
                    break;
                case 'u':
                    variable = new UnsignedInteger32(Long.parseLong(value));
                    break;
                case 's':
                    variable = new OctetString(value);
                    break;
                case 'r':
                case 'R':
                    String randomValueName = value;
                    if (randomOctetStrings.containsKey(randomValueName)) {
                        variable = randomOctetStrings.get(randomValueName);
                        break;
                    }
                    int randomOctetStringLength = (randomLength == null) ?
                        randomOctetStringDefaultLength : Integer.parseInt(randomLength);
                    byte[] randomOctets = new byte[randomOctetStringLength];
                    if (type == 'r') {
                        // printable random OctetString: ASCII printable characters from '!' (33) to '~' (126)
                        for (int i = 0; i < randomOctets.length; i++) {
                            randomOctets[i] = (byte) ('!' + random.nextInt('~' - '!' + 1));
                        }
                    } else {
                        // full 8-bit random OctetString
                        random.nextBytes(randomOctets);
                    }
                    OctetString randomOctetString = new OctetString(randomOctets);
                    randomOctetStrings.put(randomValueName, randomOctetString);
                    String logOutput = "Random value/secret generated ["+ randomValueName + "] = '" +
                            (type == 'r' ? randomOctetString : randomOctetString.toHexString()) + "'";
                    if (SNMP4JSettings.isSecretLoggingEnabled()) {
                        randomValueLogger.info(logOutput);
                    } else {
                        System.err.println(logOutput);
                    }
                    variable = randomOctetString;
                    break;
                case 'x':
                    variable = OctetString.fromString(value, ':', 16);
                    break;
                case 'd':
                    variable = OctetString.fromString(value, '.', 10);
                    break;
                case 'b':
                    variable = OctetString.fromString(value, ' ', 2);
                    break;
                case 'n':
                    variable = new Null();
                    break;
                case 'o':
                    variable = parseOidWithReferenceResolving(value);
                    break;
                case 't':
                    variable = new TimeTicks(Long.parseLong(value));
                    break;
                case 'a':
                    variable = new IpAddress(value);
                    break;
                case '$':
                    variable = (this.variables == null) ?
                            null : this.variables.getVariable(varName);
                    break;
                case ' ':
                    return null;
                default:
                    throw new IllegalArgumentException("Variable type " + type + " not supported");
            }
            if (!returnType.isInstance(variable)) {
                /**@todo make conversion*/
            }
            return variable;
        }
        return null;
    }

    private String resolveOidReference(String value) {
        Pattern p = Pattern.compile("(\\$#?\\{[^}]*})");
        Matcher m = p.matcher(value);
        StringBuilder result = new StringBuilder();
        while (m.find()) {
            String group = m.group();
            boolean impliedLength = group.charAt(1) != '#';
            group = group.substring(group.indexOf('{') + 1, group.length() - 1);
            Variable replacementValue = (this.variables == null) ?
                    new OID() : this.variables.getVariable(group);
            if (replacementValue != null) {
                OID oid = replacementValue.toSubIndex(impliedLength);
                m.appendReplacement(result, oid.toDottedString());
            }
        }
        m.appendTail(result);
        return result.toString();
    }

    public void close() throws IOException {
    }

    public int getRandomOctetStringDefaultLength() {
        return randomOctetStringDefaultLength;
    }

    public void setRandomOctetStringDefaultLength(int randomOctetStringDefaultLength) {
        this.randomOctetStringDefaultLength = randomOctetStringDefaultLength;
    }

    /**
     * Predefines a named random value (secret) that will be used instead of generating a new random
     * {@code OctetString} when a {@code {r}name} or {@code {R}name} value with the same {@code name} is
     * encountered while parsing the configuration. This method has to be called before the deserialization
     * (reading) process begins, i.e., before this {@code PropertyMOInput} is passed to a
     * {@link org.snmp4j.agent.io.MOServerPersistence} or {@link org.snmp4j.agent.AgentConfigManager}.
     * <p>
     * This allows externally provided secrets (for example pass keys supplied on the command line) to be
     * injected into the configuration by referencing them by name in the properties file.
     *
     * @param name
     *    the name of the random value as referenced by a {@code {r}name}/{@code {R}name} value.
     * @param value
     *    the predefined value to use for that name. A {@code null} value removes any predefined value.
     * @since 3.9.0
     */
    public void setRandomValue(String name, OctetString value) {
        if (value == null) {
            randomOctetStrings.remove(name);
        } else {
            randomOctetStrings.put(name, value);
        }
    }

    /**
     * Returns the (predefined or generated) named random value with the given name.
     *
     * @param name
     *    the name of the random value.
     * @return
     *    the {@code OctetString} associated with {@code name}, or {@code null} if no such value has been
     *    predefined or generated yet.
     * @since 3.9.0
     */
    public OctetString getRandomValue(String name) {
        return randomOctetStrings.get(name);
    }

    /**
     * Returns an unmodifiable view of all named random values (predefined and generated so far).
     *
     * @return
     *    an unmodifiable map from name to {@code OctetString} value.
     * @since 3.9.0
     */
    public Map<String, OctetString> getRandomValues() {
        return Collections.unmodifiableMap(randomOctetStrings);
    }

    private class ContextInfo implements Iterator<Context> {
        int numContexts;
        Context curContext;
        Iterator<Context> iterator;

        ContextInfo(int numContexts, Iterator<Context> contexts) {
            this.numContexts = numContexts;
            this.iterator = contexts;
        }

        public void remove() {
            throw new UnsupportedOperationException();
        }

        public boolean hasNext() {
            return iterator.hasNext();
        }

        public Context next() {
            curContext = iterator.next();
            return curContext;
        }
    }

    private static class OIDInfo implements Iterator<MOInfo> {
        int numElements;
        MOInfo curOID;
        OctetString curContext;
        Iterator<MOInfo> iterator;

        OIDInfo(OctetString context, int numElements, Iterator<MOInfo> data) {
            this.numElements = numElements;
            this.iterator = data;
            this.curContext = context;
        }

        public void remove() {
            throw new UnsupportedOperationException();
        }

        public boolean hasNext() {
            return iterator.hasNext();
        }

        public MOInfo next() {
            curOID = iterator.next();
            return curOID;
        }
    }

    private static class DataInfo<T> implements Iterator<T> {
        OctetString context;
        List<T> data = new ArrayList<T>();
        Iterator<T> iterator;

        DataInfo(OctetString context) {
            this.context = context;
        }

        public void add(T element) {
            data.add(element);
        }

        public void remove() {
            throw new UnsupportedOperationException();
        }

        private void initIterator() {
            if (iterator == null) {
                iterator = data.iterator();
            }
        }

        public boolean hasNext() {
            initIterator();
            return iterator.hasNext();
        }

        public T next() {
            initIterator();
            return iterator.next();
        }

        public int size() {
            return data.size();
        }
    }

}
