利用Jakarta Commons Lang��化Java

Thu, 11 Jan 2007 08:26:00 GMT

旉��Q?005-07-19
作者：Harshad Oak
��览�ơ数�Q? 3473
本文关键字：java, 基础, Jakarta Commons
转自:http://dev2dev.bea.com.cn/techdoc/2005071902.html
作�ؓ企业Java开发�h员，我们��L��需要实现各�U�功能，如解析XML、��用HTTP、验证输入以及处理日期等。��用Jakarta Commons��目的目的在于创��责处理所有此�c�d��用�Q务的�l��g�Q�从而节�U�时��_��让您集中�_�֊�处理核心业务解决�Ҏ��。在本文中，我们��对Jakarta Commons ��目作简单介�l�，然后演示如何使用Jakarta Commons内的Lang�l��g来处理和��化日常Java��d��Q�比如字�W�串操作、��用日期和日历、比较数据对象以及对象排序等。对于本文中的所有例子，我们都将使用最新的Lang版本�Q�即2.1版本�Q��?
　　�~�者按�Q�本文中的代码是�Ҏ��Commons Lang�?RC1版本 �~�写的。其最�l�版不久��发行�?br />
Commons和Lang�l��g��?/strong>
　　Jakarta Commons ��目旨在实现可重用的 Java �l��g。此��目包含数十个组�Ӟ��用以��?Java 的开发，每个�l��g负责满��一个特定需求。有大量的组件可用，且不仅限于在特定�c�d��的Java应用�E�序中��用�?br />
��目分类在两个部件中�Q?
Commons Proper�Q�Commons Proper中的��目已可以投入实际��用�?
Commons Sandbox�Q�sandbox内的��目仍然处于实验阶段�?
　　目前Commons Proper中有33个项目，Commons Sandbox中有22个项目，故而，��M��一�c�Java��目都有其存在的意义�?br />　　Lang�l��g是Jakarta Commons中较为流行的�l��g之一。Lang是要呈现在J2SE本��n中的一�l�类�?
　　在本文中�Q�我们将了解Lang最有用的一些功能。要注意的是�Q�也可以只��用基本Java�c�L��完成Lang的每个功能，但相对于自己学习、理解�ƈ�~�写代码而言�Q��用Lang要简单得多。即使您能够写出最好的代码�Q��用经�q�实验和��试的Lang的功能会更快一些，能节省大量的��查与��试旉��。随着Lang一��h��供了�Ҏ��的JUnit��试用例�Q�Lang的��用极其广泛，已经历了其创��和现实世界的种�U�考验�?br />　　Lang的一个重要特征是其简单性。通常来说�Q�新的Java�l��g十分复杂�Q�要了解若干�U�技术才能��用这些组件。要理解�l��g的用途通常都很难，更别说实际��用该�l��g了。但对于大多数Commons�l��g而言�Q�这��׃��是问题了。Lang一�cȝ��件��用方便，无论对Java初学者还是高�U�Java用户都非常有用�?br />　　如果在采用技术前需要有十��的保证，则请在保存您的Java软�g的目录中搜烦commons-lang*.jar。结果会让您感到很意外�?Tomcat�?a target="_blank">Struts�?a target="_blank">Hibernate�?a target="_blank">Spring�?a target="_blank">WebWork �{�常见Java��目都��用Lang�?br />　　首先让我们看一看��用Lang�q�行大多数开发�h员几乎每天必��进行的操作——字�W�串操作�?

处理字符�?/strong>
　　无论应用�E�序是基于Swing、J2EE或J2ME的，它都必须使用字符丌Ӏ�所以，��管在Java中��用字�W�串相当��单，但是如果希望按照一定的条�g修改和处理字�W�串�Q�事情就不那么简单了。您不得不在各种与字�W�串相关的类中寻扑֐��U�不常用的方法，然后惛_��法��其协同工作，以获得所需的结果。虽然有些Lang�Ҏ��与J2SE中的某些�Ҏ��重叠�Q�但在大多数情况下，一个Lang�Ҏ��可提供各种�c�M��的多个J2SE�Ҏ��的功能，从而帮助您获得所需的输出�?
　　Lang�l��g有许多专门用于字�W�串操作的类。现在我们将使用一个简单的Java应用�E�序来演�C�Z��些较为有用的�c�d��Ҏ��?
　　当应用程序接受用戯��入时�Q�由于用户可能会存在输入错误的情况，或用户可能以各种格式输入数据�Q�而您希望只采用一�U�格式进行处理和存储�Q�则通常会涉及到对字�W�串�q�行操作�?
　　例如�Q�您有一个带输入框的�H�体�Q�用户在此输入框内输入许可证密钥。您希望允许输入1111-JAVA格式的密钥。您必须�q�行以下操作�Q?/p>
��查是否�ؓ�I�字�W�串�?
忽略�I�格�?
密钥区分大小写�?
用�?”标记分隔密钥字�W�串�Q�然后检查第一部分是否全部是数字，�W�二部分包含的字�W�是否只来自有效字符集“J”、“A”、“V”、“A”�?
两个部分均应有四个字�W��?
�W�一部分的第四个数字应该是�?”�?
　　只有当密钥满��x��有这些条件时�Q�应用程序才会查询数据库�Q�检查该密钥是否合法�?
　　如果不花大量的时间浏览String、StringTokenizer和其他类的API文档�Q�您能完成以上的��d��么？我不能，所以现在我��试着用Lang�l��g来管理验证�?br />清单1. checkLicenseKey()�Ҏ��
/** * Check if the key is valid * @param key license key value * @return true if key is valid, false otherwise. */ public static boolean checkLicenseKey(String key){ //checks if empty or null if(StringUtils.isBlank(key)){ return false; } //delete all white space key= StringUtils.deleteWhitespace(key); //Split String using the - separator String[] keySplit = StringUtils.split(key, "-"); //check lengths of whole and parts if(keySplit.length != 2 || keySplit[0].length() != 4 || keySplit[1].length() != 4) { return false; } //Check if first part is numeric if(!StringUtils.isNumeric(keySplit[0])){ return false; } //Check if second part contains only //the four characters 'J', 'A', 'V' and 'A' if(! StringUtils.containsOnly(keySplit[1] ,new char[]{'J', 'A', 'V', 'A'})){ return false; } //Check if the fourth character //in the first part is a '0' if(StringUtils.indexOf(keySplit[0], '0') != 3){ return false; } //If all conditions are fulfilled, key is valid. return true; }
　　在清�?中，我们使用了org.apache.commons.lang.StringUtils�c�M��提供的各�U�方法，�Ҏ��我们先前定义的所有规则对字符串进行验证。isBlank()�Ҏ��查字�W�串是否为空。deleteWhitespace()�Ҏ��保字符串不包含�I�格。然后我们��用split()�Ҏ��对字�W�串�q�行分隔�Q��ƈ使用isNumeric()、containsOnly()和indexOf()�Ҏ��对密钥的两部分进行验证�?br />　　��h��意，��管在J2SE中已�l�有了indexOf()�Ҏ��Q�最好��用StringUtils中的indexOf()。与J2SE indexOf()�Ҏ��不同�Q��用StringUtils indexOf()时无需担心�I�指针的问题。触发NullPointerException被认为是Java�E�序员最常犯的错误。Lang可以��保您不会犯同样的错误。即使向indexOf()或其他此�c�L��法传递一个null�Q�都不会引发NullPointerException。indexOf()��直接返�?1�?br />　　�q�样�Q�只需几行��单代码，��可以实现相应的功能�Q�而采用其他方法需要编写很多行代码�Q�而且十分�ȝ��。如果��用清�?中所�C�的��L��法执行checkLicenseKey()�Ҏ��Q�所得到的结果如清单3所�C��?br />
清单2. main()�Ҏ��
public static void main(String[] args) { String []key= {"1210-JVAJ","1211-JVAJ", "210-JVAJ", "1210-ZVAJ"}; for (int i=0; i < key.length; i++){ if(checkLicenseKey(key[i])){ System.out.println(key[i]+ " >> Is Valid"); } else{ System.out.println(key[i]+ " >> Is InValid"); } } }
清单3. 输出
1210-JVAJ >> Is Valid 1211-JVAJ >> Is InValid 210-JVAJ >> Is InValid 1210-ZVAJ >> Is InValid
　　大部分用于进行字�W�串操作的方法都隶属于org.apache.commons.lang.StringUtils�Q�但也有其他的类可以使用。CharUtils和CharSetUtils分别提供使用字符和字�W�集的实用方法。WordUtils是在2.0版中首次出现的类�Q�用于承载专门用于处理字的实用方法。不�q�，�׃��字符串和字的处理上有大量的重叠操作，使得此类��g��有点没有存在的必要了。RandomStringUtils�c�d��以根据各�U�规则生成随机字�W�串�?
　　现在�Q�让我们了解一下Lang的另一个有用的斚w��Q�处理日期和旉��的能力�?br />
旉��技�?/strong>
　　在Java中处理日期和旉��是一件相当棘手的事。如果要使用java.text.SimpleDateFormat、java.util.Calendar、java.util.Date�{�类�Q�需要一定时间来适应�Q�还需要对每一个涉及到的类和接口非�怺�解，才能��利地处理日期和旉��?
　　Lang�l��g��d��地简化了日期的处理，�q�可对其�q�行格式化。您可以��L��地格式化日期以进行显�C�、比较日期、舍入或截断日期�Q�甚臌��获取特定范围内的所有日期�?

清单4. 处理日期和时�?/strong>
public static void main(String[] args) throws InterruptedException, ParseException { //date1 created Date date1= new Date(); //Print the date and time at this instant System.out.println("The time right now is >>"+date1); //Thread sleep for 1000 ms Thread.currentThread().sleep(DateUtils.MILLIS_IN_SECOND); //date2 created. Date date2= new Date(); //Check if date1 and date2 have the same day System.out.println("Is Same Day >> " + DateUtils.isSameDay(date1, date2)); //Check if date1 and date2 have the same instance System.out.println("Is Same Instant >> " +DateUtils.isSameInstant(date1, date2)); //Round the hour System.out.println("Date after rounding >>" +DateUtils.round(date1, Calendar.HOUR)); //Truncate the hour System.out.println("Date after truncation >>" +DateUtils.truncate(date1, Calendar.HOUR)); //Three dates in three different formats String [] dates={"2005.03.24 11:03:26", "2005-03-24 11:03", "2005/03/24"}; //Iterate over dates and parse strings to java.util.Date objects for(int i=0; i < dates.length; i++){ Date parsedDate= DateUtils.parseDate(dates[i], new String []{"yyyy/MM/dd", "yyyy.MM.dd HH:mm:ss", "yyyy-MM-dd HH:mm"}); System.out.println("Parsed Date is >>"+parsedDate); } //Display date in HH:mm:ss format System.out.println("Now >>" +DateFormatUtils.ISO_TIME_NO_T_FORMAT.format (System.currentTimeMillis())); }
　　清单4演示了org.apache.commons.lang.DateUtils和org.apache.commons.lang.DateFormatStringUtils�cȝ��部分功能。还有其他许多方法可以进行同��L��操作�Q�但输入格式不同。故而，如果万一您必��d��析和格式化一个日期��|��只需要借助提供的方法之一�Q�利用一行代码就可以实现了�?
　　执行清单4中代码后的输入如清单5所�C��?br />
清单5. 输出
The time right now is >>Sat Apr 09 14:40:41 GMT+05:30 2005 Is Same Day >> true Is Same Instant >> false Date after rounding >>Sat Apr 09 15:00:00 GMT+05:30 2005 Date after truncation >>Sat Apr 09 14:00:00 GMT+05:30 2005 Parsed Date is >>Thu Mar 24 11:03:26 GMT+05:30 2005 Parsed Date is >>Thu Mar 24 11:03:00 GMT+05:30 2005 Parsed Date is >>Thu Mar 24 00:00:00 GMT+05:30 2005 Now >>14:40:43
　　在清�?中，我们创徏了两个日期，�q�两个日期仅有一�U�的差别。然后��用isSameInstant()和isSameDay()�Ҏ��查这两个日期是否相同。接下来��日期进行舍入和截断�Q�然后��用在数组中指定的各种格式对特�D�日期用例进行解析�?br />　　��您的应用程序集成到�W�三方应用程序时�Q�经�怸�能完全确定输入的格式。我曄��做过一个对旧版应用�E�序的集成，对于每个问题�Q�该应用�E�序��g��L��有三个答案。所以，如果必须�Ҏ��c�d��用程序提供的日期�q�行解析�Q�您需要提供三个和四个不同的日期格式。清�?中��用parseDate()�Ҏ��是��Z��完成�q�项��d��。这��P��即��输入有变化，仍然能更�Ҏ��期进行解析。还要注意，数组内模式的��序与输入的��序�q�不相同�Q�但该方法仍然找��C��适当的模式，�q�据此进行解析�?br />　　最后，我们按照ISO_TIME_NO_T_FORMAT格式�Q�HH:mm:ss�Q�对日期�q�行格式化�ƈ打印输入。现在我们将了解使用Lang生成常用�Ҏ��toString()�?br />
生成toString()�Ҏ��
　　�l�常要用到equals()、toString()和hashCode()�Ҏ��。不�q�，谈到实际�~�写�q�些�Ҏ��的实现时�Q�不仅我们大多数��Z��愿意�q�样做，而且我们也不能确定如何准��简单地�~�写�q�些�Ҏ��。生成器�E�序包提供了一些实用类�Q�可以帮助您方便地创��些方法的实现。大多数情况下，只需要一行代码即可。下面我们将了解Lang的toString功能�?br />
toString()�Ҏ��
　　您可能没有注意到�Q�在清单4中，即��我们向System.out.println()传递一个java.util.Date对象�Q�所获得的输��Z��然是正确的日期和旉��昄��。传递对象引用时�Q�将自动调用toString()�Ҏ��Q�所以可以实现这一炏V��那么，在我们的�C�Z��中实际上调用了java.util.Date�cȝ��toString()�Ҏ��Q�我们能够得到正��的输出是因为有人重写了java.util.Date�c�M��的java.lang.Object�cȝ��toString()�Ҏ��?
　　如果没有重写toString()�Ҏ��Q�则获得的输出只是类名称和hashcode的名�U�。将不会昄��c�M��的�Q何数据。所以，如果�~�写了一个新�c�，且希望能得到正确的打印输出，则需要重写该�c�M��的toString()�Ҏ��?

清单6. toString()�Ҏ��
public class Computer { String processor; String color; int cost; /** Creates a new instance of Computer */ public Computer(String processor, String color, int cost) { this.processor=processor; this.color=color; this.cost=cost; } public static void main(String[] args) { Computer myComp=new Computer("Pentium","black",1000); System.out.println(myComp); } public String toString(){ return ToStringBuilder.reflectionToString(this); /* return ToStringBuilder.reflectionToString(this , ToStringStyle.SHORT_PREFIX_STYLE); return ToStringBuilder.reflectionToString(this , ToStringStyle.MULTI_LINE_STYLE); return new ToStringBuilder(this) .append("processor", processor).toString(); */ } }
　　清单6演示了具有三个字�D늚�Computer�c�R��其中值得��x��的是toString()�Ҏ��。调用reflectionToString()�Ҏ��可以判断哪些是类中的字段�Q�然后打印其名称和倹{��main()�Ҏ��中，我们只创��Z��该类的一个实例，然后��其打印出来。该�cȝ��输出为dev2dev.Computer@f6a746[processor=Pentium,color=black,cost=1000]�?br />　　因而，如果不希望花太多�_�֊��Q�但又需要您的类有toString()实现�Q�最��单的�Ҏ��莫过于将�q�两行代码复制�ƈ�_�脓到您的所有类中。如果希望更好地控制生成的结果，请参见注释中提到的选项。通过创徏ToStringBuilder的新实例�Q�可以对输出应用各种样式�Q�甚至生成全部输出。如果按照列出的��序执行了全部四个返回语句，则输出如清单7所�C��?br />
清单7. ��Z��ToStringBuilder�Ҏ��的四个可能输�?/strong>
1) dev2dev.Computer@f6a746[processor=Pentium,color=black,cost=1000] 2) Computer[processor=Pentium,color=black,cost=1000] 3) dev2dev.Computer@f6a746[ processor=Pentium color=black cost=1000 ] 4) dev2dev.Computer@192d342[processor=Pentium]
对象比较与排�?/strong>
　　�l�常需要对数据对象�q�行比较�Q��ƈ据此�q�行排序。那么我们如何对清单6中所�l�出的Computer�cȝ��对象�q�行比较和排序呢�Q?
　　您猜猜！让我们��用Lang�Ҏ��计算机的成本对Computer对象�q�行排序。若要比较对象，需要实现java.lang.Comparable接口。此接口��h��惟一的方法compareTo(Object)。此�Ҏ��实现��当前对象和传递给此方法的对象�q�行比较。如果此对象��于、等于或大于指定的对象，此方法将分别�q�回负数、零或正数�?
　　��Z��对Computer对象�q�行比较�Q�在Computer�c�M��实现compareTo() �Ҏ��Q�如清单8所�C��?br />
清单8. compareTo()�Ҏ��
public int compareTo(Object obj) { Computer anotherComputer = (Computer)obj; //return new CompareToBuilder().reflectionCompare (this, anotherComputer); return new CompareToBuilder(). append(this.cost, anotherComputer.cost).toComparison(); }
　　然后�Q��ؓ了实际进行比较，我们�~�写一个名为ComputerSor的简单类�Q�如清单9中所�C�。我们只向ArrayList��d��三个对象�Q�然后进行排序�?br />
清单9. ComputerSort�c?/strong>
public class ComputerSort { public static void main(String[] args) { ArrayList computerList = new ArrayList(); computerList.add(new Computer("Pentium","black", 1000)); computerList.add(new Computer("Pentium","chocolate", 334)); computerList.add(new Computer("Pentium","darkgray", 2234)); Collections.sort(computerList); System.out.println(computerList); } }
　　执行ComputerSort�Ӟ��看到对象根据cost字段的��D��行了排序。CompareToBuilder与ToStringBuilder�c�M��Q�也有一个基于反��的用法选项。我们已�Ҏ��?中的compareTo()�Ҏ��中的位元�q�行了注释，因�ؓ�Q�在此种情况下，反射选项��比较所有字�D�，最�l�获得不正确的结果。如果既不希望比较当前类中的字段�Q�也不希望比较其��类中的字段�Q�CompareToBuilder也提供了可以用于此用途的�Ҏ��。执行ComputerSort�cȝ��输出如清�?0中所�C��?br />
清单10. 排序后的Computer对象
[dev2dev.Computer@cf2c80[processor=Pentium,color=chocolate,cost=334] , dev2dev.Computer@12dacd1[processor=Pentium,color=black,cost=1000] , dev2dev.Computer@1ad086a[processor=Pentium,color=darkgray,cost=2234]]
�l�束�?/strong>
　　本文中，我们了解了Jakarta Commons Lang�l��g的一些主要功能。�ȝ��说来�Q�Commons��目是非常有用的��目�Q�但�q�没有得到充分利用。虽然开源项目��用了许多Commons�l��g�Q�但其在开源世界之外的应用�q�不十分�q�泛。现在您已经对Lang的功能有所了解�Q�应该考虑立即��其应用到您的应用程序中。另外，�q�可以在Commons��目中寻扑֐��U�有用的�l��g�Q�从而简化XML解析、��应用�E�序�q�行HTTP会话、实现系�l�化验证以及执行很多其他功能�?br />
下蝲
　　下蝲本文中用到的代码�Q?a >examples.zip (3KB)

参考资�?/strong>
Jakarta Commons
Jakarta Commons Lang
　　Harshad Oak是Java J2EE门户�|�站IndicThreads.com的创始�h。他�~�写了Pro Jakarta Commons和Oracle JDeveloper 10g:Empowering J2EE Development�Q��ƈ与�h合著了Java 2 Enterprise Edition 1.4 Bible。他�q�是Rightrix Solutions的创始�h�?
原文出处
http://dev2dev.bea.com/pub/a/2005/04/commons_lang.html

★yesjoy�?/a> 2007-01-11 16:26 发表评论

久久亚洲精品中文字幕,亚洲区日韩精品中文字幕,五月婷婷亚洲综合

利用Jakarta Commons Lang���化Java

利用Jakarta Commons Lang��化Java