YUI，开发不断，现在已经在其中添加了css布局的一个lib

style，老家伙了，内容很多，不仅仅是布局，据说什么网站只要放上这个就会漂亮许多，呵呵。

当然其他的有很多，这几个只是我接触到的，欢迎大家添加哦。

From: http://springide.org/project/wiki/SpringideGuide 

To start working with Spring IDE you need a SpringProject. A SpringProject can be created by adding the SpringProjectNature to an existing project or by creating a new Spring project with the SpringProjectWizard.

Add SpringProject nature ¶

• select open project nodes in Eclipse resource navigator or JDT package explorer
• activate context menu item "Add Spring Project Nature" on selected projects

• once the nature is added, these projects are now decorated with a small 'S' in the upper right corner (overwriting other decorators, e.g. Java project decorator 'J')

• to remove the nature, right click the project and select "Remove Spring Project Nature"

See also: SpringProject, SpringProjectNature

Create new SpringProject ¶

• open the wizard selection dialog via the menu "File / New / Project..."

• select the wizard "Spring IDE / New Spring Project"

• enter the project name
• (optionally) modify the comma-separated list of supported BeansConfig file extensions (default is "xml")
• if you don't need a Java project then deselect the checkbox "Create a Java project"
• for a Java project you can change the project's settings (source / classes folder, classpath, libraries, ...) on the next dialog page

See also: SpringProject

Add references to other Spring projects (optional) ¶

• open a Spring project's properties dialog from the context menu in Eclipse resource navigator or JDT package explorer
• select the properties page "Project References" from the list on the left side
• enable all Spring project(s) containing Spring Beans config files which are referenced from within this project via Spring Beans config sets (defined later on)

See also: BeansConfig, BeansConfigSet

Add Spring BeansConfig files ¶

• open a Spring project's properties dialog from the context menu in Eclipse resource navigator or JDT package explorer
• select the properties page "Spring Beans" from the list on the left side

• (optionally) modify the comma-separated list of supported BeansConfig file extensions (default is "xml")
• use the button "Add..." to open a selector dialog providing a list of all files with the specified extensions in your Spring project and select the corresponding Spring BeansConfig files

• once the config files are selected the corresponding files are decorated with a small 'S' in Eclipse resource navigator or JDT package explorer

See also: BeansProjectProperties?, BeansConfig

Create Spring BeansConfig file sets (optional) ¶

• open a Spring project's properties dialog from the context menu in Eclipse resource navigator or JDT package explorer
• select the properties page "Spring Beans" from the list on the left side
• select the second tab labeled "Config Sets"

• use the button "New..." to open a dialog for creating a new config set with a selection of all config files (added in the previous step) belonging to this config set
  • define a unique name for the config set
  • activate the checkbox "Enable bean override" if multiple beans with the same ID should be overidden by the last bean (used by the BeansConfigValidator only -> if activated then bean overriding is not treated as validation error)
  • activate the checkbox "Is incomplete" if this config set does not contain all beans which are referenced by other beans defined in this config set (used by the BeansConfigValidator only -> if activated then unresolved bean references are not treated as validation errors)
  • externally defined config files (as described in section "Add references to other Spring projects") are decorated with a small blue arrow)

• use the buttons "Move Up" and "Move Down" to change the order of the config files within the config set (important for bean overriding)

See also: BeansConfig, BeansConfigSet, BeansConfigValidator

Open Spring BeansView ¶

• select from within any of the added Spring BeansConfig files opened in an Eclipse editor the menu item "Navigate/Show In/Spring Beans"

• once the menu item is selected the Spring BeansView is opened and the corresponding Spring BeansConfig file is selected in the view's model

• double-clicking on certain entries in the Spring BeansView (bean, property or constructor argument) navigates to the corresponding location in the config file
• by selecting the corresponding toolbar actions the BeansView supports alphabetical sorting and syncing with the BeansXmlEditor

See also: BeansView, BeansConfig, BeansXmlEditor

Validate Spring BeansConfig file ¶

• after modifying and saving any of the added Spring BeansConfig files from within an open Eclipse editor this config is automatically validated by Spring IDE
• for any error occured during validation a problem marker is created and listed in Eclipse's problem view

See also: BeansConfig, BeansConfigValidator

Open Spring BeansGraph ¶

• right-clicking on certain entries in the Spring BeansView (config, config set or bean) opens a read-only editor showing a graph with all beans referenced by the selected view entry

See also: BeansView, BeansConfig, BeansConfigSet, BeansGraph

Search for Spring Beans ¶

• open the search dialog via the "Search / Search..." menu
• select the tab "Spring Beans Search" to switch to the BeansSearch dialog

See also: BeansSearch

Attachments

• AddNature.png (55.5 kB) -added screenshoot, added by tjuerge on 07/16/05 16:14:33.
• NatureAdded.png (11.3 kB) -added screenshoot, added by tjuerge on 07/16/05 16:14:44.
• ProjectReference.png (67.9 kB) -added screenshoot, added by tjuerge on 07/16/05 16:36:31.
• BeansView1.png (107.8 kB) -added screen shoot, added by tjuerge on 07/16/05 18:23:19.
• SpringProjectWizardSelection.png (25.5 kB) -Screenshoot of wizard selection dialog, added by tjuerge on 04/04/06 22:53:39.
• SpringProjectWizard.png (51.3 kB) -Screenshoot of Spring project wizard, added by tjuerge on 04/04/06 22:56:07.
• BeansSearch.png (178.1 kB) -Screenshoot of Spring Beans search dialog, added by tjuerge on 04/04/06 23:21:51.
• AddConfigFiles2.png (80.9 kB) -Spring project properties dialog with Add BeansConfig dialog, added by tjuerge on 04/24/06 00:24:35.
• AddConfigFiles1.png (74.7 kB) -Spring project properties dialog with BeansConfig tab, added by tjuerge on 04/24/06 00:25:05.
• AddConfigFiles3.png (31.0 kB) -Package explorer with decorated BeansConfig files, added by tjuerge on 04/24/06 00:26:00.
• CreateConfigSets1.png (106.0 kB) -Spring project properties dialog with BeansConfigSet tab, added by tjuerge on 04/24/06 00:42:41.
• CreateConfigSets2.png (49.5 kB) -Create new BeansConfigSet dialog, added by tjuerge on 04/24/06 00:43:18.
• CreateConfigSets3.png (114.8 kB) -Spring project properties dialog with BeansConfigSet tab, added by tjuerge on 04/24/06 00:44:37.
• BeansView2.png (211.8 kB) -Editor and Beans View, added by tjuerge on 04/24/06 00:52:00.
• ConfigValidator.png (200.6 kB) -Editor with problem markers and problem view, added by tjuerge on 04/24/06 01:09:40.
• BeansGraph.png (155.8 kB) -BeansGraph with outline view, added by tjuerge on 04/24/06 01:13:27.

Args4J 是一个用来出来命令行的工具.

在实际的项目中用到命令行的并不是很常见,但当真正使用到时,特别是在程序启动时配置一下参数的时候就很有用了,如果参数很多的话,一个一个解析命令行还是比较麻烦的.这时使用Args4J就相当好办了. 在本文中我们来看看Args4J的使用,当需要时能提供一个解决方案.

Args4J使用一个被称为Option类的类来保存输入的参数,让后根据该类来应用参数,每个参数可以对应一个类中的属性,该属性用Annotation注释,在Annotation中给出该参数 的选项, 还可以配置其他有用的信息.该Annotation就是 Option 注解: 该注解的doc如下:

Marks a field/setter that receives a command line switch value.

This annotation can be placed on a field of type T or the method of the form void methodName(T value). Its access modified can be anything, but if it's not public, your application needs to run in a security context that allows args4j to access the field/method (see AccessibleObject.setAccessible(boolean).

The behavior of the annotation differs depending on T --- the type of the field or the parameter of the method.

Boolean Switch

When T is boolean , it represents a boolean option that takes the form of "-OPT". When this option is set, the property will be set to true.

String Switch

When T is String, it represents an option that takes one operand. The value of the operand is set to the property.

Enum Switch

When T is derived from Enum, it represents an option that takes an operand, which must be one of the enum constant. The comparion between the operand and the enum constant name is done in a case insensitive fashion.

For example, the following definition will represent command line options like "-coin penny" or "-coin DIME" but things like "-coin" or "-coin abc" are errors.

 enum Coin { PENNY,NICKEL,DIME,QUARTER }

 class Option {
   @Option(name="-coin")
   public Coin coin;
 }
 

File Switch

When T is a File, it represents an option that takes a file/directory name as an operand.

该注解有5各域 其中name是必须的,其他四个是可选的.如下所示,关于该注解的详细Doc请查看 其docs.

当命令行设定后 其使用方式和java 命令里面的参数使用方式一样 如:java -cp ./calssPath/.......

下面通过一个例子来解释:

001 /*
002  * Created on 2006-2-21
003  * @author icerain
004  */
005 package test.args4j;
006 
007 import org.kohsuke.args4j.Argument;
008 import org.kohsuke.args4j.CmdLineException;
009 import org.kohsuke.args4j.CmdLineParser;
010 import org.kohsuke.args4j.ExampleMode;
011 import org.kohsuke.args4j.Option;
012 import org.kohsuke.args4j.spi.BooleanOptionHandler;
013 
014 import java.io.File;
015 import java.io.IOException;
016 import java.util.ArrayList;
017 import java.util.List;
018 
019 public class TestArgs4J {
020   // 利用Option注解来定义一个boolean 命令行参数 其参数name为 -re ,required指定该参数是必须的
021   @Option(name = "-re", usage = "recursively run something", required = true)
022   private boolean recursive;
023 
024   //利用Option注解定义一个File 命令行参数, name为-o, 输入时候知道该file的路径就可以了
025   //metaVar 用来设定显示 使用方式时候的输出,这个输出为-o OUTPUT : output to this file
026   //如果不指定该属性 则使用默认的代替 为-o FILE : output to this file
027   @Option(name = "-o", usage = "output to this file", metaVar = "OUTPUT")
028   private File out = new File(".");
029 
030   //If 'usage' value is empty, the option will not be displayed
031     // in the usage screen.
032   //注意该处没有指定 usage 属性 或者指定usage 但是其值为空的 如usage = "",这样当使用
033   //parser.printExample(ExampleMode.ALL) 请注意下面第92行的输出
034   @Option(name = "-str", required = true)
035   //@Option(name = "-str", usage = "测试", required = true)  // 该行 -str参数有用
036   // no usage
037   
038   private String str = "(default value)";
039 
040   // 整数参数
041   @Option(name = "-n", usage = "repeat <n> times\nusage can have new lines in it and also it can be verrry long")
042   private int num = -1;
043 
044   // using 'handler=...' allows you to specify a custom OptionHandler
045   // implementation class. This allows you to bind a standard Java type
046   // with a non-standard option syntax
047   //指定一个特定的handler 
048   @Option(name = "-custom", handler=BooleanOptionHandler.class,usage="boolean value for checking the custom handler")
049   private boolean data;
050 
051   // receives other command line parameters than options
052   @Argument
053   private List<String> arguments = new ArrayList<String>();
054 
055   public static void main(String[] args) throws IOException {
056     new TestArgs4J().doMain(args);
057   }
058 
059   public void doMain(String[] args) throws IOException {
060     //Creates a new command line owner that parses arguments/options

             and set them into the given object.
061     CmdLineParser parser = new CmdLineParser(this);
062 
063     try {
064       // parse the arguments.
065       parser.parseArgument(args);
066 
067       // you can parse additional arguments if you want.
068       // parser.parseArgument("more","args");
069 
070       // after parsing arguments, you should check
071       // if enough arguments are given.
072       if (arguments.isEmpty())
073         throw new CmdLineException("No argument is given");
074 
075     } catch (CmdLineException e) {
076       // if there's a problem in the command line,
077       // you'll get this exception. this will report
078       // an error message.
079       System.err.println(e.getMessage());  //打印出错消息
080       System.err.println("java SampleMain [options...] arguments...");
081       // print the list of available options
082       parser.printUsage(System.err);  // 打印参数的用法
083       System.err.println();
084 
085       System.err.println("测试!!!!!");
086       // print option sample. This is useful some time
087       System.err.println("  Example: java SampleMain"
088           + parser.printExample(ExampleMode.ALL));       

// 注意 在Option中如果没有指定 usage 属性,
089       System.err.println("/n 2.........");               

//则这两行程序不会输出该参数的使用的
090 
091       System.err.println(" 2 Example2: java SampleMain" 

//注意 在Option中如果没有指定 usage 属性,
092           + parser.printExample(ExampleMode.REQUIRED));  

//则这两行程序不会输出该参数的使用的
093       return;
094     }
095 
096     // this will redirect the output to the specified output
097     System.out.println(out);
098 
099     if (recursive)
100       System.out.println("-r flag is set");
101 
102     if (data)
103       System.out.println("-custom flag is set");
104 
105     System.out.println("-str was " + str);
106 
107     if (num >= 0)
108       System.out.println("-n was " + num);
109 
110     // access non-option arguments
111     System.out.println("other arguments are:");
112     for (String s : arguments)
113       System.out.println(s);
114   }
115 
116 }

当不使用命令行时候 输入信息如下:

当使用 -re 为命令行输入时,输出如下:// 后为作者加的注释 不是输出

当使用-re -str some 为命令行输入时,结果如下:这是由于的73 行的判断引起的

使用-custom -n 2 -re -str some otherstring 为命令行输入时的 结果如下:

当使用-custom -n 2 -re -str some -o log.txt otherstring 时候的输出如下:

当使用一个不存在的参数时候 会有Exception的 例如:-custom -ee 2 -re -str some -o log.txt otherstring

其中-ee参数不存在 结果如下:

......

由以上的实例可以看出 args4J 取得命令行的输入参数,然后根据保存参数的类中的属性类型比较
 
并转换为适当的值, 然后我们可以使用这些属性了,这样就免去了自己判断args 的麻烦了,

当默认的Handler不满足你的要求时 可以自己扩展Handler实现,关于这点请参考Args4J的测试用例,

From : java 爱好者  by : icess