Package org.kohsuke.github
Class GHTeam
- java.lang.Object
-
- org.kohsuke.github.GHObject
-
- org.kohsuke.github.GHTeam
-
- All Implemented Interfaces:
Refreshable
public class GHTeam extends GHObject implements Refreshable
A team in GitHub organization.- Author:
- Kohsuke Kawaguchi
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
GHTeam.Privacy
The Enum Privacy.static class
GHTeam.Role
Member's role in a team.
-
Field Summary
-
Fields inherited from class org.kohsuke.github.GHObject
responseHeaderFields
-
-
Constructor Summary
Constructors Constructor Description GHTeam()
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description void
add(GHRepository r)
Add.void
add(GHRepository r, GHOrganization.Permission permission)
void
add(GHRepository r, GHOrganization.RepositoryRole permission)
Add.void
add(GHUser u)
Adds a member to the team.void
add(GHUser user, GHTeam.Role role)
Adds a member to the teamGHDiscussion.Creator
createDiscussion(String title)
Begins the creation of a new instance.void
delete()
Deletes this team.boolean
equals(Object o)
Equals.String
getDescription()
Gets description.GHDiscussion
getDiscussion(long discussionNumber)
Gets a single discussion by ID.URL
getHtmlUrl()
Gets the html url.Set<GHUser>
getMembers()
Gets members.String
getName()
Gets name.GHOrganization
getOrganization()
Gets organization.String
getPermission()
Gets permission.GHTeam.Privacy
getPrivacy()
Gets the privacy state.Map<String,GHRepository>
getRepositories()
Gets repositories.GitHub
getRoot()
Deprecated.For access to theGitHub
instance, use a local copy instead of pulling it out of objects.String
getSlug()
Gets slug.int
hashCode()
Hash code.boolean
hasMember(GHUser user)
Checks if this team has the specified user as a member.PagedIterable<GHTeam>
listChildTeams()
Retrieves the teams that are children of this team.PagedIterable<GHDiscussion>
listDiscussions()
Retrieves the discussions.PagedIterable<GHUser>
listMembers()
Retrieves the current members.PagedIterable<GHUser>
listMembers(String role)
List members with specified role paged iterable.PagedIterable<GHUser>
listMembers(GHTeam.Role role)
List members with specified role paged iterable.PagedIterable<GHRepository>
listRepositories()
List repositories paged iterable.void
refresh()
Refresh.void
remove(GHRepository r)
Remove.void
remove(GHUser u)
Removes a member to the team.void
setDescription(String description)
Sets description.void
setPrivacy(GHTeam.Privacy privacy)
Updates the team's privacy setting.-
Methods inherited from class org.kohsuke.github.GHObject
getCreatedAt, getId, getNodeId, getResponseHeaderFields, getUpdatedAt, getUrl, setResponseHeaderFields, toString
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface org.kohsuke.github.Refreshable
refresh
-
-
-
-
Method Detail
-
getName
public String getName()
Gets name.- Returns:
- the name
-
getPermission
public String getPermission()
Gets permission.- Returns:
- the permission
-
getSlug
public String getSlug()
Gets slug.- Returns:
- the slug
-
getDescription
public String getDescription()
Gets description.- Returns:
- the description
-
getPrivacy
public GHTeam.Privacy getPrivacy()
Gets the privacy state.- Returns:
- the privacy state.
-
setDescription
public void setDescription(String description) throws IOException
Sets description.- Parameters:
description
- the description- Throws:
IOException
- the io exception
-
setPrivacy
public void setPrivacy(GHTeam.Privacy privacy) throws IOException
Updates the team's privacy setting.- Parameters:
privacy
- the privacy- Throws:
IOException
- the io exception
-
listDiscussions
@Nonnull public PagedIterable<GHDiscussion> listDiscussions() throws IOException
Retrieves the discussions.- Returns:
- the paged iterable
- Throws:
IOException
- the io exception
-
listMembers
public PagedIterable<GHUser> listMembers(String role) throws IOException
List members with specified role paged iterable.- Parameters:
role
- the role- Returns:
- the paged iterable
- Throws:
IOException
- the io exception
-
listMembers
public PagedIterable<GHUser> listMembers(GHTeam.Role role) throws IOException
List members with specified role paged iterable.- Parameters:
role
- the role- Returns:
- the paged iterable
- Throws:
IOException
- the io exception
-
getDiscussion
@Nonnull public GHDiscussion getDiscussion(long discussionNumber) throws IOException
Gets a single discussion by ID.- Parameters:
discussionNumber
- id of the discussion that we want to query for- Returns:
- the discussion
- Throws:
IOException
- the io exception- See Also:
- documentation
-
listMembers
public PagedIterable<GHUser> listMembers() throws IOException
Retrieves the current members.- Returns:
- the paged iterable
- Throws:
IOException
- the io exception
-
listChildTeams
public PagedIterable<GHTeam> listChildTeams() throws IOException
Retrieves the teams that are children of this team.- Returns:
- the paged iterable
- Throws:
IOException
- the io exception
-
getMembers
public Set<GHUser> getMembers() throws IOException
Gets members.- Returns:
- the members
- Throws:
IOException
- the io exception
-
hasMember
public boolean hasMember(GHUser user)
Checks if this team has the specified user as a member.- Parameters:
user
- the user- Returns:
- the boolean
-
getRepositories
public Map<String,GHRepository> getRepositories() throws IOException
Gets repositories.- Returns:
- the repositories
- Throws:
IOException
- the io exception
-
listRepositories
public PagedIterable<GHRepository> listRepositories()
List repositories paged iterable.- Returns:
- the paged iterable
-
add
public void add(GHUser u) throws IOException
Adds a member to the team.The user will be invited to the organization if required.
- Parameters:
u
- the u- Throws:
IOException
- the io exception- Since:
- 1.59
-
add
public void add(GHUser user, GHTeam.Role role) throws IOException
Adds a member to the teamThe user will be invited to the organization if required.
- Parameters:
user
- github userrole
- role for the new member- Throws:
IOException
- the io exception
-
remove
public void remove(GHUser u) throws IOException
Removes a member to the team.- Parameters:
u
- the u- Throws:
IOException
- the io exception
-
add
public void add(GHRepository r) throws IOException
Add.- Parameters:
r
- the r- Throws:
IOException
- the io exception
-
add
@Deprecated public void add(GHRepository r, GHOrganization.Permission permission) throws IOException
* Add.- Parameters:
r
- the rpermission
- the permission- Throws:
IOException
- the io exception
-
add
public void add(GHRepository r, GHOrganization.RepositoryRole permission) throws IOException
Add.- Parameters:
r
- the rpermission
- the permission- Throws:
IOException
- the io exception
-
remove
public void remove(GHRepository r) throws IOException
Remove.- Parameters:
r
- the r- Throws:
IOException
- the io exception
-
delete
public void delete() throws IOException
Deletes this team.- Throws:
IOException
- the io exception
-
createDiscussion
public GHDiscussion.Creator createDiscussion(String title) throws IOException
Begins the creation of a new instance. Consumer must callAbstractBuilder.done()
to commit changes.- Parameters:
title
- title of the discussion to be created- Returns:
- a
GHDiscussion.Creator
- Throws:
IOException
- the io exception
-
getOrganization
public GHOrganization getOrganization() throws IOException
Gets organization.- Returns:
- the organization
- Throws:
IOException
- the io exception
-
refresh
public void refresh() throws IOException
Refresh.- Specified by:
refresh
in interfaceRefreshable
- Throws:
IOException
- Signals that an I/O exception has occurred.
-
getHtmlUrl
public URL getHtmlUrl()
Gets the html url.- Specified by:
getHtmlUrl
in classGHObject
- Returns:
- the html url
-
equals
public boolean equals(Object o)
Equals.
-
getRoot
@Deprecated public GitHub getRoot()
Deprecated.For access to theGitHub
instance, use a local copy instead of pulling it out of objects.Get the rootGitHub
instance for this object.- Returns:
- the root
GitHub
instance
-
-