Java Doc for Formattable.java in  » 6.0-JDK-Core » Collections-Jar-Zip-Logging-regex » java » util » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Home
Java Source Code / Java Documentation
1.6.0 JDK Core
2.6.0 JDK Modules
3.6.0 JDK Modules com.sun
4.6.0 JDK Modules com.sun.java
5.6.0 JDK Modules sun
6.6.0 JDK Platform
7.Ajax
8.Apache Harmony Java SE
9.Aspect oriented
10.Authentication Authorization
11.Blogger System
12.Build
13.Byte Code
14.Cache
15.Chart
16.Chat
17.Code Analyzer
18.Collaboration
19.Content Management System
20.Database Client
21.Database DBMS
22.Database JDBC Connection Pool
23.Database ORM
24.Development
25.EJB Server
26.ERP CRM Financial
27.ESB
28.Forum
29.Game
30.GIS
31.Graphic 3D
32.Graphic Library
33.Groupware
34.HTML Parser
35.IDE
36.IDE Eclipse
37.IDE Netbeans
38.Installer
39.Internationalization Localization
40.Inversion of Control
41.Issue Tracking
42.J2EE
43.J2ME
44.JBoss
45.JMS
46.JMX
47.Library
48.Mail Clients
49.Music
50.Net
51.Parser
52.PDF
53.Portal
54.Profiler
55.Project Management
56.Report
57.RSS RDF
58.Rule Engine
59.Science
60.Scripting
61.Search Engine
62.Security
63.Sevlet Container
64.Source Control
65.Swing Library
66.Template Engine
67.Test Coverage
68.Testing
69.UML
70.Web Crawler
71.Web Framework
72.Web Mail
73.Web Server
74.Web Services
75.Web Services apache cxf 2.2.6
76.Web Services AXIS2
77.Wiki Engine
78.Workflow Engines
79.XML
80.XML UI
Java Source Code / Java Documentation » 6.0 JDK Core » Collections Jar Zip Logging regex » java.util 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.util.Formattable

Formattable
public interface Formattable (Code)
The Formattable interface must be implemented by any class that needs to perform custom formatting using the 's' conversion specifier of java.util.Formatter . This interface allows basic control for formatting arbitrary objects. For example, the following class prints out different representations of a stock's name depending on the flags and length constraints:
 import java.nio.CharBuffer;
 import java.util.Formatter;
 import java.util.Formattable;
 import java.util.Locale;
 import static java.util.FormattableFlags.*;
 ...
 public class StockName implements Formattable {
 private String symbol, companyName, frenchCompanyName;
 public StockName(String symbol, String companyName,
 String frenchCompanyName) {
 ...
 }
 ...
 public void formatTo(Formatter fmt, int f, int width, int precision) {
 StringBuilder sb = new StringBuilder();
 // decide form of name 
 String name = companyName;
 if (fmt.locale().equals(Locale.FRANCE))
 name = frenchCompanyName;
 boolean alternate = (f & ALTERNATE) == ALTERNATE;
 boolean usesymbol = alternate || (precision != -1 && precision < 10);
 String out = (usesymbol ? symbol : name);
 // apply precision
 if (precision == -1 || out.length() < precision) {
 // write it all
 sb.append(out);
 } else {
 sb.append(out.substring(0, precision - 1)).append('*');
 }
 // apply width and justification
 int len = sb.length(); 
 if (len < width)
 for (int i = 0; i < width - len; i++)
 if ((f & LEFT_JUSTIFY) == LEFT_JUSTIFY)
 sb.append(' ');
 else
 sb.insert(0, ' ');
 fmt.format(sb.toString());
 }
 public String toString() {
 return String.format("%s - %s", symbol, companyName);
 }
 }
 

When used in conjunction with the java.util.Formatter , the above class produces the following output for various format strings.

 Formatter fmt = new Formatter();
 StockName sn = new StockName("HUGE", "Huge Fruit, Inc.",
 "Fruit Titanesque, Inc.");
 fmt.format("%s", sn);                   //   -> "Huge Fruit, Inc."
 fmt.format("%s", sn.toString());        //   -> "HUGE - Huge Fruit, Inc."
 fmt.format("%#s", sn);                  //   -> "HUGE"
 fmt.format("%-10.8s", sn);              //   -> "HUGE      "
 fmt.format("%.12s", sn);                //   -> "Huge Fruit,*"
 fmt.format(Locale.FRANCE, "%25s", sn);  //   -> "   Fruit Titanesque, Inc." 
 

Formattables are not necessarily safe for multithreaded access. Thread safety is optional and may be enforced by classes that extend and implement this interface.

Unless otherwise specified, passing a null argument to any method in this interface will cause a NullPointerException to be thrown.
version:
   1.10, 05/05/07
since:
   1.5





Method Summary
 voidformatTo(Formatter formatter, int flags, int width, int precision)
     Formats the object using the provided Formatter formatter .
Parameters:
  formatter - The Formatter formatter.



Method Detail
formatTo
void formatTo(Formatter formatter, int flags, int width, int precision)(Code)
Formats the object using the provided Formatter formatter .
Parameters:
  formatter - The Formatter formatter. Implementing classes may callFormatter.out formatter.out() or Formatter.locale formatter.locale() to obtain the Appendable or Locale used by thisformatter respectively.
Parameters:
  flags - The flags modify the output format. The value is interpreted asa bitmask. Any combination of the following flags may be set:FormattableFlags.LEFT_JUSTIFY, FormattableFlags.UPPERCASE, and FormattableFlags.ALTERNATE. If no flags are set, the defaultformatting of the implementing class will apply.
Parameters:
  width - The minimum number of characters to be written to the output.If the length of the converted value is less than thewidth then the output will be padded by'  ' until the total number of charactersequals width. The padding is at the beginning by default. Ifthe FormattableFlags.LEFT_JUSTIFY flag is set then thepadding will be at the end. If width is -1then there is no minimum.
Parameters:
  precision - The maximum number of characters to be written to the output.The precision is applied before the width, thus the output willbe truncated to precision characters even if thewidth is greater than the precision. Ifprecision is -1 then there is no explicitlimit on the number of characters.
throws:
  IllegalFormatException - If any of the parameters are invalid. For specification of allpossible formatting errors, see the Details section of theformatter class specification.



www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.