Skip to content

Commit

Permalink
Initial commit
Browse files Browse the repository at this point in the history
  • Loading branch information
@antoinesd
antoinesd committed May 8, 2012
1 parent 7b44108 commit d4ac8de
Show file tree
Hide file tree
Showing 80 changed files with 6,920 additions and 0 deletions.
11 changes: 11 additions & 0 deletions .gitignore
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
target
.classpath
.project
.settings
bin
rebel.xml
*.sw?
*/src/main/java/META-INF
impl/coverage.ec
*.DS_Store
*.iml
196 changes: 196 additions & 0 deletions LICENSE-2.0.html
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,196 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="LICENSE-2.0_fichiers/style.css"
type="text/css">
<meta name="author" content="The Apache Software Foundation">
<meta name="email" content="apache.AT.apache.DOT.org">
<title>Apache License, Version 2.0 - The Apache Software
Foundation</title>
</head>
<body>
<p align="center">
Apache License<br> Version 2.0, January 2004<br> <a
href="http://www.apache.org/licenses/">http://www.apache.org/licenses/</a>
</p>
<p>TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION</p>
<p>
<b><a name="definitions">1. Definitions</a></b>.
</p>
<p>"License" shall mean the terms and conditions for use,
reproduction, and distribution as defined by Sections 1 through 9 of
this document.</p>
<p>"Licensor" shall mean the copyright owner or entity authorized
by the copyright owner that is granting the License.</p>
<p>"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.</p>
<p>"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.</p>
<p>"Source" form shall mean the preferred form for making
modifications, including but not limited to software source code,
documentation source, and configuration files.</p>
<p>"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but not
limited to compiled object code, generated documentation, and
conversions to other media types.</p>
<p>"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work (an
example is provided in the Appendix below).</p>
<p>"Derivative Works" shall mean any work, whether in Source or
Object form, that is based on (or derived from) the Work and for which
the editorial revisions, annotations, elaborations, or other
modifications represent, as a whole, an original work of authorship.
For the purposes of this License, Derivative Works shall not include
works that remain separable from, or merely link (or bind by name) to
the interfaces of, the Work and Derivative Works thereof.</p>
<p>"Contribution" shall mean any work of authorship, including the
original version of the Work and any modifications or additions to
that Work or Derivative Works thereof, that is intentionally submitted
to Licensor for inclusion in the Work by the copyright owner or by an
individual or Legal Entity authorized to submit on behalf of the
copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent to
the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control
systems, and issue tracking systems that are managed by, or on behalf
of, the Licensor for the purpose of discussing and improving the Work,
but excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
</p>
<p>"Contributor" shall mean Licensor and any individual or Legal
Entity on behalf of whom a Contribution has been received by Licensor
and subsequently incorporated within the Work.</p>
<p>
<b><a name="copyright">2. Grant of Copyright License</a></b>. Subject
to the terms and conditions of this License, each Contributor hereby
grants to You a perpetual, worldwide, non-exclusive, no-charge,
royalty-free, irrevocable copyright license to reproduce, prepare
Derivative Works of, publicly display, publicly perform, sublicense,
and distribute the Work and such Derivative Works in Source or Object
form.
</p>
<p>
<b><a name="patent">3. Grant of Patent License</a></b>. Subject to the
terms and conditions of this License, each Contributor hereby grants
to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
irrevocable (except as stated in this section) patent license to make,
have made, use, offer to sell, sell, import, and otherwise transfer
the Work, where such license applies only to those patent claims
licensable by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s) with
the Work to which such Contribution(s) was submitted. If You institute
patent litigation against any entity (including a cross-claim or
counterclaim in a lawsuit) alleging that the Work or a Contribution
incorporated within the Work constitutes direct or contributory patent
infringement, then any patent licenses granted to You under this
License for that Work shall terminate as of the date such litigation
is filed.
</p>
<p>
<b><a name="redistribution">4. Redistribution</a></b>. You may
reproduce and distribute copies of the Work or Derivative Works
thereof in any medium, with or without modifications, and in Source or
Object form, provided that You meet the following conditions:
</p>
<ol type="a">
<li>You must give any other recipients of the Work or Derivative
Works a copy of this License; and <br> <br>
</li>

<li>You must cause any modified files to carry prominent notices
stating that You changed the files; and <br> <br>
</li>

<li>You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work, excluding those
notices that do not pertain to any part of the Derivative Works; and
<br> <br>
</li>

<li>If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained within
such NOTICE file, excluding those notices that do not pertain to any
part of the Derivative Works, in at least one of the following
places: within a NOTICE text file distributed as part of the
Derivative Works; within the Source form or documentation, if
provided along with the Derivative Works; or, within a display
generated by the Derivative Works, if and wherever such third-party
notices normally appear. The contents of the NOTICE file are for
informational purposes only and do not modify the License. You may
add Your own attribution notices within Derivative Works that You
distribute, alongside or as an addendum to the NOTICE text from the
Work, provided that such additional attribution notices cannot be
construed as modifying the License.</li>
</ol>
You may add Your own copyright statement to Your modifications and may
provide additional or different license terms and conditions for use,
reproduction, or distribution of Your modifications, or for any such
Derivative Works as a whole, provided Your use, reproduction, and
distribution of the Work otherwise complies with the conditions stated
in this License.

<p>
<b><a name="contributions">5. Submission of Contributions</a></b>.
Unless You explicitly state otherwise, any Contribution intentionally
submitted for inclusion in the Work by You to the Licensor shall be
under the terms and conditions of this License, without any additional
terms or conditions. Notwithstanding the above, nothing herein shall
supersede or modify the terms of any separate license agreement you
may have executed with Licensor regarding such Contributions.
</p>
<p>
<b><a name="trademarks">6. Trademarks</a></b>. This License does not
grant permission to use the trade names, trademarks, service marks, or
product names of the Licensor, except as required for reasonable and
customary use in describing the origin of the Work and reproducing the
content of the NOTICE file.
</p>
<p>
<b><a name="no-warranty">7. Disclaimer of Warranty</a></b>. Unless
required by applicable law or agreed to in writing, Licensor provides
the Work (and each Contributor provides its Contributions) on an "AS
IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
express or implied, including, without limitation, any warranties or
conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR
A PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
</p>
<p>
<b><a name="no-liability">8. Limitation of Liability</a></b>. In no
event and under no legal theory, whether in tort (including
negligence), contract, or otherwise, unless required by applicable law
(such as deliberate and grossly negligent acts) or agreed to in
writing, shall any Contributor be liable to You for damages, including
any direct, indirect, special, incidental, or consequential damages of
any character arising as a result of this License or out of the use or
inability to use the Work (including but not limited to damages for
loss of goodwill, work stoppage, computer failure or malfunction, or
any and all other commercial damages or losses), even if such
Contributor has been advised of the possibility of such damages.
</p>
<p>
<b><a name="additional">9. Accepting Warranty or Additional
Liability</a></b>. While redistributing the Work or Derivative Works
thereof, You may choose to offer, and charge a fee for, acceptance of
support, warranty, indemnity, or other liability obligations and/or
rights consistent with this License. However, in accepting such
obligations, You may act only on Your own behalf and on Your sole
responsibility, not on behalf of any other Contributor, and only if
You agree to indemnify, defend, and hold each Contributor harmless for
any liability incurred by, or claims asserted against, such
Contributor by reason of your accepting any such warranty or
additional liability.
</p>
<p>END OF TERMS AND CONDITIONS</p>
</body>
</html>
34 changes: 34 additions & 0 deletions agorava-twitter-api/pom.xml
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
<!--
Copyright 2012 Agorava
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<artifactId>agorava-twitter-parent</artifactId>
<groupId>org.agorava</groupId>
<version>1.0.0-SNAPSHOT</version>
</parent>
<artifactId>agorava-twitter-api</artifactId>
<dependencies>
<dependency>
<groupId>org.agorava</groupId>
<artifactId>agorava-core-api</artifactId>
</dependency>
</dependencies>
<build>
<finalName>agorava-twitter-api</finalName>
</build>
</project>
118 changes: 118 additions & 0 deletions agorava-twitter-api/src/main/java/org/agorava/twitter/TwitterBlockService.java
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,118 @@
/*******************************************************************************
* Copyright 2012 Agorava
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
******************************************************************************/

package org.agorava.twitter;

import java.util.List;

import org.agorava.twitter.model.TwitterProfile;

/**
* Interface defining the operations for blocking and unblocking users
*
* @author Craig Walls
* @author Antoine Sabot-Durand
*/
public interface TwitterBlockService {

/**
* Blocks a user. If a friendship exists with the user, it will be destroyed.
*
* @param userId the ID of the user to block.
* @return The {@link TwitterProfile} of the blocked user.
* @throws ApiException if there is an error while communicating with Twitter.
* @throws MissingAuthorizationException if TwitterTemplate was not created with OAuth credentials.
*/
TwitterProfile block(long userId);

/**
* Blocks a user. If a friendship exists with the user, it will be destroyed.
*
* @param screenName the screen name of the user to block.
* @return The {@link TwitterProfile} of the blocked user.
* @throws ApiException if there is an error while communicating with Twitter.
* @throws MissingAuthorizationException if TwitterTemplate was not created with OAuth credentials.
*/
TwitterProfile block(String screenName);

/**
* Unblocks a user.
*
* @param userId the ID of the user to unblock.
* @return The {@link TwitterProfile} of the unblocked user.
* @throws ApiException if there is an error while communicating with Twitter.
* @throws MissingAuthorizationException if TwitterTemplate was not created with OAuth credentials.
*/
TwitterProfile unblock(long userId);

/**
* Unblocks a user.
*
* @param screenName the screen name of the user to unblock.
* @return The {@link TwitterProfile} of the unblocked user.
* @throws ApiException if there is an error while communicating with Twitter.
* @throws MissingAuthorizationException if TwitterTemplate was not created with OAuth credentials.
*/
TwitterProfile unblock(String screenName);

/**
* Retrieves a list of users that the authenticating user has blocked.
*
* @return a list of {@link TwitterProfile}s for the users that are blocked.
* @throws ApiException if there is an error while communicating with Twitter.
* @throws MissingAuthorizationException if TwitterTemplate was not created with OAuth credentials.
*/
List<TwitterProfile> getBlockedUsers();

/**
* Retrieves a list of users that the authenticating user has blocked.
*
* @param page the page of blocked users to return
* @param pageSize the number of users per page
* @return a list of {@link TwitterProfile}s for the users that are blocked.
* @throws ApiException if there is an error while communicating with Twitter.
* @throws MissingAuthorizationException if TwitterTemplate was not created with OAuth credentials.
*/
List<TwitterProfile> getBlockedUsers(int page, int pageSize);

/**
* Retrieves a list of user IDs for the users that the authenticating user has blocked.
*
* @return a list of user IDs for the users that are blocked.
* @throws ApiException if there is an error while communicating with Twitter.
* @throws MissingAuthorizationException if TwitterTemplate was not created with OAuth credentials.
*/
List<Long> getBlockedUserIds();

/**
* Determines if the user has blocked a specific user.
*
* @param userId the ID of the user to check for a block.
* @return true if the user is blocked; false otherwise
* @throws ApiException if there is an error while communicating with Twitter.
*/
boolean isBlocking(long userId);

/**
* Determines if the user has blocked a specific user.
*
* @param screenName the screen name of the user to check for a block.
* @return true if the user is blocked; false otherwise
* @throws ApiException if there is an error while communicating with Twitter.
*/
boolean isBlocking(String screenName);

}
Loading

0 comments on commit d4ac8de

Please sign in to comment.