com.trendmicro.grid.acl.l0
Interface FileService

All Superinterfaces:

PublicFileService, Service

@ProtectedRequestContext
@WebServlet(value="/ws/level-0/internal/files")
public interface FileService
extends PublicFileService

Defines TM reachable services to query file details.

Version:

1.0

Author:

Juergen_Kellerer, 2010-04-26

Method Summary

FileDetails	getFileDetails(FileIdentifier file) Returns the file details for the given file.
Collection<FileDetails>	getFileDetailsList(BatchCollection<FileIdentifier> files) Returns the file details list for the given files.

Methods inherited from interface com.trendmicro.grid.acl.l0.PublicFileService

getFileInformation, getFileInformationList, getFilesTaggedWith, getMatchingFiles, getMatchingFilesInRange, isFileKnown, isFileKnownGood, isFilePureWhite, isFilesKnown, isFilesKnownGood, isFilesPureWhite, isFilesTaggedWith, isFilesTaggedWithAll, isFileTaggedWith, isFileTaggedWithAll

Method Detail

getFileDetails

@RequiredRoles(value={"access.details","access.protected.services","run.hash.queries"})
FileDetails getFileDetails(FileIdentifier file)
                           throws AuthenticationException

Returns the file details for the given file.

Specified by:

getFileDetails in interface PublicFileService

Parameters:

file - The file to return the details for.

Returns:

the file details for the given file or 'null' if the file is unknown.

Throws:

AuthenticationException - In case of this service requires authentication and the current user session is not authenticated or doesn't have the right to access the service.

getFileDetailsList

@ResponseWrapper(className="com.trendmicro.grid.acl.l0.wrappers.GetFileDetailsListResponse")
@RequiredRoles(value={"access.details","access.protected.services","run.hash.queries"})
Collection<FileDetails> getFileDetailsList(BatchCollection<FileIdentifier> files)
                                           throws AuthenticationException

Returns the file details list for the given files.

Specified by:

getFileDetailsList in interface PublicFileService

Parameters:

files - The files to return the details list for.

Returns:

the file details list for the given file. The list may contain 'null' entries if the corresponding file was unknown.

Throws:

AuthenticationException - In case of this service requires authentication and the current user session is not authenticated or doesn't have the right to access the service.