001    /*
002     * Cumulus4j - Securing your data in the cloud - http://cumulus4j.org
003     * Copyright (C) 2011 NightLabs Consulting GmbH
004     *
005     * This program is free software: you can redistribute it and/or modify
006     * it under the terms of the GNU Affero General Public License as
007     * published by the Free Software Foundation, either version 3 of the
008     * License, or (at your option) any later version.
009     *
010     * This program is distributed in the hope that it will be useful,
011     * but WITHOUT ANY WARRANTY; without even the implied warranty of
012     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
013     * GNU Affero General Public License for more details.
014     *
015     * You should have received a copy of the GNU Affero General Public License
016     * along with this program.  If not, see <http://www.gnu.org/licenses/>.
017     */
018    package org.cumulus4j.keystore.prop;
019    
020    import java.nio.charset.Charset;
021    
022    /**
023     * {@link Property} implementation for the value type {@link String}.
024     *
025     * @author Marco หงุ่ยตระกูล-Schulze - marco at nightlabs dot de
026     */
027    public class StringProperty extends Property<String>
028    {
029            private static final Charset UTF8 = Charset.forName("UTF-8");
030    
031            /**
032             * {@inheritDoc}
033             * <p>
034             * The implementation in <code>StringProperty</code> returns either <code>null</code>
035             * or a UTF-8-encoded <code>String</code>-representation.
036             * </p>
037             */
038            @Override
039            public byte[] getValueEncoded()
040            {
041                    String value = getValue();
042                    if (value == null)
043                            return null;
044    
045                    return value.getBytes(UTF8);
046            }
047    
048            /**
049             * {@inheritDoc}
050             * @param encodedValue a UTF-8-encoded <code>String</code>-representation or <code>null</code>.
051             */
052            @Override
053            public void setValueEncoded(byte[] encodedValue) {
054                    if (encodedValue == null)
055                            setValue(null);
056                    else
057                            setValue(new String(encodedValue, UTF8));
058            }
059    }