📁 🍈 🔃 Symfony2 में डेटा ट्रांसफॉर्मर का उपयोग करना 🌏 🈸 ◻️

प्रपत्र - सिम्फनी 2 में सबसे शक्तिशाली उपकरणों में से एक, वे कई विशेषताओं का प्रतिनिधित्व करते हैं। सिम्फनी 2 के साथ काम करने के लिए कई रहस्य रिकेट बुक में वर्णित हैं। मैं आपको रूपों के साथ काम करने के लिए एक नुस्खा का अनुवाद करना चाहता हूं, सिम्फनी 2 में - तारीख ट्रांसफार्मर का उपयोग ।
अक्सर आपके प्रोग्राम में उपयोग के लिए उपयोगकर्ता द्वारा दर्ज किए गए डेटा को एक अलग प्रारूप में रूप में परिवर्तित करने की आवश्यकता होती है। आप नियंत्रक में मैन्युअल रूप से इसे आसानी से कर सकते हैं, लेकिन क्या होगा यदि आप इस फॉर्म को विभिन्न स्थानों पर उपयोग करना चाहते हैं? मान लें कि आपके पास एक "समस्या" ऑब्जेक्ट के साथ कोड-टू-वन संबंध से जुड़ी एक "टास्क" ऑब्जेक्ट है, प्रत्येक "टास्क" के लिए एक "इश्यू" निर्दिष्ट किया जा सकता है, जिसे वह हल करता है। यदि हम कार्य संपादन के लिए समस्या की ड्रॉप-डाउन सूची जोड़ते हैं, तो हमारे लिए इसे नेविगेट करना बहुत मुश्किल होगा। आप एक ड्रॉप-डाउन सूची के बजाय एक पाठ फ़ील्ड जोड़ सकते हैं और बस अंक संख्या दर्ज कर सकते हैं।
आप नियंत्रक में रूपांतरण करने की कोशिश कर सकते हैं, लेकिन यह सबसे अच्छा विचार नहीं है। यह बेहतर होगा कि अंक संख्या स्वचालित रूप से मुद्दा वस्तु में परिवर्तित हो जाए। इस स्थिति में, "डेटा ट्रांसफॉर्मर" खेलने में आता है।

ट्रांसफार्मर का निर्माण।

सबसे पहले, जारी करें एकTTNNumberTransformer वर्ग - यह वर्ग इश्यू संख्या से अंक तालिका में परिवर्तित करने के लिए जिम्मेदार होगा:

// src/Acme/TaskBundle/Form/DataTransformer/IssueToNumberTransformer.php namespace Acme\TaskBundle\Form\DataTransformer; use Symfony\Component\Form\DataTransformerInterface; use Symfony\Component\Form\Exception\TransformationFailedException; use Doctrine\Common\Persistence\ObjectManager; use Acme\TaskBundle\Entity\Issue; class IssueToNumberTransformer implements DataTransformerInterface { /** * @var ObjectManager */ private $om; /** * @param ObjectManager $om */ public function __construct(ObjectManager $om) { $this->om = $om; } /** * Transforms an object (issue) to a string (number). * * @param Issue|null $issue * @return string */ public function transform($issue) { if (null === $issue) { return ""; } return $issue->getNumber(); } /** * Transforms a string (number) to an object (issue). * * @param string $number * @return Issue|null * @throws TransformationFailedException if object (issue) is not found. */ public function reverseTransform($number) { if (!$number) { return null; } $issue = $this->om ->getRepository('AcmeTaskBundle:Issue') ->findOneBy(array('number' => $number)) ; if (null === $issue) { throw new TransformationFailedException(sprintf( 'An issue with number "%s" does not exist!', $number )); } return $issue; } }

जब उपयोगकर्ता किसी अज्ञात नंबर में प्रवेश करता है और एक परिवर्तन नहीं करता है, तो आप एक नया "इश्यू" ऑब्जेक्ट बना सकते हैं।

ट्रांसफॉर्मर का उपयोग करना

अब हमारे पास एक ट्रांसफार्मर है, आपको बस इसे एक या दूसरे रूप में हमारे "इश्यू" फ़ील्ड में जोड़ना होगा।

 use Symfony\Component\Form\FormBuilderInterface; use Acme\TaskBundle\Form\DataTransformer\IssueToNumberTransformer; class TaskType extends AbstractType { public function buildForm(FormBuilderInterface $builder, array $options) { // ... // this assumes that the entity manager was passed in as an option $entityManager = $options['em']; $transformer = new IssueToNumberTransformer($entityManager); // add a normal text field, but add our transformer to it $builder->add( $builder->create('issue', 'text') ->addModelTransformer($transformer) ); } // ... }

इस उदाहरण में, आपको फॉर्म बनाते समय EntityManager को एक विकल्प के रूप में पास करना होगा। बाद में आप सीखेंगे कि EntityManager को पास करने से बचने के लिए अंक संख्या के लिए एक कस्टम फ़ील्ड कैसे बनाएं।

 $taskForm = $this->createForm(new TaskType(), $task, array( 'em' => $this->getDoctrine()->getEntityManager(), ));

कूल, हमने किया! अब उपयोगकर्ता टेक्स्ट बॉक्स में नंबर दर्ज करने में सक्षम होगा, और इसे ऑब्जेक्ट "इश्यू" में बदल दिया जाएगा। इसका मतलब है कि सफल बाइंडिंग ($ फॉर्म-> बिंद्रेस्सेस्ट ($ अनुरोध)) के बाद, फॉर्म फ्रेमवर्क "इश्यू" नंबर के बजाय वास्तविक "इश्यू" ऑब्जेक्ट को :: सेटआईट्यून्स () विधि को सबमिट करेगा।
ध्यान दें कि ट्रांसफार्मर जोड़ते समय, आपको फ़ील्ड जोड़ते समय थोड़ा अधिक जटिल सिंटैक्स का उपयोग करने की आवश्यकता होती है। निम्नलिखित इस बात का सही उदाहरण नहीं है कि ट्रांसफार्मर को पूरे फॉर्म में कैसे लागू किया जाएगा, और एक विशिष्ट क्षेत्र में नहीं:

 //    -       //        $builder->add('issue', 'text') ->addModelTransformer($transformer);

मॉडल दृश्य और ट्रांसफार्मर

संस्करण 2.1 में नया: सिम्फनी 2.1 में ट्रांसफार्मर के तरीकों का नाम बदल दिया गया था। prependNormTransformer addModelTransformer और appendClientTransformer addViewTransformer बन गया।
उपरोक्त उदाहरण में, एक ट्रांसफार्मर का उपयोग "मॉडल ट्रांसफार्मर" के रूप में किया गया था। वास्तव में, दो अलग-अलग प्रकार के ट्रांसफार्मर हैं और तीन अलग-अलग प्रकार के इनपुट डेटा हैं।

किसी भी रूप में, तीन अलग-अलग प्रकार के डेटा होते हैं:

मॉडल डेटा उस प्रारूप में डेटा है जो आपके एप्लिकेशन में उपयोग किया जाता है (उदाहरण के लिए, उदाहरण के लिए, प्रकार "ऑब्जेक्ट" का एक ऑब्जेक्ट)। यदि आप फॉर्म में :: GetData या :: SetData विधियों को कॉल करते हैं, तो आप "मॉडल डेटा" के साथ काम करेंगे।
सामान्य डेटा आपके डेटा के सामान्यीकृत संस्करण हैं, वे आमतौर पर "मॉडल डेटा" डेटा (हालांकि हमारे उदाहरण में नहीं) के समान हैं। प्रत्यक्ष रूप से, वे अक्सर उपयोग नहीं किए जाते हैं।
व्यू डेटा फॉर्मेट फ़ील्ड को पॉप्युलेट करने के लिए उपयोग किया जाने वाला प्रारूप है। यह वह प्रारूप भी है जिसमें उपयोगकर्ता डेटा प्रसारित करेगा (फ़ॉर्म सबमिट करें)। जब हम फ़ॉर्म :: बाइंड ($ डेटा) विधि कहते हैं, तो $ डेटा "डेटा देखें" प्रारूप में प्रस्तुत किया जाता है

दो अलग-अलग प्रकार के ट्रांसफार्मर हैं जो हमें डेटा को एक दृश्य से दूसरे में बदलने में मदद करते हैं।

"मॉडल ट्रांसफार्मर" मॉडल ट्रांसफार्मर
- रूपांतर: "मॉडल डेटा" => "मानक डेटा"
- रिवर्सट्रांसफॉर्म: "आदर्श डेटा" => "मॉडल डेटा"
"ट्रांसफार्मर देखें"
- परिवर्तन: "मानक डेटा" => "डेटा देखें"
- रिवर्सट्रांसफॉर्म: "डेटा देखें" => "मानक डेटा"

आपको किस ट्रांसफार्मर की आवश्यकता है यह विशिष्ट स्थिति पर निर्भर करता है।
View Transformer का उपयोग करने के लिए, AddViewTransformer विधि को कॉल करें।

तो हम डेटा ट्रांसफार्मर का उपयोग क्यों करते हैं?

हमारे उदाहरण में, क्षेत्र एक पाठ क्षेत्र है, और हम उम्मीद करते हैं कि पाठ क्षेत्र हमेशा "मानक" और "दृश्य" प्रारूप में स्केलर डेटा लौटाएगा। और इस मामले में, सबसे स्वीकार्य ट्रांसफार्मर "मॉडल ट्रांसफार्मर" है, जो "आदर्श डेटा" को "मॉडल डेटा" में परिवर्तित करता है और इसके विपरीत (इश्यूस "ऑब्जेक्ट में समस्या संख्या और इसके विपरीत)।
ट्रांसफार्मर के बीच का अंतर बहुत सूक्ष्म है और आपको हमेशा सोचना चाहिए कि सामान्यीकृत डेटा "आदर्श" होना चाहिए। उदाहरण के लिए, "मानक" पाठ क्षेत्र के लिए, सामान्यीकृत डेटा एक पाठ स्ट्रिंग है, और "दिनांक" फ़ील्ड के लिए, एक दिनांक समय ऑब्जेक्ट।

"कस्टम फ़ील्ड" में ट्रांसफार्मर का उपयोग

ऊपर वर्णित उदाहरण में, हम पाठ क्षेत्र के लिए एक ट्रांसफार्मर का उपयोग करते हैं। यह करना बहुत आसान था, लेकिन इस दृष्टिकोण में दो कमियां हैं:

आपको हमेशा आइसु क्षेत्र का उपयोग करते समय ट्रांसफार्मर का उपयोग करने के बारे में याद रखना चाहिए।
जब भी आप एक ट्रांसफार्मर का उपयोग करते हुए एक फॉर्म बनाते हैं, तो आपको em => EntityManager विकल्प में पास होने का ध्यान रखना चाहिए।

इसलिए, हमें संभवतः एक कस्टम "कस्टम" प्रकार का फ़ील्ड बनाने की आवश्यकता है। सबसे पहले, कस्टम फ़ील्ड प्रकार के लिए एक क्लास बनाएँ:

 // src/Acme/TaskBundle/Form/Type/IssueSelectorType.php namespace Acme\TaskBundle\Form\Type; use Symfony\Component\Form\AbstractType; use Symfony\Component\Form\FormBuilderInterface; use Acme\TaskBundle\Form\DataTransformer\IssueToNumberTransformer; use Doctrine\Common\Persistence\ObjectManager; use Symfony\Component\OptionsResolver\OptionsResolverInterface; class IssueSelectorType extends AbstractType { /** * @var ObjectManager */ private $om; /** * @param ObjectManager $om */ public function __construct(ObjectManager $om) { $this->om = $om; } public function buildForm(FormBuilderInterface $builder, array $options) { $transformer = new IssueToNumberTransformer($this->om); $builder->addModelTransformer($transformer); } public function setDefaultOptions(OptionsResolverInterface $resolver) { $resolver->setDefaults(array( 'invalid_message' => 'The selected issue does not exist', )); } public function getParent() { return 'text'; } public function getName() { return 'issue_selector'; } }

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

 <service id="acme_demo.type.issue_selector" class="Acme\TaskBundle\Form\Type\IssueSelectorType"> <argument type="service" id="doctrine.orm.entity_manager"/> <tag name="form.type" alias="issue_selector" /> </service>

अब हम अपने विशेष मुद्दे_ प्रकार का उपयोग कर सकते हैं:

 // src/Acme/TaskBundle/Form/Type/TaskType.php namespace Acme\TaskBundle\Form\Type; use Symfony\Component\Form\AbstractType; use Symfony\Component\Form\FormBuilderInterface; class TaskType extends AbstractType { public function buildForm(FormBuilderInterface $builder, array $options) { $builder ->add('task') ->add('dueDate', null, array('widget' => 'single_text')); ->add('issue', 'issue_selector'); } public function getName() { return 'task'; } }