Custom JSP tags. This taglib lets you work with
Twitter API right from your JSP pages. Taglib uses Twitter4J library,
so you have to download twitter4j-core jar file and save it in your WEB-INF/lib directory.
In order to use tags you have to provide the list of keys for your web application: accessToken,
accessTokenSecret, consumerKey, consumerSecret. You can pass them directly to the tags, or set once for
your JSP page via setAuth tag.
For example:
<%@ taglib uri="taglib.tld" prefix="t" %>
<html>
<t:update accessToken="xxxxx"
accessTokenSecret="yyyyy"
consumerKey="zzzzzz"
consumerSecret="qqqqqqq">
your posting to Twitter
</t:update>
</html>
or
<%@ taglib uri="taglib.tld" prefix="t" %>
<html>
<t:setAuth accessToken="xxxxx"
accessTokenSecret="yyyyy"
consumerKey="zzzzzz"
consumerSecret="qqqqqqq"/>
<t:addFriend who="newFriend"
</t:addFriend>
</html>
Tags are:
update
Body tag posts new message to your Twitter blog. Parameters are:
1) accessToken Optional attribute. Describes your access token
2) accessTokenSecret Optional attribute. Describes your access token secret
3) consumerKey Optional attribute. Describes your consumer key
4) consumerSecret Optional attribute. Describes your consumer secret
5) latitude Optional parameter. Describes a latitude
6) longitude Optional parameter. Describes a longitude
7) id Optional attribute. Describes a name for page scope variable
(type is java.lang.String) that will keep the result of your request. By default tag will simply print the requested data.
Tag prints (saves in the page scope variable) an ID for new status. In case of error it will be -1
newMessage
Body tag lets you send a new direct message to the specified user. Parameters are:
1) accessToken Optional attribute. Describes your access token
2) accessTokenSecret Optional attribute. Describes your access token secret
3) consumerKey Optional attribute. Describes your consumer key
4) consumerSecret Optional attribute. Describes your consumer secret
5) to Describes the screen name for the recipient user
6) id Optional attribute. Describes a name for page scope variable (type is java.lang.String) that will keep
the result of your request. By default tag will simply print the requested data.
Tag prints (saves in the page scope variable) an ID for new message. In case of error it will be -1
deleteMessage
Body tag lets you delete direct message to the specified user. Parameters are:
1) accessToken Optional attribute. Describes your access token
2) accessTokenSecret Optional attribute. Describes your access token secret
3) consumerKey Optional attribute. Describes your consumer key
4) consumerSecret Optional attribute. Describes your consumer secret
5) msgId Describes an id for the message.
messages
Body tag lets you request a list of the direct messages sent to the authenticating user. Parameters are:
1) accessToken Optional attribute. Describes your access token
2) accessTokenSecret Optional attribute. Describes your access token secret
3) consumerKey Optional attribute. Describes your consumer key
4) consumerSecret Optional attribute. Describes your consumer secret
5) sinceId Optional attribute. Lets you request only direct
messages with an ID greater than (that is, more recent than) the specified ID. By default tag
requests 20 most recent messages.
6) id Optional attribute. Describes a name for page scope variable
(type is java.util.Vector) that will keep the result of your request. Array contains elements of
com.cj.twitter.MessageBean type. By default tag will simply print the requested data
mentions
Body tag lets you request a list of the mentions (status containing @username) for the authenticating user. Parameters are:
1) accessToken Optional attribute. Describes your access token
2) accessTokenSecret Optional attribute. Describes your access token secret
3) consumerKey Optional attribute. Describes your consumer key
4) consumerSecret Optional attribute. Describes your consumer secret
5) sinceId Optional attribute. Lets you request only stauses
with an ID greater than (that is, more recent than) the specified ID. By default tag
requests 20 most recent stauses.
6) id Optional attribute. Describes a name for page scope variable (type is java.util.Vector) that will keep
the result of your request. By default tag will simply print the requested data. Array contains elements of
com.cj.twitter.StatusBean type.
7) count Optional attribute. Specifies the number of statuses to retrieve. Default value is 20
addFriend
Body tag lets you add a new friend to the given twitter account. Parameters are:
1) accessToken Optional attribute. Describes your access token
2) accessTokenSecret Optional attribute. Describes your access token secret
3) consumerKey Optional attribute. Describes your consumer key
4) consumerSecret Optional attribute. Describes your consumer secret
5) who Describes the screen name for new friend
6) id Optional attribute. Describes a name for page scope variable (type is java.lang.String) that will keep
the result of your request. By default tag will simply print the requested data.
Tag prints (saves in the page scope variable) an ID for new friend. In case of error it will be -1
setAuth
Body tag lets you set oAuth parameters for the future use on this page. Parameters are:
1) accessToken Describes your access token
2) accessTokenSecret Describes your access token secret
3) consumerKey Describes your consumer key
4) consumerSecret Describes your consumer secret
for downloading:
Library: twittertag.jar Description: taglib.tld
© Coldbeans
Comments?
See also Coldtags suite - the largest collection of custom JSP tags.
|