621

Coming from Perl, I sure am missing the "here-document" means of creating a multi-line string in source code:

$string = <<"EOF"  # create a three-line string
text
text
text
EOF

In Java, I have to have cumbersome quotes and plus signs on every line as I concatenate my multiline string from scratch.

What are some better alternatives? Define my string in a properties file?

Edit: Two answers say StringBuilder.append() is preferable to the plus notation. Could anyone elaborate as to why they think so? It doesn't look more preferable to me at all. I'm looking for a way around the fact that multiline strings are not a first-class language construct, which means I definitely don't want to replace a first-class language construct (string concatenation with plus) with method calls.

Edit: To clarify my question further, I'm not concerned about performance at all. I'm concerned about maintainability and design issues.

20
  • 13
    StringBuilder.append() is preferable to plus when repeatedly adding to a string because every time you do string1 + string2 you're allocating a new string object and copying the characters from both of the input strings. If you're adding n Strings together you'd be doing n-1 allocations and approximately (n^2)/2 character copies. StringBuilder, on the other hand, copies and reallocates less frequently (though it still does both when you exceed the size of its internal buffer). Theoretically, there are cases where the compiler could convert + to use StringBuilder but in practice who knows. May 18, 2009 at 17:18
  • 5
    Every time I jump into the debugger, + is converted to a StringBuilder.append() call, on Java 1.5. I've had colleagues confusedly tell me StringBuilder has a bug since they debug into code that does not appear to call it and wind up there.
    – skiphoppy
    May 18, 2009 at 17:34
  • 4
    See also: stackoverflow.com/questions/782810/…
    – Michael Myers
    May 18, 2009 at 17:55
  • 67
    Note that a string literal made up of "abc\n" + "def\n" etc. does not use StringBuilder: the compiler glues them together and puts them into the .class file as a single literal, same as with other types of constant folding.
    – araqnid
    May 18, 2009 at 18:00
  • 7
    Most IDEs support entering multi-line strings. ie. you just type or paste what you want into a "" string and it will add the \n and " + " as required. e.g. I can paste a 40 lines of text into a String and teh IDE sorts it out for you. Oct 24, 2010 at 12:19

43 Answers 43

564

NOTE: This answer applies to Java 14 and older.

Text blocks (multiline literals) were introduced in Java 15. See this answer for details.


It sounds like you want to do a multiline literal, which does not exist in Java.

Your best alternative is going to be strings that are just +'d together. Some other options people have mentioned (StringBuilder, String.format, String.join) would only be preferable if you started with an array of strings.

Consider this:

String s = "It was the best of times, it was the worst of times,\n"
         + "it was the age of wisdom, it was the age of foolishness,\n"
         + "it was the epoch of belief, it was the epoch of incredulity,\n"
         + "it was the season of Light, it was the season of Darkness,\n"
         + "it was the spring of hope, it was the winter of despair,\n"
         + "we had everything before us, we had nothing before us";

Versus StringBuilder:

String s = new StringBuilder()
           .append("It was the best of times, it was the worst of times,\n")
           .append("it was the age of wisdom, it was the age of foolishness,\n")
           .append("it was the epoch of belief, it was the epoch of incredulity,\n")
           .append("it was the season of Light, it was the season of Darkness,\n")
           .append("it was the spring of hope, it was the winter of despair,\n")
           .append("we had everything before us, we had nothing before us")
           .toString();

Versus String.format():

String s = String.format("%s\n%s\n%s\n%s\n%s\n%s"
         , "It was the best of times, it was the worst of times,"
         , "it was the age of wisdom, it was the age of foolishness,"
         , "it was the epoch of belief, it was the epoch of incredulity,"
         , "it was the season of Light, it was the season of Darkness,"
         , "it was the spring of hope, it was the winter of despair,"
         , "we had everything before us, we had nothing before us"
);

Versus Java8 String.join():

String s = String.join("\n"
         , "It was the best of times, it was the worst of times,"
         , "it was the age of wisdom, it was the age of foolishness,"
         , "it was the epoch of belief, it was the epoch of incredulity,"
         , "it was the season of Light, it was the season of Darkness,"
         , "it was the spring of hope, it was the winter of despair,"
         , "we had everything before us, we had nothing before us"
);

If you want the newline for your particular system, you either need to use System.lineSeparator(), or you can use %n in String.format.

Another option is to put the resource in a text file, and just read the contents of that file. This would be preferable for very large strings to avoid unnecessarily bloating your class files.

14
  • 268
    Furthermore, the first version will be automatically concatenated by the compiler, since all the strings are known at compile time. Even if the strings are not known at compile time, it's no slower than StringBuilder or String.format(). The only reason to avoid concatenation with +'s is if you're doing it in a loop.
    – Michael Myers
    May 18, 2009 at 17:06
  • 27
    The problem with the String.format version is that you have to keep the format in sync with the number of lines. Dec 14, 2010 at 12:05
  • 6
    String.format is not efficient compared to other two examples
    – cmcginty
    Dec 30, 2010 at 0:50
  • 12
    This answer is a very inappropriate solution to the question at hand. We have 2000 line SAS macros or bunches of 200 line SQL queries which we wish to copy and paste. To suggest that we use +"" concat to transform those multiline text into StringBuffer appends is ridiculous. Sep 24, 2012 at 19:44
  • 25
    @BlessedGeek: the question at hand was about what options were available in the Java language. It didn't mention anything about the type of data going into the string. If there is a better solution then you can post it as an answer. It sounds like Josh Curren's solution would be better for your situation. If you are just upset that the language doesn't support multiline literals then this is the wrong place to complain about it.
    – Kip
    Sep 24, 2012 at 20:08
193

In Eclipse if you turn on the option "Escape text when pasting into a string literal" (in Preferences > Java > Editor > Typing) and paste a multi-lined string whithin quotes, it will automatically add " and \n" + for all your lines.

String str = "paste your text here";
2
  • 19
    intelij also does this by default when you paste into ""s
    – Bob B
    Jul 14, 2014 at 14:45
  • 1
    Do you generally leave in the \rs that Eclipse puts in on Windows?
    – Noumenon
    Mar 12, 2017 at 17:57
124

JEP 378: Text Blocks covers this functionality and is included in JDK 15. It first appeared as JEP 355: Text Blocks (Preview) in JDK 13 and JEP 368: Text Blocks (Second Preview) in JDK 14 and can be enabled in these versions with the ––enable–preview javac option.

The syntax allows to write something like:

String s = """
           text
           text
           text
           """;

Previous to this JEP, in JDK 12, JEP 326: Raw String Literals aimed to implement a similar feature, but it was eventually withdrawn:

Please note: This was intended to be a preview language feature in JDK 12, but it was withdrawn and did not appear in JDK 12. It was superseded by Text Blocks (JEP 355) in JDK 13.

1
102

This is an old thread, but a new quite elegant solution (with only 4 maybe 3 little drawbacks) is to use a custom annotation.

Check : http://www.adrianwalker.org/2011/12/java-multiline-string.html

A project inspired from that work is hosted on GitHub:

https://github.com/benelog/multiline

Example of Java code:

import org.adrianwalker.multilinestring.Multiline;
...
public final class MultilineStringUsage {

  /**
  <html>
    <head/>
    <body>
      <p>
        Hello<br/>
        Multiline<br/>
        World<br/>
      </p>
    </body>
  </html>
  */
  @Multiline
  private static String html;

  public static void main(final String[] args) {
    System.out.println(html);
  }
}

The drawbacks are

  1. that you have to activate the corresponding (provided) annotation processor.
  2. that String variable can not be defined as local variable Check Raw String Literals project where you can define variables as local variables
  3. that String cannot contains other variables as in Visual Basic .Net with XML literal (<%= variable %>) :-)
  4. that String literal is delimited by JavaDoc comment (/**)

And you probably have to configure Eclipse/Intellij-Idea to not reformat automatically your Javadoc comments.

One may find this weird (Javadoc comments are not designed to embed anything other than comments), but as this lack of multiline string in Java is really annoying in the end, I find this to be the least worst solution.

7
  • Does that require the class using the multiline string to be final? Also, is any setup required when developing and executing code from Eclipse? The reference URL mentions setup requirements for Maven for annotation processing. I can't figure out what might be needed, if any in Eclipse.
    – David
    May 17, 2013 at 21:55
  • The annotation is livable - but it seems there were also a hard dependency on maven? That part takes away much of the value of heredoc's which are to simplify the management of small pieces of text. May 28, 2013 at 0:23
  • 3
    You can do this entirely in eclipse. The link that @SRG posted above points you to this link. If you are using eclipse, then a minute of setup and it is working. Sep 18, 2014 at 19:22
  • 7
    This is probably the biggest hack I have ever seen. EDIT: Nevermind... see Bob Albrights answer. Apr 18, 2018 at 3:52
  • 3
    I made an extension of this project an created a new one which local variables are supported, take a look at the project
    – deFreitas
    Feb 26, 2019 at 4:10
66

Another option may be to store long strings in an external file and read the file into a string.

10
  • 15
    Exactly. Large amounts of text don't belong in Java source; use a resource file of an appropriate format instead, loaded via a call to Class.getResource(String).
    – erickson
    May 18, 2009 at 16:51
  • 5
    Right! You can use Locale + ResourceBundle's also to easily load the I18N text, and then the String.format() call will parse the "\n"'s as newlines :) Example: String readyStr = String.parse(resourceBundle.getString("introduction"));
    – ATorras
    May 18, 2009 at 17:13
  • 69
    You shouldn't have to externalize a String just because it's multi-line. What if I have a regex that I want to break up into multiple lines with comments? It looks ugly in Java. The @ syntax for C# is much cleaner. Oct 16, 2009 at 20:45
  • 9
    Skiphoppy doesn't want to bother with the overhead of dealing with files just to use a paragraph length string constant. I use multiline strings all the time in C++, embedded in my source code, where I want them.
    – Tim Cooper
    Nov 6, 2009 at 5:35
  • 9
    Wow. I can't believe C++ is actually better than Java on this issue! I love multi-line string constants and they DO belong in source in some cases.
    – User1
    Jan 25, 2011 at 22:14
61

This is something that you should never use without thinking about what it's doing. But for one-off scripts I've used this with great success:

Example:

    System.out.println(S(/*
This is a CRAZY " ' ' " multiline string with all sorts of strange 
   characters!
*/));

Code:

// From: http://blog.efftinge.de/2008/10/multi-line-string-literals-in-java.html
// Takes a comment (/**/) and turns everything inside the comment to a string that is returned from S()
public static String S() {
    StackTraceElement element = new RuntimeException().getStackTrace()[1];
    String name = element.getClassName().replace('.', '/') + ".java";
    StringBuilder sb = new StringBuilder();
    String line = null;
    InputStream in = classLoader.getResourceAsStream(name);
    String s = convertStreamToString(in, element.getLineNumber());
    return s.substring(s.indexOf("/*")+2, s.indexOf("*/"));
}

// From http://www.kodejava.org/examples/266.html
private static String convertStreamToString(InputStream is, int lineNum) {
    /*
     * To convert the InputStream to String we use the BufferedReader.readLine()
     * method. We iterate until the BufferedReader return null which means
     * there's no more data to read. Each line will appended to a StringBuilder
     * and returned as String.
     */
    BufferedReader reader = new BufferedReader(new InputStreamReader(is));
    StringBuilder sb = new StringBuilder();

    String line = null; int i = 1;
    try {
        while ((line = reader.readLine()) != null) {
            if (i++ >= lineNum) {
                sb.append(line + "\n");
            }
        }
    } catch (IOException e) {
        e.printStackTrace();
    } finally {
        try {
            is.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    return sb.toString();
}
8
  • 18
    Requires shipping the Java code for the class with the final binary. Hmm. May 18, 2010 at 6:13
  • 29
    i can imagine my co-workers reaction when i try to check something like this in... Aug 21, 2012 at 19:25
  • 15
    +1. Some lack of imagination by persons voting down. This is a useful construct for writing small utilities, test cases, and even in controlled prod environments. This is a difference maker between dropping out of java into ruby/python/etc or staying here. May 26, 2013 at 18:55
  • 1
    Great solution, but unfortunately will not work for android since the it will be executed on emulator or real device and there is no source code there. Jul 8, 2015 at 11:56
  • 1
    dang - that's the coolest hack I have seen in years... simply brilliant... not because it's a good idea... but it's radical
    – Jim
    May 16, 2018 at 12:52
61

String.join

Java 8 added a new static method to java.lang.String which offers a slightly better alternative:

String.join( CharSequence delimiter , CharSequence... elements )

Using it:

String s = String.join(
    System.getProperty("line.separator"),
    "First line.",
    "Second line.",
    "The rest.",
    "And the last!"
);
4
  • 5
    Neat and clean solution! No dependency on IDE and preprocessor! No manual "\n" is needed, and is aware of portability! Dec 1, 2017 at 3:24
  • 1
    I understand that my comment is useless, but it is so retarted to seek hacks for such a basic thing as a multiline string literal. Why the heck cannot java still add this into the spec?
    – dmitry
    Oct 9, 2018 at 16:03
  • 2
    @dmitry it nowadays has. However, a great question is whether the use of System.getProperty("line.separator") is improving the portability or downgrading it. The Java language designers decided to always produce the same string regardless of where the code will run, in other words, to consistently use \n only. To achieve the same in older versions, such hacks like String.join(…) where never necessary, "First line.\n" + "Second line.\n" + "The rest.\n" + "And the last!\n" did the job and could be generated by the IDE automatically when pasting text into the string…
    – Holger
    Jan 4, 2022 at 14:36
  • @Holger Good that it finally happened (however where I write java I'm still stuck with an older version). Regarding line separator I can imagine that it can matter in some applications but in general I used multiline literals for many things in Scala, Python or wherever they were available and never even gave it a second thought because there never were any issues with this. :)
    – dmitry
    Jan 4, 2022 at 16:17
45

Java 13 and beyond

Multiline Strings are now supported in Java via Text Blocks. In Java 13 and 14, this feature requires you to set the ––enable–preview option when building and running your project. In Java 15 and later, this option is no longer required as Text Blocks have become a standard feature. Check out the official Programmer's Guide to Text Blocks for more details.

Now, prior to Java 13, this is how you'd write a query:

List<Tuple> posts = entityManager
.createNativeQuery(
    "SELECT *\n" +
    "FROM (\n" +
    "    SELECT *,\n" +
    "           dense_rank() OVER (\n" +
    "               ORDER BY \"p.created_on\", \"p.id\"\n" +
    "           ) rank\n" +
    "    FROM (\n" +
    "        SELECT p.id AS \"p.id\",\n" +
    "               p.created_on AS \"p.created_on\",\n" +
    "               p.title AS \"p.title\",\n" +
    "               pc.id as \"pc.id\",\n" +
    "               pc.created_on AS \"pc.created_on\",\n" +
    "               pc.review AS \"pc.review\",\n" +
    "               pc.post_id AS \"pc.post_id\"\n" +
    "        FROM post p\n" +
    "        LEFT JOIN post_comment pc ON p.id = pc.post_id\n" +
    "        WHERE p.title LIKE :titlePattern\n" +
    "        ORDER BY p.created_on\n" +
    "    ) p_pc\n" +
    ") p_pc_r\n" +
    "WHERE p_pc_r.rank <= :rank\n",
    Tuple.class)
.setParameter("titlePattern", "High-Performance Java Persistence %")
.setParameter("rank", 5)
.getResultList();

Thanks to Java 13 Text Blocks, you can rewrite this query as follows:

List<Tuple> posts = entityManager
.createNativeQuery("""
    SELECT *
    FROM (
        SELECT *,
               dense_rank() OVER (
                   ORDER BY "p.created_on", "p.id"
               ) rank
        FROM (
            SELECT p.id AS "p.id",
                   p.created_on AS "p.created_on",
                   p.title AS "p.title",
                   pc.id as "pc.id",
                   pc.created_on AS "pc.created_on",
                   pc.review AS "pc.review",
                   pc.post_id AS "pc.post_id"
            FROM post p
            LEFT JOIN post_comment pc ON p.id = pc.post_id
            WHERE p.title LIKE :titlePattern
            ORDER BY p.created_on
        ) p_pc
    ) p_pc_r
    WHERE p_pc_r.rank <= :rank
    """,
    Tuple.class)
.setParameter("titlePattern", "High-Performance Java Persistence %")
.setParameter("rank", 5)
.getResultList();

Much more readable, right?

IDE support

IntelliJ IDEA provides support for transforming legacy String concatenation blocks to the new multiline String format:

IntelliJ IDEA Text Blocks support

JSON, HTML, XML

The multiline String is especially useful when writing JSON, HTML, or XML.

Consider this example using String concatenation to build a JSON string literal:

entityManager.persist(
    new Book()
    .setId(1L)
    .setIsbn("978-9730228236")
    .setProperties(
        "{" +
        "   \"title\": \"High-Performance Java Persistence\"," +
        "   \"author\": \"Vlad Mihalcea\"," +
        "   \"publisher\": \"Amazon\"," +
        "   \"price\": 44.99," +
        "   \"reviews\": [" +
        "       {" +
        "           \"reviewer\": \"Cristiano\", " +
        "           \"review\": \"Excellent book to understand Java Persistence\", " +
        "           \"date\": \"2017-11-14\", " +
        "           \"rating\": 5" +
        "       }," +
        "       {" +
        "           \"reviewer\": \"T.W\", " +
        "           \"review\": \"The best JPA ORM book out there\", " +
        "           \"date\": \"2019-01-27\", " +
        "           \"rating\": 5" +
        "       }," +
        "       {" +
        "           \"reviewer\": \"Shaikh\", " +
        "           \"review\": \"The most informative book\", " +
        "           \"date\": \"2016-12-24\", " +
        "           \"rating\": 4" +
        "       }" +
        "   ]" +
        "}"
    )
);

You can barely read the JSON due to the escaping characters and the abundance of double quotes and plus signs.

With Java Text Blocks, the JSON object can be written like this:

entityManager.persist(
    new Book()
    .setId(1L)
    .setIsbn("978-9730228236")
    .setProperties("""
        {
           "title": "High-Performance Java Persistence",
           "author": "Vlad Mihalcea",
           "publisher": "Amazon",
           "price": 44.99,
           "reviews": [
               {
                   "reviewer": "Cristiano",
                   "review": "Excellent book to understand Java Persistence",
                   "date": "2017-11-14",
                   "rating": 5
               },
               {
                   "reviewer": "T.W",
                   "review": "The best JPA ORM book out there",
                   "date": "2019-01-27",
                   "rating": 5
               },
               {
                   "reviewer": "Shaikh",
                   "review": "The most informative book",
                   "date": "2016-12-24",
                   "rating": 4
               }
           ]
        }
        """
    )
);

Ever since I used C# in 2004, I've been wanting to have this feature in Java, and now we finally have it.

19

If you define your strings in a properties file it'll look much worse. IIRC, it'll look like:

string:text\u000atext\u000atext\u000a

Generally it's a reasonable idea to not embed large strings in to source. You might want to load them as resources, perhaps in XML or a readable text format. The text files can be either read at runtime or compiled into Java source. If you end up placing them in the source, I suggest putting the + at the front and omitting unnecessary new lines:

final String text = ""
    +"text "
    +"text "
    +"text"
;

If you do have new lines, you might want some of join or formatting method:

final String text = join("\r\n"
    ,"text"
    ,"text"
    ,"text"
);
0
18

Pluses are converted to StringBuilder.append, except when both strings are constants so the compiler can combine them at compile time. At least, that's how it is in Sun's compiler, and I would suspect most if not all other compilers would do the same.

So:

String a="Hello";
String b="Goodbye";
String c=a+b;

normally generates exactly the same code as:

String a="Hello";
String b="Goodbye":
StringBuilder temp=new StringBuilder();
temp.append(a).append(b);
String c=temp.toString();

On the other hand:

String c="Hello"+"Goodbye";

is the same as:

String c="HelloGoodbye";

That is, there's no penalty in breaking your string literals across multiple lines with plus signs for readability.

2
  • 4
    to be technical, in your first example it generates something more like: String c = new StringBuilder().append(a).append(b).toString(); The difference being that the temporary string builder is out of scope and eligible for garbage collection immediately after the String c=... line, whereas the "temp" string builder would stay around a little longer.
    – Kip
    Jun 4, 2009 at 16:24
  • True. My point, of course, is to distinguish when a function gets called at run-time versus when the work can be done at compile time. But you are correct.
    – Jay
    Jun 8, 2009 at 17:05
17

In the IntelliJ IDE you just need to type:

""

Then position your cursor inside the quotation marks and paste your string. The IDE will expand it into multiple concatenated lines.

0
11

Sadly, Java does not have multi-line string literals. You either have to concatenate string literals (using + or StringBuilder being the two most common approaches to this) or read the string in from a separate file.

For large multi-line string literals I'd be inclined to use a separate file and read it in using getResourceAsStream() (a method of the Class class). This makes it easy to find the file as you don't have to worry about the current directory versus where your code was installed. It also makes packaging easier, because you can actually store the file in your jar file.

Suppose you're in a class called Foo. Just do something like this:

Reader r = new InputStreamReader(Foo.class.getResourceAsStream("filename"), "UTF-8");
String s = Utils.readAll(r);

The one other annoyance is that Java doesn't have a standard "read all of the text from this Reader into a String" method. It's pretty easy to write though:

public static String readAll(Reader input) {
    StringBuilder sb = new StringBuilder();
    char[] buffer = new char[4096];
    int charsRead;
    while ((charsRead = input.read(buffer)) >= 0) {
        sb.append(buffer, 0, charsRead);
    }
    input.close();
    return sb.toString();
}
1
  • Not true anymore about java doesn't have a standard read all text method... — since Java 7 you can use Files.readAllLines(Path)
    – ccpizza
    May 24, 2019 at 20:57
11
String newline = System.getProperty ("line.separator");
string1 + newline + string2 + newline + string3

But, the best alternative is to use String.format

String multilineString = String.format("%s\n%s\n%s\n",line1,line2,line3);
4
  • My opinion is that it removes the plus signs and quotes, making it more readable, specially when there are more than just 3 lines. Not as good as String.format though.
    – Tom
    May 18, 2009 at 16:43
  • 2
    Stringbuilder example is at least as unreadable. Also, don't forget that "\n" isn't always a newline, but it's fine for linux and unix machines. May 18, 2009 at 16:45
  • Plus, just wanted to mention the existance of StringBuilder.
    – Tom
    May 18, 2009 at 16:46
  • 4
    Replacing one plus sign with a six-character method name and parentheses doesn't look more readable to me, although apparently you're not the only one who thinks that way. It doesn't remove the quotes, though. They are still there.
    – skiphoppy
    May 18, 2009 at 16:50
9

Since Java does not (yet) native support multi-line strings, the only way for now is to hack around it using one of the aforementioned techniques. I built the following Python script using some of the tricks mentioned above:

import sys
import string
import os

print 'new String('
for line in sys.stdin:
    one = string.replace(line, '"', '\\"').rstrip(os.linesep)
    print '  + "' + one + ' "'
print ')'

Put that in a file named javastringify.py and your string in a file mystring.txt and run it as follows:

cat mystring.txt | python javastringify.py

You can then copy the output and paste it into your editor.

Modify this as needed to handle any special cases but this works for my needs. Hope this helps!

9

You may use scala-code, which is compatible to java, and allows multiline-Strings enclosed with """:

package foobar
object SWrap {
  def bar = """John said: "This is
  a test
  a bloody test,
  my dear." and closed the door.""" 
}

(note the quotes inside the string) and from java:

String s2 = foobar.SWrap.bar ();

Whether this is more comfortable ...?

Another approach, if you often handle long text, which should be placed in your sourcecode, might be a script, which takes the text from an external file, and wrappes it as a multiline-java-String like this:

sed '1s/^/String s = \"/;2,$s/^/\t+ "/;2,$s/$/"/' file > file.java

so that you may cut-and-paste it easily into your source.

7

Actually, the following is the cleanest implementation I have seen so far. It uses an annotation to convert a comment into a string variable...

/**
  <html>
    <head/>
    <body>
      <p>
        Hello<br/>
        Multiline<br/>
        World<br/>
      </p>
    </body>
  </html>
  */
  @Multiline
  private static String html;

So, the end result is that the variable html contains the multiline string. No quotes, no pluses, no commas, just pure string.

This solution is available at the following URL... http://www.adrianwalker.org/2011/12/java-multiline-string.html

Hope that helps!

1
  • That annotation processor needs more robust checking, Apr 26, 2018 at 20:41
7

See Java Stringfier. Turns your text into a StringBuilder java block escaping if needed.

1
  • 1
    Yes, because I can spend my life copy and pasting into that site. I could also just store them in a file and load that but that is not an ideal solution either.
    – mjs
    Jul 26, 2017 at 19:36
7

You can concatenate your appends in a separate method like:

public static String multilineString(String... lines){
   StringBuilder sb = new StringBuilder();
   for(String s : lines){
     sb.append(s);
     sb.append ('\n');
   }
   return sb.toString();
}

Either way, prefer StringBuilder to the plus notation.

4
  • 5
    Why do I prefer StringBuilder to the plus notation?
    – skiphoppy
    May 18, 2009 at 16:44
  • 10
    Efficiency, or rather an often-misguided attempt at it.
    – Michael Myers
    May 18, 2009 at 16:55
  • 2
    The attempt at efficiency is based, I think, on the fact that the Java compiler implements the string concatenation operator using StringBuilder (StringBuffer in pre-1.5 compilers). There is an old, but well-known article stating that there are performance benefits in certain situations to using StringBuffer (or StringBuilder, now). Here's the link: java.sun.com/developer/JDCTechTips/2002/tt0305.html
    – Paul Morie
    May 18, 2009 at 17:32
  • 6
    Only when the compiler can't do it. For literals and constants, if you use a plus sign, the concatenation is done at compile-time. Using a StringBuilder forces it to happen at runtime, so it's not only more work, it's slower.
    – johncip
    May 9, 2011 at 7:30
7
    import org.apache.commons.lang3.StringUtils;

    String multiline = StringUtils.join(new String[] {
        "It was the best of times, it was the worst of times ", 
        "it was the age of wisdom, it was the age of foolishness",
        "it was the epoch of belief, it was the epoch of incredulity",
        "it was the season of Light, it was the season of Darkness",
        "it was the spring of hope, it was the winter of despair",
        "we had everything before us, we had nothing before us",
        }, "\n");
6

Java 13 preview:

Text Blocks Come to Java. Java 13 delivers long-awaited multiline string by Mala Gupta

With text blocks, Java 13 is making it easier for you to work with multiline string literals. You no longer need to escape the special characters in string literals or use concatenation operators for values that span multiple lines.

Text block is defined using three double quotes (""") as the opening and closing delimiters. The opening delimiter can be followed by zero or more white spaces and a line terminator.

Example:

 String s1 = """
 text
 text
 text
 """;
5

An alternative I haven't seen as answer yet is the java.io.PrintWriter.

StringWriter stringWriter = new StringWriter();
PrintWriter writer = new PrintWriter(stringWriter);
writer.println("It was the best of times, it was the worst of times");
writer.println("it was the age of wisdom, it was the age of foolishness,");
writer.println("it was the epoch of belief, it was the epoch of incredulity,");
writer.println("it was the season of Light, it was the season of Darkness,");
writer.println("it was the spring of hope, it was the winter of despair,");
writer.println("we had everything before us, we had nothing before us");
String string = stringWriter.toString();

Also the fact that java.io.BufferedWriter has a newLine() method is unmentioned.

5

A quite efficient and platform independent solution would be using the system property for line separators and the StringBuilder class to build strings:

String separator = System.getProperty("line.separator");
String[] lines = {"Line 1", "Line 2" /*, ... */};

StringBuilder builder = new StringBuilder(lines[0]);
for (int i = 1; i < lines.length(); i++) {
    builder.append(separator).append(lines[i]);
}
String multiLine = builder.toString();
0
5

Use Properties.loadFromXML(InputStream). There's no need for external libs.

Better than a messy code (since maintainability and design are your concern), it is preferable not to use long strings.

Start by reading xml properties:

 InputStream fileIS = YourClass.class.getResourceAsStream("MultiLine.xml");
 Properties prop = new Properies();
 prop.loadFromXML(fileIS);


then you can use your multiline string in a more maintainable way...

static final String UNIQUE_MEANINGFUL_KEY = "Super Duper UNIQUE Key";
prop.getProperty(UNIQUE_MEANINGFUL_KEY) // "\n    MEGA\n   LONG\n..."


MultiLine.xml` gets located in the same folder YourClass:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">

<properties>
    <entry key="Super Duper UNIQUE Key">
       MEGA
       LONG
       MULTILINE
    </entry>
</properties>

PS.: You can use <![CDATA[" ... "]]> for xml-like string.

2
  • Yes, this is what I use as well, great solution! Move out the SQL or XML into an external XML property file. It does not mess the code up. :) Mar 5, 2016 at 17:29
  • This does not answer the question. heredoc's are by definition within the file. The point is to keep it in one place. Sep 12, 2016 at 14:54
5

With JDK/12 early access build # 12, one can now use multiline strings in Java as follows :

String multiLine = `First line
    Second line with indentation
Third line
and so on...`; // the formatting as desired
System.out.println(multiLine);

and this results in the following output:

First line
    Second line with indentation
Third line
and so on...

Edit: Postponed to java 13

3
  • 1
    Here is a way to try it out using maven
    – Naman
    Sep 21, 2018 at 9:44
  • 2
    As cybersoft says on other comment, raw string literals (JEP326) has been removed from final JDK12, but another JEP has been created to add "Text blocks" that may be done as preview in JDK 13 Feb 4, 2020 at 16:27
  • Does not work on JDK 17.
    – e-info128
    Apr 27 at 17:54
4

If you like google's guava as much as I do, it can give a fairly clean representation and a nice, easy way to not hardcode your newline characters too:

String out = Joiner.on(newline).join(ImmutableList.of(
    "line1",
    "line2",
    "line3"));
4

One good option.

import static some.Util.*;

    public class Java {

        public static void main(String[] args) {

            String sql = $(
              "Select * from java",
              "join some on ",
              "group by"        
            );

            System.out.println(sql);
        }

    }


    public class Util {

        public static String $(String ...sql){
            return String.join(System.getProperty("line.separator"),sql);
        }

    }
4

Java15 now supports triple-quoted strings a la Python.

4

Saw all the answers and I think no one referred than in newer version of java you can do this:

String s = """
    This
    is 
    a
    multiline
    string
    """;
System.out.println(s);

This is what it prints:

This
is
a
multiline
string
1
  • Good to know. But, please define "newer" in your answer. Dec 5, 2022 at 10:17
3

Define my string in a properties file?

Multiline strings aren't allowed in properties files. You can use \n in properties files, but I don't think that is much of a solution in your case.

1
  • The value in a properties file can span multiple lines: Just end all lines but the last with a backslash. This does leave the problem of what you use as the line separator, as this is platform-specific. I suppose you could use a simple \n and then in your code, after reading the property, do a search-and-replace of \n to line.separator. That seems a little kludgey, but I guess you could write a function that retrieves a property and does this manipulation at the same time. Well, all that assumes that you'd be writing these strings to a file, which is a big assumption.
    – Jay
    May 19, 2009 at 0:43
3

I know this is an old question, however for intersted developers Multi line literals gonna be in #Java12

http://mail.openjdk.java.net/pipermail/amber-dev/2018-July/003254.html

1
  • nope. but did finally make it for java 13. Which my teams will likely adopt in about a half decade. Jan 6, 2020 at 1:17

Not the answer you're looking for? Browse other questions tagged or ask your own question.