段传涛

文件和文件夹 REST API 引用

转自：https://technet.microsoft.com/zh-cn/subscriptions/index/dn450841.aspx#bk_Overview

适用范围：apps for SharePoint | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

本文内容
关于本文中的请求示例
浏览 SharePoint 2013 文件和文件夹 REST 语法
文件资源
FileCollection 资源
文件版本资源
FileVersionCollection 资源
Folder 资源
FolderCollection 资源
其他资源

关于本文中的请求示例

本文中的请求示例假设您正在使用跨域库 (SP.RequestExecutor.js) 发出跨域请求，因此它们在终结点 URI 中使用 SP.AppContextSite。有关详细信息，请参阅使用跨域库从外接程序访问 SharePoint 2013 数据。

使用请求示例之前，请执行下列操作：

更改 <应用程序 Web URL>、<主机 Web URL> 和其他占位符数据，例如 SharePoint 条目的任何 ID、名称或路径。
如果您未使用跨域库，请包括用于在所有 POST 请求中发送表单摘要值的 X-RequestDigest 标头，以及在请求正文中发送数据的 POST 请求的 content-length 标头。
如果您未发出跨域请求，请从终结点 URI 中删除SP.AppContextSite(@target)和?@target=''。
如果您使用 OAuth，请包括 Authorization 标头 ("Authorization": "Bearer " + ) 以发送 OAuth 访问令牌。
在请求示例中，从 url 和 body 属性值中删除换行符。将换行符添加到示例中，使其更易于读取。
如果您希望服务器以 Atom 格式返回响应，请删除"accept": "application/json; odata=verbose"标头。

请参阅其他资源获取有关使用跨域库、OAuth 和 SharePoint REST 服务的详细信息的链接。请参阅 REST 请求如何因环境而异和 REST 请求中使用的属性获取有关请求格式的信息。

提示
SharePoint Online REST 服务支持使用 OData$batch查询选项，将多个请求组合到对服务的单个调用中。有关详细信息和代码示例链接，请参阅使用 REST API 发出批处理请求。内部部署 SharePoint 尚不支持此选项。

浏览 SharePoint 2013 文件和文件夹 REST 语法

以可视化方式浏览SharePoint 2013 列表和列表项 REST 语法。

浏览其他 SharePoint REST 语法图表：

列表和列表项 | 用户和组

下载所有 SharePoint REST 语法图表的组合 PDF。

文件资源

表示 SharePoint 网站中的文件，该文件可以是 Web 部件页面、文档库中的项目或文件夹中的文件。

终结点 URI | 属性 | 方法 | OData 表示

终结点 URI

http://<网站 URL>/_api/web/getfilebyserverrelativeurl('/<文件夹名称>/<文件名称>')

支持的 HTTP 方法

GET | PUT (媒体资源)

GET | DELETE | POST (文件资源)

请求示例

GET 请求示例：获取文件内容（媒体资源）

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')/$value
    ?@target=''",
  method: "GET",
  binaryStringResponseBody: true,
  success: successHandler,
  error: errorHandler
});

GET 请求示例：获取文件元数据

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    ?@target=''",
  method: "GET",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

PUT 请求实例：更新文件内容（媒体资源）

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.txt')/$value
    ?@target=''",
  method: "POST",
  body: "Updated contents of the file go here",
  headers: { "X-HTTP-Method":"PUT" },
  success: successHandler,
  error: errorHandler
});

首先签出文件以避免其他用户进行更改。然后在进行了更改之后将其签回。请参阅 CheckOut 方法和 CheckIn 方法。

DELETE 请求示例：删除一个文件

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    ?@target=''",
  method: "POST",
  headers: { "X-HTTP-Method":"DELETE" },
  success: successHandler,
  error: errorHandler
});

或者您可以使用 Recycle 方法删除文件并从已回收项中获取 GUID。

注释
请参阅 Add 方法了解介绍如何创建文件并将其添加到文件夹的示例。

文件属性

若要获取一个属性，请向属性终结点发送 GET 请求，如以下示例所示。

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')/
    ?@target=''",
  method: "GET",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

属性	类型	R/W	返回资源	描述
Author	SP.User	R	不可访问	获取一个值，该值指定添加该文件的用户。
CheckedOutByUser	SP.User	R	不可访问	获取一个值，该值返回签出文件的用户。
CheckInComment	String	R	可访问	获取一个值，该值返回在将文档签入文档库时使用的注释。
CheckOutType	Int32	R	可访问	获取一个值，该值指定如何将文件签出文档库。表示 SP.CheckOutType 值：Online = 0；Offline = 1；None = 2。文件的签出状态与文件的锁定状态无关。
ContentTag	String	R	可访问	返回内容的内部版本，用于验证文档在阅读目的方面的等同性。
CustomizedPageStatus	Int32	R	可访问	获取一个值，该值指定文件的自定义状态。表示 SP.CustomizedPageStatus 值：None = 0；Uncustomized = 1；Customized = 2。
ETag	String	R	可访问	获取指定 ETag 值的值。
Exists	Boolean	R	可访问	获取一个值，该值指定文件是否存在。
Length	Int64	R	可访问	获取以字节表示的文件的大小，不包括文件中使用的任何 Web 部件的大小。
Level	Byte	R	可访问	获取一个值，该值指定文件的发布级别。表示 SP.FileLevel 值：Published = 1；Draft = 2；Checkout = 255。
ListItemAllFields	SP.ListItem	R	不可访问	获取一个值，该值指定与此文件对应的列表项的列表项字段值。
LockedByUser	SP.User	R	不可访问	获取一个值，该值返回拥有当前文件锁的用户。
MajorVersion	Int32	R	可访问	获取一个值，该值指定文件的主要版本。
MinorVersion	Int32	R	可访问	获取一个值，该值指定文件的次要版本。
ModifiedBy	SP.User	R	不可访问	获取一个值，该值返回上次修改文件的用户。
Name	String	R	可访问	获取包括扩展名在内的文件名称。
ServerRelativeUrl	String	R	可访问	基于服务器的 URL 获取文件的相对 URL。
TimeCreated	DateTime	R	可访问	获取指定该文件的创建时间的值。
TimeLastModified	DateTime	R	可访问	获取一个值，该值指定文件的上次修改时间。
Title	String	R	可访问	获取一个值，该值指定文件的显示名称。
UiVersion	Int32	R	可访问	获取一个值，该值指定特定于实现的文件版本标识符。
UiVersionLabel	String	R	可访问	获取一个值，该值指定特定于实现的文件版本标识符。
Versions	SP.FileVersionCollection	R	不可访问	获取一个值，该值返回表示文件版本的文件版本对象的集合。

文件方法

Approve
CancelUpload
CheckIn
CheckOut
ContinueUpload
CopyTo
DeleteObject
Deny
FinishUpload
GetLimitedWebPartManager
MoveTo
OpenBinaryStream
Publish
Recycle
SaveBinaryStream
StartUpload
UndoCheckOut
Unpublish

Approve

批准已提交且需要使用指定注释进行内容审批的文件。

仅可对列表中为内容审批启用的文档进行审批。

终结点	/approve(comment)
参数	comment 类型：String 针对审批的注释。
HTTP 方法	POST
响应	无

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    /approve(comment='Check-in comment for the approval.')
    ?@target=''",
  method: "POST",
  success: successHandler,
  error: errorHandler
});

CancelUpload 方法

停止分块上载会话，而不保存上载的数据。如果文件在库中尚不存在，将删除部分上载的文件。可使用此选项来响应用户操作（例如取消上载的请求）或错误或异常。

使用uploadId值，该值已传递到启动上载会话的 StartUpload 方法。

此方法当前仅在 Office 365 上可用。

Endpoint	/cancelupload(uploadId)
Parameters	uploadID 类型：GUID 上载会话的唯一标识符。
HTTP method	POST
Response	无

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    /cancelupload(uploadId=guid'GUID')
    ?@target=''",
  method: "POST",
  success: successHandler,
  error: errorHandler
});

CheckIn 方法

基于签入类型将文件签入文档库。

Endpoint	/checkin(comment, checkInType)
Parameters	comment 类型：String 针对签入的注释。长度必须为 <= 1023。 checkInType 类型：Int32 文件的 SP.CheckinType：MinorCheckIn = 0；MajorCheckIn = 1；OverwriteCheckIn = 2。
HTTP method	POST
Response	无

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    /checkin(comment='Check-in comment.',checkintype=0)
    ?@target=''",
  method: "POST",
  success: successHandler,
  error: errorHandler
});

CheckOut 方法

基于签出类型从文档库签出文件。

Endpoint	/checkout
Parameters	无
HTTP method	POST
Response	无

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    /checkout
    ?@target=''",
  method: "POST",
  success: successHandler,
  error: errorHandler
});

ContinueUpload 方法

使用一个附加片段继续分块上载会话。当前的文件内容不会更改。

使用uploadId值，该值已传递到启动上载会话的 StartUpload 方法。

此方法当前仅在 Office 365 上可用。

Endpoint	/continueupload(uploadId, fileOffset)
Parameters	uploadID 类型：GUID 上载会话的唯一标识符。 fileOffset 类型：Int64 片段开始的文件偏移大小。在 POST 正文中发送文件内容（数据流）。
HTTP method	POST
Response	类型：Int64 上载的总数据大小（以字节为单位）。

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    /continueupload(uploadId=guid'GUID',fileOffset=8388608)
    ?@target=''",
  method: "POST",
  body: stream containing intermediate chunk of file
  success: successHandler,
  error: errorHandler
});

CopyTo 方法

将文件复制到目标 URL。

终结点	/copyto(strNewUrl, bOverWrite)
参数	strNewUrl 类型：String 要复制到的目标文件路径的绝对 URL 或相对于服务器的 URL。 bOverWrite 类型：Boolean true 可覆盖同一位置中具有相同名称的文件；否则为 false。
HTTP method	POST
响应	无

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    /copyto(strnewurl='/foldername/filename.docx',boverwrite=false)
    ?@target=''",
  method: "POST",
  success: successHandler,
  error: errorHandler
});

DeleteObject 方法

删除文件的建议方式是发送 DELETE 请求到 File 资源终结点，如 File 请求示例中所示。

Deny 方法

拒绝审批已提交供内容审批的文件。

仅可对列表中为内容审批启用的文档进行拒绝。

终结点	/deny(comment)
参数	comment 类型：String 针对拒绝的注释。
HTTP method	POST
响应	无

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    /deny(comment='Check-in comment for the denial.')
    ?@target=''",
  method: "POST",
  success: successHandler,
  error: errorHandler
});

FinishUpload 方法

上载最后一个文件片段并提交该文件。此方法完成后，当前文件内容将会更改。

使用uploadId值，该值已传递到启动上载会话的 StartUpload 方法。

此方法当前仅在 Office 365 上可用。

Endpoint	/finishupload(uploadId, fileOffset)
Parameters	uploadID 类型：GUID 上载会话的唯一标识符。 fileOffset 类型：Int64 片段开始的文件偏移大小。在 POST 正文中发送文件内容（数据流）。
HTTP method	POST
Response	类型：SP.File 新上载的文件。

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    /finishupload(uploadId=guid'GUID',fileOffset=125829120)
    ?@target=''",
  method: "POST",
  body: stream containing final chunk of file
  success: successHandler,
  error: errorHandler
});

GetLimitedWebPartManager 方法

指定用于访问、修改或添加与此 Web 部件页和视图关联的 Web 部件的控件集。

如果文件不是 ASPX 页面，则引发一个异常。

终结点	/getlimitedwebpartmanager(scope)
参数	scope 类型：Int32 Web 部件页上的 SP.WebParts.PersonalizationScope 视图。User = 0; Shared = 1。
HTTP method	GET
响应	类型：SP.WebParts.LimitedWebPartManager 用于访问、修改或添加 Web 部件的关联的控件集。

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/fileName.aspx')
    /getlimitedwebpartmanager(scope=0)
    ?@target=''",
  method: "GET",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

MoveTo 方法

将文件移动到指定的目标 URL。

终结点	/moveto(newUrl, flags)
参数	newUrl 类型：String 要移动到的目标文件路径的绝对 URL 或相对于服务器的 URL。 flags 类型：Int32 如何移动文件的按位 SP.MoveOperations 值。Overwrite = 1; AllowBrokenThickets（即使支持文件与文件分离，也会移动）= 8。
HTTP method	POST
响应	无

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    /moveto(newurl='/Other Folder/filename.docx',flags=1)
    ?@target=''",
  method: "POST",
  success: successHandler,
  error: errorHandler
});

OpenBinaryStream 方法

打开作为数据流的文件。

终结点	/openbinarystream
参数	无
HTTP method	GET
响应	类型：Stream 指定的文件数据流。

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    /openbinarystream
    ?@target=''",
  method: "GET",
  binaryStringResponseBody: true,
  success: successHandler,
  error: errorHandler
});

注释
或者您可以使用文件资源中的 $value 打开文件。示例：…/getfilebyserverrelativeurl('/Shared Documents/filename.docx')/$value。

Publish 方法

提交文件以使用指定的注释进行内容审批。

终结点	/publish(comment)
参数	comment 类型：String 针对已发布文件的注释。长度必须为 <= 1023。
HTTP method	POST
响应	无

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    /publish(comment='Check-in comment for the publish operation.')
    ?@target=''",
  method: "POST",
  success: successHandler,
  error: errorHandler
});

Recycle 方法

将文件移到回收站并返回新回收站项目的标识符。

终结点	/recycle
参数	无
HTTP method	POST
响应	类型：GUID 已回收文件的 GUID。

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    /recycle
    ?@target=''",
  method: "POST",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

SaveBinaryStream 方法

终结点	/savebinary
参数	在 POST 正文中发送文件内容（数据流）。
HTTP method	POST
响应	无

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    /savebinarystream
    ?@target=''",
  method: "POST",
  body: "This is the new content.",
  success: successHandler,
  error: errorHandler
});

StartUpload 方法

启动一个新的块上载会话并上载第一个片段。此方法完成时不更改当前文件内容。只要对 uploadId 和 stream 使用相同值，方法就为幂等（因此不会更改结果）。当您使用 CancelUpload 方法时，或者当您通过 ContinueUpload 和 FinishUpload 方法传递其余文件内容成功完成上载会话时，上载会话结束。

例如，您可以将一个 35 MB 的文件分成三个 10 MB 流和一个 5 MB 流并将它们上载（使用生成的偏移值 10、20 和 30 MB）来传递该文件：

startUpload(GUID, stream1)
continueUpload(GUID, 10 MB, stream2)
continueUpload(GUID, 20 MB, stream3)
finishUpload(GUID, 30 MB, stream4)

StartUpload 和 ContinueUpload 方法返回上载的总数据大小（以字节为单位），因此您可以传递这些返回值供 ContinueUpload 和 FinishUpload 后续使用。

此方法当前仅在 Office 365 上可用。

Endpoint	/startupload(uploadId)
Parameters	uploadID 类型：GUID 上载会话的唯一标识符。在 POST 正文中发送文件内容（数据流）。
HTTP method	POST
Response	类型：Int64 上载的数据大小（以字节为单位）。

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    /startupload(uploadId=guid'GUID')
    ?@target=''",
  method: "POST",
  body: stream containing first chunk of file
  success: successHandler,
  error: errorHandler
});

UndoCheckOut 方法

恢复文件的现有签出行为。

终结点	/undocheckout
参数	无
HTTP method	POST
响应	无

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    /undocheckout
    ?@target=''",
  method: "POST",
  success: successHandler,
  error: errorHandler
});

Unpublish 方法

从内容审批中删除文件或取消发布主要版本。

终结点	/unpublish
参数	comment 类型：String 针对取消发布操作的注释。长度必须为 <= 1023。
HTTP method	POST
响应	无

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    /unpublish(comment='Check-in comment for the unpublish operation.')
    ?@target=''",
  method: "POST",
  success: successHandler,
  error: errorHandler
});

OData 表示

以下示例表示 JSON 格式的 File 资源。

{"d":{
  "__metadata":{,
    "id":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared Documents/folderName/fileName.docx')",
    "uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName.docx')",
    "type":"SP.File"
  },
  "Author":{"__deferred":{"uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName.docx')/Author"}},
  "CheckedOutByUser":{"__deferred":{"uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName.docx')/CheckedOutByUser"}},
  "ListItemAllFields":{"__deferred":{"uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName.docx')/ListItemAllFields"}},
  "LockedByUser":{"__deferred":{"uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName.docx')/LockedByUser"}},
  "ModifiedBy":{"__deferred":{"uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName.docx')/ModifiedBy"}},
  "Versions":{"__deferred":{"uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName.docx')/Versions"}},
  "CheckInComment":"Revisions to the file.",
  "CheckOutType":2,
  "ContentTag":"{2FBB0C3C-4059-41A2-A5CF-3E076EA0A94C},2,3",
  "CustomizedPageStatus":0,
  "ETag":"\"{2FBB0C3C-4059-41A2-A5CF-3E076EA0A94C},2\"",
  "Exists":true,
  "Length":"20609",
  "Level":1,
  "MajorVersion":1,
  "MinorVersion":0,
  "Name":"fileName.docx",
  "ServerRelativeUrl":"/Shared Documents/folderName/fileName.docx",
  "TimeCreated":"2013-05-16T21:01:23Z",
  "TimeLastModified":"2013-05-18T04:57:32Z",
  "Title":"",
  "UIVersion":512,
  "UIVersionLabel":"1.0"
}}

FileCollection 资源

表示 File 资源的集合。

终结点 URI | 方法 | OData 表示

终结点 URI

http://<网站 URL>/_api/web/getfolderbyserverrelativeurl('/<文件夹名称>')/files

支持的 HTTP 方法

GET | POST

请求示例

GET 请求示例：获取文件夹中所有文件的元数据

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfolderbyserverrelativeurl('/Shared Documents/Folder A')/files
    ?@target=''",
  method: "GET",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

GET 请求示例：通过文件名称获取文件内容（媒体资源）

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfolderbyserverrelativeurl('/Shared Documents/Folder A')/files('filename.docx')/$value
    ?@target=''",
  method: "GET",
  binaryStringResponseBody: true,
  success: successHandler,
  error: errorHandler
});

GET 请求示例：获取文件元数据

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfolderbyserverrelativeurl('/Shared Documents/Folder A')/files('filename.docx')
    ?@target=''",
  method: "GET",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
};

请参阅 File 请求示例以获取如何使用 GetFileByServerRelativeUrl 终结点检索文件以及如何更新和删除文件的示例。若要创建文件，请参阅 Add 方法。

FileCollection 方法

Add
AddTemplateFile
GetByUrl

Add 方法

终结点	/add(content, overwrite, url)
参数	content 类型：Stream 文件的内容。在请求正文中传递 content 参数。可以使用 REST API 添加的二进制文件最大大小为 2 GB。 overwrite 类型：Boolean true 可覆盖文件（如果文件已存在）；否则为 false。 url 类型：String 文件的相对于文件夹的 URL。
HTTP method	POST
响应	类型：SP.File 新文件。

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfolderbyserverrelativeurl('/Shared Documents/Folder A')/files
    /add(overwrite=true,url='filename.txt')
    ?@target=''",
  method: "POST",
  body: "Contents of the file go here",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

以下示例显示如何使用跨域库上载二进制文件，这需要将文件流转换为字符串。有关 jQuery 示例，请参阅使用 REST API 和 jQuery 上载文件。

JavaScript

function addFile(arrayBuffer) { 
    var executor = new SP.RequestExecutor(appWebUrl);

    // Construct the endpoint.
    // The GetList method is available for SharePoint Online only. 
    var fileCollectionEndpoint = String.format(
         "{0}/_api/sp.appcontextsite(@target)/web/getlist('{1}')/" +
         "rootfolder/files/add(overwrite=true, url='{2}')?@target='{3}'",
         appWebUrl, listName, fileName, hostWebUrl);

    var fileData = '';
    var byteArray = new Uint8Array(arrayBuffer);
    for (var i = 0; i < byteArray.byteLength; i++) {
        fileData += String.fromCharCode(byteArray[i]);
    }

    // Send the request.
    executor.executeAsync({
        url: fileCollectionEndpoint,
        method: "POST",
        body: fileData,
        binaryStringRequestBody: true,
        headers: {"accept":"application/json;odata=verbose"},
        success: function (data) {
            alert('File upload succeeded.');
        },
        error: function (err) {
            alert('Error: ' + err.responseText);
        }
    });
}

AddTemplateFile 方法

向现有列表或文档库中添加幻影文件。

终结点	/addTemplateFile(urlOfFile,templateFileType)
参数	urlOfFile 类型：String 您希望保存文件的相对于服务器的 URL。 templateFileType 类型：Int32 用于创建文件的 SP.TemplateFileType：StandardPage = 0; WikiPage = 1; FormPage = 2。
HTTP method	POST
响应	类型：SP.File 已添加的模板文件。

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfolderbyserverrelativeurl('/Shared Documents')/files
    /addtemplatefile(urloffile='/Shared Documents/newwikipage.aspx',templatefiletype=1)
    ?@target=''",
  method: "POST",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

GetByUrl 方法

获取指定 URL 处的文件。

获取文件的建议方式是通过 GetFileByServerRelativeUrl 终结点。请参阅 SP.File 请求示例。

终结点	/getbyurl('<文件名称或相对于服务器的 URL>')
参数	无
HTTP method	GET
响应	类型：SP.File 指定 URL 的文件。

请求示例

获取文件内容（媒体资源）

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfolderbyserverrelativeurl('/Shared Documents/foldername')/files
    /getbyurl('filename.docx')/$value
    ?@target=''",
  method: "GET",
  binaryStringResponseBody: true,
  success: successHandler,
  error: errorHandler
});

获取文件的元数据（文件资源）

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfolderbyserverrelativeurl('/Shared Documents/foldername')/files
    /getbyurl('filename.docx')
    ?@target=''",
  method: "GET",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

请参阅File 请求示例和FileCollection 请求示例以查看获取文件的其他方式。

OData 表示

以下示例表示 JSON 格式的文件集合资源。

{"d":{
  "results":[{
    "__metadata":{
      "id":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared Documents/folderName/fileName1.docx')",
      "uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName1.docx')",
      "type":"SP.File"
    },
    "Author":{"__deferred":{"uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName1.docx')/Author"}},
    "CheckedOutByUser":{"__deferred":{"uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName1.docx')/CheckedOutByUser"}},
    "ListItemAllFields":{"__deferred":{"uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName1.docx')/ListItemAllFields"}},
    "LockedByUser":{"__deferred":{"uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName1.docx')/LockedByUser"}},
    "ModifiedBy":{"__deferred":{"uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName1.docx')/ModifiedBy"}},
    "Versions":{"__deferred":{"uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName1.docx')/Versions"}},
    "CheckInComment":"",
    "CheckOutType":2,
    "ContentTag":"{2FBB0C3C-4059-41A2-A5CF-3E076EA0A94C},4,7",
    "CustomizedPageStatus":0,
    "ETag":"\"{2FBB0C3C-4059-41A2-A5CF-3E076EA0A94C},4\"",
    "Exists":true,
    "Length":"20609",
    "Level":1,
    "MajorVersion":1,
    "MinorVersion":0,
    "Name":"fileName1.docx",
    "ServerRelativeUrl":"/Shared Documents/folderName/fileName1.docx",
    "TimeCreated":"2013-05-16T21:01:23Z",
    "TimeLastModified":"2013-06-09T02:38:14Z",
    "Title":"Title of fileName1",
    "UIVersion":512,
    "UIVersionLabel":"1.0"
    },{
    "__metadata":{
      "id":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared Documents/folderName/fileName2.docx')",
      "uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName2.docx')",
      "type":"SP.File"
    },
    "Author":{"__deferred":{"uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName2.docx')/Author"}},
    "CheckedOutByUser":{"__deferred":{"uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName2.docx')/CheckedOutByUser"}},
    "ListItemAllFields":{"__deferred":{"uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName2.docx')/ListItemAllFields"}},
    "LockedByUser":{"__deferred":{"uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName2.docx')/LockedByUser"}},
    "ModifiedBy":{"__deferred":{"uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName2.docx')/ModifiedBy"}},
    "Versions":{"__deferred":{"uri":"http:///_api/Web/GetFileByServerRelativeUrl('/Shared%20Documents/folderName/fileName2.docx')/Versions"}},
    "CheckInComment":"",
    "CheckOutType":2,
    "ContentTag":"{E654B970-C4BF-4DC5-9719-B5B01CAD6FD9},4,9",
    "CustomizedPageStatus":0,
    "ETag":"\"{E654B970-C4BF-4DC5-9719-B5B01CAD6FD9},4\"",
    "Exists":true,
    "Length":"12263",
    "Level":1,
    "MajorVersion":1,
    "MinorVersion":0,
    "Name":"fileName2.docx",
    "ServerRelativeUrl":"/Shared Documents/folderName/fileName2.docx",
    "TimeCreated":"2013-05-18T05:01:51Z",
    "TimeLastModified":"2013-06-09T02:38:59Z",
    "Title":"Title of fileName2",
    "UIVersion":512,
    "UIVersionLabel":"1.0"
  }]}}

文件版本资源

表示 File 资源的版本。

终结点 URI | 属性 | 方法 | OData 表示

终结点 URI

http://<网站 URL>/_api/web/getfilebyserverrelativeurl('/<文件夹名称>/<文件名称>')/versions(<版本 ID>)

支持的 HTTP 方法

GET | POST | DELETE

请求示例

GET 请求示例：获取文件版本的元数据

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')/versions(512)
    ?@target=''",
  method: "GET",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

DELETE 请求示例：删除文件的特定版本

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')/versions(513)
    ?@target=''",
  method: "POST",
  headers: { "X-HTTP-Method":"DELETE" },
  success: successHandler,
  error: errorHandler
});

FileVersion 属性

若要获取一个属性，请向属性终结点发送 GET 请求，如以下示例所示。

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')
    /versions(512)/
    ?@target=''",
  method: "GET",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

属性	类型	R/W	返回资源	描述
CheckInComment	String	R	可访问	获取一个值，该值指定签入注释。
Created	DateTime	R	可访问	获取一个值，该值指定文件版本的创建日期和时间。
CreatedBy	SP.User	R	不可访问	获取一个值，该值指定表示文件版本的创建者的用户。
ID	Int32	R	可访问	获取文件版本的内部标识符。
IsCurrentVersion	Boolean	R	可访问	获取一个值，该值指定文件版本是否是当前版本。
Size	Int32	R	可访问
Url	String	R	可访问	获取一个值，该值指定文件版本的相对 URL，以网站或子网站的 URL 为基础。
VersionLabel	String	R	可访问	获取一个值，该值指定特定于实现的文件标识符。使用 majorVersionNumber.minorVersionNumber 格式，例如：1.2。

FileVersion 方法

DeleteObject

DeleteObject 方法

删除文件版本的建议方式是发送 DELETE 请求到 FileVersion 资源终结点，如 FileVersion 请求示例中所示。

OData 表示

以下示例表示 JSON 格式的 FileVersion 资源。

{"d":{
  "__metadata":{,
    "id":"http:///_api/web/getfilebyserverrelativeurl('/Shared Documents/folderName/fileName1.docx')/versions(512)",
    "uri":"http:///_api/web/getfilebyserverrelativeurl('/Shared%20Documents/folderName/fileName1.docx')/versions(512)",
    "type":"SP.FileVersion"
  },
  "CreatedBy":{"__deferred":{"uri":"http:///_api/web/getfilebyserverrelativeurl('/Shared%20Documents/folderName/fileName1.docx')/versions(512)/CreatedBy"}},
  "CheckInComment":"Revisions to the file.",
  "Created":"2013-06-10T04:02:53Z",
  "ID":512,
  "IsCurrentVersion":true,
  "Size":20609,
  "Url":"_vti_history/512/Shared Documents/folderName/fileName1.docx",
  "VersionLabel":"1.0"
}}

FileVersionCollection 资源

表示 FileVersion 资源的集合。

终结点 URI | 方法 | OData 表示

终结点 URI

http://<网站 URL>/_api/web/getfilebyserverrelativeurl('/<文件夹名称>/<文件名称>')/versions

HTTP 方法

此资源支持以下 HTTP 方法：

GET | POST

请求示例

GET 请求示例：获取文件所有版本的元数据

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')/versions
    ?@target=''",
  method: "GET",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

GET 请求示例：获取文件版本的元数据

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')/versions(512)
    ?@target=''",
  method: "GET",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

FileVersionCollection 方法

DeleteAll
DeleteById
DeleteByLabel
GetById
RestoreByLabel

DeleteAll 方法

删除集合中的所有文件版本对象。

终结点	/deleteall
参数	无
HTTP method	POST
响应	无

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')/versions
    /deleteall
    ?@target=''",
  method: "POST",
  success: successHandler,
  error: errorHandler
});

DeleteById 方法

删除文件的指定版本。

终结点	/deletebyid(vid)
参数	vid 类型：Int32 要删除的文件版本 ID。
HTTP method	POST
响应	无

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')/versions
    /deletebyid(vid=3)
    ?@target=''",
  method: "POST",
  success: successHandler,
  error: errorHandler
});

DeleteByLabel 方法

删除具有指定版本标签的文件版本对象。

终结点	/deletebylabel(versionlabel)
参数	versionlabel 类型：String 要删除的文件版本的 SP.FileVersion.VersionLabel 属性。
HTTP method	POST
响应	无

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')/versions
    /deletebylabel(versionlabel='1.2')
    ?@target=''",
  method: "POST",
  success: successHandler,
  error: errorHandler
});

GetById 方法

终结点	/getbyid(versionid)
参数	versionid 类型：Int32 要获取的文件版本 ID。
HTTP method	GET
响应	类型：SP.FileVersion 指定的文件版本。

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')/versions
    /getbyid(512)
    ?@target=''",
  method: "GET",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

或者您可以直接将版本 ID 传递到集合 (…/versions(512))。请参阅FileVersionCollection 请求示例。

RestoreByLabel 方法

从版本标签指定的文件创建新文件版本。

终结点	/restorebylabel(versionlabel)
参数	versionlabel 类型：String 要恢复的文件版本的 SP.FileVersion.VersionLabel 属性。
HTTP method	POST
响应	无

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfilebyserverrelativeurl('/Shared Documents/filename.docx')/versions
    /restorebylabel(versionlabel='1.2')
    ?@target=''",
  method: "POST",
  success: successHandler,
  error: errorHandler
});

OData 表示

以下示例表示 JSON 格式的 FileVersionCollection 资源。

{"d":{
  "results":[{
    "__metadata":{
      "id":"http:///_api/SP.FileVersiona6a6bb00-2b96-41e6-a901-46df015183b9",
      "uri":"http:///_api/SP.FileVersiona6a6bb00-2b96-41e6-a901-46df015183b9",
      "type":"SP.FileVersion"
    },
    "CreatedBy":{"__deferred":{"uri":"http:///_api/SP.FileVersiona6a6bb00-2b96-41e6-a901-46df015183b9/CreatedBy"}},
    "CheckInComment":"",
    "Created":"2013-06-10T04:02:53Z",
    "ID":512,
    "IsCurrentVersion":true,
    "Size":20609,
    "Url":"_vti_history/512/Shared Documents/folderName/fileName1.docx",
    "VersionLabel":"1.0"
    },{
    "__metadata":{
      "id":"http:///_api/SP.FileVersion6accd876-7579-47b6-9779-19a24f6ab8a1",
      "uri":"http:///_api/SP.FileVersion6accd876-7579-47b6-9779-19a24f6ab8a1",
      "type":"SP.FileVersion"
    },
    "CreatedBy":{"__deferred":{"uri":"http:///_api/SP.FileVersion6accd876-7579-47b6-9779-19a24f6ab8a1/CreatedBy"}},
    "CheckInComment":"Revisions to the file.",
    "Created":"2013-06-11T17:42:41Z",
    "ID":513,
    "IsCurrentVersion":false,
    "Size":17973,
    "Url":"_vti_history/513/Shared Documents/folderName/fileName1.docx",
    "VersionLabel":"1.1"
  }]}}

Folder 资源

表示 SharePoint 网站上的文件夹。

终结点 URI | 属性 | 方法 | OData 表示

终结点 URI

http://<网站 URL>/_api/web/getfolderbyserverrelativeurl('/<文件夹名称>')

支持的 HTTP 方法

GET | POST | DELETE | MERGE | PUT

请求示例

GET 请求示例：获取一个文件夹

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfolderbyserverrelativeurl('/Shared Documents/Folder A')
    ?@target=''",
  method: "GET",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

MERGE 请求示例：更改一个文件夹

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfolderbyserverrelativeurl('/Shared Documents/Folder A')
    ?@target=''",
  method: "POST",
  body: "{ '__metadata':{ 'type': 'SP.Folder' }, 'WelcomePage':'Folder B/WelcomePage.aspx' }",
  headers: {
    "content-type": "application/json; odata=verbose",
    "X-HTTP-Method": "MERGE"
  },
  success: successHandler,
  error: errorHandler
});

DELETE 请求示例：删除一个文件夹

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfolderbyserverrelativeurl('/Shared Documents/Folder A')
    ?@target=''",
  method: "POST",
  headers: { "X-HTTP-Method":"DELETE" },
  success: successHandler,
  error: errorHandler
});

请参阅 FolderCollection 请求示例以获取如何创建文件夹的示例。

Folder 属性

若要获取一个属性，请向属性终结点发送 GET 请求，如以下示例所示。

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfolderbyserverrelativeurl('/Shared Documents/Folder A')/
    ?@target=''",
  method: "GET",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

若要设置一个可写属性、获取资源、在正文中设置属性值，然后使用资源上的 MERGE 方法合并更改，或使用 PUT 方法替换资源。请参阅 Folder 请求示例以获取示例。

属性	类型	R/W	返回资源	描述
ContentTypeOrder	Collection(SP.ContentTypeId)	R	可访问	指定内容类型的显示顺序。
Files	SP.FileCollection	R	不可访问	获取列表文件夹中包含的所有文件的集合。您可以使用文件夹的 FileCollection 资源中的 Add 方法将一个文件添加到文件夹。
Folders	SP.FolderCollection	R	不可访问	获取列表文件夹中包含的列表文件夹的集合。
ItemCount	Int32	R	可访问	获取一个值，该值指定列表文件夹中的项计数。
ListItemAllFields	SP.ListItem	R	不可访问	指定与此文件对应的列表项的列表项字段 (2) 值。
Name	String	R	可访问	获取文件夹的名称。
ParentFolder	SP.Folder	R	不可访问	获取该文件夹的父列表文件夹。
Properties	SP.PropertyValues	R	不可访问	获取文件夹中包含的所有文件的集合。
ServerRelativeUrl	String	R	可访问	获取列表文件夹相对于服务器的 URL。
UniqueContentTypeOrder	Collection(SP.ContentTypeId)	RW	可访问	获取或设置一个值，该值指定内容类型顺序。
WelcomePage	String	RW	可访问	获取或设置一个值，该值指定列表文件夹欢迎页面相对于文件夹的 URL。

Folder 方法

DeleteObject
Recycle

DeleteObject 方法

删除文件夹的建议方式是发送 DELETE 请求到 Folder 资源终结点，如 Folder 请求示例中所示。

Recycle 方法

将列表文件夹移到回收站并返回新回收站项目的标识符。

终结点	/recycle
HTTP method	POST
参数	无
响应	类型：GUID 回收操作的 ID。

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfolderbyserverrelativeurl('/Shared Documents/Folder A')
    /recycle
    ?@target=''",
  method: "POST",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

OData 表示

以下示例表示 JSON 格式的 Folder 资源。

{"d":{
  "__metadata":{,
    "id":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared Documents/Folder A')",
    "uri":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared%20Documents/Folder%20A')",
    "type":"SP.Folder"
  },
  "Files":{"__deferred":{"uri":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared%20Documents/Folder%20A')/Files"}},
  "ListItemAllFields":{"__deferred":{"uri":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared%20Documents/Folder%20A')/ListItemAllFields"}},
  "ParentFolder":{"__deferred":{"uri":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared%20Documents/Folder%20A')/ParentFolder"}},
  "Properties":{"__deferred":{"uri":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared%20Documents/Folder%20A')/Properties"}},
  "Folders":{"__deferred":{"uri":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared%20Documents/Folder%20A')/Folders"}},
  "ItemCount":7,
  "Name":"Folder A",
  "ServerRelativeUrl":"/Shared Documents/Folder A",
  "WelcomePage":""
}}

FolderCollection 资源

表示 Folder 资源的集合。

终结点 URI | 方法 | OData 表示

终结点 URI

http://<网站 URL>/_api/web/folders (根网站的顶级文件夹)
http://<网站 URL>/_api/web/getfolderbyserverrelativeurl('/<文件夹名称>')/folders

支持的 HTTP 方法

GET | POST

请求示例

GET 请求示例：获取根网站的文件夹

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web/folders
    ?@target=''",
  method: "GET",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

GET 请求示例：获取文档库中的文件夹

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfolderbyserverrelativeurl('/Shared Documents')/folders
    ?@target=''",
  method: "GET",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

GET 请求示例：通过名称获取文件夹

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfolderbyserverrelativeurl('/Shared Documents/Folder A')/folders('Folder B')
    ?@target=''",
  method: "GET",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

POST 请求示例：创建一个文件夹（或者您可以使用 Add 方法）

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web
    /getfolderbyserverrelativeurl('/Shared Documents/Folder A')/folders
    ?@target=''",
  method: "POST",
  body: "{ '__metadata':{ 'type': 'SP.Folder' }, 'ServerRelativeUrl':'Folder B' }",
  headers: {
    "accept": "application/json; odata=verbose",
    "content-type": "application/json; odata=verbose"
  },
  success: successHandler,
  error: errorHandler
});

请参阅Folder 请求示例以获取如何更新和删除文件夹的示例。

FolderCollection 方法

Add
GetByUrl

Add 方法

向集合中添加位于指定 URL 处的文件夹。

终结点	/add(url)
参数	url 类型：String 您希望添加文件夹（包括新文件夹的名称）的路径，如完全限定的 URL、相对于服务器的 URL 或相对于网站的 URL。
HTTP method	POST
响应	类型：SP.Folder 新添加的文件夹。

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web/folders
    /add('/Shared Documents/Folder A/Folder B')
    ?@target=''",
  method: "POST",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

GetByUrl 方法

终结点	/getbyurl('<相对于服务器的文件夹 URL>')
参数	类型：String 文件夹的相对于服务器的 URL。
HTTP method	GET
响应	类型：SP.Folder 指定的文件夹。

请求示例

JavaScript

executor.executeAsync({
  url: "/_api/SP.AppContextSite(@target)/web/folders
    /getbyurl('Folder B')
    ?@target=''",
  method: "GET",
  headers: { "accept": "application/json; odata=verbose" },
  success: successHandler,
  error: errorHandler
});

您还可以直接将文件夹名称传递到文件夹集合。示例：…/folders('Folder B')。请参阅 FolderCollection 请求示例。

OData 表示

以下示例表示 JSON 格式的 FolderCollection 资源。

{"d":{
  "results":[{
    "__metadata":{
      "id":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared Documents/Forms')",
      "uri":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared%20Documents/Forms')",
      "type":"SP.Folder"
    },
    "Files":{"__deferred":{"uri":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared%20Documents/Forms')/Files"}},
    "ListItemAllFields":{"__deferred":{"uri":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared%20Documents/Forms')/ListItemAllFields"}},
    "ParentFolder":{"__deferred":{"uri":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared%20Documents/Forms')/ParentFolder"}},
    "Properties":{"__deferred":{"uri":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared%20Documents/Forms')/Properties"}},
    "Folders":{"__deferred":{"uri":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared%20Documents/Forms')/Folders"}},
    "ItemCount":0,
    "Name":"Forms",
    "ServerRelativeUrl":"/Shared Documents/Forms",
    "WelcomePage":""
    },{
    "__metadata":{
      "id":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared Documents/folderName')",
      "uri":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared%20Documents/folderName')",
      "type":"SP.Folder"
    },
    "Files":{"__deferred":{"uri":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared%20Documents/folderName')/Files"}},
    "ListItemAllFields":{"__deferred":{"uri":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared%20Documents/folderName')/ListItemAllFields"}},
    "ParentFolder":{"__deferred":{"uri":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared%20Documents/folderName')/ParentFolder"}},
    "Properties":{"__deferred":{"uri":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared%20Documents/folderName')/Properties"}},
    "Folders":{"__deferred":{"uri":"http:///_api/Web/GetFolderByServerRelativeUrl('/Shared%20Documents/folderName')/Folders"}},
    "ItemCount":4,
    "Name":"folderName",
    "ServerRelativeUrl":"/Shared Documents/folderName",
    "WelcomePage":""
  }]}}

你可能感兴趣的:(文件和文件夹 REST API 引用)

情绪觉察日记第37天露露_e800
今天是家庭关系规划师的第二阶最后一天，慧萍老师帮我做了个案，帮我处理了埋在心底好多年的一份恐惧，并给了我深深的力量！这几天出来学习，爸妈过来婆家帮我带小孩，妈妈出于爱帮我收拾东西，并跟我先生和婆婆产生矛盾，妈妈觉得他们没有照顾好我…。今晚回家见到妈妈，我很欣赏她并赞扬她，妈妈说今晚要跟我睡我说好，当我们俩躺在床上准备睡觉的时候，我握着妈妈的手对她说:妈妈这几天辛苦你了，你看你多利害把我们的家收拾得
芦花鞋一四许叶晗
又是在一个寒冷的夏日里，青铜和葵花决定今天一起去卖芦花鞋，奶奶亲手给他们做了一碗热乎乎的粥对他们说:“就靠你们两挣生活费了这碗粥赶紧趁热喝了吧！”于是青铜和葵花喝完了奶奶给她们做的粥，就准备去镇上卖卢花鞋，这回青铜和葵花穿着新的芦花鞋来到了镇上。青铜这回看到了很多人都在卖，用手势表达对葵花说:“这回有好多人在抢我们生意呢！我们必须得吆喝起来。”葵花点了点头。可是谁知他们也大声的叫，卖芦花喽！卖芦花
关于沟通这件事，项目经理不需要每次都面对面进行流程大师兄
很多项目经理都会遇到这样的问题，项目中由于事情太多，根本没有足够的时间去召开会议，那在这种情况下如何去有效地管理项目中的利益相关者？当然，不建议电子邮件也不需要开会的话，建议可以采取下面几种方式来形成有效的沟通，这几种方式可以帮助你努力的通过各种办法来保持和各方面的联系。项目经理首先要问自己几个问题，项目中哪些利益相关者是必须要进行沟通的？可以列出项目中所有的利益相关者清单，同时也整理出项目中哪些
机器学习与深度学习间关系与区别 ℒℴѵℯ心·动ꦿ໊ོ꫞ 人工智能学习深度学习 python
一、机器学习概述定义机器学习（MachineLearning,ML）是一种通过数据驱动的方法，利用统计学和计算算法来训练模型，使计算机能够从数据中学习并自动进行预测或决策。机器学习通过分析大量数据样本，识别其中的模式和规律，从而对新的数据进行判断。其核心在于通过训练过程，让模型不断优化和提升其预测准确性。主要类型1.监督学习（SupervisedLearning）监督学习是指在训练数据集中包含输入
【iOS】MVC设计模式 Magnetic_h ios mvc 设计模式 objective-c 学习 ui
MVC前言如何设计一个程序的结构，这是一门专门的学问，叫做"架构模式"（architecturalpattern），属于编程的方法论。MVC模式就是架构模式的一种。它是Apple官方推荐的App开发架构，也是一般开发者最先遇到、最经典的架构。MVC各层controller层Controller/ViewController/VC（控制器）负责协调Model和View，处理大部分逻辑它将数据从Mod
一百九十四章. 自相矛盾巨木擎天
唉！就这么一夜，林子感觉就像过了很多天似的，先是回了阳间家里，遇到了那么多不可思议的事情儿。特别是小伙伴们，第二次与自己见面时，僵硬的表情和恐怖的气氛，让自己如坐针毡，打从心眼里难受！还有东子，他现在还好吗？有没有被人欺负？护城河里的小鱼小虾们，还都在吗？水不会真的干枯了吧？那对相亲相爱漂亮的太平鸟儿，还好吧！春天了，到了做窝、下蛋、喂养小鸟宝宝的时候了，希望它们都能够平安啊！虽然没有看见家人，也
UI学习——cell的复用和自定义cell Magnetic_h ui 学习
目录cell的复用手动（非注册）自动（注册）自定义cellcell的复用在iOS开发中，单元格复用是一种提高表格（UITableView）和集合视图（UICollectionView）滚动性能的技术。当一个UITableViewCell或UICollectionViewCell首次需要显示时，如果没有可复用的单元格，则视图会创建一个新的单元格。一旦这个单元格滚动出屏幕，它就不会被销毁。相反，它被添
element实现动态路由+面包屑软件技术NINI vue案例 vue.js 前端
el-breadcrumb是ElementUI组件库中的一个面包屑导航组件，它用于显示当前页面的路径，帮助用户快速理解和导航到应用的各个部分。在Vue.js项目中，如果你已经安装了ElementUI，就可以很方便地使用el-breadcrumb组件。以下是一个基本的使用示例：安装ElementUI（如果你还没有安装的话）:你可以通过npm或yarn来安装ElementUI。bash复制代码npmi
地推话术，如何应对地推过程中家长的拒绝校师学
相信校长们在做地推的时候经常遇到这种情况：市场专员反馈家长不接单，咨询师反馈难以邀约这些家长上门，校区地推疲软，招生难。为什么？仅从地推层面分析，一方面因为家长受到的信息轰炸越来越多，对信息越来越“免疫”；而另一方面地推人员的专业能力和营销话术没有提高，无法应对家长的拒绝，对有意向的家长也不知如何跟进，眼睁睁看着家长走远；对于家长的疑问，更不知道如何有技巧地回答，机会白白流失。由于回答没技巧和专业
谢谢你们，爱你们！鹿游儿
昨天家人去泡温泉，二个孩子也带着去，出发前一晚，匆匆下班，赶回家和孩子一起收拾。饭后，我拿出笔和本子（上次去澳门时做手帐的本子）写下了1\2\3\4\5\6\7\8\9,让后让小壹去思考，带什么出发去旅游呢？她在对应的数字旁边画上了，泳衣、泳圈、肖恩、内衣内裤、tapuy、拖鞋……画完后，就让她自己对着这个本子，将要带的，一一带上，没想到这次带的书还是这本《便便工厂》(晚上姑婆发照片过来，妹妹累得
C语言如何定义宏函数？小九格物 c语言
在C语言中，宏函数是通过预处理器定义的，它在编译之前替换代码中的宏调用。宏函数可以模拟函数的行为，但它们不是真正的函数，因为它们在编译时不会进行类型检查，也不会分配存储空间。宏函数的定义通常使用#define指令，后面跟着宏的名称和参数列表，以及宏展开后的代码。宏函数的定义方式：1.基本宏函数：这是最简单的宏函数形式，它直接定义一个表达式。#defineSQUARE(x)((x)*(x))2.带参
微服务下功能权限与数据权限的设计与实现 nbsaas-boot 微服务 java 架构
在微服务架构下，系统的功能权限和数据权限控制显得尤为重要。随着系统规模的扩大和微服务数量的增加，如何保证不同用户和服务之间的访问权限准确、细粒度地控制，成为设计安全策略的关键。本文将讨论如何在微服务体系中设计和实现功能权限与数据权限控制。1.功能权限与数据权限的定义功能权限：指用户或系统角色对特定功能的访问权限。通常是某个用户角色能否执行某个操作，比如查看订单、创建订单、修改用户资料等。数据权限：
理解Gunicorn：Python WSGI服务器的基石范范0825 ipython linux 运维
理解Gunicorn：PythonWSGI服务器的基石介绍Gunicorn，全称GreenUnicorn，是一个为PythonWSGI（WebServerGatewayInterface）应用设计的高效、轻量级HTTP服务器。作为PythonWeb应用部署的常用工具，Gunicorn以其高性能和易用性著称。本文将介绍Gunicorn的基本概念、安装和配置，帮助初学者快速上手。1.什么是Gunico
2021年12月19日，春蕾教育集团团建活动感受——黄晓丹黄错错加油
感受:1.从陌生到熟悉的过程。游戏环节让我们在轻松的氛围中得到了锻炼，也增长了不少知识。2.游戏过程中，我们贡献的是个人力量，展现的是团队的力量。它磨合的往往不止是工作的熟悉，更是观念上契合度的贴近。3.这和工作是一样的道理。在各自的岗位上，每个人摆正自己的位置、各司其职充分发挥才能，并团结一致劲往一处使，才能实现最大的成功。新知:1.团队精神需要不断地创新。过去，人们把创新看作是冒风险，现在人们
Cell Insight | 单细胞测序技术又一新发现，可用于HIV-1和Mtb共感染个体诊断尐尐呅
结核病是艾滋病合并其他疾病中导致患者死亡的主要原因。其中结核病由结核分枝杆菌（Mycobacteriumtuberculosis,Mtb）感染引起，获得性免疫缺陷综合症（艾滋病）由人免疫缺陷病毒（Humanimmunodeficiencyvirustype1,HIV-1）感染引起。国家感染性疾病临床医学研究中心/深圳市第三人民医院张国良团队携手深圳华大生命科学研究院吴靓团队，共同研究得出单细胞测序
c++ 的iostream 和 c++的stdio的区别和联系黄卷青灯77 c++算法开发语言 iostream stdio
在C++中，iostream和C语言的stdio.h都是用于处理输入输出的库，但它们在设计、用法和功能上有许多不同。以下是两者的区别和联系：区别1.编程风格iostream（C++风格）：C++标准库中的输入输出流类库，支持面向对象的输入输出操作。典型用法是cin（输入）和cout（输出），使用>操作符来处理数据。更加类型安全，支持用户自定义类型的输入输出。#includeintmain(){in
《投行人生》读书笔记小蘑菇的树洞
《投行人生》----作者詹姆斯-A-朗德摩根斯坦利副主席40年的职业洞见-很短小精悍的篇幅，比较适合初入职场的新人。第一部分成功的职业生涯需要规划1.情商归为适应能力分享与协作同理心适应能力，更多的是自我意识，你有能力识别自己的情并分辨这些情绪如何影响你的思想和行为。2.对于初入职场的人的建议，细节，截止日期和数据很重要截止日期，一种有效的方法是请老板为你所有的任务进行优先级排序。和老板喝咖啡的好
swagger访问路径 igotyback swagger
Swagger2.x版本访问地址：http://{ip}:{port}/{context-path}/swagger-ui.html{ip}是你的服务器IP地址。{port}是你的应用服务端口，通常为8080。{context-path}是你的应用上下文路径，如果应用部署在根路径下，则为空。Swagger3.x版本对于Swagger3.x版本（也称为OpenAPI3）访问地址：http://{ip
Linux下QT开发的动态库界面弹出操作（SDL2） 13jjyao QT类 qt 开发语言 sdl2 linux
需求：操作系统为linux，开发框架为qt，做成需带界面的qt动态库，调用方为java等非qt程序难点：调用方为java等非qt程序，也就是说调用方肯定不带QApplication::exec()，缺少了这个，QTimer等事件和QT创建的窗口将不能弹出(包括opencv也是不能弹出)；这与qt调用本身qt库是有本质的区别的思路：1.调用方缺QApplication::exec()，那么我们在接口
绘本讲师训练营【24期】8/21阅读原创《独生小孩》 1784e22615e0
24016-孟娟《独生小孩》图片发自App今天我想分享一个蛮特别的绘本，讲的是一个特殊的群体，我也是属于这个群体，80后的独生小孩。这是一本中国绘本，作者郭婧，也是一个80厚。全书一百多页，均为铅笔绘制，虽然为黑白色调，但并不显得沉闷。全书没有文字，犹如“默片”，但并不影响读者对该作品的理解，反而显得神秘，梦幻，給读者留下想象的空间。作者在前蝴蝶页这样写到：“我更希望父母和孩子一起分享这本书，使他
店群合一模式下的社区团购新发展——结合链动 2+1 模式、AI 智能名片与 S2B2C 商城小程序源码说私域人工智能小程序
摘要：本文探讨了店群合一的社区团购平台在当今商业环境中的重要性和优势。通过分析店群合一模式如何将互联网社群与线下终端紧密结合，阐述了链动2+1模式、AI智能名片和S2B2C商城小程序源码在这一模式中的应用价值。这些创新元素的结合为社区团购带来了新的机遇，提升了用户信任感、拓展了营销渠道，并实现了线上线下的完美融合。一、引言随着互联网技术的不断发展，社区团购作为一种新兴的商业模式，在满足消费者日常需
消息中间件有哪些常见类型 xmh-sxh-1314 java
消息中间件根据其设计理念和用途，可以大致分为以下几种常见类型：点对点消息队列（Point-to-PointMessagingQueues）：在这种模型中，消息被发送到特定的队列中，消费者从队列中取出并处理消息。队列中的消息只能被一个消费者消费，消费后即被删除。常见的实现包括IBM的MQSeries、RabbitMQ的部分使用场景等。适用于任务分发、负载均衡等场景。发布/订阅消息模型（Pub/Sub
ArcGIS栅格计算器常见公式（赋值、0和空值的转换、补充栅格空值）研学随笔 arcgis 经验分享
我们在使用ArcGIS时通常经常用到栅格计算器，今天主要给大家介绍我日常中经常用到的几个公式，供大家参考学习。将特定值（-9999）赋值为0，例如-9999.Con("raster"==-9999,0,"raster")2.给空值赋予特定的值（如0）Con(IsNull("raster"),0,"raster")3.将特定的栅格值(如1)赋值为空值，其他保留原值SetNull("raster"==
水平垂直居中的几种方法（总结） LJ小番茄 CSS_玄学语言 html javascript 前端 css css3
1.使用flexbox的justify-content和align-items.parent{display:flex;justify-content:center;/*水平居中*/align-items:center;/*垂直居中*/height:100vh;/*需要指定高度*/}2.使用grid的place-items:center.parent{display:grid;place-item
本周第二次约练 2cfbdfe28a51
中原焦点团队中24初26刘霞2021.12.3约练161次，分享第368天当事人虽然是带着问题来的，但是咨询过程中发现，她是经过自己不断地调整和努力才走到现在的，看到当事人的不容易，找到例外，发现资源，力量感也就随之而来。增强画面感，或者说重温，会给当事人带来更深刻的感受。
放下是一段成长的修行小莳玥
人来到这个世界上，只有两件事：生和死。一件事已经做完了，另一件你还急什么呢?是人，都有七情六欲。是心，都有喜怒哀乐，这些再正常不过了。别总抱怨自己活得累，过得辛苦。永远记住：舒坦是留给死人的。苦，才是生活；累，才是工作；变，才是命运；忍，才是历练；容，才是智慧；静，才是修养；舍，才会得到；做，才会拥有。人生，活得太清楚，才是最大的不明白。有些事，看得很清，却说不清；有些人，了解很深，却猜不透；有些
回溯 Leetcode 332 重新安排行程 mmaerd Leetcode刷题学习记录 leetcode 算法职场和发展
重新安排行程Leetcode332学习记录自代码随想录给你一份航线列表tickets，其中tickets[i]=[fromi,toi]表示飞机出发和降落的机场地点。请你对该行程进行重新规划排序。所有这些机票都属于一个从JFK（肯尼迪国际机场）出发的先生，所以该行程必须从JFK开始。如果存在多种有效的行程，请你按字典排序返回最小的行程组合。例如，行程[“JFK”,“LGA”]与[“JFK”,“LGB
Python数据分析与可视化实战指南 William数据分析 python python 数据
在数据驱动的时代，Python因其简洁的语法、强大的库生态系统以及活跃的社区，成为了数据分析与可视化的首选语言。本文将通过一个详细的案例，带领大家学习如何使用Python进行数据分析，并通过可视化来直观呈现分析结果。一、环境准备1.1安装必要库在开始数据分析和可视化之前，我们需要安装一些常用的库。主要包括pandas、numpy、matplotlib和seaborn等。这些库分别用于数据处理、数学
每日一题——第八十四题互联网打工人no1 C语言程序设计每日一练 c语言
题目：编写函数1、输入10个职工的姓名和职工号2、按照职工由大到小顺序排列，姓名顺序也随之调整3、要求输入一个职工号，用折半查找法找出该职工的姓名#define_CRT_SECURE_NO_WARNINGS#include#include#defineMAX_EMPLOYEES10typedefstruct{intid;charname[50];}Empolyee;voidinputEmploye
WPF中的ComboBox控件几种数据绑定的方式互联网打工人no1 wpf c#
一、用字典给ItemsSource赋值（此绑定用的地方很多，建议熟练掌握）在XMAL中：在CS文件中privatevoidBindData(){DictionarydicItem=newDictionary();dicItem.add(1,"北京");dicItem.add(2,"上海");dicItem.add(3,"广州");cmb_list.ItemsSource=dicItem;cmb_l
jdk tomcat 环境变量配置 Array_06 java jdk tomcat
Win7 下如何配置java环境变量 1。准备jdk包，win7系统，tomcat安装包（均上网下载即可） 2。进行对jdk的安装，尽量为默认路径（但要记住啊！！以防以后配置用。。。） 3。分别配置高级环境变量。电脑-->右击属性-->高级环境变量-->环境变量。分别配置 : path &nbs
Spring调SDK包报java.lang.NoSuchFieldError错误 bijian1013 java spring
在工作中调另一个系统的SDK包，出现如下java.lang.NoSuchFieldError错误。 org.springframework.web.util.NestedServletException: Handler processing failed; nested exception is java.l
LeetCode[位运算] - #136 数组中的单一数 Cwind java 题解位运算 LeetCode Algorithm
原题链接：#136 Single Number 要求：给定一个整型数组，其中除了一个元素之外，每个元素都出现两次。找出这个元素注意：算法的时间复杂度应为O(n)，最好不使用额外的内存空间难度：中等分析：题目限定了线性的时间复杂度，同时不使用额外的空间，即要求只遍历数组一遍得出结果。由于异或运算 n XOR n = 0, n XOR 0 = n，故将数组中的每个元素进
qq登陆界面开发 15700786134 qq
今天我们来开发一个qq登陆界面，首先写一个界面程序，一个界面首先是一个Frame对象，即是一个窗体。然后在这个窗体上放置其他组件。代码如下： public class First { public void initul(){ jf=ne
Linux的程序包管理器RPM 被触发 linux
在早期我们使用源代码的方式来安装软件时，都需要先把源程序代码编译成可执行的二进制安装程序，然后进行安装。这就意味着每次安装软件都需要经过预处理-->编译-->汇编-->链接-->生成安装文件--> 安装，这个复杂而艰辛的过程。为简化安装步骤，便于广大用户的安装部署程序，程序提供商就在特定的系统上面编译好相关程序的安装文件并进行打包，提供给大家下载，我们只需要根据自己的
socket通信遇到EOFException 肆无忌惮_ EOFException
java.io.EOFException at java.io.ObjectInputStream$PeekInputStream.readFully(ObjectInputStream.java:2281) at java.io.ObjectInputStream$BlockDataInputStream.readShort(ObjectInputStream.java:
基于spring的web项目定时操作知了ing java Web
废话不多说，直接上代码，很简单配置一下项目启动就行 1，web.xml <?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="h
树形结构的数据库表Schema设计矮蛋蛋 schema
原文地址： http://blog.csdn.net/MONKEY_D_MENG/article/details/6647488 程序设计过程中，我们常常用树形结构来表征某些数据的关联关系，如企业上下级部门、栏目结构、商品分类等等，通常而言，这些树状结构需要借助于数据库完成持久化。然而目前的各种基于关系的数据库，都是以二维表的形式记录存储数据信息，
maven将jar包和源码一起打包到本地仓库 alleni123 maven
http://stackoverflow.com/questions/4031987/how-to-upload-sources-to-local-maven-repository <project> ... <build> <plugins> <plugin> <groupI
java IO操作与 File 获取文件或文件夹的大小，可读，等属性！！！百合不是茶
类 File File是指文件和目录路径名的抽象表示形式。 1，何为文件：标准文件（txt doc mp3...）目录文件（文件夹）虚拟内存文件 2，File类中有可以创建文件的 createNewFile（）方法,在创建新文件的时候需要try{} catch(）{}因为可能会抛出异常；也有可以判断文件是否是一个标准文件的方法isFile();这些防抖都
Spring注入有继承关系的类（2） bijian1013 java spring
被注入类的父类有相应的属性，Spring可以直接注入相应的属性，如下所例：1.AClass类 package com.bijian.spring.test4; public class AClass { private String a; private String b; public String getA() { retu
30岁转型期你能否成为成功人士 bijian1013 成长励志
很多人由于年轻时走了弯路，到了30岁一事无成，这样的例子大有人在。但同样也有一些人，整个职业生涯都发展得很优秀，到了30岁已经成为职场的精英阶层。由于做猎头的原因，我们接触很多30岁左右的经理人，发现他们在职业发展道路上往往有很多致命的问题。在30岁之前，他们的职业生涯表现很优秀，但从30岁到40岁这一段，很多人
【Velocity四】Velocity与Java互操作 bit1129 velocity
Velocity出现的目的用于简化基于MVC的web应用开发，用于替代JSP标签技术，那么Velocity如何访问Java代码.本篇继续以Velocity三http://bit1129.iteye.com/blog/2106142中的例子为基础， POJO package com.tom.servlets; public
【Hive十一】Hive数据倾斜优化 bit1129 hive
什么是Hive数据倾斜问题操作：join,group by,count distinct 现象：任务进度长时间维持在99%（或100%），查看任务监控页面，发现只有少量（1个或几个）reduce子任务未完成；查看未完成的子任务，可以看到本地读写数据量积累非常大，通常超过10GB可以认定为发生数据倾斜。原因：key分布不均匀倾斜度衡量：平均记录数超过50w且
在nginx中集成lua脚本：添加自定义Http头，封IP等 ronin47 nginx lua csrf
Lua是一个可以嵌入到Nginx配置文件中的动态脚本语言，从而可以在Nginx请求处理的任何阶段执行各种Lua代码。刚开始我们只是用Lua 把请求路由到后端服务器，但是它对我们架构的作用超出了我们的预期。下面就讲讲我们所做的工作。强制搜索引擎只索引mixlr.com Google把子域名当作完全独立的网站，我们不希望爬虫抓取子域名的页面，降低我们的Page rank。 location /{
java-3.求子数组的最大和 bylijinnan java
package beautyOfCoding; public class MaxSubArraySum { /** * 3.求子数组的最大和题目描述：输入一个整形数组，数组里有正数也有负数。数组中连续的一个或多个整数组成一个子数组，每个子数组都有一个和。求所有子数组的和的最大值。要求时间复杂度为O(n)。例如输入的数组为1, -2, 3, 10, -4,
Netty源码学习-FileRegion bylijinnan java netty
今天看org.jboss.netty.example.http.file.HttpStaticFileServerHandler.java 可以直接往channel里面写入一个FileRegion对象，而不需要相应的encoder： //pipeline（没有诸如“FileRegionEncoder”的handler）： public ChannelPipeline ge
使用ZeroClipboard解决跨浏览器复制到剪贴板的问题 cngolon 跨浏览器复制到粘贴板 Zero Clipboard
Zero Clipboard的实现原理 Zero Clipboard 利用透明的Flash让其漂浮在复制按钮之上，这样其实点击的不是按钮而是 Flash ，这样将需要的内容传入Flash，再通过Flash的复制功能把传入的内容复制到剪贴板。 Zero Clipboard的安装方法首先需要下载 Zero Clipboard的压缩包，解压后把文件夹中两个文件：ZeroClipboard.js
单例模式 cuishikuan 单例模式
第一种（懒汉，线程不安全）： public class Singleton { 2 private static Singleton instance; 3 pri
spring+websocket的使用 dalan_123
一、spring配置文件 <?xml version="1.0" encoding="UTF-8"?><beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.or
细节问题：ZEROFILL的用法范围。 dcj3sjt126com mysql
1、zerofill把月份中的一位数字比如1，2，3等加前导0 mysql> CREATE TABLE t1 (year YEAR(4), month INT(2) UNSIGNED ZEROFILL, -> day
Android开发10——Activity的跳转与传值 dcj3sjt126com Android开发
Activity跳转与传值，主要是通过Intent类，Intent的作用是激活组件和附带数据。一、Activity跳转方法一Intent intent = new Intent(A.this, B.class); startActivity(intent) 方法二Intent intent = new Intent();intent.setCla
jdbc 得到表结构、主键 eksliang jdbc 得到表结构、主键
转自博客：http://blog.csdn.net/ocean1010/article/details/7266042 假设有个con DatabaseMetaData dbmd = con.getMetaData(); rs = dbmd.getColumns(con.getCatalog(), schema, tableName, null); rs.getSt
Android 应用程序开关GPS gqdy365 android
要在应用程序中操作GPS开关需要权限： <uses-permission android:name="android.permission.WRITE_SECURE_SETTINGS" /> 但在配置文件中添加此权限之后会报错，无法再eclipse里面正常编译，怎么办？ 1、方法一：将项目放到Android源码中编译； 2、方法二：网上有人说cl
Windows上调试MapReduce zhiquanliu mapreduce
1.下载hadoop2x-eclipse-plugin https://github.com/winghc/hadoop2x-eclipse-plugin.git 把 hadoop2.6.0-eclipse-plugin.jar 放到eclipse plugin 目录中。 2.下载 hadoop2.6_x64_.zip http://dl.iteye.com/topics/download/d2b
如何看待一些知名博客推广软文的行为？ justjavac 博客
本文来自我在知乎上的一个回答：http://www.zhihu.com/question/23431810/answer/24588621 互联网上的两种典型心态：当初求种像条狗，如今撸完嫌人丑当初搜贴像条犬，如今读完嫌人软你为啥感觉不舒服呢？难道非得要作者把自己的劳动成果免费给你用，你才舒服？就如同 Google 关闭了 Gooled Reader，那是
sql优化总结 macroli sql
为了是自己对sql优化有更好的原则性，在这里做一下总结，个人原则如有不对请多多指教。谢谢！要知道一个简单的sql语句执行效率，就要有查看方式，一遍更好的进行优化。一、简单的统计语句执行时间 declare @d datetime ---定义一个datetime的变量set @d=getdate() ---获取查询语句开始前的时间select user_id
Linux Oracle中常遇到的一些问题及命令总结超声波 oracle linux
1.linux更改主机名 (1)#hostname oracledb　　　　临时修改主机名 (2) vi /etc/sysconfig/network 　　修改hostname (3) vi /etc/hosts　　　　　　　　修改IP对应的主机名 2.linux重启oracle实例及监听的各种方法（注意操作的顺序应该是先监听，后数据库实例） &nbs
hive函数大全及使用示例 superlxw1234 hadoop hive函数
具体说明及示例参见附件文档。文档目录：目录一、关系运算： 4 1. 等值比较: = 4 2. 不等值比较: <> 4 3. 小于比较: < 4 4. 小于等于比较: <= 4 5. 大于比较: > 5 6. 大于等于比较: >= 5 7. 空值判断: IS NULL 5
Spring 4.2新特性-使用@Order调整配置类加载顺序 wiselyman spring 4
4.1 @Order Spring 4.2 利用@Order控制配置类的加载顺序 4.2 演示两个演示bean package com.wisely.spring4_2.order; public class Demo1Service { } package com.wisely.spring4_2.order; public class