读取 Java 属性文件而不转义值

Question

我的应用程序需要使用 .properties 文件进行配置。 在属性文件中，用户可以指定路径。

问题

属性文件需要对值进行转义，例如

dir = c:\\mydir

需要

我需要某种方式来接受值未转义的属性文件，以便用户可以指定：

dir = c:\mydir

Answer 1

您可以尝试使用 guava 的 Splitter：根据 '=' 进行拆分，并根据生成的 Iterable 构建映射。

该方案的缺点是不支持注释。

Answer 2

@pdeva：还有一种解决方案

//Reads entire file in a String 
//available in java1.5
Scanner scan = new Scanner(new File("C:/workspace/Test/src/myfile.properties"));   
scan.useDelimiter("\\Z");   
String content = scan.next();

//Use apache StringEscapeUtils.escapeJava() method to escape java characters
ByteArrayInputStream bi=new ByteArrayInputStream(StringEscapeUtils.escapeJava(content).getBytes());

//load properties file
Properties properties = new Properties(); 
properties.load(bi);

Answer 3

这不是您问题的确切答案，而是可能适合您需求的不同解决方案。在 Java 中，您可以使用 / 作为路径分隔符，它适用于 Windows、Linux 和 OSX。这对于相对路径特别有用。

在您的示例中，您可以使用：

dir = c:/mydir

Answer 4

为什么不简单地扩展属性类以合并双正斜杠的剥离。这样做的一个很好的功能是，在程序的其余部分中，您仍然可以使用原始的 Properties 类。

public class PropertiesEx extends Properties {
    public void load(FileInputStream fis) throws IOException {
        Scanner in = new Scanner(fis);
        ByteArrayOutputStream out = new ByteArrayOutputStream();

        while(in.hasNext()) {
            out.write(in.nextLine().replace("\\","\\\\").getBytes());
            out.write("\n".getBytes());
        }

        InputStream is = new ByteArrayInputStream(out.toByteArray());
        super.load(is);
    }
}

使用新类很简单：

PropertiesEx p = new PropertiesEx();
p.load(new FileInputStream("C:\\temp\\demo.properties"));
p.list(System.out);

剥离代码也可以改进，但一般原则就在那里。

Answer 5

两个选项：

• 使用 XML 属性 格式改为
• 编写您自己的解析器，以获取修改后的 .properties 格式，无需转义

Answer 6

您可以在加载属性之前“预处理”文件，例如：

public InputStream preprocessPropertiesFile(String myFile) throws IOException{
    Scanner in = new Scanner(new FileReader(myFile));
    ByteArrayOutputStream out = new ByteArrayOutputStream();
    while(in.hasNext())
        out.write(in.nextLine().replace("\\","\\\\").getBytes());
    return new ByteArrayInputStream(out.toByteArray());
}

您的代码可能看起来像这样 这样

Properties properties = new Properties();
properties.load(preprocessPropertiesFile("path/myfile.properties"));

做，您的 .properties 文件将看起来像您所需要的，但您将拥有可供使用的属性值。

*我知道应该有更好的方法来操作文件，但我希望这会有所帮助。

Answer 7

正确的方法是为您的用户提供一个属性文件编辑器（或他们最喜欢的文本编辑器的插件），允许他们以纯文本形式输入文本，并将文件保存为属性文件格式。

如果您不希望这样做，那么您实际上是在为与属性文件相同（或其子集）的内容模型定义新格式。

全程指定您的格式，然后考虑一种方法，将

• 格式转换为规范格式，然后使用它来加载文件，或者
• 解析该格式并填充 < code>Properties 对象。

仅当您确实可以控制属性对象的创建时，这两种方法才能直接起作用，否则您将必须使用应用程序存储转换后的格式。

---

那么，让我们看看如何定义它。 普通属性文件的内容模型很简单：

• 字符串键到字符串值的映射，两者都允许任意 Java 字符串。

您想要避免的转义只是允许任意 Java 字符串，而不仅仅是这些字符串的子集。

通常足够的子集是：

• 字符串键（不包含任何空格、: 或 =）到字符串值（不包含任何前导或尾随空格或行）的映射休息）。

在您的示例 dir = c:\mydir 中，键为 dir ，值为 c:\mydir。

如果我们希望我们的键和值包含任何 Unicode 字符（除了提到的禁止字符），我们应该使用 UTF-8（或 UTF-16）作为存储编码 - 因为我们无法在存储之外转义字符编码。否则，US-ASCII 或 ISO-8859-1（作为普通属性文件）或 Java 支持的任何其他编码就足够了，但请确保将其包含在内容模型的规范中（并确保以这种方式阅读） ）。

由于我们限制了内容模型，以便排除所有“危险”字符，因此我们现在可以将文件格式简单地定义为：

<simplepropertyfile> ::= (<line> <line break> )*
<line>               ::= <comment> | <empty> | <key-value>
<comment>            ::= <space>* "#" < any text excluding line breaks >
<key-value>          ::= <space>* <key> <space>* "=" <space>* <value> <space>*
<empty>              ::= <space>*
<key>                ::= < any text excluding ':', '=' and whitespace >
<value>              ::= < any text starting and ending not with whitespace,
                           not including line breaks >
<space>              ::= < any whitespace, but not a line break >
<line break>         ::= < one of "\n", "\r", and "\r\n" >

键或值中出现的每个 \ 现在都是一个 真正的反斜杠，而不是任何逃避其他东西的东西。
因此，为了将其转换为原始格式，我们只需将其加倍，就像 Grekz 提出的那样，例如在过滤阅读器中：

public DoubleBackslashFilter extends FilterReader {
    private boolean bufferedBackslash = false;

    public DoubleBackslashFilter(Reader org) {
        super(org);
    }

    public int read() {
        if(bufferedBackslash) {
            bufferedBackslash = false;
            return '\\';
        }
        int c = super.read();
        if(c == '\\')
           bufferedBackslash = true;
        return c;
    }

    public int read(char[] buf, int off, int len) {
        int read = 0;
        if(bufferedBackslash) {
           buf[off] = '\\';
           read++;
           off++;
           len --;
           bufferedBackslash = false;
        }
        if(len > 1) {
           int step = super.read(buf, off, len/2);
           for(int i = 0; i < step; i++) {
               if(buf[off+i] == '\\') {
                  // shift everything from here one one char to the right.
                  System.arraycopy(buf, i, buf, i+1, step - i);
                  // adjust parameters
                  step++; i++;
               }
           }
           read += step;
        }
        return read;
    }
}

然后我们将此 Reader 传递给我们的 Properties 对象（或将内容保存到新文件中）。

相反，我们可以简单地自己解析这种格式。

public Properties parse(Reader in) {
    BufferedReader r = new BufferedReader(in);
    Properties prop = new Properties();
    Pattern keyValPattern = Pattern.compile("\s*=\s*");
    String line;
    while((line = r.readLine()) != null) {
        line = line.trim(); // remove leading and trailing space
        if(line.equals("") || line.startsWith("#")) {
            continue; // ignore empty and comment lines
        }
        String[] kv = line.split(keyValPattern, 2);
        // the pattern also grabs space around the separator.
        if(kv.length < 2) {
            // no key-value separator. TODO: Throw exception or simply ignore this line?
            continue;
        }
        prop.setProperty(kv[0], kv[1]);
    }
    r.close();
    return prop;
}

再次，在此之后使用Properties.store()，我们可以将其以原始格式导出。

Answer 8

基于@Ian Harrigan，这里是一个完整的解决方案，可以从 ascii 文本文件获取 Netbeans 属性文件（和其他转义属性文件）：

import java.io.BufferedReader;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.OutputStreamWriter;
import java.io.PrintWriter;
import java.io.Reader;
import java.io.Writer;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import java.util.Properties;

/**
 * This class allows to handle Netbeans properties file. 
 * It is based on the work of  : http://stackoverflow.com/questions/6233532/reading-java-properties-file-without-escaping-values.
 * It overrides both load methods in order to load a netbeans property file, taking into account the \ that 
 * were escaped by java properties original load methods.
 * @author stephane
 */
public class NetbeansProperties extends Properties {
    @Override
    public synchronized void load(Reader reader) throws IOException {
        BufferedReader bfr = new BufferedReader( reader );
        ByteArrayOutputStream out = new ByteArrayOutputStream();

        String readLine = null;
        while( (readLine = bfr.readLine()) != null ) {
            out.write(readLine.replace("\\","\\\\").getBytes());
            out.write("\n".getBytes());
        }//while

        InputStream is = new ByteArrayInputStream(out.toByteArray());
        super.load(is);
    }//met

    @Override
    public void load(InputStream is) throws IOException {
        load( new InputStreamReader( is ) );
    }//met

    @Override
    public void store(Writer writer, String comments) throws IOException {
        PrintWriter out = new PrintWriter( writer );
        if( comments != null ) {
            out.print( '#' );
            out.println( comments );
        }//if
        List<String> listOrderedKey = new ArrayList<String>();
        listOrderedKey.addAll( this.stringPropertyNames() );
        Collections.sort(listOrderedKey );
        for( String key : listOrderedKey ) {
            String newValue = this.getProperty(key);
            out.println( key+"="+newValue  );
       }//for
    }//met

    @Override
    public void store(OutputStream out, String comments) throws IOException {
        store( new OutputStreamWriter(out), comments );
    }//met
}//class