?? imports.html
字號:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html><head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>4.3.7. Imports</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="printer.html" title="4.3. Printer"><link rel="previous" href="comments.html" title="4.3.6. Comments"><link rel="next" href="environment.html" title="4.3.8. Environment"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part I. Jalopy core"><link rel="chapter" href="installation.html" title="Chapter 1. Installation"><link rel="chapter" href="build.html" title="Chapter 2. Building"><link rel="chapter" href="usage.html" title="Chapter 3. Usage"><link rel="chapter" href="settings.html" title="Chapter 4. Settings"><link rel="part" href="part-plugins.html" title="Part II. Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter 5. Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter 6. Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter 7. Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter 8. JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter 9. JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter 10. jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter 11. NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix A. Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix B. The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix C. ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix D. The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix E. GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix F. GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix G. Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix H. SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="imports.html#imports-sorting" title="4.3.7.1. General"><link rel="subsection" href="imports.html#import-grouping" title="4.3.7.2. Grouping"><link rel="subsection" href="imports.html#import-optimization" title="4.3.7.3. Optimize"> <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> • <a href="./download.html" class="navlink">Download</a> • <a href="./docs.html" class="navlink">Documentation</a> • <a href="./plugins.html" class="navlink">Plug-ins</a> • <a href="./links.html" class="navlink">Links</a> • <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> | <a href="./history.html" class="navlink2">History</a> | <a href="./manual.html" class="navlink2">Manual</a> | <a href="./faq.html" class="navlink2">FAQ</a> | <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px"> This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.3.7. Imports</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="comments.html">Prev</a> </td><th width="60%" align="center">4.3. Printer</th><td width="20%" align="right"> <a accesskey="n" href="environment.html">Next</a></td></tr></table><hr></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="imports"></a>4.3.7. Imports</h3></div></div><div></div></div><a class="indexterm" name="d0e4017"></a><p>Controls the handling of import declarations.</p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="imports-sorting"></a>4.3.7.1. General</h4></div></div><div></div></div><a class="indexterm" name="d0e4025"></a><p>Enables the sorting of import statements. Sorting the import statements makesit simple to browse a long list of imports.</p><div class="itemizedlist"><ul type="disc"><li><p>Sort import statements</p><p>Enables or disables the sorting of import statements. Enabling this optionwill sort all imports lexicographically.</p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="import-grouping"></a>4.3.7.2. Grouping</h4></div></div><div></div></div><a class="indexterm" name="d0e4039"></a><p>In addition to sorting, associated packages can be grouped together to reducecomplexity by packing related information into a common unit.</p><div class="itemizedlist"><ul type="disc"><li><p><a name="imports-grouping-depth"></a>Default grouping depth</p><a class="indexterm" name="d0e4052"></a><a class="indexterm" name="d0e4059"></a><p>Lets you define the default grouping depth. Only takes effect if sorting is enabled.</p><p>The grouping depth specifies the number of package name parts that are tobe taken into account in order to determine whether two import statements are tobe grouped together. For certain packages you may want to specify a groupingdepth that differs from the default.</p><p>Statements are to be grouped together, if all relevant parts are equal. So viathe grouping depth you can effectively specify how many parts are relevant.</p><p>To disable grouping at all, set the grouping depth to "<tt class="literal">0</tt>".</p><div class="example"><a name="ex-imports-grouping-depth-one"></a><p class="title"><b>Example 4.137. Grouping depth java='1'</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">import <span class="bold"><b>java</b></span>.awt.Color;import <span class="bold"><b>java</b></span>.awt.Component;import <span class="bold"><b>java</b></span>.awt.GridBagConstraints;import <span class="bold"><b>java</b></span>.awt.GridBagLayout;import <span class="bold"><b>java</b></span>.awt.event.ActionEvent;import <span class="bold"><b>java</b></span>.awt.event.ActionListener;import <span class="bold"><b>java</b></span>.util.ArrayList;import <span class="bold"><b>java</b></span>.util.List;</pre></td></tr></table></div><p></p><div class="example"><a name="ex-imports-grouping-depth-two"></a><p class="title"><b>Example 4.138. Grouping depth java='2'</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">import <span class="bold"><b>java.awt</b></span>.Color;import <span class="bold"><b>java.awt</b></span>.Component;import <span class="bold"><b>java.awt</b></span>.GridBagConstraints;import <span class="bold"><b>java.awt</b></span>.GridBagLayout;import <span class="bold"><b>java.awt</b></span>.event.ActionEvent;import <span class="bold"><b>java.awt</b></span>.event.ActionListener;import <span class="bold"><b>java.util</b></span>.ArrayList;import <span class="bold"><b>java.util</b></span>.List;</pre></td></tr></table></div><p></p><div class="example"><a name="ex-imports-grouping-depth-three"></a><p class="title"><b>Example 4.139. Grouping depth java= '3'</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">import <span class="bold"><b>java.awt</b></span>.Color;import <span class="bold"><b>java.awt</b></span>.Component;import <span class="bold"><b>java.awt</b></span>.GridBagConstraints;import <span class="bold"><b>java.awt</b></span>.GridBagLayout;import <span class="bold"><b>java.awt.event</b></span>.ActionEvent;import <span class="bold"><b>java.awt.event</b></span>.ActionListener;import <span class="bold"><b>java.util</b></span>.ArrayList;import <span class="bold"><b>java.util</b></span>.List;</pre></td></tr></table></div><p></p></li></ul></div><p>You can add/remove package fragments (e.g. javax, javax.swing or com.foo.sarah)via the <span><b class="guibutton">Add...</b></span> and <span><b class="guibutton">Remove</b></span>buttons to fine-tune the appearance for certain packages.</p><p>To specify the order in which related statements should appear, youmay want to use the <span><b class="guibutton">Up</b></span> and <span><b class="guibutton">Down</b></span> buttons.</p><p>Note that the <tt class="literal">asterix</tt> represents all undefined packages.</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="import-optimization"></a>4.3.7.3. Optimize</h4></div></div><div></div></div><p>Optimizes the import statements by either expanding or collapsing them. Thisis a nice feature that is currently only available with the Ant andJBuilder Plug-in.</p><a class="indexterm" name="d0e4189"></a><div class="itemizedlist"><ul type="disc"><li><p><a name="import-optimization-expand"></a>Expand on-demand imports<a class="indexterm" name="d0e4198"></a></p><p>If enabled, tries to expand all on-demand import statements.</p><p><a name="imports-on-demand"></a>Expanding means to resolve all on-demand import statements (sometimes calledwildcard imports) and replace them with single-type import statements (sometimescalled explicit imports) of the types that are actually used in the source file.</p><a class="indexterm" name="d0e4208"></a><p>So the following on-demand import statement may be expanded into twosingle-type import statements that reference the needed types for this package.</p><div class="example"><a name="ex-imports-on-demand"></a><p class="title"><b>Example 4.140. On-demand import statement</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">import java.util.*;</pre></td></tr></table></div><p></p><div class="example"><a name="ex-import-single-type"></a><p class="title"><b>Example 4.141. Single-type import statements</b></p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="programlisting">import java.util.ArrayList;import java.util.List;</pre></td></tr></table></div><p>Using single-type imports is quite useful and an absolute requirement in theopen source community as this code is usually really reviewed. Usingsingle-type imports makes it easy for the code reader to quickly findout the package a particular type is in: You just search for the type namefrom the start of the source file.</p></li></ul></div><div class="itemizedlist"><ul type="disc"><li><p><a name="import-optimization-collapse"></a>Collapse single-type imports<a class="indexterm" name="d0e4232"></a><a class="indexterm" name="d0e4238"></a></p><p>If enabled, tries to collapse all single-type statements.</p><p>Collapsing means to remove all single-type imports of a given package andreplace them with one on-demand import statement.</p></li></ul></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="comments.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="printer.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="environment.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.3.6. Comments </td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top"> 4.3.8. Environment</td></tr></table></div></td></tr></table></td></tr><tr><td bgcolor="#eeeecc" height="17" style="font-size:9px;padding-left:5px"><a href="#toppage">to top</a></td></tr><tr><td height="30"><br></td></tr><tr><td height="3"></td></tr><tr><td bgcolor="#336699" height="1"></td></tr><tr><td height="1"></td></tr><tr><td bgcolor="#336699" height="16"></td></tr><tr><td bgcolor="#ff9966" height="4"></td></tr><tr><td class="footer" align="center" height="15" valign="middle"> Copyright © 2001-2004, <a class="footer" href="./contact.html">Marco Hunsicker</a>. All rights reserved. Hosted by <a href="http://sourceforge.net">SourceForge.net</a></td></tr></tbody></table><img src="http://sourceforge.net/sflogo.php?group_id=45216&type=1" width="1" height="1" border="0" hspace="0" vspace="0" alt=""></body></html>?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -