நிரலாக்கம்

RESTful - ஆரம்பநிலைக்கான விரைவான வழிகாட்டி

அக்டோபர் 30, 2021

நீங்கள் ஒன்றை உருவாக்க விரும்பினால் பயன்பாட்டு நிரல் இடைமுகம் (API) வலை பயன்பாடுகளுக்கு, RESTful பயன்படுத்தப்படுகிறது. பயன்பாட்டு நிரல் இடைமுகம் (API) என்றால் என்ன? ஒரு பயன்பாட்டு நிரல் இடைமுகம் என்பது இரண்டு மென்பொருள் பயன்பாடுகளுக்கு இடையே ஒரு மத்தியஸ்தராகும். இது இரண்டு மென்பொருள் பயன்பாடுகளை ஒன்றுக்கொன்று பாதுகாப்பாகவும் பாதுகாப்பாகவும் தொடர்பு கொள்ள உதவுகிறது. தினசரி வாழ்வில் வழக்கமான API பயன்பாடுகள் Facebook ஐப் பயன்படுத்துகின்றன, அரட்டை பயன்பாடுகளைப் பயன்படுத்துகின்றன அல்லது மொபைல் ஃபோனில் வானிலை முன்னறிவிப்பு பயன்பாட்டைப் பயன்படுத்துகின்றன.

API என்றால் என்ன என்பதைப் புரிந்துகொள்ள, ஒரு நேரடியான உதாரணத்தைக் கவனிப்போம்? ஒரு உணவகத்தின் உதாரணத்தைக் கவனியுங்கள். நாங்கள் ஒரு உணவகத்திற்குச் சென்று நமக்கு விருப்பமான உணவைச் சாப்பிடுகிறோம். நாங்கள் என்ன செய்வோம், நாங்கள் மெனு கார்டைக் கவனித்து, மெனுவிலிருந்து நீங்கள் தேர்ந்தெடுத்த உருப்படிகளைப் பற்றி பணியாளரிடம் கூறுவோம். பணியாளர் உங்கள் ஆர்டரை சமையலறை துறைக்கு தெரிவிக்கிறார், மேலும் உங்கள் உணவு தயாராகிறது. உணவு தயாரான பிறகு, பணியாளர் அதை உங்களுக்காக உங்கள் மேஜையில் பரிமாறுகிறார். இங்கே, பணியாள் என்பது உங்களுக்கும் சமையலறை துறைக்கும் இடையிலான இடைமுகம். இரண்டு அமைப்புகள் தொடர்பு கொள்ளும்போது இதுவே நடக்கும்.

ஒரு பயன்பாட்டு நிரல் இடைமுகம் (API) நான்கு முதன்மை வகைகளாக வகைப்படுத்தப்பட்டுள்ளது, OpenAPIகள், கூட்டாளர் APIகள், உள் APIகள் மற்றும் கூட்டு APIகள். OepnAPI கள் பொதுவில் கிடைப்பதால், அனைவராலும் அணுக அனுமதிக்கப்படுகிறது. கூட்டாளர் API களில், ஒரு குறிப்பிட்ட பயனருக்கு அதை அணுக சரியான உரிமை தேவை, ஏனெனில் அவை பொது பயன்பாட்டிற்காக உருவாக்கப்படவில்லை. உள் APIகள் நிறுவனத்தின் உள் பயன்பாட்டிற்காக சிறப்பாக வடிவமைக்கப்பட்டுள்ளன. கடைசியாக, கம்போசிட் ஏபிஐகள் பொதுவாக நிறுவனத்தின் செயல்பாடுகள் மற்றும் செயல்திறனை விரைவுபடுத்தப் பயன்படுத்தப்படுகின்றன.

மற்றொரு API வகை இணைய சேவை APIகள் ஆகும். நான்கு முதன்மை வலை சேவை APIகள் உள்ளன, SOAP, XML-RPC, JSON-RPC மற்றும் REST. SOAP என்பது ஒரு எளிய பொருள் அணுகல் நெறிமுறை , இது XML வடிவமைப்பைப் பயன்படுத்தி தரவை மாற்றுகிறது. SOAP API இன் பயன்பாட்டை உள்ளடக்கியது இணைய சேவைகள் வரையறை மொழி (WSDL) அதன் இடைமுகத்தை வரையறுக்க. மற்றொரு இணைய சேவை API எக்ஸ்எம்எல்-ஆர்பிசி . அதன் பெயர் குறிப்பிடுவது போல, தரவுப் பகிர்வுக்கு எக்ஸ்எம்எல் படிவத்தைப் பயன்படுத்தியது. SOAP API ஐ விட XML-RPC API எளிமையானது மற்றும் அணுகக்கூடியது.

அடுத்த இணைய சேவை API JSON-RPC . இது XML இன் அதே API ஆகும், ஆனால் தரவுப் பகிர்வுக்கு JSON வடிவமைப்பைப் பயன்படுத்துகிறது. கடைசியாக, REST API மேலே உள்ள மூன்றில் இருந்து வேறுபட்டது. இது கட்டிடக்கலை தரங்களின் தொகுப்பு. REST API ஆனது RESTful API என்றும் அழைக்கப்படுகிறது. இது பொதுவாக பயன்படுத்தப்படும் வலை சேவை APIகளில் ஒன்றாகும், ஏனெனில் இதற்கு விதிவிலக்காக குறைந்த அலைவரிசை தேவைப்படுகிறது.

இந்த கட்டுரையில், RESTful இணைய சேவையைப் பற்றிய விரைவான வழிகாட்டியைப் பார்ப்போம். ரெஸ்ட்ஃபுல் இணைய சேவையைப் பற்றி அறிந்துகொள்ள இந்தப் பதிவு உதவும். எளிதான எடுத்துக்காட்டுகளுடன் RESTful இணைய சேவைக் கருத்துகளை இன்னும் நேரடியாக விளக்கியுள்ளோம். தொடங்கும் முன் ஒன்றை நினைவில் கொள்ள வேண்டும் RESTful என்பதைப் புரிந்து கொள்ளுங்கள் API என்பது ஜாவா நிரலாக்க மொழி, HTML, CSS, AJAX மற்றும் Text Editor பற்றிய சிறந்த அறிவைப் பெற்றிருக்க வேண்டும், ஏனெனில் RESTful என்பது வலை பயன்பாடுகளை உருவாக்குவதற்கான ஒரு வலை சேவையாகும். எனவே, எங்கள் RESTful API டுடோரியலைத் தொடங்குவோம்.

பொருளடக்கம்

RESTful Web Service API என்றால் என்ன?

RESTful API என்றால் என்ன என்பதை அறிவதற்கு முன், இணையச் சேவை உண்மையில் என்ன என்பதை முதலில் தெரிந்துகொள்வோம். ஏ இணைய சேவை அமைப்புகளுக்கு இடையே தரவைப் பகிர்வதற்கு அல்லது பரிமாற்றம் செய்வதற்குத் தேவையான தரநிலைகள் அல்லது கொள்கைகளின் தொகுப்பாகும். இன்று, எங்கள் மொபைல் போன்கள் மற்றும் டெஸ்க்டாப்களில் பல பயன்பாடுகளைப் பயன்படுத்துகிறோம். இந்த பயன்பாடுகள் பல நிரலாக்க மொழிகளில் எழுதப்பட்டுள்ளன, இருப்பினும், அவை தனித்துவமான இயக்க முறைமைகளில் வேலை செய்கின்றன. வெவ்வேறு இயக்க முறைமைகளில் ஒரு குறிப்பிட்ட மென்பொருள் பயன்பாட்டை அணுக இணைய சேவை உங்களுக்கு உதவுகிறது.

RESTful API என்பது ஒரு வலை சேவை API ஆகும். இது கட்டடக்கலை தரநிலைகளின் தொகுப்பை உள்ளடக்கியது மற்றும் குறிப்பிட்ட தரவை அணுகுவதற்கும் பயன்படுத்துவதற்கும் ஒரு HTTP நெறிமுறையைப் பயன்படுத்துகிறது. REST குறிக்கிறது பிரதிநிதித்துவ மாநில இடமாற்றம் . RESTful API இல், சம்பந்தப்பட்ட ஒவ்வொரு கூறுகளும் ஒரு ஆதாரமாகக் கருதப்படுகின்றன. இதைப் பயன்படுத்தி இந்த ஆதாரங்களை நீங்கள் அணுகலாம் HTTP நெறிமுறை முறைகள்.

RESTful API இல் ஒரு சர்வர் மற்றும் கிளையன்ட் ஈடுபட்டுள்ளனர். REST API இன் வாடிக்கையாளர்கள் சேவையகத்தால் வழங்கப்பட்ட ஆதாரங்களை அணுகலாம் மற்றும் அவற்றைக் கையாளலாம். ஒவ்வொரு ஆதாரத்திற்கும் தனியான URI அல்லது உலகளாவிய ஐடி உள்ளது. URI அல்லது உலகளாவிய ஐடியைப் பயன்படுத்தி, RESTful API இல் உள்ள ஆதாரங்களை நாம் அடையாளம் காணலாம். URI என்பது அ சீரான வள அடையாளங்காட்டி . நீங்கள் REST API இல் உரை, XML.JSON அல்லது JSON வடிவங்களைப் பயன்படுத்தி வளப் பிரதிநிதித்துவத்திற்குப் பயன்படுத்தலாம்.

RESTful இணைய சேவையானது பொதுவாக கிளவுட் நுகர்வோரால் பயன்படுத்தப்படுகிறது, இதனால் அவர்கள் இணைய சேவைகளை அணுகவும் நிர்வகிக்கவும் முடியும். REST API ஒரு வலுவான API ஐ உருவாக்க மிகவும் விரும்பத்தக்க தேர்வுகளில் ஒன்றாக செயல்படுகிறது. REST கட்டமைப்பைப் பயன்படுத்தி உருவாக்கப்பட்ட API ஆனது, பயனர்கள் கிளவுட் சேவைகளுடன் நிர்வகிக்கக்கூடிய வகையில் தொடர்புகொள்ள அனுமதிக்கிறது. RESTful இணையச் சேவையைப் பயன்படுத்தி APIகளை உருவாக்கப் பயன்படுத்தும் பிரபலமான இணையதளங்கள் சில அமேசான் இணைய சேவைகள் (AWS), Twitter, LinkedIn மற்றும் Google.

RESTful Web Service API இன் வேலை

RESTful இணைய சேவையின் சுருக்கமான விளக்கத்தை நாங்கள் கவனித்துள்ளோம். இப்போது, ​​RESTful API இன் செயல்பாட்டைத் தெரிந்து கொள்வோம். RESTful API ஆனது இரண்டு பயன்பாடுகளுக்கு இடையேயான ஒவ்வொரு பரிவர்த்தனையையும் பல சிறிய தொகுதிகளாக உடைக்கிறது. இங்கே, பரிவர்த்தனை என்பது தரவு அல்லது தகவல் பரிமாற்றத்தைக் குறிக்கிறது. ஒவ்வொரு தொகுதியும் பரிவர்த்தனையின் அத்தியாவசிய தகவலைக் கொண்டுள்ளது. எனவே, டெவலப்பர்கள் எந்த இணைய பயன்பாட்டிற்கும் API ஐ உருவாக்க வசதியாகவும் நெகிழ்வாகவும் உணர்கிறார்கள்.

இன்று, கிளவுட் டேட்டா மேனேஜ்மென்ட் இன்டர்ஃபேஸ் (சிடிஎம்ஐ), அமேசான்எஸ் 3 போன்ற பல நிறுவனங்கள், ஏபிஐயை உருவாக்க தங்கள் குறிப்பிட்ட மாதிரிகளை வழங்குகின்றன. RESTful API வலை சேவையில் வளங்களை அணுகுவதற்கு ஏராளமான கட்டளைகள் உள்ளன. ஒரு குறிப்பிட்ட நேர முத்திரையில் ஒரு குறிப்பிட்ட வளத்தின் நிலையை வள பிரதிநிதித்துவம் வரையறுக்கிறது.

RESTful இணைய சேவை API இல் HTTP முறைகள்

RESTful வலை சேவை API ஆனது ஆதாரங்களை அணுகுவதற்கும் கையாளுவதற்கும் HTTP நெறிமுறையைப் பயன்படுத்துகிறது. RESTful இணைய சேவையில் GET, PUT, POST, DELETE ஆகிய நான்கு முதன்மை HTTP முறைகள் பயன்படுத்தப்படுகின்றன. இந்த HTTP முறைகள் ஒவ்வொன்றையும் சுருக்கமாக அறிந்து கொள்வோம்.

    பெறு:GET முறையானது RESTful API இன் ஆதாரங்களை அணுக பயனர்களுக்கு உதவுகிறது. ஆனால், அவற்றை மாற்றவோ, கையாளவோ முடியாது. GET முறையைப் பயன்படுத்தி, நீங்கள் ஆதாரங்களை மட்டுமே படிக்க முடியும்.போடு:HTTP PUT முறையானது வளங்களை மாற்ற அல்லது அவற்றின் நிலைகளை மாற்ற உங்களை அனுமதிக்கிறது. இது மற்றொரு புதிய ஆதாரத்தை உருவாக்க உங்களை அனுமதிக்கிறது.அஞ்சல்:புதிய ஆதாரத்தை உருவாக்க நீங்கள் POST முறையைப் பயன்படுத்தலாம்.அழி:ஆதாரத்தை நீக்க HTTP DELETE முறை பயன்படுத்தப்படுகிறது.

RESTful இணைய சேவை API ஆனது, application/xml, application/json, application/x-www-form-urlencoded, application.x-web+xml மற்றும் multipart/form-data போன்ற பல தரவு வடிவங்களை ஆதரிக்கிறது.

RESTful API கட்டிடக்கலை பண்புகள் மற்றும் கட்டுப்பாடுகள்

டாக்டர் ராய் ஃபீல்டிங் RESTful இணைய சேவை API இன் டெவலப்பர் ஆவார். RESTful API கட்டமைப்பின் சில குறிப்பிடத்தக்க பண்புகள் மற்றும் கட்டுப்பாடுகள் கீழே உள்ளன.

RESTful API இன் பண்புகள்

  1. RESTful API இறுதி பயனர்களுக்கு உயர் செயல்திறனை வழங்குகிறது. எந்தவொரு இணைப்பையும் பயனர் கிளிக் செய்தால், அவருக்கு உடனடி முடிவுகள் வழங்கப்படுகின்றன. மேலும் டெவலப்பர்கள் அனைத்து சேவைகளையும் பயனர்களுக்கு வழங்குகிறார்கள்.
  2. RESTful API இன் மற்றொரு பண்பு அளவிடுதல் ஆகும். RESTful API ஆனது பயனர்கள் அதிகரித்தாலும் அல்லது குறைந்தாலும் தொடர்ந்து சேவைகளை வழங்குகிறது.
  3. RESTful API ஆனது ஒரு சீரான இடைமுகத்தைக் கொண்டுள்ளது. அனைத்து ஆதாரங்களும் அந்தந்த URIகளைப் பயன்படுத்தி அடையாளம் காணப்படுகின்றன. எனவே, இந்த சீரான இடைமுகம் RESTful API ஐ எளிதாக்குகிறது.
  4. அடுத்த சொத்து மாற்றியமைத்தல். அமைப்பில் எந்த மாற்றமும் எளிதாகவும் வசதியாகவும் நடக்க வேண்டும்.
  5. RESTful API கட்டமைப்பு மிகவும் கையடக்கமானது மற்றும் நம்பகமானது.

RESTful API இன் கட்டடக்கலை கட்டுப்பாடுகள்

எந்தவொரு RESTful வலை சேவை API க்கும், கீழே உள்ள ஆறு கட்டடக்கலை நிபந்தனைகள் இருக்க வேண்டும்.

  1. RESTful வலை சேவை APIக்கான முதல் கட்டடக்கலைக் கட்டுப்பாடு, அது ஒரு சீரான இடைமுகத்தைப் பயன்படுத்த வேண்டும். அனைத்து RESTful API ஆதாரங்களும் அந்தந்த சீரான ஆதார அடையாளங்காட்டிகளை (URIகள்) பயன்படுத்தி அடையாளம் காணப்பட வேண்டும். PUT, POST, GET மற்றும் DELETE ஆகிய நான்கு HTTP முறைகள் மூலம் மட்டுமே அவற்றை அணுக வேண்டும் மற்றும் கையாள வேண்டும்.
  2. RESTful API இல் உள்ள கிளையன்ட் மற்றும் சர்வர் ஒரு துல்லியமான பிரதிநிதித்துவத்தைக் கொண்டிருக்க வேண்டும். வாடிக்கையாளர் ஒரே மாதிரியான இடைமுகம் மற்றும் கோரிக்கை சேகரிப்பை கையாளுகிறார். மறுபுறம், சேவையகம் பாதுகாப்பு, தரவு அணுகல் மற்றும் பணிச்சுமை மேலாண்மை ஆகியவற்றை ஒழுங்குபடுத்துகிறது. சேவையகம் அனைத்து ஆதாரங்களையும் வைத்திருக்கிறது, மேலும் கிளையன்ட் சேவையகத்திலிருந்து ஆதாரங்களைக் கோருகிறது.
  3. RESTful வலை சேவை APIக்கான மற்றொரு கட்டடக்கலை தடையானது நிலையற்ற செயல்பாடுகள் ஆகும். RESTful API இல் உள்ள கிளையன்ட் மற்றும் சர்வர் நிலையற்ற செயல்பாடுகளைப் பின்பற்ற வேண்டும். அனைத்து மாநில நிர்வாக நடவடிக்கைகளும் வாடிக்கையாளர் பக்கத்தில் மேற்கொள்ளப்பட வேண்டும்.
  4. அனைத்து RESTful வலை சேவை APIகளும் கேச்சிங் செய்ய வேண்டும். கேச்சிங் சாத்தியமில்லை என்று குறிப்பிடப்பட்டால், கேச்சிங் மட்டும் செய்யக்கூடாது.
  5. ஒரு குறிப்பிட்ட பயன்பாட்டின் கட்டமைப்பு பல அடுக்குகளில் சேவையகத்தைக் கொண்டிருக்க வேண்டும். ஒரு அடுக்கு அதன் உடனடி அடுக்கு தவிர, மற்ற அடுக்குகள் தொடர்பான எந்த தகவலையும் கொண்டிருக்கக்கூடாது.
  6. பொதுவாக, சேவையகம் XML அல்லது JSON வடிவத்தில் கிளையண்டிற்கு ஆதாரங்களின் நிலையான பிரதிநிதித்துவங்களை அனுப்புகிறது. தேவைப்படும் போது அது இயங்கக்கூடிய குறியீட்டை கிளையண்டிற்கு அனுப்ப வேண்டும்.

அடுத்த பகுதியில், HTTP முறைகளைப் பயன்படுத்தி இணையச் சேவையை எவ்வாறு உருவாக்குவது என்பதைக் கற்றுக்கொள்வோம். பயனர் நிர்வாகத்தை உருவாக்க, GET மற்றும் POST ஆகிய இரண்டு HTTP முறைகளைப் பயன்படுத்துவோம். பின்வரும் சில அத்தியாவசிய செயல்பாடுகள் பயன்படுத்தப்படுகின்றன:

  1. HTTP GET முறையைப் பயன்படுத்தி வெற்று POST உடலுடன், பயனர் பெயர்களைக் கொண்ட பட்டியலைக் காண்பிப்போம். என ஒரு சீரான வள அடையாளங்காட்டியை எடுத்துக் கொள்ளுங்கள் /பயனர்/சேவை/பயனர்கள் .
  2. பின்னர், ஒவ்வொரு பயனரின் விவரங்களையும் பட்டியலில் சேர்ப்போம். இந்த நோக்கத்திற்காக, POST உடலில் JSON சரத்துடன் HTTP POST முறையைப் பயன்படுத்துவோம். URI ஐப் பயன்படுத்தவும் /பயனர்/சேவை/சேர்ப்பவர் .
  3. கடைசியாக, HTTP GET முறையைப் பயன்படுத்தி தனித்தனி பயனர்களின் விவரங்களைக் காண்பிப்போம். POST உடலை காலியாக வைத்து URI ஐப் பயன்படுத்தவும் /User/Service/getUser/:id .

RESTful இணைய சேவைகளுக்கான சுற்றுச்சூழல் அமைப்பு

RESTful இணைய சேவையுடன் பணிபுரிய, நாங்கள் பயன்படுத்துவோம் ஜெர்சி கட்டமைப்பு . இந்த கட்டமைப்பு JAX-RS 2.0 API எனப்படும் நிலையான விவரக்குறிப்பை செயல்படுத்துகிறது. இந்த விவரக்குறிப்பைப் பயன்படுத்தி, நாம் RESTful இணைய சேவைகளை உருவாக்க முடியும். ஜெர்சி கட்டமைப்பை நோக்கிச் செல்வதற்கு முன், உங்கள் கணினி அமைப்பில் எக்லிப்ஸ், டாம்கேட் மற்றும் ஜேடிகே சூழலை அமைக்க கற்றுக்கொள்வோம். கணினியில் மூன்று சூழல்களையும் துல்லியமான மற்றும் நேரடியான வழிமுறைகளுடன் அமைப்பதை நாங்கள் விளக்கியுள்ளோம்.

ஜாவா டெவலப்மெண்ட் கிட் (ஜேடிகே) அமைப்பது எப்படி?

தி ஜாவா டெவலப்மெண்ட் கிட் (ஜேடிகே) ஜாவா குறியீட்டை இயக்குவதற்குப் பயன்படுத்தப்படும் அத்தியாவசிய தொகுப்புகளில் ஒன்றாகும். Java இல் உள்ள JDK தொகுப்பு பயனர்களுக்கு ஜாவா நிரல்களை எழுத உதவுகிறது. JavaSE என பெயரிடப்பட்ட இந்த தொகுப்பை இதிலிருந்து பதிவிறக்கம் செய்ய வேண்டும் இணையதளம் :

பதிவிறக்கிய பிறகு, வழங்கப்பட்ட வழிகாட்டுதல்களின் உதவியுடன் அதை நிறுவவும். முடிந்ததும், நீங்கள் PATH மற்றும் JAVA_HOME சூழல் மாறிகளை 'java' மற்றும் 'javac' இருக்கும் இடத்தில் சரிசெய்ய வேண்டும். பொதுவாக, 'java' java_install_dir/bin இல் உள்ளது, மேலும் 'javac' என்பது 'java_install_dir.'

Windows XP, NT அல்லது 2000 சிஸ்டங்களில் PATH மற்றும் JAVA_HOME சூழல் மாறிகளை சரிசெய்ய, 'My Computer' என்பதற்குச் சென்று, அதில் வலது கிளிக் செய்து, 'Properties' என்பதைக் கிளிக் செய்யவும். 'மேம்பட்ட தாவலைக் காண்பீர்கள்.' அதைக் கிளிக் செய்யவும். பின்னர் 'சுற்றுச்சூழல் மாறிகள்' என்பதைக் கிளிக் செய்யவும். கணினியில் 'ஜாவா' மற்றும் 'ஜாவாக்' இருப்பிடத்துடன் PATH மற்றும் JAVA_HOME சூழல் மாறிகளை மாற்றி, 'சரி' பொத்தானைக் கிளிக் செய்யவும். உங்கள் சூழல் மாறி அமைவு முடிந்தது.

லினக்ஸ் மற்றும் சோலாரிஸ் அமைப்புகளுக்கு, கீழே உள்ள படிகளைப் பின்பற்றவும். நீங்கள் C ஷெல்லைப் பயன்படுத்துகிறீர்கள் என்று கருதுங்கள், மேலும் /usr/local/jdk1.7.9_75 இடத்தில் JavaSE கோப்பைப் பதிவிறக்கம் செய்துள்ளீர்கள். கீழே உள்ள கட்டளைகளுடன் ‘.cshrc’ கோப்பைப் புதுப்பிக்கவும்:

|_+_|

Eclipse IDEஐ எவ்வாறு அமைப்பது?

நீங்கள் பின்பற்ற வேண்டிய முதல் விஷயம், கிரகணத்தின் சமீபத்திய பைனரிகளை அதன் அதிகாரப்பூர்வத்திலிருந்து பதிவிறக்கம் செய்வதாகும் இணையதளம் .

புதிய எக்லிப்ஸ் பைனரிகளைப் பதிவிறக்கிய பிறகு, அவற்றை உங்கள் கணினியில் சரியான இடத்தில் வைக்கவும். விண்டோஸ் சிஸ்டங்களில் எக்லிப்ஸ் பைனரிகளை C:eclipse இல் கண்டுபிடித்துள்ளோம். லினக்ஸ் அல்லது யூனிக்ஸ் சிஸ்டத்திற்கான எக்லிப்ஸ் பைனரிகளை /usr/local/eclipse இடத்தில் கண்டறிவோம். நீங்கள் அதை சரியான இடத்தில் வைத்த பிறகு, நீங்கள் எக்லிப்ஸ் பைனரிகளை வைத்திருக்கும் இடத்திற்கு PATH மாறியை சரிசெய்யவும்.

கிரகணத்தைத் தொடங்க, eclipse.exe கோப்பில் இருமுறை கிளிக் செய்யவும் அல்லது Windows கட்டளை வரியில் கீழே உள்ள கட்டளையைத் தட்டச்சு செய்யலாம்.

|_+_|

நீங்கள் Linux அல்லது Solaris கணினியில் Eclipse ஐப் பயன்படுத்தினால், அதைத் தொடங்க கீழே உள்ள கட்டளையைப் பயன்படுத்தவும்.

|_+_|

எல்லாம் சரியாக நடந்தால் மற்றும் செட்-அப் சரியாக இருந்தால், பயன்பாடு தொடங்கும் மற்றும் குறியீட்டை எழுதுவதற்கான திரை தோன்றும்.

Apache Tomcat-ஐ எவ்வாறு அமைப்பது?

இங்கே, Apache Tomcat க்காக உங்கள் கணினியின் சூழலை எவ்வாறு நிறுவுவது மற்றும் அமைப்பது என்பதை நாங்கள் புரிந்துகொள்வோம். முதலில், நீங்கள் சமீபத்திய டாம்கேட் பதிப்பைப் பதிவிறக்க வேண்டும் இணையதளம் .

இந்த சமீபத்திய டாம்கேட் பதிப்பைப் பதிவிறக்கிய பிறகு, அதை உங்கள் கணினியில் பொருத்தமான இடத்தில் வைக்கவும்.

டாம்கேட் அப்பாச்சி கோப்பை விண்டோஸ் சிஸ்டத்தில் C:apache-tomcat-7.0.59 இடத்தில் வைத்தோம். Tomcat Apache கோப்பை /usr/local/apache-tomcat-7.0.59 இல் வைப்போம் லினக்ஸ் அல்லது சோலாரிஸ் அமைப்பு. அதன் பிறகு, நீங்கள் பதிவிறக்கம் செய்யப்பட்ட Tomcat Apache கோப்பை வைத்திருக்கும் இடத்தில் CATALINA_HOME சூழல் மாறியை சரிசெய்ய வேண்டும்.

Startup.bat கோப்பைக் கிளிக் செய்வதன் மூலம் உங்கள் Windows கணினியில் Tomcat பயன்பாட்டைத் தொடங்கலாம். டாம்கேட் பயன்பாட்டைத் தொடங்க பின்வரும் கட்டளையையும் நீங்கள் பயன்படுத்தலாம்.

|_+_|

அல்லது

|_+_|

நீங்கள் Linux அல்லது Solaris கணினியில் Tomcat பயன்பாட்டைப் பயன்படுத்துகிறீர்கள் என்றால், அதைத் தொடங்க கீழே உள்ள கட்டளைகளில் ஏதேனும் ஒன்றைப் பின்பற்ற வேண்டும்.

|_+_|

அல்லது

|_+_|

எல்லாம் சரியாக இருக்கும்போது, ​​​​குறியீட்டை எழுதி அதை இயக்கக்கூடிய ஒரு திரை தோன்றும். Tomcat உடனான அனைத்து இயல்புநிலை பயன்பாடுகளும் கீழே உள்ளதைப் பார்வையிடுவதன் மூலம் கிடைக்கும் இணையதளம் :

டாம்கேட் உள்ளமைவு மற்றும் அதில் இயங்கும் புரோகிராம்கள் பற்றிய முழுமையான தகவல்கள் கிடைக்கின்றன இணையதளம் .

விண்டோஸ் சிஸ்டத்தில் டாம்கேட் பயன்பாட்டை நிறுத்த விரும்பினால், பின்வரும் கட்டளைகளில் ஏதேனும் ஒன்றை டைப் செய்யவும்.

|_+_|

அல்லது

|_+_|

Tomcat பயன்பாட்டை நிறுத்துவதற்கு கீழே குறிப்பிடப்பட்டுள்ள இரண்டு கட்டளைகளில் ஏதேனும் ஒன்றை நீங்கள் தட்டச்சு செய்யலாம்.

|_+_|

அல்லது

|_+_|

ஜெர்சி கட்டமைப்பு நூலகங்களை எவ்வாறு அமைப்பது?

JDK, Eclipse மற்றும் Tomcat Apache ஆகியவற்றை அமைத்த பிறகு, நீங்கள் இப்போது ஜெர்சி கட்டமைப்பை அமைப்பதற்கு செல்லலாம். ஜெர்சி ஃபிரேம்வொர்க்கைப் பதிவிறக்க, கீழே உள்ள வழிகாட்டுதல்களைப் பின்பற்றவும்.

  1. முதலில், விண்டோஸ் அல்லது யூனிக்ஸ் போன்ற இயக்க முறைமையில் ஜெர்சி கட்டமைப்பை நிறுவ நீங்கள் முடிவு செய்ய வேண்டும். நீங்கள் Windows சிஸ்டத்தைத் தேர்வுசெய்தால், .zip கோப்பைப் பதிவிறக்கவும், Unix கணினிகளுக்கு, .tz கோப்பைப் பதிவிறக்கவும்.
  2. புதிய ஜெர்சி ஃபிரேம்வொர்க் பைனரிகளை கீழே இருந்து பதிவிறக்குவது அடுத்த படியாகும் இணையதளம் .
  3. விண்டோஸ் சிஸ்டத்தில் .zip கோப்பைப் பதிவிறக்கிய பிறகு, அதை அன்ஜிப் செய்ய வேண்டும். நீங்கள் jaxrs-ri-2.17.zip கோப்பை பதிவிறக்கம் செய்துள்ளீர்கள் என்று வைத்துக்கொள்வோம். இந்தக் கோப்பை அன்ஜிப் செய்த பிறகு, இது E:jaxrs-ri-2.17jaxrs-ri இடத்தில் ஒரு கோப்பக அமைப்பை வழங்குகிறது.
  4. அனைத்து ஜெர்சி நூலகங்களும் C:jaxrs-ri-2.17jaxrs-rilib கோப்பகத்தில் இருக்கும், மேலும் சார்புகள் C:jaxrs-ri-2.17jaxrs-riext இல் இருக்கும்.
  5. பின்னர், உங்கள் ஜெர்சி நூலகங்கள் இருக்கும் இடத்தில் CLASSPATH மாறியை சரிசெய்யவும், C:jaxrs-ri-2.17jaxrs-rilib கோப்பகம். நீங்கள் Eclipse பயன்பாட்டைப் பயன்படுத்தினால், Jersey Frameworkக்கான CLASSPATH மாறியை சரிசெய்ய வேண்டிய அவசியமில்லை என்பதை நினைவில் கொள்ளுங்கள்.

RESTful இணைய சேவைக்கான சூழலை எவ்வாறு அமைப்பது என்பது இப்போது உங்களுக்குத் தெரியும். மேலே உள்ள அனைத்து படிகளையும் பின்பற்றவும், நீங்கள் ஜெர்சி உதாரணத்தை எழுத தயாராக இருப்பீர்கள்.

நிம்மதியான முதல் உதாரணம் - ஜெர்சி (JAX-RS)

Java, Tomcat Apache, Eclipse மற்றும் Jersey Framework சூழலை அமைத்த பிறகு, RESTful API ஐப் பயன்படுத்தி இணைய பயன்பாடுகளை உருவாக்கத் தொடங்கலாம். RESTful API இல் நிரலை எழுதுவது பற்றிய துல்லியமான யோசனையைப் பெற, Jersey Framework இல் உள்ள ஒரு உதாரணத்தைக் கவனிப்போம். நிரலை வெற்றிகரமாக இயக்க, கீழே குறிப்பிடப்பட்டுள்ள படிகளை நீங்கள் பின்பற்ற வேண்டும்.

படி 1: ஜாவா திட்டத்தை உருவாக்கவும்

Eclipse IDE ஐப் பயன்படுத்தி ஜாவா திட்டத்தை உருவாக்கவும். இங்கே, நாம் ஒரு டைனமிக் வலைத் திட்டத்தை உருவாக்குவோம். அதற்கான படிகள் கீழே உள்ளன டைனமிக் வலையை உருவாக்குங்கள் எக்லிப்ஸ் ஐடிஇயில் திட்டம்.

  1. உங்கள் கணினியிலிருந்து எக்லிப்ஸ் பயன்பாட்டைத் தொடங்கவும். கோப்பு விருப்பத்தைக் கிளிக் செய்து, புதியதைக் கிளிக் செய்து, புதிய திட்டத்தைத் தேர்ந்தெடுக்கவும்.
  2. பின்னர், வழிகாட்டி பட்டியலிலிருந்து வழிகாட்டி டைனமிக் வலைத் திட்டத்தைத் தேர்ந்தெடுக்கவும்.
  3. வழிகாட்டியைத் தேர்ந்தெடுத்த பிறகு, உங்கள் திட்டத்திற்கு விரும்பிய பெயரைக் கொடுங்கள், சொல்லுங்கள் முதல் ரெஸ்ட் எடுத்துக்காட்டு .
  4. உங்கள் திட்டத்தின் பெயரை வழிகாட்டி சாளரத்தில் சேமிக்கும் போது, ​​ப்ராஜெக்ட் எக்ஸ்ப்ளோரருக்குச் செல்லவும், அங்கு உங்கள் திட்டத்தின் பெயரைக் காண்பீர்கள்.

படி 2: தேவையான நூலகங்களைச் சேர்க்கவும்

திட்டத்தை உருவாக்கி அதை ஒரு குறிப்பிட்ட பெயரில் சேமித்த பிறகு, உங்கள் திட்டத்தில் ஜெர்சி ஃப்ரேம்வொக்கின் நூலகங்களையும் சார்புகளையும் சேர்க்க வேண்டும். ஜெர்சியின் ஜிப் கோப்புறையிலிருந்து உருவாக்கப்பட்ட திட்டத்தின் WEB-INF/lib கோப்பகத்தில் நகலெடுக்க வேண்டிய ஜார் கோப்பு பெயர்களை பட்டியலிட்டுள்ளோம்.

  • jaxrs-ri-2.17jaxrs-riapi
  • jaxrs-ri-2.17jaxrs-riext
  • jaxrs-ri-2.17jaxrs-rilib

மேலே குறிப்பிட்டுள்ள ஜார் கோப்புகளை உங்கள் திட்டப்பணியில் சேர்க்க, உங்கள் திட்டப்பணியில் வலது கிளிக் செய்யவும். முதல் ரெஸ்ட் எடுத்துக்காட்டு . Build Path விருப்பத்தை கிளிக் செய்து, பின்னர் Configure Build Path என்பதற்குச் செல்லவும். இங்கே, ஜாவா பில்ட் பாதையைக் காண்பிக்கும் சாளரத்தைக் காண்பீர்கள். கூடுதலாக, நூலகங்கள் மெனுவின் கீழ், ஜார்களைச் சேர் பொத்தானைக் காண்பீர்கள். ஜார் கோப்புகளை WEB-INF/lib கோப்பகத்தில் சேர்க்கவும்.

படி 3: மூல கோப்புகளை உருவாக்கவும்

எக்லிப்ஸ் ஐடிஇயில் FirstRestExample என பெயரிடப்பட்ட எங்கள் திட்டத்தை உருவாக்கியுள்ளோம். இப்போது, ​​இந்த திட்டத்திற்கான மூல கோப்புகளை நாம் உருவாக்க வேண்டும். மூல கோப்புகளை உருவாக்க, முதலில் ஒரு தொகுப்பை உருவாக்க வேண்டும், com.restexample என்று சொல்லுங்கள். தொகுப்பு எக்ஸ்ப்ளோரருக்குச் சென்று src விருப்பத்தின் மீது வலது கிளிக் செய்யவும். நீங்கள் புதிய விருப்பத்தைக் காண்பீர்கள். அதைக் கிளிக் செய்து, பின்னர் தொகுப்பு விருப்பத்தை சொடுக்கவும்.

இங்கே நீங்கள் com.restexample தொகுப்பின் கீழ் மூன்று வெவ்வேறு கோப்புகளை உருவாக்க வேண்டும். கோப்புகளுக்கு EmployeeService.java, Employee.java மற்றும் EmployeeDao.java என பெயரிடுவோம். மூன்று கோப்புகளில், நீங்கள் com.restexmaple தொகுப்பின் கீழ் உருவாக்கியுள்ளீர்கள், மேலும் நீங்கள் குறியீட்டை எழுத வேண்டும். முதலில் Employee.java கோப்பில் குறியீட்டை எழுதுவோம்.

பணியாளர்.ஜாவா

|_+_|

EmployeeDao.java

|_+_|

EmployeeService.java

|_+_|

மேலே உள்ள EmployeeService.java கோப்பில், வலைச் சேவைக்கான பாதையைக் குறிப்பிடுவதற்கு @Path என்ற சிறுகுறிப்பைப் பயன்படுத்தியுள்ளோம் என்பதை நீங்கள் நினைவில் கொள்ள வேண்டும். கூடுதலாக, @Path சிறுகுறிப்பைப் பயன்படுத்தி குறிப்பிட்ட இணைய சேவை முறைக்கான பாதையையும் அமைத்துள்ளோம்.

படி 4: Web.xml கோப்பை உருவாக்கவும்

கடைசியாக, Web.xml கோப்பை உருவாக்க வேண்டும். Web.xml கோப்பின் முதன்மை நோக்கம் ஜெர்சி ஃபிரேம்வொர்க் சர்வ்லெட்டை உருவாக்குவதுதான்.

web.xml

|_+_|

படி 5: நிரலைத் தொகுத்து இயக்கவும்

மேலே குறிப்பிட்டுள்ள நான்கு கோப்புகளையும் எழுதி முடித்த பிறகு, நிரலை விளம்பர இயக்கத்தை தொகுக்க நீங்கள் தயாராக உள்ளீர்கள். மேலே உள்ள அனைத்து நிரல்களையும் எழுதுவதற்கு Eclipse IDE ஐப் பயன்படுத்தியுள்ளோம். எனவே மேலே உள்ள அப்ளிகேஷனை போர் கோப்பில் ஏற்றுமதி செய்ய வேண்டும். பின்னர், இந்த போர் கோப்பை Tomcat Apache கருவியில் தொகுத்து இயக்க வேண்டும்.

எக்லிப்ஸ் ஐடிஇயில் போர்க் கோப்பை எவ்வாறு உருவாக்குவது என்பதை கீழே காண்போம்.

  • Eclipse IDE இல், கோப்பு விருப்பத்திற்குச் சென்று, Export -> We -> War File என்பதைக் கிளிக் செய்யவும். அங்கு நீங்கள் உங்கள் திட்டத்தை தேர்வு செய்ய வேண்டும் முதல் ரெஸ்ட் எடுத்துக்காட்டு மற்றும் இலக்கு கோப்புறை.
  • பின்னர், நீங்கள் FirstRestExample.war கோப்பைக் கண்டறிய வேண்டும் டாம்கேட் நிறுவல் கோப்பகம் விருப்பங்கள் webapps அடைவு . டாம்கேட் பயன்பாட்டைத் தொடங்கவும்.

டாம்கேட்டின் வெப்அப்ஸ் கோப்பகத்தில் போர்க் கோப்பை வைத்த பிறகு, உங்கள் விண்ணப்பத்தை இயக்கலாம். நாங்கள் Chrome நீட்டிப்பைப் பயன்படுத்துவோம், தபால்காரர் , எங்கள் பயன்பாடுகளை சோதிப்பதற்காக. அடுத்த கட்டமாக அனைத்து ஊழியர்களையும் POSTMAN இல் வைப்பது. இதைச் செய்ய, கீழே உள்ள குறியீட்டைப் பயன்படுத்தவும்

|_+_|

டாம்கேட் அப்பாச்சியில் மேலே உள்ள குறியீட்டைப் பயன்படுத்த, HTTP GET முறையைப் பயன்படுத்தவும். இதோ உங்களின் முதல் இணைய சேவை பயன்பாடு தயாராக உள்ளது.

RESTful Web Service API இல் உள்ள செய்திகள்

RESTful API இல், கிளையன்ட் மற்றும் சர்வர் HTTP நெறிமுறையைப் பயன்படுத்தி ஒருவருக்கொருவர் தொடர்பு கொள்கின்றன. கிளையன்ட் சேவையகத்திற்கு HTTP கோரிக்கையை அனுப்பும் போது தொடர்பு ஏற்படுகிறது, மேலும் HTTP பதிலுடன் சேவையகம் கிளையண்டிற்கு பதிலளிக்கிறது. HTTP நெறிமுறையைப் பயன்படுத்தி கிளையன்ட் மற்றும் சர்வர் இடையேயான தொடர்பு செய்தியிடல் என குறிப்பிடப்படுகிறது. ஒரு HTTP செய்தியில் செய்தி தரவு மற்றும் மெட்டாடேட்டா உள்ளது. மெட்டாடேட்டா என்பது செய்தித் தகவல்.

இப்போது, ​​RESTful இணைய சேவை API இல் HTTP கோரிக்கை மற்றும் HTTP பதிலைப் பார்ப்போம்.

HTTP கோரிக்கை

கிளையன்ட் ஒரு HTTP கோரிக்கையை சேவையகத்திற்கு அனுப்புகிறார். இது சேவையகத்திலிருந்து ஆதாரங்களைக் கோருகிறது. HTTP கோரிக்கை, வினைச்சொல், URI, HTTP பதிப்பு, கோரிக்கை தலைப்பு மற்றும் கோரிக்கை உள்ளடக்கத்தில் ஐந்து முதன்மை பகுதிகள் சேர்க்கப்பட்டுள்ளன. பின்வருவது HTTP கோரிக்கை வடிவம்.

நிம்மதியான

HTTP கோரிக்கையின் ஒவ்வொரு பகுதியையும் சுருக்கமாக விவரிப்போம்.

    வினைச்சொல்:ஒரு HTTP கோரிக்கையில் உள்ள வினைச்சொல், GET, POST, PUT மற்றும் DELETE ஆகிய நான்கு HTTP முறைகளைக் குறிக்கிறது.சீரான வள அடையாளங்காட்டி (URI):HTTP கோரிக்கையின் அடுத்த பகுதி ஒரு சீரான கோரிக்கை அடையாளங்காட்டி (URI) ஆகும். ஒரு URI ஒவ்வொரு வளத்தையும் தனித்தனியாக அடையாளப்படுத்துகிறது.HTTP பதிப்பு:HTTP கோரிக்கையின் மூன்றாம் பகுதி HTTP பதிப்பாகும். உதாரணமாக, HTTP v1.1, v1.1 என்பது ஒரு பதிப்பாகும்.கோரிக்கை தலைப்பு:கோரிக்கை தலைப்பில் செய்தியின் மெட்டாடேட்டா உள்ளது. கோரிக்கை தலைப்பில் உள்ள மெட்டாடேட்டா முக்கிய மதிப்பு ஜோடியில் உள்ளது. இது கிளையன்ட் வகை, கேச் அமைப்புகள், செய்தி வடிவம் போன்ற தகவல்களைச் சேகரிக்கலாம்.கோரிக்கை உடல்:HTTP கோரிக்கையில் உள்ள கோரிக்கை அமைப்பு என்பது வளத்தின் பிரதிநிதித்துவத்தைக் குறிக்கிறது.

HTTP பதில்

சேவையகம் கிளையண்டிடமிருந்து HTTP கோரிக்கையைப் பெறும்போது, ​​அது கிளையண்டிற்கு HTTP பதிலுடன் பதிலளிக்கிறது. ஒரு HTTP பதிலில் நான்கு குறிப்பிடத்தக்க பகுதிகள் அடங்கும், பதில் குறியீடு, HTTP பதிப்பு, பதில் தலைப்பு மற்றும் மறுமொழி உடல். கீழே ஒரு HTTP மறுமொழி வடிவம் உள்ளது.

img 617dd1cb36593

ஒவ்வொரு HTTP மறுமொழி பகுதியையும் இங்கு விவாதிப்போம்.

    பதில் குறியீடு:

பதில் குறியீடு நிலை என்றும் குறிப்பிடப்படுகிறது. கிளையன்ட் சேவையகத்திலிருந்து ஆதாரத்தைக் கோரும்போது, ​​பதில் குறியீடு அதன் நிலையைக் காட்டுகிறது. நிலை 404 எனில், ஆதாரம் கிடைக்கவில்லை. பதில் சரி என்றால், நிலை 200.

    HTTP பதிப்பு:

HTTP பதிலின் இரண்டாம் பகுதி HTTP பதிப்பாகும். உதாரணமாக, HTTP v1.1, v1.1 என்பது ஒரு பதிப்பாகும்.

    பதில் தலைப்பு:

ஹெடரில் HTTP ரெஸ்பான்ஸ் மெசேஜின் மெட்டாடேட்டா முக்கிய மதிப்பு ஜோடி வடிவில் உள்ளது. இது சர்வர் வகை, உள்ளடக்க நீளம், பதில் தரவு போன்ற தகவல்களைக் கொண்டிருக்கலாம்.

    மறுமொழி அமைப்பு:

பதிலளிப்பு அமைப்பு வளத்தின் பிரதிநிதித்துவத்தை உள்ளடக்கியது.

RESTful வலை சேவை API இன் மேலே உள்ள எடுத்துக்காட்டில், நாங்கள் வைத்துள்ளோம் http://localhost:8080/FirstRestExample/rest/EmployeeService/employees .

POSTMAN இல், HTTP GET முறையைப் பயன்படுத்துகிறது. GET முறையைப் பயன்படுத்தி கோரிக்கை அனுப்பப்படும்போது, ​​பின்வருமாறு XML செய்தியைப் பெறுவோம். XML பதிலைப் பார்க்க, நீங்கள் முன்னோட்டம் பொத்தானைக் கிளிக் செய்ய வேண்டும்.

|_+_|

RESTful Web Service API இல் உள்ள ஆதாரம்

RESTful இணைய சேவை API இல், ஒவ்வொரு உள்ளடக்கமும் ஒரு ஆதாரமாகக் கருதப்படுகிறது. கிளையன்ட் ஆதாரத்தைக் கோருகிறார், மேலும் கிளையன்ட் கோரும் குறிப்பிட்ட ஆதாரத்திற்கான அணுகலை சேவையகம் வழங்குகிறது. அணுகலை வழங்கிய பிறகு, வாடிக்கையாளர் வளத்தை மாற்றலாம் அல்லது மாற்றலாம். ஆதாரம் HTML பக்கங்கள், படங்கள், உரை கோப்புகள் அல்லது வணிகத் தரவு.

REST கட்டமைப்பில் ஒவ்வொரு ஆதாரத்திற்கும் ஒரு தனிப்பட்ட எண் உள்ளது. இந்த தனித்துவமான எண் ஒரு சீரான ஆதார அடையாளங்காட்டி (URI) என குறிப்பிடப்படுகிறது. பொதுவாக, REST கட்டமைப்பில் உள்ள வளமானது XML அல்லது JSON வடிவத்தைப் பயன்படுத்தி குறிப்பிடப்படுகிறது. REST கட்டமைப்பில் உள்ள வளங்களின் பிரதிநிதித்துவத்தை இப்போது பார்க்கலாம்.

REST கட்டமைப்பில் வள பிரதிநிதித்துவம்

REST கட்டமைப்பில் உள்ள ஆதாரங்கள் XML அல்லது JSON வடிவங்களில் குறிப்பிடப்படுகின்றன. நீங்கள் ஒரு REST ஆதாரத்தை தரவுத்தளத்தில் உள்ள ஒரு பொருளாகவோ அல்லது பொருள் சார்ந்த நிரலாக்கத்தில் ஒரு பொருளாகவோ கருதலாம். முதலாவதாக, வளமானது அதன் சீரான வள அடையாளங்காட்டியை (URI) பயன்படுத்தி அடையாளம் காணப்படுகிறது. பின்னர், வளத்தை பிரதிநிதித்துவப்படுத்துவதற்கான நிலையான வடிவம் தீர்மானிக்கப்படுகிறது. கிளையன்ட் ஆதாரத்தைக் கோரும்போது, ​​சேவையகம் கிளையண்ட் குறிப்பிட்ட படிவத்தில் ஆதாரத்தை அனுப்புகிறது.

எங்களின் மேலே உள்ள RESTful உதாரணத்தில், எங்களிடம் ஒரு 'பணியாளர்' வளமாக இருக்கிறார். எக்ஸ்எம்எல் படிவத்தைப் பயன்படுத்தி 'பணியாளர்' வளம் எவ்வாறு குறிப்பிடப்படுகிறது என்பதைப் பார்ப்போம்.

|_+_|

இப்போது, ​​அதே 'பணியாளர்' வளத்தை JSON படிவத்தில் சித்தரிப்போம்.

|_+_|

REST கட்டமைப்பில், நீங்கள் எந்த வடிவத்திலும் ஆதாரங்களைக் குறிப்பிடலாம். RESTful வலை சேவை API இல் ஒரு கிளையன்ட் XML வடிவத்தில் ஆதாரத்தைக் கோரும் போது மற்ற கிளையன்ட் JSON படிவத்தில் அதே ஆதாரத்தைக் கோரும் சந்தர்ப்பங்கள் உள்ளன. வள பிரதிநிதித்துவத்தில் உள்ள ஒரே குறிப்பிடத்தக்க விஷயம் என்னவென்றால், வாடிக்கையாளர் புரிந்து கொள்ளக்கூடிய வடிவத்தில் அது குறிப்பிடப்பட வேண்டும்.

எந்தவொரு வடிவத்திலும் ஆதாரம் குறிப்பிடப்படும்போது, ​​கருத்தில் கொள்ள சில முன்நிபந்தனைகள் உள்ளன. ஆதார வடிவம் புரிந்துகொள்ளக்கூடியதாகவும், முழுமையானதாகவும், இணைக்கக்கூடியதாகவும் இருக்க வேண்டும். REST கட்டமைப்பில் உள்ள கிளையன்ட் மற்றும் சேவையகம் வள பிரதிநிதித்துவ வடிவமைப்பை விரைவாக ஒப்புக் கொள்ள வேண்டும். வளத்தைப் பிரதிநிதித்துவப்படுத்த நீங்கள் தேர்ந்தெடுக்கும் எந்தப் படிவமும் முழுமையான ஆதாரத் தகவலை வழங்க வேண்டும். ஆதார பிரதிநிதித்துவ வடிவம் வேறு எந்த ஆதாரத்திற்கும் இணைப்பை அனுமதிக்க வேண்டும்.

பெரும்பாலான டெவலப்பர்கள் REST கட்டமைப்பில் உள்ள வளத்தைப் பிரதிநிதித்துவப்படுத்த JSON அல்லது XML படிவத்தைப் பயன்படுத்துகின்றனர். JSON அல்லது XML தரவை மாற்றுவதற்கு இன்று ஏராளமான கருவிகள் உள்ளன.

RESTful Web Service API இல் முகவரி

REST கட்டமைப்பில் முகவரி என்பது சர்வரில் இருக்கும் ஆதாரங்களைக் கண்டறிவதைக் குறிக்கிறது. வளங்கள் அவற்றின் சீரான வள அடையாளங்காட்டிகளால் (URIகள்) அடையாளம் காணப்படுகின்றன என்பதை நாங்கள் அறிவோம். ஒரு சீரான வள அடையாளங்காட்டியின் வடிவம் பின்வருமாறு:

////

URI ஆனது சர்வரில் ஒரு குறிப்பிட்ட ஆதாரத்தைக் கண்டறியும். எங்கள் மேலே உள்ள எடுத்துக்காட்டில், URI

|_+_|

மேலே உள்ள URIக்கு HTTP GET முறையைப் பயன்படுத்தினோம்.

URI எவ்வாறு உருவாக்கப்படுகிறது என்று நீங்கள் யோசித்துக்கொண்டிருக்கலாம். REST கட்டமைப்பில் உள்ள எந்தவொரு ஆதாரத்திற்கும் URI ஐ உருவாக்குவதற்கான சில நேரடியான விதிகளுடன் நாங்கள் உங்களுக்கு வழிகாட்டுவோம்.

  1. உங்கள் இணைய சேவைகளில் ஆதாரங்களை வரையறுக்கும்போது, ​​எப்போதும் பன்மை வடிவத்தைப் பயன்படுத்தவும். மேலே உள்ள RESTful இணைய பயன்பாட்டு எடுத்துக்காட்டில், 'பயனர்கள்' என்ற ஆதாரத்தை உருவாக்கியுள்ளோம்.
  2. உங்கள் ஆதாரப் பெயரில் %, $, @ போன்ற எந்த இடைவெளியும் அல்லது சிறப்பு சின்னமும் இருக்கக்கூடாது என்பதை உறுதிசெய்ய வேண்டும். ஆதாரப் பெயரில் ஹைபன் (-) அல்லது அடிக்கோடிட்டு (_) பயன்படுத்தலாம். உதாரணமாக, சரியான ஆதாரப் பெயர் எஃபெக்டிவ்_எம்ப்ளாய்ஸ் மற்றும் எஃபெக்டிவ்@எம்ப்ளாய்ஸ் அல்ல.
  3. RESTful இணையச் சேவையில், URIகள் கேஸ்-சென்சிட்டிவ் அல்ல. ஆனால், URI ஐ சிறிய எழுத்தில் வைத்திருப்பது எப்போதும் நல்லது.
  4. ஆதாரங்களில் செயல்பாடுகளைச் செய்வதற்கு HTTP வினைச்சொற்கள் அல்லது முறைகளில் ஏதேனும் ஒன்றைப் பயன்படுத்துகிறீர்கள் என்பதை உறுதிப்படுத்தவும். மேலே உள்ள RESTful பயன்பாட்டில், நாங்கள் HTTP GET முறையைப் பயன்படுத்தினோம்.
  5. இணைய சேவைகள் பொது சேவைகள் என்பதால் URI பொதுவில் வெளியிடப்பட வேண்டும்.

ஒரு பணியாளரைப் பெறுவதற்கான நல்ல மற்றும் மோசமான URI இன் உதாரணத்தைப் பார்ப்போம்.

மோசமான URI

|_+_|

நல்ல URI

|_+_|

ஜாவா(JAX-RS) RESTful Web Service API இல்

ஜாக்ஸ்-ஆர்எஸ் ஜகார்த்தா RESTful இணைய சேவைகளை குறிக்கிறது. முன்னதாக, இது RESTful Web Servicesக்கான Java API என அறியப்பட்டது. JAX-RS என்பது ஜாவா அடிப்படையிலான API ஆகும், இது REST கட்டமைப்பின் அடிப்படையில் இணைய சேவைகளை உருவாக்க பயனர்களுக்கு உதவுகிறது. சமீபத்திய JAX-RS பதிப்பு 2.0 ஆகும், இது 2013 இல் வெளியிடப்பட்டது. இந்த ஜாவா அடிப்படையிலான API ஆனது ஜாவா SE 5 இலிருந்து சிறுகுறிப்புகளைப் பயன்படுத்துகிறது, இது வலை சேவைகளின் மேம்பாடு மற்றும் வரிசைப்படுத்தலை மிகவும் நிர்வகிக்கிறது.

JAX-RS விவரக்குறிப்புகள்

வலை சேவை ஆதாரமாக ஆதாரத்தை வரைபடமாக்குவதற்கு பொதுவாகப் பயன்படுத்தப்படும் சில குறிப்புகள் பின்வருமாறு.

    @பெறு:JAX-RS இன் இந்த விவரக்குறிப்பு வளத்தைப் பெறுவதற்குப் பயன்படுத்தப்படுகிறது.@பாதை:@பாத் என்பது வலைச் சேவையில் சேர்க்கப்பட்டுள்ள வகுப்பு அல்லது முறையின் பாதையைக் குறிக்கிறது.@அழி:@DELETE ஆதாரம் ஒரு குறிப்பிட்ட ஆதாரத்தை நீக்குகிறது.@அஞ்சல்:JAX-RS இல் மேலே உள்ள விவரக்குறிப்பு ஒரு புதிய ஆதாரத்தை உருவாக்குகிறது.@PUT:இந்த JAX-RS விவரக்குறிப்பு ஏற்கனவே உள்ள வளத்தைப் புதுப்பிக்கப் பயன்படுகிறது.@நுகர்வுகள்:@Consumes JAX-RS விவரக்குறிப்பு HTTP கோரிக்கையின் வகையைக் குறிக்கிறது.@HEAD:JAX-RS இல் உள்ள மற்றொரு HTTP முறை @HEAD ஆகும், இது முறை கிடைக்குமா இல்லையா என்பது பற்றிய தகவலை வழங்குகிறது.@QueryParam:வினவல் அளவுருவை இணைக்க மேலே உள்ள விவரக்குறிப்பு பயன்படுத்தப்படுகிறது, மேலும் அளவுரு முறைக்கு அனுப்பப்பட்டது.@தயாரிப்பு:@Produces விவரக்குறிப்பு HTTP பதிலின் வகையைக் காட்டுகிறது.@பாத்பரம்:மேலே உள்ள JAX-RS விவரக்குறிப்பு பாதை மதிப்பை முறைக்கு அனுப்பப்பட்ட அளவுருவுடன் இணைக்கப் பயன்படுகிறது.@CookieParam:@CookieParam ஒரு குக்கீயை முறைக்கு அனுப்பப்பட்ட அளவுருவுடன் இணைக்கிறது.@MatrixParam:இந்த JAX-RS விவரக்குறிப்பு HTTP மேட்ரிக்ஸ் அளவுருவுடன் ஒரு அளவுரு முறைக்கு அனுப்பப்படுகிறது.@FormParam:@FormParam ஐப் பயன்படுத்தி முறைக்கு அனுப்பப்பட்ட அளவுருவுடன் படிவ மதிப்பு இணைக்கப்பட்டுள்ளது.@HeaderParam:@HeaderParam ஐப் பயன்படுத்தி முறைக்கு அனுப்பப்பட்ட அளவுருவுடன் HTTP தலைப்பு பிணைக்கப்பட்டுள்ளது.@சூழல்:@சூழல் என்பது வள சூழலைக் குறிக்கிறது.@இயல்புநிலை மதிப்பு:மேலே உள்ள JAX-RS விவரக்குறிப்பு, இயல்புநிலை மதிப்புடன் முறைக்கு அனுப்பப்பட்ட அளவுருவை ஒதுக்குகிறது.

நிலையற்ற தன்மை மற்றும் RESTful Web Service API ஐ கேச் செய்தல்

நாடற்ற தன்மை

நிலையின்மை என்பது கிளையன்ட் நிலை சர்வரில் இருக்கக்கூடாது என்பதைக் குறிக்கிறது. கிளையன்ட் அதன் சூழலை சேவையகத்திற்கு அனுப்புகிறது. வாடிக்கையாளரிடமிருந்து சூழலைப் பெறும்போது, ​​சேவையகம் சூழலைச் சேமித்து, மேலும் கிளையண்டின் கோரிக்கைகளுக்குப் பயன்படுத்துகிறது. எடுத்துக்காட்டாக, கிளையன்ட் அமர்வு அடையாளங்காட்டியை சேவையகத்திற்கு அனுப்புகிறது. எனவே, அமர்வுகளை அடையாளம் காண சேவையகம் அதை வைத்திருக்கிறது.

நன்மை:

RESTful வலை சேவை API இல் நிலையற்ற தன்மையின் சில குறிப்பிடத்தக்க நன்மைகள் கீழே உள்ளன.

  • நிலையற்ற தன்மையைப் பயன்படுத்தி, இணைய சேவையானது ஒவ்வொரு முறை கோரிக்கையையும் தனித்தனியாக செயலாக்குகிறது.
  • கிளையண்டின் நிலை அல்லது முந்தைய செயல்பாடுகளை சர்வர் வைத்திருக்கவில்லை. எனவே, இது பயன்பாட்டு வடிவமைப்பை மிகவும் எளிதாக்குகிறது.
  • RESTful இணைய சேவைகள் கிட்டத்தட்ட HTTP நெறிமுறைகளில் செயலாக்கப்படுகின்றன.

பாதகம்:

  • சேவையகம் கிளையண்டின் நிலையைக் கொண்டிருக்கவில்லை என்பதால், கிளையண்டின் ஒவ்வொரு கோரிக்கையிலிருந்தும் இணையச் சேவைக்கு கூடுதல் தரவு தேவைப்படுகிறது.

கேச்சிங்

பதிலின் அடிப்படையில், சேவையகத்திலிருந்து கிளையன்ட் சில ஆதாரங்களை வைத்திருக்கிறார். எனவே, வாடிக்கையாளர் ஒரே ஆதாரத்திற்காக சேவையகத்தை மீண்டும் மீண்டும் கோர வேண்டியதில்லை. இது கேச்சிங் எனப்படும். சேவையகத்தால் வழங்கப்படும் ஒரு குறிப்பிட்ட ஆதாரத்தின் கேச்சிங் தகவலின் அடிப்படையில், குறிப்பிட்ட நேரத்திற்கு ஆதாரத்தை தேக்ககப்படுத்த வேண்டுமா அல்லது அதை தேக்ககப்படுத்த வேண்டாமா என்பதை கிளையன்ட் தீர்மானிக்கிறார்.

பொது, தனியார், அதிகபட்ச வயது, கேச்-இல்லை/ஸ்டோர் இல்லை, மற்றும் மறுமதிப்பீடு செய்ய வேண்டிய ஐந்து முக்கிய பகுதிகளைக் கொண்ட கேச்-கட்டுப்பாட்டு தலைப்பு உள்ளது. ஒவ்வொரு பகுதியின் விளக்கத்தையும் கீழே பார்ப்போம்.

    பொது:எந்தவொரு கூறுகளும் பொதுவில் உள்ள வளத்தை தேக்கக முடியும்.தனிப்பட்ட:ஆதாரத்தை தேக்ககப்படுத்த யாருக்கும் அனுமதி இல்லை. கிளையன்ட் மற்றும் சர்வர் மட்டுமே ஆதாரத்தை தேக்கக முடியும்.அதிகபட்ச வயது:அதிகபட்ச வயது உறுப்பு நொடிகளில் கணக்கிடப்படுகிறது. ஆதாரத்தின் கேச்சிங் எவ்வளவு நேரம் செல்லுபடியாகும் என்பதை இது குறிக்கிறது. அதிகபட்ச வயது நேரம் முடிந்ததும், வாடிக்கையாளர் மீண்டும் ஆதாரத்தைக் கோர வேண்டும்.இல்லை-கேச்/நோ-ஸ்டோர்:கிளையன்ட் ஆதாரத்தை தேக்க முடியாது.மறுமதிப்பீடு செய்ய வேண்டும்:தற்காலிக சேமிப்பிற்கான அதிகபட்ச வயது நேரம் முடிந்ததும் சேவையகம் ஆதாரத்தை மறுமதிப்பீடு செய்ய வேண்டும்.

கிளையண்டின் தற்காலிக சேமிப்பை உள்ளமைக்க, சர்வர் பதில் பின்வரும் தலைப்புகளை உள்ளடக்கியது:

    தேதி:ஆதாரத்தை உருவாக்கும் தேதி மற்றும் நேரம் தேதி தலைப்பில் குறிப்பிடப்படுகின்றன.தற்காலிக சேமிப்பு கட்டுப்பாடு:கேச்-கட்டுப்பாட்டு தலைப்பு தேக்ககத்தை கண்காணிக்கிறது.வயது:வயது வினாடிகளில் குறிக்கப்படுகிறது. சேவையகத்திலிருந்து வளம் பெறப்படும் நேரம் இது.கடைசியாக மாற்றப்பட்டது:இந்த தலைப்பு ஆதாரம் கடைசியாக புதுப்பிக்கப்பட்ட தேதி மற்றும் நேரத்தைக் காட்டுகிறது.காலாவதியாகும்:இந்த தலைப்பு தேக்ககத்தின் காலாவதி தேதி மற்றும் நேரத்தைக் குறிக்கிறது.

RESTful API இல் HTTP முறைகள் மற்றும் அவற்றின் செயல்பாடுகள்

முந்தைய பகுதியில், HTTP முறைகள் மற்றும் அவற்றின் பயன்பாடுகளைப் பார்த்தோம். REST கட்டமைப்பில் HTTPS முறைகள், அவற்றின் செயல்பாடுகள் மற்றும் செயல்பாட்டு வகை ஆகியவற்றை இந்தப் பிரிவு கவனிக்க வேண்டும்.

    பெறு:

மேலே உள்ள RESTful பயன்பாட்டு எடுத்துக்காட்டில் உள்ள GET HTTP முறை ஊழியர்களின் பட்டியலைப் பெறுவதற்குப் பயன்படுத்தப்படுகிறது. கீழே உள்ள GET முறைக்கு URI ஐப் பயன்படுத்தினோம்:

|_+_|

HTTP GET முறையானது பணியாளர்களின் பட்டியலைப் பெறுகிறது. எனவே, இது படிக்க-மட்டும் செயல்பாட்டு வகையைக் கொண்டுள்ளது.

ஐடி 1 பணியாளரை மீட்டெடுப்பதற்கும் GET முறையைப் பயன்படுத்தலாம். ஐடி 1 பணியாளரை மீட்டெடுப்பதற்கான URI,

|_+_|

இந்தச் செயல்பாடும் படிக்க-மட்டும் வகையைச் சேர்ந்தது.

    அஞ்சல்:

எங்கள் RESTful பயன்பாட்டு எடுத்துக்காட்டில், ஐடி 2 ஐக் கொண்ட பணியாளரைச் செருகுவதற்கு HTTP POST முறையைப் பயன்படுத்தியுள்ளோம். Id 2 க்கு பணியாளரைச் செருகுவதற்கான URI,

|_+_|

மேலே உள்ள செயல்பாட்டு வகையானது பலவீனமற்றது.

    அழி:

ஐடி 1 உடன் பணியாளரை நீக்குவதற்கு HTTP DELETE முறையைப் பயன்படுத்தலாம். Id 1 உடன் பணியாளரை நீக்குவதற்கான URI கீழே உள்ளது.

|_+_|

DELETE ஆபரேஷன் என்பது ஒரு சக்தியற்ற வகையைச் சேர்ந்தது.

    தலை:

REST கட்டமைப்பில் உள்ள HEAD முறையானது HTTP தலைப்பைத் திரும்பப் பெறப் பயன்படுகிறது. இது HTTP உடலை வழங்காது. எங்கள் மேலே உள்ள ஊழியர் உதாரணத்திற்கு, கீழே உள்ள URI ஐப் பயன்படுத்தலாம்.

|_+_|

இந்த செயல்பாடு படிக்க-மட்டும் வகையாகும்.

    போடு:

மேலே உள்ள REST பணியாளர் பயன்பாட்டில், பணியாளரை ஐடி 2 உடன் புதுப்பிக்க HTTP PUT முறையைப் பயன்படுத்தலாம். ஐடி 2 உடன் பணியாளரைப் புதுப்பிக்க கீழே உள்ள URI ஐப் பயன்படுத்தவும்.

|_+_|
    விருப்பங்கள்:

HTTP OPTIONS முறைகள் இணைய சேவையில் ஆதரிக்கப்படும் அனைத்து செயல்பாடுகளையும் பட்டியலிட உதவுகிறது. இந்த செயல்பாட்டிற்கு நீங்கள் பின்வரும் URI ஐப் பயன்படுத்தலாம்.

|_+_|

OPTIONS செயல்பாடு படிக்க-மட்டும் வகையாகும்.

மேலே உள்ள HTTP முறைகள் மற்றும் அவற்றின் செயல்பாடுகளிலிருந்து, GET செயல்பாடு படிக்க-மட்டும் வகை என்று நாம் முடிவு செய்யலாம். DELETE மற்றும் PUT செயல்பாடுகள் ஒரு செயலற்ற வகையைச் சேர்ந்தவை. இந்த இரண்டு செயல்பாடுகளின் முடிவும் ஒரே மாதிரியாக இருக்கும், அவை பல முறை செய்யப்பட்டாலும்.

முடிவுரை

RESTful API என்பது REST கட்டமைப்பு அடிப்படையிலான API ஆகும், இது தரவை அணுகவும் ஒழுங்கமைக்கவும் HTTP முறைகளைப் பயன்படுத்துகிறது. REST கட்டமைப்பில் உள்ள ஒவ்வொரு தரவும் ஒரு ஆதாரமாகக் கருதப்படுகிறது. நீங்கள் RESTful API ஐக் கற்றுக்கொள்ள விரும்பினால், இந்த இடுகை உங்களுக்கான முழுமையான வழிகாட்டியாகும்.

RESTful web service API என்றால் என்ன, அது எவ்வாறு செயல்படுகிறது, REST கட்டமைப்பில் பயன்படுத்தப்படும் HTTP முறைகள் மற்றும் REST கட்டமைப்பின் பண்புகள் மற்றும் கட்டுப்பாடுகள் ஆகியவற்றைப் பார்த்தோம். பின்னர், RESTful APIக்கான சூழல் அமைப்பை சித்தரித்துள்ளோம். RESTful API சூழல் அமைப்பில், JDK சூழல், Tomcat Apache, Eclipse IDE மற்றும் Jersey Framework ஆகியவற்றை அமைத்துள்ளோம். இந்த டுடோரியலில் எளிமையான RESTful பயன்பாட்டு உதாரணத்தை நீங்கள் அவதானிக்கலாம்.

அடுத்து, RESTful வலை சேவை API இல் செய்திகள், நிலையற்ற தன்மை, தற்காலிக சேமிப்பு, வளங்கள் மற்றும் முகவரியிடல் போன்ற பல கூறுகளை நாங்கள் உள்ளடக்கியுள்ளோம். என்பது குறித்தும் விவாதித்துள்ளோம் ஜாவா JAX-RS மற்றும் அதன் விவரக்குறிப்புகள். கடைசியாக, HTTP முறைகள் மற்றும் URI மற்றும் செயல்பாட்டு வகையுடன் அவற்றின் செயல்பாடுகளைப் பார்த்தோம்.