@cparra/apexdocs 3.0.0 → 3.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (264) hide show
  1. package/README.md +11 -5
  2. package/dist/cli/generate.js +1 -1
  3. package/dist/index.js +1 -1
  4. package/dist/logger-BATX7-be.js +3278 -0
  5. package/package.json +4 -1
  6. package/.github/workflows/ci.yaml +0 -22
  7. package/.github/workflows/close_stale.yml +0 -22
  8. package/.prettierrc.js +0 -7
  9. package/__mocks__/chalk.js +0 -12
  10. package/__mocks__/log-update.js +0 -6
  11. package/eslint.config.mjs +0 -10
  12. package/examples/README.md +0 -5
  13. package/examples/docsify/README.md +0 -17
  14. package/examples/docsify/apexdocs.config.ts +0 -13
  15. package/examples/docsify/classes/ASampleClass.cls +0 -57
  16. package/examples/docsify/classes/CodeControl.cls +0 -19
  17. package/examples/docsify/classes/SampleClass.cls +0 -95
  18. package/examples/docsify/classes/SampleInterface.cls +0 -17
  19. package/examples/docsify/classes/SomeDto.cls +0 -122
  20. package/examples/docsify/docs/.nojekyll +0 -0
  21. package/examples/docsify/docs/README.md +0 -25
  22. package/examples/docsify/docs/_config.yml +0 -1
  23. package/examples/docsify/docs/index.html +0 -22
  24. package/examples/docsify/docs/miscellaneous/ASampleClass.md +0 -88
  25. package/examples/docsify/docs/miscellaneous/CodeControl.md +0 -107
  26. package/examples/docsify/docs/miscellaneous/SomeDto.md +0 -244
  27. package/examples/docsify/docs/sample-classes/SampleClass.md +0 -171
  28. package/examples/docsify/docs/sample-interfaces/SampleInterface.md +0 -36
  29. package/examples/docsify/package-lock.json +0 -2459
  30. package/examples/docsify/package.json +0 -14
  31. package/examples/imported/.forceignore +0 -12
  32. package/examples/imported/README.md +0 -6
  33. package/examples/imported/config/project-scratch-def.json +0 -5
  34. package/examples/imported/docs/index.md +0 -109
  35. package/examples/imported/docs/miscellaneous/BaseClass.md +0 -13
  36. package/examples/imported/docs/miscellaneous/MultiInheritanceClass.md +0 -69
  37. package/examples/imported/docs/miscellaneous/ParentInterface.md +0 -12
  38. package/examples/imported/docs/miscellaneous/ReferencedEnum.md +0 -5
  39. package/examples/imported/docs/miscellaneous/SampleException.md +0 -21
  40. package/examples/imported/docs/miscellaneous/SampleInterface.md +0 -113
  41. package/examples/imported/docs/miscellaneous/Url.md +0 -308
  42. package/examples/imported/docs/sample-enums/SampleEnum.md +0 -33
  43. package/examples/imported/docs/samplegroup/SampleClass.md +0 -167
  44. package/examples/imported/force-app/classes/BaseClass.cls +0 -3
  45. package/examples/imported/force-app/classes/MultiInheritanceClass.cls +0 -1
  46. package/examples/imported/force-app/classes/ParentInterface.cls +0 -3
  47. package/examples/imported/force-app/classes/ReferencedEnum.cls +0 -3
  48. package/examples/imported/force-app/classes/SampleClass.cls +0 -72
  49. package/examples/imported/force-app/classes/SampleEnum.cls +0 -30
  50. package/examples/imported/force-app/classes/SampleException.cls +0 -17
  51. package/examples/imported/force-app/classes/SampleInterface.cls +0 -50
  52. package/examples/imported/force-app/classes/Url.cls +0 -196
  53. package/examples/imported/package-lock.json +0 -665
  54. package/examples/imported/package.json +0 -6
  55. package/examples/imported/scripts/process-docs.mjs +0 -16
  56. package/examples/imported/sfdx-project.json +0 -12
  57. package/examples/markdown/.forceignore +0 -12
  58. package/examples/markdown/README.md +0 -7
  59. package/examples/markdown/config/project-scratch-def.json +0 -5
  60. package/examples/markdown/docs/index.md +0 -109
  61. package/examples/markdown/docs/miscellaneous/BaseClass.md +0 -16
  62. package/examples/markdown/docs/miscellaneous/MultiInheritanceClass.md +0 -72
  63. package/examples/markdown/docs/miscellaneous/ParentInterface.md +0 -15
  64. package/examples/markdown/docs/miscellaneous/ReferencedEnum.md +0 -8
  65. package/examples/markdown/docs/miscellaneous/SampleException.md +0 -24
  66. package/examples/markdown/docs/miscellaneous/SampleInterface.md +0 -116
  67. package/examples/markdown/docs/miscellaneous/Url.md +0 -311
  68. package/examples/markdown/docs/sample-enums/SampleEnum.md +0 -36
  69. package/examples/markdown/docs/samplegroup/SampleClass.md +0 -170
  70. package/examples/markdown/force-app/classes/BaseClass.cls +0 -3
  71. package/examples/markdown/force-app/classes/MultiInheritanceClass.cls +0 -1
  72. package/examples/markdown/force-app/classes/ParentInterface.cls +0 -3
  73. package/examples/markdown/force-app/classes/ReferencedEnum.cls +0 -3
  74. package/examples/markdown/force-app/classes/SampleClass.cls +0 -72
  75. package/examples/markdown/force-app/classes/SampleEnum.cls +0 -30
  76. package/examples/markdown/force-app/classes/SampleException.cls +0 -17
  77. package/examples/markdown/force-app/classes/SampleInterface.cls +0 -50
  78. package/examples/markdown/force-app/classes/Url.cls +0 -196
  79. package/examples/markdown/package-lock.json +0 -665
  80. package/examples/markdown/package.json +0 -20
  81. package/examples/markdown/sfdx-project.json +0 -12
  82. package/examples/markdown-jsconfig/.forceignore +0 -12
  83. package/examples/markdown-jsconfig/README.md +0 -9
  84. package/examples/markdown-jsconfig/apexdocs.config.mjs +0 -22
  85. package/examples/markdown-jsconfig/config/project-scratch-def.json +0 -5
  86. package/examples/markdown-jsconfig/docs/index.md +0 -12
  87. package/examples/markdown-jsconfig/docs/miscellaneous/Url.md +0 -315
  88. package/examples/markdown-jsconfig/force-app/classes/Url.cls +0 -196
  89. package/examples/markdown-jsconfig/package-lock.json +0 -665
  90. package/examples/markdown-jsconfig/package.json +0 -15
  91. package/examples/markdown-jsconfig/sfdx-project.json +0 -12
  92. package/examples/open-api/README.md +0 -5
  93. package/examples/open-api/config/project-scratch-def.json +0 -13
  94. package/examples/open-api/docs/openapi.json +0 -14
  95. package/examples/open-api/force-app/main/default/classes/ChildClass.cls +0 -42
  96. package/examples/open-api/force-app/main/default/classes/SampleClass.cls +0 -167
  97. package/examples/open-api/force-app/main/default/restapi/SampleRestResource.cls +0 -195
  98. package/examples/open-api/force-app/main/default/restapi/SampleRestResourceToSkip.cls +0 -35
  99. package/examples/open-api/force-app/main/default/restapi/SampleRestResourceWithInnerClass.cls +0 -24
  100. package/examples/open-api/force-app/main/default/restapi/SampleRestResourceWithoutApexDocs.cls +0 -15
  101. package/examples/open-api/force-app/main/default/restapi/references/Reference1.cls +0 -9
  102. package/examples/open-api/force-app/main/default/restapi/references/Reference2.cls +0 -9
  103. package/examples/open-api/force-app/main/default/restapi/references/Reference3.cls +0 -3
  104. package/examples/open-api/force-app/main/default/restapi/references/Reference4.cls +0 -3
  105. package/examples/open-api/force-app/main/default/restapi/references/Reference5.cls +0 -3
  106. package/examples/open-api/force-app/main/default/restapi/references/Reference6.cls +0 -6
  107. package/examples/open-api/force-app/main/default/restapi/references/Reference7.cls +0 -3
  108. package/examples/open-api/package-lock.json +0 -724
  109. package/examples/open-api/package.json +0 -20
  110. package/examples/open-api/sfdx-project.json +0 -12
  111. package/examples/vitepress/.forceignore +0 -12
  112. package/examples/vitepress/README.md +0 -25
  113. package/examples/vitepress/apexdocs.config.ts +0 -113
  114. package/examples/vitepress/config/project-scratch-def.json +0 -13
  115. package/examples/vitepress/docs/.vitepress/cache/deps/@theme_index.js +0 -259
  116. package/examples/vitepress/docs/.vitepress/cache/deps/@theme_index.js.map +0 -7
  117. package/examples/vitepress/docs/.vitepress/cache/deps/_metadata.json +0 -40
  118. package/examples/vitepress/docs/.vitepress/cache/deps/chunk-574YRH25.js +0 -11474
  119. package/examples/vitepress/docs/.vitepress/cache/deps/chunk-574YRH25.js.map +0 -7
  120. package/examples/vitepress/docs/.vitepress/cache/deps/chunk-E5DZZB2I.js +0 -9172
  121. package/examples/vitepress/docs/.vitepress/cache/deps/chunk-E5DZZB2I.js.map +0 -7
  122. package/examples/vitepress/docs/.vitepress/cache/deps/package.json +0 -3
  123. package/examples/vitepress/docs/.vitepress/cache/deps/vitepress___@vue_devtools-api.js +0 -4339
  124. package/examples/vitepress/docs/.vitepress/cache/deps/vitepress___@vue_devtools-api.js.map +0 -7
  125. package/examples/vitepress/docs/.vitepress/cache/deps/vitepress___@vueuse_core.js +0 -567
  126. package/examples/vitepress/docs/.vitepress/cache/deps/vitepress___@vueuse_core.js.map +0 -7
  127. package/examples/vitepress/docs/.vitepress/cache/deps/vue.js +0 -323
  128. package/examples/vitepress/docs/.vitepress/cache/deps/vue.js.map +0 -7
  129. package/examples/vitepress/docs/.vitepress/config.mts +0 -21
  130. package/examples/vitepress/docs/.vitepress/sidebar.json +0 -119
  131. package/examples/vitepress/docs/api-examples.md +0 -49
  132. package/examples/vitepress/docs/index-frontmatter.md +0 -16
  133. package/examples/vitepress/docs/index.md +0 -56
  134. package/examples/vitepress/docs/markdown-examples.md +0 -85
  135. package/examples/vitepress/docs/miscellaneous/BaseClass.md +0 -20
  136. package/examples/vitepress/docs/miscellaneous/MultiInheritanceClass.md +0 -76
  137. package/examples/vitepress/docs/miscellaneous/ParentInterface.md +0 -19
  138. package/examples/vitepress/docs/miscellaneous/ReferencedEnum.md +0 -15
  139. package/examples/vitepress/docs/miscellaneous/SampleException.md +0 -28
  140. package/examples/vitepress/docs/miscellaneous/SampleInterface.md +0 -116
  141. package/examples/vitepress/docs/miscellaneous/Url.md +0 -317
  142. package/examples/vitepress/docs/sample-enums/SampleEnum.md +0 -40
  143. package/examples/vitepress/docs/samplegroup/SampleClass.md +0 -174
  144. package/examples/vitepress/force-app/main/default/classes/BaseClass.cls +0 -3
  145. package/examples/vitepress/force-app/main/default/classes/MultiInheritanceClass.cls +0 -1
  146. package/examples/vitepress/force-app/main/default/classes/ParentInterface.cls +0 -3
  147. package/examples/vitepress/force-app/main/default/classes/ReferencedEnum.cls +0 -5
  148. package/examples/vitepress/force-app/main/default/classes/Url.cls +0 -198
  149. package/examples/vitepress/force-app/main/default/classes/feature-a/SampleClass.cls +0 -73
  150. package/examples/vitepress/force-app/main/default/classes/feature-a/SampleEnum.cls +0 -30
  151. package/examples/vitepress/force-app/main/default/classes/feature-a/SampleException.cls +0 -17
  152. package/examples/vitepress/force-app/main/default/classes/feature-a/SampleInterface.cls +0 -46
  153. package/examples/vitepress/package-lock.json +0 -2574
  154. package/examples/vitepress/package.json +0 -18
  155. package/examples/vitepress/sfdx-project.json +0 -12
  156. package/jest.config.js +0 -10
  157. package/jest.d.ts +0 -7
  158. package/src/application/Apexdocs.ts +0 -69
  159. package/src/application/__tests__/apex-file-reader.spec.ts +0 -128
  160. package/src/application/apex-file-reader.ts +0 -56
  161. package/src/application/file-system.ts +0 -69
  162. package/src/application/file-writer.ts +0 -43
  163. package/src/application/generators/markdown.ts +0 -45
  164. package/src/application/generators/openapi.ts +0 -75
  165. package/src/cli/args.ts +0 -55
  166. package/src/cli/commands/markdown.ts +0 -56
  167. package/src/cli/commands/openapi.ts +0 -36
  168. package/src/cli/generate.ts +0 -32
  169. package/src/core/__test__/manifest.spec.ts +0 -16
  170. package/src/core/manifest.ts +0 -90
  171. package/src/core/markdown/__test__/expect-extensions.ts +0 -32
  172. package/src/core/markdown/__test__/generating-class-docs.spec.ts +0 -362
  173. package/src/core/markdown/__test__/generating-docs.spec.ts +0 -378
  174. package/src/core/markdown/__test__/generating-enum-docs.spec.ts +0 -61
  175. package/src/core/markdown/__test__/generating-interface-docs.spec.ts +0 -169
  176. package/src/core/markdown/__test__/generating-reference-guide.spec.ts +0 -196
  177. package/src/core/markdown/__test__/inheritance-chain.test.ts +0 -54
  178. package/src/core/markdown/__test__/test-helpers.ts +0 -25
  179. package/src/core/markdown/adapters/__tests__/documentables.spec.ts +0 -109
  180. package/src/core/markdown/adapters/__tests__/interface-adapter.spec.ts +0 -150
  181. package/src/core/markdown/adapters/__tests__/link-generator.spec.ts +0 -130
  182. package/src/core/markdown/adapters/__tests__/references.spec.ts +0 -136
  183. package/src/core/markdown/adapters/apex-types.ts +0 -238
  184. package/src/core/markdown/adapters/documentables.ts +0 -115
  185. package/src/core/markdown/adapters/fields-and-properties.ts +0 -45
  186. package/src/core/markdown/adapters/generate-link.ts +0 -82
  187. package/src/core/markdown/adapters/inline.ts +0 -143
  188. package/src/core/markdown/adapters/methods-and-constructors.ts +0 -133
  189. package/src/core/markdown/adapters/reference-guide.ts +0 -37
  190. package/src/core/markdown/adapters/renderable-bundle.ts +0 -61
  191. package/src/core/markdown/adapters/renderable-to-page-data.ts +0 -91
  192. package/src/core/markdown/adapters/type-utils.ts +0 -13
  193. package/src/core/markdown/adapters/types.d.ts +0 -180
  194. package/src/core/markdown/generate-docs.ts +0 -210
  195. package/src/core/markdown/reflection/__test__/filter-scope.spec.ts +0 -290
  196. package/src/core/markdown/reflection/__test__/helpers.ts +0 -18
  197. package/src/core/markdown/reflection/__test__/remove-excluded-tags.spec.ts +0 -200
  198. package/src/core/markdown/reflection/filter-scope.ts +0 -13
  199. package/src/core/markdown/reflection/inheritance-chain-expanion.ts +0 -22
  200. package/src/core/markdown/reflection/inheritance-chain.ts +0 -23
  201. package/src/core/markdown/reflection/inherited-member-expansion.ts +0 -105
  202. package/src/core/markdown/reflection/reflect-source.ts +0 -123
  203. package/src/core/markdown/reflection/remove-excluded-tags.ts +0 -168
  204. package/src/core/markdown/reflection/sort-types-and-members.ts +0 -61
  205. package/src/core/markdown/templates/class-template.ts +0 -75
  206. package/src/core/markdown/templates/constructors-partial-template.ts +0 -32
  207. package/src/core/markdown/templates/documentable-partial-template.ts +0 -26
  208. package/src/core/markdown/templates/enum-template.ts +0 -12
  209. package/src/core/markdown/templates/fieldsPartialTemplate.ts +0 -23
  210. package/src/core/markdown/templates/grouped-members-partial-template.ts +0 -6
  211. package/src/core/markdown/templates/hookable.ts +0 -7
  212. package/src/core/markdown/templates/interface-template.ts +0 -16
  213. package/src/core/markdown/templates/methods-partial-template.ts +0 -43
  214. package/src/core/markdown/templates/reference-guide.ts +0 -14
  215. package/src/core/markdown/templates/template.ts +0 -114
  216. package/src/core/markdown/templates/type-doc-partial.ts +0 -27
  217. package/src/core/markdown/utils.ts +0 -3
  218. package/src/core/openApiSettings.ts +0 -41
  219. package/src/core/openapi/__tests__/manifest-factory.spec.ts +0 -16
  220. package/src/core/openapi/__tests__/open-api-docs-processor.spec.ts +0 -59
  221. package/src/core/openapi/__tests__/open-api.spec.ts +0 -22
  222. package/src/core/openapi/apex-doc-types.ts +0 -26
  223. package/src/core/openapi/apex-type-wrappers/ClassMirrorWrapper.ts +0 -12
  224. package/src/core/openapi/apex-type-wrappers/MethodMirrorWrapper.ts +0 -11
  225. package/src/core/openapi/apex-type-wrappers/__tests__/ClassMirrorWrapper.spec.ts +0 -15
  226. package/src/core/openapi/file-container.ts +0 -13
  227. package/src/core/openapi/manifest-factory.ts +0 -16
  228. package/src/core/openapi/open-api-docs-processor.ts +0 -93
  229. package/src/core/openapi/open-api-types.ts +0 -119
  230. package/src/core/openapi/open-api.ts +0 -45
  231. package/src/core/openapi/openapi-type-file.ts +0 -12
  232. package/src/core/openapi/parser.ts +0 -163
  233. package/src/core/openapi/parsers/Builder.ts +0 -40
  234. package/src/core/openapi/parsers/MethodParser.ts +0 -249
  235. package/src/core/openapi/parsers/ParameterObjectBuilder.ts +0 -13
  236. package/src/core/openapi/parsers/ReferenceBuilder.ts +0 -299
  237. package/src/core/openapi/parsers/RequestBodyBuilder.ts +0 -19
  238. package/src/core/openapi/parsers/ResponsesBuilder.ts +0 -21
  239. package/src/core/openapi/parsers/__tests__/MethodParser.spec.ts +0 -44
  240. package/src/core/openapi/parsers/__tests__/ParameterObjectBuilder.spec.ts +0 -68
  241. package/src/core/openapi/parsers/__tests__/ReferenceBuilder.spec.ts +0 -751
  242. package/src/core/openapi/parsers/__tests__/RequestBodyBuilder.spec.ts +0 -64
  243. package/src/core/openapi/parsers/__tests__/ResponsesBuilder.spec.ts +0 -55
  244. package/src/core/openapi/transpiler.ts +0 -17
  245. package/src/core/openapi/types-repository.ts +0 -54
  246. package/src/core/parse-apex-metadata.ts +0 -30
  247. package/src/core/shared/types.d.ts +0 -150
  248. package/src/core/shared/utils.ts +0 -5
  249. package/src/defaults.ts +0 -21
  250. package/src/index.ts +0 -110
  251. package/src/test-helpers/AnnotationBuilder.ts +0 -29
  252. package/src/test-helpers/ClassMirrorBuilder.ts +0 -69
  253. package/src/test-helpers/DocCommentAnnotationBuilder.ts +0 -24
  254. package/src/test-helpers/DocCommentBuilder.ts +0 -36
  255. package/src/test-helpers/FieldMirrorBuilder.ts +0 -59
  256. package/src/test-helpers/InterfaceMirrorBuilder.ts +0 -39
  257. package/src/test-helpers/MethodMirrorBuilder.ts +0 -77
  258. package/src/test-helpers/SettingsBuilder.ts +0 -17
  259. package/src/util/error-logger.ts +0 -92
  260. package/src/util/fp.ts +0 -3
  261. package/src/util/logger.ts +0 -51
  262. package/src/util/string-utils.ts +0 -7
  263. package/tsconfig.json +0 -25
  264. package/tslint.json +0 -6
@@ -1,76 +0,0 @@
1
- ---
2
- title: MultiInheritanceClass
3
- ---
4
-
5
- # MultiInheritanceClass Class
6
-
7
- ## Namespace
8
- apexdocs
9
-
10
- **Inheritance**
11
-
12
- [SampleClass](../samplegroup/SampleClass) < [BaseClass](BaseClass)
13
-
14
- ## Fields
15
- ### `sampleEnumFromBase`
16
-
17
- *Inherited*
18
-
19
- #### Signature
20
- ```apex
21
- public sampleEnumFromBase
22
- ```
23
-
24
- #### Type
25
- [SampleEnum](../sample-enums/SampleEnum)
26
-
27
- ## Properties
28
- ### Group Name
29
- #### `someProperty`
30
-
31
- *Inherited*
32
-
33
- ##### Signature
34
- ```apex
35
- public someProperty
36
- ```
37
-
38
- ##### Type
39
- String
40
-
41
- ## Methods
42
- ### Available Methods
43
- #### `doSomething()`
44
-
45
- *Inherited*
46
-
47
- ##### Signature
48
- ```apex
49
- public void doSomething()
50
- ```
51
-
52
- ##### Return Type
53
- **void**
54
-
55
- ### Deprecated Methods
56
- #### `sayHello()`
57
-
58
- *Inherited*
59
-
60
- `DEPRECATED`
61
-
62
- This is a sample method.
63
-
64
- ##### Signature
65
- ```apex
66
- public virtual String sayHello()
67
- ```
68
-
69
- ##### Return Type
70
- **String**
71
-
72
- A string value.
73
-
74
- ##### Example
75
- SampleClass sample &#x3D; new SampleClass();
76
- sample.doSomething();
@@ -1,19 +0,0 @@
1
- ---
2
- title: ParentInterface
3
- ---
4
-
5
- # ParentInterface Interface
6
-
7
- ## Namespace
8
- apexdocs
9
-
10
- ## Methods
11
- ### `sampleParentMethod()`
12
-
13
- #### Signature
14
- ```apex
15
- public void sampleParentMethod()
16
- ```
17
-
18
- #### Return Type
19
- **void**
@@ -1,15 +0,0 @@
1
- ---
2
- title: ReferencedEnum
3
- ---
4
-
5
- # ReferencedEnum Enum
6
-
7
- ## Namespace
8
- apexdocs
9
-
10
- ## Values
11
- | Value | Description |
12
- |-------|-------------|
13
- | VALUE1 | |
14
- | VALUE2 | |
15
- | VALUE3 | |
@@ -1,28 +0,0 @@
1
- ---
2
- title: SampleException
3
- ---
4
-
5
- # SampleException Class
6
-
7
- This is a sample exception.
8
-
9
- **Usage**
10
-
11
- You can use the exception the following way.
12
- You can also take a look at [SampleClass](../samplegroup/SampleClass) to see how it is used.
13
- This is a dangerous HTML tag: &lt;script&gt;alert(&#x27;Hello&#x27;);&lt;/script&gt;
14
-
15
- ```apex
16
- try {
17
- throw new SampleException();
18
- } catch (SampleException e) {
19
- System.debug('Caught exception');
20
- }
21
- ```
22
-
23
- ## Namespace
24
- apexdocs
25
-
26
- **Inheritance**
27
-
28
- Exception
@@ -1,116 +0,0 @@
1
- ---
2
- title: SampleInterface
3
- ---
4
-
5
- # SampleInterface Interface
6
-
7
- `NAMESPACEACCESSIBLE`
8
-
9
- This is a sample interface
10
-
11
- **Mermaid**
12
-
13
- graph TD
14
- A[SampleInterface] --&gt;|extends| B[ParentInterface]
15
- B --&gt;|extends| C[GrandParentInterface]
16
- C --&gt;|extends| D[GreatGrandParentInterface]
17
-
18
- **Author** John Doe
19
-
20
- **Date** 2020-01-01
21
-
22
- **See** [SampleEnum](../sample-enums/SampleEnum)
23
-
24
- **See** [ReferencedEnum](ReferencedEnum)
25
-
26
- ## Namespace
27
- apexdocs
28
-
29
- ## Example
30
- SampleInterface sampleInterface &#x3D; new SampleInterface();
31
- sampleInterface.sampleMethod();
32
-
33
- **Extends**
34
- [ParentInterface](ParentInterface)
35
-
36
- ## Methods
37
- ### `sampleMethod()`
38
-
39
- `NAMESPACEACCESSIBLE`
40
-
41
- This is a sample method
42
-
43
- **Custom Tag**
44
-
45
- This is a custom tag
46
-
47
- **Another Custom Tag**
48
-
49
- This is another custom tag
50
-
51
- **Mermaid**
52
-
53
- graph TD
54
- A[SampleInterface] --&gt;|extends| B[ParentInterface]
55
- B --&gt;|extends| C[GrandParentInterface]
56
- C --&gt;|extends| D[GreatGrandParentInterface]
57
-
58
- #### Signature
59
- ```apex
60
- public String sampleMethod()
61
- ```
62
-
63
- #### Return Type
64
- **String**
65
-
66
- Some return value
67
-
68
- #### Throws
69
- [SampleException](SampleException): This is a sample exception
70
-
71
- AnotherSampleException: This is another sample exception
72
-
73
- #### Example
74
- SampleInterface sampleInterface &#x3D; new SampleInterface();
75
- sampleInterface.sampleMethod();
76
-
77
- ---
78
-
79
- ### `sampleMethodWithParams(param1, param2, theEnum)`
80
-
81
- `NAMESPACEACCESSIBLE`
82
- `DEPRECATED`
83
-
84
- This is a sample method with parameters
85
- Sometimes it won&#x27;t be possible to find a NonExistent link.
86
-
87
- #### Signature
88
- ```apex
89
- public SampleEnum sampleMethodWithParams(String param1, Integer param2, SampleEnum theEnum)
90
- ```
91
-
92
- #### Parameters
93
- | Name | Type | Description |
94
- |------|------|-------------|
95
- | param1 | String | This is the first parameter |
96
- | param2 | Integer | This is the second parameter |
97
- | theEnum | [SampleEnum](../sample-enums/SampleEnum) | This is an enum parameter |
98
-
99
- #### Return Type
100
- **[SampleEnum](../sample-enums/SampleEnum)**
101
-
102
- Some return value
103
-
104
- ---
105
-
106
- ### `sampleParentMethod()`
107
-
108
- *Inherited*
109
-
110
- #### Signature
111
- ```apex
112
- public void sampleParentMethod()
113
- ```
114
-
115
- #### Return Type
116
- **void**
@@ -1,317 +0,0 @@
1
- ---
2
- title: Url
3
- ---
4
-
5
- # Url Class
6
-
7
- Represents a uniform resource locator (URL) and provides access to parts of the URL.
8
- Enables access to the base URL used to access your Salesforce org.
9
-
10
- **Usage**
11
-
12
- Use the methods of the `System.URL` class to create links to objects in your organization. Such objects can be files, images,
13
- logos, or records that you want to include in external emails, in activities, or in Chatter posts. For example, you can create
14
- a link to a file uploaded as an attachment to a Chatter post by concatenating the Salesforce base URL with the file ID:
15
-
16
- ```apex
17
- // Get a file uploaded through Chatter.
18
- ContentDocument doc = [SELECT Id FROM ContentDocument
19
- WHERE Title = 'myfile'];
20
- // Create a link to the file.
21
- String fullFileURL = URL.getOrgDomainURL().toExternalForm() +
22
- '/' + doc.id;
23
- System.debug(fullFileURL);
24
- ```
25
-
26
-
27
- The following example creates a link to a Salesforce record. The full URL is created by concatenating the Salesforce base
28
- URL with the record ID.
29
-
30
- ```apex
31
- Account acct = [SELECT Id FROM Account WHERE Name = 'Acme' LIMIT 1];
32
- String fullRecordURL = URL.getOrgDomainURL().toExternalForm() + '/' + acct.Id;
33
- ```
34
-
35
- **Version Behavior Changes**
36
-
37
- In API version 41.0 and later, Apex URL objects are represented by the java.net.URI type, not the java.net.URL type.
38
-
39
- The API version in which the URL object was instantiated determines the behavior of subsequent method calls to the
40
- specific instance. Salesforce strongly encourages you to use API 41.0 and later versions for fully RFC-compliant URL
41
- parsing that includes proper handling of edge cases of complex URL structures. API 41.0 and later versions also enforce
42
- that inputs are valid, RFC-compliant URL or URI strings.
43
-
44
- * [URL Constructors](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_url.htm#apex_System_URL_constructors)
45
- * [URL Methods](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_url.htm#apex_System_URL_methods)
46
-
47
- **See Also**
48
- * [URL Class](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_classes_url.htm)
49
-
50
- ## Namespace
51
- apexdocs
52
-
53
- ## Example
54
- In this example, the base URL and the full request URL of the current Salesforce server instance are retrieved. Next, a URL
55
- pointing to a specific account object is created. Finally, components of the base and full URL are obtained. This example
56
- prints out all the results to the debug log output.
57
-
58
- ```apex
59
- // Create a new account called Acme that we will create a link for later.
60
- Account myAccount = new Account(Name='Acme');
61
- insert myAccount;
62
-
63
- // Get the base URL.
64
- String sfdcBaseURL = URL.getOrgDomainURL().toExternalForm();
65
- System.debug('Base URL: ' + sfdcBaseURL );
66
-
67
- // Get the URL for the current request.
68
- String currentRequestURL = URL.getCurrentRequestUrl().toExternalForm();
69
- System.debug('Current request URL: ' + currentRequestURL);
70
-
71
- // Create the account URL from the base URL.
72
- String accountURL = URL.getOrgDomainURL().toExternalForm() +
73
- '/' + myAccount.Id;
74
- System.debug('URL of a particular account: ' + accountURL);
75
-
76
- // Get some parts of the base URL.
77
- System.debug('Host: ' + URL.getOrgDomainURL().getHost());
78
- System.debug('Protocol: ' + URL.getOrgDomainURL().getProtocol());
79
-
80
- // Get the query string of the current request.
81
- System.debug('Query: ' + URL.getCurrentRequestUrl().getQuery());
82
- ```
83
-
84
- ## Constructors
85
- ### `Url(spec)`
86
-
87
- Creates a new instance of the URL class using the specified string representation of the URL.
88
-
89
- #### Signature
90
- ```apex
91
- global Url(String spec)
92
- ```
93
-
94
- #### Parameters
95
- | Name | Type | Description |
96
- |------|------|-------------|
97
- | spec | String | The string to parse as a URL. |
98
-
99
- ---
100
-
101
- ### `Url(context, spec)`
102
-
103
- Creates a new instance of the URL class by parsing the specified spec within the specified context.
104
-
105
- **Usage**
106
-
107
- The new URL is created from the given context URL and the spec argument as described in RFC2396 &quot;Uniform Resource Identifiers : Generic * Syntax&quot; :
108
- ```xml
109
- <scheme>://<authority><path>?<query>#<fragment>
110
- ```
111
-
112
-
113
- For more information about the arguments of this constructor, see the corresponding URL(java.net.URL, java.lang.String) constructor for Java.
114
-
115
- #### Signature
116
- ```apex
117
- global Url(Url context, String spec)
118
- ```
119
-
120
- #### Parameters
121
- | Name | Type | Description |
122
- |------|------|-------------|
123
- | context | [Url](Url) | The context in which to parse the specification. |
124
- | spec | String | The string to parse as a URL. |
125
-
126
- ---
127
-
128
- ### `Url(protocol, host, file)`
129
-
130
- Creates a new instance of the URL class using the specified protocol, host, and file on the host. The default port for the specified protocol is used.
131
-
132
- #### Signature
133
- ```apex
134
- global Url(String protocol, String host, String file)
135
- ```
136
-
137
- #### Parameters
138
- | Name | Type | Description |
139
- |------|------|-------------|
140
- | protocol | String | The protocol name for this URL. |
141
- | host | String | The host name for this URL. |
142
- | file | String | The file name for this URL. |
143
-
144
- ---
145
-
146
- ### `Url(protocol, host, port, file)`
147
-
148
- Creates a new instance of the URL class using the specified protocol, host, port number, and file on the host.
149
-
150
- #### Signature
151
- ```apex
152
- global Url(String protocol, String host, Integer port, String file)
153
- ```
154
-
155
- #### Parameters
156
- | Name | Type | Description |
157
- |------|------|-------------|
158
- | protocol | String | The protocol name for this URL. |
159
- | host | String | The host name for this URL. |
160
- | port | Integer | The port number for this URL. |
161
- | file | String | The file name for this URL. |
162
-
163
- ## Methods
164
- ### `getAuthority()`
165
-
166
- Returns the authority portion of the current URL.
167
-
168
- #### Signature
169
- ```apex
170
- global String getAuthority()
171
- ```
172
-
173
- #### Return Type
174
- **String**
175
-
176
- The authority portion of the current URL.
177
-
178
- ---
179
-
180
- ### `getCurrentRequestUrl()`
181
-
182
- Returns the URL of an entire request on a Salesforce instance.
183
-
184
- **Usage**
185
-
186
- An example of a URL for an entire request is https://yourInstance.salesforce.com/apex/myVfPage.apexp.
187
-
188
- #### Signature
189
- ```apex
190
- global static Url getCurrentRequestUrl()
191
- ```
192
-
193
- #### Return Type
194
- **[Url](Url)**
195
-
196
- The URL of the entire request.
197
-
198
- ---
199
-
200
- ### `getDefPort()`
201
-
202
- Returns the default port number of the protocol associated with the current URL.
203
-
204
- **Usage**
205
-
206
- Returns -1 if the URL scheme or the stream protocol handler for the URL doesn&#x27;t define a default port number.
207
-
208
- #### Signature
209
- ```apex
210
- global Integer getDefPort()
211
- ```
212
-
213
- #### Return Type
214
- **Integer**
215
-
216
- The default port number of the protocol associated with the current URL.
217
-
218
- ---
219
-
220
- ### `getFile()`
221
-
222
- Returns the file name of the current URL.
223
-
224
- #### Signature
225
- ```apex
226
- global String getFile()
227
- ```
228
-
229
- #### Return Type
230
- **String**
231
-
232
- The file name of the current URL.
233
-
234
- ---
235
-
236
- ### `getFileFieldURL(entityId, fieldName)`
237
-
238
- Returns the download URL for a file attachment.
239
-
240
- #### Signature
241
- ```apex
242
- global static String getFileFieldURL(String entityId, String fieldName)
243
- ```
244
-
245
- #### Parameters
246
- | Name | Type | Description |
247
- |------|------|-------------|
248
- | entityId | String | Specifies the ID of the entity that holds the file data. |
249
- | fieldName | String | Specifies the API name of a file field component, such as `AttachmentBody` . |
250
-
251
- #### Return Type
252
- **String**
253
-
254
- The download URL for the file attachment.
255
-
256
- #### Example
257
- String fileURL &#x3D;
258
- URL.getFileFieldURL(
259
- &#x27;087000000000123&#x27; ,
260
- &#x27;AttachmentBody&#x27;);
261
-
262
- ---
263
-
264
- ### `getHost()`
265
-
266
- Returns the host name of the current URL.
267
-
268
- #### Signature
269
- ```apex
270
- global String getHost()
271
- ```
272
-
273
- #### Return Type
274
- **String**
275
-
276
- The host name of the current URL.
277
-
278
- ---
279
-
280
- ### `getOrgDomainUrl()`
281
-
282
- Returns the canonical URL for your org. For example, https://MyDomainName.my.salesforce.com.
283
-
284
- **Usage**
285
-
286
- Use getOrgDomainUrl() to interact with Salesforce REST and SOAP APIs in Apex code. Get endpoints for User Interface API calls, for creating and customizing picklist value sets and custom fields, and more.
287
-
288
- `getOrgDomainUrl()` can access the domain URL only for the org in which the Apex code is running.
289
-
290
- You don&#x27;t need a RemoteSiteSetting for your org to interact with the Salesforce APIs using domain URLs retrieved with this method.
291
-
292
- **See Also**
293
-
294
- * [Lightning Aura Components Developer Guide: Making API Calls from Apex](https://developer.salesforce.com/docs/atlas.en-us.250.0.lightning.meta/lightning/apex_api_calls.htm)
295
-
296
- #### Signature
297
- ```apex
298
- global static Url getOrgDomainUrl()
299
- ```
300
-
301
- #### Return Type
302
- **[Url](Url)**
303
-
304
- getOrgDomainUrl() always returns the login URL for your org, regardless of context. Use that URL when making API calls to your org.
305
-
306
- #### Example
307
- This example uses the Salesforce REST API to get organization limit values. For information on limits, see Limits in the REST API Developer Guide.
308
-
309
- ```apex
310
- Http h = new Http();
311
- HttpRequest req = new HttpRequest();
312
- req.setEndpoint(Url.getOrgDomainUrl().toExternalForm()
313
- + '/services/data/v44.0/limits');
314
- req.setMethod('GET');
315
- req.setHeader('Authorization', 'Bearer ' + UserInfo.getSessionId());
316
- HttpResponse res = h.send(req);
317
- ```
@@ -1,40 +0,0 @@
1
- ---
2
- title: SampleEnum
3
- ---
4
-
5
- # SampleEnum Enum
6
-
7
- `NAMESPACEACCESSIBLE`
8
-
9
- This is a sample enum. This references [ReferencedEnum](../miscellaneous/ReferencedEnum) .
10
-
11
- This description has several lines
12
-
13
- **Some Custom**
14
-
15
- Test. I can also have a [ReferencedEnum](../miscellaneous/ReferencedEnum) here.
16
- And it can be multiline.
17
-
18
- **Mermaid**
19
-
20
- graph TD
21
- A[SampleEnum] --&gt;|references| B[ReferencedEnum]
22
- B --&gt;|referenced by| A
23
-
24
- **Group** Sample Enums
25
-
26
- **Author** John Doe
27
-
28
- **Date** 2022-01-01
29
-
30
- **See** [ReferencedEnum](../miscellaneous/ReferencedEnum)
31
-
32
- ## Namespace
33
- apexdocs
34
-
35
- ## Values
36
- | Value | Description |
37
- |-------|-------------|
38
- | VALUE1 | This is value 1 |
39
- | VALUE2 | This is value 2 |
40
- | VALUE3 | This is value 3 |