提供静态方法访问单例对象中的方法

1. PropertyUtils 就是此列
3. /*
4. *LicensedtotheApacheSoftwareFoundation(ASF)underoneormore
5. *contributorlicenseagreements.SeetheNOTICEfiledistributedwith
6. *thisworkforadditionalinformationregardingcopyrightownership.
7. *TheASFlicensesthisfiletoYouundertheApacheLicense,Version2.0
8. *(the"License");youmaynotusethisfileexceptincompliancewith
9. *theLicense.YoumayobtainacopyoftheLicenseat
10. *
11. *http://www.apache.org/licenses/LICENSE-2.0
12. *
13. *Unlessrequiredbyapplicablelaworagreedtoinwriting,software
14. *distributedundertheLicenseisdistributedonan"ASIS"BASIS,
15. *WITHOUTWARRANTIESORCONDITIONSOFANYKIND,eitherexpressorimplied.
16. *SeetheLicenseforthespecificlanguagegoverningpermissionsand
17. *limitationsundertheLicense.
18. */
21. packageorg.apache.commons.beanutils;
23. importjava.beans.PropertyDescriptor;
24. importjava.lang.reflect.InvocationTargetException;
25. importjava.lang.reflect.Method;
26. importjava.util.Map;
28. importorg.apache.commons.collections.FastHashMap;
31. /**
32. *<p>UtilitymethodsforusingJavaReflectionAPIstofacilitategeneric
33. *propertygetterandsetteroperationsonJavaobjects.</p>
34. *
35. *<p>Theimplementationsforthesemethodsareprovidedby<code>PropertyUtilsBean</code>.
36. *Formoredetailssee{@linkPropertyUtilsBean}.</p>
37. *
38. *@authorCraigR.McClanahan
39. *@authorRalphSchaer
40. *@authorChrisAudley
41. *@authorReyFrancois
42. *@authorGregorRayman
43. *@authorJanSorensen
44. *@authorScottSanders
45. *@version$Revision:644137$$Date:2008-04-0303:30:23+0100(Thu,03Apr2008)$
46. *@seePropertyUtilsBean
47. *@seeorg.apache.commons.beanutils.expression.Resolver
48. */
50. publicclass
51. {
54. //-----------------------------------------------------ManifestConstants
57. /**
58. *Thedelimiterthatpreceedsthezero-relativesubscriptforan
59. *indexedreference.
60. *
61. *@deprecatedThenotationusedforpropertynameexpressionsisnow
62. *dependantonthe{@linkorg.apache.commons.beanutils.expression.Resolver}
63. *implementationbeingused.
64. */
65. publicstaticfinalcharINDEXED_DELIM='[';
68. /**
69. *Thedelimiterthatfollowsthezero-relativesubscriptforan
70. *indexedreference.
71. *
72. *@deprecatedThenotationusedforpropertynameexpressionsisnow
73. *dependantonthe{@linkorg.apache.commons.beanutils.expression.Resolver}
74. *implementationbeingused.
75. */
76. publicstaticfinalcharINDEXED_DELIM2=']';
79. /**
80. *Thedelimiterthatpreceedsthekeyofamappedproperty.
81. *
82. *@deprecatedThenotationusedforpropertynameexpressionsisnow
83. *dependantonthe{@linkorg.apache.commons.beanutils.expression.Resolver}
84. *implementationbeingused.
85. */
86. publicstaticfinalcharMAPPED_DELIM='(';
89. /**
90. *Thedelimiterthatfollowsthekeyofamappedproperty.
91. *
92. *@deprecatedThenotationusedforpropertynameexpressionsisnow
93. *dependantonthe{@linkorg.apache.commons.beanutils.expression.Resolver}
94. *implementationbeingused.
95. */
96. publicstaticfinalcharMAPPED_DELIM2=')';
99. /**
100. *Thedelimiterthatseparatesthecomponentsofanestedreference.
101. *
102. *@deprecatedThenotationusedforpropertynameexpressionsisnow
103. *dependantonthe{@linkorg.apache.commons.beanutils.expression.Resolver}
104. *implementationbeingused.
105. */
106. publicstaticfinalcharNESTED_DELIM='.';
109. //-------------------------------------------------------StaticVariables
112. /**
113. *Thedebuggingdetaillevelforthiscomponent.
114. *
115. *Notethatthisstaticvariablewillhaveunexpectedside-effectsif
116. *thisclassisdeployedinasharedclassloaderwithinacontainer.
117. *Howeverasitisactuallycompletelyignoredbythisclassduetoits
118. *deprecatedstatus,itdoesn'tdoanyactualharm.
119. *
120. *@deprecatedThe<code>debug</code>staticpropertyisnolongerused
121. */
122. privatestaticintdebug=0;
124. /**
125. *The<code>debug</code>staticpropertyisnolongerused
126. *@returndebugproperty
127. *@deprecatedThe<code>debug</code>staticpropertyisnolongerused
128. */
129. publicstaticintgetDebug(){
130. return(debug);
131. }
133. /**
134. *The<code>debug</code>staticpropertyisnolongerused
135. *@paramnewDebugdebugproperty
136. *@deprecatedThe<code>debug</code>staticpropertyisnolongerused
137. */
138. publicstaticvoidsetDebug(intnewDebug){
139. debug=newDebug;
140. }
142. //---------------------------------------------------------PublicMethods
145. /**
146. *Clearanycachedpropertydescriptorsinformationforallclasses
147. *loadedbyanyclassloaders.Thisisusefulincaseswhereclass
148. *loadersarethrownawaytoimplementclassreloading.
149. *
150. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
151. *
152. *@seePropertyUtilsBean#clearDescriptors
153. */
154. publicstaticvoidclearDescriptors(){
156. PropertyUtilsBean.getInstance().clearDescriptors();
158. }
161. /**
162. *<p>Copypropertyvaluesfromthe"origin"beantothe"destination"bean
163. *forallcaseswherethepropertynamesarethesame(eventhoughthe
164. *actualgetterandsettermethodsmighthavebeencustomizedvia
165. *<code>BeanInfo</code>classes).</p>
166. *
167. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
168. *
169. *@paramdestDestinationbeanwhosepropertiesaremodified
170. *@paramorigOriginbeanwhosepropertiesareretrieved
171. *
172. *@exceptionIllegalAccessExceptionifthecallerdoesnothave
173. *accesstothepropertyaccessormethod
174. *@exceptionIllegalArgumentExceptionifthe<code>dest</code>or
175. *<code>orig</code>argumentisnull
176. *@exceptionInvocationTargetExceptionifthepropertyaccessormethod
177. *throwsanexception
178. *@exceptionNoSuchMethodExceptionifanaccessormethodforthis
179. *propetycannotbefound
180. *@seePropertyUtilsBean#copyProperties
181. */
182. publicstaticvoidcopyProperties(Objectdest,Objectorig)
183. throwsIllegalAccessException,InvocationTargetException,
184. NoSuchMethodException{
186. PropertyUtilsBean.getInstance().copyProperties(dest,orig);
187. }
190. /**
191. *<p>Returntheentiresetofpropertiesforwhichthespecifiedbean
192. *providesareadmethod.</p>
193. *
194. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
195. *
196. *@parambeanBeanwhosepropertiesaretobeextracted
197. *@returnThesetofpropertiesforthebean
198. *
199. *@exceptionIllegalAccessExceptionifthecallerdoesnothave
200. *accesstothepropertyaccessormethod
201. *@exceptionIllegalArgumentExceptionif<code>bean</code>isnull
202. *@exceptionInvocationTargetExceptionifthepropertyaccessormethod
203. *throwsanexception
204. *@exceptionNoSuchMethodExceptionifanaccessormethodforthis
205. *propetycannotbefound
206. *@seePropertyUtilsBean#describe
207. */
208. publicstaticMapdescribe(Objectbean)
209. throwsIllegalAccessException,InvocationTargetException,
210. NoSuchMethodException{
212. return(PropertyUtilsBean.getInstance().describe(bean));
214. }
217. /**
218. *<p>Returnthevalueofthespecifiedindexedpropertyofthespecified
219. *bean,withnotypeconversions.</p>
220. *
221. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
222. *
223. *@parambeanBeanwhosepropertyistobeextracted
224. *@paramname<code>propertyname[index]</code>ofthepropertyvalue
225. *tobeextracted
226. *@returntheindexedpropertyvalue
227. *
228. *@exceptionIndexOutOfBoundsExceptionifthespecifiedindex
229. *isoutsidethevalidrangefortheunderlyingproperty
230. *@exceptionIllegalAccessExceptionifthecallerdoesnothave
231. *accesstothepropertyaccessormethod
232. *@exceptionIllegalArgumentExceptionif<code>bean</code>or
233. *<code>name</code>isnull
234. *@exceptionInvocationTargetExceptionifthepropertyaccessormethod
235. *throwsanexception
236. *@exceptionNoSuchMethodExceptionifanaccessormethodforthis
237. *propetycannotbefound
238. *@seePropertyUtilsBean#getIndexedProperty(Object,String)
239. */
240. publicstaticObjectgetIndexedProperty(Objectbean,Stringname)
241. throwsIllegalAccessException,InvocationTargetException,
242. NoSuchMethodException{
244. return(PropertyUtilsBean.getInstance().getIndexedProperty(bean,name));
246. }
249. /**
250. *<p>Returnthevalueofthespecifiedindexedpropertyofthespecified
251. *bean,withnotypeconversions.</p>
252. *
253. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
254. *
255. *@parambeanBeanwhosepropertyistobeextracted
256. *@paramnameSimplepropertynameofthepropertyvaluetobeextracted
257. *@paramindexIndexofthepropertyvaluetobeextracted
258. *@returntheindexedpropertyvalue
259. *
260. *@exceptionIndexOutOfBoundsExceptionifthespecifiedindex
261. *isoutsidethevalidrangefortheunderlyingproperty
262. *@exceptionIllegalAccessExceptionifthecallerdoesnothave
263. *accesstothepropertyaccessormethod
264. *@exceptionIllegalArgumentExceptionif<code>bean</code>or
265. *<code>name</code>isnull
266. *@exceptionInvocationTargetExceptionifthepropertyaccessormethod
267. *throwsanexception
268. *@exceptionNoSuchMethodExceptionifanaccessormethodforthis
269. *propetycannotbefound
270. *@seePropertyUtilsBean#getIndexedProperty(Object,String,int)
271. */
272. publicstaticObjectgetIndexedProperty(Objectbean,
273. Stringname,intindex)
274. throwsIllegalAccessException,InvocationTargetException,
275. NoSuchMethodException{
277. return(PropertyUtilsBean.getInstance().getIndexedProperty(bean,name,index));
278. }
281. /**
282. *<p>Returnthevalueofthespecifiedmappedpropertyofthe
283. *specifiedbean,withnotypeconversions.</p>
284. *
285. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
286. *
287. *@parambeanBeanwhosepropertyistobeextracted
288. *@paramname<code>propertyname(key)</code>ofthepropertyvalue
289. *tobeextracted
290. *@returnthemappedpropertyvalue
291. *
292. *@exceptionIllegalAccessExceptionifthecallerdoesnothave
293. *accesstothepropertyaccessormethod
294. *@exceptionInvocationTargetExceptionifthepropertyaccessormethod
295. *throwsanexception
296. *@exceptionNoSuchMethodExceptionifanaccessormethodforthis
297. *propetycannotbefound
298. *@seePropertyUtilsBean#getMappedProperty(Object,String)
299. */
300. publicstaticObjectgetMappedProperty(Objectbean,Stringname)
301. throwsIllegalAccessException,InvocationTargetException,
302. NoSuchMethodException{
304. return(PropertyUtilsBean.getInstance().getMappedProperty(bean,name));
306. }
309. /**
310. *<p>Returnthevalueofthespecifiedmappedpropertyofthespecified
311. *bean,withnotypeconversions.</p>
312. *
313. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
314. *
315. *@parambeanBeanwhosepropertyistobeextracted
316. *@paramnameMappedpropertynameofthepropertyvaluetobeextracted
317. *@paramkeyKeyofthepropertyvaluetobeextracted
318. *@returnthemappedpropertyvalue
319. *
320. *@exceptionIllegalAccessExceptionifthecallerdoesnothave
321. *accesstothepropertyaccessormethod
322. *@exceptionInvocationTargetExceptionifthepropertyaccessormethod
323. *throwsanexception
324. *@exceptionNoSuchMethodExceptionifanaccessormethodforthis
325. *propetycannotbefound
326. *@seePropertyUtilsBean#getMappedProperty(Object,String,String)
327. */
328. publicstaticObjectgetMappedProperty(Objectbean,
329. Stringname,Stringkey)
330. throwsIllegalAccessException,InvocationTargetException,
331. NoSuchMethodException{
333. returnPropertyUtilsBean.getInstance().getMappedProperty(bean,name,key);
335. }
338. /**
339. *<p>Returnthemappedpropertydescriptorsforthisbeanclass.</p>
340. *
341. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
342. *
343. *@parambeanClassBeanclasstobeintrospected
344. *@returnthemappedpropertydescriptors
345. *@seePropertyUtilsBean#getMappedPropertyDescriptors(Class)
346. *@deprecatedThismethodshouldnotbeexposed
347. */
348. publicstaticFastHashMapgetMappedPropertyDescriptors(ClassbeanClass){
350. returnPropertyUtilsBean.getInstance().getMappedPropertyDescriptors(beanClass);
352. }
355. /**
356. *<p>Returnthemappedpropertydescriptorsforthisbean.</p>
357. *
358. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
359. *
360. *@parambeanBeantobeintrospected
361. *@returnthemappedpropertydescriptors
362. *@seePropertyUtilsBean#getMappedPropertyDescriptors(Object)
363. *@deprecatedThismethodshouldnotbeexposed
364. */
365. publicstaticFastHashMapgetMappedPropertyDescriptors(Objectbean){
367. returnPropertyUtilsBean.getInstance().getMappedPropertyDescriptors(bean);
369. }
372. /**
373. *<p>Returnthevalueofthe(possiblynested)propertyofthespecified
374. *name,forthespecifiedbean,withnotypeconversions.</p>
375. *
376. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
377. *
378. *@parambeanBeanwhosepropertyistobeextracted
379. *@paramnamePossiblynestednameofthepropertytobeextracted
380. *@returnthenestedpropertyvalue
381. *
382. *@exceptionIllegalAccessExceptionifthecallerdoesnothave
383. *accesstothepropertyaccessormethod
384. *@exceptionIllegalArgumentExceptionif<code>bean</code>or
385. *<code>name</code>isnull
386. *@exceptionNestedNullExceptionifanestedreferencetoa
387. *propertyreturnsnull
388. *@exceptionInvocationTargetException
389. *ifthepropertyaccessormethodthrowsanexception
390. *@exceptionNoSuchMethodExceptionifanaccessormethodforthis
391. *propetycannotbefound
392. *@seePropertyUtilsBean#getNestedProperty
393. */
394. publicstaticObjectgetNestedProperty(Objectbean,Stringname)
395. throwsIllegalAccessException,InvocationTargetException,
396. NoSuchMethodException{
398. returnPropertyUtilsBean.getInstance().getNestedProperty(bean,name);
400. }
403. /**
404. *<p>Returnthevalueofthespecifiedpropertyofthespecifiedbean,
405. *nomatterwhichpropertyreferenceformatisused,withno
406. *typeconversions.</p>
407. *
408. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
409. *
410. *@parambeanBeanwhosepropertyistobeextracted
411. *@paramnamePossiblyindexedand/ornestednameoftheproperty
412. *tobeextracted
413. *@returnthepropertyvalue
414. *
415. *@exceptionIllegalAccessExceptionifthecallerdoesnothave
416. *accesstothepropertyaccessormethod
417. *@exceptionIllegalArgumentExceptionif<code>bean</code>or
418. *<code>name</code>isnull
419. *@exceptionInvocationTargetExceptionifthepropertyaccessormethod
420. *throwsanexception
421. *@exceptionNoSuchMethodExceptionifanaccessormethodforthis
422. *propetycannotbefound
423. *@seePropertyUtilsBean#getProperty
424. */
425. publicstaticObjectgetProperty(Objectbean,Stringname)
426. throwsIllegalAccessException,InvocationTargetException,
427. NoSuchMethodException{
429. return(PropertyUtilsBean.getInstance().getProperty(bean,name));
431. }
434. /**
435. *<p>Retrievethepropertydescriptorforthespecifiedpropertyofthe
436. *specifiedbean,orreturn<code>null</code>ifthereisnosuch
437. *descriptor.</p>
438. *
439. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
440. *
441. *@parambeanBeanforwhichapropertydescriptorisrequested
442. *@paramnamePossiblyindexedand/ornestednameofthepropertyfor
443. *whichapropertydescriptorisrequested
444. *@returnthepropertydescriptor
445. *
446. *@exceptionIllegalAccessExceptionifthecallerdoesnothave
447. *accesstothepropertyaccessormethod
448. *@exceptionIllegalArgumentExceptionif<code>bean</code>or
449. *<code>name</code>isnull
450. *@exceptionIllegalArgumentExceptionifanestedreferencetoa
451. *propertyreturnsnull
452. *@exceptionInvocationTargetExceptionifthepropertyaccessormethod
453. *throwsanexception
454. *@exceptionNoSuchMethodExceptionifanaccessormethodforthis
455. *propetycannotbefound
456. *@seePropertyUtilsBean#getPropertyDescriptor
457. */
458. publicstaticPropertyDescriptorgetPropertyDescriptor(Objectbean,
459. Stringname)
460. throwsIllegalAccessException,InvocationTargetException,
461. NoSuchMethodException{
463. returnPropertyUtilsBean.getInstance().getPropertyDescriptor(bean,name);
465. }
468. /**
469. *<p>Retrievethepropertydescriptorsforthespecifiedclass,
470. *introspectingandcachingthemthefirsttimeaparticularbeanclass
471. *isencountered.</p>
472. *
473. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
474. *
475. *@parambeanClassBeanclassforwhichpropertydescriptorsarerequested
476. *@returnthepropertydescriptors
477. *@exceptionIllegalArgumentExceptionif<code>beanClass</code>isnull
478. *@seePropertyUtilsBean#getPropertyDescriptors(Class)
479. */
480. publicstaticPropertyDescriptor[]
481. getPropertyDescriptors(ClassbeanClass){
483. returnPropertyUtilsBean.getInstance().getPropertyDescriptors(beanClass);
485. }
488. /**
489. *<p>Retrievethepropertydescriptorsforthespecifiedbean,
490. *introspectingandcachingthemthefirsttimeaparticularbeanclass
491. *isencountered.</p>
492. *
493. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
494. *
495. *@parambeanBeanforwhichpropertydescriptorsarerequested
496. *@returnthepropertydescriptors
497. *@exceptionIllegalArgumentExceptionif<code>bean</code>isnull
498. *@seePropertyUtilsBean#getPropertyDescriptors(Object)
499. */
500. publicstaticPropertyDescriptor[]getPropertyDescriptors(Objectbean){
502. returnPropertyUtilsBean.getInstance().getPropertyDescriptors(bean);
504. }
507. /**
508. *<p>ReturntheJavaClassrepesentingthepropertyeditorclassthathas
509. *beenregisteredforthisproperty(ifany).</p>
510. *
511. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
512. *
513. *@parambeanBeanforwhichapropertydescriptorisrequested
514. *@paramnamePossiblyindexedand/ornestednameofthepropertyfor
515. *whichapropertydescriptorisrequested
516. *@returnthepropertyeditorclass
517. *
518. *@exceptionIllegalAccessExceptionifthecallerdoesnothave
519. *accesstothepropertyaccessormethod
520. *@exceptionIllegalArgumentExceptionif<code>bean</code>or
521. *<code>name</code>isnull
522. *@exceptionIllegalArgumentExceptionifanestedreferencetoa
523. *propertyreturnsnull
524. *@exceptionInvocationTargetExceptionifthepropertyaccessormethod
525. *throwsanexception
526. *@exceptionNoSuchMethodExceptionifanaccessormethodforthis
527. *propetycannotbefound
528. *@seePropertyUtilsBean#getPropertyEditorClass(Object,String)
529. */
530. publicstaticClassgetPropertyEditorClass(Objectbean,Stringname)
531. throwsIllegalAccessException,InvocationTargetException,
532. NoSuchMethodException{
534. returnPropertyUtilsBean.getInstance().getPropertyEditorClass(bean,name);
536. }
539. /**
540. *<p>ReturntheJavaClassrepresentingthepropertytypeofthespecified
541. *property,or<code>null</code>ifthereisnosuchpropertyforthe
542. *specifiedbean.</p>
543. *
544. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
545. *
546. *@parambeanBeanforwhichapropertydescriptorisrequested
547. *@paramnamePossiblyindexedand/ornestednameofthepropertyfor
548. *whichapropertydescriptorisrequested
549. *@returnThepropertytype
550. *
551. *@exceptionIllegalAccessExceptionifthecallerdoesnothave
552. *accesstothepropertyaccessormethod
553. *@exceptionIllegalArgumentExceptionif<code>bean</code>or
554. *<code>name</code>isnull
555. *@exceptionIllegalArgumentExceptionifanestedreferencetoa
556. *propertyreturnsnull
557. *@exceptionInvocationTargetExceptionifthepropertyaccessormethod
558. *throwsanexception
559. *@exceptionNoSuchMethodExceptionifanaccessormethodforthis
560. *propetycannotbefound
561. *@seePropertyUtilsBean#getPropertyType(Object,String)
562. */
563. publicstaticClassgetPropertyType(Objectbean,Stringname)
564. throwsIllegalAccessException,InvocationTargetException,
565. NoSuchMethodException{
567. returnPropertyUtilsBean.getInstance().getPropertyType(bean,name);
568. }
571. /**
572. *<p>Returnanaccessiblepropertygettermethodforthisproperty,
573. *ifthereisone;otherwisereturn<code>null</code>.</p>
574. *
575. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
576. *
577. *@paramdescriptorPropertydescriptortoreturnagetterfor
578. *@returnThereadmethod
579. *@seePropertyUtilsBean#getReadMethod(PropertyDescriptor)
580. */
581. publicstaticMethodgetReadMethod(PropertyDescriptordescriptor){
583. return(PropertyUtilsBean.getInstance().getReadMethod(descriptor));
585. }
588. /**
589. *<p>Returnthevalueofthespecifiedsimplepropertyofthespecified
590. *bean,withnotypeconversions.</p>
591. *
592. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
593. *
594. *@parambeanBeanwhosepropertyistobeextracted
595. *@paramnameNameofthepropertytobeextracted
596. *@returnThepropertyvalue
597. *
598. *@exceptionIllegalAccessExceptionifthecallerdoesnothave
599. *accesstothepropertyaccessormethod
600. *@exceptionIllegalArgumentExceptionif<code>bean</code>or
601. *<code>name</code>isnull
602. *@exceptionIllegalArgumentExceptionifthepropertyname
603. *isnestedorindexed
604. *@exceptionInvocationTargetExceptionifthepropertyaccessormethod
605. *throwsanexception
606. *@exceptionNoSuchMethodExceptionifanaccessormethodforthis
607. *propetycannotbefound
608. *@seePropertyUtilsBean#getSimpleProperty
609. */
610. publicstaticObjectgetSimpleProperty(Objectbean,Stringname)
611. throwsIllegalAccessException,InvocationTargetException,
612. NoSuchMethodException{
614. returnPropertyUtilsBean.getInstance().getSimpleProperty(bean,name);
616. }
619. /**
620. *<p>Returnanaccessiblepropertysettermethodforthisproperty,
621. *ifthereisone;otherwisereturn<code>null</code>.</p>
622. *
623. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
624. *
625. *@paramdescriptorPropertydescriptortoreturnasetterfor
626. *@returnThewritemethod
627. *@seePropertyUtilsBean#getWriteMethod(PropertyDescriptor)
628. */
629. publicstaticMethodgetWriteMethod(PropertyDescriptordescriptor){
631. returnPropertyUtilsBean.getInstance().getWriteMethod(descriptor);
633. }
636. /**
637. *<p>Return<code>true</code>ifthespecifiedpropertynameidentifies
638. *areadablepropertyonthespecifiedbean;otherwise,return
639. *<code>false</code>.</p>
640. *
641. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
642. *
643. *@parambeanBeantobeexamined(maybea{@linkDynaBean}
644. *@paramnamePropertynametobeevaluated
645. *@return<code>true</code>ifthepropertyisreadable,
646. *otherwise<code>false</code>
647. *
648. *@exceptionIllegalArgumentExceptionif<code>bean</code>
649. *or<code>name</code>is<code>null</code>
650. *@seePropertyUtilsBean#isReadable
651. *@sinceBeanUtils1.6
652. */
653. publicstaticbooleanisReadable(Objectbean,Stringname){
655. returnPropertyUtilsBean.getInstance().isReadable(bean,name);
656. }
659. /**
660. *<p>Return<code>true</code>ifthespecifiedpropertynameidentifies
661. *awriteablepropertyonthespecifiedbean;otherwise,return
662. *<code>false</code>.</p>
663. *
664. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
665. *
666. *@parambeanBeantobeexamined(maybea{@linkDynaBean}
667. *@paramnamePropertynametobeevaluated
668. *@return<code>true</code>ifthepropertyiswriteable,
669. *otherwise<code>false</code>
670. *
671. *@exceptionIllegalArgumentExceptionif<code>bean</code>
672. *or<code>name</code>is<code>null</code>
673. *@seePropertyUtilsBean#isWriteable
674. *@sinceBeanUtils1.6
675. */
676. publicstaticbooleanisWriteable(Objectbean,Stringname){
678. returnPropertyUtilsBean.getInstance().isWriteable(bean,name);
679. }
682. /**
683. *<p>Setsthevalueofthespecifiedindexedpropertyofthespecified
684. *bean,withnotypeconversions.</p>
685. *
686. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
687. *
688. *@parambeanBeanwhosepropertyistobemodified
689. *@paramname<code>propertyname[index]</code>ofthepropertyvalue
690. *tobemodified
691. *@paramvalueValuetowhichthespecifiedpropertyelement
692. *shouldbeset
693. *
694. *@exceptionIndexOutOfBoundsExceptionifthespecifiedindex
695. *isoutsidethevalidrangefortheunderlyingproperty
696. *@exceptionIllegalAccessExceptionifthecallerdoesnothave
697. *accesstothepropertyaccessormethod
698. *@exceptionIllegalArgumentExceptionif<code>bean</code>or
699. *<code>name</code>isnull
700. *@exceptionInvocationTargetExceptionifthepropertyaccessormethod
701. *throwsanexception
702. *@exceptionNoSuchMethodExceptionifanaccessormethodforthis
703. *propetycannotbefound
704. *@seePropertyUtilsBean#setIndexedProperty(Object,String,Object)
705. */
706. publicstaticvoidsetIndexedProperty(Objectbean,Stringname,
707. Objectvalue)
708. throwsIllegalAccessException,InvocationTargetException,
709. NoSuchMethodException{
711. PropertyUtilsBean.getInstance().setIndexedProperty(bean,name,value);
713. }
716. /**
717. *<p>Setsthevalueofthespecifiedindexedpropertyofthespecified
718. *bean,withnotypeconversions.</p>
719. *
720. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
721. *
722. *@parambeanBeanwhosepropertyistobeset
723. *@paramnameSimplepropertynameofthepropertyvaluetobeset
724. *@paramindexIndexofthepropertyvaluetobeset
725. *@paramvalueValuetowhichtheindexedpropertyelementistobeset
726. *
727. *@exceptionIndexOutOfBoundsExceptionifthespecifiedindex
728. *isoutsidethevalidrangefortheunderlyingproperty
729. *@exceptionIllegalAccessExceptionifthecallerdoesnothave
730. *accesstothepropertyaccessormethod
731. *@exceptionIllegalArgumentExceptionif<code>bean</code>or
732. *<code>name</code>isnull
733. *@exceptionInvocationTargetExceptionifthepropertyaccessormethod
734. *throwsanexception
735. *@exceptionNoSuchMethodExceptionifanaccessormethodforthis
736. *propetycannotbefound
737. *@seePropertyUtilsBean#setIndexedProperty(Object,String,Object)
738. */
739. publicstaticvoidsetIndexedProperty(Objectbean,Stringname,
740. intindex,Objectvalue)
741. throwsIllegalAccessException,InvocationTargetException,
742. NoSuchMethodException{
744. PropertyUtilsBean.getInstance().setIndexedProperty(bean,name,index,value);
745. }
748. /**
749. *<p>Setsthevalueofthespecifiedmappedpropertyofthe
750. *specifiedbean,withnotypeconversions.</p>
751. *
752. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
753. *
754. *@parambeanBeanwhosepropertyistobeset
755. *@paramname<code>propertyname(key)</code>ofthepropertyvalue
756. *tobeset
757. *@paramvalueThepropertyvaluetobeset
758. *
759. *@exceptionIllegalAccessExceptionifthecallerdoesnothave
760. *accesstothepropertyaccessormethod
761. *@exceptionInvocationTargetExceptionifthepropertyaccessormethod
762. *throwsanexception
763. *@exceptionNoSuchMethodExceptionifanaccessormethodforthis
764. *propetycannotbefound
765. *@seePropertyUtilsBean#setMappedProperty(Object,String,Object)
766. */
767. publicstaticvoidsetMappedProperty(Objectbean,Stringname,
768. Objectvalue)
769. throwsIllegalAccessException,InvocationTargetException,
770. NoSuchMethodException{
772. PropertyUtilsBean.getInstance().setMappedProperty(bean,name,value);
773. }
776. /**
777. *<p>Setsthevalueofthespecifiedmappedpropertyofthespecified
778. *bean,withnotypeconversions.</p>
779. *
780. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
781. *
782. *@parambeanBeanwhosepropertyistobeset
783. *@paramnameMappedpropertynameofthepropertyvaluetobeset
784. *@paramkeyKeyofthepropertyvaluetobeset
785. *@paramvalueThepropertyvaluetobeset
786. *
787. *@exceptionIllegalAccessExceptionifthecallerdoesnothave
788. *accesstothepropertyaccessormethod
789. *@exceptionInvocationTargetExceptionifthepropertyaccessormethod
790. *throwsanexception
791. *@exceptionNoSuchMethodExceptionifanaccessormethodforthis
792. *propetycannotbefound
793. *@seePropertyUtilsBean#setMappedProperty(Object,String,String,Object)
794. */
795. publicstaticvoidsetMappedProperty(Objectbean,Stringname,
796. Stringkey,Objectvalue)
797. throwsIllegalAccessException,InvocationTargetException,
798. NoSuchMethodException{
800. PropertyUtilsBean.getInstance().setMappedProperty(bean,name,key,value);
801. }
804. /**
805. *<p>Setsthevalueofthe(possiblynested)propertyofthespecified
806. *name,forthespecifiedbean,withnotypeconversions.</p>
807. *
808. *<p>Formoredetailssee<code>PropertyUtilsBean</code>.</p>
809. *
810. *@parambeanBeanwhosepropertyistobemodified
811. *@paramnamePossiblynestednameofthepropertytobemodified
812. *@paramvalueValuetowhichthepropertyistobeset