हाइबरनेट एनवर्स: संचालन सुनने वाला

यह क्यों आवश्यक है?

उद्यम विकास में, अक्सर कुछ तालिकाओं की संपादन प्रक्रिया को ट्रैक करना आवश्यक होता है।
मान लीजिए कि आपको अपने सिस्टम में एक दस्तावेज मिला है। फिर किसी ने उसकी श्रृंखला बदल दी। फिर संख्या। फिर उन्होंने रूसी संघ के पासपोर्ट से प्रकार को विदेशी में बदल दिया। जर्मन पासपोर्ट। मैं उन परिवर्तनों के इतिहास को ट्रैक करने में सक्षम होना चाहूंगा और, यह कहना चाहूंगा कि गलती करने वाले उपयोगकर्ता के हेडर को टैप करना।

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

हम इस तथ्य से आगे बढ़ेंगे कि हमारा सिस्टम हाइबरनेट के माध्यम से डेटाबेस के साथ काम करता है। इस मामले में, हमारे पास एक अद्भुत रिकॉर्डिंग श्रवण तंत्र तक पहुंच है: एनवर्स।

आखिर में हमें क्या मिलता है?

प्रत्येक तालिका के लिए जिसका परिवर्तन हम एनवर्स को ट्रैक करना चाहते हैं, हमारे लिए एक अतिरिक्त प्लेट बनाएगा जिसमें हम हर बार ऑडिट टेबल के साथ कुछ करने के लिए एक रिकॉर्ड डालेंगे। उदाहरण के लिए:

तालिका दस्तावेज़ (दस्तावेज़):

आईडी	श्रृंखला	संख्या
1	1000	100000

दस्तावेजों के लिए ऑडिट टेबल: (DOCUMENT_AUD)

आईडी	REV	REVTYPE	श्रृंखला	संख्या
1	1	0	1000	100000
1	2	1	1345	100000

जैसा कि आप तालिका से देख सकते हैं, हमारे पास आईडी के साथ दस्तावेज़ के लिए 2 संशोधन हैं = 1. एक (REVTYPE = 0 के साथ) नया जोड़ा गया रिकॉर्ड है, दूसरा रिकॉर्ड परिवर्तन है। 1000 श्रृंखला 1345 बन गई।

ठीक है, आप कहते हैं, लेकिन ऐसा कब हुआ? Envers एक अन्य तालिका बनाता है, जिसे डिफ़ॉल्ट रूप से REVINFO कहा जाता है। इसमें संशोधन संख्या और टाइमस्टैम्प शामिल हैं। लेकिन खेतों की संख्या का विस्तार किया जा सकता है।

इसे उतारने में क्या लगता है?

पुस्तकालयों से, हमें खुद हाइबरनेट के अलावा और किसी चीज की आवश्यकता नहीं होगी।

आपको केवल निम्न पंक्तियों को दृढ़ता से जोड़ने की आवश्यकता है। xml, लेकिन मुझे लगता है कि हर कोई समझता है कि उनकी आवश्यकता क्यों है:

<property name="hibernate.ejb.event.post-insert" value="org.hibernate.ejb.event.EJB3PostInsertEventListener,org.hibernate.envers.event.AuditEventListener" /> <property name="hibernate.ejb.event.post-update" value="org.hibernate.ejb.event.EJB3PostUpdateEventListener,org.hibernate.envers.event.AuditEventListener" /> <property name="hibernate.ejb.event.post-delete" value="org.hibernate.ejb.event.EJB3PostDeleteEventListener,org.hibernate.envers.event.AuditEventListener" /> <property name="hibernate.ejb.event.pre-collection-update" value="org.hibernate.envers.event.AuditEventListener" /> <property name="hibernate.ejb.event.pre-collection-remove" value="org.hibernate.envers.event.AuditEventListener" /> <property name="hibernate.ejb.event.post-collection-recreate" value="org.hibernate.envers.event.AuditEventListener" /> 

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

 @Entity @Audited public Document 

यदि आप कक्षाओं के अनुसार एक योजना बनाते हैं, तो ऑडिट टेबल को जोड़ने के लिए, आपको hbm2ddl शुरू होने वाले एंटीस्क कार्य के क्लासनाम को बदलने की आवश्यकता है:

 classname="org.hibernate.tool.ant.EnversHibernateToolTask" 

इसलिए, हमारे पास इन संशोधनों के लिए एक संस्करण प्लेट और एक टाइम टेबल है। लेकिन क्या होगा अगर हम इस तालिका को थोड़ा विस्तारित करना चाहते हैं और इसे एक अलग नाम दें? @RevisionEntity एनोटेशन हमारी मदद करने के लिए hurries।

अपनी इकाई को परिभाषित करें:

 @Entity @org.hibernate.envers.RevisionEntity(RevisionListener.class) public class RevisionEntity extends DefaultRevisionEntity { } 

DefaultRevisionEntity यहां एक डिफ़ॉल्ट इकाई है जिसमें पहले से ही टाइमस्टैम्प और संशोधन संख्या शामिल है। यदि आप किसी चीज़ को फिर से परिभाषित करना चाहते हैं, तो आप ऐसा कर सकते हैं:

 @Entity @RevisionEntity(ExampleListener.class) public class ExampleRevEntity { @Id @GeneratedValue @RevisionNumber private int id; @RevisionTimestamp private long timestamp; ... } 

@RevisionNumber और @RevisionTimestamp का उपयोग केवल एक बार किया जा सकता है, इसलिए यदि आप DefaultRevisionEntity से विरासत में प्राप्त करते हैं, तो आप उन्हें दूसरी बार उपयोग नहीं कर सकते।

हमारे सार को कैसे पूरक करें? बस किसी भी अन्य की तरह!

 @Entity @org.hibernate.envers.RevisionEntity(RevisionListener.class) public class RevisionEntity extends DefaultRevisionEntity { @ManyToOne private User user; // ,  } 

लेकिन सवाल यह है कि यह अतिरिक्त डेटा कब डाला जाना है? ऐसा करने के लिए, आपको एक संशोधनकर्ता की आवश्यकता है। यह एक निश्चित वर्ग है जो org.hibernate.envers.RevisionListener को लागू करता है और इसकी एक विधि है:

public void newRevision(Object revision);

यह तब कहा जाएगा जब हमारी ऑडिटेड इकाई (दस्तावेज़) बदल जाएगी। यहां रिवीजन ऑब्जेक्ट हमारी रिविजन इश्यिनिटी है। ताकि हम कुछ ऐसा लिख ​​सकें

 RevisionEntity revisionEntity = (RevisionEntity) revision; revisionEntity.setUser(...); //  -   ,  

लेकिन डेटा कैसे पढ़ें?

चूंकि आपके पास ऑडिट टेबल (Document_AUD) के लिए मैप की गई इकाई नहीं है, आप एक सामान्य क्वेरी नहीं लिख सकते। लेकिन एनवर्स आपकी सहायता के लिए आता है। इस तालिका को पढ़ने के लिए हमें AuditQuery की आवश्यकता है। आप इसे इस तरह प्राप्त कर सकते हैं:

 AuditQuery query = AuditReaderFactory.get(em).createQuery(); 

ठीक है, तो हमें केवल यह कहना है कि हमें वास्तव में क्या चाहिए, एक विशिष्ट संशोधन या शायद संशोधन की सूची:

 query.forRevisionsOfEntity(Document.class, false, false); 

यहां झंडे बहुत महत्वपूर्ण हैं। यदि उनमें से अंतिम सत्य है, तो क्वेरी हटाए गए रिकॉर्ड भी लौटाएगी।
लेकिन दूसरा झंडा वापसी मूल्य को नियंत्रित करता है। यदि सत्य है, तो केवल संशोधन स्वयं सूची में होंगे। और यदि नहीं, तो 3 तत्वों के सरणियों से युक्त एक सूची दी गई है।

पहला संशोधन है, दूसरा संशोधन है, और तीसरा संशोधन का प्रकार है।

आप इस क्वेरी के लिए विभिन्न फ़िल्टरिंग संलग्न कर सकते हैं, उदाहरण के लिए, मुख्य इकाई की आईडी द्वारा:

 query.add(AuditEntity.id().eq(docId)) 

या पुनरीक्षण के मापदंडों के अनुसार:

 query.add(AuditEntity.revisionProperty("user_id").eq(userId)) 

लेकिन अब (हाइबरनेट 3.6.1 - 3.6.4) यह सुविधा काम नहीं करती है, क्योंकि एक बग ।

ठीक है, अंत में, हम सूची प्राप्त करते हैं:

 List<Object []> resultList = query.getResultList(); 

ऑडिट रणनीति

क्वेरी दक्षता के लिए, यह अनुशंसा की जाती है कि आप ValidityAuditStrategy का उपयोग करें। यह रणनीति _AUD तालिकाओं में एक और फ़ील्ड जोड़ती है - REVEND। इस प्रकार, आपको अधिकतम संशोधन प्राप्त करने के लिए नेस्टेड चयन करने की आवश्यकता नहीं है।

इसे सक्षम करने के लिए, आपको केवल दृढ़ता के लिए एक पंक्ति जोड़ने की आवश्यकता है। xml:

  <property name="org.hibernate.envers.audit_strategy" value="org.hibernate.envers.strategy.ValidityAuditStrategy"/> 

संदर्भ:

सीतनिद्रा में होना

यह habrayuzer dzigoro का एक लेख है, जिसे प्रकाशित करने के लिए कहा गया है।