यूनिट परीक्षण जावा डेटाबेस कोड के लिए HSQLDB + DBUnit का उपयोग करना

प्रस्तावना

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

उपकरण चयन

शायद यूनिट टेस्टिंग में सबसे मुश्किल काम उस कोड की जाँच करना है जो डेटाबेस कनेक्शन के साथ काम करता है (बाहरी वस्तुओं के साथ काम करने वाले कोड की जाँच करके और बड़े)। हां, आप कनेक्शनों के बजाय मोक्स का उपयोग कर सकते हैं, लेकिन यदि आपके पास जेडीबीसी प्रदाता के साथ एक से अधिक ऑपरेशन हैं, तो आप बाद वाले का उपयोग करके कोड में इसे पकड़ने की तुलना में नकली वस्तु में गलती करने की अधिक संभावना है। क्या रहता है? वास्तविक डेटाबेस का उपयोग करना भी अच्छा नहीं है, क्योंकि आप डेटाबेस सर्वर को रिपॉजिटरी में नहीं डाल सकते हैं ... और अगर मैं कहूं कि आप इसे बहुत डाल सकते हैं, और यह पहले से ही है? हमारी समस्या का हल HSQLDB है ।

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

ठीक है, मान लें कि हमारे पास एक डेटाबेस है जो पूरी तरह से मेमोरी में है और न्यूनतम संसाधनों की खपत करता है। परीक्षण करने से पहले, इसे डेटा से भरा जाना चाहिए, और SQL प्रश्नों को लिखने की तुलना में अधिक सार्वभौमिक विधि के साथ ऐसा करने की सलाह दी जाती है। हमें इस पर संचालन के बाद डेटाबेस की स्थिति को भी जांचना होगा। इससे डेटा प्राप्त करने और मैन्युअल रूप से संदर्भ के साथ तुलना करने के लिए, आप देखते हैं, विचार बेहद खराब है। इसलिए, ऑपरेशन के परिणामों की प्रारंभिककरण और सत्यापन की समस्या को हल करने के लिए, DBUnit पुस्तकालय बनाया गया था, जो डेटाबेस के आरंभीकरण को स्वचालित करने और डेटा सेटों के बाद के सत्यापन के लिए आदर्श रूप से अनुकूल है।

उदाहरण का उपयोग करें

HSQLDB और DBUnit की क्षमताओं को प्रदर्शित करने के लिए, हम एक वर्ग बनाएंगे, जिसका निर्माता मापदंडों के रूप में डेटाबेस कनेक्टर को स्वीकार करता है। कक्षा में एक विधि होगी जो पाठ को स्ट्रिंग के रूप में पैरामीटर के रूप में लेती है, इसे अलग-अलग शब्दों में तोड़ती है और डेटाबेस तालिका में शब्दों की घटना की आवृत्ति के बारे में आंकड़े जोड़ती है। हमारी कक्षा इस तरह दिखाई देगी:

public class User { private Connection sqlConnection; public User(Connection sqlConnectopn) { this.sqlConnection = sqlConnectopn; } private int insertOriginalString(String originalString) throws SQLException { int originalStringId = 0; PreparedStatement psInsert = sqlConnection. prepareStatement( "INSERT INTO original_strings (strings, date) VALUES (?, now())", PreparedStatement.RETURN_GENERATED_KEYS ); psInsert.setString(1, originalString); psInsert.execute(); ResultSet rsInsert = psInsert.getGeneratedKeys(); if(rsInsert.next()) { originalStringId = rsInsert.getInt(1); } else { throw new RuntimeException(); } rsInsert.close(); psInsert.close(); return originalStringId; } private int insertToken(int originalStringId, String token) throws SQLException { int tokenId = 0; PreparedStatement psTokenId = sqlConnection. prepareStatement("SELECT id FROM tokens WHERE word = ?"); psTokenId.setString(1, token); ResultSet rsToken = psTokenId.executeQuery(); if(rsToken.next()) { tokenId = rsToken.getInt(1); } else { PreparedStatement psInsertToken = sqlConnection. prepareStatement( "INSERT INTO tokens (word) VALUES (?)", PreparedStatement.RETURN_GENERATED_KEYS ); psInsertToken.setString(1, token); psInsertToken.execute(); ResultSet rsInserToken = psInsertToken.getGeneratedKeys(); if(rsInserToken.next()) { tokenId = rsInserToken.getInt(1); } else { throw new RuntimeException(); } rsInserToken.close(); psInsertToken.close(); } rsToken.close(); psTokenId.close(); return tokenId; } private void linkTokenToString(int originalStringId, int tokenId) throws SQLException { PreparedStatement psCreateLink = sqlConnection. prepareStatement("INSERT INTO links (original_string_id, token_id) VALUES(?,?)"); psCreateLink.setInt(1, originalStringId); psCreateLink.setInt(2, tokenId); psCreateLink.execute(); } public void logRequestString(String requestString) throws SQLException { String preParsed = requestString.replaceAll("\\W+", " "); String[] tokens = preParsed.split(" "); if(tokens.length > 0) { int originalStringId = insertOriginalString(requestString); for(String token: tokens) { linkTokenToString( originalStringId, insertToken(originalStringId, token) ); } } } } 

अब इसके लिए एक इकाई परीक्षण लिखें।

 public class UserTest { private IDatabaseTester tester = null; @Before public void instantiate() throws Exception { //Creating databse server instance tester = new JdbcDatabaseTester("org.hsqldb.jdbcDriver", "jdbc:hsqldb:mem:" + UUID.randomUUID().toString(), "sa", ""); //Creating tables tester.getConnection().getConnection().prepareStatement("CREATE SEQUENCE SEQU AS INTEGER START WITH 0").execute(); tester.getConnection().getConnection().prepareStatement("CREATE SEQUENCE SEQU2 AS INTEGER START WITH 0").execute(); tester.getConnection().getConnection().prepareStatement("CREATE SEQUENCE SEQU3 AS INTEGER START WITH 0").execute(); tester.getConnection().getConnection().prepareStatement("CREATE TABLE TOKENS(ID INT GENERATED BY DEFAULT AS SEQUENCE SEQU NOT NULL PRIMARY KEY, WORD LONGVARCHAR NOT NULL)").execute(); tester.getConnection().getConnection().prepareStatement("CREATE TABLE ORIGINAL_STRINGS(ID INT GENERATED BY DEFAULT AS SEQUENCE SEQU2 NOT NULL PRIMARY KEY, STRINGS LONGVARCHAR NOT NULL,DATE TIMESTAMP NOT NULL)").execute(); tester.getConnection().getConnection().prepareStatement("CREATE TABLE LINKS(ID INT GENERATED BY DEFAULT AS SEQUENCE SEQU3 NOT NULL PRIMARY KEY,TOKEN_ID INT NOT NULL,ORIGINAL_STRING_ID INT NOT NULL)").execute(); //Setting DATA_FACTORY, so DBUnit will know how to work with specific HSQLDB data types tester.getConnection().getConfig().setProperty(DatabaseConfig.PROPERTY_DATATYPE_FACTORY, new HsqldbDataTypeFactory()); //Getting dataset for database initialization IDataSet dataSet = new FlatXmlDataSetBuilder().build(this.getClass().getClassLoader().getResourceAsStream("template_set.xml")); //Initializing database tester.setDataSet(dataSet); tester.onSetup(); } @Test public void logRequestStringTest() throws SQLException, Exception { User man = new User(tester.getConnection().getConnection()); man.logRequestString("Hello, world!"); ITable template = new FlatXmlDataSetBuilder().build(this.getClass().getClassLoader(). getResourceAsStream("check_set.xml")).getTable("tokens"); ITable actual = DefaultColumnFilter.includedColumnsTable(tester.getConnection().createDataSet().getTable("tokens"), template.getTableMetaData().getColumns()); Assertion.assertEquals(template, actual); } } 

डेटासेट फाइलें इस प्रकार हैं:

template_set.xml

 <dataset> </dataset> 

check_set.xml

 <tokens WORD="Hello" /> <tokens WORD="world" /> 

यूनिट टेस्ट देखते समय, सवाल तुरंत उठ सकता है: “यूनिट-टेस्ट में शामिल डेटाबेस में टेबल बनाने के लिए कोड क्यों है! उन्होंने फाइलों से डेटा सेट डाउनलोड करने का वादा किया है? ” हां, यह सही है, हम फाइलों से सेट को लोड करते हैं, लेकिन प्रत्येक डीबीएमएस के लिए डीडीएल प्रश्नों के अलग-अलग सिंटैक्स के कारण xml का उपयोग करके डेटाबेस संरचना का वर्णन करना और इसे सभी डेटाबेस ड्राइवरों के साथ काम करना आसान प्रक्रिया नहीं है। इसलिए, ऐसी कार्यक्षमता DBUnit में उपलब्ध नहीं है।
मैं आपका ध्यान निम्नलिखित डिजाइन पर केंद्रित करना चाहता हूं:

 ITable actual = DefaultColumnFilter.includedColumnsTable(tester.getConnection().createDataSet().getTable("tokens"), template.getTableMetaData().getColumns()); 

DefaultColumnFilter फ़ंक्शन रिकॉर्ड की आईडी पर विचार किए बिना डेटा सेट की तुलना करने के लिए कॉलम को फ़िल्टर करता है।

निष्कर्ष

लेख में, मैंने डेटाबेस के साथ काम करने के सबसे सरल उदाहरण का विश्लेषण किया। पाठक आसानी से कल्पना कर सकते हैं कि परीक्षण के लिए इस तरह का दृष्टिकोण न केवल ओडीबीसी कनेक्शन के "नंगे" उपयोग के लिए लागू है, बल्कि ओआरईडी फ्रेमवर्क के लिए भी है। आपके लिए स्थिर कोड!