वसंत-सामाजिक का उपयोग करके फेसबुक, लिंक्डइन और ट्विटर पर स्थिति कैसे अपडेट करें

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





स्थिति अद्यतन को एक उदाहरण के रूप में लिया गया था क्योंकि:

* यह सरल और स्पष्ट है;

* यह फ़ंक्शन लिंक्डइन के लिए स्प्रिंग-सोशल द्वारा समर्थित नहीं है, अर्थात, आप देख सकते हैं कि एपीआई सेवाओं के कार्यान्वयन को कैसे जोड़ा जाए जो डिफ़ॉल्ट रूप से स्प्रिंग-सोशल में लागू नहीं होते हैं।

सिद्धांत रूप में, स्थिति को अद्यतन करने के स्थान पर, कोई अन्य कार्यक्षमता हो सकती है।



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



यह पोस्ट मेरी अंग्रेजी पोस्ट का एक मुफ्त अनुवाद है।

सभी स्रोत svn में उपलब्ध हैं: http://svn.emforge.net/svnroot/akakunin-experiments/update-status

स्रोतों को EmForge वेबसाइट पर भी देखा जा सकता है ।

आधार आवेदन

एक "आधार" के रूप में हम वसंत ढांचे और वसंत-एमवीसी पर सबसे सरल अनुप्रयोग का उपयोग करते हैं। यह एप्लिकेशन मानक सज्जन के सेट का उपयोग करता है:

* बनाने के लिए मावेन;

* स्प्रिंग फ्रेमवर्क 3.0.5;

* वसंत-सुरक्षा 3.0.5;

* जेपीए (हाइबरनेट के माध्यम से);

* आधार के रूप में HSQL।



सिद्धांत रूप में, सब कुछ यथासंभव मानक और सरल है। केवल एक इकाई है - net.emforge.updatestatus.entity.User - जो उपयोगकर्ताओं (उपयोगकर्ता नाम, पासवर्ड) को संग्रहीत करती है। प्रत्येक उपयोगकर्ता के लिए, टोकन भी सहेजे जाते हैं, जिनका उपयोग प्रत्येक सेवाओं के साथ काम करने के लिए किया जाता है।

एक DAO वर्ग UserDao , और UserServiceImpl सेवा है।

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



साथ में, यह सबसे सरल अनुप्रयोग है जहां उपयोगकर्ता पंजीकरण कर सकता है या लॉग इन कर सकता है और स्थिति पृष्ठ पर सेवाओं में से किसी एक के साथ जुड़कर स्थिति को अपडेट कर सकता है।

आवेदन पंजीकरण

काम करने के लिए इस उदाहरण के लिए, आपको पहले अपना आवेदन उन सेवाओं में पंजीकृत करना होगा, जिनका आप उपयोग करने जा रहे हैं:

* फेसबुक पर पंजीकरण http://developers.facebook.com/setup/ पेज पर किया जाता है - कृपया साइटहोस्ट के रूप में केवल लोकलहोस्ट का उपयोग करें: 8080 / अपडेट-स्टेटस / - अन्यथा कॉलबैक काम नहीं करेगा;

* ट्विटर पर रजिस्टर करें: http://dev.twitter.com/apps/new ;

* लिंक्डइन से जुड़ें: https://www.linkedin.com/secure/developer



प्रत्येक मामले में, आपको दो कुंजी प्राप्त होंगी - एप्लिकेशन कुंजी (या एप्लिकेशन आईडी) और सुरक्षा-टोकन - उन्हें src / main / resource / config.properties में सहेजा जाना चाहिए

तेज दौड़ो

यदि आप जल्दी से यह देखना चाहते हैं कि यह कैसे काम करता है और आपके पास जावा और मावेन है (मुझे आशा है कि यह ऐसा है :)) - तो बस svn से स्रोतों को लें और निष्पादित करें (config.properties में अपनी चाबियाँ लिखने के बाद)

mvn tomcat:run







जिसके बाद आवेदन http: // localhost: 8080 / update-status पर उपलब्ध होना चाहिए

एक नया उपयोगकर्ता बनाएं - और जाएं, और हम देखेंगे कि यह कैसे लागू किया जाता है

लिंक्डइन और ट्विटर कनेक्ट

OAuth का उपयोग दोनों सेवाओं के साथ काम करने के लिए किया जाता है और कनेक्शन प्रक्रिया समान है - इसलिए मैं आपको ट्विटर का एक उदाहरण दिखाऊंगा।

सेवा के साथ काम करने के लिए, हम सबसे सरल वर्ग TwitterProvider लिखते हैं, जिसमें मुख्य विधि getOAuthService है:

public OAuthService getOAuthService() {

OAuthConfig config = new OAuthConfig();

config.setRequestTokenEndpoint( "https://api.twitter.com/oauth/request_token" );

config.setAccessTokenEndpoint( "https://api.twitter.com/oauth/access_token" );

config.setAccessTokenVerb(Verb.POST);

config.setRequestTokenVerb(Verb.POST);

config.setApiKey(apiKey);

config.setApiSecret(apiSecret);

config.setCallback(callbackUrl);



return new OAuth10aServiceImpl(

new HMACSha1SignatureService(),

new TimestampServiceImpl(),

new BaseStringExtractorImpl(),

new HeaderExtractorImpl(),

new TokenExtractorImpl(),

new TokenExtractorImpl(),

config);

}



apiKey, apiSecret & callbackUrl को config.properties (जहां हम पहले से लिख रहे हैं) से इंजेक्ट किया जाता है।



कनेक्शन के लिए, लिंक / कनेक्टर / ट्विटर जोड़ें और हैंडलर ( सोशलकंट्रोलर में ) लटकाएं :

@RequestMapping(value = "/connect/twitter" , method = RequestMethod.GET)

public String requestConnectionToTwitter(WebRequest request) {

// get request token

Token requestToken = twitterProvider.getOAuthService().getRequestToken();

// store request token in session

request.setAttribute( "twitter_request_token" , requestToken, WebRequest.SCOPE_SESSION);



return "redirect:" + twitterProvider.getAuthorizeUrl() + "?oauth_token=" + requestToken.getToken();

}



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

/** Callback from twitter on success login

*

* @param verifier

* @param request

* @return

*/

@RequestMapping(value = "/callback/twitter" , method = RequestMethod.GET, params = "oauth_token" )

public String authorizeTwitterCallback(@RequestParam(value = "oauth_verifier" , defaultValue = "verifier" ) String verifier,

WebRequest request) {

// get request token from session

Token requestToken = (Token)request.getAttribute( "twitter_request_token" , WebRequest.SCOPE_SESSION);



// get access token

Token accessToken = twitterProvider.getOAuthService().getAccessToken(requestToken, new Verifier(verifier));

String userName = getCurrentUser().getName();

userService.updateTwitterAuthentication(userName, accessToken.getToken(), accessToken.getSecret());



return "redirect:/status" ;



}



इस हैंडलर में, हम टोकन प्राप्त करते हैं और उन्हें भविष्य में उपयोग के लिए उपयोगकर्ता के लिए संग्रहीत करते हैं।

फेसबुक कनेक्ट

सब कुछ फेसबुक पर थोड़ा पेचीदा है। फेसबुक से कनेक्ट करने के लिए, हम अपने स्टेटस पर "Facebook से कनेक्ट" बटन रखें । निम्न कोड का उपयोग करते हुए पृष्ठ:

< form id ="fb_signin" action ="<c:url value=" / connect / facebook " /> " method="post" >

< div class ="formInfo" >

</ div >

< div id ="fb-root" ></ div >

< p >< fb:login-button perms ="email,publish_stream,offline_access" onlogin ="$('#fb_signin').submit();" v ="2" length ="long" > Connect to Facebook </ fb:login-button ></ p >

</ form >



< facebook:init />



निम्नलिखित बातों पर ध्यान देना महत्वपूर्ण है:

* facebook: init टैग को स्प्रिंग-सोशल लाइब्रेरी में लागू किया गया है और इसे स्प्रिंग संदर्भ में $ {facebookProvider} बिन की आवश्यकता है - हमने इसे FacebookProvider वर्ग में लागू किया है। वास्तव में, टैग इस बीन से केवल चाबियाँ लेता है;

* fb: लॉगिन-बटन फेसबुक से कनेक्ट बटन उत्पन्न करता है;

* फॉर्म-एक्शन / कनेक्ट / फेसबुक का उपयोग सफल लॉगिन के मामले में कॉलबैक के रूप में किया जाएगा।



इसके अलावा, इस कोड को काम करने के लिए, आपको tagLib को कनेक्ट करना होगा

<%@ taglib uri="http://www.springframework.org/spring-social/facebook/tags" prefix="facebook" %>







और jQuery में प्लग - मेरे मामले में, मैंने अभी किया











ठीक है, आपको एक कॉलबैक हैंडलर लिखना होगा, जो / कनेक्ट / फेसबुक पर आता है:

@RequestMapping(value= "/connect/facebook" , method=RequestMethod.POST)

public String connectAccountToFacebook(@FacebookAccessToken String accessToken,

@FacebookUserId String facebookUserId) {

if (facebookUserId != null && accessToken != null ) {

// store facebook information

String userName = getCurrentUser().getName();

userService.updateFacebookAuthentication(userName, accessToken, facebookUserId);

}

return "redirect:/status" ;

}



* This source code was highlighted with Source Code Highlighter .

इस उदाहरण में, हम दो दिलचस्प एनोटेशन देखेंगे: @FacebookAccessToken और @FacebookUserId, वसंत-सामाजिक विशेषताओं में से एक है, लेकिन इसे काम करने के लिए, हमें प्रोजेक्ट में एक विशेष WebArgololver जोड़ने की आवश्यकता है। ऐसा करने के लिए, ApplicationContext.xml में जोड़ें:

< bean id ="facebookWebArgResolver" class ="org.springframework.social.facebook.FacebookWebArgumentResolver" >

< constructor-arg name ="apiKey" value ="${facebook.appId}" />

</ bean >



* This source code was highlighted with Source Code Highlighter .

कॉलबैक प्रसंस्करण Tiwtter & Linkedin के समान है - हम आगे उपयोग के लिए कुंजी (हमारे मामले में facebookUserId और facebookToken) को सहेजते हैं।

ट्विटर और फेसबुक पर शेयर स्थिति

कनेक्टेड, कनेक्टेड, अब आप स्टेटस अपडेट कर सकते हैं। स्थिति पृष्ठ पर, हमारे पास textArea है जहां उपयोगकर्ता पाठ में प्रवेश करता है और एक संदेश भेजता है। फ़ॉर्म हैंडलर इस तरह दिखता है:

@RequestMapping(value = "/status" , method = RequestMethod.POST)

public String sendStatus(@Valid StatusForm statusForm, BindingResult result, ModelMap modelMap) {

User user = getCurrentUser();



LinkedInTemplateExt linkedInTemplate = linkedInProvider.createTemplate(user);

FacebookTemplate facebookTemplate = facebookProvider.createTemplate(user);

TwitterTemplate twitterTemplate = twitterProvider.createTemplate(user);



// send message to LinkedIn

if (linkedInTemplate != null ) {

linkedInTemplate.updateStatus(statusForm.getStatus());

}



// send message to Facebook

if (facebookTemplate != null ) {

facebookTemplate.updateStatus(statusForm.getStatus());

}



// send message to Twitter

if (twitterTemplate != null ) {

twitterTemplate.updateStatus(statusForm.getStatus());

}

return "redirect:/status" ;

}



* This source code was highlighted with Source Code Highlighter .

इस हैंडलर में, हमें वर्तमान उपयोगकर्ता की कुंजियों का उपयोग करके FacebookTemplate और TwitterTemplate (स्प्रिंग-सोशल से दोनों वर्ग) मिलते हैं और उनके अपडेटस्टैट विधि को कॉल करते हैं

लिंक्डइन स्टेटस सबमिशन

लिंक्डइन निकला थोड़ा और जटिल - लिंक्डइनटेम्पलेट, जिसे वसंत-सामाजिक में लागू किया गया है, में स्थिति को अद्यतन करने के लिए एक विधि नहीं है - इसलिए हमें इसे स्वयं लिखना होगा (REST API call api.linkediv.com/v1/people/~/person का उपयोग करके) -सक्रियता )। ऐसा करने के लिए, हम एक वर्ग LinkedInTemplateExt लिखते हैं - "मूल" का उत्तराधिकारी LinkedInTemplate जिसमें:

* हम RestOperations वर्ग की अपनी वस्तु को आरंभीकृत करते हैं - यह "सही" कॉल एन्कोडिंग (एक और वसंत-सामाजिक विशेषता) के लिए विशेष OAuth1RequestSignerFactory.getRequestSigner का उपयोग करता है;

* हम अपडेटस्टैटस विधि को स्वयं लागू करते हैं:

public void updateStatus(String message) {

LinkedInPersonActivity personActivity = new LinkedInPersonActivity(message);



restOperationsExt.postForLocation( "http://api.linkedin.com/v1/people/~/person-activities" , personActivity);

}



* This source code was highlighted with Source Code Highlighter .

हमें लिंक्डइनपर्सनएक्टिविटी क्लास - स्टेटस पास करने के लिए भी लिखना होगा:

@XmlRootElement(name = "activity" )

public class LinkedInPersonActivity {

public LinkedInPersonActivity() {

}

public LinkedInPersonActivity(String body) {

this .body = body;

}



@XmlElement(name = "content-type" )

String contentType = "linkedin-html" ;



@XmlElement(name = "body" )

String body;

}



* This source code was highlighted with Source Code Highlighter .

सब कुछ - विधि तैयार है - जैसा कि आप देख सकते हैं - इस तथ्य के बावजूद कि LinkedInTemplate शुरू में एपीआई से बहुत कम कार्यों का समर्थन करता है, नए कार्यों को जोड़ना इतना मुश्किल काम नहीं है।



मुझे आशा है कि यह उदाहरण उपयोगी है।