स्विंग फॉर्म रिफ्लेक्टिव लाइब्रेरी

कुछ समय पहले, यह मेरे लिए हुआ था कि जावा स्विंग में जल्दी से फॉर्म बनाने के लिए एक लाइब्रेरी बनाई जाए। मैं आपको बताऊंगा कि मैं कैसे आया।

समस्या का बयान

निश्चित रूप से, कई को समय-समय पर स्विंग-घटकों का उपयोग करके संपादन जावा-बीन्स को लागू करना पड़ता है। उदाहरण के लिए, विभिन्न निर्देशिकाएं। JDK रूढ़िवादी है, और "आउट ऑफ द बॉक्स" ऐसा कुछ प्रदान नहीं करता है जो डेवलपर के जीवन को बहुत आसान बना देगा। प्रत्येक मामले के लिए, आपको कुछ लिखने की आवश्यकता है:

GridBagPanel panel = new GridBagPanel(){{ add( new JLabel( "Name" ), 0, 0 ); add( new JTextField( person.getName() ) {{ getDocument().addDocumentListener( new DocumentListener() { public void insertUpdate( final DocumentEvent e ) { person.setName( getText() ); } public void removeUpdate( final DocumentEvent e ) { person.setName( getText() ); } public void changedUpdate( final DocumentEvent e ) { person.setName( getText() ); } } ); }}, 0, 1 ); //      ... }}; 

पहले से ही बहुत कोड है। लेकिन आपको हैंडलर में सत्यापन जोड़ने की भी आवश्यकता हो सकती है।

आपके जीवन को आसान बनाने के लिए अलग-अलग दृष्टिकोण हैं।

• आईडीई के लिए रूपों का "चित्र"। उदाहरण के लिए, नेटबीन्स आपको फॉर्म बनाने और java.beans पैकेज के टूल का उपयोग करके डेटा के साथ दृश्य जोड़ने की अनुमति देता है।
  आपकी सेम में परिवर्तनों को ट्रैक करने के लिए एक अतिरिक्त कोड उत्पन्न किया जाएगा। ग्राफिक घटक बनाने के लिए, कोड भी जेनरेट किया जाएगा। इस सभी कोड में ब्लोटिंग और अपठनीय बनने की संपत्ति है। प्रपत्र बनाने की प्रक्रिया यहाँ वर्णित है ।
• चिंतनशील फार्म पीढ़ी के पुस्तकालय, जैसे कि JGoodies ( यहां केस का उपयोग करें ) और मेटाविजेट ( यहां केस का उपयोग करें )।
  एक नियम के रूप में, बंधन बिन गुणों के स्ट्रिंग नामों पर जाता है। इसलिए, रिफैक्टिंग के दौरान बंधन की शुद्धता का उल्लंघन हो सकता है।
  इसके अलावा मेटाविजट में, घटकों का स्थान अप्रत्यक्ष रूप से सेट किया गया है, अर्थात, आपको निर्दिष्ट करने की आवश्यकता है, उदाहरण के लिए, कुछ XML, सीधे पैनल में घटकों को जोड़ने के बजाय।
  यह मेटाविटग में भी स्पष्ट नहीं है, उदाहरण के लिए, अन्य पैनलों में घटकों को कैसे लपेटना है जिनके फ्रेम को सत्यापन के दौरान हाइलाइट करने की आवश्यकता है।

साइकिल के आविष्कार के लिए प्यास से प्रेरित होकर, मैंने फॉर्म जेनरेशन की एक न्यूनतम पुस्तकालय लिखने का फैसला किया, जो आपको करने की अनुमति देगा:

• कोड की एक दो लाइनों में डिफ़ॉल्ट रूप बनाना
• पैनल में घटकों के स्थान पर सामान्य नियंत्रण, जैसे कि आपके पास पहले से तैयार घटक हैं - वास्तव में, सेम के गुणों से जुड़े घटकों का इंजेक्शन
• सत्यापन के परिणामों पर नियंत्रण; एक इंटरफ़ेस लागू करके सत्यापन प्रसंस्करण को संशोधित करें
• इंटरफ़ेस को लागू करके नए प्रकार के घटकों को जोड़ें
• यदि संभव हो तो कंपाइलर बाइंडिंग की जाँच करें

मैं वर्णन करूंगा कि इस लाइब्रेरी का उपयोग करने वाला कोड कैसा दिखना चाहिए

डिफ़ॉल्ट रूप

यहां सब कुछ सरल है: हम एक वर्ग देते हैं, हम एक फॉर्म प्राप्त करते हैं।

 Form<Person> form = FormBuilder.map( Person.class ).buildForm(); myFrame.add( form.asComponent() ); Person person = new Person(); person.setName( "john smith" ); // ... further initialization form.setValue( person ); 

घटक स्थान

संभवतः, 80% मामलों में, प्रत्येक क्षेत्र के लिए केवल 2 घटकों की आवश्यकता होती है: एक नाम और संपादक के साथ एक लेबल। क्लासिक दृष्टिकोण यह है: हम क्षेत्र का नाम पूछते हैं, हमें घटक मिलता है।

 Form<Person> form = FormBuilder.map( Person.class ).with( new PropertyNameBeanMapper<Person>() {      @Override      public JComponent mapBean( PropertyNameContext<Person> ctx ) {        JPanel panel = new JPanel( new BorderLayout() );        panel.add( ctx.label( "name" ), BorderLayout.NORTH );        panel.add( ctx.editor( "name" ), BorderLayout.CENTER );        return panel;      } } ).buildForm(); 

क्या स्ट्रिंग्स को कुछ अधिक विश्वसनीय के साथ बदलना संभव है? उदाहरण के लिए, इस तरह:

 Form<Person> form = FormBuilder.map( Person.class ).with( new SampleBeanMapper<Person>() {      @Override      protected JComponent mapBean( Person sample, SampleContext<Person> ctx ) {        Box box = Box.createHorizontalBox();        box.add( ctx.label( sample.getName() ) );        box.add( ctx.editor( sample.getName() ) );        return box;      } } ).buildForm(); 

यदि आप एक नमूना के रूप में डायनेमिक प्रॉक्सी का उपयोग करते हैं (CGLIB लाइब्रेरी का उपयोग करने का एक उदाहरण ), जो संदर्भ को बताएगा कि कौन से तरीके कहलाते हैं, तो यह कोड पूरी तरह कार्यात्मक हो जाएगा। दृष्टिकोण थ्रेड सुरक्षित नहीं है, लेकिन यह एक जीयूआई है।

मानचित्रण

Ctx.label () के साथ सब कुछ स्पष्ट है - इसे JLabel को वापस करना चाहिए। और ctx.editor () क्या लौटना चाहिए? संदर्भ के भीतर, कुछ मानचित्रण होना चाहिए, जो प्रत्येक क्षेत्र के लिए, उसके प्रकार के अनुसार, संपादक इसके लिए चयन करेगा। लेकिन थोड़ा उठाओ। और अगर यह एक कस्टम घटक है? कई बिंदु हैं जिन्हें कॉन्फ़िगर किया जाना चाहिए।

• मान वर्ग
• घटक निर्माण संचालन
• सेट करें और मूल्य प्राप्त करें
• एक घटक में परिवर्तन प्रसंस्करण (उन्हें मान्य करने की संभावना के साथ)

उदाहरण के लिए, तृतीय-पक्ष कैलेंडर घटक के लिए, यह कॉन्फ़िगरेशन इस तरह दिखेगा:

 class DateToDateChooserMapper implements TypeMapper<JDateChooser, Date> { public Class<Date> getValueClass() { return Date.class; } public JDateChooser createEditorComponent() { return new JDateChooser(); } public Date getValue( final JDateChooser editorComponent ) { return editorComponent.getDate(); } public void setValue(final JDateChooser editorComponent, final Date value) { editorComponent.setDate( value ); } public void handleChanges(final JDateChooser editorComponent, final ChangeHandler changeHandler) { editorComponent.getDateEditor() .addPropertyChangeListener( "date", new PropertyChangeListener() { public void propertyChange( final PropertyChangeEvent evt ) { changeHandler.onChange( BackgroundMarker.INSTANCE ); } } ); } } 

यहाँ ChangeHandler सिस्टम को घटक में परिवर्तन के बारे में बताने का कार्य करता है। डिफ़ॉल्ट रूप से, सेम को हाइबरनेट वैलिडेटर का उपयोग करके मान्य किया गया है। ValidationMarker को इसके परिणामों के बारे में सूचित किया जाता है, इस मामले में, BackgroundMarker, जो यह तय करता है कि असफल घटकों की उपस्थिति को कैसे बदला जाए।

यदि आपको इस प्रकार के सभी क्षेत्रों के लिए मैपिंग निर्दिष्ट करने की आवश्यकता है, तो कोड सरल दिखता है:

 Form<Person> form = FormBuilder.map( Person.class ).use( new StringToTextAreaMapper() ).buildForm(); 

विशिष्ट क्षेत्रों के लिए, यह थोड़ा अधिक जटिल है:

 Form<Person> form = FormBuilder.map( Person.class ) .useForProperty( "description", new StringToTextAreaMapper() ) .buildForm(); 

फिर, क्या डायनेमिक प्रॉक्सी का उपयोग करना संभव है, और तार की बजाय तरीकों से बाँधना, प्रकार की जाँच प्रदान करना? यह संभव है, हालांकि कुछ हद तक बोझिल:

 Form<Person> form = FormBuilder.map( Person.class ).useForGetters( new GetterMapper<Person>() {      @Override      public void mapGetters( Person beanSample, GetterConfig config ) {        config.use( beanSample.getDescription(), new StringToTextAreaMapper() );      } } ).buildForm(); 

निष्कर्ष

मैंने कुछ समय पहले इस पुस्तकालय को लिखा था, और अब मैंने इसे समुदाय को प्रस्तुत करने का निर्णय लिया। अब मैं स्काला के लिए इस लाइब्रेरी का एक एडॉप्टर बना रहा हूं, लेकिन अभी तक यह बहुत ही मामूली है। शायद मैं अगले पोस्ट में इसका वर्णन करूंगा।

लाइब्रेरी और मावेन रिपॉजिटरी के अधिक विस्तृत विवरण के साथ एक विकी Google कोड पर पाया जा सकता है: code.google.com/p/swing-formbuilder
मैंने सूत्रों को GitHub: github.com/aeremenok/swing-formbuilder में स्थानांतरित कर दिया