J2SE 1.5 中的Formatter 类

原创 2005年06月01日 00:42:00
作者:Jeff Langr
出处:developer.com

Java 1.5 introduces a new class named java.util.Formatter that allows you to do string formatting similar to the printf function in C. It depends heavily on the varargs feature being introduced in 1.5.

System.out.printf


The first way you'll learn to work with the Formatter is not to interact with it directly, but instead to use the new PrintStream method printf. You're probably most familiar with PrintStream from doing System.out.println calls. Here is a simple example of the new printf method:

  1. String initials = "jjl";
  2. String comment  = "just because";
  3. System.out.printf("reason: %s (noted by %s)", comment, initials);


The example prints the following output on the console:

reason: just because (noted by jjl)
In the example code, you are passing printf a format string that contains embedded format specifiers. You also pass it a list of arguments, each of which corresponds to a format specifier. There are two format specifiers in the example: %s and %s. The first corresponds to the comment argument, and the second corresponds to the initials argument.

A % in a format string designates the start of a format specifier. The end of a format specifier is triggered by one of many possible characters known as conversions. In the %s format specifier, the lowercase s indicates a String conversion. A string conversion means that Java calls toString on the corresponding argument, and substitutes the result for the format specifier.

String.format


If you only want to obtain a formatted string, but not print it, you can use the static method format on the String class. Here's an example that also demonstrates a few numeric conversions:

  1. int a = 65;
  2. String s = 
  3.    String.format("char: %c integral: %d octal: %o hex: %x %n",
  4.       a, a, a, a);


The %n at the end of the format string indicates a platform-specific line separator. When printed, the String s looks like this:

char: A integral: 65 octal: 101 hex: 41
Numeric conversions also support flags for padding, grouping, justification, and sign.

Note: There are four arguments, each using the reference a. Were you to supply only three, or were one of the arguments an invalid type (for example, a string), the format method would have generated one of a few runtime exceptions. This is unlike C, which ignores any formatting problems.

If you want to use the same argument more than once against a format string, you can use a shortcut:

  1. String s = String.format("char: %c integral:%<d octal: %<o hex: %<x %n", a);


The a reference is specified only once. The less-than sign (<) in a format specifier means that it should use the same argument as the last format specifier.

Dates


Formatter provides an extensive number of date-related conversions. The following code:

  1. String.format("%1$td %1$tb %1$ty"new Date())


produces a string with the value:

26 Feb 04
The 1$ in each format specifier is another way to designate which argument to use. In this example, all three format specifiers target the first argument.

The last part of each format specifier is how you do date conversions?using a two-character sequence starting with a t. The second character indicates the date part to convert. For example, td in the first specifier converts the day of the month.

java.util.Formatter


The Formatter class is at the core of the new formatting capability. It fully supports internationalization by letting you pass a Locale to the constructor; the other formatting methods (e.g. String.format) also allow this.

Formatter also lets you pass an Appendable object. This is a new interface that defines append methods so that the formatter can store its results in a text collector such as a stream object. Sun has modified all relevant Java classes, such as StringBuffer and PrintStream, to implement this interface. Here's how you might use it:

  1. double avogadro     = 6.0e23;
  2. StringBuffer buffer = new StringBuffer();
  3. Formatter formatter = new Formatter(buffer, Locale.US);
  4. formatter.format("avogadro's number: %e %n", avogadro);
  5. formatter.format("base of the natural log: %e %n"Math.E);
  6. System.out.println(buffer.toString());


The corresponding output:

[pre]avogadro's number:       6.000000e+23
base of the natural log: 2.718282e+00[/pre]

Summary


There are dozens of conversions available in the Formatter class and a few more things that are not covered here. To learn more about formatting, refer to the Java API documentation pages for java.util.Formatter.

Trying It Out


You can download the current beta version of J2SE 1.5 from Sun's Web site.

About the Author


Jeff Langr is a freelance author and the owner of Langr Software Solutions. He is working on a second book on Java and test-driven development entitled Agile Java, due out from Prentice Hall in fall 2004.

默认eclipse建立maven项目时,JDK版本往往是1.5

如果你用eclipse建立maven项目时,新建的项目往往JDK版本很低——1.5!怎么办?修改settings.xml文件,增加profile节点,如下所示: jdk-1.6 ...
  • zheng12tian
  • zheng12tian
  • 2014年10月30日 11:37
  • 2243

Servlet JSP Tutorial -- 1.5 ServletContextListener Servlet Listener Example

ServletContextListener是我们拥有的许多SerServletContextListener是我们拥有的许多Servlet监听器之一。 这是本系列中的第五篇文章,你可能还想查看前面的...
  • Oktfolio
  • Oktfolio
  • 2018年01月10日 09:25
  • 29

克服J2SE 1.3-1.4 的不兼容性

 概要     实现Java 众多API中的一个是一件困难的工作。你必须经常实现许多相互依赖的接口。对新特征的需求促进了最新Java API的创建,投资商们必须不断的更新他们的实现以跟上时代的需要。当...
  • wangyongligood
  • wangyongligood
  • 2007年10月22日 22:18
  • 326

JRE System Library Problem J2SE-1.5问题

(1)问题: Description Resource Path Location Type Build path specifies execution environment J2SE-1.5....
  • Edison_03
  • Edison_03
  • 2017年07月04日 23:52
  • 1199

JAVA中使用Formatter类进行输出格式的控制

本文主要介绍的是JAVA中Formatter类的简单实用,由于现在我暂时只用过对String输出的控制,因此先整理这部分内容,当然Formatter类还可以对时间等其他输出格式的控制,以后如果有发现会...
  • u013816144
  • u013816144
  • 2015年12月16日 17:46
  • 2557

Java Web 开发JDK8+Tomcat8+Eclipse Luna安装配置(Windows)

说明:我的电脑是Windows7、 64位操作系统(如果是32位的系统选择下载对应的32位软件),三个软件我都选择安装在D盘了,可以根据个人习惯选择其他位置。 一、JDK8 1,下载 ...
  • baidu_34578937
  • baidu_34578937
  • 2016年04月10日 19:06
  • 715

更新maven依赖时 项目默j2SE1.5版本

只需要在maven项目的pom.xml中将编译器的版本指定为1.8即可 代码如下 org.apache.maven.plugins ...
  • u012156858
  • u012156858
  • 2017年02月06日 16:09
  • 2112

j2se 1.5 中的线程

java.util.concurrent包为多线程提供了更好的支持。比如 ConcurrentHashMap,多个线程可以同时访问而且还能保证是线程安全的,它允许不限数量的读操作以及一定数量(可以设置...
  • yhang
  • yhang
  • 2004年07月30日 09:53
  • 648

关于Echarts中formatter实现动态数据的方法

由于在近期工作内容中用到echarts,实现产品设计图时遇到一些小问题,比如: 设计图是这样的: 而Echarts的legend图例大概是这样的(注:以下demo都是随手写的): 看到ech...
  • kirinlau
  • kirinlau
  • 2017年12月06日 16:46
  • 266

maven项目中JRE System Library Problem J2SE-1.5问题

(1)问题: 我们创建的maven web项目,jre system library 使用的是j2se-1.5,如何更改为我们自己安装的jdk? (2)原因: maven是项目管...
  • feixiangsmile
  • feixiangsmile
  • 2017年10月25日 17:39
  • 348
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:J2SE 1.5 中的Formatter 类
举报原因:
原因补充:

(最多只允许输入30个字)