首页 发现 帮助
注册 登录
apache
/
hadoop
镜像自地址 https://github.com/apache/hadoop.git
2
0
派生 1
文件 工单管理 0 Wiki
分支: gh-pages
分支列表 标签列表
hadoop
/
hadoop-project-dist
/
hadoop-common
/
filesystem
/
abortable.html

abortable.html 34 KB
永久链接 文件历史 原始文件

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688 
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    2. 

  2. <!--
    3. 

  3.  | Generated by Apache Maven Doxia at 2025-05-04
    4. 

  4.  | Rendered using Apache Maven Stylus Skin 1.5
    5. 

  5. -->
    6. 

  6. <html xmlns="http://www.w3.org/1999/xhtml">
    7. 

  7.   <head>
    8. 

  8.     <title>Apache Hadoop 3.5.0-SNAPSHOT &#x2013; interface org.apache.hadoop.fs.Abortable</title>
    9. 

  9.     <style type="text/css" media="all">
    10. 

  10.       @import url("../css/maven-base.css");
    11. 

  11.       @import url("../css/maven-theme.css");
    12. 

  12.       @import url("../css/site.css");
    13. 

  13.     </style>
    14. 

  14.     <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
    15. 

  15.         <meta name="Date-Revision-yyyymmdd" content="20250504" />
    16. 

  16.     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    17. 

  17.                 </head>
    18. 

  18.   <body class="composite">
    19. 

  19.     <div id="banner">
    20. 

  20.                         <a href="http://hadoop.apache.org/" id="bannerLeft">
    21. 

  21.                                         <img src="http://hadoop.apache.org/images/hadoop-logo.jpg" alt="" />
    22. 

  22.                 </a>
    23. 

  23.                               <a href="http://www.apache.org/" id="bannerRight">
    24. 

  24.                                         <img src="http://www.apache.org/images/asf_logo_wide.png" alt="" />
    25. 

  25.                 </a>
    26. 

  26.             <div class="clear">
    27. 

  27.         <hr/>
    28. 

  28.       </div>
    29. 

  29.     </div>
    30. 

  30.     <div id="breadcrumbs">
    31. 

  31.             
    32. 

  32.                                      <div class="xright">            <a href="http://wiki.apache.org/hadoop" class="externalLink">Wiki</a>
    33. 

  33.             |
    34. 

  34.                 <a href="https://gitbox.apache.org/repos/asf/hadoop.git" class="externalLink">git</a>
    35. 

  35.             |
    36. 

  36.                 <a href="http://hadoop.apache.org/" class="externalLink">Apache Hadoop</a>
    37. 

  37.               
    38. 

  38.                                    &nbsp;| Last Published: 2025-05-04
    39. 

  39.               &nbsp;| Version: 3.5.0-SNAPSHOT
    40. 

  40.             </div>
    41. 

  41.       <div class="clear">
    42. 

  42.         <hr/>
    43. 

  43.       </div>
    44. 

  44.     </div>
    45. 

  45.     <div id="leftColumn">
    46. 

  46.       <div id="navcolumn">
    47. 

  47.              
    48. 

  48.                                                    <h5>General</h5>
    49. 

  49.                   <ul>
    50. 

  50.                   <li class="none">
    51. 

  51.                   <a href="../../../index.html">Overview</a>
    52. 

  52.             </li>
    53. 

  53.                   <li class="none">
    54. 

  54.                   <a href="../../../hadoop-project-dist/hadoop-common/SingleCluster.html">Single Node Setup</a>
    55. 

  55.             </li>
    56. 

  56.                   <li class="none">
    57. 

  57.                   <a href="../../../hadoop-project-dist/hadoop-common/ClusterSetup.html">Cluster Setup</a>
    58. 

  58.             </li>
    59. 

  59.                   <li class="none">
    60. 

  60.                   <a href="../../../hadoop-project-dist/hadoop-common/CommandsManual.html">Commands Reference</a>
    61. 

  61.             </li>
    62. 

  62.                   <li class="none">
    63. 

  63.                   <a href="../../../hadoop-project-dist/hadoop-common/FileSystemShell.html">FileSystem Shell</a>
    64. 

  64.             </li>
    65. 

  65.                   <li class="none">
    66. 

  66.                   <a href="../../../hadoop-project-dist/hadoop-common/Compatibility.html">Compatibility Specification</a>
    67. 

  67.             </li>
    68. 

  68.                   <li class="none">
    69. 

  69.                   <a href="../../../hadoop-project-dist/hadoop-common/DownstreamDev.html">Downstream Developer's Guide</a>
    70. 

  70.             </li>
    71. 

  71.                   <li class="none">
    72. 

  72.                   <a href="../../../hadoop-project-dist/hadoop-common/AdminCompatibilityGuide.html">Admin Compatibility Guide</a>
    73. 

  73.             </li>
    74. 

  74.                   <li class="none">
    75. 

  75.                   <a href="../../../hadoop-project-dist/hadoop-common/InterfaceClassification.html">Interface Classification</a>
    76. 

  76.             </li>
    77. 

  77.                   <li class="none">
    78. 

  78.                   <a href="../../../hadoop-project-dist/hadoop-common/filesystem/index.html">FileSystem Specification</a>
    79. 

  79.             </li>
    80. 

  80.           </ul>
    81. 

  81.                        <h5>Common</h5>
    82. 

  82.                   <ul>
    83. 

  83.                   <li class="none">
    84. 

  84.                   <a href="../../../hadoop-project-dist/hadoop-common/CLIMiniCluster.html">CLI Mini Cluster</a>
    85. 

  85.             </li>
    86. 

  86.                   <li class="none">
    87. 

  87.                   <a href="../../../hadoop-project-dist/hadoop-common/FairCallQueue.html">Fair Call Queue</a>
    88. 

  88.             </li>
    89. 

  89.                   <li class="none">
    90. 

  90.                   <a href="../../../hadoop-project-dist/hadoop-common/NativeLibraries.html">Native Libraries</a>
    91. 

  91.             </li>
    92. 

  92.                   <li class="none">
    93. 

  93.                   <a href="../../../hadoop-project-dist/hadoop-common/Superusers.html">Proxy User</a>
    94. 

  94.             </li>
    95. 

  95.                   <li class="none">
    96. 

  96.                   <a href="../../../hadoop-project-dist/hadoop-common/RackAwareness.html">Rack Awareness</a>
    97. 

  97.             </li>
    98. 

  98.                   <li class="none">
    99. 

  99.                   <a href="../../../hadoop-project-dist/hadoop-common/SecureMode.html">Secure Mode</a>
    100. 

  100.             </li>
    101. 

  101.                   <li class="none">
    102. 

  102.                   <a href="../../../hadoop-project-dist/hadoop-common/ServiceLevelAuth.html">Service Level Authorization</a>
    103. 

  103.             </li>
    104. 

  104.                   <li class="none">
    105. 

  105.                   <a href="../../../hadoop-project-dist/hadoop-common/HttpAuthentication.html">HTTP Authentication</a>
    106. 

  106.             </li>
    107. 

  107.                   <li class="none">
    108. 

  108.                   <a href="../../../hadoop-project-dist/hadoop-common/CredentialProviderAPI.html">Credential Provider API</a>
    109. 

  109.             </li>
    110. 

  110.                   <li class="none">
    111. 

  111.                   <a href="../../../hadoop-kms/index.html">Hadoop KMS</a>
    112. 

  112.             </li>
    113. 

  113.                   <li class="none">
    114. 

  114.                   <a href="../../../hadoop-project-dist/hadoop-common/Tracing.html">Tracing</a>
    115. 

  115.             </li>
    116. 

  116.                   <li class="none">
    117. 

  117.                   <a href="../../../hadoop-project-dist/hadoop-common/UnixShellGuide.html">Unix Shell Guide</a>
    118. 

  118.             </li>
    119. 

  119.                   <li class="none">
    120. 

  120.                   <a href="../../../hadoop-project-dist/hadoop-common/registry/index.html">Registry</a>
    121. 

  121.             </li>
    122. 

  122.                   <li class="none">
    123. 

  123.                   <a href="../../../hadoop-project-dist/hadoop-common/AsyncProfilerServlet.html">Async Profiler</a>
    124. 

  124.             </li>
    125. 

  125.           </ul>
    126. 

  126.                        <h5>HDFS</h5>
    127. 

  127.                   <ul>
    128. 

  128.                   <li class="none">
    129. 

  129.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/HdfsDesign.html">Architecture</a>
    130. 

  130.             </li>
    131. 

  131.                   <li class="none">
    132. 

  132.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/HdfsUserGuide.html">User Guide</a>
    133. 

  133.             </li>
    134. 

  134.                   <li class="none">
    135. 

  135.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/HDFSCommands.html">Commands Reference</a>
    136. 

  136.             </li>
    137. 

  137.                   <li class="none">
    138. 

  138.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/HDFSHighAvailabilityWithQJM.html">NameNode HA With QJM</a>
    139. 

  139.             </li>
    140. 

  140.                   <li class="none">
    141. 

  141.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/HDFSHighAvailabilityWithNFS.html">NameNode HA With NFS</a>
    142. 

  142.             </li>
    143. 

  143.                   <li class="none">
    144. 

  144.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/ObserverNameNode.html">Observer NameNode</a>
    145. 

  145.             </li>
    146. 

  146.                   <li class="none">
    147. 

  147.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/Federation.html">Federation</a>
    148. 

  148.             </li>
    149. 

  149.                   <li class="none">
    150. 

  150.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/ViewFs.html">ViewFs</a>
    151. 

  151.             </li>
    152. 

  152.                   <li class="none">
    153. 

  153.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/ViewFsOverloadScheme.html">ViewFsOverloadScheme</a>
    154. 

  154.             </li>
    155. 

  155.                   <li class="none">
    156. 

  156.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/HdfsSnapshots.html">Snapshots</a>
    157. 

  157.             </li>
    158. 

  158.                   <li class="none">
    159. 

  159.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/HdfsEditsViewer.html">Edits Viewer</a>
    160. 

  160.             </li>
    161. 

  161.                   <li class="none">
    162. 

  162.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/HdfsImageViewer.html">Image Viewer</a>
    163. 

  163.             </li>
    164. 

  164.                   <li class="none">
    165. 

  165.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/HdfsPermissionsGuide.html">Permissions and HDFS</a>
    166. 

  166.             </li>
    167. 

  167.                   <li class="none">
    168. 

  168.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/HdfsQuotaAdminGuide.html">Quotas and HDFS</a>
    169. 

  169.             </li>
    170. 

  170.                   <li class="none">
    171. 

  171.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/LibHdfs.html">libhdfs (C API)</a>
    172. 

  172.             </li>
    173. 

  173.                   <li class="none">
    174. 

  174.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/WebHDFS.html">WebHDFS (REST API)</a>
    175. 

  175.             </li>
    176. 

  176.                   <li class="none">
    177. 

  177.                   <a href="../../../hadoop-hdfs-httpfs/index.html">HttpFS</a>
    178. 

  178.             </li>
    179. 

  179.                   <li class="none">
    180. 

  180.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/ShortCircuitLocalReads.html">Short Circuit Local Reads</a>
    181. 

  181.             </li>
    182. 

  182.                   <li class="none">
    183. 

  183.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/CentralizedCacheManagement.html">Centralized Cache Management</a>
    184. 

  184.             </li>
    185. 

  185.                   <li class="none">
    186. 

  186.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/HdfsNfsGateway.html">NFS Gateway</a>
    187. 

  187.             </li>
    188. 

  188.                   <li class="none">
    189. 

  189.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/HdfsRollingUpgrade.html">Rolling Upgrade</a>
    190. 

  190.             </li>
    191. 

  191.                   <li class="none">
    192. 

  192.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/ExtendedAttributes.html">Extended Attributes</a>
    193. 

  193.             </li>
    194. 

  194.                   <li class="none">
    195. 

  195.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/TransparentEncryption.html">Transparent Encryption</a>
    196. 

  196.             </li>
    197. 

  197.                   <li class="none">
    198. 

  198.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/HdfsMultihoming.html">Multihoming</a>
    199. 

  199.             </li>
    200. 

  200.                   <li class="none">
    201. 

  201.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/ArchivalStorage.html">Storage Policies</a>
    202. 

  202.             </li>
    203. 

  203.                   <li class="none">
    204. 

  204.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/MemoryStorage.html">Memory Storage Support</a>
    205. 

  205.             </li>
    206. 

  206.                   <li class="none">
    207. 

  207.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/SLGUserGuide.html">Synthetic Load Generator</a>
    208. 

  208.             </li>
    209. 

  209.                   <li class="none">
    210. 

  210.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/HDFSErasureCoding.html">Erasure Coding</a>
    211. 

  211.             </li>
    212. 

  212.                   <li class="none">
    213. 

  213.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/HDFSDiskbalancer.html">Disk Balancer</a>
    214. 

  214.             </li>
    215. 

  215.                   <li class="none">
    216. 

  216.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/HdfsUpgradeDomain.html">Upgrade Domain</a>
    217. 

  217.             </li>
    218. 

  218.                   <li class="none">
    219. 

  219.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/HdfsDataNodeAdminGuide.html">DataNode Admin</a>
    220. 

  220.             </li>
    221. 

  221.                   <li class="none">
    222. 

  222.                   <a href="../../../hadoop-project-dist/hadoop-hdfs-rbf/HDFSRouterFederation.html">Router Federation</a>
    223. 

  223.             </li>
    224. 

  224.                   <li class="none">
    225. 

  225.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/HdfsProvidedStorage.html">Provided Storage</a>
    226. 

  226.             </li>
    227. 

  227.           </ul>
    228. 

  228.                        <h5>MapReduce</h5>
    229. 

  229.                   <ul>
    230. 

  230.                   <li class="none">
    231. 

  231.                   <a href="../../../hadoop-mapreduce-client/hadoop-mapreduce-client-core/MapReduceTutorial.html">Tutorial</a>
    232. 

  232.             </li>
    233. 

  233.                   <li class="none">
    234. 

  234.                   <a href="../../../hadoop-mapreduce-client/hadoop-mapreduce-client-core/MapredCommands.html">Commands Reference</a>
    235. 

  235.             </li>
    236. 

  236.                   <li class="none">
    237. 

  237.                   <a href="../../../hadoop-mapreduce-client/hadoop-mapreduce-client-core/MapReduce_Compatibility_Hadoop1_Hadoop2.html">Compatibility with 1.x</a>
    238. 

  238.             </li>
    239. 

  239.                   <li class="none">
    240. 

  240.                   <a href="../../../hadoop-mapreduce-client/hadoop-mapreduce-client-core/EncryptedShuffle.html">Encrypted Shuffle</a>
    241. 

  241.             </li>
    242. 

  242.                   <li class="none">
    243. 

  243.                   <a href="../../../hadoop-mapreduce-client/hadoop-mapreduce-client-core/PluggableShuffleAndPluggableSort.html">Pluggable Shuffle/Sort</a>
    244. 

  244.             </li>
    245. 

  245.                   <li class="none">
    246. 

  246.                   <a href="../../../hadoop-mapreduce-client/hadoop-mapreduce-client-core/DistributedCacheDeploy.html">Distributed Cache Deploy</a>
    247. 

  247.             </li>
    248. 

  248.                   <li class="none">
    249. 

  249.                   <a href="../../../hadoop-mapreduce-client/hadoop-mapreduce-client-core/SharedCacheSupport.html">Support for YARN Shared Cache</a>
    250. 

  250.             </li>
    251. 

  251.           </ul>
    252. 

  252.                        <h5>MapReduce REST APIs</h5>
    253. 

  253.                   <ul>
    254. 

  254.                   <li class="none">
    255. 

  255.                   <a href="../../../hadoop-mapreduce-client/hadoop-mapreduce-client-core/MapredAppMasterRest.html">MR Application Master</a>
    256. 

  256.             </li>
    257. 

  257.                   <li class="none">
    258. 

  258.                   <a href="../../../hadoop-mapreduce-client/hadoop-mapreduce-client-hs/HistoryServerRest.html">MR History Server</a>
    259. 

  259.             </li>
    260. 

  260.           </ul>
    261. 

  261.                        <h5>YARN</h5>
    262. 

  262.                   <ul>
    263. 

  263.                   <li class="none">
    264. 

  264.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/YARN.html">Architecture</a>
    265. 

  265.             </li>
    266. 

  266.                   <li class="none">
    267. 

  267.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/YarnCommands.html">Commands Reference</a>
    268. 

  268.             </li>
    269. 

  269.                   <li class="none">
    270. 

  270.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/CapacityScheduler.html">Capacity Scheduler</a>
    271. 

  271.             </li>
    272. 

  272.                   <li class="none">
    273. 

  273.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/FairScheduler.html">Fair Scheduler</a>
    274. 

  274.             </li>
    275. 

  275.                   <li class="none">
    276. 

  276.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/ResourceManagerRestart.html">ResourceManager Restart</a>
    277. 

  277.             </li>
    278. 

  278.                   <li class="none">
    279. 

  279.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/ResourceManagerHA.html">ResourceManager HA</a>
    280. 

  280.             </li>
    281. 

  281.                   <li class="none">
    282. 

  282.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/ResourceModel.html">Resource Model</a>
    283. 

  283.             </li>
    284. 

  284.                   <li class="none">
    285. 

  285.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/NodeLabel.html">Node Labels</a>
    286. 

  286.             </li>
    287. 

  287.                   <li class="none">
    288. 

  288.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/NodeAttributes.html">Node Attributes</a>
    289. 

  289.             </li>
    290. 

  290.                   <li class="none">
    291. 

  291.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/WebApplicationProxy.html">Web Application Proxy</a>
    292. 

  292.             </li>
    293. 

  293.                   <li class="none">
    294. 

  294.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/TimelineServer.html">Timeline Server</a>
    295. 

  295.             </li>
    296. 

  296.                   <li class="none">
    297. 

  297.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/TimelineServiceV2.html">Timeline Service V.2</a>
    298. 

  298.             </li>
    299. 

  299.                   <li class="none">
    300. 

  300.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/WritingYarnApplications.html">Writing YARN Applications</a>
    301. 

  301.             </li>
    302. 

  302.                   <li class="none">
    303. 

  303.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/YarnApplicationSecurity.html">YARN Application Security</a>
    304. 

  304.             </li>
    305. 

  305.                   <li class="none">
    306. 

  306.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/NodeManager.html">NodeManager</a>
    307. 

  307.             </li>
    308. 

  308.                   <li class="none">
    309. 

  309.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/DockerContainers.html">Running Applications in Docker Containers</a>
    310. 

  310.             </li>
    311. 

  311.                   <li class="none">
    312. 

  312.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/RuncContainers.html">Running Applications in runC Containers</a>
    313. 

  313.             </li>
    314. 

  314.                   <li class="none">
    315. 

  315.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/NodeManagerCgroups.html">Using CGroups</a>
    316. 

  316.             </li>
    317. 

  317.                   <li class="none">
    318. 

  318.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/SecureContainer.html">Secure Containers</a>
    319. 

  319.             </li>
    320. 

  320.                   <li class="none">
    321. 

  321.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/ReservationSystem.html">Reservation System</a>
    322. 

  322.             </li>
    323. 

  323.                   <li class="none">
    324. 

  324.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/GracefulDecommission.html">Graceful Decommission</a>
    325. 

  325.             </li>
    326. 

  326.                   <li class="none">
    327. 

  327.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/OpportunisticContainers.html">Opportunistic Containers</a>
    328. 

  328.             </li>
    329. 

  329.                   <li class="none">
    330. 

  330.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/Federation.html">YARN Federation</a>
    331. 

  331.             </li>
    332. 

  332.                   <li class="none">
    333. 

  333.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/SharedCache.html">Shared Cache</a>
    334. 

  334.             </li>
    335. 

  335.                   <li class="none">
    336. 

  336.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/UsingGpus.html">Using GPU</a>
    337. 

  337.             </li>
    338. 

  338.                   <li class="none">
    339. 

  339.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/UsingFPGA.html">Using FPGA</a>
    340. 

  340.             </li>
    341. 

  341.                   <li class="none">
    342. 

  342.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/PlacementConstraints.html">Placement Constraints</a>
    343. 

  343.             </li>
    344. 

  344.                   <li class="none">
    345. 

  345.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/YarnUI2.html">YARN UI2</a>
    346. 

  346.             </li>
    347. 

  347.           </ul>
    348. 

  348.                        <h5>YARN REST APIs</h5>
    349. 

  349.                   <ul>
    350. 

  350.                   <li class="none">
    351. 

  351.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/WebServicesIntro.html">Introduction</a>
    352. 

  352.             </li>
    353. 

  353.                   <li class="none">
    354. 

  354.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/ResourceManagerRest.html">Resource Manager</a>
    355. 

  355.             </li>
    356. 

  356.                   <li class="none">
    357. 

  357.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/NodeManagerRest.html">Node Manager</a>
    358. 

  358.             </li>
    359. 

  359.                   <li class="none">
    360. 

  360.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/TimelineServer.html#Timeline_Server_REST_API_v1">Timeline Server</a>
    361. 

  361.             </li>
    362. 

  362.                   <li class="none">
    363. 

  363.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/TimelineServiceV2.html#Timeline_Service_v.2_REST_API">Timeline Service V.2</a>
    364. 

  364.             </li>
    365. 

  365.           </ul>
    366. 

  366.                        <h5>YARN Service</h5>
    367. 

  367.                   <ul>
    368. 

  368.                   <li class="none">
    369. 

  369.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/yarn-service/Overview.html">Overview</a>
    370. 

  370.             </li>
    371. 

  371.                   <li class="none">
    372. 

  372.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/yarn-service/QuickStart.html">QuickStart</a>
    373. 

  373.             </li>
    374. 

  374.                   <li class="none">
    375. 

  375.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/yarn-service/Concepts.html">Concepts</a>
    376. 

  376.             </li>
    377. 

  377.                   <li class="none">
    378. 

  378.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/yarn-service/YarnServiceAPI.html">Yarn Service API</a>
    379. 

  379.             </li>
    380. 

  380.                   <li class="none">
    381. 

  381.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/yarn-service/ServiceDiscovery.html">Service Discovery</a>
    382. 

  382.             </li>
    383. 

  383.                   <li class="none">
    384. 

  384.                   <a href="../../../hadoop-yarn/hadoop-yarn-site/yarn-service/SystemServices.html">System Services</a>
    385. 

  385.             </li>
    386. 

  386.           </ul>
    387. 

  387.                        <h5>Hadoop Compatible File Systems</h5>
    388. 

  388.                   <ul>
    389. 

  389.                   <li class="none">
    390. 

  390.                   <a href="../../../hadoop-aliyun/tools/hadoop-aliyun/index.html">Aliyun OSS</a>
    391. 

  391.             </li>
    392. 

  392.                   <li class="none">
    393. 

  393.                   <a href="../../../hadoop-aws/tools/hadoop-aws/index.html">Amazon S3</a>
    394. 

  394.             </li>
    395. 

  395.                   <li class="none">
    396. 

  396.                   <a href="../../../hadoop-azure/index.html">Azure Blob Storage</a>
    397. 

  397.             </li>
    398. 

  398.                   <li class="none">
    399. 

  399.                   <a href="../../../hadoop-azure-datalake/index.html">Azure Data Lake Storage</a>
    400. 

  400.             </li>
    401. 

  401.                   <li class="none">
    402. 

  402.                   <a href="../../../hadoop-cos/cloud-storage/index.html">Tencent COS</a>
    403. 

  403.             </li>
    404. 

  404.                   <li class="none">
    405. 

  405.                   <a href="../../../hadoop-huaweicloud/index.html">Huaweicloud OBS</a>
    406. 

  406.             </li>
    407. 

  407.                   <li class="none">
    408. 

  408.                   <a href="../../../hadoop-tos/cloud-storage/index.html">VolcanoEngine TOS</a>
    409. 

  409.             </li>
    410. 

  410.           </ul>
    411. 

  411.                        <h5>Auth</h5>
    412. 

  412.                   <ul>
    413. 

  413.                   <li class="none">
    414. 

  414.                   <a href="../../../hadoop-auth/index.html">Overview</a>
    415. 

  415.             </li>
    416. 

  416.                   <li class="none">
    417. 

  417.                   <a href="../../../hadoop-auth/Examples.html">Examples</a>
    418. 

  418.             </li>
    419. 

  419.                   <li class="none">
    420. 

  420.                   <a href="../../../hadoop-auth/Configuration.html">Configuration</a>
    421. 

  421.             </li>
    422. 

  422.                   <li class="none">
    423. 

  423.                   <a href="../../../hadoop-auth/BuildingIt.html">Building</a>
    424. 

  424.             </li>
    425. 

  425.           </ul>
    426. 

  426.                        <h5>Tools</h5>
    427. 

  427.                   <ul>
    428. 

  428.                   <li class="none">
    429. 

  429.                   <a href="../../../hadoop-streaming/HadoopStreaming.html">Hadoop Streaming</a>
    430. 

  430.             </li>
    431. 

  431.                   <li class="none">
    432. 

  432.                   <a href="../../../hadoop-archives/HadoopArchives.html">Hadoop Archives</a>
    433. 

  433.             </li>
    434. 

  434.                   <li class="none">
    435. 

  435.                   <a href="../../../hadoop-archive-logs/HadoopArchiveLogs.html">Hadoop Archive Logs</a>
    436. 

  436.             </li>
    437. 

  437.                   <li class="none">
    438. 

  438.                   <a href="../../../hadoop-distcp/DistCp.html">DistCp</a>
    439. 

  439.             </li>
    440. 

  440.                   <li class="none">
    441. 

  441.                   <a href="../../../hadoop-federation-balance/HDFSFederationBalance.html">HDFS Federation Balance</a>
    442. 

  442.             </li>
    443. 

  443.                   <li class="none">
    444. 

  444.                   <a href="../../../hadoop-gridmix/GridMix.html">GridMix</a>
    445. 

  445.             </li>
    446. 

  446.                   <li class="none">
    447. 

  447.                   <a href="../../../hadoop-rumen/Rumen.html">Rumen</a>
    448. 

  448.             </li>
    449. 

  449.                   <li class="none">
    450. 

  450.                   <a href="../../../hadoop-resourceestimator/ResourceEstimator.html">Resource Estimator Service</a>
    451. 

  451.             </li>
    452. 

  452.                   <li class="none">
    453. 

  453.                   <a href="../../../hadoop-sls/SchedulerLoadSimulator.html">Scheduler Load Simulator</a>
    454. 

  454.             </li>
    455. 

  455.                   <li class="none">
    456. 

  456.                   <a href="../../../hadoop-project-dist/hadoop-common/Benchmarking.html">Hadoop Benchmarking</a>
    457. 

  457.             </li>
    458. 

  458.                   <li class="none">
    459. 

  459.                   <a href="../../../hadoop-dynamometer/Dynamometer.html">Dynamometer</a>
    460. 

  460.             </li>
    461. 

  461.           </ul>
    462. 

  462.                        <h5>Reference</h5>
    463. 

  463.                   <ul>
    464. 

  464.                   <li class="none">
    465. 

  465.                   <a href="../../../hadoop-project-dist/hadoop-common/release/">Changelog and Release Notes</a>
    466. 

  466.             </li>
    467. 

  467.                   <li class="none">
    468. 

  468.                   <a href="../../../api/index.html">Java API docs</a>
    469. 

  469.             </li>
    470. 

  470.                   <li class="none">
    471. 

  471.                   <a href="../../../hadoop-project-dist/hadoop-common/UnixShellAPI.html">Unix Shell API</a>
    472. 

  472.             </li>
    473. 

  473.                   <li class="none">
    474. 

  474.                   <a href="../../../hadoop-project-dist/hadoop-common/Metrics.html">Metrics</a>
    475. 

  475.             </li>
    476. 

  476.           </ul>
    477. 

  477.                        <h5>Configuration</h5>
    478. 

  478.                   <ul>
    479. 

  479.                   <li class="none">
    480. 

  480.                   <a href="../../../hadoop-project-dist/hadoop-common/core-default.xml">core-default.xml</a>
    481. 

  481.             </li>
    482. 

  482.                   <li class="none">
    483. 

  483.                   <a href="../../../hadoop-project-dist/hadoop-hdfs/hdfs-default.xml">hdfs-default.xml</a>
    484. 

  484.             </li>
    485. 

  485.                   <li class="none">
    486. 

  486.                   <a href="../../../hadoop-project-dist/hadoop-hdfs-rbf/hdfs-rbf-default.xml">hdfs-rbf-default.xml</a>
    487. 

  487.             </li>
    488. 

  488.                   <li class="none">
    489. 

  489.                   <a href="../../../hadoop-mapreduce-client/hadoop-mapreduce-client-core/mapred-default.xml">mapred-default.xml</a>
    490. 

  490.             </li>
    491. 

  491.                   <li class="none">
    492. 

  492.                   <a href="../../../hadoop-yarn/hadoop-yarn-common/yarn-default.xml">yarn-default.xml</a>
    493. 

  493.             </li>
    494. 

  494.                   <li class="none">
    495. 

  495.                   <a href="../../../hadoop-kms/kms-default.html">kms-default.xml</a>
    496. 

  496.             </li>
    497. 

  497.                   <li class="none">
    498. 

  498.                   <a href="../../../hadoop-hdfs-httpfs/httpfs-default.html">httpfs-default.xml</a>
    499. 

  499.             </li>
    500. 

  500.                   <li class="none">
    501. 

  501.                   <a href="../../../hadoop-project-dist/hadoop-common/DeprecatedProperties.html">Deprecated Properties</a>
    502. 

  502.             </li>
    503. 

  503.           </ul>
    504. 

  504.                                  <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
    505. 

  505.           <img alt="Built by Maven" src="../images/logos/maven-feather.png"/>
    506. 

  506.         </a>
    507. 

  507.                        
    508. 

  508.                                </div>
    509. 

  509.     </div>
    510. 

  510.     <div id="bodyColumn">
    511. 

  511.       <div id="contentBox">
    512. 

  512.          <!---
    513. 

  513.   Licensed under the Apache License, Version 2.0 (the "License");
    514. 

  514.   you may not use this file except in compliance with the License.
    515. 

  515.   You may obtain a copy of the License at
    516. 

  516. 

  517.    http://www.apache.org/licenses/LICENSE-2.0
    518. 

  518. 

  519.   Unless required by applicable law or agreed to in writing, software
    520. 

  520.   distributed under the License is distributed on an "AS IS" BASIS,
    521. 

  521.   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    522. 

  522.   See the License for the specific language governing permissions and
    523. 

  523.   limitations under the License. See accompanying LICENSE file.
    524. 

  524. -->
    525. 

  525. <!--  ============================================================= -->
    526. 

  526. <!--  CLASS: FileSystem -->
    527. 

  527. <!--  ============================================================= -->
    528. 

  528. <h1>interface <code>org.apache.hadoop.fs.Abortable</code></h1>
    529. 

  529. <ul>
    530. 

  530. <li><a href="#Method_abort.28.29">Method abort()</a></li>
    531. 

  531. <li><a href="#Method_abort.28.29_on_an_output_stream">Method abort() on an output stream</a></li>
    532. 

  532. <li><a href="#Preconditions">Preconditions</a></li>
    533. 

  533. <li><a href="#Postconditions">Postconditions</a>
    534. 

  534. <ul>
    535. 

  535. <li><a href="#Cleanup">Cleanup</a></li>
    536. 

  536. <li><a href="#Thread_safety_and_atomicity">Thread safety and atomicity</a></li></ul></li>
    537. 

  537. <li><a href="#Path.2FStream_capability_.E2.80.9Cfs.capability.outputstream.abortable.E2.80.9D">Path/Stream capability &#x201c;fs.capability.outputstream.abortable&#x201d;</a></li></ul>
    538. 

  538. 

  539. <p>Abort the active operation such that the output does not become manifest.</p>
    540. 

  540. <p>Specifically, if supported on an <a href="outputstream.html">output stream</a>, a successful <code>abort()</code> MUST guarantee that the stream will not be made visible in the <code>close()</code> operation.</p>
    541. 

  541. 

  542. <div class="source">
    543. 

  543. <div class="source">
    544. 

  544. <pre>@InterfaceAudience.Public
    545. 

  545. @InterfaceStability.Unstable
    546. 

  546. public interface Abortable {
    547. 

  547. 

  548.   /**
    549. 

  549.    * Abort the active operation without the output becoming visible.
    550. 

  550.    *
    551. 

  551.    * This is to provide ability to cancel the write on stream; once
    552. 

  552.    * a stream is aborted, the write MUST NOT become visible.
    553. 

  553.    *
    554. 

  554.    * @throws UnsupportedOperationException if the operation is not supported.
    555. 

  555.    * @return the result.
    556. 

  556.    */
    557. 

  557.   AbortableResult abort();
    558. 

  558. 

  559.   /**
    560. 

  560.    * Interface for the result of aborts; allows subclasses to extend
    561. 

  561.    * (IOStatistics etc) or for future enhancements if ever needed.
    562. 

  562.    */
    563. 

  563.   interface AbortableResult {
    564. 

  564. 

  565.     /**
    566. 

  566.      * Was the stream already closed/aborted?
    567. 

  567.      * @return true if a close/abort operation had already
    568. 

  568.      * taken place.
    569. 

  569.      */
    570. 

  570.     boolean alreadyClosed();
    571. 

  571. 

  572.     /**
    573. 

  573.      * Any exception caught during cleanup operations,
    574. 

  574.      * exceptions whose raising/catching does not change
    575. 

  575.      * the semantics of the abort.
    576. 

  576.      * @return an exception or null.
    577. 

  577.      */
    578. 

  578.     IOException anyCleanupException();
    579. 

  579.   }
    580. 

  580. }
    581. 

  581. </pre></div></div>
    582. 

  582. <section>
    583. 

  583. <h2><a name="Method_abort.28.29"></a>Method <code>abort()</code></h2>
    584. 

  584. <p>Aborts the ongoing operation such that no output SHALL become visible when the operation is completed.</p>
    585. 

  585. <p>Unless and until other File System classes implement <code>Abortable</code>, the interface is specified purely for output streams.</p></section><section>
    586. 

  586. <h2><a name="Method_abort.28.29_on_an_output_stream"></a>Method <code>abort()</code> on an output stream</h2>
    587. 

  587. <p><code>Abortable.abort()</code> MUST only be supported on output streams whose output is only made visible when <code>close()</code> is called, for example. output streams returned by the S3A FileSystem.</p></section><section>
    588. 

  588. <h2><a name="Preconditions"></a>Preconditions</h2>
    589. 

  589. <p>The stream MUST implement <code>Abortable</code> and <code>StreamCapabilities</code>.</p>
    590. 

  590. 

  591. <div class="source">
    592. 

  592. <div class="source">
    593. 

  593. <pre>if unsupported:
    594. 

  594.   throw UnsupportedException
    595. 

  595. 

  596. if not isOpen(stream):
    597. 

  597.   no-op
    598. 

  598. 

  599. StreamCapabilities.hasCapability(&quot;fs.capability.outputstream.abortable&quot;) == True
    600. 

  600. </pre></div></div>
    601. 

  601. </section><section>
    602. 

  602. <h2><a name="Postconditions"></a>Postconditions</h2>
    603. 

  603. <p>After <code>abort()</code> returns, the filesystem MUST be unchanged:</p>
    604. 

  604. 

  605. <div class="source">
    606. 

  606. <div class="source">
    607. 

  607. <pre>FS' = FS
    608. 

  608. </pre></div></div>
    609. 

  609. 

  610. <p>A successful <code>abort()</code> operation MUST guarantee that when the stream<code>close()</code> is invoked no output shall be manifest.</p>
    611. 

  611. <ul>
    612. 

  612. 

  613. <li>The stream MUST retry any remote calls needed to force the abort outcome.</li>
    614. 

  614. <li>If any file was present at the destination path, it MUST remain unchanged.</li>
    615. 

  615. </ul>
    616. 

  616. <p>Strictly then:</p>
    617. 

  617. <blockquote>
    618. 

  618. 

  619. <p>if <code>Abortable.abort()</code> does not raise <code>UnsupportedOperationException</code> then returns, then it guarantees that the write SHALL NOT become visible and that any existing data in the filesystem at the destination path SHALL continue to be available.</p>
    620. 

  620. </blockquote>
    621. 

  621. <ol style="list-style-type: decimal">
    622. 

  622. 

  623. <li>Calls to <code>write()</code> methods MUST fail.</li>
    624. 

  624. <li>Calls to <code>flush()</code> MUST be no-ops (applications sometimes call this on closed streams)</li>
    625. 

  625. <li>Subsequent calls to <code>abort()</code> MUST be no-ops.</li>
    626. 

  626. <li><code>close()</code> MUST NOT manifest the file, and MUST NOT raise an exception</li>
    627. 

  627. </ol>
    628. 

  628. <p>That is, the postconditions of <code>close()</code> becomes:</p>
    629. 

  629. 

  630. <div class="source">
    631. 

  631. <div class="source">
    632. 

  632. <pre>FS' = FS
    633. 

  633. </pre></div></div>
    634. 

  634. <section>
    635. 

  635. <h3><a name="Cleanup"></a>Cleanup</h3>
    636. 

  636. <ul>
    637. 

  637. 

  638. <li>
    639. 

  639. 

  640. <p>If temporary data is stored in the local filesystem or in the store&#x2019;s upload infrastructure then this MAY be cleaned up; best-effort is expected here.</p>
    641. 

  641. </li>
    642. 

  642. <li>
    643. 

  643. 

  644. <p>The stream SHOULD NOT retry cleanup operations; any failure there MUST be caught and added to <code>AbortResult</code></p>
    645. 

  645. </li>
    646. 

  646. </ul><section>
    647. 

  647. <h4><a name="Returned_AbortResult"></a>Returned <code>AbortResult</code></h4>
    648. 

  648. <p>The <code>AbortResult</code> value returned is primarily for testing and logging.</p>
    649. 

  649. <p><code>alreadyClosed()</code>: MUST return <code>true</code> if the write had already been aborted or closed;</p>
    650. 

  650. <p><code>anyCleanupException();</code>: SHOULD return any IOException raised during any optional cleanup operations.</p></section></section><section>
    651. 

  651. <h3><a name="Thread_safety_and_atomicity"></a>Thread safety and atomicity</h3>
    652. 

  652. <p>Output streams themselves aren&#x2019;t formally required to  be thread safe, but as applications do sometimes assume they are, this call MUST be thread safe.</p></section></section><section>
    653. 

  653. <h2><a name="Path.2FStream_capability_.E2.80.9Cfs.capability.outputstream.abortable.E2.80.9D"></a>Path/Stream capability &#x201c;fs.capability.outputstream.abortable&#x201d;</h2>
    654. 

  654. <p>An application MUST be able to verify that a stream supports the <code>Abortable.abort()</code> operation without actually calling it. This is done through the <code>StreamCapabilities</code> interface.</p>
    655. 

  655. <ol style="list-style-type: decimal">
    656. 

  656. 

  657. <li>
    658. 

  658. 

  659. <p>If a stream instance supports <code>Abortable</code> then it MUST return <code>true</code> in the probe <code>hasCapability(&quot;fs.capability.outputstream.abortable&quot;)</code></p>
    660. 

  660. </li>
    661. 

  661. <li>
    662. 

  662. 

  663. <p>If a stream instance does not support <code>Abortable</code> then it MUST return <code>false</code> in the probe <code>hasCapability(&quot;fs.capability.outputstream.abortable&quot;)</code></p>
    664. 

  664. </li>
    665. 

  665. </ol>
    666. 

  666. <p>That is: if a stream declares its support for the feature, a call to <code>abort()</code> SHALL meet the defined semantics of the operation.</p>
    667. 

  667. <p>FileSystem/FileContext implementations SHOULD declare support similarly, to allow for applications to probe for the feature in the destination directory/path.</p>
    668. 

  668. <p>If a filesystem supports <code>Abortable</code> under a path <code>P</code> then it SHOULD return <code>true</code> to <code>PathCababilities.hasPathCapability(path, &quot;fs.capability.outputstream.abortable&quot;)</code> This is to allow applications to verify that the store supports the feature.</p>
    669. 

  669. <p>If a filesystem does not support <code>Abortable</code> under a path <code>P</code> then it MUST return <code>false</code> to <code>PathCababilities.hasPathCapability(path, &quot;fs.capability.outputstream.abortable&quot;)</code></p></section>
    670. 

  670.       </div>
    671. 

  671.     </div>
    672. 

  672.     <div class="clear">
    673. 

  673.       <hr/>
    674. 

  674.     </div>
    675. 

  675.     <div id="footer">
    676. 

  676.       <div class="xright">
    677. 

  677.         &#169;            2008-2025
    678. 

  678.               Apache Software Foundation
    679. 

  679.             
    680. 

  680.                           - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.
    681. 

  681.         Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation.
    682. 

  682.       </div>
    683. 

  683.       <div class="clear">
    684. 

  684.         <hr/>
    685. 

  685.       </div>
    686. 

  686.     </div>
    687. 

  687.   </body>
    688. 

  688. </html>
    689.