From 4554f22c870fa7f1e79b9261fdebc2ecbf8a570c Mon Sep 17 00:00:00 2001 From: LZX <1820455493@qq.com> Date: Mon, 14 Sep 2026 00:06:49 +0800 Subject: [PATCH] 2 --- analysis_options.yaml | 1 + lib/l10n/app_en.arb | 163 +- lib/l10n/app_localizations.dart | 500 +- lib/l10n/app_localizations_en.dart | 390 +- lib/l10n/app_localizations_zh.dart | 387 +- lib/l10n/app_zh.arb | 169 +- lib/main.dart | 42 +- lib/models/app_font.dart | 7 +- lib/models/run_task.dart | 108 + lib/models/terminal_session.dart | 56 +- lib/models/virtual_keyboard_config.dart | 552 +- lib/providers/project_provider.dart | 14 + lib/providers/run_provider.dart | 158 + lib/providers/settings_provider.dart | 211 +- lib/providers/terminal_provider.dart | 28 + lib/services/file_service.dart | 4 +- lib/services/project_task_detector.dart | 279 + lib/services/run_task_storage_service.dart | 97 + lib/utils/app_theme.dart | 32 + lib/utils/terminal_theme_helper.dart | 38 + lib/views/main_view.dart | 185 +- lib/views/run_task_detail_view.dart | 204 + lib/views/run_task_edit_view.dart | 337 + lib/views/settings_view.dart | 203 +- lib/views/terminal_view.dart | 112 +- lib/views/virtual_keyboard_config_view.dart | 47 +- lib/widgets/code_editor_app_bar.dart | 125 +- lib/widgets/code_editor_menu.dart | 94 +- lib/widgets/code_editor_tab_bar.dart | 32 +- lib/widgets/code_editor_widget.dart | 2 + lib/widgets/color_palette_dialog.dart | 470 + lib/widgets/distro_selector_dialog.dart | 16 +- lib/widgets/file_item_widget.dart | 14 +- lib/widgets/run_tasks_dialog.dart | 262 + lib/widgets/terminal_drawer.dart | 9 +- lib/widgets/terminal_keyboard_sink.dart | 112 + lib/widgets/terminal_modifier_state.dart | 148 + lib/widgets/terminal_session_item_widget.dart | 26 +- .../virtual_keyboard_key_edit_dialog.dart | 346 +- .../virtual_keyboard_page_config_section.dart | 36 +- lib/widgets/virtual_keyboard_sink.dart | 172 + lib/widgets/virtual_keyboard_widget.dart | 232 +- packages/re_editor/CHANGELOG.md | 105 + packages/re_editor/LICENSE | 21 + packages/re_editor/README.md | 202 + packages/re_editor/README_CN.md | 196 + packages/re_editor/analysis_options.yaml | 4 + packages/re_editor/arts/art01.gif | Bin 0 -> 3722598 bytes packages/re_editor/arts/art02.png | Bin 0 -> 351173 bytes .../example/android/app/build.gradle | 67 + .../android/app/src/debug/AndroidManifest.xml | 7 + .../android/app/src/main/AndroidManifest.xml | 33 + .../com/example/example/MainActivity.kt | 6 + .../res/drawable-v21/launch_background.xml | 12 + .../main/res/drawable/launch_background.xml | 12 + .../src/main/res/mipmap-hdpi/ic_launcher.png | Bin 0 -> 544 bytes .../src/main/res/mipmap-mdpi/ic_launcher.png | Bin 0 -> 442 bytes .../src/main/res/mipmap-xhdpi/ic_launcher.png | Bin 0 -> 721 bytes .../main/res/mipmap-xxhdpi/ic_launcher.png | Bin 0 -> 1031 bytes .../main/res/mipmap-xxxhdpi/ic_launcher.png | Bin 0 -> 1443 bytes .../app/src/main/res/values-night/styles.xml | 18 + .../app/src/main/res/values/styles.xml | 18 + .../app/src/profile/AndroidManifest.xml | 7 + .../re_editor/example/android/build.gradle | 30 + .../example/android/gradle.properties | 3 + .../gradle/wrapper/gradle-wrapper.properties | 5 + .../re_editor/example/android/settings.gradle | 29 + packages/re_editor/example/assets/code.dart | 16 + packages/re_editor/example/assets/code.json | 152 + packages/re_editor/example/assets/large.txt | 108162 +++++++++++++++ .../ios/Flutter/AppFrameworkInfo.plist | 26 + .../example/ios/Flutter/Debug.xcconfig | 1 + .../example/ios/Flutter/Release.xcconfig | 1 + .../ios/Runner.xcodeproj/project.pbxproj | 617 + .../contents.xcworkspacedata | 7 + .../xcshareddata/IDEWorkspaceChecks.plist | 8 + .../xcshareddata/WorkspaceSettings.xcsettings | 8 + .../xcshareddata/xcschemes/Runner.xcscheme | 98 + .../contents.xcworkspacedata | 7 + .../xcshareddata/IDEWorkspaceChecks.plist | 8 + .../xcshareddata/WorkspaceSettings.xcsettings | 8 + .../example/ios/Runner/AppDelegate.swift | 13 + .../AppIcon.appiconset/Contents.json | 122 + .../Icon-App-1024x1024@1x.png | Bin 0 -> 10932 bytes .../AppIcon.appiconset/Icon-App-20x20@1x.png | Bin 0 -> 295 bytes .../AppIcon.appiconset/Icon-App-20x20@2x.png | Bin 0 -> 406 bytes .../AppIcon.appiconset/Icon-App-20x20@3x.png | Bin 0 -> 450 bytes .../AppIcon.appiconset/Icon-App-29x29@1x.png | Bin 0 -> 282 bytes .../AppIcon.appiconset/Icon-App-29x29@2x.png | Bin 0 -> 462 bytes .../AppIcon.appiconset/Icon-App-29x29@3x.png | Bin 0 -> 704 bytes .../AppIcon.appiconset/Icon-App-40x40@1x.png | Bin 0 -> 406 bytes .../AppIcon.appiconset/Icon-App-40x40@2x.png | Bin 0 -> 586 bytes .../AppIcon.appiconset/Icon-App-40x40@3x.png | Bin 0 -> 862 bytes .../AppIcon.appiconset/Icon-App-60x60@2x.png | Bin 0 -> 862 bytes .../AppIcon.appiconset/Icon-App-60x60@3x.png | Bin 0 -> 1674 bytes .../AppIcon.appiconset/Icon-App-76x76@1x.png | Bin 0 -> 762 bytes .../AppIcon.appiconset/Icon-App-76x76@2x.png | Bin 0 -> 1226 bytes .../Icon-App-83.5x83.5@2x.png | Bin 0 -> 1418 bytes .../LaunchImage.imageset/Contents.json | 23 + .../LaunchImage.imageset/LaunchImage.png | Bin 0 -> 68 bytes .../LaunchImage.imageset/LaunchImage@2x.png | Bin 0 -> 68 bytes .../LaunchImage.imageset/LaunchImage@3x.png | Bin 0 -> 68 bytes .../LaunchImage.imageset/README.md | 5 + .../Runner/Base.lproj/LaunchScreen.storyboard | 37 + .../ios/Runner/Base.lproj/Main.storyboard | 26 + .../re_editor/example/ios/Runner/Info.plist | 49 + .../ios/Runner/Runner-Bridging-Header.h | 1 + .../example/ios/RunnerTests/RunnerTests.swift | 12 + .../example/lib/editor_autocomplete.dart | 481 + .../example/lib/editor_basic_field.dart | 16 + .../re_editor/example/lib/editor_json.dart | 69 + .../example/lib/editor_large_text.dart | 57 + packages/re_editor/example/lib/find.dart | 283 + packages/re_editor/example/lib/main.dart | 105 + packages/re_editor/example/lib/menu.dart | 65 + .../re_editor/example/linux/CMakeLists.txt | 145 + .../example/linux/flutter/CMakeLists.txt | 88 + .../flutter/generated_plugin_registrant.cc | 11 + .../flutter/generated_plugin_registrant.h | 15 + .../linux/flutter/generated_plugins.cmake | 23 + packages/re_editor/example/linux/main.cc | 6 + .../re_editor/example/linux/my_application.cc | 104 + .../re_editor/example/linux/my_application.h | 18 + .../macos/Flutter/Flutter-Debug.xcconfig | 1 + .../macos/Flutter/Flutter-Release.xcconfig | 1 + .../Flutter/GeneratedPluginRegistrant.swift | 10 + .../macos/Runner.xcodeproj/project.pbxproj | 695 + .../xcshareddata/IDEWorkspaceChecks.plist | 8 + .../xcshareddata/xcschemes/Runner.xcscheme | 98 + .../contents.xcworkspacedata | 7 + .../xcshareddata/IDEWorkspaceChecks.plist | 8 + .../example/macos/Runner/AppDelegate.swift | 9 + .../AppIcon.appiconset/Contents.json | 68 + .../AppIcon.appiconset/app_icon_1024.png | Bin 0 -> 102994 bytes .../AppIcon.appiconset/app_icon_128.png | Bin 0 -> 5680 bytes .../AppIcon.appiconset/app_icon_16.png | Bin 0 -> 520 bytes .../AppIcon.appiconset/app_icon_256.png | Bin 0 -> 14142 bytes .../AppIcon.appiconset/app_icon_32.png | Bin 0 -> 1066 bytes .../AppIcon.appiconset/app_icon_512.png | Bin 0 -> 36406 bytes .../AppIcon.appiconset/app_icon_64.png | Bin 0 -> 2218 bytes .../macos/Runner/Base.lproj/MainMenu.xib | 343 + .../macos/Runner/Configs/AppInfo.xcconfig | 14 + .../macos/Runner/Configs/Debug.xcconfig | 2 + .../macos/Runner/Configs/Release.xcconfig | 2 + .../macos/Runner/Configs/Warnings.xcconfig | 13 + .../macos/Runner/DebugProfile.entitlements | 12 + .../re_editor/example/macos/Runner/Info.plist | 32 + .../macos/Runner/MainFlutterWindow.swift | 15 + .../example/macos/Runner/Release.entitlements | 8 + .../macos/RunnerTests/RunnerTests.swift | 12 + packages/re_editor/example/pubspec.yaml | 66 + packages/re_editor/example/web/favicon.png | Bin 0 -> 917 bytes .../re_editor/example/web/icons/Icon-192.png | Bin 0 -> 5292 bytes .../re_editor/example/web/icons/Icon-512.png | Bin 0 -> 8252 bytes .../example/web/icons/Icon-maskable-192.png | Bin 0 -> 5594 bytes .../example/web/icons/Icon-maskable-512.png | Bin 0 -> 20998 bytes packages/re_editor/example/web/index.html | 59 + packages/re_editor/example/web/manifest.json | 35 + .../re_editor/example/windows/CMakeLists.txt | 108 + .../example/windows/flutter/CMakeLists.txt | 109 + .../flutter/generated_plugin_registrant.cc | 11 + .../flutter/generated_plugin_registrant.h | 15 + .../windows/flutter/generated_plugins.cmake | 23 + .../example/windows/runner/CMakeLists.txt | 40 + .../example/windows/runner/Runner.rc | 121 + .../example/windows/runner/flutter_window.cpp | 71 + .../example/windows/runner/flutter_window.h | 33 + .../re_editor/example/windows/runner/main.cpp | 43 + .../example/windows/runner/resource.h | 16 + .../windows/runner/resources/app_icon.ico | Bin 0 -> 33772 bytes .../windows/runner/runner.exe.manifest | 20 + .../example/windows/runner/utils.cpp | 65 + .../re_editor/example/windows/runner/utils.h | 19 + .../example/windows/runner/win32_window.cpp | 288 + .../example/windows/runner/win32_window.h | 102 + packages/re_editor/lib/re_editor.dart | 1 + .../re_editor/lib/src/_code_autocomplete.dart | 323 + .../re_editor/lib/src/_code_editable.dart | 489 + .../re_editor/lib/src/_code_extensions.dart | 44 + packages/re_editor/lib/src/_code_field.dart | 1991 + packages/re_editor/lib/src/_code_find.dart | 525 + .../lib/src/_code_floating_cursor.dart | 149 + .../re_editor/lib/src/_code_formatter.dart | 795 + .../re_editor/lib/src/_code_highlight.dart | 337 + .../re_editor/lib/src/_code_indicator.dart | 373 + packages/re_editor/lib/src/_code_input.dart | 756 + packages/re_editor/lib/src/_code_line.dart | 2504 + packages/re_editor/lib/src/_code_lines.dart | 36 + .../re_editor/lib/src/_code_paragraph.dart | 326 + packages/re_editor/lib/src/_code_scroll.dart | 142 + .../re_editor/lib/src/_code_selection.dart | 1276 + .../re_editor/lib/src/_code_shortcuts.dart | 334 + packages/re_editor/lib/src/_code_span.dart | 38 + packages/re_editor/lib/src/_consts.dart | 5 + packages/re_editor/lib/src/_isolate.dart | 38 + .../re_editor/lib/src/code_autocomplete.dart | 310 + packages/re_editor/lib/src/code_chunk.dart | 363 + packages/re_editor/lib/src/code_editor.dart | 641 + packages/re_editor/lib/src/code_find.dart | 224 + .../re_editor/lib/src/code_formatter.dart | 21 + .../re_editor/lib/src/code_indicator.dart | 202 + packages/re_editor/lib/src/code_line.dart | 1192 + packages/re_editor/lib/src/code_lines.dart | 461 + .../re_editor/lib/src/code_paragraph.dart | 28 + packages/re_editor/lib/src/code_scroll.dart | 36 + .../re_editor/lib/src/code_shortcuts.dart | 605 + packages/re_editor/lib/src/code_span.dart | 26 + packages/re_editor/lib/src/code_theme.dart | 90 + packages/re_editor/lib/src/code_toolbar.dart | 34 + packages/re_editor/lib/src/debug/_trace.dart | 22 + packages/re_editor/lib/src/re_editor.dart | 52 + packages/re_editor/pubspec.yaml | 20 + .../code_chunk_default_analyzer_test.dart | 609 + packages/re_editor/test/code_chunk_test.dart | 936 + .../code_line_editing_controller_test.dart | 4694 + .../test/code_line_editing_value_test.dart | 253 + .../test/code_line_extension_test.dart | 40 + .../test/code_line_position_test.dart | 110 + .../re_editor/test/code_line_range_test.dart | 128 + .../test/code_line_selection_test.dart | 647 + packages/re_editor/test/code_line_test.dart | 266 + packages/re_editor/test/code_lines_test.dart | 1075 + .../test/code_search_controller_test.dart | 986 + .../test/code_search_option_test.dart | 121 + .../test/code_search_result_test.dart | 661 + .../test/code_search_value_test.dart | 221 + .../re_editor/test/data/json_flatted.json | 1 + packages/re_editor/test/data/json_pretty.json | 18 + pubspec.lock | 7 +- pubspec.yaml | 3 +- test/run_system_test.dart | 82 + test/terminal_test.dart | 210 +- test/widget_test.dart | 1468 +- 233 files changed, 147430 insertions(+), 605 deletions(-) create mode 100644 lib/models/run_task.dart create mode 100644 lib/providers/run_provider.dart create mode 100644 lib/services/project_task_detector.dart create mode 100644 lib/services/run_task_storage_service.dart create mode 100644 lib/utils/app_theme.dart create mode 100644 lib/utils/terminal_theme_helper.dart create mode 100644 lib/views/run_task_detail_view.dart create mode 100644 lib/views/run_task_edit_view.dart create mode 100644 lib/widgets/color_palette_dialog.dart create mode 100644 lib/widgets/run_tasks_dialog.dart create mode 100644 lib/widgets/terminal_keyboard_sink.dart create mode 100644 lib/widgets/terminal_modifier_state.dart create mode 100644 lib/widgets/virtual_keyboard_sink.dart create mode 100644 packages/re_editor/CHANGELOG.md create mode 100644 packages/re_editor/LICENSE create mode 100644 packages/re_editor/README.md create mode 100644 packages/re_editor/README_CN.md create mode 100644 packages/re_editor/analysis_options.yaml create mode 100644 packages/re_editor/arts/art01.gif create mode 100644 packages/re_editor/arts/art02.png create mode 100644 packages/re_editor/example/android/app/build.gradle create mode 100644 packages/re_editor/example/android/app/src/debug/AndroidManifest.xml create mode 100644 packages/re_editor/example/android/app/src/main/AndroidManifest.xml create mode 100644 packages/re_editor/example/android/app/src/main/kotlin/com/example/example/MainActivity.kt create mode 100644 packages/re_editor/example/android/app/src/main/res/drawable-v21/launch_background.xml create mode 100644 packages/re_editor/example/android/app/src/main/res/drawable/launch_background.xml create mode 100644 packages/re_editor/example/android/app/src/main/res/mipmap-hdpi/ic_launcher.png create mode 100644 packages/re_editor/example/android/app/src/main/res/mipmap-mdpi/ic_launcher.png create mode 100644 packages/re_editor/example/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png create mode 100644 packages/re_editor/example/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png create mode 100644 packages/re_editor/example/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png create mode 100644 packages/re_editor/example/android/app/src/main/res/values-night/styles.xml create mode 100644 packages/re_editor/example/android/app/src/main/res/values/styles.xml create mode 100644 packages/re_editor/example/android/app/src/profile/AndroidManifest.xml create mode 100644 packages/re_editor/example/android/build.gradle create mode 100644 packages/re_editor/example/android/gradle.properties create mode 100644 packages/re_editor/example/android/gradle/wrapper/gradle-wrapper.properties create mode 100644 packages/re_editor/example/android/settings.gradle create mode 100644 packages/re_editor/example/assets/code.dart create mode 100644 packages/re_editor/example/assets/code.json create mode 100644 packages/re_editor/example/assets/large.txt create mode 100644 packages/re_editor/example/ios/Flutter/AppFrameworkInfo.plist create mode 100644 packages/re_editor/example/ios/Flutter/Debug.xcconfig create mode 100644 packages/re_editor/example/ios/Flutter/Release.xcconfig create mode 100644 packages/re_editor/example/ios/Runner.xcodeproj/project.pbxproj create mode 100644 packages/re_editor/example/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata create mode 100644 packages/re_editor/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist create mode 100644 packages/re_editor/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings create mode 100644 packages/re_editor/example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme create mode 100644 packages/re_editor/example/ios/Runner.xcworkspace/contents.xcworkspacedata create mode 100644 packages/re_editor/example/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist create mode 100644 packages/re_editor/example/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings create mode 100644 packages/re_editor/example/ios/Runner/AppDelegate.swift create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@3x.png create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@1x.png create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@3x.png create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@1x.png create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@2x.png create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png create mode 100644 packages/re_editor/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md create mode 100644 packages/re_editor/example/ios/Runner/Base.lproj/LaunchScreen.storyboard create mode 100644 packages/re_editor/example/ios/Runner/Base.lproj/Main.storyboard create mode 100644 packages/re_editor/example/ios/Runner/Info.plist create mode 100644 packages/re_editor/example/ios/Runner/Runner-Bridging-Header.h create mode 100644 packages/re_editor/example/ios/RunnerTests/RunnerTests.swift create mode 100644 packages/re_editor/example/lib/editor_autocomplete.dart create mode 100644 packages/re_editor/example/lib/editor_basic_field.dart create mode 100644 packages/re_editor/example/lib/editor_json.dart create mode 100644 packages/re_editor/example/lib/editor_large_text.dart create mode 100644 packages/re_editor/example/lib/find.dart create mode 100644 packages/re_editor/example/lib/main.dart create mode 100644 packages/re_editor/example/lib/menu.dart create mode 100644 packages/re_editor/example/linux/CMakeLists.txt create mode 100644 packages/re_editor/example/linux/flutter/CMakeLists.txt create mode 100644 packages/re_editor/example/linux/flutter/generated_plugin_registrant.cc create mode 100644 packages/re_editor/example/linux/flutter/generated_plugin_registrant.h create mode 100644 packages/re_editor/example/linux/flutter/generated_plugins.cmake create mode 100644 packages/re_editor/example/linux/main.cc create mode 100644 packages/re_editor/example/linux/my_application.cc create mode 100644 packages/re_editor/example/linux/my_application.h create mode 100644 packages/re_editor/example/macos/Flutter/Flutter-Debug.xcconfig create mode 100644 packages/re_editor/example/macos/Flutter/Flutter-Release.xcconfig create mode 100644 packages/re_editor/example/macos/Flutter/GeneratedPluginRegistrant.swift create mode 100644 packages/re_editor/example/macos/Runner.xcodeproj/project.pbxproj create mode 100644 packages/re_editor/example/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist create mode 100644 packages/re_editor/example/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme create mode 100644 packages/re_editor/example/macos/Runner.xcworkspace/contents.xcworkspacedata create mode 100644 packages/re_editor/example/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist create mode 100644 packages/re_editor/example/macos/Runner/AppDelegate.swift create mode 100644 packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json create mode 100644 packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png create mode 100644 packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png create mode 100644 packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png create mode 100644 packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_256.png create mode 100644 packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_32.png create mode 100644 packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_512.png create mode 100644 packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png create mode 100644 packages/re_editor/example/macos/Runner/Base.lproj/MainMenu.xib create mode 100644 packages/re_editor/example/macos/Runner/Configs/AppInfo.xcconfig create mode 100644 packages/re_editor/example/macos/Runner/Configs/Debug.xcconfig create mode 100644 packages/re_editor/example/macos/Runner/Configs/Release.xcconfig create mode 100644 packages/re_editor/example/macos/Runner/Configs/Warnings.xcconfig create mode 100644 packages/re_editor/example/macos/Runner/DebugProfile.entitlements create mode 100644 packages/re_editor/example/macos/Runner/Info.plist create mode 100644 packages/re_editor/example/macos/Runner/MainFlutterWindow.swift create mode 100644 packages/re_editor/example/macos/Runner/Release.entitlements create mode 100644 packages/re_editor/example/macos/RunnerTests/RunnerTests.swift create mode 100644 packages/re_editor/example/pubspec.yaml create mode 100644 packages/re_editor/example/web/favicon.png create mode 100644 packages/re_editor/example/web/icons/Icon-192.png create mode 100644 packages/re_editor/example/web/icons/Icon-512.png create mode 100644 packages/re_editor/example/web/icons/Icon-maskable-192.png create mode 100644 packages/re_editor/example/web/icons/Icon-maskable-512.png create mode 100644 packages/re_editor/example/web/index.html create mode 100644 packages/re_editor/example/web/manifest.json create mode 100644 packages/re_editor/example/windows/CMakeLists.txt create mode 100644 packages/re_editor/example/windows/flutter/CMakeLists.txt create mode 100644 packages/re_editor/example/windows/flutter/generated_plugin_registrant.cc create mode 100644 packages/re_editor/example/windows/flutter/generated_plugin_registrant.h create mode 100644 packages/re_editor/example/windows/flutter/generated_plugins.cmake create mode 100644 packages/re_editor/example/windows/runner/CMakeLists.txt create mode 100644 packages/re_editor/example/windows/runner/Runner.rc create mode 100644 packages/re_editor/example/windows/runner/flutter_window.cpp create mode 100644 packages/re_editor/example/windows/runner/flutter_window.h create mode 100644 packages/re_editor/example/windows/runner/main.cpp create mode 100644 packages/re_editor/example/windows/runner/resource.h create mode 100644 packages/re_editor/example/windows/runner/resources/app_icon.ico create mode 100644 packages/re_editor/example/windows/runner/runner.exe.manifest create mode 100644 packages/re_editor/example/windows/runner/utils.cpp create mode 100644 packages/re_editor/example/windows/runner/utils.h create mode 100644 packages/re_editor/example/windows/runner/win32_window.cpp create mode 100644 packages/re_editor/example/windows/runner/win32_window.h create mode 100644 packages/re_editor/lib/re_editor.dart create mode 100644 packages/re_editor/lib/src/_code_autocomplete.dart create mode 100644 packages/re_editor/lib/src/_code_editable.dart create mode 100644 packages/re_editor/lib/src/_code_extensions.dart create mode 100644 packages/re_editor/lib/src/_code_field.dart create mode 100644 packages/re_editor/lib/src/_code_find.dart create mode 100644 packages/re_editor/lib/src/_code_floating_cursor.dart create mode 100644 packages/re_editor/lib/src/_code_formatter.dart create mode 100644 packages/re_editor/lib/src/_code_highlight.dart create mode 100644 packages/re_editor/lib/src/_code_indicator.dart create mode 100644 packages/re_editor/lib/src/_code_input.dart create mode 100644 packages/re_editor/lib/src/_code_line.dart create mode 100644 packages/re_editor/lib/src/_code_lines.dart create mode 100644 packages/re_editor/lib/src/_code_paragraph.dart create mode 100644 packages/re_editor/lib/src/_code_scroll.dart create mode 100644 packages/re_editor/lib/src/_code_selection.dart create mode 100644 packages/re_editor/lib/src/_code_shortcuts.dart create mode 100644 packages/re_editor/lib/src/_code_span.dart create mode 100644 packages/re_editor/lib/src/_consts.dart create mode 100644 packages/re_editor/lib/src/_isolate.dart create mode 100644 packages/re_editor/lib/src/code_autocomplete.dart create mode 100644 packages/re_editor/lib/src/code_chunk.dart create mode 100644 packages/re_editor/lib/src/code_editor.dart create mode 100644 packages/re_editor/lib/src/code_find.dart create mode 100644 packages/re_editor/lib/src/code_formatter.dart create mode 100644 packages/re_editor/lib/src/code_indicator.dart create mode 100644 packages/re_editor/lib/src/code_line.dart create mode 100644 packages/re_editor/lib/src/code_lines.dart create mode 100644 packages/re_editor/lib/src/code_paragraph.dart create mode 100644 packages/re_editor/lib/src/code_scroll.dart create mode 100644 packages/re_editor/lib/src/code_shortcuts.dart create mode 100644 packages/re_editor/lib/src/code_span.dart create mode 100644 packages/re_editor/lib/src/code_theme.dart create mode 100644 packages/re_editor/lib/src/code_toolbar.dart create mode 100644 packages/re_editor/lib/src/debug/_trace.dart create mode 100644 packages/re_editor/lib/src/re_editor.dart create mode 100644 packages/re_editor/pubspec.yaml create mode 100644 packages/re_editor/test/code_chunk_default_analyzer_test.dart create mode 100644 packages/re_editor/test/code_chunk_test.dart create mode 100644 packages/re_editor/test/code_line_editing_controller_test.dart create mode 100644 packages/re_editor/test/code_line_editing_value_test.dart create mode 100644 packages/re_editor/test/code_line_extension_test.dart create mode 100644 packages/re_editor/test/code_line_position_test.dart create mode 100644 packages/re_editor/test/code_line_range_test.dart create mode 100644 packages/re_editor/test/code_line_selection_test.dart create mode 100644 packages/re_editor/test/code_line_test.dart create mode 100644 packages/re_editor/test/code_lines_test.dart create mode 100644 packages/re_editor/test/code_search_controller_test.dart create mode 100644 packages/re_editor/test/code_search_option_test.dart create mode 100644 packages/re_editor/test/code_search_result_test.dart create mode 100644 packages/re_editor/test/code_search_value_test.dart create mode 100644 packages/re_editor/test/data/json_flatted.json create mode 100644 packages/re_editor/test/data/json_pretty.json create mode 100644 test/run_system_test.dart diff --git a/analysis_options.yaml b/analysis_options.yaml index bf8d421..ad438fe 100644 --- a/analysis_options.yaml +++ b/analysis_options.yaml @@ -16,6 +16,7 @@ analyzer: - windows/** - macos/** - linux/** + - packages/** include: package:flutter_lints/flutter.yaml linter: diff --git a/lib/l10n/app_en.arb b/lib/l10n/app_en.arb index 216d034..d37fc9d 100644 --- a/lib/l10n/app_en.arb +++ b/lib/l10n/app_en.arb @@ -71,6 +71,27 @@ "darkThemeCategory": "Dark Theme", "lightThemeCategory": "Light Theme", "codeFontSize": "Font Size", + "uiFont": "Interface Font", + "selectUiFont": "Select Interface Font", + "themeColor": "Theme Color", + "selectThemeColor": "Select Theme Color", + "terminalBackgroundColor": "Terminal Background", + "selectTerminalBackgroundColor": "Select Terminal Background", + "uiFontPreview": "Code Editor interface font preview 123", + "codeFont": "Code Font", + "selectCodeFont": "Select Code Font", + "codeFontPreview": "const app = \"Code Editor\"; // code preview", + "terminalFont": "Terminal Font", + "selectTerminalFont": "Select Terminal Font", + "terminalFontPreview": "$ git status -s # terminal font preview", + "fontName": "{font, select, system_default{System Default} sans_serif{Sans-Serif} serif{Serif (Songti)} monospace{System Monospace} consolas{Consolas} courier_new{Courier New} menlo{Menlo / Monaco} jetbrains_mono{JetBrains Mono} fira_code{Fira Code} other{{font}}}", + "@fontName": { + "placeholders": { + "font": { + "type": "String" + } + } + }, "decreaseFontSize": "Decrease font size", "increaseFontSize": "Increase font size", "fontSizeDialogTitle": "Editor Font Size", @@ -91,6 +112,10 @@ "virtualKeyboardSubtitle": "Show accessory symbols and shortcuts below the code editor", "editVirtualKeyboardConfig": "Edit Keyboard Config", "editVirtualKeyboardConfigSubtitle": "Customize keyboard layout and shortcuts", + "terminalVirtualKeyboard": "Terminal Accessory Keyboard", + "terminalVirtualKeyboardSubtitle": "Show special keys and command shortcuts below the terminal", + "editTerminalVirtualKeyboardConfig": "Edit Terminal Keyboard Config", + "editTerminalVirtualKeyboardConfigSubtitle": "Customize Esc / Tab / Ctrl combos and other terminal keys", "virtualKeyboardDialogTitle": "Keyboard Config (JSON)", "resetDefault": "Reset to Default", "configFormatError": "Configuration format error", @@ -361,17 +386,139 @@ "keyboardLabelFormFieldHint": "Text displayed on the key, e.g. Tab, (), A", "keyboardLabelOrIconRequiredError": "Please enter display text or select an icon", "keyboardIconFormField": "Icon (Optional)", + "keyboardIconName": "{icon, select, undo{Undo} redo{Redo} tab{Indent} untab{Outdent} outdent{Decrease Indent} arrow_left{Left Arrow} arrow_right{Right Arrow} arrow_up{Up Arrow} arrow_down{Down Arrow} home{Line Start} end{Line End} first_page{Document Start} last_page{Document End} page_up{Page Up} page_down{Page Down} enter{Enter} space{Space} escape{Escape} insert{Insert} clear{Clear} keyboard{Keyboard} backspace{Backspace} delete{Delete} copy{Copy} cut{Cut} paste{Paste} save{Save} search{Search} select_all{Select All} keyboard_hide{Hide Keyboard} other{{icon}}}", + "@keyboardIconName": { + "placeholders": { + "icon": { + "type": "String" + } + } + }, "keyboardNoIconOption": "No icon (Use text)", "keyboardActionFormField": "Action", - "keyboardValueFormField": "Input Text (Value)", + "keyboardActionName": "{action, select, input{Plain Text} pair{Pair Symbols} command{Editor Command} modifier{Modifier Key} key{Special Key} other{{action}}}", + "@keyboardActionName": { + "placeholders": { + "action": { + "type": "String" + } + } + }, + "keyboardActionInputTerminal": "Command Shortcut", + "keyboardKeyFormField": "Special Key", + "keyboardKeyGroupNavigation": "Navigation", + "keyboardKeyGroupEditing": "Editing", + "keyboardKeyGroupFunctionKeys": "Function Keys", + "keyboardKeyGroupLetters": "Letters", + "keyboardAutoEnter": "Send Enter after", + "keyboardKeyName": "{key, select, escape{Escape} tab{Tab} backtab{Backtab} returnKey{Return} enter{Enter} numpadEnter{Keypad Enter} backspace{Backspace} delete{Delete} insert{Insert} space{Space} numpadClear{Clear} arrowUp{Up} arrowDown{Down} arrowLeft{Left} arrowRight{Right} home{Home} end{End} pageUp{Page Up} pageDown{Page Down} f1{F1} f2{F2} f3{F3} f4{F4} f5{F5} f6{F6} f7{F7} f8{F8} f9{F9} f10{F10} f11{F11} f12{F12} other{{key}}}", + "@keyboardKeyName": { + "placeholders": { + "key": { + "type": "String" + } + } + }, + "keyboardKeyInvalidError": "This key produces no output in the terminal; please pick a listed special key", + "keyboardValueFormField": "Input Text", "keyboardValueFormFieldHint": "Text inserted upon click, e.g. ;, =, ->", "keyboardValueRequiredError": "Input text cannot be empty", - "keyboardPairPresetFormField": "Pair Symbols Preset (Value)", - "keyboardCommandPresetFormField": "Editor Command Preset (Value)", - "keyboardModifierPresetFormField": "Terminal Modifier (Value)", - "keyboardTerminalKeyPresetFormField": "Terminal Key (Value)", - "keyboardCursorOffsetFormField": "Cursor Relative Offset (cursorOffset)", - "keyboardCursorOffsetHelper": "e.g. For () cursor in center should move left by 1, enter -1", + "keyboardPairValueFormField": "Pair Symbols", + "keyboardPairValueFormFieldHint": "e.g. (), [], \"\", <>", + "keyboardPairValueRequiredError": "Please enter the pair symbols", + "keyboardPairValueInvalidError": "Enter at least 2 characters with different halves, e.g. (), []", + "keyboardCommandPresetFormField": "Editor Command", + "keyboardCommandName": "{command, select, tab{Indent} untab{Outdent} undo{Undo} redo{Redo} cursor_left{Cursor Left} cursor_right{Cursor Right} cursor_up{Cursor Up} cursor_down{Cursor Down} line_start{Move to Line Start} line_end{Move to Line End} page_start{Move to Document Start} page_end{Move to Document End} copy{Copy} cut{Cut} paste{Paste} delete{Delete} select_all{Select All} keyboard_hide{Hide Keyboard} other{{command}}}", + "@keyboardCommandName": { + "placeholders": { + "command": { + "type": "String" + } + } + }, + "keyboardModifierPresetFormField": "Terminal Modifier", + "keyboardModifierName": "{modifier, select, ctrl{Ctrl Key} alt{Alt Key} shift{Shift Key} other{{modifier}}}", + "@keyboardModifierName": { + "placeholders": { + "modifier": { + "type": "String" + } + } + }, + "keyboardCursorOffsetFormField": "Cursor Relative Offset", "keyboardCursorOffsetRequiredError": "Please enter cursor offset (usually -1)", - "keyboardCursorOffsetIntegerError": "Offset must be an integer" + "keyboardCursorOffsetIntegerError": "Offset must be an integer", + "recommended": "Recommended", + "presetColors": "Preset Colors", + "hexColor": "Hex Color", + "currentColor": "Current", + "newColor": "Preview", + "runTasks": "Run Tasks", + "projectDetect": "Detect Project", + "projectDetecting": "Detecting project...", + "editRunTasks": "Edit Run Tasks", + "projectSection": "Project", + "showHiddenFiles": "Show Hidden Files", + "showHiddenFilesSubtitle": "Show hidden files and folders starting with dot (.) in file tree", + "searchTasksHint": "Search tasks...", + "noTasksAvailable": "No executable tasks available", + "noMatchingTasks": "No matching tasks found", + "userCustomTasks": "User Custom Tasks", + "systemDetectedTasks": "System Detected Tasks", + "editCustomTasksTooltip": "Edit Custom Tasks", + "runTasksConfig": "Run Tasks Configuration", + "editTask": "Edit Task", + "addTask": "Add Task", + "runTasksConfigSubtitle": "Configuration will be saved to .code_editor/run_tasks.json in project root", + "noCustomTasksInProject": "No custom tasks in current project", + "createNow": "Create Now", + "saveAndApply": "Save & Apply", + "taskNameRequired": "Task Name *", + "taskNameHint": "e.g. Build & Run Debug", + "taskNameEmptyError": "Please enter task name", + "shellCommandRequired": "Shell Command *", + "shellCommandHint": "e.g. cmake -B build && cmake --build build", + "shellCommandEmptyError": "Please enter command", + "taskDescOptional": "Description (Optional)", + "taskDescHint": "Briefly describe the task purpose", + "clearBeforeRun": "Clear Screen (clear)", + "clearBeforeRunSubtitle": "Clear terminal output before executing task", + "runTasksUpdated": "Run tasks configuration updated", + "detectCompletedMessage": "Detection completed, found {count} tasks", + "@detectCompletedMessage": { + "placeholders": { + "count": { + "type": "int" + } + } + }, + "pleaseOpenProjectFirst": "Please open a project first", + "deleteTaskConfirmMessage": "Are you sure you want to delete task \"{name}\"?", + "@deleteTaskConfirmMessage": { + "placeholders": { + "name": { + "type": "String" + } + } + }, + "deleteSelectedTasksConfirmMessage": "Are you sure you want to delete the selected {count} tasks?", + "@deleteSelectedTasksConfirmMessage": { + "placeholders": { + "count": { + "type": "int" + } + } + }, + "deleteSelected": "Delete Selected", + "selectTasksToDelete": "Select Tasks to Delete", + "selectedCount": "{count} selected", + "@selectedCount": { + "placeholders": { + "count": { + "type": "int" + } + } + }, + "unsavedTaskChangesTitle": "Unsaved Task Changes", + "unsavedTaskChangesMessage": "The task has been modified. Do you want to discard unsaved changes and leave?" } \ No newline at end of file diff --git a/lib/l10n/app_localizations.dart b/lib/l10n/app_localizations.dart index 95e118e..17ae81b 100644 --- a/lib/l10n/app_localizations.dart +++ b/lib/l10n/app_localizations.dart @@ -524,6 +524,90 @@ abstract class AppLocalizations { /// **'代码字号缩放'** String get codeFontSize; + /// No description provided for @uiFont. + /// + /// In zh, this message translates to: + /// **'界面字体'** + String get uiFont; + + /// No description provided for @selectUiFont. + /// + /// In zh, this message translates to: + /// **'选择界面字体'** + String get selectUiFont; + + /// No description provided for @themeColor. + /// + /// In zh, this message translates to: + /// **'主题颜色'** + String get themeColor; + + /// No description provided for @selectThemeColor. + /// + /// In zh, this message translates to: + /// **'选择主题颜色'** + String get selectThemeColor; + + /// No description provided for @terminalBackgroundColor. + /// + /// In zh, this message translates to: + /// **'终端背景颜色'** + String get terminalBackgroundColor; + + /// No description provided for @selectTerminalBackgroundColor. + /// + /// In zh, this message translates to: + /// **'选择终端背景颜色'** + String get selectTerminalBackgroundColor; + + /// No description provided for @uiFontPreview. + /// + /// In zh, this message translates to: + /// **'代码编辑器界面字体预览 Code Editor 123'** + String get uiFontPreview; + + /// No description provided for @codeFont. + /// + /// In zh, this message translates to: + /// **'代码字体'** + String get codeFont; + + /// No description provided for @selectCodeFont. + /// + /// In zh, this message translates to: + /// **'选择代码字体'** + String get selectCodeFont; + + /// No description provided for @codeFontPreview. + /// + /// In zh, this message translates to: + /// **'const app = \"Code Editor\"; // 代码预览'** + String get codeFontPreview; + + /// No description provided for @terminalFont. + /// + /// In zh, this message translates to: + /// **'终端字体'** + String get terminalFont; + + /// No description provided for @selectTerminalFont. + /// + /// In zh, this message translates to: + /// **'选择终端字体'** + String get selectTerminalFont; + + /// No description provided for @terminalFontPreview. + /// + /// In zh, this message translates to: + /// **'\$ git status -s # 终端字体预览'** + String get terminalFontPreview; + + /// No description provided for @fontName. + /// + /// In zh, this message translates to: + /// **'{font, select, system_default{系统默认} sans_serif{无衬线体} serif{衬线体(宋体)} monospace{系统等宽} consolas{Consolas} courier_new{Courier New} menlo{Menlo / Monaco} jetbrains_mono{JetBrains Mono} fira_code{Fira Code} other{{font}}}'** + String fontName(String font); + /// No description provided for @decreaseFontSize. /// /// In zh, this message translates to: @@ -596,6 +680,30 @@ abstract class AppLocalizations { /// **'自定义小键盘按键布局与快捷键'** String get editVirtualKeyboardConfigSubtitle; + /// No description provided for @terminalVirtualKeyboard. + /// + /// In zh, this message translates to: + /// **'终端小键盘'** + String get terminalVirtualKeyboard; + + /// No description provided for @terminalVirtualKeyboardSubtitle. + /// + /// In zh, this message translates to: + /// **'在终端下方显示常用特殊键与指令快捷键'** + String get terminalVirtualKeyboardSubtitle; + + /// No description provided for @editTerminalVirtualKeyboardConfig. + /// + /// In zh, this message translates to: + /// **'编辑终端键盘配置'** + String get editTerminalVirtualKeyboardConfig; + + /// No description provided for @editTerminalVirtualKeyboardConfigSubtitle. + /// + /// In zh, this message translates to: + /// **'自定义 Esc / Tab / Ctrl 组合等终端专用按键'** + String get editTerminalVirtualKeyboardConfigSubtitle; + /// No description provided for @virtualKeyboardDialogTitle. /// /// In zh, this message translates to: @@ -1259,7 +1367,7 @@ abstract class AppLocalizations { /// No description provided for @keyboardLabelFormField. /// /// In zh, this message translates to: - /// **'显示文本 (Label)'** + /// **'显示文本'** String get keyboardLabelFormField; /// No description provided for @keyboardLabelFormFieldHint. @@ -1277,9 +1385,15 @@ abstract class AppLocalizations { /// No description provided for @keyboardIconFormField. /// /// In zh, this message translates to: - /// **'图标 (Icon, 可选)'** + /// **'图标 (可选)'** String get keyboardIconFormField; + /// No description provided for @keyboardIconName. + /// + /// In zh, this message translates to: + /// **'{icon, select, undo{撤销} redo{重做} tab{向右缩进} untab{向左缩进} outdent{减少缩进} arrow_left{左箭头} arrow_right{右箭头} arrow_up{上箭头} arrow_down{下箭头} home{移至行首} end{移至行尾} first_page{移至文首} last_page{移至文末} page_up{上翻页} page_down{下翻页} enter{回车} space{空格} escape{退出} insert{插入} clear{清除} keyboard{键盘} backspace{退格} delete{删除} copy{复制} cut{剪切} paste{粘贴} save{保存} search{搜索} select_all{全选} keyboard_hide{收起小键盘} other{{icon}}}'** + String keyboardIconName(String icon); + /// No description provided for @keyboardNoIconOption. /// /// In zh, this message translates to: @@ -1289,13 +1403,73 @@ abstract class AppLocalizations { /// No description provided for @keyboardActionFormField. /// /// In zh, this message translates to: - /// **'动作类型 (Action)'** + /// **'动作类型'** String get keyboardActionFormField; + /// No description provided for @keyboardActionName. + /// + /// In zh, this message translates to: + /// **'{action, select, input{普通文本} pair{成对符号} command{编辑器命令} modifier{修饰键} key{特殊键} other{{action}}}'** + String keyboardActionName(String action); + + /// No description provided for @keyboardActionInputTerminal. + /// + /// In zh, this message translates to: + /// **'指令快捷键'** + String get keyboardActionInputTerminal; + + /// No description provided for @keyboardKeyFormField. + /// + /// In zh, this message translates to: + /// **'特殊键'** + String get keyboardKeyFormField; + + /// No description provided for @keyboardKeyGroupNavigation. + /// + /// In zh, this message translates to: + /// **'导航键'** + String get keyboardKeyGroupNavigation; + + /// No description provided for @keyboardKeyGroupEditing. + /// + /// In zh, this message translates to: + /// **'编辑键'** + String get keyboardKeyGroupEditing; + + /// No description provided for @keyboardKeyGroupFunctionKeys. + /// + /// In zh, this message translates to: + /// **'功能键'** + String get keyboardKeyGroupFunctionKeys; + + /// No description provided for @keyboardKeyGroupLetters. + /// + /// In zh, this message translates to: + /// **'字母键'** + String get keyboardKeyGroupLetters; + + /// No description provided for @keyboardAutoEnter. + /// + /// In zh, this message translates to: + /// **'发送后自动回车'** + String get keyboardAutoEnter; + + /// No description provided for @keyboardKeyName. + /// + /// In zh, this message translates to: + /// **'{key, select, escape{退出} tab{Tab} backtab{反向制表} returnKey{回车} enter{回车} numpadEnter{小键盘回车} backspace{退格} delete{删除} insert{插入} space{空格} numpadClear{清除} arrowUp{上} arrowDown{下} arrowLeft{左} arrowRight{右} home{行首} end{行尾} pageUp{上翻页} pageDown{下翻页} f1{F1} f2{F2} f3{F3} f4{F4} f5{F5} f6{F6} f7{F7} f8{F8} f9{F9} f10{F10} f11{F11} f12{F12} other{{key}}}'** + String keyboardKeyName(String key); + + /// No description provided for @keyboardKeyInvalidError. + /// + /// In zh, this message translates to: + /// **'该键在终端中不会产生任何输出,请选择列表中的特殊键'** + String get keyboardKeyInvalidError; + /// No description provided for @keyboardValueFormField. /// /// In zh, this message translates to: - /// **'输入文本内容 (Value)'** + /// **'输入文本内容'** String get keyboardValueFormField; /// No description provided for @keyboardValueFormFieldHint. @@ -1310,42 +1484,60 @@ abstract class AppLocalizations { /// **'输入文本不能为空'** String get keyboardValueRequiredError; - /// No description provided for @keyboardPairPresetFormField. + /// No description provided for @keyboardPairValueFormField. /// /// In zh, this message translates to: - /// **'成对符号预设 (Value)'** - String get keyboardPairPresetFormField; + /// **'成对符号'** + String get keyboardPairValueFormField; + + /// No description provided for @keyboardPairValueFormFieldHint. + /// + /// In zh, this message translates to: + /// **'例如 ()、[]、\"\"、<>'** + String get keyboardPairValueFormFieldHint; + + /// No description provided for @keyboardPairValueRequiredError. + /// + /// In zh, this message translates to: + /// **'请输入成对符号'** + String get keyboardPairValueRequiredError; + + /// No description provided for @keyboardPairValueInvalidError. + /// + /// In zh, this message translates to: + /// **'请输入至少 2 个字符且左右不同的成对符号,如 ()、[]'** + String get keyboardPairValueInvalidError; /// No description provided for @keyboardCommandPresetFormField. /// /// In zh, this message translates to: - /// **'预设编辑器命令 (Value)'** + /// **'编辑器命令'** String get keyboardCommandPresetFormField; + /// No description provided for @keyboardCommandName. + /// + /// In zh, this message translates to: + /// **'{command, select, tab{向右缩进} untab{向左缩进} undo{撤销} redo{重做} cursor_left{光标左移} cursor_right{光标右移} cursor_up{光标上移} cursor_down{光标下移} line_start{移动至行首} line_end{移动至行尾} page_start{移动至文首} page_end{移动至文末} copy{复制} cut{剪切} paste{粘贴} delete{删除} select_all{全选} keyboard_hide{收起小键盘} other{{command}}}'** + String keyboardCommandName(String command); + /// No description provided for @keyboardModifierPresetFormField. /// /// In zh, this message translates to: - /// **'终端修饰键 (Value)'** + /// **'终端修饰键'** String get keyboardModifierPresetFormField; - /// No description provided for @keyboardTerminalKeyPresetFormField. + /// No description provided for @keyboardModifierName. /// /// In zh, this message translates to: - /// **'终端按键 (Value)'** - String get keyboardTerminalKeyPresetFormField; + /// **'{modifier, select, ctrl{Ctrl 键} alt{Alt 键} shift{Shift 键} other{{modifier}}}'** + String keyboardModifierName(String modifier); /// No description provided for @keyboardCursorOffsetFormField. /// /// In zh, this message translates to: - /// **'光标相对偏移 (cursorOffset)'** + /// **'光标相对偏移'** String get keyboardCursorOffsetFormField; - /// No description provided for @keyboardCursorOffsetHelper. - /// - /// In zh, this message translates to: - /// **'例如 () 插入后光标居中需向左偏移 1 位,填写 -1'** - String get keyboardCursorOffsetHelper; - /// No description provided for @keyboardCursorOffsetRequiredError. /// /// In zh, this message translates to: @@ -1357,6 +1549,276 @@ abstract class AppLocalizations { /// In zh, this message translates to: /// **'偏移量必须为整数'** String get keyboardCursorOffsetIntegerError; + + /// No description provided for @recommended. + /// + /// In zh, this message translates to: + /// **'推荐'** + String get recommended; + + /// No description provided for @presetColors. + /// + /// In zh, this message translates to: + /// **'预设颜色'** + String get presetColors; + + /// No description provided for @hexColor. + /// + /// In zh, this message translates to: + /// **'十六进制颜色'** + String get hexColor; + + /// No description provided for @currentColor. + /// + /// In zh, this message translates to: + /// **'当前'** + String get currentColor; + + /// No description provided for @newColor. + /// + /// In zh, this message translates to: + /// **'预览'** + String get newColor; + + /// No description provided for @runTasks. + /// + /// In zh, this message translates to: + /// **'运行任务'** + String get runTasks; + + /// No description provided for @projectDetect. + /// + /// In zh, this message translates to: + /// **'项目探测'** + String get projectDetect; + + /// No description provided for @projectDetecting. + /// + /// In zh, this message translates to: + /// **'正在探测项目...'** + String get projectDetecting; + + /// No description provided for @editRunTasks. + /// + /// In zh, this message translates to: + /// **'运行任务编辑'** + String get editRunTasks; + + /// No description provided for @projectSection. + /// + /// In zh, this message translates to: + /// **'项目'** + String get projectSection; + + /// No description provided for @showHiddenFiles. + /// + /// In zh, this message translates to: + /// **'显示隐藏文件'** + String get showHiddenFiles; + + /// No description provided for @showHiddenFilesSubtitle. + /// + /// In zh, this message translates to: + /// **'在文件树中展示以点 (.) 开头的隐藏文件与文件夹'** + String get showHiddenFilesSubtitle; + + /// No description provided for @searchTasksHint. + /// + /// In zh, this message translates to: + /// **'搜索指定任务...'** + String get searchTasksHint; + + /// No description provided for @noTasksAvailable. + /// + /// In zh, this message translates to: + /// **'暂无可执行任务'** + String get noTasksAvailable; + + /// No description provided for @noMatchingTasks. + /// + /// In zh, this message translates to: + /// **'无匹配的任务'** + String get noMatchingTasks; + + /// No description provided for @userCustomTasks. + /// + /// In zh, this message translates to: + /// **'用户自定义任务'** + String get userCustomTasks; + + /// No description provided for @systemDetectedTasks. + /// + /// In zh, this message translates to: + /// **'系统动态探测任务'** + String get systemDetectedTasks; + + /// No description provided for @editCustomTasksTooltip. + /// + /// In zh, this message translates to: + /// **'编辑自定义任务'** + String get editCustomTasksTooltip; + + /// No description provided for @runTasksConfig. + /// + /// In zh, this message translates to: + /// **'运行任务配置'** + String get runTasksConfig; + + /// No description provided for @editTask. + /// + /// In zh, this message translates to: + /// **'编辑任务'** + String get editTask; + + /// No description provided for @addTask. + /// + /// In zh, this message translates to: + /// **'新增任务'** + String get addTask; + + /// No description provided for @runTasksConfigSubtitle. + /// + /// In zh, this message translates to: + /// **'配置将自动保存至项目根目录下的 .code_editor/run_tasks.json'** + String get runTasksConfigSubtitle; + + /// No description provided for @noCustomTasksInProject. + /// + /// In zh, this message translates to: + /// **'当前项目暂无自定义任务'** + String get noCustomTasksInProject; + + /// No description provided for @createNow. + /// + /// In zh, this message translates to: + /// **'立即创建'** + String get createNow; + + /// No description provided for @saveAndApply. + /// + /// In zh, this message translates to: + /// **'保存并应用'** + String get saveAndApply; + + /// No description provided for @taskNameRequired. + /// + /// In zh, this message translates to: + /// **'任务名称 *'** + String get taskNameRequired; + + /// No description provided for @taskNameHint. + /// + /// In zh, this message translates to: + /// **'如: 编译并运行 Debug'** + String get taskNameHint; + + /// No description provided for @taskNameEmptyError. + /// + /// In zh, this message translates to: + /// **'请输入任务名称'** + String get taskNameEmptyError; + + /// No description provided for @shellCommandRequired. + /// + /// In zh, this message translates to: + /// **'Shell 执行指令 *'** + String get shellCommandRequired; + + /// No description provided for @shellCommandHint. + /// + /// In zh, this message translates to: + /// **'如: cmake -B build && cmake --build build'** + String get shellCommandHint; + + /// No description provided for @shellCommandEmptyError. + /// + /// In zh, this message translates to: + /// **'请输入执行指令'** + String get shellCommandEmptyError; + + /// No description provided for @taskDescOptional. + /// + /// In zh, this message translates to: + /// **'任务描述(选填)'** + String get taskDescOptional; + + /// No description provided for @taskDescHint. + /// + /// In zh, this message translates to: + /// **'简要说明此任务的用途'** + String get taskDescHint; + + /// No description provided for @clearBeforeRun. + /// + /// In zh, this message translates to: + /// **'执行前清屏 (clear)'** + String get clearBeforeRun; + + /// No description provided for @clearBeforeRunSubtitle. + /// + /// In zh, this message translates to: + /// **'在终端输出任务结果前清理历史屏幕'** + String get clearBeforeRunSubtitle; + + /// No description provided for @runTasksUpdated. + /// + /// In zh, this message translates to: + /// **'运行任务配置已更新'** + String get runTasksUpdated; + + /// No description provided for @detectCompletedMessage. + /// + /// In zh, this message translates to: + /// **'探测完成,发现 {count} 个可用任务'** + String detectCompletedMessage(int count); + + /// No description provided for @pleaseOpenProjectFirst. + /// + /// In zh, this message translates to: + /// **'请先打开一个项目'** + String get pleaseOpenProjectFirst; + + /// No description provided for @deleteTaskConfirmMessage. + /// + /// In zh, this message translates to: + /// **'确定要删除任务 \"{name}\" 吗?'** + String deleteTaskConfirmMessage(String name); + + /// No description provided for @deleteSelectedTasksConfirmMessage. + /// + /// In zh, this message translates to: + /// **'确定要删除选中的 {count} 个任务吗?'** + String deleteSelectedTasksConfirmMessage(int count); + + /// No description provided for @deleteSelected. + /// + /// In zh, this message translates to: + /// **'删除选中'** + String get deleteSelected; + + /// No description provided for @selectTasksToDelete. + /// + /// In zh, this message translates to: + /// **'选择要删除的任务'** + String get selectTasksToDelete; + + /// No description provided for @selectedCount. + /// + /// In zh, this message translates to: + /// **'已选 {count} 项'** + String selectedCount(int count); + + /// No description provided for @unsavedTaskChangesTitle. + /// + /// In zh, this message translates to: + /// **'未保存的任务更改'** + String get unsavedTaskChangesTitle; + + /// No description provided for @unsavedTaskChangesMessage. + /// + /// In zh, this message translates to: + /// **'当前任务内容已被修改,是否放弃未保存的修改并返回?'** + String get unsavedTaskChangesMessage; } class _AppLocalizationsDelegate diff --git a/lib/l10n/app_localizations_en.dart b/lib/l10n/app_localizations_en.dart index 960c009..95b0882 100644 --- a/lib/l10n/app_localizations_en.dart +++ b/lib/l10n/app_localizations_en.dart @@ -241,6 +241,62 @@ class AppLocalizationsEn extends AppLocalizations { @override String get codeFontSize => 'Font Size'; + @override + String get uiFont => 'Interface Font'; + + @override + String get selectUiFont => 'Select Interface Font'; + + @override + String get themeColor => 'Theme Color'; + + @override + String get selectThemeColor => 'Select Theme Color'; + + @override + String get terminalBackgroundColor => 'Terminal Background'; + + @override + String get selectTerminalBackgroundColor => 'Select Terminal Background'; + + @override + String get uiFontPreview => 'Code Editor interface font preview 123'; + + @override + String get codeFont => 'Code Font'; + + @override + String get selectCodeFont => 'Select Code Font'; + + @override + String get codeFontPreview => 'const app = \"Code Editor\"; // code preview'; + + @override + String get terminalFont => 'Terminal Font'; + + @override + String get selectTerminalFont => 'Select Terminal Font'; + + @override + String get terminalFontPreview => '\$ git status -s # terminal font preview'; + + @override + String fontName(String font) { + String _temp0 = intl.Intl.selectLogic(font, { + 'system_default': 'System Default', + 'sans_serif': 'Sans-Serif', + 'serif': 'Serif (Songti)', + 'monospace': 'System Monospace', + 'consolas': 'Consolas', + 'courier_new': 'Courier New', + 'menlo': 'Menlo / Monaco', + 'jetbrains_mono': 'JetBrains Mono', + 'fira_code': 'Fira Code', + 'other': '$font', + }); + return '$_temp0'; + } + @override String get decreaseFontSize => 'Decrease font size'; @@ -281,6 +337,21 @@ class AppLocalizationsEn extends AppLocalizations { String get editVirtualKeyboardConfigSubtitle => 'Customize keyboard layout and shortcuts'; + @override + String get terminalVirtualKeyboard => 'Terminal Accessory Keyboard'; + + @override + String get terminalVirtualKeyboardSubtitle => + 'Show special keys and command shortcuts below the terminal'; + + @override + String get editTerminalVirtualKeyboardConfig => + 'Edit Terminal Keyboard Config'; + + @override + String get editTerminalVirtualKeyboardConfigSubtitle => + 'Customize Esc / Tab / Ctrl combos and other terminal keys'; + @override String get virtualKeyboardDialogTitle => 'Keyboard Config (JSON)'; @@ -683,6 +754,44 @@ class AppLocalizationsEn extends AppLocalizations { @override String get keyboardIconFormField => 'Icon (Optional)'; + @override + String keyboardIconName(String icon) { + String _temp0 = intl.Intl.selectLogic(icon, { + 'undo': 'Undo', + 'redo': 'Redo', + 'tab': 'Indent', + 'untab': 'Outdent', + 'outdent': 'Decrease Indent', + 'arrow_left': 'Left Arrow', + 'arrow_right': 'Right Arrow', + 'arrow_up': 'Up Arrow', + 'arrow_down': 'Down Arrow', + 'home': 'Line Start', + 'end': 'Line End', + 'first_page': 'Document Start', + 'last_page': 'Document End', + 'page_up': 'Page Up', + 'page_down': 'Page Down', + 'enter': 'Enter', + 'space': 'Space', + 'escape': 'Escape', + 'insert': 'Insert', + 'clear': 'Clear', + 'keyboard': 'Keyboard', + 'backspace': 'Backspace', + 'delete': 'Delete', + 'copy': 'Copy', + 'cut': 'Cut', + 'paste': 'Paste', + 'save': 'Save', + 'search': 'Search', + 'select_all': 'Select All', + 'keyboard_hide': 'Hide Keyboard', + 'other': '$icon', + }); + return '$_temp0'; + } + @override String get keyboardNoIconOption => 'No icon (Use text)'; @@ -690,7 +799,84 @@ class AppLocalizationsEn extends AppLocalizations { String get keyboardActionFormField => 'Action'; @override - String get keyboardValueFormField => 'Input Text (Value)'; + String keyboardActionName(String action) { + String _temp0 = intl.Intl.selectLogic(action, { + 'input': 'Plain Text', + 'pair': 'Pair Symbols', + 'command': 'Editor Command', + 'modifier': 'Modifier Key', + 'key': 'Special Key', + 'other': '$action', + }); + return '$_temp0'; + } + + @override + String get keyboardActionInputTerminal => 'Command Shortcut'; + + @override + String get keyboardKeyFormField => 'Special Key'; + + @override + String get keyboardKeyGroupNavigation => 'Navigation'; + + @override + String get keyboardKeyGroupEditing => 'Editing'; + + @override + String get keyboardKeyGroupFunctionKeys => 'Function Keys'; + + @override + String get keyboardKeyGroupLetters => 'Letters'; + + @override + String get keyboardAutoEnter => 'Send Enter after'; + + @override + String keyboardKeyName(String key) { + String _temp0 = intl.Intl.selectLogic(key, { + 'escape': 'Escape', + 'tab': 'Tab', + 'backtab': 'Backtab', + 'returnKey': 'Return', + 'enter': 'Enter', + 'numpadEnter': 'Keypad Enter', + 'backspace': 'Backspace', + 'delete': 'Delete', + 'insert': 'Insert', + 'space': 'Space', + 'numpadClear': 'Clear', + 'arrowUp': 'Up', + 'arrowDown': 'Down', + 'arrowLeft': 'Left', + 'arrowRight': 'Right', + 'home': 'Home', + 'end': 'End', + 'pageUp': 'Page Up', + 'pageDown': 'Page Down', + 'f1': 'F1', + 'f2': 'F2', + 'f3': 'F3', + 'f4': 'F4', + 'f5': 'F5', + 'f6': 'F6', + 'f7': 'F7', + 'f8': 'F8', + 'f9': 'F9', + 'f10': 'F10', + 'f11': 'F11', + 'f12': 'F12', + 'other': '$key', + }); + return '$_temp0'; + } + + @override + String get keyboardKeyInvalidError => + 'This key produces no output in the terminal; please pick a listed special key'; + + @override + String get keyboardValueFormField => 'Input Text'; @override String get keyboardValueFormFieldHint => @@ -700,24 +886,63 @@ class AppLocalizationsEn extends AppLocalizations { String get keyboardValueRequiredError => 'Input text cannot be empty'; @override - String get keyboardPairPresetFormField => 'Pair Symbols Preset (Value)'; + String get keyboardPairValueFormField => 'Pair Symbols'; @override - String get keyboardCommandPresetFormField => 'Editor Command Preset (Value)'; + String get keyboardPairValueFormFieldHint => 'e.g. (), [], \"\", <>'; @override - String get keyboardModifierPresetFormField => 'Terminal Modifier (Value)'; + String get keyboardPairValueRequiredError => 'Please enter the pair symbols'; @override - String get keyboardTerminalKeyPresetFormField => 'Terminal Key (Value)'; + String get keyboardPairValueInvalidError => + 'Enter at least 2 characters with different halves, e.g. (), []'; @override - String get keyboardCursorOffsetFormField => - 'Cursor Relative Offset (cursorOffset)'; + String get keyboardCommandPresetFormField => 'Editor Command'; @override - String get keyboardCursorOffsetHelper => - 'e.g. For () cursor in center should move left by 1, enter -1'; + String keyboardCommandName(String command) { + String _temp0 = intl.Intl.selectLogic(command, { + 'tab': 'Indent', + 'untab': 'Outdent', + 'undo': 'Undo', + 'redo': 'Redo', + 'cursor_left': 'Cursor Left', + 'cursor_right': 'Cursor Right', + 'cursor_up': 'Cursor Up', + 'cursor_down': 'Cursor Down', + 'line_start': 'Move to Line Start', + 'line_end': 'Move to Line End', + 'page_start': 'Move to Document Start', + 'page_end': 'Move to Document End', + 'copy': 'Copy', + 'cut': 'Cut', + 'paste': 'Paste', + 'delete': 'Delete', + 'select_all': 'Select All', + 'keyboard_hide': 'Hide Keyboard', + 'other': '$command', + }); + return '$_temp0'; + } + + @override + String get keyboardModifierPresetFormField => 'Terminal Modifier'; + + @override + String keyboardModifierName(String modifier) { + String _temp0 = intl.Intl.selectLogic(modifier, { + 'ctrl': 'Ctrl Key', + 'alt': 'Alt Key', + 'shift': 'Shift Key', + 'other': '$modifier', + }); + return '$_temp0'; + } + + @override + String get keyboardCursorOffsetFormField => 'Cursor Relative Offset'; @override String get keyboardCursorOffsetRequiredError => @@ -725,4 +950,151 @@ class AppLocalizationsEn extends AppLocalizations { @override String get keyboardCursorOffsetIntegerError => 'Offset must be an integer'; + + @override + String get recommended => 'Recommended'; + + @override + String get presetColors => 'Preset Colors'; + + @override + String get hexColor => 'Hex Color'; + + @override + String get currentColor => 'Current'; + + @override + String get newColor => 'Preview'; + + @override + String get runTasks => 'Run Tasks'; + + @override + String get projectDetect => 'Detect Project'; + + @override + String get projectDetecting => 'Detecting project...'; + + @override + String get editRunTasks => 'Edit Run Tasks'; + + @override + String get projectSection => 'Project'; + + @override + String get showHiddenFiles => 'Show Hidden Files'; + + @override + String get showHiddenFilesSubtitle => + 'Show hidden files and folders starting with dot (.) in file tree'; + + @override + String get searchTasksHint => 'Search tasks...'; + + @override + String get noTasksAvailable => 'No executable tasks available'; + + @override + String get noMatchingTasks => 'No matching tasks found'; + + @override + String get userCustomTasks => 'User Custom Tasks'; + + @override + String get systemDetectedTasks => 'System Detected Tasks'; + + @override + String get editCustomTasksTooltip => 'Edit Custom Tasks'; + + @override + String get runTasksConfig => 'Run Tasks Configuration'; + + @override + String get editTask => 'Edit Task'; + + @override + String get addTask => 'Add Task'; + + @override + String get runTasksConfigSubtitle => + 'Configuration will be saved to .code_editor/run_tasks.json in project root'; + + @override + String get noCustomTasksInProject => 'No custom tasks in current project'; + + @override + String get createNow => 'Create Now'; + + @override + String get saveAndApply => 'Save & Apply'; + + @override + String get taskNameRequired => 'Task Name *'; + + @override + String get taskNameHint => 'e.g. Build & Run Debug'; + + @override + String get taskNameEmptyError => 'Please enter task name'; + + @override + String get shellCommandRequired => 'Shell Command *'; + + @override + String get shellCommandHint => 'e.g. cmake -B build && cmake --build build'; + + @override + String get shellCommandEmptyError => 'Please enter command'; + + @override + String get taskDescOptional => 'Description (Optional)'; + + @override + String get taskDescHint => 'Briefly describe the task purpose'; + + @override + String get clearBeforeRun => 'Clear Screen (clear)'; + + @override + String get clearBeforeRunSubtitle => + 'Clear terminal output before executing task'; + + @override + String get runTasksUpdated => 'Run tasks configuration updated'; + + @override + String detectCompletedMessage(int count) { + return 'Detection completed, found $count tasks'; + } + + @override + String get pleaseOpenProjectFirst => 'Please open a project first'; + + @override + String deleteTaskConfirmMessage(String name) { + return 'Are you sure you want to delete task \"$name\"?'; + } + + @override + String deleteSelectedTasksConfirmMessage(int count) { + return 'Are you sure you want to delete the selected $count tasks?'; + } + + @override + String get deleteSelected => 'Delete Selected'; + + @override + String get selectTasksToDelete => 'Select Tasks to Delete'; + + @override + String selectedCount(int count) { + return '$count selected'; + } + + @override + String get unsavedTaskChangesTitle => 'Unsaved Task Changes'; + + @override + String get unsavedTaskChangesMessage => + 'The task has been modified. Do you want to discard unsaved changes and leave?'; } diff --git a/lib/l10n/app_localizations_zh.dart b/lib/l10n/app_localizations_zh.dart index eedec89..9283720 100644 --- a/lib/l10n/app_localizations_zh.dart +++ b/lib/l10n/app_localizations_zh.dart @@ -237,6 +237,62 @@ class AppLocalizationsZh extends AppLocalizations { @override String get codeFontSize => '代码字号缩放'; + @override + String get uiFont => '界面字体'; + + @override + String get selectUiFont => '选择界面字体'; + + @override + String get themeColor => '主题颜色'; + + @override + String get selectThemeColor => '选择主题颜色'; + + @override + String get terminalBackgroundColor => '终端背景颜色'; + + @override + String get selectTerminalBackgroundColor => '选择终端背景颜色'; + + @override + String get uiFontPreview => '代码编辑器界面字体预览 Code Editor 123'; + + @override + String get codeFont => '代码字体'; + + @override + String get selectCodeFont => '选择代码字体'; + + @override + String get codeFontPreview => 'const app = \"Code Editor\"; // 代码预览'; + + @override + String get terminalFont => '终端字体'; + + @override + String get selectTerminalFont => '选择终端字体'; + + @override + String get terminalFontPreview => '\$ git status -s # 终端字体预览'; + + @override + String fontName(String font) { + String _temp0 = intl.Intl.selectLogic(font, { + 'system_default': '系统默认', + 'sans_serif': '无衬线体', + 'serif': '衬线体(宋体)', + 'monospace': '系统等宽', + 'consolas': 'Consolas', + 'courier_new': 'Courier New', + 'menlo': 'Menlo / Monaco', + 'jetbrains_mono': 'JetBrains Mono', + 'fira_code': 'Fira Code', + 'other': '$font', + }); + return '$_temp0'; + } + @override String get decreaseFontSize => '减小字号'; @@ -275,6 +331,19 @@ class AppLocalizationsZh extends AppLocalizations { @override String get editVirtualKeyboardConfigSubtitle => '自定义小键盘按键布局与快捷键'; + @override + String get terminalVirtualKeyboard => '终端小键盘'; + + @override + String get terminalVirtualKeyboardSubtitle => '在终端下方显示常用特殊键与指令快捷键'; + + @override + String get editTerminalVirtualKeyboardConfig => '编辑终端键盘配置'; + + @override + String get editTerminalVirtualKeyboardConfigSubtitle => + '自定义 Esc / Tab / Ctrl 组合等终端专用按键'; + @override String get virtualKeyboardDialogTitle => '小键盘配置 (JSON)'; @@ -655,7 +724,7 @@ class AppLocalizationsZh extends AppLocalizations { String get keyboardEditKeyTitle => '编辑按键'; @override - String get keyboardLabelFormField => '显示文本 (Label)'; + String get keyboardLabelFormField => '显示文本'; @override String get keyboardLabelFormFieldHint => '按键上显示的文本,如 Tab、()、A'; @@ -664,16 +733,130 @@ class AppLocalizationsZh extends AppLocalizations { String get keyboardLabelOrIconRequiredError => '请输入显示文本或选择图标'; @override - String get keyboardIconFormField => '图标 (Icon, 可选)'; + String get keyboardIconFormField => '图标 (可选)'; + + @override + String keyboardIconName(String icon) { + String _temp0 = intl.Intl.selectLogic(icon, { + 'undo': '撤销', + 'redo': '重做', + 'tab': '向右缩进', + 'untab': '向左缩进', + 'outdent': '减少缩进', + 'arrow_left': '左箭头', + 'arrow_right': '右箭头', + 'arrow_up': '上箭头', + 'arrow_down': '下箭头', + 'home': '移至行首', + 'end': '移至行尾', + 'first_page': '移至文首', + 'last_page': '移至文末', + 'page_up': '上翻页', + 'page_down': '下翻页', + 'enter': '回车', + 'space': '空格', + 'escape': '退出', + 'insert': '插入', + 'clear': '清除', + 'keyboard': '键盘', + 'backspace': '退格', + 'delete': '删除', + 'copy': '复制', + 'cut': '剪切', + 'paste': '粘贴', + 'save': '保存', + 'search': '搜索', + 'select_all': '全选', + 'keyboard_hide': '收起小键盘', + 'other': '$icon', + }); + return '$_temp0'; + } @override String get keyboardNoIconOption => '无图标 (使用文本显示)'; @override - String get keyboardActionFormField => '动作类型 (Action)'; + String get keyboardActionFormField => '动作类型'; @override - String get keyboardValueFormField => '输入文本内容 (Value)'; + String keyboardActionName(String action) { + String _temp0 = intl.Intl.selectLogic(action, { + 'input': '普通文本', + 'pair': '成对符号', + 'command': '编辑器命令', + 'modifier': '修饰键', + 'key': '特殊键', + 'other': '$action', + }); + return '$_temp0'; + } + + @override + String get keyboardActionInputTerminal => '指令快捷键'; + + @override + String get keyboardKeyFormField => '特殊键'; + + @override + String get keyboardKeyGroupNavigation => '导航键'; + + @override + String get keyboardKeyGroupEditing => '编辑键'; + + @override + String get keyboardKeyGroupFunctionKeys => '功能键'; + + @override + String get keyboardKeyGroupLetters => '字母键'; + + @override + String get keyboardAutoEnter => '发送后自动回车'; + + @override + String keyboardKeyName(String key) { + String _temp0 = intl.Intl.selectLogic(key, { + 'escape': '退出', + 'tab': 'Tab', + 'backtab': '反向制表', + 'returnKey': '回车', + 'enter': '回车', + 'numpadEnter': '小键盘回车', + 'backspace': '退格', + 'delete': '删除', + 'insert': '插入', + 'space': '空格', + 'numpadClear': '清除', + 'arrowUp': '上', + 'arrowDown': '下', + 'arrowLeft': '左', + 'arrowRight': '右', + 'home': '行首', + 'end': '行尾', + 'pageUp': '上翻页', + 'pageDown': '下翻页', + 'f1': 'F1', + 'f2': 'F2', + 'f3': 'F3', + 'f4': 'F4', + 'f5': 'F5', + 'f6': 'F6', + 'f7': 'F7', + 'f8': 'F8', + 'f9': 'F9', + 'f10': 'F10', + 'f11': 'F11', + 'f12': 'F12', + 'other': '$key', + }); + return '$_temp0'; + } + + @override + String get keyboardKeyInvalidError => '该键在终端中不会产生任何输出,请选择列表中的特殊键'; + + @override + String get keyboardValueFormField => '输入文本内容'; @override String get keyboardValueFormFieldHint => '点击后直接插入的文本,如 ;、=、->'; @@ -682,26 +865,210 @@ class AppLocalizationsZh extends AppLocalizations { String get keyboardValueRequiredError => '输入文本不能为空'; @override - String get keyboardPairPresetFormField => '成对符号预设 (Value)'; + String get keyboardPairValueFormField => '成对符号'; @override - String get keyboardCommandPresetFormField => '预设编辑器命令 (Value)'; + String get keyboardPairValueFormFieldHint => '例如 ()、[]、\"\"、<>'; @override - String get keyboardModifierPresetFormField => '终端修饰键 (Value)'; + String get keyboardPairValueRequiredError => '请输入成对符号'; @override - String get keyboardTerminalKeyPresetFormField => '终端按键 (Value)'; + String get keyboardPairValueInvalidError => '请输入至少 2 个字符且左右不同的成对符号,如 ()、[]'; @override - String get keyboardCursorOffsetFormField => '光标相对偏移 (cursorOffset)'; + String get keyboardCommandPresetFormField => '编辑器命令'; @override - String get keyboardCursorOffsetHelper => '例如 () 插入后光标居中需向左偏移 1 位,填写 -1'; + String keyboardCommandName(String command) { + String _temp0 = intl.Intl.selectLogic(command, { + 'tab': '向右缩进', + 'untab': '向左缩进', + 'undo': '撤销', + 'redo': '重做', + 'cursor_left': '光标左移', + 'cursor_right': '光标右移', + 'cursor_up': '光标上移', + 'cursor_down': '光标下移', + 'line_start': '移动至行首', + 'line_end': '移动至行尾', + 'page_start': '移动至文首', + 'page_end': '移动至文末', + 'copy': '复制', + 'cut': '剪切', + 'paste': '粘贴', + 'delete': '删除', + 'select_all': '全选', + 'keyboard_hide': '收起小键盘', + 'other': '$command', + }); + return '$_temp0'; + } + + @override + String get keyboardModifierPresetFormField => '终端修饰键'; + + @override + String keyboardModifierName(String modifier) { + String _temp0 = intl.Intl.selectLogic(modifier, { + 'ctrl': 'Ctrl 键', + 'alt': 'Alt 键', + 'shift': 'Shift 键', + 'other': '$modifier', + }); + return '$_temp0'; + } + + @override + String get keyboardCursorOffsetFormField => '光标相对偏移'; @override String get keyboardCursorOffsetRequiredError => '请输入光标偏移(通常为 -1)'; @override String get keyboardCursorOffsetIntegerError => '偏移量必须为整数'; + + @override + String get recommended => '推荐'; + + @override + String get presetColors => '预设颜色'; + + @override + String get hexColor => '十六进制颜色'; + + @override + String get currentColor => '当前'; + + @override + String get newColor => '预览'; + + @override + String get runTasks => '运行任务'; + + @override + String get projectDetect => '项目探测'; + + @override + String get projectDetecting => '正在探测项目...'; + + @override + String get editRunTasks => '运行任务编辑'; + + @override + String get projectSection => '项目'; + + @override + String get showHiddenFiles => '显示隐藏文件'; + + @override + String get showHiddenFilesSubtitle => '在文件树中展示以点 (.) 开头的隐藏文件与文件夹'; + + @override + String get searchTasksHint => '搜索指定任务...'; + + @override + String get noTasksAvailable => '暂无可执行任务'; + + @override + String get noMatchingTasks => '无匹配的任务'; + + @override + String get userCustomTasks => '用户自定义任务'; + + @override + String get systemDetectedTasks => '系统动态探测任务'; + + @override + String get editCustomTasksTooltip => '编辑自定义任务'; + + @override + String get runTasksConfig => '运行任务配置'; + + @override + String get editTask => '编辑任务'; + + @override + String get addTask => '新增任务'; + + @override + String get runTasksConfigSubtitle => + '配置将自动保存至项目根目录下的 .code_editor/run_tasks.json'; + + @override + String get noCustomTasksInProject => '当前项目暂无自定义任务'; + + @override + String get createNow => '立即创建'; + + @override + String get saveAndApply => '保存并应用'; + + @override + String get taskNameRequired => '任务名称 *'; + + @override + String get taskNameHint => '如: 编译并运行 Debug'; + + @override + String get taskNameEmptyError => '请输入任务名称'; + + @override + String get shellCommandRequired => 'Shell 执行指令 *'; + + @override + String get shellCommandHint => '如: cmake -B build && cmake --build build'; + + @override + String get shellCommandEmptyError => '请输入执行指令'; + + @override + String get taskDescOptional => '任务描述(选填)'; + + @override + String get taskDescHint => '简要说明此任务的用途'; + + @override + String get clearBeforeRun => '执行前清屏 (clear)'; + + @override + String get clearBeforeRunSubtitle => '在终端输出任务结果前清理历史屏幕'; + + @override + String get runTasksUpdated => '运行任务配置已更新'; + + @override + String detectCompletedMessage(int count) { + return '探测完成,发现 $count 个可用任务'; + } + + @override + String get pleaseOpenProjectFirst => '请先打开一个项目'; + + @override + String deleteTaskConfirmMessage(String name) { + return '确定要删除任务 \"$name\" 吗?'; + } + + @override + String deleteSelectedTasksConfirmMessage(int count) { + return '确定要删除选中的 $count 个任务吗?'; + } + + @override + String get deleteSelected => '删除选中'; + + @override + String get selectTasksToDelete => '选择要删除的任务'; + + @override + String selectedCount(int count) { + return '已选 $count 项'; + } + + @override + String get unsavedTaskChangesTitle => '未保存的任务更改'; + + @override + String get unsavedTaskChangesMessage => '当前任务内容已被修改,是否放弃未保存的修改并返回?'; } diff --git a/lib/l10n/app_zh.arb b/lib/l10n/app_zh.arb index 4d47f7a..b7c0647 100644 --- a/lib/l10n/app_zh.arb +++ b/lib/l10n/app_zh.arb @@ -71,6 +71,27 @@ "darkThemeCategory": "暗色系", "lightThemeCategory": "浅色系", "codeFontSize": "代码字号缩放", + "uiFont": "界面字体", + "selectUiFont": "选择界面字体", + "themeColor": "主题颜色", + "selectThemeColor": "选择主题颜色", + "terminalBackgroundColor": "终端背景颜色", + "selectTerminalBackgroundColor": "选择终端背景颜色", + "uiFontPreview": "代码编辑器界面字体预览 Code Editor 123", + "codeFont": "代码字体", + "selectCodeFont": "选择代码字体", + "codeFontPreview": "const app = \"Code Editor\"; // 代码预览", + "terminalFont": "终端字体", + "selectTerminalFont": "选择终端字体", + "terminalFontPreview": "$ git status -s # 终端字体预览", + "fontName": "{font, select, system_default{系统默认} sans_serif{无衬线体} serif{衬线体(宋体)} monospace{系统等宽} consolas{Consolas} courier_new{Courier New} menlo{Menlo / Monaco} jetbrains_mono{JetBrains Mono} fira_code{Fira Code} other{{font}}}", + "@fontName": { + "placeholders": { + "font": { + "type": "String" + } + } + }, "decreaseFontSize": "减小字号", "increaseFontSize": "增大字号", "fontSizeDialogTitle": "代码字号", @@ -91,6 +112,10 @@ "virtualKeyboardSubtitle": "在代码编辑区底部显示辅助符号与快捷键", "editVirtualKeyboardConfig": "编辑键盘配置", "editVirtualKeyboardConfigSubtitle": "自定义小键盘按键布局与快捷键", + "terminalVirtualKeyboard": "终端小键盘", + "terminalVirtualKeyboardSubtitle": "在终端下方显示常用特殊键与指令快捷键", + "editTerminalVirtualKeyboardConfig": "编辑终端键盘配置", + "editTerminalVirtualKeyboardConfigSubtitle": "自定义 Esc / Tab / Ctrl 组合等终端专用按键", "virtualKeyboardDialogTitle": "小键盘配置 (JSON)", "resetDefault": "恢复默认", "configFormatError": "配置格式错误", @@ -357,21 +382,143 @@ }, "keyboardAddKeyTitle": "添加按键", "keyboardEditKeyTitle": "编辑按键", - "keyboardLabelFormField": "显示文本 (Label)", + "keyboardLabelFormField": "显示文本", "keyboardLabelFormFieldHint": "按键上显示的文本,如 Tab、()、A", "keyboardLabelOrIconRequiredError": "请输入显示文本或选择图标", - "keyboardIconFormField": "图标 (Icon, 可选)", + "keyboardIconFormField": "图标 (可选)", + "keyboardIconName": "{icon, select, undo{撤销} redo{重做} tab{向右缩进} untab{向左缩进} outdent{减少缩进} arrow_left{左箭头} arrow_right{右箭头} arrow_up{上箭头} arrow_down{下箭头} home{移至行首} end{移至行尾} first_page{移至文首} last_page{移至文末} page_up{上翻页} page_down{下翻页} enter{回车} space{空格} escape{退出} insert{插入} clear{清除} keyboard{键盘} backspace{退格} delete{删除} copy{复制} cut{剪切} paste{粘贴} save{保存} search{搜索} select_all{全选} keyboard_hide{收起小键盘} other{{icon}}}", + "@keyboardIconName": { + "placeholders": { + "icon": { + "type": "String" + } + } + }, "keyboardNoIconOption": "无图标 (使用文本显示)", - "keyboardActionFormField": "动作类型 (Action)", - "keyboardValueFormField": "输入文本内容 (Value)", + "keyboardActionFormField": "动作类型", + "keyboardActionName": "{action, select, input{普通文本} pair{成对符号} command{编辑器命令} modifier{修饰键} key{特殊键} other{{action}}}", + "@keyboardActionName": { + "placeholders": { + "action": { + "type": "String" + } + } + }, + "keyboardActionInputTerminal": "指令快捷键", + "keyboardKeyFormField": "特殊键", + "keyboardKeyGroupNavigation": "导航键", + "keyboardKeyGroupEditing": "编辑键", + "keyboardKeyGroupFunctionKeys": "功能键", + "keyboardKeyGroupLetters": "字母键", + "keyboardAutoEnter": "发送后自动回车", + "keyboardKeyName": "{key, select, escape{退出} tab{Tab} backtab{反向制表} returnKey{回车} enter{回车} numpadEnter{小键盘回车} backspace{退格} delete{删除} insert{插入} space{空格} numpadClear{清除} arrowUp{上} arrowDown{下} arrowLeft{左} arrowRight{右} home{行首} end{行尾} pageUp{上翻页} pageDown{下翻页} f1{F1} f2{F2} f3{F3} f4{F4} f5{F5} f6{F6} f7{F7} f8{F8} f9{F9} f10{F10} f11{F11} f12{F12} other{{key}}}", + "@keyboardKeyName": { + "placeholders": { + "key": { + "type": "String" + } + } + }, + "keyboardKeyInvalidError": "该键在终端中不会产生任何输出,请选择列表中的特殊键", + "keyboardValueFormField": "输入文本内容", "keyboardValueFormFieldHint": "点击后直接插入的文本,如 ;、=、->", "keyboardValueRequiredError": "输入文本不能为空", - "keyboardPairPresetFormField": "成对符号预设 (Value)", - "keyboardCommandPresetFormField": "预设编辑器命令 (Value)", - "keyboardModifierPresetFormField": "终端修饰键 (Value)", - "keyboardTerminalKeyPresetFormField": "终端按键 (Value)", - "keyboardCursorOffsetFormField": "光标相对偏移 (cursorOffset)", - "keyboardCursorOffsetHelper": "例如 () 插入后光标居中需向左偏移 1 位,填写 -1", + "keyboardPairValueFormField": "成对符号", + "keyboardPairValueFormFieldHint": "例如 ()、[]、\"\"、<>", + "keyboardPairValueRequiredError": "请输入成对符号", + "keyboardPairValueInvalidError": "请输入至少 2 个字符且左右不同的成对符号,如 ()、[]", + "keyboardCommandPresetFormField": "编辑器命令", + "keyboardCommandName": "{command, select, tab{向右缩进} untab{向左缩进} undo{撤销} redo{重做} cursor_left{光标左移} cursor_right{光标右移} cursor_up{光标上移} cursor_down{光标下移} line_start{移动至行首} line_end{移动至行尾} page_start{移动至文首} page_end{移动至文末} copy{复制} cut{剪切} paste{粘贴} delete{删除} select_all{全选} keyboard_hide{收起小键盘} other{{command}}}", + "@keyboardCommandName": { + "placeholders": { + "command": { + "type": "String" + } + } + }, + "keyboardModifierPresetFormField": "终端修饰键", + "keyboardModifierName": "{modifier, select, ctrl{Ctrl 键} alt{Alt 键} shift{Shift 键} other{{modifier}}}", + "@keyboardModifierName": { + "placeholders": { + "modifier": { + "type": "String" + } + } + }, + "keyboardCursorOffsetFormField": "光标相对偏移", "keyboardCursorOffsetRequiredError": "请输入光标偏移(通常为 -1)", - "keyboardCursorOffsetIntegerError": "偏移量必须为整数" + "keyboardCursorOffsetIntegerError": "偏移量必须为整数", + "recommended": "推荐", + "presetColors": "预设颜色", + "hexColor": "十六进制颜色", + "currentColor": "当前", + "newColor": "预览", + "runTasks": "运行任务", + "projectDetect": "项目探测", + "projectDetecting": "正在探测项目...", + "editRunTasks": "运行任务编辑", + "projectSection": "项目", + "showHiddenFiles": "显示隐藏文件", + "showHiddenFilesSubtitle": "在文件树中展示以点 (.) 开头的隐藏文件与文件夹", + "searchTasksHint": "搜索指定任务...", + "noTasksAvailable": "暂无可执行任务", + "noMatchingTasks": "无匹配的任务", + "userCustomTasks": "用户自定义任务", + "systemDetectedTasks": "系统动态探测任务", + "editCustomTasksTooltip": "编辑自定义任务", + "runTasksConfig": "运行任务配置", + "editTask": "编辑任务", + "addTask": "新增任务", + "runTasksConfigSubtitle": "配置将自动保存至项目根目录下的 .code_editor/run_tasks.json", + "noCustomTasksInProject": "当前项目暂无自定义任务", + "createNow": "立即创建", + "saveAndApply": "保存并应用", + "taskNameRequired": "任务名称 *", + "taskNameHint": "如: 编译并运行 Debug", + "taskNameEmptyError": "请输入任务名称", + "shellCommandRequired": "Shell 执行指令 *", + "shellCommandHint": "如: cmake -B build && cmake --build build", + "shellCommandEmptyError": "请输入执行指令", + "taskDescOptional": "任务描述(选填)", + "taskDescHint": "简要说明此任务的用途", + "clearBeforeRun": "执行前清屏 (clear)", + "clearBeforeRunSubtitle": "在终端输出任务结果前清理历史屏幕", + "runTasksUpdated": "运行任务配置已更新", + "detectCompletedMessage": "探测完成,发现 {count} 个可用任务", + "@detectCompletedMessage": { + "placeholders": { + "count": { + "type": "int" + } + } + }, + "pleaseOpenProjectFirst": "请先打开一个项目", + "deleteTaskConfirmMessage": "确定要删除任务 \"{name}\" 吗?", + "@deleteTaskConfirmMessage": { + "placeholders": { + "name": { + "type": "String" + } + } + }, + "deleteSelectedTasksConfirmMessage": "确定要删除选中的 {count} 个任务吗?", + "@deleteSelectedTasksConfirmMessage": { + "placeholders": { + "count": { + "type": "int" + } + } + }, + "deleteSelected": "删除选中", + "selectTasksToDelete": "选择要删除的任务", + "selectedCount": "已选 {count} 项", + "@selectedCount": { + "placeholders": { + "count": { + "type": "int" + } + } + }, + "unsavedTaskChangesTitle": "未保存的任务更改", + "unsavedTaskChangesMessage": "当前任务内容已被修改,是否放弃未保存的修改并返回?" } \ No newline at end of file diff --git a/lib/main.dart b/lib/main.dart index d387e73..0cf48fd 100644 --- a/lib/main.dart +++ b/lib/main.dart @@ -3,8 +3,10 @@ import 'package:code_editor/providers/distro_provider.dart'; import 'package:code_editor/providers/project_provider.dart'; import 'package:code_editor/providers/settings_provider.dart'; import 'package:code_editor/providers/tab_provider.dart'; +import 'package:code_editor/providers/run_provider.dart'; import 'package:code_editor/providers/terminal_provider.dart'; import 'package:code_editor/views/main_view.dart'; +import 'package:code_editor/utils/app_theme.dart'; import 'package:flutter/material.dart'; import 'package:provider/provider.dart'; @@ -28,13 +30,21 @@ class MyApp extends StatelessWidget { return MultiProvider( providers: [ ChangeNotifierProvider(create: (_) => SettingsProvider()..init()), - ChangeNotifierProvider(create: (_) => ProjectProvider()..init()), + ChangeNotifierProxyProvider( + create: (_) => ProjectProvider()..init(), + update: (_, settings, project) { + final pp = project ?? (ProjectProvider()..init()); + pp.updateShowHiddenFiles(settings.showHiddenFiles); + return pp; + }, + ), ChangeNotifierProxyProvider( create: (_) => TabProvider()..init(), update: (_, project, tab) => (tab ?? (TabProvider()..init()))..bindProjectProvider(project), ), ChangeNotifierProvider(create: (_) => TerminalProvider()), + ChangeNotifierProvider(create: (_) => RunProvider()), ChangeNotifierProxyProvider( create: (_) => DistroProvider()..init(), update: (_, terminal, distro) { @@ -58,37 +68,15 @@ class MyApp extends StatelessWidget { supportedLocales: AppLocalizations.supportedLocales, onGenerateTitle: (context) => AppLocalizations.of(context)!.appTitle, themeMode: settings.appThemeMode, - theme: ThemeData( - useMaterial3: true, + theme: buildAppTheme( + seedColor: settings.appThemeColor, brightness: Brightness.light, - colorScheme: ColorScheme.fromSeed( - seedColor: Colors.blue, - brightness: Brightness.light, - ), - appBarTheme: const AppBarTheme( - systemOverlayStyle: SystemUiOverlayStyle( - statusBarColor: Colors.transparent, - statusBarIconBrightness: Brightness.dark, - statusBarBrightness: Brightness.light, - ), - ), fontFamily: settings.uiFont.fontFamily, fontFamilyFallback: settings.uiFont.fallback, ), - darkTheme: ThemeData( - useMaterial3: true, + darkTheme: buildAppTheme( + seedColor: settings.appThemeColor, brightness: Brightness.dark, - colorScheme: ColorScheme.fromSeed( - seedColor: Colors.blue, - brightness: Brightness.dark, - ), - appBarTheme: const AppBarTheme( - systemOverlayStyle: SystemUiOverlayStyle( - statusBarColor: Colors.transparent, - statusBarIconBrightness: Brightness.light, - statusBarBrightness: Brightness.dark, - ), - ), fontFamily: settings.uiFont.fontFamily, fontFamilyFallback: settings.uiFont.fallback, ), diff --git a/lib/models/app_font.dart b/lib/models/app_font.dart index a8d215b..a699e11 100644 --- a/lib/models/app_font.dart +++ b/lib/models/app_font.dart @@ -1,4 +1,7 @@ /// 字体定义与预设常量 +/// +/// 注意:[name] 仅作为代码内的定义说明,界面展示名称一律取自 l10n +/// (`fontName(id)`),避免中英文文案两处维护。 class AppFontItem { final String id; final String name; @@ -133,7 +136,7 @@ class AppFonts { /// 预设的开源编程字体配置(用户后续下载字体包放入 assets/fonts/ 并配置 pubspec 后即可即开即用) static const AppFontItem editorJetBrainsMono = AppFontItem( id: 'jetbrains_mono', - name: 'JetBrains Mono (推荐)', + name: 'JetBrains Mono', fontFamily: 'JetBrains Mono', fallback: ['monospace'], isMonospace: true, @@ -200,7 +203,7 @@ class AppFonts { static const AppFontItem terminalJetBrainsMono = AppFontItem( id: 'jetbrains_mono', - name: 'JetBrains Mono (推荐)', + name: 'JetBrains Mono', fontFamily: 'JetBrains Mono', fallback: ['monospace'], isMonospace: true, diff --git a/lib/models/run_task.dart b/lib/models/run_task.dart new file mode 100644 index 0000000..dfdcbd2 --- /dev/null +++ b/lib/models/run_task.dart @@ -0,0 +1,108 @@ +import 'package:flutter/material.dart'; + +/// 运行任务来源类型 +enum TaskSource { + /// 系统动态探测所得(保存在内存,随项目探测刷新) + detected, + + /// 用户在 .code_editor/run_tasks.json 中持久化配置 + custom, +} + +/// 运行任务实体模型 +class RunTask { + /// 任务唯一ID + final String id; + + /// 任务展示名称 + final String name; + + /// 发送到终端执行的 Shell 命令(支持 &&、; 串联多条命令) + final String command; + + /// 任务来源(探测/用户自定义) + final TaskSource source; + + /// 任务补充描述/副标题(通常是命令预览或文件路径) + final String? description; + + /// 容器内相对工作路径(为 null 时默认容器工作区 /workspace) + final String? workingDir; + + /// 是否在执行该命令前清屏(发送 clear) + final bool clearBeforeRun; + + /// UI 展示图标(可选) + final IconData? icon; + + const RunTask({ + required this.id, + required this.name, + required this.command, + required this.source, + this.description, + this.workingDir, + this.clearBeforeRun = false, + this.icon, + }); + + /// 从持久化的 JSON Map 构建自定义运行任务 + factory RunTask.fromJson(Map json) { + return RunTask( + id: json['id'] as String? ?? 'custom_${DateTime.now().microsecondsSinceEpoch}', + name: json['name'] as String? ?? '未命名任务', + command: json['command'] as String? ?? '', + source: TaskSource.custom, + description: json['description'] as String?, + workingDir: json['workingDir'] as String?, + clearBeforeRun: json['clearBeforeRun'] as bool? ?? false, + ); + } + + /// 序列化为持久化 JSON Map(仅针对用户自定义任务保存) + Map toJson() { + return { + 'id': id, + 'name': name, + 'command': command, + if (description != null && description!.isNotEmpty) 'description': description, + if (workingDir != null && workingDir!.isNotEmpty) 'workingDir': workingDir, + 'clearBeforeRun': clearBeforeRun, + }; + } + + RunTask copyWith({ + String? id, + String? name, + String? command, + TaskSource? source, + String? description, + String? workingDir, + bool? clearBeforeRun, + IconData? icon, + }) { + return RunTask( + id: id ?? this.id, + name: name ?? this.name, + command: command ?? this.command, + source: source ?? this.source, + description: description ?? this.description, + workingDir: workingDir ?? this.workingDir, + clearBeforeRun: clearBeforeRun ?? this.clearBeforeRun, + icon: icon ?? this.icon, + ); + } + + @override + bool operator ==(Object other) => + identical(this, other) || + other is RunTask && + runtimeType == other.runtimeType && + id == other.id && + name == other.name && + command == other.command && + source == other.source; + + @override + int get hashCode => id.hashCode ^ name.hashCode ^ command.hashCode ^ source.hashCode; +} diff --git a/lib/models/terminal_session.dart b/lib/models/terminal_session.dart index aeadc18..81a1767 100644 --- a/lib/models/terminal_session.dart +++ b/lib/models/terminal_session.dart @@ -10,6 +10,7 @@ class TerminalSession { final String id; String name; final String distroId; + final String? workspacePath; final DateTime createdAt; final Terminal terminal; final FocusNode focusNode; @@ -17,12 +18,14 @@ class TerminalSession { Pty? _pty; StreamSubscription? _ptyOutputSub; bool _isProcessRunning = false; - String _inputBuffer = ''; + VoidCallback? onProcessTerminated; TerminalSession({ required this.id, this.name = '会话', this.distroId = 'alpine', + this.workspacePath, + this.onProcessTerminated, DateTime? createdAt, int maxLines = 10000, bool autoStartProcess = false, @@ -31,7 +34,7 @@ class TerminalSession { focusNode = FocusNode() { _initTerminalEvents(); if (autoStartProcess) { - unawaited(startProcess()); + unawaited(startProcess(workspacePath: workspacePath)); } } @@ -41,14 +44,12 @@ class TerminalSession { String get bufferText => terminal.buffer.getText(); void _initTerminalEvents() { - // 监听输入直接送往 PTY + // 监听输入直接送往 PTY;若进程已退出或未启动,则完全不处理输入(禁止交互) terminal.onOutput = (data) { if (_pty != null && _isProcessRunning) { try { _pty!.write(utf8.encode(data)); } catch (_) {} - } else { - _handleLocalEcho(data); } }; @@ -62,48 +63,14 @@ class TerminalSession { }; } - /// 当无底层进程挂接时的本地简易交互回显支持(保证脱机/本地开发时的基础交互与光标跳动) - void _handleLocalEcho(String data) { - for (int i = 0; i < data.length; i++) { - final char = data[i]; - if (char == '\r' || char == '\n') { - terminal.write('\r\n'); - _executeLocalCommand(_inputBuffer.trim()); - _inputBuffer = ''; - } else if (char == '\x7f' || char == '\b') { - // 退格键 - if (_inputBuffer.isNotEmpty) { - _inputBuffer = _inputBuffer.substring(0, _inputBuffer.length - 1); - terminal.write('\b \b'); - } - } else if (char.codeUnitAt(0) >= 32) { - _inputBuffer += char; - terminal.write(char); - } - } - } - - void _executeLocalCommand(String cmd) { - if (cmd.isEmpty) { - terminal.write('\$ '); - return; - } - if (cmd == 'clear') { - clear(); - terminal.write('\$ '); - return; - } - terminal.write('\x1b[33m[Host fallback]: executed "$cmd"\x1b[0m\r\n'); - terminal.write('\$ '); - } - /// 启动底层真实 PTY 进程(连接 PRoot 容器或 Host Shell) Future startProcess({DistroManager? distroManager, String? workspacePath}) async { final manager = distroManager ?? DistroManager(); + final effectiveWorkspace = workspacePath ?? this.workspacePath; try { final config = await manager.buildLaunchConfig( systemName: distroId, - workspacePath: workspacePath, + workspacePath: effectiveWorkspace, ); final initialRows = terminal.viewHeight > 0 ? terminal.viewHeight : 24; @@ -130,18 +97,19 @@ class TerminalSession { }, onDone: () { _isProcessRunning = false; + onProcessTerminated?.call(); }, ); _pty!.exitCode.then((code) { _isProcessRunning = false; terminal.write('\r\n\x1b[33m[Process exited with code $code]\x1b[0m\r\n'); + onProcessTerminated?.call(); }); } catch (e) { _isProcessRunning = false; - terminal.write('\x1b[1;36mWelcome to Terminal [$distroId]\x1b[0m\r\n'); - terminal.write('\x1b[90m(PTY launch failed: $e. Running in local fallback mode.)\x1b[0m\r\n\r\n'); - terminal.write('\$ '); + terminal.write('\x1b[31m[PTY launch failed: $e]\x1b[0m\r\n'); + onProcessTerminated?.call(); } } diff --git a/lib/models/virtual_keyboard_config.dart b/lib/models/virtual_keyboard_config.dart index cd9de94..0a1a2d7 100644 --- a/lib/models/virtual_keyboard_config.dart +++ b/lib/models/virtual_keyboard_config.dart @@ -15,6 +15,16 @@ class KeyboardIconHelper { 'arrow_down': Icons.arrow_downward, 'home': Icons.vertical_align_top, 'end': Icons.vertical_align_bottom, + 'first_page': Icons.first_page, + 'last_page': Icons.last_page, + 'page_up': Icons.keyboard_double_arrow_up, + 'page_down': Icons.keyboard_double_arrow_down, + 'enter': Icons.keyboard_return, + 'space': Icons.space_bar, + 'escape': Icons.cancel_outlined, + 'insert': Icons.input, + 'clear': Icons.clear, + 'keyboard': Icons.keyboard_outlined, 'backspace': Icons.backspace_outlined, 'delete': Icons.delete_outline, 'copy': Icons.copy, @@ -22,6 +32,7 @@ class KeyboardIconHelper { 'paste': Icons.content_paste, 'save': Icons.save_outlined, 'search': Icons.search, + 'select_all': Icons.select_all, 'keyboard_hide': Icons.keyboard_hide_outlined, }; @@ -36,21 +47,17 @@ class KeyboardIconHelper { } /// 虚拟小键盘作用域(编辑区或终端) +/// +/// 界面展示名称取自 l10n(`editorScope` / `terminalScope`),此处不再自带文案。 enum KeyboardScope { editor, - terminal; - - String get displayName { - switch (this) { - case KeyboardScope.editor: - return '编辑区'; - case KeyboardScope.terminal: - return '终端'; - } - } + terminal, } /// 按键动作定义项辅助 +/// +/// 注意:[label] 与 [description] 仅作为代码内的定义说明,界面展示名称一律取自 +/// l10n(`keyboardActionName`),避免中英文文案两处维护。 class KeyboardActionOption { final String action; final String label; @@ -64,13 +71,116 @@ class KeyboardActionOption { } /// 预设值选项辅助 +/// +/// 注意:[label] 仅作为代码内的定义说明,界面展示名称一律取自 l10n +/// (`keyboardCommandName` / `keyboardModifierName` / `keyboardKeyName`)。 class KeyboardValueOption { final String value; final String label; + /// 下拉菜单中展示的内置图标常量名称(可选,取值同 [KeyboardIconHelper]) + final String? icon; + const KeyboardValueOption({ required this.value, required this.label, + this.icon, + }); +} + +/// 按键修饰符组合(Ctrl / Alt / Shift) +/// +/// 仅在终端作用域的 `key` 动作上有实际含义:xterm 会把它换算成对应转义序列。 +/// 三个都为 false 时视为"无修饰",JSON 导出时整个 `mods` 字段省略。 +class KeyboardKeyMods { + final bool ctrl; + final bool alt; + final bool shift; + + const KeyboardKeyMods({ + this.ctrl = false, + this.alt = false, + this.shift = false, + }); + + /// 无修饰的常量实例 + static const KeyboardKeyMods none = KeyboardKeyMods(); + + bool get isEmpty => !ctrl && !alt && !shift; + + bool get isNotEmpty => !isEmpty; + + /// 已勾选的修饰键数量 + int get count => (ctrl ? 1 : 0) + (alt ? 1 : 0) + (shift ? 1 : 0); + + KeyboardKeyMods copyWith({bool? ctrl, bool? alt, bool? shift}) { + return KeyboardKeyMods( + ctrl: ctrl ?? this.ctrl, + alt: alt ?? this.alt, + shift: shift ?? this.shift, + ); + } + + /// 从 `{"ctrl": true, "alt": false}` 形式的 JSON 解析,非法输入一律视为无修饰 + factory KeyboardKeyMods.fromJson(dynamic json) { + if (json is! Map) return none; + return KeyboardKeyMods( + ctrl: json['ctrl'] == true, + alt: json['alt'] == true, + shift: json['shift'] == true, + ); + } + + Map toJson() { + return { + if (ctrl) 'ctrl': true, + if (alt) 'alt': true, + if (shift) 'shift': true, + }; + } + + @override + bool operator ==(Object other) { + return other is KeyboardKeyMods && + other.ctrl == ctrl && + other.alt == alt && + other.shift == shift; + } + + @override + int get hashCode => Object.hash(ctrl, alt, shift); + + @override + String toString() { + if (isEmpty) return 'none'; + return [ + if (ctrl) 'ctrl', + if (alt) 'alt', + if (shift) 'shift', + ].join('+'); + } +} + +/// 终端命名键分组(用于弹窗下拉的分组展示) +enum TerminalKeyGroup { + navigation, + editing, + functionKeys, + letters, +} + +/// 终端命名键选项:value 为 xterm `TerminalKey` 的枚举名 +class KeyboardNamedKeyOption { + final String value; + final TerminalKeyGroup group; + + /// 下拉菜单中展示的内置图标常量名称(可选,取值同 [KeyboardIconHelper]) + final String? icon; + + const KeyboardNamedKeyOption({ + required this.value, + required this.group, + this.icon, }); } @@ -78,69 +188,197 @@ class KeyboardValueOption { class KeyboardScopeHelper { /// 编辑区支持的动作类型 static const List editorActions = [ - KeyboardActionOption(action: 'input', label: '普通文本 (input)', description: '直接插入指定文本内容'), - KeyboardActionOption(action: 'pair', label: '成对符号 (pair)', description: '括号/引号等成对符号,支持选区包裹与光标偏移'), - KeyboardActionOption(action: 'command', label: '编辑器命令 (command)', description: '触发缩进、撤销、光标移动等编辑器功能'), + KeyboardActionOption(action: 'input', label: '普通文本', description: '直接插入指定文本内容'), + KeyboardActionOption(action: 'pair', label: '成对符号', description: '括号/引号等成对符号,支持选区包裹与光标偏移'), + KeyboardActionOption(action: 'command', label: '编辑器命令', description: '触发缩进、撤销、光标移动等编辑器功能'), ]; /// 终端支持的动作类型 static const List terminalActions = [ - KeyboardActionOption(action: 'input', label: '普通文本 (input)', description: '直接向终端发送指定文本'), - KeyboardActionOption(action: 'modifier', label: '修饰键 (modifier)', description: 'Ctrl / Alt 等组合修饰键状态切换'), - KeyboardActionOption(action: 'terminal_key', label: '终端按键 (terminal_key)', description: 'Esc、Tab、Ctrl+C、方向键等终端特殊键'), + KeyboardActionOption(action: 'input', label: '指令快捷键', description: '向终端发送一段文本,可附加自动回车'), + KeyboardActionOption(action: 'modifier', label: '修饰键', description: 'Ctrl / Alt / Shift 修饰状态切换'), + KeyboardActionOption(action: 'key', label: '特殊键', description: 'Esc、Tab、方向键、功能键及 Ctrl/Alt 组合'), ]; - /// 编辑区预设命令列表 + /// 终端动作取值集合(供校验使用) + static const Set terminalActionValues = {'input', 'modifier', 'key'}; + + /// 编辑区动作取值集合(供校验使用) + static const Set editorActionValues = {'input', 'pair', 'command'}; + + /// 编辑区预设命令列表(icon 用于下拉菜单前缀展示) static const List editorCommands = [ - KeyboardValueOption(value: 'tab', label: 'Tab (向右缩进)'), - KeyboardValueOption(value: 'untab', label: 'Untab (向左缩进)'), - KeyboardValueOption(value: 'undo', label: '撤销 (Undo)'), - KeyboardValueOption(value: 'redo', label: '重做 (Redo)'), - KeyboardValueOption(value: 'cursor_left', label: '光标左移'), - KeyboardValueOption(value: 'cursor_right', label: '光标右移'), - KeyboardValueOption(value: 'cursor_up', label: '光标上移'), - KeyboardValueOption(value: 'cursor_down', label: '光标下移'), - KeyboardValueOption(value: 'line_start', label: '移动至行首'), - KeyboardValueOption(value: 'line_end', label: '移动至行尾'), - KeyboardValueOption(value: 'page_start', label: '移动至文首'), - KeyboardValueOption(value: 'page_end', label: '移动至文末'), - KeyboardValueOption(value: 'copy', label: '复制 (Copy)'), - KeyboardValueOption(value: 'cut', label: '剪切 (Cut)'), - KeyboardValueOption(value: 'paste', label: '粘贴 (Paste)'), - KeyboardValueOption(value: 'delete', label: '删除 (Delete)'), - KeyboardValueOption(value: 'select_all', label: '全选 (Select All)'), - KeyboardValueOption(value: 'keyboard_hide', label: '收起小键盘'), + KeyboardValueOption(value: 'tab', label: '向右缩进', icon: 'tab'), + KeyboardValueOption(value: 'untab', label: '向左缩进', icon: 'untab'), + KeyboardValueOption(value: 'undo', label: '撤销', icon: 'undo'), + KeyboardValueOption(value: 'redo', label: '重做', icon: 'redo'), + KeyboardValueOption(value: 'cursor_left', label: '光标左移', icon: 'arrow_left'), + KeyboardValueOption(value: 'cursor_right', label: '光标右移', icon: 'arrow_right'), + KeyboardValueOption(value: 'cursor_up', label: '光标上移', icon: 'arrow_up'), + KeyboardValueOption(value: 'cursor_down', label: '光标下移', icon: 'arrow_down'), + KeyboardValueOption(value: 'line_start', label: '移动至行首', icon: 'home'), + KeyboardValueOption(value: 'line_end', label: '移动至行尾', icon: 'end'), + KeyboardValueOption(value: 'page_start', label: '移动至文首', icon: 'first_page'), + KeyboardValueOption(value: 'page_end', label: '移动至文末', icon: 'last_page'), + KeyboardValueOption(value: 'copy', label: '复制', icon: 'copy'), + KeyboardValueOption(value: 'cut', label: '剪切', icon: 'cut'), + KeyboardValueOption(value: 'paste', label: '粘贴', icon: 'paste'), + KeyboardValueOption(value: 'delete', label: '删除', icon: 'delete'), + KeyboardValueOption(value: 'select_all', label: '全选', icon: 'select_all'), + KeyboardValueOption(value: 'keyboard_hide', label: '收起小键盘', icon: 'keyboard_hide'), ]; - /// 编辑区成对符号预设列表 - static const List editorPairs = [ - KeyboardValueOption(value: '()', label: '圆括号 ()'), - KeyboardValueOption(value: '[]', label: '方括号 []'), - KeyboardValueOption(value: '{}', label: '花括号 {}'), - KeyboardValueOption(value: '""', label: '双引号 ""'), - KeyboardValueOption(value: "''", label: "单引号 ''"), - KeyboardValueOption(value: '<>', label: '尖括号 <>'), + // ========================================== + // 终端命名键表(值为 xterm TerminalKey 的枚举名) + // + // 说明:xterm 4.0.0 的默认 keytab 只对下列 31 个命名键定义了转义序列, + // 其余 HID 键码(digit0-9、numpad0-9、media*、gameButton* 等)在默认 + // keytab 中没有条目,`Terminal.keyInput` 会返回 false 且不产生任何输出, + // 因此这里作为"终端中真正可用"的键清单,由弹窗下拉与 JSON 校验共用。 + // 组合键由弹窗下方的三个修饰键控件(Ctrl / Alt / Shift)叠加产生。 + // ========================================== + + /// 终端可用命名键(导航键) + static const List terminalNavigationKeys = [ + KeyboardNamedKeyOption(value: 'arrowUp', group: TerminalKeyGroup.navigation, icon: 'arrow_up'), + KeyboardNamedKeyOption(value: 'arrowDown', group: TerminalKeyGroup.navigation, icon: 'arrow_down'), + KeyboardNamedKeyOption(value: 'arrowLeft', group: TerminalKeyGroup.navigation, icon: 'arrow_left'), + KeyboardNamedKeyOption(value: 'arrowRight', group: TerminalKeyGroup.navigation, icon: 'arrow_right'), + KeyboardNamedKeyOption(value: 'home', group: TerminalKeyGroup.navigation, icon: 'home'), + KeyboardNamedKeyOption(value: 'end', group: TerminalKeyGroup.navigation, icon: 'end'), + KeyboardNamedKeyOption(value: 'pageUp', group: TerminalKeyGroup.navigation, icon: 'page_up'), + KeyboardNamedKeyOption(value: 'pageDown', group: TerminalKeyGroup.navigation, icon: 'page_down'), ]; - /// 终端修饰键预设列表 - static const List terminalModifiers = [ - KeyboardValueOption(value: 'ctrl', label: 'Ctrl 键'), - KeyboardValueOption(value: 'alt', label: 'Alt 键'), + /// 终端可用命名键(编辑键) + static const List terminalEditingKeys = [ + KeyboardNamedKeyOption(value: 'escape', group: TerminalKeyGroup.editing, icon: 'escape'), + KeyboardNamedKeyOption(value: 'tab', group: TerminalKeyGroup.editing, icon: 'tab'), + KeyboardNamedKeyOption(value: 'backtab', group: TerminalKeyGroup.editing, icon: 'untab'), + KeyboardNamedKeyOption(value: 'returnKey', group: TerminalKeyGroup.editing, icon: 'enter'), + KeyboardNamedKeyOption(value: 'enter', group: TerminalKeyGroup.editing, icon: 'enter'), + KeyboardNamedKeyOption(value: 'numpadEnter', group: TerminalKeyGroup.editing, icon: 'enter'), + KeyboardNamedKeyOption(value: 'backspace', group: TerminalKeyGroup.editing, icon: 'backspace'), + KeyboardNamedKeyOption(value: 'delete', group: TerminalKeyGroup.editing, icon: 'delete'), + KeyboardNamedKeyOption(value: 'insert', group: TerminalKeyGroup.editing, icon: 'insert'), + KeyboardNamedKeyOption(value: 'space', group: TerminalKeyGroup.editing, icon: 'space'), + KeyboardNamedKeyOption(value: 'numpadClear', group: TerminalKeyGroup.editing, icon: 'clear'), ]; - /// 终端按键预设列表 - static const List terminalKeys = [ - KeyboardValueOption(value: 'esc', label: 'Esc (退出键)'), - KeyboardValueOption(value: 'terminal_tab', label: 'Tab (补全键)'), - KeyboardValueOption(value: 'ctrl_c', label: 'Ctrl + C (中断信号)'), - KeyboardValueOption(value: 'ctrl_d', label: 'Ctrl + D (EOF / 退出)'), - KeyboardValueOption(value: 'ctrl_z', label: 'Ctrl + Z (挂起挂起)'), - KeyboardValueOption(value: 'ctrl_l', label: 'Ctrl + L (清屏)'), - KeyboardValueOption(value: 'arrow_up', label: '方向上键 (历史上一条)'), - KeyboardValueOption(value: 'arrow_down', label: '方向下键 (历史下一条)'), - KeyboardValueOption(value: 'arrow_left', label: '方向左键'), - KeyboardValueOption(value: 'arrow_right', label: '方向右键'), + /// 终端可用命名键(功能键 F1~F12,统一用键盘图标) + static const List terminalFunctionKeys = [ + KeyboardNamedKeyOption(value: 'f1', group: TerminalKeyGroup.functionKeys, icon: 'keyboard'), + KeyboardNamedKeyOption(value: 'f2', group: TerminalKeyGroup.functionKeys, icon: 'keyboard'), + KeyboardNamedKeyOption(value: 'f3', group: TerminalKeyGroup.functionKeys, icon: 'keyboard'), + KeyboardNamedKeyOption(value: 'f4', group: TerminalKeyGroup.functionKeys, icon: 'keyboard'), + KeyboardNamedKeyOption(value: 'f5', group: TerminalKeyGroup.functionKeys, icon: 'keyboard'), + KeyboardNamedKeyOption(value: 'f6', group: TerminalKeyGroup.functionKeys, icon: 'keyboard'), + KeyboardNamedKeyOption(value: 'f7', group: TerminalKeyGroup.functionKeys, icon: 'keyboard'), + KeyboardNamedKeyOption(value: 'f8', group: TerminalKeyGroup.functionKeys, icon: 'keyboard'), + KeyboardNamedKeyOption(value: 'f9', group: TerminalKeyGroup.functionKeys, icon: 'keyboard'), + KeyboardNamedKeyOption(value: 'f10', group: TerminalKeyGroup.functionKeys, icon: 'keyboard'), + KeyboardNamedKeyOption(value: 'f11', group: TerminalKeyGroup.functionKeys, icon: 'keyboard'), + KeyboardNamedKeyOption(value: 'f12', group: TerminalKeyGroup.functionKeys, icon: 'keyboard'), ]; + + /// 终端全部可用命名键(31 个,按分组顺序拼接) + static const List terminalNamedKeys = [ + ...terminalNavigationKeys, + ...terminalEditingKeys, + ...terminalFunctionKeys, + ]; + + /// 终端字母键 keyA ~ keyZ(同样用键盘图标;配合下方修饰键控件可组成 Ctrl+C) + /// + /// 用 getter 而不是 `static final`:静态字段在热重载后不会重新初始化, + /// 会让这里的改动(例如给字母键补图标)"看起来没生效"。 + static List get terminalLetterKeys => [ + for (int i = 0; i < 26; i++) + KeyboardNamedKeyOption( + value: 'key${String.fromCharCode(0x41 + i)}', + group: TerminalKeyGroup.letters, + icon: 'keyboard', + ), + ]; + + /// 弹窗下拉可选的终端键(31 命名键 + 26 字母键) + static List get terminalSelectableKeys => [ + ...terminalNamedKeys, + ...terminalLetterKeys, + ]; + + /// 终端特殊键的紧凑显示名,用于按键标签自动生成(符号/缩写无需 l10n) + static String terminalKeyShortLabel(String value) { + switch (value) { + case 'escape': + return 'Esc'; + case 'tab': + return 'Tab'; + case 'backtab': + return '⇤'; + case 'returnKey': + case 'enter': + case 'numpadEnter': + return '⏎'; + case 'backspace': + return '⌫'; + case 'delete': + return 'Del'; + case 'insert': + return 'Ins'; + case 'space': + return 'Space'; + case 'numpadClear': + return 'Clear'; + case 'arrowUp': + return '↑'; + case 'arrowDown': + return '↓'; + case 'arrowLeft': + return '←'; + case 'arrowRight': + return '→'; + case 'home': + return 'Home'; + case 'end': + return 'End'; + case 'pageUp': + return 'PgUp'; + case 'pageDown': + return 'PgDn'; + default: + if (isLetterKeyName(value)) return value.substring(3); + if (value.length > 1 && value.startsWith('f') && int.tryParse(value.substring(1)) != null) { + return value.toUpperCase(); + } + return value; + } + } + + /// 终端 action 为 `key` 时的合法 value 集合(31 个命名键 + keyA~keyZ) + static Set get terminalSupportedKeyNames => { + for (final key in terminalNamedKeys) key.value, + for (int i = 0; i < 26; i++) 'key${String.fromCharCode(0x41 + i)}', + }; + + /// 是否为字母键名(keyA ~ keyZ) + static bool isLetterKeyName(String value) { + if (value.length != 4 || !value.startsWith('key')) return false; + final code = value.codeUnitAt(3); + return code >= 0x41 && code <= 0x5A; + } + + /// 判断终端 `key` 动作的 value 是否为受支持的键。 + /// + /// - 31 个命名键:任意修饰组合都可用 + /// - 字母键 keyA~keyZ:**不受修饰符约束**,单独成格时就是该字母本身 + /// (运行时走 `charInput`:裸字母发字母,Ctrl/Alt 组合发对应控制序列) + static bool isSupportedTerminalKey(String value) { + return terminalNamedKeys.any((k) => k.value == value) || isLetterKeyName(value); + } + + /// 修饰键动作允许的取值 + static const Set terminalModifierValues = {'ctrl', 'alt', 'shift'}; } /// 小键盘单个按键数据模型 @@ -152,25 +390,34 @@ class KeyboardKeyItem { final String? icon; /// 动作类型: - /// - 'input': 普通文本输入(默认) - /// - 'pair': 括号/引号等成对符号,支持选区包裹与光标偏移 - /// - 'command': 编辑器动作命令,例如 'cursor_left', 'tab', 'undo' 等 - /// - 'modifier': 终端修饰键,如 'ctrl', 'alt' - /// - 'terminal_key': 终端按键,如 'esc', 'ctrl_c' + /// - 'input': 普通文本输入(默认)。终端作用域下即"指令快捷键",配合 + /// [autoEnter] 可实现"输入并执行" + /// - 'pair': 括号/引号等成对符号,支持选区包裹与光标偏移(仅编辑区) + /// - 'command': 编辑器动作命令,例如 'cursor_left', 'tab', 'undo' 等(仅编辑区) + /// - 'modifier': 终端修饰键,取值 'ctrl' / 'alt' / 'shift'(仅终端) + /// - 'key': 终端特殊键,取值为 xterm `TerminalKey` 枚举名(仅终端) final String action; - /// 动作附带值(输入的文本或命令名称) + /// 动作附带值(输入的文本、命令名称或特殊键名) final String value; /// 光标插入后的相对偏移(如 pair \"()\" 插入后光标向左移动 1 位,则为 -1) final int cursorOffset; + /// 修饰符组合,仅终端 `key` 动作有效(文本通道不接受修饰符) + final KeyboardKeyMods mods; + + /// 仅终端 `input` 动作有效:发送文本后补一个回车符 `\r`,实现"输入即执行" + final bool autoEnter; + const KeyboardKeyItem({ required this.label, this.icon, this.action = 'input', required this.value, this.cursorOffset = 0, + this.mods = KeyboardKeyMods.none, + this.autoEnter = false, }); KeyboardKeyItem copyWith({ @@ -180,6 +427,8 @@ class KeyboardKeyItem { String? action, String? value, int? cursorOffset, + KeyboardKeyMods? mods, + bool? autoEnter, }) { return KeyboardKeyItem( label: label ?? this.label, @@ -187,6 +436,8 @@ class KeyboardKeyItem { action: action ?? this.action, value: value ?? this.value, cursorOffset: cursorOffset ?? this.cursorOffset, + mods: mods ?? this.mods, + autoEnter: autoEnter ?? this.autoEnter, ); } @@ -214,6 +465,8 @@ class KeyboardKeyItem { action: action, value: value, cursorOffset: cursorOffset, + mods: KeyboardKeyMods.fromJson(json['mods']), + autoEnter: json['autoEnter'] == true, ); } return const KeyboardKeyItem(label: '', value: ''); @@ -231,6 +484,12 @@ class KeyboardKeyItem { if (cursorOffset != 0) { map['cursorOffset'] = cursorOffset; } + if (mods.isNotEmpty) { + map['mods'] = mods.toJson(); + } + if (autoEnter) { + map['autoEnter'] = true; + } return map; } } @@ -339,8 +598,12 @@ class VirtualKeyboardConfig { }; } - /// 校验 JSON 文本合法性,若合法返回 null,若非法返回具体错误描述 - static String? validateJson(String jsonStr) { + /// 校验 JSON 文本合法性,若合法返回 null,若非法返回具体错误描述。 + /// + /// [scope] 决定按键动作与取值的合法集合: + /// - 编辑区:`input` / `pair` / `command` + /// - 终端:`input`(指令快捷键)/ `modifier` / `key`(特殊键) + static String? validateJson(String jsonStr, [KeyboardScope scope = KeyboardScope.editor]) { final trimmed = jsonStr.trim(); if (trimmed.isEmpty) { return '配置内容不能为空'; @@ -435,6 +698,12 @@ class VirtualKeyboardConfig { if (key.containsKey('cursorOffset') && key['cursorOffset'] is! int) { return '第 $pageNum 页第 $rowNum 行第 $keyNum 个按键的 "cursorOffset" 必须为整数'; } + final actionError = _validateKeyAction( + key: key, + scope: scope, + location: '第 $pageNum 页第 $rowNum 行第 $keyNum 个按键', + ); + if (actionError != null) return actionError; } else { return '第 $pageNum 页第 $rowNum 行第 $keyNum 个按键类型错误,只能是文本字符串或对象'; } @@ -445,9 +714,140 @@ class VirtualKeyboardConfig { return null; } - /// 默认配置预设 + /// 按作用域校验单个按键对象的 action / value / mods / autoEnter 组合。 + /// + /// 返回 null 表示合法;否则返回可直接展示给用户的错误描述。 + /// 这里的严格程度是刻意为之:宁可保存时报错,也不要在运行时静默无输出 + /// (例如把 digit1 当作终端特殊键,或给文本通道挂修饰符)。 + static String? _validateKeyAction({ + required Map key, + required KeyboardScope scope, + required String location, + }) { + final action = key['action']?.toString() ?? 'input'; + final value = key['value']?.toString() ?? ''; + final mods = KeyboardKeyMods.fromJson(key['mods']); + + if (key.containsKey('mods') && key['mods'] != null && key['mods'] is! Map) { + return '$location 的 "mods" 必须是对象,例如 {"ctrl": true}'; + } + + if (scope == KeyboardScope.editor) { + if (!KeyboardScopeHelper.editorActionValues.contains(action)) { + return '$location 的动作 "$action" 不适用于编辑区,可用动作: ' + '${KeyboardScopeHelper.editorActionValues.join(' / ')}'; + } + return null; + } + + // 终端作用域 + if (!KeyboardScopeHelper.terminalActionValues.contains(action)) { + return '$location 的动作 "$action" 不适用于终端,可用动作: ' + '${KeyboardScopeHelper.terminalActionValues.join(' / ')}'; + } + + switch (action) { + case 'modifier': + if (!KeyboardScopeHelper.terminalModifierValues.contains(value)) { + return '$location 的修饰键取值 "$value" 无效,只能是 ' + '${KeyboardScopeHelper.terminalModifierValues.join(' / ')}'; + } + if (mods.isNotEmpty) { + return '$location 是修饰键动作,不应再附带 "mods"'; + } + return null; + + case 'key': + if (value.isEmpty) { + return '$location 缺少特殊键值 ("value")'; + } + if (!KeyboardScopeHelper.isSupportedTerminalKey(value)) { + return '$location 的特殊键 "$value" 在终端中不会产生任何输出,' + '请选择受支持的命名键(如 escape / tab / arrowUp / f1)或字母键 keyA ~ keyZ'; + } + return null; + + case 'input': + default: + if (value.isEmpty) { + return '$location 缺少文本内容 ("value")'; + } + if (mods.isNotEmpty) { + return '$location 是文本指令,附加 "mods" 不会生效' + '(终端文本通道不接受修饰符,请改用"特殊键"类型)'; + } + return null; + } + } + + /// 默认配置预设(编辑区) static VirtualKeyboardConfig defaultConfiguration() => _defaultConfig(); + /// 按作用域返回默认配置预设 + static VirtualKeyboardConfig defaultForScope(KeyboardScope scope) => + scope == KeyboardScope.terminal ? defaultTerminalConfiguration() : _defaultConfig(); + + /// ## 终端小键盘 JSON 结构 + /// + /// ```json + /// { + /// "pages": [ + /// { "count": 7, "keys": [ [ , , ... ], ... ] } + /// ] + /// } + /// ``` + /// + /// 终端作用域下 `` 有三种动作: + /// + /// - **指令快捷键**:`{"label":"cd ..","action":"input","value":"cd ..","autoEnter":true}` + /// `autoEnter` 为 true 时,发送文本后再补一个回车符 `\r`(等价于按下回车), + /// 实现"一格执行命令";value 已以 `\r`/`\n` 结尾时不会重复补。 + /// - **特殊键**:`{"label":"^C","action":"key","value":"keyC","mods":{"ctrl":true}}` + /// - `value` 取 xterm `TerminalKey` 的枚举名,可用集合见 + /// [KeyboardScopeHelper.terminalNamedKeys](31 个命名键)与 + /// [KeyboardScopeHelper.terminalSupportedKeyNames](再加 keyA~keyZ) + /// - `mods` 形如 `{"ctrl":bool,"alt":bool,"shift":bool}`,**仅 `key` 动作有效**; + /// 字母键必须且只能单独搭配 Ctrl 或 Alt,这是 xterm 输入链路的硬限制 + /// - **修饰键**:`{"label":"Ctrl","action":"modifier","value":"ctrl"}` + /// `value` ∈ {ctrl, alt, shift},只切换运行时状态(单击一次性 / 双击锁定),不产生输出。 + /// + /// 编辑区作用域继续使用 `input` / `pair` / `command`;`mods` 与 `autoEnter` + /// 在无值时导出省略,因此既有编辑区配置零迁移。 + /// + /// 默认终端配置预设:两行特殊键 + 修饰键 + /// + /// 行1:Esc Tab Ctrl Alt - ↑ 回车 + /// 行2:Ins End Shift : ← ↓ → + static VirtualKeyboardConfig defaultTerminalConfiguration() { + return const VirtualKeyboardConfig( + pages: [ + KeyboardPageItem( + count: 7, + keys: [ + [ + KeyboardKeyItem(label: 'Esc', action: 'key', value: 'escape'), + KeyboardKeyItem(label: 'Tab', icon: 'tab', action: 'key', value: 'tab'), + KeyboardKeyItem(label: 'Ctrl', action: 'modifier', value: 'ctrl'), + KeyboardKeyItem(label: 'Alt', action: 'modifier', value: 'alt'), + KeyboardKeyItem(label: '-', action: 'input', value: '-'), + KeyboardKeyItem(label: '↑', icon: 'arrow_up', action: 'key', value: 'arrowUp'), + KeyboardKeyItem(label: '回车', icon: 'enter', action: 'key', value: 'enter'), + ], + [ + KeyboardKeyItem(label: 'Ins', action: 'key', value: 'insert'), + KeyboardKeyItem(label: 'End', action: 'key', value: 'end'), + KeyboardKeyItem(label: 'Shift', action: 'modifier', value: 'shift'), + KeyboardKeyItem(label: ':', action: 'input', value: ':'), + KeyboardKeyItem(label: '←', icon: 'arrow_left', action: 'key', value: 'arrowLeft'), + KeyboardKeyItem(label: '↓', icon: 'arrow_down', action: 'key', value: 'arrowDown'), + KeyboardKeyItem(label: '→', icon: 'arrow_right', action: 'key', value: 'arrowRight'), + ], + ], + ), + ], + ); + } + static VirtualKeyboardConfig _defaultConfig() { return const VirtualKeyboardConfig( pages: [ @@ -461,8 +861,8 @@ class VirtualKeyboardConfig { KeyboardKeyItem(label: '()', action: 'pair', value: '()', cursorOffset: -1), KeyboardKeyItem(label: '[]', action: 'pair', value: '[]', cursorOffset: -1), KeyboardKeyItem(label: '{}', action: 'pair', value: '{}', cursorOffset: -1), - KeyboardKeyItem(label: '撤销', icon: 'undo', action: 'command', value: 'undo'), - KeyboardKeyItem(label: '重做', icon: 'redo', action: 'command', value: 'redo'), + KeyboardKeyItem(label: 'Undo', icon: 'undo', action: 'command', value: 'undo'), + KeyboardKeyItem(label: 'Redo', icon: 'redo', action: 'command', value: 'redo'), ], [ KeyboardKeyItem(label: '<-', icon: 'arrow_left', action: 'command', value: 'cursor_left'), @@ -503,9 +903,19 @@ class VirtualKeyboardConfig { ); } - /// 转换为格式化好的默认 JSON 字符串 + /// 转换为格式化好的默认 JSON 字符串(编辑区) static String defaultJsonPretty() { const encoder = JsonEncoder.withIndent(' '); return encoder.convert(_defaultConfig().toJson()); } + + /// 转换为格式化好的默认 JSON 字符串(终端) + static String defaultTerminalJsonPretty() { + const encoder = JsonEncoder.withIndent(' '); + return encoder.convert(defaultTerminalConfiguration().toJson()); + } + + /// 按作用域返回格式化好的默认 JSON 字符串 + static String defaultJsonPrettyFor(KeyboardScope scope) => + scope == KeyboardScope.terminal ? defaultTerminalJsonPretty() : defaultJsonPretty(); } diff --git a/lib/providers/project_provider.dart b/lib/providers/project_provider.dart index 9234d8e..5a08119 100644 --- a/lib/providers/project_provider.dart +++ b/lib/providers/project_provider.dart @@ -25,6 +25,9 @@ class ProjectProvider extends ChangeNotifier { //是否正在加载项目 bool _isLoading = false; + //是否显示隐藏文件 + bool _showHiddenFiles = true; + // 跨 Provider 协同回调 void Function(String oldPath, String newPath)? onEntityRenamed; void Function(String deletedPath)? onEntityDeleted; @@ -37,10 +40,18 @@ class ProjectProvider extends ChangeNotifier { List get openDirectoryPaths => _history.openDirectoryPaths; List get items => _items; bool get isLoading => _isLoading; + bool get showHiddenFiles => _showHiddenFiles; FileItem? get cutItem => _cutItem; FileItem? get copiedItem => _copiedItem; bool get canPaste => _cutItem != null || _copiedItem != null; + void updateShowHiddenFiles(bool show) { + if (_showHiddenFiles != show) { + _showHiddenFiles = show; + refreshTree(); + } + } + bool isItemCut(String path) { if (_cutItem == null) return false; return _cutItem!.path == path || _cutItem!.path.trim() == path.trim(); @@ -88,6 +99,7 @@ class ProjectProvider extends ChangeNotifier { ? await FileService.instance.buildTree( cleanPath, openDirectoryPaths: validOpenPaths, + showHiddenFiles: _showHiddenFiles, ) : []; @@ -187,6 +199,7 @@ class ProjectProvider extends ChangeNotifier { item.path, depth: item.depth + 1, openDirectoryPaths: updatedOpenPaths, + showHiddenFiles: _showHiddenFiles, ); item.children.clear(); item.children.addAll(children); @@ -218,6 +231,7 @@ class ProjectProvider extends ChangeNotifier { final items = await FileService.instance.buildTree( currentRoot, openDirectoryPaths: _history.openDirectoryPaths, + showHiddenFiles: _showHiddenFiles, ); String? currentFile = _history.lastOpenedFilePath; diff --git a/lib/providers/run_provider.dart b/lib/providers/run_provider.dart new file mode 100644 index 0000000..2eeb99b --- /dev/null +++ b/lib/providers/run_provider.dart @@ -0,0 +1,158 @@ +import 'package:flutter/material.dart'; +import '../models/run_task.dart'; +import '../services/project_task_detector.dart'; +import '../services/run_task_storage_service.dart'; + +/// 运行任务状态管理 Provider +class RunProvider extends ChangeNotifier { + final RunTaskStorageService _storageService; + + RunProvider({RunTaskStorageService? storageService}) + : _storageService = storageService ?? RunTaskStorageService(); + + /// 内存中保存的系统动态探测任务列表(不落盘) + List _detectedTasks = []; + + /// 用户持久化配置的自定义任务列表(存放在 .code_editor/run_tasks.json) + List _customTasks = []; + + /// 最近一次运行的任务ID(持久化保存) + String? _lastRunTaskId; + + /// 最近一次运行的任务(如果有) + RunTask? _lastRunTask; + + /// 是否正在探测中(探测期间互斥,防止并发与按钮连点) + bool _isDetecting = false; + + /// 当前绑定的工程根路径 + String? _currentProjectRoot; + + List get detectedTasks => List.unmodifiable(_detectedTasks); + List get customTasks => List.unmodifiable(_customTasks); + RunTask? get lastRunTask => _lastRunTask; + String? get lastRunTaskId => _lastRunTaskId; + bool get isDetecting => _isDetecting; + String? get currentProjectRoot => _currentProjectRoot; + + /// 获取当前合并后的所有可用任务列表(自定义任务置顶,随后为探测任务) + List get allTasks => [..._customTasks, ..._detectedTasks]; + + /// 内部方法:尝试从现有任务列表中匹配 lastRunTaskId + void _resolveLastRunTask() { + if (_lastRunTaskId == null) return; + for (final task in allTasks) { + if (task.id == _lastRunTaskId) { + _lastRunTask = task; + return; + } + } + } + + /// 记录最近一次执行的任务并持久化 + Future setLastRunTask(RunTask task) async { + _lastRunTask = task; + _lastRunTaskId = task.id; + notifyListeners(); + + if (_currentProjectRoot != null) { + await _storageService.saveConfig( + projectRoot: _currentProjectRoot!, + tasks: _customTasks, + lastRunTaskId: _lastRunTaskId, + ); + } + } + + /// 当打开或切换工程时初始化任务(读取持久化任务 + 首次自动探测系统任务) + Future onProjectOpened(String projectRoot, {String? activeFilePath}) async { + _currentProjectRoot = projectRoot; + // 1. 加载持久化的自定义任务与最近运行任务ID + final config = await _storageService.loadConfig(projectRoot); + _customTasks = config.tasks; + _lastRunTaskId = config.lastRunTaskId; + _resolveLastRunTask(); + notifyListeners(); + + // 2. 自动触发一次系统探测 + await detectTasks(projectRoot: projectRoot, currentFilePath: activeFilePath); + } + + /// 关闭工程时清理状态 + void onProjectClosed() { + _currentProjectRoot = null; + _detectedTasks = []; + _customTasks = []; + _lastRunTaskId = null; + _lastRunTask = null; + _isDetecting = false; + notifyListeners(); + } + + /// 手动或自动触发项目探测 + /// [projectRoot] 目标工程路径 + /// [currentFilePath] 当前激活的编辑器文件路径 + Future detectTasks({ + required String projectRoot, + String? currentFilePath, + }) async { + if (_isDetecting) return; + + _isDetecting = true; + // 清空内存中的旧探测结果 + _detectedTasks = []; + notifyListeners(); + + try { + final detected = await ProjectTaskDetector.detect( + projectRoot: projectRoot, + currentFilePath: currentFilePath, + ); + _detectedTasks = detected; + _resolveLastRunTask(); + } catch (e) { + debugPrint('[RunProvider] 项目探测失败: $e'); + } finally { + _isDetecting = false; + notifyListeners(); + } + } + + /// 保存并更新用户自定义任务 + Future updateCustomTasks(List updatedTasks) async { + if (_currentProjectRoot == null) return; + + _customTasks = List.from(updatedTasks); + _resolveLastRunTask(); + notifyListeners(); + + await _storageService.saveConfig( + projectRoot: _currentProjectRoot!, + tasks: _customTasks, + lastRunTaskId: _lastRunTaskId, + ); + } + + /// 添加单个自定义任务 + Future addCustomTask(RunTask task) async { + final list = List.from(_customTasks); + list.add(task); + await updateCustomTasks(list); + } + + /// 删除单个自定义任务 + Future removeCustomTask(String taskId) async { + final list = _customTasks.where((t) => t.id != taskId).toList(); + await updateCustomTasks(list); + } + + /// 修改单个自定义任务 + Future editCustomTask(RunTask task) async { + final index = _customTasks.indexWhere((t) => t.id == task.id); + if (index != -1) { + final list = List.from(_customTasks); + list[index] = task; + await updateCustomTasks(list); + } + } +} diff --git a/lib/providers/settings_provider.dart b/lib/providers/settings_provider.dart index 1b1c98c..9e8ab6e 100644 --- a/lib/providers/settings_provider.dart +++ b/lib/providers/settings_provider.dart @@ -9,6 +9,7 @@ import 'package:shared_preferences/shared_preferences.dart'; class SettingsProvider extends ChangeNotifier { //外观 static const String _keyAppThemeMode = 'app_theme_mode'; //应用主题 + static const String _keyAppThemeColor = 'app_theme_color'; //主题颜色 static const String _keyUiFont = 'app_ui_font'; //界面字体 //编辑区 @@ -22,24 +23,39 @@ class SettingsProvider extends ChangeNotifier { //终端 static const String _keyTerminalFont = 'terminal_font_family'; //终端字体 + static const String _keyTerminalBackgroundColor = 'terminal_background_color'; //终端背景颜色 + static const String _keyEnableTerminalVirtualKeyboard = 'enable_terminal_virtual_keyboard'; //终端小键盘启用 + static const String _keyTerminalKeyboardConfig = 'terminal_virtual_keyboard_config'; //终端小键盘配置JSON + + //项目配置 + static const String _keyShowHiddenFiles = 'show_hidden_files'; //显示隐藏文件 //语言 static const String _keyAppLocale = 'app_locale'; ThemeMode _appThemeMode = ThemeMode.system; + Color _appThemeColor = Colors.blue; String _uiFontId = 'system_default'; EditorTheme _editorTheme = EditorTheme.atomOneDark; String _editorFontId = 'jetbrains_mono'; String _terminalFontId = 'jetbrains_mono'; + Color _terminalBackgroundColor = const Color(0xFF1E1E1E); double _fontSize = 14.0; int _indentSize = 4; bool _wordWrap = false; bool _enableVirtualKeyboard = defaultTargetPlatform == TargetPlatform.android || defaultTargetPlatform == TargetPlatform.iOS; String _virtualKeyboardConfigJson = VirtualKeyboardConfig.defaultJsonPretty(); VirtualKeyboardConfig _virtualKeyboardConfig = VirtualKeyboardConfig.defaultConfiguration(); + bool _enableTerminalVirtualKeyboard = defaultTargetPlatform == TargetPlatform.android || defaultTargetPlatform == TargetPlatform.iOS; + String _terminalKeyboardConfigJson = VirtualKeyboardConfig.defaultTerminalJsonPretty(); + VirtualKeyboardConfig _terminalKeyboardConfig = VirtualKeyboardConfig.defaultTerminalConfiguration(); + bool _showHiddenFiles = true; Locale? _locale; + bool get showHiddenFiles => _showHiddenFiles; + ThemeMode get appThemeMode => _appThemeMode; + Color get appThemeColor => _appThemeColor; String get uiFontId => _uiFontId; AppFontItem get uiFont => AppFonts.getUiFont(_uiFontId); @@ -49,6 +65,7 @@ class SettingsProvider extends ChangeNotifier { String get terminalFontId => _terminalFontId; AppFontItem get terminalFont => AppFonts.getTerminalFont(_terminalFontId); + Color get terminalBackgroundColor => _terminalBackgroundColor; double get fontSize => _fontSize; int get indentSize => _indentSize; @@ -56,8 +73,89 @@ class SettingsProvider extends ChangeNotifier { bool get enableVirtualKeyboard => _enableVirtualKeyboard; String get virtualKeyboardConfigJson => _virtualKeyboardConfigJson; VirtualKeyboardConfig get virtualKeyboardConfig => _virtualKeyboardConfig; + bool get enableTerminalVirtualKeyboard => _enableTerminalVirtualKeyboard; + String get terminalKeyboardConfigJson => _terminalKeyboardConfigJson; + VirtualKeyboardConfig get terminalKeyboardConfig => _terminalKeyboardConfig; Locale? get locale => _locale; + // ========================================== + // 小键盘配置:按作用域(编辑区 / 终端)读写两份互不干扰的配置 + // ========================================== + + /// 读取指定作用域的键盘配置 + VirtualKeyboardConfig keyboardConfigFor(KeyboardScope scope) => + scope == KeyboardScope.terminal ? _terminalKeyboardConfig : _virtualKeyboardConfig; + + /// 读取指定作用域的键盘配置 JSON + String keyboardConfigJsonFor(KeyboardScope scope) => + scope == KeyboardScope.terminal ? _terminalKeyboardConfigJson : _virtualKeyboardConfigJson; + + /// 指定作用域的小键盘是否启用(两个开关相互独立) + bool keyboardEnabledFor(KeyboardScope scope) => + scope == KeyboardScope.terminal ? _enableTerminalVirtualKeyboard : _enableVirtualKeyboard; + + static String _enablePrefKey(KeyboardScope scope) => + scope == KeyboardScope.terminal ? _keyEnableTerminalVirtualKeyboard : _keyEnableVirtualKeyboard; + + static String _configPrefKey(KeyboardScope scope) => + scope == KeyboardScope.terminal ? _keyTerminalKeyboardConfig : _keyVirtualKeyboardConfig; + + /// 设置指定作用域小键盘的启用状态 + Future setKeyboardEnabled(KeyboardScope scope, bool enable) async { + if (keyboardEnabledFor(scope) == enable) return; + if (scope == KeyboardScope.terminal) { + _enableTerminalVirtualKeyboard = enable; + } else { + _enableVirtualKeyboard = enable; + } + notifyListeners(); + try { + final prefs = await SharedPreferences.getInstance(); + await prefs.setBool(_enablePrefKey(scope), enable); + } catch (_) {} + } + + /// 保存指定作用域的键盘配置 JSON,校验失败返回 false + Future setKeyboardConfig(KeyboardScope scope, String jsonStr) async { + final err = VirtualKeyboardConfig.validateJson(jsonStr, scope); + if (err != null) { + return false; + } + try { + final decoded = jsonDecode(jsonStr) as Map; + final config = VirtualKeyboardConfig.fromJson(decoded); + if (scope == KeyboardScope.terminal) { + _terminalKeyboardConfig = config; + _terminalKeyboardConfigJson = jsonStr; + } else { + _virtualKeyboardConfig = config; + _virtualKeyboardConfigJson = jsonStr; + } + notifyListeners(); + final prefs = await SharedPreferences.getInstance(); + await prefs.setString(_configPrefKey(scope), jsonStr); + return true; + } catch (_) { + return false; + } + } + + /// 将指定作用域的键盘配置恢复为该作用域的默认预设 + Future resetKeyboardConfig(KeyboardScope scope) async { + if (scope == KeyboardScope.terminal) { + _terminalKeyboardConfig = VirtualKeyboardConfig.defaultTerminalConfiguration(); + _terminalKeyboardConfigJson = VirtualKeyboardConfig.defaultTerminalJsonPretty(); + } else { + _virtualKeyboardConfig = VirtualKeyboardConfig.defaultConfiguration(); + _virtualKeyboardConfigJson = VirtualKeyboardConfig.defaultJsonPretty(); + } + notifyListeners(); + try { + final prefs = await SharedPreferences.getInstance(); + await prefs.remove(_configPrefKey(scope)); + } catch (_) {} + } + Future init() async { await _loadSettings(); } @@ -75,6 +173,11 @@ class SettingsProvider extends ChangeNotifier { ); } + final savedThemeColor = prefs.getInt(_keyAppThemeColor); + if (savedThemeColor != null) { + _appThemeColor = Color(savedThemeColor); + } + //设置编辑区 final themeId = prefs.getString(_keyEditorTheme); _editorTheme = EditorTheme.fromId(themeId); @@ -102,7 +205,7 @@ class SettingsProvider extends ChangeNotifier { final savedKeyboardConfig = prefs.getString(_keyVirtualKeyboardConfig); if (savedKeyboardConfig != null && savedKeyboardConfig.trim().isNotEmpty) { - final err = VirtualKeyboardConfig.validateJson(savedKeyboardConfig); + final err = VirtualKeyboardConfig.validateJson(savedKeyboardConfig, KeyboardScope.editor); if (err == null) { try { final decoded = jsonDecode(savedKeyboardConfig) as Map; @@ -112,6 +215,24 @@ class SettingsProvider extends ChangeNotifier { } } + //终端小键盘(独立开关 + 独立配置) + final savedEnableTerminalKeyboard = prefs.getBool(_keyEnableTerminalVirtualKeyboard); + if (savedEnableTerminalKeyboard != null) { + _enableTerminalVirtualKeyboard = savedEnableTerminalKeyboard; + } + + final savedTerminalKeyboardConfig = prefs.getString(_keyTerminalKeyboardConfig); + if (savedTerminalKeyboardConfig != null && savedTerminalKeyboardConfig.trim().isNotEmpty) { + final err = VirtualKeyboardConfig.validateJson(savedTerminalKeyboardConfig, KeyboardScope.terminal); + if (err == null) { + try { + final decoded = jsonDecode(savedTerminalKeyboardConfig) as Map; + _terminalKeyboardConfig = VirtualKeyboardConfig.fromJson(decoded); + _terminalKeyboardConfigJson = savedTerminalKeyboardConfig; + } catch (_) {} + } + } + //设置字体 final savedUiFont = prefs.getString(_keyUiFont); if (savedUiFont != null && savedUiFont.isNotEmpty) { @@ -128,6 +249,17 @@ class SettingsProvider extends ChangeNotifier { _terminalFontId = savedTerminalFont; } + final savedTerminalBackground = prefs.getInt(_keyTerminalBackgroundColor); + if (savedTerminalBackground != null) { + _terminalBackgroundColor = Color(savedTerminalBackground); + } + + //设置项目配置 + final savedShowHiddenFiles = prefs.getBool(_keyShowHiddenFiles); + if (savedShowHiddenFiles != null) { + _showHiddenFiles = savedShowHiddenFiles; + } + //设置语言 final savedLocale = prefs.getString(_keyAppLocale); if(savedLocale != null && savedLocale.isNotEmpty) { @@ -150,6 +282,17 @@ class SettingsProvider extends ChangeNotifier { }catch (_) {} } + /// 设置主题颜色(Material 3 的 seed color) + Future setAppThemeColor(Color color) async { + if (_appThemeColor.toARGB32() == color.toARGB32()) return; + _appThemeColor = color; + notifyListeners(); + try { + final prefs = await SharedPreferences.getInstance(); + await prefs.setInt(_keyAppThemeColor, color.toARGB32()); + } catch (_) {} + } + Future setEditorTheme(EditorTheme theme) async { if(_editorTheme.id == theme.id) return; _editorTheme = theme; @@ -192,43 +335,17 @@ class SettingsProvider extends ChangeNotifier { }catch (_) {} } - Future setEnableVirtualKeyboard(bool enable) async { - if (_enableVirtualKeyboard == enable) return; - _enableVirtualKeyboard = enable; - notifyListeners(); - try { - final prefs = await SharedPreferences.getInstance(); - await prefs.setBool(_keyEnableVirtualKeyboard, enable); - } catch (_) {} - } + /// 编辑区小键盘开关(等价于 `setKeyboardEnabled(KeyboardScope.editor, ...)`) + Future setEnableVirtualKeyboard(bool enable) => + setKeyboardEnabled(KeyboardScope.editor, enable); - Future setVirtualKeyboardConfig(String jsonStr) async { - final err = VirtualKeyboardConfig.validateJson(jsonStr); - if (err != null) { - return false; - } - try { - final decoded = jsonDecode(jsonStr) as Map; - _virtualKeyboardConfig = VirtualKeyboardConfig.fromJson(decoded); - _virtualKeyboardConfigJson = jsonStr; - notifyListeners(); - final prefs = await SharedPreferences.getInstance(); - await prefs.setString(_keyVirtualKeyboardConfig, jsonStr); - return true; - } catch (_) { - return false; - } - } + /// 编辑区小键盘配置(等价于 `setKeyboardConfig(KeyboardScope.editor, ...)`) + Future setVirtualKeyboardConfig(String jsonStr) => + setKeyboardConfig(KeyboardScope.editor, jsonStr); - Future resetVirtualKeyboardConfig() async { - _virtualKeyboardConfig = VirtualKeyboardConfig.defaultConfiguration(); - _virtualKeyboardConfigJson = VirtualKeyboardConfig.defaultJsonPretty(); - notifyListeners(); - try { - final prefs = await SharedPreferences.getInstance(); - await prefs.remove(_keyVirtualKeyboardConfig); - } catch (_) {} - } + /// 编辑区小键盘恢复默认 + Future resetVirtualKeyboardConfig() => + resetKeyboardConfig(KeyboardScope.editor); Future setLocale(Locale? newLocale) async { if(_locale == newLocale) return; @@ -273,4 +390,26 @@ class SettingsProvider extends ChangeNotifier { await prefs.setString(_keyTerminalFont, fontId); } catch (_) {} } + + /// 设置终端背景颜色 + Future setTerminalBackgroundColor(Color color) async { + if (_terminalBackgroundColor.toARGB32() == color.toARGB32()) return; + _terminalBackgroundColor = color; + notifyListeners(); + try { + final prefs = await SharedPreferences.getInstance(); + await prefs.setInt(_keyTerminalBackgroundColor, color.toARGB32()); + } catch (_) {} + } + + /// 设置是否显示隐藏文件 + Future setShowHiddenFiles(bool show) async { + if (_showHiddenFiles == show) return; + _showHiddenFiles = show; + notifyListeners(); + try { + final prefs = await SharedPreferences.getInstance(); + await prefs.setBool(_keyShowHiddenFiles, show); + } catch (_) {} + } } diff --git a/lib/providers/terminal_provider.dart b/lib/providers/terminal_provider.dart index 81141bf..b671308 100644 --- a/lib/providers/terminal_provider.dart +++ b/lib/providers/terminal_provider.dart @@ -34,10 +34,12 @@ class TerminalProvider extends ChangeNotifier { /// 创建新会话 /// [distroId]: 发行版标识符(如 'alpine', 'host') + /// [workspacePath]: 绑定的工程根目录路径(挂载至容器内部的 /workspace) /// [activate]: 是否自动跳转切换到该会话。抽屉右上角加号点击时为 false(直接添加但不跳转)。 TerminalSession createSession({ String? name, String distroId = 'alpine', + String? workspacePath, bool activate = false, bool autoStartProcess = true, }) { @@ -47,7 +49,11 @@ class TerminalProvider extends ChangeNotifier { id: 'session_${DateTime.now().microsecondsSinceEpoch}_$nextIndex', name: sessionName, distroId: distroId, + workspacePath: workspacePath, autoStartProcess: autoStartProcess, + onProcessTerminated: () { + notifyListeners(); + }, ); _sessions.add(session); @@ -60,6 +66,28 @@ class TerminalProvider extends ChangeNotifier { return session; } + /// 查找或复用绑定了指定工程路径的终端会话 + /// 如果存在,直接激活并返回;如果不存在,则新建并激活一个会话 + TerminalSession getOrCreateSessionForProject({ + required String projectRoot, + String distroId = 'alpine', + String? sessionName, + }) { + final index = _sessions.indexWhere((s) => s.workspacePath == projectRoot); + if (index != -1) { + selectSession(index); + return _sessions[index]; + } + + return createSession( + name: sessionName, + distroId: distroId, + workspacePath: projectRoot, + activate: true, + autoStartProcess: true, + ); + } + /// 切换当前激活的会话 void selectSession(int index) { if (index >= 0 && index < _sessions.length) { diff --git a/lib/services/file_service.dart b/lib/services/file_service.dart index c9c9fe8..993d7cc 100644 --- a/lib/services/file_service.dart +++ b/lib/services/file_service.dart @@ -14,6 +14,7 @@ class FileService { int depth = 0, List openDirectoryPaths = const [], int maxDepth = 10, + bool showHiddenFiles = true, }) async { if(depth > maxDepth) { return []; @@ -45,7 +46,7 @@ class FileService { for(var entity in entities) { try { final fileName = p.basename(entity.path); - if (fileName.startsWith('.')) continue; + if (!showHiddenFiles && fileName.startsWith('.')) continue; final entityPath = p.normalize(entity.path); String? relativePath; @@ -64,6 +65,7 @@ class FileService { depth: depth + 1, openDirectoryPaths: openDirectoryPaths, maxDepth: maxDepth, + showHiddenFiles: showHiddenFiles, ); } items.add(FileItem( diff --git a/lib/services/project_task_detector.dart b/lib/services/project_task_detector.dart new file mode 100644 index 0000000..fb8e7a8 --- /dev/null +++ b/lib/services/project_task_detector.dart @@ -0,0 +1,279 @@ +import 'dart:io'; +import 'package:flutter/material.dart'; +import 'package:path/path.dart' as p; +import '../models/run_task.dart'; + +/// 负责根据工程文件和当前打开的文件,在内存中动态推导可用的运行任务 +class ProjectTaskDetector { + /// 核心探测入口 + /// [projectRoot]: 工程根目录(宿主绝对路径) + /// [currentFilePath]: 当前编辑器激活打开的文件(宿主绝对路径,可能为 null) + static Future> detect({ + required String projectRoot, + String? currentFilePath, + }) async { + final List tasks = []; + final projectDir = Directory(projectRoot); + if (!projectDir.existsSync()) { + return tasks; + } + + // 1. 工程级特征文件检测 + tasks.addAll(await _detectProjectBuildTasks(projectRoot)); + + // 2. 当前活跃文件(单文件运行)检测 + if (currentFilePath != null && currentFilePath.isNotEmpty) { + final singleTask = _detectSingleFileTask(projectRoot, currentFilePath); + if (singleTask != null) { + // 单文件即时运行置于首位,方便用户直接点击运行 + tasks.insert(0, singleTask); + } + } + + return tasks; + } + + /// 探测构建工程任务(CMake / Gradle / Makefile / npm / Cargo / Dart 等) + static Future> _detectProjectBuildTasks(String projectRoot) async { + final List buildTasks = []; + + // 1. CMakeLists.txt + final cmakeFile = File(p.join(projectRoot, 'CMakeLists.txt')); + if (cmakeFile.existsSync()) { + final projectName = p.basename(projectRoot); + buildTasks.addAll([ + RunTask( + id: 'detected_cmake_build_run', + name: 'CMake: Build & Run', + command: 'cmake -B build && cmake --build build && ./build/$projectName', + source: TaskSource.detected, + description: '配置、编译并尝试启动生成的目标程序', + icon: Icons.play_circle_outline, + ), + RunTask( + id: 'detected_cmake_build', + name: 'CMake: Build Only', + command: 'cmake -B build && cmake --build build', + source: TaskSource.detected, + description: '仅执行 cmake 生成与构建', + icon: Icons.build_outlined, + ), + RunTask( + id: 'detected_cmake_clean', + name: 'CMake: Clean', + command: 'rm -rf build', + source: TaskSource.detected, + description: '清理构建缓存目录', + icon: Icons.cleaning_services_outlined, + ), + ]); + } + + // 2. Gradle (build.gradle / gradlew) + final gradlewFile = File(p.join(projectRoot, 'gradlew')); + final gradleFile = File(p.join(projectRoot, 'build.gradle')); + final gradleKtsFile = File(p.join(projectRoot, 'build.gradle.kts')); + if (gradlewFile.existsSync() || gradleFile.existsSync() || gradleKtsFile.existsSync()) { + final exec = gradlewFile.existsSync() ? './gradlew' : 'gradle'; + buildTasks.addAll([ + RunTask( + id: 'detected_gradle_run', + name: 'Gradle: Run', + command: '$exec run', + source: TaskSource.detected, + description: '执行应用程序主入口', + icon: Icons.play_circle_outline, + ), + RunTask( + id: 'detected_gradle_assemble', + name: 'Gradle: Assemble Debug', + command: '$exec assembleDebug', + source: TaskSource.detected, + description: '构建调试输出包', + icon: Icons.build_outlined, + ), + RunTask( + id: 'detected_gradle_build', + name: 'Gradle: Build', + command: '$exec build', + source: TaskSource.detected, + description: '执行完整构建与测试', + icon: Icons.done_all_outlined, + ), + ]); + } + + // 3. Makefile + final makeFile = File(p.join(projectRoot, 'Makefile')); + if (makeFile.existsSync()) { + buildTasks.add( + const RunTask( + id: 'detected_make_default', + name: 'Make: Default', + command: 'make', + source: TaskSource.detected, + description: '执行默认 Makefile 构建目标', + icon: Icons.build_circle_outlined, + ), + ); + } + + // 4. package.json (Node/Web) + final packageJsonFile = File(p.join(projectRoot, 'package.json')); + if (packageJsonFile.existsSync()) { + buildTasks.addAll([ + const RunTask( + id: 'detected_npm_start', + name: 'NPM: Start', + command: 'npm start', + source: TaskSource.detected, + description: '启动 Node 服务或前端开发环境', + icon: Icons.rocket_launch_outlined, + ), + const RunTask( + id: 'detected_npm_test', + name: 'NPM: Test', + command: 'npm test', + source: TaskSource.detected, + description: '执行 npm test 测试套件', + icon: Icons.checklist_outlined, + ), + ]); + } + + // 5. Cargo.toml (Rust) + final cargoFile = File(p.join(projectRoot, 'Cargo.toml')); + if (cargoFile.existsSync()) { + buildTasks.addAll([ + const RunTask( + id: 'detected_cargo_run', + name: 'Cargo: Run', + command: 'cargo run', + source: TaskSource.detected, + description: '编译并运行 Rust 项目', + icon: Icons.play_circle_outline, + ), + const RunTask( + id: 'detected_cargo_build', + name: 'Cargo: Build', + command: 'cargo build', + source: TaskSource.detected, + description: '仅编译 Rust 项目', + icon: Icons.build_outlined, + ), + ]); + } + + // 6. pubspec.yaml (Dart) + final pubspecFile = File(p.join(projectRoot, 'pubspec.yaml')); + if (pubspecFile.existsSync()) { + buildTasks.add( + const RunTask( + id: 'detected_dart_run', + name: 'Dart: Run', + command: 'dart run', + source: TaskSource.detected, + description: '启动 Dart 应用', + icon: Icons.play_circle_outline, + ), + ); + } + + return buildTasks; + } + + /// 探测单文件运行指令(基于当前打开的文件) + static RunTask? _detectSingleFileTask(String projectRoot, String currentFilePath) { + final file = File(currentFilePath); + if (!file.existsSync()) return null; + + final fileName = p.basename(currentFilePath); + final ext = p.extension(currentFilePath).toLowerCase(); + + // 转换相对容器的路径(在容器内 /workspace 下执行) + String relPath = p.relative(currentFilePath, from: projectRoot).replaceAll(r'\', '/'); + if (!relPath.startsWith('./') && !relPath.startsWith('/')) { + relPath = './$relPath'; + } + + switch (ext) { + case '.py': + return RunTask( + id: 'detected_single_python', + name: 'Python: $fileName', + command: 'python3 "$relPath"', + source: TaskSource.detected, + description: '运行当前 Python 脚本', + icon: Icons.code, + ); + case '.c': + return RunTask( + id: 'detected_single_c', + name: 'GCC: $fileName', + command: 'gcc "$relPath" -o /tmp/a.out && /tmp/a.out', + source: TaskSource.detected, + description: '编译并执行当前 C 源文件', + icon: Icons.terminal, + ); + case '.cpp': + case '.cc': + case '.cxx': + return RunTask( + id: 'detected_single_cpp', + name: 'G++: $fileName', + command: 'g++ "$relPath" -o /tmp/a.out && /tmp/a.out', + source: TaskSource.detected, + description: '编译并执行当前 C++ 源文件', + icon: Icons.terminal, + ); + case '.sh': + case '.bash': + return RunTask( + id: 'detected_single_sh', + name: 'Shell: $fileName', + command: 'sh "$relPath"', + source: TaskSource.detected, + description: '运行当前 Shell 脚本', + icon: Icons.terminal, + ); + case '.dart': + return RunTask( + id: 'detected_single_dart', + name: 'Dart: $fileName', + command: 'dart run "$relPath"', + source: TaskSource.detected, + description: '运行当前 Dart 文件', + icon: Icons.code, + ); + case '.go': + return RunTask( + id: 'detected_single_go', + name: 'Go: $fileName', + command: 'go run "$relPath"', + source: TaskSource.detected, + description: '运行当前 Go 源文件', + icon: Icons.code, + ); + case '.rs': + return RunTask( + id: 'detected_single_rust', + name: 'Rust: $fileName', + command: 'rustc "$relPath" -o /tmp/a.out && /tmp/a.out', + source: TaskSource.detected, + description: '编译并执行当前 Rust 源文件', + icon: Icons.code, + ); + case '.js': + return RunTask( + id: 'detected_single_js', + name: 'Node: $fileName', + command: 'node "$relPath"', + source: TaskSource.detected, + description: '运行当前 JS 脚本', + icon: Icons.javascript, + ); + default: + return null; + } + } +} diff --git a/lib/services/run_task_storage_service.dart b/lib/services/run_task_storage_service.dart new file mode 100644 index 0000000..ac9ecd0 --- /dev/null +++ b/lib/services/run_task_storage_service.dart @@ -0,0 +1,97 @@ +import 'dart:convert'; +import 'dart:io'; +import 'package:flutter/foundation.dart'; +import 'package:path/path.dart' as p; +import '../models/run_task.dart'; + +/// 负责工程目录下 `.code_editor/run_tasks.json` 的读写与持久化管理 +class RunTaskStorageService { + static const String configDirName = '.code_editor'; + static const String configFileName = 'run_tasks.json'; + + /// 获取配置文件的绝对 File 对象 + File getConfigFile(String projectRoot) { + return File(p.join(projectRoot, configDirName, configFileName)); + } + + /// 从工程的 `.code_editor/run_tasks.json` 中读取持久化的配置(包括自定义任务与最近运行任务ID) + Future<({List tasks, String? lastRunTaskId})> loadConfig(String projectRoot) async { + try { + final file = getConfigFile(projectRoot); + if (!await file.exists()) { + return (tasks: [], lastRunTaskId: null); + } + + final content = await file.readAsString(); + if (content.trim().isEmpty) { + return (tasks: [], lastRunTaskId: null); + } + + final dynamic decoded = jsonDecode(content); + if (decoded is Map) { + final lastId = decoded['lastRunTaskId'] as String?; + final tasksRaw = decoded['tasks']; + List list = []; + if (tasksRaw is List) { + list = tasksRaw + .whereType>() + .map((item) => RunTask.fromJson(item)) + .toList(); + } + return (tasks: list, lastRunTaskId: lastId); + } else if (decoded is List) { + final list = decoded + .whereType>() + .map((item) => RunTask.fromJson(item)) + .toList(); + return (tasks: list, lastRunTaskId: null); + } + return (tasks: [], lastRunTaskId: null); + } catch (e) { + debugPrint('[RunTaskStorageService] 读取 run_tasks.json 失败: $e'); + return (tasks: [], lastRunTaskId: null); + } + } + + /// 兼容旧方法:直接返回 tasks + Future> loadTasks(String projectRoot) async { + final result = await loadConfig(projectRoot); + return result.tasks; + } + + /// 将自定义任务列表与最近运行的任务ID持久化保存到 `.code_editor/run_tasks.json` + Future saveConfig({ + required String projectRoot, + required List tasks, + String? lastRunTaskId, + }) async { + try { + final file = getConfigFile(projectRoot); + final dir = file.parent; + if (!await dir.exists()) { + await dir.create(recursive: true); + } + + final data = { + 'version': '1.0', + if (lastRunTaskId != null && lastRunTaskId.isNotEmpty) 'lastRunTaskId': lastRunTaskId, + 'tasks': tasks + .where((t) => t.source == TaskSource.custom) + .map((t) => t.toJson()) + .toList(), + }; + + const encoder = JsonEncoder.withIndent(' '); + final jsonStr = encoder.convert(data); + await file.writeAsString(jsonStr, flush: true); + } catch (e) { + debugPrint('[RunTaskStorageService] 保存 run_tasks.json 失败: $e'); + rethrow; + } + } + + /// 兼容旧方法 + Future saveTasks(String projectRoot, List tasks) async { + await saveConfig(projectRoot: projectRoot, tasks: tasks); + } +} diff --git a/lib/utils/app_theme.dart b/lib/utils/app_theme.dart new file mode 100644 index 0000000..85e12b2 --- /dev/null +++ b/lib/utils/app_theme.dart @@ -0,0 +1,32 @@ +import 'package:flutter/material.dart'; +import 'package:flutter/services.dart'; + +/// 按"主题色 + 亮暗 + 界面字体"构建应用主题。 +/// +/// 抽成纯函数便于单测:换一个 seed 应得到不同的 colorScheme。 +ThemeData buildAppTheme({ + required Color seedColor, + required Brightness brightness, + String? fontFamily, + List? fontFamilyFallback, +}) { + final isLight = brightness == Brightness.light; + + return ThemeData( + useMaterial3: true, + brightness: brightness, + colorScheme: ColorScheme.fromSeed( + seedColor: seedColor, + brightness: brightness, + ), + appBarTheme: AppBarTheme( + systemOverlayStyle: SystemUiOverlayStyle( + statusBarColor: Colors.transparent, + statusBarIconBrightness: isLight ? Brightness.dark : Brightness.light, + statusBarBrightness: isLight ? Brightness.light : Brightness.dark, + ), + ), + fontFamily: fontFamily, + fontFamilyFallback: fontFamilyFallback, + ); +} diff --git a/lib/utils/terminal_theme_helper.dart b/lib/utils/terminal_theme_helper.dart new file mode 100644 index 0000000..09ab64e --- /dev/null +++ b/lib/utils/terminal_theme_helper.dart @@ -0,0 +1,38 @@ +import 'package:flutter/material.dart'; +import 'package:xterm/xterm.dart' as xterm; + +/// 以指定背景色重建终端主题。 +/// +/// xterm 的 `TerminalTheme` 没有 copyWith 且全部字段必填,所以这里基于 +/// `TerminalThemes.defaultTheme` 复制一份,只替换背景;当背景偏亮时同步把 +/// 前景、光标切换为深色,避免浅色背景下文字看不清。 +xterm.TerminalTheme terminalThemeWithBackground(Color background) { + final base = xterm.TerminalThemes.defaultTheme; + final isLight = background.computeLuminance() > 0.5; + + return xterm.TerminalTheme( + cursor: isLight ? const Color(0xFF1F1F1F) : base.cursor, + selection: base.selection, + foreground: isLight ? const Color(0xFF1F1F1F) : base.foreground, + background: background, + black: base.black, + white: base.white, + red: base.red, + green: base.green, + yellow: base.yellow, + blue: base.blue, + magenta: base.magenta, + cyan: base.cyan, + brightBlack: base.brightBlack, + brightRed: base.brightRed, + brightGreen: base.brightGreen, + brightYellow: base.brightYellow, + brightBlue: base.brightBlue, + brightMagenta: base.brightMagenta, + brightCyan: base.brightCyan, + brightWhite: base.brightWhite, + searchHitBackground: base.searchHitBackground, + searchHitBackgroundCurrent: base.searchHitBackgroundCurrent, + searchHitForeground: base.searchHitForeground, + ); +} diff --git a/lib/views/main_view.dart b/lib/views/main_view.dart index bca5de3..0c89fc0 100644 --- a/lib/views/main_view.dart +++ b/lib/views/main_view.dart @@ -1,18 +1,31 @@ import 'package:code_editor/l10n/app_localizations.dart'; +import 'package:code_editor/models/run_task.dart'; import 'package:code_editor/providers/project_provider.dart'; +import 'package:code_editor/providers/run_provider.dart'; import 'package:code_editor/providers/tab_provider.dart'; +import 'package:code_editor/providers/terminal_provider.dart'; import 'package:code_editor/utils/dialog_utils.dart'; import 'package:code_editor/views/settings_view.dart'; +import 'package:code_editor/views/terminal_view.dart'; import 'package:code_editor/widgets/code_editor_app_bar.dart'; import 'package:code_editor/widgets/code_editor_drawer.dart'; import 'package:code_editor/widgets/code_editor_tab_bar.dart'; import 'package:code_editor/widgets/code_editor_widget.dart'; +import 'package:code_editor/views/run_task_edit_view.dart'; +import 'package:code_editor/widgets/run_tasks_dialog.dart'; import 'package:flutter/material.dart'; import 'package:provider/provider.dart'; -class MainView extends StatelessWidget { +class MainView extends StatefulWidget { const MainView({super.key}); + @override + State createState() => _MainViewState(); +} + +class _MainViewState extends State { + String? _lastProjectRoot; + static ProjectProvider _getProjectProvider(BuildContext context, {bool listen = false}) { return listen ? context.watch() : context.read(); } @@ -21,6 +34,22 @@ class MainView extends StatelessWidget { return listen ? context.watch() : context.read(); } + static RunProvider? _getRunProvider(BuildContext context, {bool listen = false}) { + try { + return listen ? Provider.of(context, listen: listen) : Provider.of(context, listen: false); + } catch (_) { + return null; + } + } + + static TerminalProvider? _getTerminalProvider(BuildContext context, {bool listen = false}) { + try { + return listen ? Provider.of(context, listen: listen) : Provider.of(context, listen: false); + } catch (_) { + return null; + } + } + void _handleSave(BuildContext context) async { final tabProvider = _getTabProvider(context); if (tabProvider.currentFilePath == null || tabProvider.currentFilePath!.isEmpty) { @@ -52,6 +81,143 @@ class MainView extends StatelessWidget { final canProceed = await tabProvider.checkUnsavedChanges(context); if (canProceed && context.mounted) { await projectProvider.closeProject(); + if (context.mounted) { + _getRunProvider(context)?.onProjectClosed(); + } + } + } + + /// 执行某个具体的运行任务(复用/创建当前工程工作目录的终端并执行指令) + void _executeRunTask(BuildContext context, RunTask task) { + final projectProvider = _getProjectProvider(context); + final l10n = AppLocalizations.of(context)!; + final rootPath = projectProvider.rootPath; + if (rootPath == null || rootPath.isEmpty) { + DialogUtils.showErrorToast(context, l10n.noOpenDirectory); + return; + } + + final terminalProvider = _getTerminalProvider(context); + final runProvider = _getRunProvider(context); + + // 1. 查找或创建绑定了该工程工作路径的终端会话(保持系统默认会话名称) + final session = terminalProvider?.getOrCreateSessionForProject( + projectRoot: rootPath, + distroId: 'alpine', + ); + + // 2. 记录最近执行的任务 + runProvider?.setLastRunTask(task); + + // 3. 跳转至终端视图 + Navigator.of(context).push( + MaterialPageRoute( + builder: (context) => const TerminalView(), + ), + ); + + // 4. 等待界面跳转后向终端发送指令 + Future.delayed(const Duration(milliseconds: 300), () { + if (session != null) { + if (task.clearBeforeRun) { + session.write('clear\r\n'); + } + session.write('${task.command}\r\n'); + } + }); + } + + /// 点击运行按钮 (Play):有历史任务或单文件即直接执行,否则弹出任务列表 + void _handleRun(BuildContext context) { + final projectProvider = _getProjectProvider(context); + final l10n = AppLocalizations.of(context)!; + final rootPath = projectProvider.rootPath; + if (rootPath == null || rootPath.isEmpty) { + DialogUtils.showErrorToast(context, l10n.pleaseOpenProjectFirst); + return; + } + + final runProvider = _getRunProvider(context); + if (runProvider == null) return; + + // 优先: 最近运行的任务(若已持久化并存在) + if (runProvider.lastRunTask != null) { + _executeRunTask(context, runProvider.lastRunTask!); + return; + } + + // 若没有上一次运行的任务,直接打开运行任务列表 + _handleOpenRunTasksDialog(context); + } + + /// 打开运行任务选择弹窗 + void _handleOpenRunTasksDialog(BuildContext context) { + final runProvider = _getRunProvider(context); + if (runProvider == null) return; + final projectProvider = _getProjectProvider(context); + final l10n = AppLocalizations.of(context)!; + final rootPath = projectProvider.rootPath; + if (rootPath == null || rootPath.isEmpty) { + DialogUtils.showErrorToast(context, l10n.pleaseOpenProjectFirst); + return; + } + + RunTasksDialog.show( + context: context, + customTasks: runProvider.customTasks, + detectedTasks: runProvider.detectedTasks, + lastRunTaskId: runProvider.lastRunTaskId ?? runProvider.lastRunTask?.id, + onTaskSelected: (task) => _executeRunTask(context, task), + onEditCustomTasks: () => _handleOpenEditRunTasks(context), + ); + } + + /// 打开运行任务编辑独立 View + void _handleOpenEditRunTasks(BuildContext context) { + final projectProvider = _getProjectProvider(context); + final l10n = AppLocalizations.of(context)!; + final rootPath = projectProvider.rootPath; + if (rootPath == null || rootPath.isEmpty) { + DialogUtils.showErrorToast(context, l10n.pleaseOpenProjectFirst); + return; + } + + final runProvider = _getRunProvider(context); + if (runProvider == null) return; + + RunTaskEditView.navigate( + context: context, + currentTasks: runProvider.customTasks, + onSave: (updatedTasks) async { + await runProvider.updateCustomTasks(updatedTasks); + if (context.mounted) { + DialogUtils.showSuccessToast(context, l10n.runTasksUpdated); + } + }, + ); + } + + /// 手动触发项目探测 + void _handleProjectDetect(BuildContext context) async { + final projectProvider = _getProjectProvider(context); + final rootPath = projectProvider.rootPath; + if (rootPath == null || rootPath.isEmpty) return; + + final tabProvider = _getTabProvider(context); + final runProvider = _getRunProvider(context); + if (runProvider == null) return; + + await runProvider.detectTasks( + projectRoot: rootPath, + currentFilePath: tabProvider.currentFilePath, + ); + + if (context.mounted) { + final l10n = AppLocalizations.of(context)!; + DialogUtils.showSuccessToast( + context, + l10n.detectCompletedMessage(runProvider.detectedTasks.length), + ); } } @@ -59,6 +225,7 @@ class MainView extends StatelessWidget { Widget build(BuildContext context) { final projectProvider = _getProjectProvider(context, listen: true); final tabProvider = _getTabProvider(context, listen: true); + final runProvider = _getRunProvider(context, listen: true); if (projectProvider.isLoading) { return const Center(child: CircularProgressIndicator()); @@ -68,6 +235,16 @@ class MainView extends StatelessWidget { final rootPath = projectProvider.rootPath; final isModified = tabProvider.isModified; + // 当检测到切换了项目根目录时,自动触发初始化并进行一次探测 + if (rootPath != null && rootPath != _lastProjectRoot) { + _lastProjectRoot = rootPath; + WidgetsBinding.instance.addPostFrameCallback((_) { + if (mounted) { + runProvider?.onProjectOpened(rootPath, activeFilePath: currentFile); + } + }); + } + return PopScope( canPop: !isModified, onPopInvokedWithResult: (didPop, result) async { @@ -86,7 +263,11 @@ class MainView extends StatelessWidget { onSaveAll: () => _handleSaveAll(context), onCloseAllTabs: () => _handleCloseAllTabs(context), onCloseProject: () => _handleCloseProject(context), - onRun: () {}, + onRun: () => _handleRun(context), + onRunTasks: () => _handleOpenRunTasksDialog(context), + onProjectDetect: () => _handleProjectDetect(context), + onEditRunTasks: () => _handleOpenEditRunTasks(context), + isDetecting: runProvider?.isDetecting ?? false, onSettings: () { Navigator.of(context).push( MaterialPageRoute( diff --git a/lib/views/run_task_detail_view.dart b/lib/views/run_task_detail_view.dart new file mode 100644 index 0000000..8d09087 --- /dev/null +++ b/lib/views/run_task_detail_view.dart @@ -0,0 +1,204 @@ +import 'package:code_editor/l10n/app_localizations.dart'; +import 'package:flutter/material.dart'; +import '../models/run_task.dart'; +import '../utils/dialog_utils.dart'; + +/// 运行任务单项创建/编辑 View(独立页面,点击返回键返回任务配置界面) +class RunTaskDetailView extends StatefulWidget { + final RunTask? initialTask; + final ValueChanged onSave; + + const RunTaskDetailView({ + super.key, + this.initialTask, + required this.onSave, + }); + + static Future navigate({ + required BuildContext context, + RunTask? initialTask, + required ValueChanged onSave, + }) { + return Navigator.of(context).push( + MaterialPageRoute( + builder: (ctx) => RunTaskDetailView( + initialTask: initialTask, + onSave: onSave, + ), + ), + ); + } + + @override + State createState() => _RunTaskDetailViewState(); +} + +class _RunTaskDetailViewState extends State { + final _formKey = GlobalKey(); + late TextEditingController _nameController; + late TextEditingController _commandController; + late TextEditingController _descController; + bool _clearBeforeRun = false; + + late String _initialName; + late String _initialCommand; + late String _initialDesc; + late bool _initialClearBeforeRun; + + @override + void initState() { + super.initState(); + final task = widget.initialTask; + _initialName = task?.name ?? ''; + _initialCommand = task?.command ?? ''; + _initialDesc = task?.description ?? ''; + _initialClearBeforeRun = task?.clearBeforeRun ?? false; + + _nameController = TextEditingController(text: _initialName); + _commandController = TextEditingController(text: _initialCommand); + _descController = TextEditingController(text: _initialDesc); + _clearBeforeRun = _initialClearBeforeRun; + } + + @override + void dispose() { + _nameController.dispose(); + _commandController.dispose(); + _descController.dispose(); + super.dispose(); + } + + bool get _isDirty { + return _nameController.text != _initialName || + _commandController.text != _initialCommand || + _descController.text != _initialDesc || + _clearBeforeRun != _initialClearBeforeRun; + } + + Future _confirmDiscardChanges() async { + if (!_isDirty) return true; + + final l10n = AppLocalizations.of(context)!; + final shouldDiscard = await DialogUtils.showConfirmDialog( + context, + title: l10n.unsavedTaskChangesTitle, + message: l10n.unsavedTaskChangesMessage, + confirmText: l10n.dontSave, + cancelText: l10n.cancel, + icon: Icon( + Icons.warning_amber_rounded, + color: Theme.of(context).colorScheme.error, + size: 28, + ), + ); + return shouldDiscard; + } + + void _save() { + if (!_formKey.currentState!.validate()) return; + + final task = RunTask( + id: widget.initialTask?.id ?? 'custom_${DateTime.now().microsecondsSinceEpoch}', + name: _nameController.text.trim(), + command: _commandController.text.trim(), + source: TaskSource.custom, + description: _descController.text.trim().isEmpty ? null : _descController.text.trim(), + clearBeforeRun: _clearBeforeRun, + ); + + widget.onSave(task); + Navigator.of(context).pop(); + } + + @override + Widget build(BuildContext context) { + final l10n = AppLocalizations.of(context)!; + final isEditing = widget.initialTask != null; + + return PopScope( + canPop: false, + onPopInvokedWithResult: (didPop, result) async { + if (didPop) return; + final canDiscard = await _confirmDiscardChanges(); + if (canDiscard && context.mounted) { + Navigator.of(context).pop(); + } + }, + child: Scaffold( + appBar: AppBar( + title: Text(isEditing ? l10n.editTask : l10n.addTask), + leading: IconButton( + icon: const Icon(Icons.arrow_back), + tooltip: l10n.back, + onPressed: () async { + final canDiscard = await _confirmDiscardChanges(); + if (canDiscard && context.mounted) { + Navigator.of(context).pop(); + } + }, + ), + actions: [ + IconButton( + icon: const Icon(Icons.check), + tooltip: l10n.done, + onPressed: _save, + ), + ], + ), + body: Form( + key: _formKey, + child: SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.stretch, + children: [ + TextFormField( + controller: _nameController, + decoration: InputDecoration( + labelText: l10n.taskNameRequired, + hintText: l10n.taskNameHint, + border: const OutlineInputBorder(), + isDense: true, + ), + validator: (v) => (v == null || v.trim().isEmpty) ? l10n.taskNameEmptyError : null, + ), + const SizedBox(height: 16), + TextFormField( + controller: _descController, + decoration: InputDecoration( + labelText: l10n.taskDescOptional, + hintText: l10n.taskDescHint, + border: const OutlineInputBorder(), + isDense: true, + ), + ), + const SizedBox(height: 16), + TextFormField( + controller: _commandController, + maxLines: 4, + style: const TextStyle(fontFamily: 'monospace', fontSize: 13), + decoration: InputDecoration( + labelText: l10n.shellCommandRequired, + hintText: l10n.shellCommandHint, + border: const OutlineInputBorder(), + alignLabelWithHint: true, + isDense: true, + ), + validator: (v) => (v == null || v.trim().isEmpty) ? l10n.shellCommandEmptyError : null, + ), + const SizedBox(height: 16), + SwitchListTile( + contentPadding: EdgeInsets.zero, + title: Text(l10n.clearBeforeRun), + subtitle: Text(l10n.clearBeforeRunSubtitle, style: const TextStyle(fontSize: 12)), + value: _clearBeforeRun, + onChanged: (val) => setState(() => _clearBeforeRun = val), + ), + ], + ), + ), + ), + ), + ); + } +} diff --git a/lib/views/run_task_edit_view.dart b/lib/views/run_task_edit_view.dart new file mode 100644 index 0000000..1c0343d --- /dev/null +++ b/lib/views/run_task_edit_view.dart @@ -0,0 +1,337 @@ +import 'package:code_editor/l10n/app_localizations.dart'; +import 'package:flutter/material.dart'; +import '../models/run_task.dart'; +import 'run_task_detail_view.dart'; + +/// 运行任务列表配置 View(支持拖动排序、单项与多选删除确认、自动静默保存至 JSON) +class RunTaskEditView extends StatefulWidget { + final List tasks; + final ValueChanged> onSave; + + const RunTaskEditView({ + super.key, + required this.tasks, + required this.onSave, + }); + + static Future navigate({ + required BuildContext context, + required List currentTasks, + required ValueChanged> onSave, + }) { + return Navigator.of(context).push( + MaterialPageRoute( + builder: (ctx) => RunTaskEditView( + tasks: currentTasks, + onSave: onSave, + ), + ), + ); + } + + @override + State createState() => _RunTaskEditViewState(); +} + +class _RunTaskEditViewState extends State { + late List _taskList; + bool _isSelectionMode = false; + final Set _selectedTaskIds = {}; + + @override + void initState() { + super.initState(); + _taskList = List.from(widget.tasks); + } + + /// 任何变动立即写回(直接写回 JSON,无需点击额外保存按钮) + void _persistChanges() { + widget.onSave(List.unmodifiable(_taskList)); + } + + void _openCreateView() { + RunTaskDetailView.navigate( + context: context, + onSave: (newTask) { + setState(() { + _taskList.add(newTask); + }); + _persistChanges(); + }, + ); + } + + void _openEditView(RunTask task) { + RunTaskDetailView.navigate( + context: context, + initialTask: task, + onSave: (updatedTask) { + final index = _taskList.indexWhere((t) => t.id == updatedTask.id); + if (index != -1) { + setState(() { + _taskList[index] = updatedTask; + }); + _persistChanges(); + } + }, + ); + } + + /// 单项删除确认弹窗 + Future _confirmDeleteSingle(RunTask task) async { + final l10n = AppLocalizations.of(context)!; + final confirmed = await showDialog( + context: context, + builder: (ctx) => AlertDialog( + title: Text(l10n.confirmDelete), + content: Text(l10n.deleteTaskConfirmMessage(task.name)), + actions: [ + TextButton( + onPressed: () => Navigator.of(ctx).pop(false), + child: Text(l10n.cancel), + ), + FilledButton( + style: FilledButton.styleFrom(backgroundColor: Theme.of(context).colorScheme.error), + onPressed: () => Navigator.of(ctx).pop(true), + child: Text(l10n.delete), + ), + ], + ), + ); + + if (confirmed == true && mounted) { + setState(() { + _taskList.removeWhere((t) => t.id == task.id); + _selectedTaskIds.remove(task.id); + }); + _persistChanges(); + } + } + + /// 多选批量删除确认弹窗 + Future _confirmDeleteBatch() async { + if (_selectedTaskIds.isEmpty) return; + final l10n = AppLocalizations.of(context)!; + final confirmed = await showDialog( + context: context, + builder: (ctx) => AlertDialog( + title: Text(l10n.confirmDelete), + content: Text(l10n.deleteSelectedTasksConfirmMessage(_selectedTaskIds.length)), + actions: [ + TextButton( + onPressed: () => Navigator.of(ctx).pop(false), + child: Text(l10n.cancel), + ), + FilledButton( + style: FilledButton.styleFrom(backgroundColor: Theme.of(context).colorScheme.error), + onPressed: () => Navigator.of(ctx).pop(true), + child: Text(l10n.delete), + ), + ], + ), + ); + + if (confirmed == true && mounted) { + setState(() { + _taskList.removeWhere((t) => _selectedTaskIds.contains(t.id)); + _selectedTaskIds.clear(); + _isSelectionMode = false; + }); + _persistChanges(); + } + } + + void _toggleSelection(String id) { + setState(() { + if (_selectedTaskIds.contains(id)) { + _selectedTaskIds.remove(id); + if (_selectedTaskIds.isEmpty) { + _isSelectionMode = false; + } + } else { + _selectedTaskIds.add(id); + } + }); + } + + @override + Widget build(BuildContext context) { + final theme = Theme.of(context); + final l10n = AppLocalizations.of(context)!; + + return Scaffold( + appBar: AppBar( + title: Text(_isSelectionMode + ? l10n.selectedCount(_selectedTaskIds.length) + : l10n.runTasksConfig), + leading: _isSelectionMode + ? IconButton( + icon: const Icon(Icons.close), + onPressed: () { + setState(() { + _isSelectionMode = false; + _selectedTaskIds.clear(); + }); + }, + ) + : null, + actions: [ + if (_isSelectionMode) + IconButton( + icon: Icon(Icons.delete_outline, color: theme.colorScheme.error), + tooltip: l10n.deleteSelected, + onPressed: _confirmDeleteBatch, + ) + else if (_taskList.isNotEmpty) + IconButton( + icon: const Icon(Icons.checklist), + tooltip: l10n.selectTasksToDelete, + onPressed: () { + setState(() { + _isSelectionMode = true; + }); + }, + ), + ], + ), + body: SafeArea( + child: _taskList.isEmpty ? _buildEmptyView(theme, l10n) : _buildReorderableList(theme, l10n), + ), + floatingActionButton: !_isSelectionMode + ? FloatingActionButton( + onPressed: _openCreateView, + tooltip: l10n.addTask, + child: const Icon(Icons.add), + ) + : null, + ); + } + + Widget _buildEmptyView(ThemeData theme, AppLocalizations l10n) { + return Center( + child: Column( + mainAxisSize: MainAxisSize.min, + children: [ + Icon(Icons.playlist_remove, size: 56, color: theme.colorScheme.outline), + const SizedBox(height: 12), + Text(l10n.noCustomTasksInProject, + style: theme.textTheme.bodyMedium?.copyWith(color: theme.colorScheme.outline)), + const SizedBox(height: 16), + FilledButton.icon( + icon: const Icon(Icons.add), + label: Text(l10n.createNow), + onPressed: _openCreateView, + ), + ], + ), + ); + } + + Widget _buildReorderableList(ThemeData theme, AppLocalizations l10n) { + return ReorderableListView.builder( + buildDefaultDragHandles: false, + padding: const EdgeInsets.symmetric(vertical: 8), + itemCount: _taskList.length, + onReorderItem: (oldIndex, newIndex) { + setState(() { + final task = _taskList.removeAt(oldIndex); + _taskList.insert(newIndex, task); + }); + _persistChanges(); + }, + itemBuilder: (ctx, index) { + final task = _taskList[index]; + final isSelected = _selectedTaskIds.contains(task.id); + + return Card( + key: ValueKey(task.id), + margin: const EdgeInsets.symmetric(horizontal: 12, vertical: 4), + elevation: 0, + color: isSelected + ? theme.colorScheme.primaryContainer.withValues(alpha: 0.3) + : theme.colorScheme.surfaceContainerHighest.withValues(alpha: 0.3), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(10), + side: BorderSide( + color: isSelected + ? theme.colorScheme.primary + : theme.colorScheme.outlineVariant.withValues(alpha: 0.4), + ), + ), + child: ListTile( + dense: true, + contentPadding: const EdgeInsets.only(left: 12, right: 4, top: 2, bottom: 2), + leading: _isSelectionMode + ? Checkbox( + value: isSelected, + onChanged: (_) => _toggleSelection(task.id), + ) + : const CircleAvatar( + radius: 16, + child: Icon(Icons.terminal, size: 18), + ), + // 只显示:名称 + 用途(描述) + title: Text( + task.name, + style: const TextStyle(fontWeight: FontWeight.w600, fontSize: 14), + maxLines: 1, + overflow: TextOverflow.ellipsis, + ), + subtitle: (task.description != null && task.description!.trim().isNotEmpty) + ? Text( + task.description!.trim(), + maxLines: 1, + overflow: TextOverflow.ellipsis, + style: TextStyle(fontSize: 12, color: theme.colorScheme.outline), + ) + : null, + trailing: Row( + mainAxisSize: MainAxisSize.min, + children: [ + if (!_isSelectionMode) ...[ + IconButton( + icon: const Icon(Icons.edit_outlined, size: 20), + tooltip: l10n.editTask, + onPressed: () => _openEditView(task), + ), + IconButton( + icon: Icon(Icons.delete_outline, size: 20, color: theme.colorScheme.error), + tooltip: l10n.delete, + onPressed: () => _confirmDeleteSingle(task), + ), + // 最右侧拖动把手,支持长按/拖动排序 + ReorderableDragStartListener( + index: index, + child: Padding( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 8), + child: Icon( + Icons.drag_handle, + color: theme.colorScheme.outline, + size: 22, + ), + ), + ), + ], + ], + ), + onTap: () { + if (_isSelectionMode) { + _toggleSelection(task.id); + } else { + _openEditView(task); + } + }, + onLongPress: () { + if (!_isSelectionMode) { + setState(() { + _isSelectionMode = true; + _selectedTaskIds.add(task.id); + }); + } + }, + ), + ); + }, + ); + } +} diff --git a/lib/views/settings_view.dart b/lib/views/settings_view.dart index cf4fe96..7a2a90b 100644 --- a/lib/views/settings_view.dart +++ b/lib/views/settings_view.dart @@ -5,6 +5,7 @@ import 'package:code_editor/models/virtual_keyboard_config.dart'; import 'package:code_editor/providers/settings_provider.dart'; import 'package:flutter/material.dart'; import 'package:provider/provider.dart'; +import '../widgets/color_palette_dialog.dart'; import 'virtual_keyboard_config_view.dart'; /// 设置页面 @@ -38,6 +39,7 @@ class SettingsView extends StatelessWidget { // ============================== _buildSectionHeader(context, l10n.appearanceSection), _buildThemeModeTile(context, provider, l10n), + _buildThemeColorTile(context, provider, l10n), _buildUiFontTile(context, provider), const Divider(height: 32, indent: 16, endIndent: 16), @@ -59,13 +61,24 @@ class SettingsView extends StatelessWidget { // ============================== // 3. 终端分组 (Terminal) // ============================== - _buildSectionHeader(context, '终端'), + _buildSectionHeader(context, l10n.terminal), + _buildTerminalBackgroundTile(context, provider, l10n), + _buildTerminalVirtualKeyboardTile(context, provider, l10n), + _buildTerminalVirtualKeyboardConfigTile(context, provider, l10n), _buildTerminalFontTile(context, provider), const Divider(height: 32, indent: 16, endIndent: 16), // ============================== - // 4. 语言分组 (Language) + // 4. 项目分组 (Project) + // ============================== + _buildSectionHeader(context, l10n.projectSection), + _buildShowHiddenFilesTile(context, provider, l10n), + + const Divider(height: 32, indent: 16, endIndent: 16), + + // ============================== + // 5. 语言分组 (Language) // ============================== _buildSectionHeader(context, l10n.languageSection), _buildLanguageTile(context, provider, l10n), @@ -178,19 +191,20 @@ class SettingsView extends StatelessWidget { /// 外观:UI 界面字体条目 Widget _buildUiFontTile(BuildContext context, SettingsProvider provider) { final theme = Theme.of(context); + final l10n = AppLocalizations.of(context)!; final currentFont = provider.uiFont; return ListTile( leading: Icon(Icons.font_download_outlined, color: theme.colorScheme.primary), - title: const Text('界面字体'), - subtitle: Text(currentFont.name), + title: Text(l10n.uiFont), + subtitle: Text(l10n.fontName(currentFont.id)), trailing: const Icon(Icons.chevron_right), onTap: () { _showFontSelector( context, - title: '选择界面字体', + title: l10n.selectUiFont, fonts: AppFonts.uiFonts, currentId: provider.uiFontId, - previewSample: '代码编辑器界面字体预览 Code Editor 123', + previewSample: l10n.uiFontPreview, onSelected: (id) => provider.setUiFontId(id), ); }, @@ -200,19 +214,25 @@ class SettingsView extends StatelessWidget { /// 编辑区:代码字体条目 Widget _buildEditorFontTile(BuildContext context, SettingsProvider provider) { final theme = Theme.of(context); + final l10n = AppLocalizations.of(context)!; final currentFont = provider.editorFont; + final fontName = l10n.fontName(currentFont.id); + final subtitle = currentFont.id == 'jetbrains_mono' + ? '$fontName (${l10n.recommended})' + : fontName; return ListTile( leading: Icon(Icons.text_fields, color: theme.colorScheme.primary), - title: const Text('代码字体'), - subtitle: Text(currentFont.name), + title: Text(l10n.codeFont), + subtitle: Text(subtitle), trailing: const Icon(Icons.chevron_right), onTap: () { _showFontSelector( context, - title: '选择代码字体', + title: l10n.selectCodeFont, fonts: AppFonts.editorFonts, currentId: provider.editorFontId, - previewSample: 'void main() { int a = 123; } // 代码预览', + previewSample: l10n.codeFontPreview, + showRecommendation: true, onSelected: (id) => provider.setEditorFontId(id), ); }, @@ -222,25 +242,108 @@ class SettingsView extends StatelessWidget { /// 终端:终端字体条目 Widget _buildTerminalFontTile(BuildContext context, SettingsProvider provider) { final theme = Theme.of(context); + final l10n = AppLocalizations.of(context)!; final currentFont = provider.terminalFont; + final fontName = l10n.fontName(currentFont.id); + final subtitle = currentFont.id == 'jetbrains_mono' + ? '$fontName (${l10n.recommended})' + : fontName; return ListTile( - leading: Icon(Icons.terminal, color: theme.colorScheme.primary), - title: const Text('终端字体'), - subtitle: Text(currentFont.name), + leading: Icon(Icons.font_download_outlined, color: theme.colorScheme.primary), + title: Text(l10n.terminalFont), + subtitle: Text(subtitle), trailing: const Icon(Icons.chevron_right), onTap: () { _showFontSelector( context, - title: '选择终端字体', + title: l10n.selectTerminalFont, fonts: AppFonts.terminalFonts, currentId: provider.terminalFontId, - previewSample: '\$ git status -s # 终端字体预览', + previewSample: l10n.terminalFontPreview, + showRecommendation: true, onSelected: (id) => provider.setTerminalFontId(id), ); }, ); } + /// 外观:主题颜色条目(点击弹出调色板) + Widget _buildThemeColorTile( + BuildContext context, + SettingsProvider provider, + AppLocalizations l10n, + ) { + final theme = Theme.of(context); + final current = provider.appThemeColor; + + return ListTile( + leading: Icon(Icons.palette_outlined, color: theme.colorScheme.primary), + title: Text(l10n.themeColor), + subtitle: Text(colorToHex(current)), + trailing: _buildColorTrailing(context, current), + onTap: () async { + final picked = await ColorPaletteDialog.show( + context, + title: l10n.selectThemeColor, + current: current, + palette: ColorPaletteDialog.uiPalette, + ); + if (picked != null) { + await provider.setAppThemeColor(picked); + } + }, + ); + } + + /// 终端:终端背景颜色条目(点击弹出调色板) + Widget _buildTerminalBackgroundTile( + BuildContext context, + SettingsProvider provider, + AppLocalizations l10n, + ) { + final theme = Theme.of(context); + final current = provider.terminalBackgroundColor; + + return ListTile( + leading: Icon(Icons.palette_outlined, color: theme.colorScheme.primary), + title: Text(l10n.terminalBackgroundColor), + subtitle: Text(colorToHex(current)), + trailing: _buildColorTrailing(context, current), + onTap: () async { + final picked = await ColorPaletteDialog.show( + context, + title: l10n.selectTerminalBackgroundColor, + current: current, + palette: ColorPaletteDialog.terminalPalette, + ); + if (picked != null) { + await provider.setTerminalBackgroundColor(picked); + } + }, + ); + } + + /// 颜色预览圆点 + 右箭头(与"代码高亮主题"条目的尾部样式一致) + Widget _buildColorTrailing(BuildContext context, Color color) { + final theme = Theme.of(context); + return Row( + mainAxisSize: MainAxisSize.min, + children: [ + Container( + width: 24, + height: 24, + decoration: BoxDecoration( + color: color, + shape: BoxShape.circle, + border: Border.all(color: theme.colorScheme.outlineVariant, width: 1.5), + ), + ), + const SizedBox(width: 8), + const Icon(Icons.chevron_right), + ], + ); + } + /// 字体选择底部弹窗 void _showFontSelector( BuildContext context, { @@ -249,7 +352,9 @@ class SettingsView extends StatelessWidget { required String currentId, required ValueChanged onSelected, required String previewSample, + bool showRecommendation = false, }) { + final l10n = AppLocalizations.of(context)!; showModalBottomSheet( context: context, isScrollControlled: true, @@ -280,13 +385,17 @@ class SettingsView extends StatelessWidget { itemBuilder: (context, index) { final item = fonts[index]; final isSelected = item.id == currentId; + final isRecommended = showRecommendation && item.id == 'jetbrains_mono'; + final fontTitle = isRecommended + ? '${l10n.fontName(item.id)} (${l10n.recommended})' + : l10n.fontName(item.id); return ListTile( leading: Icon( item.isMonospace ? Icons.code : Icons.font_download_outlined, color: isSelected ? theme.colorScheme.primary : null, ), title: Text( - item.name, + fontTitle, style: TextStyle( fontWeight: isSelected ? FontWeight.bold : FontWeight.normal, color: isSelected ? theme.colorScheme.primary : null, @@ -681,6 +790,50 @@ class SettingsView extends StatelessWidget { + /// 终端:终端小键盘开关条目(与编辑区开关相互独立) + Widget _buildTerminalVirtualKeyboardTile( + BuildContext context, + SettingsProvider provider, + AppLocalizations l10n, + ) { + final theme = Theme.of(context); + + return SwitchListTile( + secondary: Icon(Icons.keyboard_command_key, color: theme.colorScheme.primary), + title: Text(l10n.terminalVirtualKeyboard), + subtitle: Text(l10n.terminalVirtualKeyboardSubtitle), + value: provider.enableTerminalVirtualKeyboard, + onChanged: (val) => provider.setKeyboardEnabled(KeyboardScope.terminal, val), + ); + } + + /// 终端:终端键盘配置编辑条目 + Widget _buildTerminalVirtualKeyboardConfigTile( + BuildContext context, + SettingsProvider provider, + AppLocalizations l10n, + ) { + final theme = Theme.of(context); + final enabled = provider.enableTerminalVirtualKeyboard; + + return ListTile( + enabled: enabled, + leading: Icon(Icons.tune, color: enabled ? theme.colorScheme.primary : theme.disabledColor), + title: Text(l10n.editTerminalVirtualKeyboardConfig), + subtitle: Text(l10n.editTerminalVirtualKeyboardConfigSubtitle), + trailing: const Icon(Icons.chevron_right), + onTap: () { + Navigator.of(context).push( + MaterialPageRoute( + builder: (_) => const VirtualKeyboardConfigView( + scope: KeyboardScope.terminal, + ), + ), + ); + }, + ); + } + /// 语言:应用语言选择条目 Widget _buildLanguageTile( BuildContext context, @@ -769,4 +922,22 @@ class SettingsView extends StatelessWidget { }, ); } + + /// 项目配置:显示隐藏文件开关 + Widget _buildShowHiddenFilesTile( + BuildContext context, + SettingsProvider provider, + AppLocalizations l10n, + ) { + final theme = Theme.of(context); + return SwitchListTile( + secondary: Icon(Icons.visibility_outlined, color: theme.colorScheme.primary), + title: Text(l10n.showHiddenFiles), + subtitle: Text(l10n.showHiddenFilesSubtitle), + value: provider.showHiddenFiles, + onChanged: (val) { + provider.setShowHiddenFiles(val); + }, + ); + } } diff --git a/lib/views/terminal_view.dart b/lib/views/terminal_view.dart index 70a4019..d85f693 100644 --- a/lib/views/terminal_view.dart +++ b/lib/views/terminal_view.dart @@ -1,15 +1,22 @@ import 'package:code_editor/l10n/app_localizations.dart'; import 'package:code_editor/models/app_font.dart'; import 'package:code_editor/models/terminal_session.dart'; +import 'package:code_editor/models/virtual_keyboard_config.dart'; import 'package:code_editor/providers/distro_provider.dart'; +import 'package:code_editor/providers/project_provider.dart'; import 'package:code_editor/providers/settings_provider.dart'; import 'package:code_editor/providers/terminal_provider.dart'; +import 'package:code_editor/utils/terminal_theme_helper.dart'; import 'package:code_editor/widgets/distro_extract_dialog.dart'; import 'package:code_editor/widgets/distro_selector_dialog.dart'; import 'package:code_editor/widgets/terminal_drawer.dart'; +import 'package:code_editor/widgets/terminal_keyboard_sink.dart'; +import 'package:code_editor/widgets/terminal_modifier_state.dart'; +import 'package:code_editor/widgets/virtual_keyboard_widget.dart'; import 'package:flutter/material.dart'; import 'package:provider/provider.dart'; import 'package:xterm/xterm.dart' as xterm; +import 'package:xterm/xterm.dart' show TerminalInputHandler, defaultInputHandler; /// 终端视图(支持多系统实例切换、全屏会话保持、右侧抽屉多会话管理与交互) class TerminalView extends StatefulWidget { @@ -84,15 +91,17 @@ class _TerminalViewState extends State { final theme = Theme.of(context); final l10n = AppLocalizations.of(context)!; final provider = context.watch(); - final distroProvider = context.watch(); + final projectProvider = context.watch(); final activeSession = provider.activeSession; final sessions = provider.sessions; final activeIndex = provider.activeIndex; final titleText = activeSession?.name ?? l10n.sessionDefaultName; - final currentSystem = activeSession?.distroId ?? distroProvider?.selectedSystem; - final subtitleText = currentSystem != null ? l10n.terminalWithSystem(currentSystem) : l10n.terminal; + final projectRoot = activeSession?.workspacePath ?? projectProvider?.rootPath; + final String? subtitleText = (projectRoot != null && projectRoot.trim().isNotEmpty) + ? projectRoot.trim() + : null; return Scaffold( key: _scaffoldKey, @@ -116,14 +125,15 @@ class _TerminalViewState extends State { ), overflow: TextOverflow.ellipsis, ), - Text( - subtitleText, - style: TextStyle( - fontSize: 11.0, - color: theme.colorScheme.onSurfaceVariant, + if (subtitleText != null) + Text( + subtitleText, + style: TextStyle( + fontSize: 11.0, + color: theme.colorScheme.onSurfaceVariant, + ), + overflow: TextOverflow.ellipsis, ), - overflow: TextOverflow.ellipsis, - ), ], ), actions: [ @@ -180,6 +190,46 @@ class _TerminalSessionBody extends StatefulWidget { } class _TerminalSessionBodyState extends State<_TerminalSessionBody> { + /// 小键盘修饰键的运行时状态:键盘组件与终端共用同一份 + late final TerminalModifierState _modifiers = TerminalModifierState(); + + /// 终端原有的输入处理器与输出出口(用于串联,而不是替换) + TerminalInputHandler? _delegateInputHandler; + void Function(String)? _delegateOnOutput; + + @override + void initState() { + super.initState(); + final terminal = widget.session.terminal; + + // ① 按键事件(硬件键盘、小键盘 key 格)都会经过 inputHandler: + // 把运行时修饰键叠加进事件,再交给 xterm 默认链路。 + _delegateInputHandler = terminal.inputHandler; + terminal.inputHandler = ModifierAwareInputHandler( + state: _modifiers, + delegate: _delegateInputHandler ?? defaultInputHandler, + ); + + // ② 软键盘 / IME 打进来的字符不产生 KeyEvent,只能在这里改写。 + _delegateOnOutput = terminal.onOutput; + terminal.onOutput = (data) { + final transformed = applyModifierToTypedText(data, _modifiers.mods); + _delegateOnOutput?.call(transformed ?? data); + if (transformed != null) _modifiers.consume(); + }; + } + + @override + void dispose() { + final terminal = widget.session.terminal; + if (terminal.inputHandler is ModifierAwareInputHandler) { + terminal.inputHandler = _delegateInputHandler; + } + terminal.onOutput = _delegateOnOutput; + _modifiers.dispose(); + super.dispose(); + } + @override Widget build(BuildContext context) { final session = widget.session; @@ -192,18 +242,42 @@ class _TerminalSessionBodyState extends State<_TerminalSessionBody> { fontFamilyFallback: terminalFont.fallback, ); + // 终端小键盘:开关与配置均独立于编辑区 + final keyboardEnabled = settings?.keyboardEnabledFor(KeyboardScope.terminal) ?? false; + final keyboardConfig = settings?.keyboardConfigFor(KeyboardScope.terminal); + + // 终端背景颜色(设置项):容器与 xterm 主题保持一致 + final backgroundColor = settings?.terminalBackgroundColor ?? const Color(0xFF1E1E1E); + return Container( - color: const Color(0xFF181818), + color: backgroundColor, child: SafeArea( top: false, - child: xterm.TerminalView( - session.terminal, - focusNode: session.focusNode, - autofocus: true, - theme: xterm.TerminalThemes.defaultTheme, - textStyle: terminalStyle, - cursorType: xterm.TerminalCursorType.block, - padding: const EdgeInsets.symmetric(horizontal: 10.0, vertical: 8.0), + child: Column( + children: [ + Expanded( + child: xterm.TerminalView( + session.terminal, + focusNode: session.focusNode, + autofocus: true, + theme: terminalThemeWithBackground(backgroundColor), + textStyle: terminalStyle, + cursorType: xterm.TerminalCursorType.block, + padding: const EdgeInsets.symmetric(horizontal: 10.0, vertical: 8.0), + ), + ), + if (keyboardEnabled && keyboardConfig != null && keyboardConfig.hasKeys) + VirtualKeyboardWidget( + controller: null, + focusNode: session.focusNode, + sink: TerminalKeyboardSink( + terminal: session.terminal, + focusNode: session.focusNode, + ), + modifierState: _modifiers, + config: keyboardConfig, + ), + ], ), ), ); diff --git a/lib/views/virtual_keyboard_config_view.dart b/lib/views/virtual_keyboard_config_view.dart index b4d6e83..9f3e579 100644 --- a/lib/views/virtual_keyboard_config_view.dart +++ b/lib/views/virtual_keyboard_config_view.dart @@ -43,7 +43,7 @@ class _VirtualKeyboardConfigViewState extends State { void initState() { super.initState(); final settingsProvider = context.read(); - _config = settingsProvider.virtualKeyboardConfig; + _config = settingsProvider.keyboardConfigFor(widget.scope); if (_currentPageIndex >= _config.pages.length) { _currentPageIndex = 0; } @@ -77,12 +77,12 @@ class _VirtualKeyboardConfigViewState extends State { }); } - /// 保存并同步到 SettingsProvider + /// 保存并同步到 SettingsProvider(按作用域写入对应的那份配置) Future _syncAndSaveConfig() async { final settingsProvider = context.read(); const encoder = JsonEncoder.withIndent(' '); final jsonStr = encoder.convert(_config.toJson()); - await settingsProvider.setVirtualKeyboardConfig(jsonStr); + await settingsProvider.setKeyboardConfig(widget.scope, jsonStr); } /// 恢复默认配置 @@ -109,10 +109,10 @@ class _VirtualKeyboardConfigViewState extends State { if (confirmed == true) { if (!mounted) return; final settingsProvider = context.read(); - await settingsProvider.resetVirtualKeyboardConfig(); + await settingsProvider.resetKeyboardConfig(widget.scope); if (!mounted) return; setState(() { - _config = settingsProvider.virtualKeyboardConfig; + _config = settingsProvider.keyboardConfigFor(widget.scope); _currentPageIndex = 0; _expandedRowsByPage.clear(); _scrollOffsetByPage.clear(); @@ -132,13 +132,10 @@ class _VirtualKeyboardConfigViewState extends State { } setState(() { + // 新建页面默认为空,不自动新增按键行,由用户手动添加 final newPage = KeyboardPageItem( count: 7, - keys: [ - [ - const KeyboardKeyItem(label: 'New', value: 'New'), - ], - ], + keys: const [], ); final newPages = List.from(_config.pages)..add(newPage); _config = _config.copyWith(pages: newPages); @@ -471,10 +468,14 @@ class _VirtualKeyboardConfigViewState extends State { children: [ Text( l10n.virtualKeyboardConfigTitle, + maxLines: 1, + overflow: TextOverflow.ellipsis, style: const TextStyle(fontSize: 18, fontWeight: FontWeight.w600), ), Text( subtitleText, + maxLines: 1, + overflow: TextOverflow.ellipsis, style: TextStyle( fontSize: 12, color: theme.colorScheme.onSurface.withValues(alpha: 0.65), @@ -531,17 +532,23 @@ class _VirtualKeyboardConfigViewState extends State { crossAxisAlignment: CrossAxisAlignment.start, children: [ Row( - mainAxisAlignment: MainAxisAlignment.spaceBetween, children: [ - Row( - children: [ - Icon(Icons.keyboard_alt_outlined, size: 20, color: theme.colorScheme.primary), - const SizedBox(width: 8), - Text( - l10n.keyboardPageKeysSectionTitle, - style: const TextStyle(fontSize: 16, fontWeight: FontWeight.bold), - ), - ], + // 左侧标题需可收缩,右侧“添加新行”按钮才不会把标题挤出右边界 + Expanded( + child: Row( + children: [ + Icon(Icons.keyboard_alt_outlined, size: 20, color: theme.colorScheme.primary), + const SizedBox(width: 8), + Flexible( + child: Text( + l10n.keyboardPageKeysSectionTitle, + maxLines: 1, + overflow: TextOverflow.ellipsis, + style: const TextStyle(fontSize: 16, fontWeight: FontWeight.bold), + ), + ), + ], + ), ), TextButton.icon( icon: const Icon(Icons.add, size: 18), diff --git a/lib/widgets/code_editor_app_bar.dart b/lib/widgets/code_editor_app_bar.dart index 5b1ba74..abdb389 100644 --- a/lib/widgets/code_editor_app_bar.dart +++ b/lib/widgets/code_editor_app_bar.dart @@ -12,10 +12,14 @@ class CodeEditorAppBar extends StatelessWidget implements PreferredSizeWidget { final VoidCallback? onSave; final VoidCallback? onSaveAll; final VoidCallback? onRun; + final VoidCallback? onRunTasks; final VoidCallback? onTerminal; final VoidCallback? onCloseAllTabs; final VoidCallback? onCloseProject; final VoidCallback? onSettings; + final VoidCallback? onProjectDetect; + final VoidCallback? onEditRunTasks; + final bool isDetecting; const CodeEditorAppBar({ super.key, @@ -25,10 +29,14 @@ class CodeEditorAppBar extends StatelessWidget implements PreferredSizeWidget { this.onSave, this.onSaveAll, this.onRun, + this.onRunTasks, this.onTerminal, this.onCloseAllTabs, this.onCloseProject, this.onSettings, + this.onProjectDetect, + this.onEditRunTasks, + this.isDetecting = false, }); @override @@ -121,28 +129,23 @@ class CodeEditorAppBar extends StatelessWidget implements PreferredSizeWidget { onPressed: onSave ?? () {}, ), ), - Focus( - canRequestFocus: false, - skipTraversal: true, - child: IconButton( - visualDensity: VisualDensity.compact, - icon: const Icon(Icons.terminal), - tooltip: '终端', - onPressed: onTerminal ?? - () { - Navigator.of(context).push( - MaterialPageRoute( - builder: (context) => const TerminalView(), - ), - ); - }, - ), - ), _MoreMenuButton( onSaveAll: onSaveAll, + onRunTasks: onRunTasks, + onTerminal: onTerminal ?? + () { + Navigator.of(context).push( + MaterialPageRoute( + builder: (context) => const TerminalView(), + ), + ); + }, + onProjectDetect: onProjectDetect, + onEditRunTasks: onEditRunTasks, onCloseAllTabs: onCloseAllTabs, onCloseProject: onCloseProject, onSettings: onSettings, + isDetecting: isDetecting, ), ], ), @@ -153,15 +156,25 @@ class CodeEditorAppBar extends StatelessWidget implements PreferredSizeWidget { /// 基于 OverlayEntry 的右上角更多菜单组件(带对齐右上角缩放淡入淡出动画,非模态不关闭键盘) class _MoreMenuButton extends StatefulWidget { final VoidCallback? onSaveAll; + final VoidCallback? onRunTasks; + final VoidCallback? onTerminal; + final VoidCallback? onProjectDetect; + final VoidCallback? onEditRunTasks; final VoidCallback? onCloseAllTabs; final VoidCallback? onCloseProject; final VoidCallback? onSettings; + final bool isDetecting; const _MoreMenuButton({ this.onSaveAll, + this.onRunTasks, + this.onTerminal, + this.onProjectDetect, + this.onEditRunTasks, this.onCloseAllTabs, this.onCloseProject, this.onSettings, + this.isDetecting = false, }); @override @@ -280,12 +293,14 @@ class _MoreMenuButtonState extends State<_MoreMenuButton> with SingleTickerProvi ), clipBehavior: Clip.antiAlias, child: Container( - width: 170, + // 菜单宽度随系统字号放大,避免大字号下文案被截断(上限避免超出窄屏) + width: (170.0 * MediaQuery.textScalerOf(context).scale(1.0)).clamp(170.0, 280.0), padding: const EdgeInsets.symmetric(vertical: 4.0), child: Column( mainAxisSize: MainAxisSize.min, crossAxisAlignment: CrossAxisAlignment.stretch, children: [ + // 分组 1: 保存所有,运行任务,终端 _buildMenuItem( icon: Icons.save_as_outlined, title: l10n.saveAll, @@ -295,11 +310,19 @@ class _MoreMenuButtonState extends State<_MoreMenuButton> with SingleTickerProvi }, ), _buildMenuItem( - icon: Icons.close_fullscreen_outlined, - title: l10n.closeAllTabs, + icon: Icons.playlist_play, + title: l10n.runTasks, iconColor: onSurfaceColor, onTap: () { - _closeMenu(onClosed: widget.onCloseAllTabs); + _closeMenu(onClosed: widget.onRunTasks); + }, + ), + _buildMenuItem( + icon: Icons.terminal, + title: l10n.terminal, + iconColor: onSurfaceColor, + onTap: () { + _closeMenu(onClosed: widget.onTerminal); }, ), Divider( @@ -307,6 +330,39 @@ class _MoreMenuButtonState extends State<_MoreMenuButton> with SingleTickerProvi thickness: 0.8, color: theme.colorScheme.outlineVariant, ), + // 分组 2: 项目探测,运行任务编辑 + _buildMenuItem( + icon: widget.isDetecting ? Icons.hourglass_top : Icons.radar_outlined, + title: widget.isDetecting ? l10n.projectDetecting : l10n.projectDetect, + iconColor: onSurfaceColor, + enabled: !widget.isDetecting, + onTap: () { + if (widget.isDetecting) return; + _closeMenu(onClosed: widget.onProjectDetect); + }, + ), + _buildMenuItem( + icon: Icons.tune_outlined, + title: l10n.editRunTasks, + iconColor: onSurfaceColor, + onTap: () { + _closeMenu(onClosed: widget.onEditRunTasks); + }, + ), + Divider( + height: 9, + thickness: 0.8, + color: theme.colorScheme.outlineVariant, + ), + // 分组 3: 关闭所有标签,关闭当前项目 + _buildMenuItem( + icon: Icons.close_fullscreen_outlined, + title: l10n.closeAllTabs, + iconColor: onSurfaceColor, + onTap: () { + _closeMenu(onClosed: widget.onCloseAllTabs); + }, + ), _buildMenuItem( icon: Icons.folder_off_outlined, title: l10n.closeProject, @@ -320,6 +376,7 @@ class _MoreMenuButtonState extends State<_MoreMenuButton> with SingleTickerProvi thickness: 0.8, color: theme.colorScheme.outlineVariant, ), + // 分组 4: 设置 _buildMenuItem( icon: Icons.settings, title: l10n.settings, @@ -348,10 +405,18 @@ class _MoreMenuButtonState extends State<_MoreMenuButton> with SingleTickerProvi required Color iconColor, required VoidCallback onTap, bool isDestructive = false, + bool enabled = true, }) { final theme = Theme.of(context); + final effectiveColor = enabled + ? (isDestructive ? theme.colorScheme.error : iconColor) + : theme.colorScheme.outline.withValues(alpha: 0.5); + final effectiveTextColor = enabled + ? (isDestructive ? theme.colorScheme.error : theme.colorScheme.onSurface) + : theme.colorScheme.outline.withValues(alpha: 0.5); + return InkWell( - onTap: onTap, + onTap: enabled ? onTap : null, child: Padding( padding: const EdgeInsets.symmetric(horizontal: 16.0, vertical: 10.0), child: Row( @@ -360,14 +425,18 @@ class _MoreMenuButtonState extends State<_MoreMenuButton> with SingleTickerProvi Icon( icon, size: 18, - color: isDestructive ? theme.colorScheme.error : iconColor, + color: effectiveColor, ), const SizedBox(width: 10), - Text( - title, - style: TextStyle( - fontSize: 14.0, - color: isDestructive ? theme.colorScheme.error : theme.colorScheme.onSurface, + Flexible( + child: Text( + title, + maxLines: 1, + overflow: TextOverflow.ellipsis, + style: TextStyle( + fontSize: 14.0, + color: effectiveTextColor, + ), ), ), ], diff --git a/lib/widgets/code_editor_menu.dart b/lib/widgets/code_editor_menu.dart index dfabe56..e5d48de 100644 --- a/lib/widgets/code_editor_menu.dart +++ b/lib/widgets/code_editor_menu.dart @@ -1,3 +1,4 @@ +import 'dart:math'; import 'package:code_editor/l10n/app_localizations.dart'; import 'package:flutter/material.dart'; import 'package:flutter/services.dart'; @@ -17,7 +18,14 @@ class _EditorContextMenuItem extends PopupMenuItem implements PreferredSiz children: [ Icon(icon, size: 16), const SizedBox(width: 8), - Text(text, style: const TextStyle(fontSize: 13)), + Flexible( + child: Text( + text, + maxLines: 1, + overflow: TextOverflow.ellipsis, + style: const TextStyle(fontSize: 13), + ), + ), ], ), ); @@ -71,8 +79,34 @@ class _MobileSelectionToolbarWidgetState extends State<_MobileSelectionToolbarWi widget.controller.selection.extentOffset != -1 && !widget.controller.selection.isCollapsed; + final mediaQuery = MediaQuery.of(context); + final availableBottom = mediaQuery.size.height - mediaQuery.viewInsets.bottom; + TextSelectionToolbarAnchors effectiveAnchors = widget.anchors; + + final primary = effectiveAnchors.primaryAnchor; + final secondary = effectiveAnchors.secondaryAnchor; + + // 针对虚拟键盘或底栏的全局安全高度校准: + if (secondary != null && secondary.dy + 65.0 > availableBottom) { + effectiveAnchors = TextSelectionToolbarAnchors( + primaryAnchor: Offset( + secondary.dx.clamp(120.0, max(120.0, mediaQuery.size.width - 120.0)), + (availableBottom - 12.0).clamp(mediaQuery.padding.top + 48.0, availableBottom), + ), + secondaryAnchor: null, + ); + } else if (primary.dy + 60.0 > availableBottom && primary.dx >= 0) { + effectiveAnchors = TextSelectionToolbarAnchors( + primaryAnchor: Offset( + primary.dx.clamp(120.0, max(120.0, mediaQuery.size.width - 120.0)), + (availableBottom - 12.0).clamp(mediaQuery.padding.top + 48.0, availableBottom), + ), + secondaryAnchor: null, + ); + } + return AdaptiveTextSelectionToolbar.buttonItems( - anchors: widget.anchors, + anchors: effectiveAnchors, buttonItems: [ if (hasSelection) ContextMenuButtonItem( @@ -164,10 +198,11 @@ class CodeEditorToolbarController implements SelectionToolbarController { anchors: anchors, ); } else { + final safeAnchors = _sanitizeMobileAnchors(anchors, renderRect); _mobileController.show( context: context, controller: controller, - anchors: anchors, + anchors: safeAnchors, renderRect: renderRect, layerLink: layerLink, visibility: visibility, @@ -175,6 +210,59 @@ class CodeEditorToolbarController implements SelectionToolbarController { } } + /// 智能校准移动端选区工具栏锚点: + /// 1. 优先展示在选区上方(primaryAnchor),避免遮挡当前选中的代码内容及下方代码; + /// 2. 当选区位于视口顶部(上方空间不足 54px 时),智能翻转至选区下方(secondaryAnchor); + /// 3. 当选区靠近视口底部或键盘时,保护次锚点不落入键盘/底栏区域,坚决保持在上方; + /// 4. 水平坐标智能居中并进行安全边缘约束(左右各留出 120px 缓冲),防止菜单按钮溢出屏幕。 + static TextSelectionToolbarAnchors _sanitizeMobileAnchors( + TextSelectionToolbarAnchors anchors, + Rect renderRect, + ) { + final primary = anchors.primaryAnchor; + final secondary = anchors.secondaryAnchor; + + // 确定水平基准坐标并进行安全边距夹取(左右两端预留充足空间以保证多个操作按钮完整可见) + final double rawX = (primary.dx > 0) ? primary.dx : (secondary?.dx ?? renderRect.center.dx); + final double safeX = (renderRect.width > 240.0) + ? rawX.clamp(renderRect.left + 120.0, renderRect.right - 120.0) + : renderRect.center.dx; + + // 计算选区上方与下方的垂直可用净空间 + final double topY = (primary.dy > 0) ? primary.dy : (secondary?.dy ?? renderRect.top + 60.0); + final double bottomY = (secondary != null && secondary.dy > 0) ? secondary.dy : (topY + 30.0); + + final double spaceAbove = topY - renderRect.top; + final double spaceBelow = renderRect.bottom - bottomY; + + // 规则 1:选区上方空间充足(>= 54.0px,足够容纳工具栏),置于选区上方! + // 选区本身与下方的代码行将保持 100% 清晰可见,绝不遮挡。 + if (spaceAbove >= 54.0) { + return TextSelectionToolbarAnchors( + primaryAnchor: Offset(safeX, topY), + secondaryAnchor: spaceBelow >= 64.0 ? Offset(safeX, bottomY) : null, + ); + } + + // 规则 2:选区位于第一行/第二行(上方空间不足 54px),但下方空间充足(>= 64px) + // 智能翻转至选区下方,保证不超出屏幕顶部也不遮挡第一行 + if (spaceBelow >= 64.0) { + return TextSelectionToolbarAnchors( + primaryAnchor: const Offset(-10000, -10000), + secondaryAnchor: Offset(safeX, bottomY), + ); + } + + // 规则 3:选区跨越很大或上下空间均受限时,安全悬浮于可视区域上边缘内侧 + return TextSelectionToolbarAnchors( + primaryAnchor: Offset( + safeX, + (renderRect.top + 56.0).clamp(renderRect.top + 10.0, renderRect.bottom - 10.0), + ), + secondaryAnchor: null, + ); + } + Future _showDesktopMenu({ required BuildContext context, required CodeLineEditingController controller, diff --git a/lib/widgets/code_editor_tab_bar.dart b/lib/widgets/code_editor_tab_bar.dart index 8f4d995..aeee8e6 100644 --- a/lib/widgets/code_editor_tab_bar.dart +++ b/lib/widgets/code_editor_tab_bar.dart @@ -82,7 +82,8 @@ class CodeEditorTabBar extends StatelessWidget { builder: (context, constraints) { final totalWidth = constraints.maxWidth; final tabCount = tabs.length; - final equalShare = math.max(28.0, totalWidth / tabCount); + // 下限需容纳内边距(8) + 关闭按钮(18) + 脏标记(10),否则标签内 Row 会右溢出 + final equalShare = math.max(40.0, totalWidth / tabCount); return Theme( data: theme.copyWith( @@ -178,26 +179,21 @@ class CodeEditorTabBar extends StatelessWidget { child: Row( children: [ Expanded( - child: Row( - mainAxisSize: MainAxisSize.min, - children: [ - if (tab.isModified) - Padding( - padding: const EdgeInsets.only(right: 2.0), - child: Text( - '*', + // 脏标记并入同一个 Text.rich,避免它在极窄标签里单独撑破 Row + child: Text.rich( + TextSpan( + children: [ + if (tab.isModified) + TextSpan( + text: '*', style: TextStyle( color: theme.colorScheme.error, fontWeight: FontWeight.bold, fontSize: 12.0, ), ), - ), - Flexible( - child: Text( - displayName, - maxLines: 1, - overflow: TextOverflow.ellipsis, + TextSpan( + text: displayName, style: TextStyle( fontSize: 12.0, fontWeight: isSelected ? FontWeight.bold : FontWeight.normal, @@ -206,8 +202,10 @@ class CodeEditorTabBar extends StatelessWidget { : theme.colorScheme.onSurfaceVariant, ), ), - ), - ], + ], + ), + maxLines: 1, + overflow: TextOverflow.ellipsis, ), ), InkResponse( diff --git a/lib/widgets/code_editor_widget.dart b/lib/widgets/code_editor_widget.dart index f22f1c6..765a23d 100644 --- a/lib/widgets/code_editor_widget.dart +++ b/lib/widgets/code_editor_widget.dart @@ -459,6 +459,8 @@ class _CodeEditorWidgetState extends State { scrollController: _scrollController, wordWrap: activeWordWrap, toolbarController: _toolbarController, + margin: const EdgeInsets.only(left: 2.0, top: 4.0, right: 8, bottom: 8.0), + padding: const EdgeInsets.fromLTRB(0.0, 0.0, 0.0, 0.0), style: CodeEditorStyle( fontSize: displayFontSize, textColor: activeTheme.textColor, diff --git a/lib/widgets/color_palette_dialog.dart b/lib/widgets/color_palette_dialog.dart new file mode 100644 index 0000000..50fbe40 --- /dev/null +++ b/lib/widgets/color_palette_dialog.dart @@ -0,0 +1,470 @@ +import 'package:flutter/material.dart'; + +import '../l10n/app_localizations.dart'; + +/// 颜色 → `#RRGGBB` 文本(用于工具提示与设置项副标题) +String colorToHex(Color color) { + final argb = color.toARGB32(); + final rgb = argb & 0xFFFFFF; + return '#${rgb.toRadixString(16).padLeft(6, '0').toUpperCase()}'; +} + +/// 通用交互式调色板弹窗: +/// +/// 包含 HSV 2D 饱和度/明度调色区、色相滑条、HEX 十六进制编辑、 +/// 当前/新色对比预览,以及经典预设色板。 +class ColorPaletteDialog extends StatefulWidget { + const ColorPaletteDialog({ + super.key, + required this.title, + required this.current, + required this.palette, + }); + + final String title; + final Color current; + final List palette; + + /// 界面主题色板:Material 主色 + 中性色 + static const List uiPalette = [ + Color(0xFFF44336), + Color(0xFFE91E63), + Color(0xFF9C27B0), + Color(0xFF673AB7), + Color(0xFF3F51B5), + Color(0xFF2196F3), + Color(0xFF03A9F4), + Color(0xFF00BCD4), + Color(0xFF009688), + Color(0xFF4CAF50), + Color(0xFF8BC34A), + Color(0xFFCDDC39), + Color(0xFFFFEB3B), + Color(0xFFFFC107), + Color(0xFFFF9800), + Color(0xFFFF5722), + Color(0xFF795548), + Color(0xFF607D8B), + Color(0xFF9E9E9E), + Color(0xFF000000), + ]; + + /// 终端背景色板:常用深色配色 + 少量浅色 + static const List terminalPalette = [ + Color(0xFF000000), + Color(0xFF0D1117), + Color(0xFF101418), + Color(0xFF181818), + Color(0xFF1E1E1E), + Color(0xFF1E1E2E), + Color(0xFF212121), + Color(0xFF263238), + Color(0xFF282C34), + Color(0xFF2B2B2B), + Color(0xFF2D2D30), + Color(0xFF303030), + Color(0xFF1B2B34), + Color(0xFF002B36), + Color(0xFF073642), + Color(0xFF3C3836), + Color(0xFFF5F5F5), + Color(0xFFFFFFFF), + ]; + + static Future show( + BuildContext context, { + required String title, + required Color current, + required List palette, + }) { + return showDialog( + context: context, + builder: (_) => ColorPaletteDialog( + title: title, + current: current, + palette: palette, + ), + ); + } + + @override + State createState() => _ColorPaletteDialogState(); +} + +class _ColorPaletteDialogState extends State { + late double _hue; + late double _saturation; + late double _value; + late Color _currentColor; + late TextEditingController _hexController; + bool _isInternalHexUpdate = false; + + @override + void initState() { + super.initState(); + _currentColor = widget.current; + final hsv = HSVColor.fromColor(widget.current); + _hue = hsv.hue; + _saturation = hsv.saturation; + _value = hsv.value; + _hexController = TextEditingController(text: colorToHex(widget.current)); + } + + @override + void dispose() { + _hexController.dispose(); + super.dispose(); + } + + void _updateColor(Color color, {bool updateHex = true}) { + final hsv = HSVColor.fromColor(color); + setState(() { + _currentColor = color; + if (hsv.saturation > 0 || color.toARGB32() != Colors.black.toARGB32()) { + _hue = hsv.hue; + } + _saturation = hsv.saturation; + _value = hsv.value; + if (updateHex) { + _isInternalHexUpdate = true; + _hexController.text = colorToHex(color); + _isInternalHexUpdate = false; + } + }); + } + + void _onHexChanged(String text) { + if (_isInternalHexUpdate) return; + String clean = text.trim(); + if (clean.startsWith('#')) clean = clean.substring(1); + if (clean.length == 6) { + final val = int.tryParse(clean, radix: 16); + if (val != null) { + final color = Color(0xFF000000 | val); + final hsv = HSVColor.fromColor(color); + setState(() { + _currentColor = color; + if (hsv.saturation > 0 || color.toARGB32() != Colors.black.toARGB32()) { + _hue = hsv.hue; + } + _saturation = hsv.saturation; + _value = hsv.value; + }); + } + } + } + + void _onSvPan(Offset localPosition, double width, double height) { + final s = (localPosition.dx / width).clamp(0.0, 1.0); + final v = (1.0 - (localPosition.dy / height)).clamp(0.0, 1.0); + setState(() { + _saturation = s; + _value = v; + _currentColor = HSVColor.fromAHSV(1.0, _hue, _saturation, _value).toColor(); + _isInternalHexUpdate = true; + _hexController.text = colorToHex(_currentColor); + _isInternalHexUpdate = false; + }); + } + + void _onHuePan(Offset localPosition, double width) { + final h = (localPosition.dx / width * 360.0).clamp(0.0, 360.0); + setState(() { + _hue = h == 360.0 ? 0.0 : h; + _currentColor = HSVColor.fromAHSV(1.0, _hue, _saturation, _value).toColor(); + _isInternalHexUpdate = true; + _hexController.text = colorToHex(_currentColor); + _isInternalHexUpdate = false; + }); + } + + Widget _buildSaturationValuePicker(double width, double height) { + return GestureDetector( + onPanDown: (details) => _onSvPan(details.localPosition, width, height), + onPanUpdate: (details) => _onSvPan(details.localPosition, width, height), + child: ClipRRect( + borderRadius: BorderRadius.circular(12), + child: SizedBox( + width: width, + height: height, + child: Stack( + children: [ + // 色相底层 + Container( + color: HSVColor.fromAHSV(1.0, _hue, 1.0, 1.0).toColor(), + ), + // 水平渐变(白色 -> 透明) + Container( + decoration: const BoxDecoration( + gradient: LinearGradient( + begin: Alignment.centerLeft, + end: Alignment.centerRight, + colors: [Colors.white, Color(0x00FFFFFF)], + ), + ), + ), + // 垂直渐变(透明 -> 黑色) + Container( + decoration: const BoxDecoration( + gradient: LinearGradient( + begin: Alignment.topCenter, + end: Alignment.bottomCenter, + colors: [Colors.transparent, Colors.black], + ), + ), + ), + // 取色定位圆环指示器 + Positioned( + left: (_saturation * width - 10).clamp(-10.0, width - 10.0), + top: ((1.0 - _value) * height - 10).clamp(-10.0, height - 10.0), + child: IgnorePointer( + child: Container( + width: 20, + height: 20, + decoration: BoxDecoration( + shape: BoxShape.circle, + border: Border.all(color: Colors.white, width: 2.5), + boxShadow: const [ + BoxShadow( + color: Colors.black45, + blurRadius: 4, + offset: Offset(0, 1), + ), + ], + ), + ), + ), + ), + ], + ), + ), + ), + ); + } + + Widget _buildHueSlider(double width) { + const double sliderHeight = 22.0; + return GestureDetector( + onPanDown: (details) => _onHuePan(details.localPosition, width), + onPanUpdate: (details) => _onHuePan(details.localPosition, width), + child: ClipRRect( + borderRadius: BorderRadius.circular(sliderHeight / 2), + child: SizedBox( + width: width, + height: sliderHeight, + child: Stack( + children: [ + Container( + decoration: BoxDecoration( + borderRadius: BorderRadius.circular(sliderHeight / 2), + gradient: const LinearGradient( + colors: [ + Color(0xFFFF0000), + Color(0xFFFFFF00), + Color(0xFF00FF00), + Color(0xFF00FFFF), + Color(0xFF0000FF), + Color(0xFFFF00FF), + Color(0xFFFF0000), + ], + ), + ), + ), + Positioned( + left: ((_hue / 360.0) * width - 10).clamp(-10.0, width - 10.0), + top: 1, + child: IgnorePointer( + child: Container( + width: 20, + height: sliderHeight - 2, + decoration: BoxDecoration( + shape: BoxShape.circle, + border: Border.all(color: Colors.white, width: 2.5), + boxShadow: const [ + BoxShadow( + color: Colors.black45, + blurRadius: 3, + offset: Offset(0, 1), + ), + ], + ), + ), + ), + ), + ], + ), + ), + ), + ); + } + + Widget _buildPreviewAndHex(BuildContext context, AppLocalizations l10n) { + final theme = Theme.of(context); + return Row( + children: [ + // 初始颜色(点击可快速重置回原色) + Tooltip( + message: '${l10n.currentColor}: ${colorToHex(widget.current)}', + child: InkWell( + onTap: () => _updateColor(widget.current), + borderRadius: BorderRadius.circular(8), + child: Container( + width: 36, + height: 36, + decoration: BoxDecoration( + color: widget.current, + borderRadius: BorderRadius.circular(8), + border: Border.all(color: theme.colorScheme.outlineVariant), + ), + ), + ), + ), + const SizedBox(width: 8), + Icon(Icons.arrow_forward, size: 18, color: theme.colorScheme.outline), + const SizedBox(width: 8), + // 调色后的实时新色预览 + Tooltip( + message: '${l10n.newColor}: ${colorToHex(_currentColor)}', + child: Container( + width: 36, + height: 36, + decoration: BoxDecoration( + color: _currentColor, + borderRadius: BorderRadius.circular(8), + border: Border.all( + color: theme.colorScheme.primary, + width: 2, + ), + boxShadow: [ + BoxShadow( + color: _currentColor.withValues(alpha: 0.35), + blurRadius: 6, + offset: const Offset(0, 2), + ), + ], + ), + ), + ), + const Spacer(), + // HEX 颜色输入框 + SizedBox( + width: 120, + height: 42, + child: TextField( + controller: _hexController, + onChanged: _onHexChanged, + style: const TextStyle( + fontFamily: 'monospace', + fontWeight: FontWeight.bold, + fontSize: 14, + ), + decoration: InputDecoration( + isDense: true, + contentPadding: const EdgeInsets.symmetric(horizontal: 10, vertical: 8), + border: OutlineInputBorder(borderRadius: BorderRadius.circular(8)), + labelText: l10n.hexColor, + counterText: '', + ), + maxLength: 7, + ), + ), + ], + ); + } + + Widget _buildPresets(BuildContext context, AppLocalizations l10n) { + final theme = Theme.of(context); + final currentRgb = _currentColor.toARGB32() & 0xFFFFFF; + + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + l10n.presetColors, + style: theme.textTheme.labelMedium?.copyWith( + color: theme.colorScheme.onSurfaceVariant, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 8), + Wrap( + spacing: 6, + runSpacing: 6, + children: [ + for (final color in widget.palette) + Tooltip( + message: colorToHex(color), + child: InkWell( + key: ValueKey(color.toARGB32()), + borderRadius: BorderRadius.circular(14), + onTap: () => _updateColor(color), + child: Container( + width: 28, + height: 28, + decoration: BoxDecoration( + color: color, + shape: BoxShape.circle, + border: Border.all( + color: (color.toARGB32() & 0xFFFFFF) == currentRgb + ? theme.colorScheme.primary + : theme.colorScheme.outlineVariant, + width: (color.toARGB32() & 0xFFFFFF) == currentRgb ? 2.5 : 1, + ), + ), + child: (color.toARGB32() & 0xFFFFFF) == currentRgb + ? Icon( + Icons.check, + size: 16, + color: color.computeLuminance() > 0.5 + ? Colors.black87 + : Colors.white, + ) + : null, + ), + ), + ), + ], + ), + ], + ); + } + + @override + Widget build(BuildContext context) { + final l10n = AppLocalizations.of(context)!; + + return AlertDialog( + title: Text(widget.title), + content: SizedBox( + width: 280, + child: SingleChildScrollView( + child: Column( + mainAxisSize: MainAxisSize.min, + crossAxisAlignment: CrossAxisAlignment.stretch, + children: [ + _buildSaturationValuePicker(280, 130), + const SizedBox(height: 12), + _buildHueSlider(280), + const SizedBox(height: 12), + _buildPreviewAndHex(context, l10n), + const SizedBox(height: 12), + const Divider(height: 1), + const SizedBox(height: 10), + _buildPresets(context, l10n), + ], + ), + ), + ), + actions: [ + TextButton( + onPressed: () => Navigator.of(context).pop(), + child: Text(l10n.cancel), + ), + FilledButton( + onPressed: () => Navigator.of(context).pop(_currentColor), + child: Text(l10n.confirm), + ), + ], + ); + } +} diff --git a/lib/widgets/distro_selector_dialog.dart b/lib/widgets/distro_selector_dialog.dart index 4a4f6f1..a02ced8 100644 --- a/lib/widgets/distro_selector_dialog.dart +++ b/lib/widgets/distro_selector_dialog.dart @@ -60,7 +60,13 @@ class DistroSelectorDialog extends StatelessWidget { children: [ const Icon(Icons.layers_outlined, size: 18), const SizedBox(width: 8), - Text(l10n.importBuiltinAlpine), + Flexible( + child: Text( + l10n.importBuiltinAlpine, + maxLines: 1, + overflow: TextOverflow.ellipsis, + ), + ), ], ), ), @@ -70,7 +76,13 @@ class DistroSelectorDialog extends StatelessWidget { children: [ const Icon(Icons.folder_open_outlined, size: 18), const SizedBox(width: 8), - Text(l10n.importExternalTarGz), + Flexible( + child: Text( + l10n.importExternalTarGz, + maxLines: 1, + overflow: TextOverflow.ellipsis, + ), + ), ], ), ), diff --git a/lib/widgets/file_item_widget.dart b/lib/widgets/file_item_widget.dart index dc8d261..0087a6a 100644 --- a/lib/widgets/file_item_widget.dart +++ b/lib/widgets/file_item_widget.dart @@ -289,11 +289,15 @@ class _FileItemWidgetState extends State { children: [ Icon(icon, size: 18, color: iconColor), const SizedBox(width: 8), - Text( - title, - style: isDestructive - ? TextStyle(color: theme.colorScheme.error) - : TextStyle(color: theme.colorScheme.onSurface), + Flexible( + child: Text( + title, + maxLines: 1, + overflow: TextOverflow.ellipsis, + style: isDestructive + ? TextStyle(color: theme.colorScheme.error) + : TextStyle(color: theme.colorScheme.onSurface), + ), ), ], ), diff --git a/lib/widgets/run_tasks_dialog.dart b/lib/widgets/run_tasks_dialog.dart new file mode 100644 index 0000000..08f382c --- /dev/null +++ b/lib/widgets/run_tasks_dialog.dart @@ -0,0 +1,262 @@ +import 'package:code_editor/l10n/app_localizations.dart'; +import 'package:flutter/material.dart'; +import '../models/run_task.dart'; + +/// 运行任务选择弹窗(带顶部搜索栏、区分系统探测与自定义任务,点击直接调度执行) +class RunTasksDialog extends StatefulWidget { + final List customTasks; + final List detectedTasks; + final String? lastRunTaskId; + final ValueChanged onTaskSelected; + final VoidCallback onEditCustomTasks; + + const RunTasksDialog({ + super.key, + required this.customTasks, + required this.detectedTasks, + this.lastRunTaskId, + required this.onTaskSelected, + required this.onEditCustomTasks, + }); + + static Future show({ + required BuildContext context, + required List customTasks, + required List detectedTasks, + String? lastRunTaskId, + required ValueChanged onTaskSelected, + required VoidCallback onEditCustomTasks, + }) { + return showDialog( + context: context, + builder: (ctx) => RunTasksDialog( + customTasks: customTasks, + detectedTasks: detectedTasks, + lastRunTaskId: lastRunTaskId, + onTaskSelected: onTaskSelected, + onEditCustomTasks: onEditCustomTasks, + ), + ); + } + + @override + State createState() => _RunTasksDialogState(); +} + +class _RunTasksDialogState extends State { + final TextEditingController _searchController = TextEditingController(); + String _searchQuery = ''; + + @override + void initState() { + super.initState(); + _searchController.addListener(() { + setState(() { + _searchQuery = _searchController.text.trim().toLowerCase(); + }); + }); + } + + @override + void dispose() { + _searchController.dispose(); + super.dispose(); + } + + bool _matchesQuery(RunTask task) { + if (_searchQuery.isEmpty) return true; + return task.name.toLowerCase().contains(_searchQuery) || + task.command.toLowerCase().contains(_searchQuery) || + (task.description?.toLowerCase().contains(_searchQuery) ?? false); + } + + @override + Widget build(BuildContext context) { + final theme = Theme.of(context); + final l10n = AppLocalizations.of(context)!; + final filteredCustom = widget.customTasks.where(_matchesQuery).toList(); + final filteredDetected = widget.detectedTasks.where(_matchesQuery).toList(); + final hasAny = filteredCustom.isNotEmpty || filteredDetected.isNotEmpty; + + return Dialog( + shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(16)), + child: ConstrainedBox( + constraints: const BoxConstraints(maxWidth: 560, maxHeight: 620), + child: Padding( + padding: const EdgeInsets.all(20), + child: Column( + crossAxisAlignment: CrossAxisAlignment.stretch, + children: [ + // 标题栏:简洁标题 + 编辑按钮 + 关闭 X + Row( + children: [ + Expanded( + child: Text( + l10n.runTasks, + style: theme.textTheme.titleLarge?.copyWith(fontWeight: FontWeight.bold), + maxLines: 1, + overflow: TextOverflow.ellipsis, + ), + ), + IconButton( + icon: const Icon(Icons.tune_outlined), + tooltip: l10n.editCustomTasksTooltip, + onPressed: () { + Navigator.of(context).pop(); + widget.onEditCustomTasks(); + }, + ), + IconButton( + icon: const Icon(Icons.close), + tooltip: l10n.close, + onPressed: () => Navigator.of(context).pop(), + ), + ], + ), + const SizedBox(height: 12), + + // 搜索输入框 + TextField( + controller: _searchController, + decoration: InputDecoration( + hintText: l10n.searchTasksHint, + prefixIcon: const Icon(Icons.search), + suffixIcon: _searchQuery.isNotEmpty + ? IconButton( + icon: const Icon(Icons.clear, size: 18), + onPressed: () => _searchController.clear(), + ) + : null, + isDense: true, + border: OutlineInputBorder(borderRadius: BorderRadius.circular(10)), + ), + ), + const SizedBox(height: 12), + + // 任务展示列表 + Expanded( + child: !hasAny + ? Center( + child: Text( + _searchQuery.isEmpty ? l10n.noTasksAvailable : l10n.noMatchingTasks, + style: theme.textTheme.bodyMedium?.copyWith(color: theme.colorScheme.outline), + ), + ) + : ListView( + children: [ + if (filteredDetected.isNotEmpty) ...[ + _buildSectionHeader(context, l10n.systemDetectedTasks, Icons.radar_outlined), + ...filteredDetected.map((task) => _buildTaskItem(context, task)), + const SizedBox(height: 8), + ], + if (filteredCustom.isNotEmpty) ...[ + _buildSectionHeader(context, l10n.userCustomTasks, Icons.person_outline), + ...filteredCustom.map((task) => _buildTaskItem(context, task)), + ], + ], + ), + ), + ], + ), + ), + ), + ); + } + + Widget _buildSectionHeader(BuildContext context, String title, IconData icon) { + final theme = Theme.of(context); + return Padding( + padding: const EdgeInsets.symmetric(vertical: 6, horizontal: 4), + child: Row( + children: [ + Icon(icon, size: 16, color: theme.colorScheme.primary), + const SizedBox(width: 6), + Text( + title, + style: theme.textTheme.labelMedium?.copyWith( + color: theme.colorScheme.primary, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + ); + } + + Widget _buildTaskItem(BuildContext context, RunTask task) { + final theme = Theme.of(context); + final isLastRun = widget.lastRunTaskId != null && widget.lastRunTaskId == task.id; + + final cardColor = isLastRun + ? Colors.green.withValues(alpha: 0.15) + : theme.colorScheme.surfaceContainerHighest.withValues(alpha: 0.4); + + final borderColor = isLastRun + ? Colors.green.withValues(alpha: 0.8) + : theme.colorScheme.outlineVariant.withValues(alpha: 0.5); + + return Card( + margin: const EdgeInsets.symmetric(vertical: 4), + elevation: 0, + color: cardColor, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(10), + side: BorderSide(color: borderColor, width: isLastRun ? 1.5 : 1.0), + ), + child: ListTile( + shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(10)), + dense: true, + title: Row( + children: [ + Expanded( + child: Text( + task.name, + style: TextStyle( + fontWeight: FontWeight.w600, + color: isLastRun ? Colors.green.shade700 : null, + ), + ), + ), + if (isLastRun) + Container( + margin: const EdgeInsets.only(left: 6), + padding: const EdgeInsets.symmetric(horizontal: 6, vertical: 2), + decoration: BoxDecoration( + color: Colors.green.withValues(alpha: 0.2), + borderRadius: BorderRadius.circular(4), + ), + child: Icon( + Icons.history, + size: 14, + color: Colors.green.shade700, + ), + ), + ], + ), + subtitle: (task.description != null && task.description!.trim().isNotEmpty) + ? Text( + task.description!.trim(), + maxLines: 1, + overflow: TextOverflow.ellipsis, + style: TextStyle( + fontSize: 12, + color: theme.colorScheme.onSurfaceVariant, + ), + ) + : null, + trailing: CircleAvatar( + radius: 16, + backgroundColor: isLastRun + ? Colors.green.withValues(alpha: 0.25) + : theme.colorScheme.primaryContainer, + foregroundColor: isLastRun ? Colors.green : theme.colorScheme.onPrimaryContainer, + child: const Icon(Icons.play_arrow, size: 20), + ), + onTap: () { + Navigator.of(context).pop(); + widget.onTaskSelected(task); + }, + ), + ); + } +} diff --git a/lib/widgets/terminal_drawer.dart b/lib/widgets/terminal_drawer.dart index 9c16979..19a70f1 100644 --- a/lib/widgets/terminal_drawer.dart +++ b/lib/widgets/terminal_drawer.dart @@ -1,5 +1,6 @@ import 'package:code_editor/l10n/app_localizations.dart'; import 'package:code_editor/providers/distro_provider.dart'; +import 'package:code_editor/providers/project_provider.dart'; import 'package:code_editor/providers/terminal_provider.dart'; import 'package:code_editor/utils/dialog_utils.dart'; import 'package:code_editor/widgets/terminal_session_item_widget.dart'; @@ -60,12 +61,16 @@ class TerminalDrawer extends StatelessWidget { DialogUtils.showToast(context, l10n.noSystemSelectedWarning); return; } - // 基于当前选择的系统创建新终端 + // 基于当前选择的系统创建新终端并直接激活进入 + final projectRoot = context.read()?.rootPath; provider.createSession( name: l10n.sessionDefaultName, distroId: currentSystem, - activate: false, + workspacePath: projectRoot, + activate: true, ); + // 自动关闭右侧抽屉,直接进入新创建的会话 + Navigator.of(context).maybePop(); }, ), ], diff --git a/lib/widgets/terminal_keyboard_sink.dart b/lib/widgets/terminal_keyboard_sink.dart new file mode 100644 index 0000000..98b043c --- /dev/null +++ b/lib/widgets/terminal_keyboard_sink.dart @@ -0,0 +1,112 @@ +import 'package:flutter/foundation.dart'; +import 'package:flutter/material.dart'; +import 'package:flutter/services.dart'; +import 'package:xterm/xterm.dart'; + +import '../models/virtual_keyboard_config.dart'; +import 'virtual_keyboard_sink.dart'; + +/// 解析 xterm 的 [TerminalKey] 枚举名,失败返回 null。 +/// +/// 模型层只保存字符串名(不依赖 xterm),由这里完成到枚举的映射, +/// 名称的合法性在保存配置时已由 [KeyboardScopeHelper.isSupportedTerminalKey] 校验。 +TerminalKey? resolveTerminalKey(String name) { + for (final key in TerminalKey.values) { + if (key.name == name) return key; + } + return null; +} + +/// 终端实现:把按键语义写入 xterm 终端。 +/// +/// 所有输入都经 `Terminal.onOutput`,在 `TerminalSession` 中该回调被接到 +/// PTY,因此这里等价于用户真按了键盘。 +/// 注意不要用 `TerminalSession.write()`——那是往屏幕缓冲区写显示内容。 +class TerminalKeyboardSink implements VirtualKeyboardSink { + final Terminal terminal; + final FocusNode? focusNode; + + TerminalKeyboardSink({required this.terminal, this.focusNode}); + + @override + void sendText(String text, {bool appendEnter = false}) { + if (text.isEmpty && !appendEnter) return; + + var payload = text; + // 避免用户已在 value 里写了换行时再补一个,造成双回车 + if (appendEnter && !payload.endsWith('\r') && !payload.endsWith('\n')) { + payload = '$payload\r'; + } + if (payload.isEmpty) return; + + // 多字符或含换行时走 paste:会遵循 bracketed paste mode,更安全 + if (payload.length > 1 || payload.contains('\n') || payload.contains('\r')) { + terminal.paste(payload); + } else { + terminal.textInput(payload); + } + } + + @override + void sendPair(String pairText, int cursorOffset) { + // 终端没有"包裹选区 + 光标偏移"的语义,降级为直接发送文本 + sendText(pairText); + } + + @override + void sendCommand(String command) { + switch (command.toLowerCase().trim()) { + case 'keyboard_hide': + case 'hide_keyboard': + hideKeyboard(); + break; + default: + // 编辑区命令在终端无意义;配置校验已禁止,这里仅作兜底 + if (kDebugMode) { + debugPrint('[VirtualKeyboard] 终端不支持编辑器命令: $command'); + } + } + } + + @override + void sendNamedKey(String keyName, {KeyboardKeyMods mods = KeyboardKeyMods.none}) { + // 字母键走 charInput:无修饰时就是该字母本身,Ctrl/Alt 组合由 xterm 换算 + if (KeyboardScopeHelper.isLetterKeyName(keyName)) { + final lowerCode = keyName.codeUnitAt(3) + 0x20; // keyC -> 'c' + final handled = terminal.charInput(lowerCode, ctrl: mods.ctrl, alt: mods.alt); + if (handled) return; + + // charInput 不支持的组合(无修饰 / 仅 Shift / Ctrl+非字母)按普通文本发送, + // 与 xterm 自身 `_onInsert` 的"先按键、后退化为文本"策略一致 + final letter = String.fromCharCode(lowerCode); + terminal.textInput(mods.shift ? letter.toUpperCase() : letter); + return; + } + + final key = resolveTerminalKey(keyName); + if (key == null) { + if (kDebugMode) { + debugPrint('[VirtualKeyboard] 未知的终端特殊键: $keyName'); + } + return; + } + + final handled = terminal.keyInput( + key, + ctrl: mods.ctrl, + alt: mods.alt, + shift: mods.shift, + ); + if (!handled && kDebugMode) { + // 例如 keytab 中不存在的组合:不会产生任何输出 + debugPrint('[VirtualKeyboard] 该按键组合在终端不会产生输出: $keyName' + '${mods.isEmpty ? '' : ' ($mods)'}'); + } + } + + @override + void hideKeyboard() { + focusNode?.unfocus(); + SystemChannels.textInput.invokeMethod('TextInput.hide'); + } +} diff --git a/lib/widgets/terminal_modifier_state.dart b/lib/widgets/terminal_modifier_state.dart new file mode 100644 index 0000000..d4e68dc --- /dev/null +++ b/lib/widgets/terminal_modifier_state.dart @@ -0,0 +1,148 @@ +import 'package:flutter/foundation.dart'; +import 'package:xterm/xterm.dart'; + +import '../models/virtual_keyboard_config.dart'; + +/// 终端修饰键(小键盘上的 Ctrl / Alt / Shift 格)的运行时状态。 +/// +/// 语义: +/// - 单击 = 一次性:点亮后由**下一次真实输入**带上并自动熄灭 +/// - 双击 = 锁定:持续生效,再点一次解除 +/// +/// 该状态由键盘组件与终端共用,因此它必须独立于 widget 生命周期存在: +/// 终端据此把修饰符叠加到"硬件键盘按键"和"软键盘打进来的字符"上。 +class TerminalModifierState extends ChangeNotifier { + TerminalModifierState({DateTime Function()? clock}) : clock = clock ?? DateTime.now; + + /// 双击判定时钟(测试可注入假时钟以确定性地控制单击/双击) + DateTime Function() clock; + + /// 双击判定窗口 + static const Duration doubleTapWindow = Duration(milliseconds: 350); + + final Set _oneshot = {}; + final Set _locked = {}; + final Map _lastTap = {}; + + bool isActive(String modifier) => + _oneshot.contains(modifier) || _locked.contains(modifier); + + bool get isEmpty => _oneshot.isEmpty && _locked.isEmpty; + + bool get isNotEmpty => !isEmpty; + + /// 当前生效的修饰符组合 + KeyboardKeyMods get mods => KeyboardKeyMods( + ctrl: isActive('ctrl'), + alt: isActive('alt'), + shift: isActive('shift'), + ); + + /// 单击一次性点亮 / 双击锁定 / 点击已锁定项解除 + void toggle(String modifier) { + final now = clock(); + final last = _lastTap[modifier]; + final isDoubleTap = last != null && now.difference(last) < doubleTapWindow; + + if (_locked.contains(modifier)) { + _locked.remove(modifier); + _oneshot.remove(modifier); + } else if (isDoubleTap) { + _oneshot.remove(modifier); + _locked.add(modifier); + } else if (_oneshot.contains(modifier)) { + _oneshot.remove(modifier); + } else { + _oneshot.add(modifier); + } + _lastTap[modifier] = now; + notifyListeners(); + } + + /// 一次性状态被一次真实输入消耗(锁定状态保留) + void consume() { + if (_oneshot.isEmpty) return; + _oneshot.clear(); + notifyListeners(); + } + + /// 清空全部状态 + void clear() { + if (isEmpty) return; + _oneshot.clear(); + _locked.clear(); + _lastTap.clear(); + notifyListeners(); + } +} + +/// 把"软键盘 / IME 直接打进来的文本"按当前修饰键状态改写。 +/// +/// 软键盘的字符不会产生 Flutter KeyEvent,xterm 内部走的是 +/// `terminal.textInput()`,因此只能在 `Terminal.onOutput` 这一层改写。 +/// 规则与 xterm 的 `Terminal.charInput` 保持一致: +/// - Ctrl + a~z → 0x01~0x1a +/// - Ctrl + [ \ ] ^ _ → 0x1b~0x1f +/// - Alt + a~z → ESC + 大写字母 +/// - Shift + a~z → 大写字母 +/// +/// 只处理**单个字符**:多字符(粘贴、指令快捷键)原样放过,避免误伤。 +/// 返回 null 表示"无需改写"。 +String? applyModifierToTypedText(String data, KeyboardKeyMods mods) { + if (mods.isEmpty) return null; + + final runes = data.runes.toList(); + if (runes.length != 1) return null; + + final code = runes.first; + final isLetter = (code >= 0x61 && code <= 0x7a) || (code >= 0x41 && code <= 0x5a); + final lower = (code >= 0x41 && code <= 0x5a) ? code + 0x20 : code; + + if (mods.ctrl) { + if (isLetter) return String.fromCharCode(lower - 0x61 + 1); + if (code >= 0x5b && code <= 0x5f) return String.fromCharCode(code - 0x5b + 27); + return null; + } + + if (mods.alt && !mods.shift) { + if (isLetter) return String.fromCharCodes([0x1b, lower - 0x20]); + return null; + } + + if (mods.shift && code >= 0x61 && code <= 0x7a) { + return String.fromCharCode(code - 0x20); + } + + return null; +} + +/// 代理输入处理器:把运行时修饰键叠加到按键事件上,再交给 xterm 默认链路。 +/// +/// 覆盖硬件键盘与"小键盘 key 格"的按键事件(它们都走 `Terminal.keyInput`); +/// 软键盘打进来的字符不产生 KeyEvent,由 [applyModifierToTypedText] 处理。 +class ModifierAwareInputHandler implements TerminalInputHandler { + ModifierAwareInputHandler({required this.state, required this.delegate}); + + final TerminalModifierState state; + final TerminalInputHandler delegate; + + @override + String? call(TerminalKeyboardEvent event) { + final mods = state.mods; + final result = delegate( + mods.isEmpty + ? event + : event.copyWith( + ctrl: event.ctrl || mods.ctrl, + alt: event.alt || mods.alt, + shift: event.shift || mods.shift, + ), + ); + + // 真的产生了输出才消耗一次性状态,避免"按了没反应还把修饰键吃掉" + if (result != null && mods.isNotEmpty) { + state.consume(); + } + return result; + } +} diff --git a/lib/widgets/terminal_session_item_widget.dart b/lib/widgets/terminal_session_item_widget.dart index b0ed2a2..ed41477 100644 --- a/lib/widgets/terminal_session_item_widget.dart +++ b/lib/widgets/terminal_session_item_widget.dart @@ -26,12 +26,20 @@ class TerminalSessionItemWidget extends StatelessWidget { final badgeLabel = session.distroId; final isHost = session.distroId == 'host'; + final isTerminated = !session.isProcessRunning; + final textStyle = theme.textTheme.bodyMedium?.copyWith( fontWeight: isSelected ? FontWeight.w600 : FontWeight.normal, - color: isSelected ? theme.colorScheme.primary : null, + color: isTerminated + ? theme.colorScheme.error + : (isSelected ? theme.colorScheme.primary : null), + decoration: isTerminated ? TextDecoration.lineThrough : null, + decorationColor: isTerminated ? theme.colorScheme.error : null, ); - final iconColor = isSelected ? theme.colorScheme.primary : null; + final iconColor = isTerminated + ? theme.colorScheme.error + : (isSelected ? theme.colorScheme.primary : null); return Container( margin: const EdgeInsets.symmetric(horizontal: 8.0, vertical: 2.0), @@ -66,6 +74,8 @@ class TerminalSessionItemWidget extends StatelessWidget { const SizedBox(width: 6), Container( padding: const EdgeInsets.symmetric(horizontal: 6.0, vertical: 1.5), + // 系统名可能来自用户自定义导入,过长时限宽避免把标题行挤出边界 + constraints: const BoxConstraints(maxWidth: 96.0), decoration: BoxDecoration( color: isHost ? theme.colorScheme.surfaceContainerHighest @@ -74,6 +84,8 @@ class TerminalSessionItemWidget extends StatelessWidget { ), child: Text( badgeLabel, + maxLines: 1, + overflow: TextOverflow.ellipsis, style: TextStyle( fontSize: 10.0, fontWeight: FontWeight.w600, @@ -175,9 +187,13 @@ class TerminalSessionItemWidget extends StatelessWidget { children: [ Icon(icon, size: 18, color: color), const SizedBox(width: 8), - Text( - title, - style: TextStyle(color: color), + Flexible( + child: Text( + title, + maxLines: 1, + overflow: TextOverflow.ellipsis, + style: TextStyle(color: color), + ), ), ], ), diff --git a/lib/widgets/virtual_keyboard_key_edit_dialog.dart b/lib/widgets/virtual_keyboard_key_edit_dialog.dart index 5b7ccc4..ae75757 100644 --- a/lib/widgets/virtual_keyboard_key_edit_dialog.dart +++ b/lib/widgets/virtual_keyboard_key_edit_dialog.dart @@ -22,12 +22,27 @@ class _KeyEditDialogState extends State { late TextEditingController _labelController; late TextEditingController _valueInputController; + late TextEditingController _pairValueController; late TextEditingController _cursorOffsetController; String? _selectedIcon; late String _selectedAction; String? _selectedPresetValue; + /// 终端特殊键:所选 TerminalKey 枚举名 + String? _selectedNamedKey; + + /// 终端特殊键:下方三个修饰键控件组成的组合 + KeyboardKeyMods _selectedMods = KeyboardKeyMods.none; + + /// 终端修饰键动作:所选的 ctrl / alt / shift + String _selectedModifierValue = 'ctrl'; + + /// 终端指令快捷键:发送后是否自动回车 + bool _autoEnter = false; + + bool get _isTerminal => widget.scope == KeyboardScope.terminal; + @override void initState() { super.initState(); @@ -35,6 +50,10 @@ class _KeyEditDialogState extends State { _labelController = TextEditingController(text: init?.label ?? ''); _valueInputController = TextEditingController(text: init?.value ?? ''); + // 成对符号不再依赖预设列表,改为自由输入,默认给出最常用的圆括号 + _pairValueController = TextEditingController( + text: (init != null && init.action == 'pair' && init.value.isNotEmpty) ? init.value : '()', + ); _cursorOffsetController = TextEditingController( text: (init?.cursorOffset ?? (init?.action == 'pair' ? -1 : 0)).toString(), ); @@ -57,40 +76,147 @@ class _KeyEditDialogState extends State { } void _syncPresetValueFromInitial() { - final currentVal = widget.initialKey?.value ?? ''; + final init = widget.initialKey; + final currentVal = init?.value ?? ''; + + _autoEnter = init?.autoEnter ?? false; + _selectedMods = (init != null && init.action == 'key') ? init.mods : KeyboardKeyMods.none; + + // 终端修饰键动作取值 + _selectedModifierValue = KeyboardScopeHelper.terminalModifierValues.contains(currentVal) + ? currentVal + : KeyboardScopeHelper.terminalModifierValues.first; + + // 终端特殊键取值(支持 31 命名键与 keyA~keyZ) + _selectedNamedKey = (init != null && + init.action == 'key' && + KeyboardScopeHelper.terminalSupportedKeyNames.contains(currentVal)) + ? currentVal + : KeyboardScopeHelper.terminalNamedKeys.first.value; + if (_selectedAction == 'command') { - if (KeyboardScopeHelper.editorCommands.any((c) => c.value == currentVal)) { - _selectedPresetValue = currentVal; - } else { - _selectedPresetValue = KeyboardScopeHelper.editorCommands.first.value; - } - } else if (_selectedAction == 'pair') { - if (KeyboardScopeHelper.editorPairs.any((p) => p.value == currentVal)) { - _selectedPresetValue = currentVal; - } else { - _selectedPresetValue = KeyboardScopeHelper.editorPairs.first.value; - } - } else if (_selectedAction == 'modifier') { - if (KeyboardScopeHelper.terminalModifiers.any((m) => m.value == currentVal)) { - _selectedPresetValue = currentVal; - } else { - _selectedPresetValue = KeyboardScopeHelper.terminalModifiers.first.value; - } - } else if (_selectedAction == 'terminal_key') { - if (KeyboardScopeHelper.terminalKeys.any((k) => k.value == currentVal)) { - _selectedPresetValue = currentVal; - } else { - _selectedPresetValue = KeyboardScopeHelper.terminalKeys.first.value; - } + _selectedPresetValue = KeyboardScopeHelper.editorCommands.any((c) => c.value == currentVal) + ? currentVal + : KeyboardScopeHelper.editorCommands.first.value; } else { _selectedPresetValue = null; } } + /// 动作在下拉中的显示名(终端作用域下 input 即"指令快捷键") + String _actionLabel(AppLocalizations l10n, String action) { + if (_isTerminal && action == 'input') { + return l10n.keyboardActionInputTerminal; + } + return l10n.keyboardActionName(action); + } + + /// 按键标签留空时的兜底文案:特殊键用「修饰符+紧凑键名」,其余沿用 value + String _fallbackLabel(String value, KeyboardKeyMods mods) { + if (_selectedAction != 'key') return value; + final prefix = [ + if (mods.ctrl) 'Ctrl', + if (mods.alt) 'Alt', + if (mods.shift) 'Shift', + ]; + final short = KeyboardScopeHelper.terminalKeyShortLabel(value); + return prefix.isEmpty ? short : '${prefix.join('+')}+$short'; + } + + /// 终端特殊键下拉:按分组插入不可选的标题项 + List> _buildNamedKeyItems(AppLocalizations l10n) { + final items = >[]; + TerminalKeyGroup? lastGroup; + + for (final option in KeyboardScopeHelper.terminalSelectableKeys) { + if (option.group != lastGroup) { + lastGroup = option.group; + items.add( + DropdownMenuItem( + value: null, + enabled: false, + child: Padding( + padding: const EdgeInsets.symmetric(vertical: 2), + child: Text( + _groupLabel(l10n, option.group), + style: TextStyle( + fontSize: 12, + fontWeight: FontWeight.bold, + color: Theme.of(context).colorScheme.primary, + ), + ), + ), + ), + ); + } + items.add( + DropdownMenuItem( + value: option.value, + child: Row( + children: [ + Icon(KeyboardIconHelper.getIcon(option.icon), size: 18), + const SizedBox(width: 8), + Expanded( + child: Text( + // 字母键在每种语言下都显示同一个拉丁字母,无需走 l10n + KeyboardScopeHelper.isLetterKeyName(option.value) + ? KeyboardScopeHelper.terminalKeyShortLabel(option.value) + : l10n.keyboardKeyName(option.value), + overflow: TextOverflow.ellipsis, + ), + ), + ], + ), + ), + ); + } + return items; + } + + String _groupLabel(AppLocalizations l10n, TerminalKeyGroup group) { + switch (group) { + case TerminalKeyGroup.navigation: + return l10n.keyboardKeyGroupNavigation; + case TerminalKeyGroup.editing: + return l10n.keyboardKeyGroupEditing; + case TerminalKeyGroup.functionKeys: + return l10n.keyboardKeyGroupFunctionKeys; + case TerminalKeyGroup.letters: + return l10n.keyboardKeyGroupLetters; + } + } + + /// 下方三个修饰键控件之一;切换后立即重新校验,避免出现静默无效的组合 + Widget _buildModifierChip(AppLocalizations l10n, String modifier, bool selected) { + return FilterChip( + label: Text(l10n.keyboardModifierName(modifier)), + selected: selected, + onSelected: (value) { + setState(() { + KeyboardKeyMods mods = _selectedMods; + switch (modifier) { + case 'ctrl': + mods = mods.copyWith(ctrl: value); + break; + case 'alt': + mods = mods.copyWith(alt: value); + break; + case 'shift': + mods = mods.copyWith(shift: value); + break; + } + _selectedMods = mods; + }); + _formKey.currentState?.validate(); + }, + ); + } + @override void dispose() { _labelController.dispose(); _valueInputController.dispose(); + _pairValueController.dispose(); _cursorOffsetController.dispose(); super.dispose(); } @@ -100,19 +226,19 @@ class _KeyEditDialogState extends State { setState(() { _selectedAction = newAction; if (_selectedAction == 'pair') { - _selectedPresetValue = KeyboardScopeHelper.editorPairs.first.value; + if (_pairValueController.text.trim().isEmpty) { + _pairValueController.text = '()'; + } if (_cursorOffsetController.text.isEmpty || _cursorOffsetController.text == '0') { _cursorOffsetController.text = '-1'; } - if (_labelController.text.isEmpty) { - _labelController.text = _selectedPresetValue!; - } + // 标签留空时由 _onSave 回退为成对符号内容,与 input 行为一致 } else if (_selectedAction == 'command') { _selectedPresetValue = KeyboardScopeHelper.editorCommands.first.value; } else if (_selectedAction == 'modifier') { - _selectedPresetValue = KeyboardScopeHelper.terminalModifiers.first.value; - } else if (_selectedAction == 'terminal_key') { - _selectedPresetValue = KeyboardScopeHelper.terminalKeys.first.value; + _selectedModifierValue = KeyboardScopeHelper.terminalModifierValues.first; + } else if (_selectedAction == 'key') { + _selectedNamedKey ??= KeyboardScopeHelper.terminalNamedKeys.first.value; } else { _selectedPresetValue = null; } @@ -125,23 +251,37 @@ class _KeyEditDialogState extends State { final String label = _labelController.text.trim(); String value; int cursorOffset = 0; + KeyboardKeyMods mods = KeyboardKeyMods.none; + bool autoEnter = false; - if (_selectedAction == 'input') { - value = _valueInputController.text; - } else { - value = _selectedPresetValue ?? ''; - } - - if (_selectedAction == 'pair') { - cursorOffset = int.tryParse(_cursorOffsetController.text.trim()) ?? -1; + switch (_selectedAction) { + case 'input': + value = _valueInputController.text; + if (_isTerminal) autoEnter = _autoEnter; + break; + case 'pair': + value = _pairValueController.text.trim(); + cursorOffset = int.tryParse(_cursorOffsetController.text.trim()) ?? -1; + break; + case 'key': + value = _selectedNamedKey ?? ''; + mods = _selectedMods; + break; + case 'modifier': + value = _selectedModifierValue; + break; + default: + value = _selectedPresetValue ?? ''; } final keyItem = KeyboardKeyItem( - label: label.isNotEmpty ? label : value, + label: label.isNotEmpty ? label : _fallbackLabel(value, mods), icon: (_selectedIcon != null && _selectedIcon!.isNotEmpty) ? _selectedIcon : null, action: _selectedAction, value: value, cursorOffset: cursorOffset, + mods: mods, + autoEnter: autoEnter, ); Navigator.of(context).pop(keyItem); @@ -208,7 +348,10 @@ class _KeyEditDialogState extends State { Icon(KeyboardIconHelper.getIcon(iconKey), size: 18), const SizedBox(width: 8), Expanded( - child: Text(iconKey, overflow: TextOverflow.ellipsis), + child: Text( + l10n.keyboardIconName(iconKey), + overflow: TextOverflow.ellipsis, + ), ), ], ), @@ -235,7 +378,10 @@ class _KeyEditDialogState extends State { items: availableActions.map( (actionOption) => DropdownMenuItem( value: actionOption.action, - child: Text(actionOption.label, overflow: TextOverflow.ellipsis), + child: Text( + _actionLabel(l10n, actionOption.action), + overflow: TextOverflow.ellipsis, + ), ), ).toList(), onChanged: _onActionChanged, @@ -243,7 +389,7 @@ class _KeyEditDialogState extends State { const SizedBox(height: 14), // 动作值 Value 控件联动 - if (_selectedAction == 'input') + if (_selectedAction == 'input') ...[ TextFormField( controller: _valueInputController, decoration: InputDecoration( @@ -258,29 +404,38 @@ class _KeyEditDialogState extends State { } return null; }, - ) + ), + // 终端指令快捷键:发送后补回车,实现"一格执行命令" + if (_isTerminal) + SwitchListTile( + contentPadding: EdgeInsets.zero, + dense: true, + title: Text(l10n.keyboardAutoEnter), + value: _autoEnter, + onChanged: (val) => setState(() => _autoEnter = val), + ), + ] else if (_selectedAction == 'pair') - DropdownButtonFormField( - isExpanded: true, - initialValue: _selectedPresetValue, + TextFormField( + controller: _pairValueController, decoration: InputDecoration( - labelText: l10n.keyboardPairPresetFormField, + labelText: l10n.keyboardPairValueFormField, + hintText: l10n.keyboardPairValueFormFieldHint, border: const OutlineInputBorder(), isDense: true, ), - items: KeyboardScopeHelper.editorPairs.map( - (pair) => DropdownMenuItem( - value: pair.value, - child: Text('${pair.label} (${pair.value})', overflow: TextOverflow.ellipsis), - ), - ).toList(), - onChanged: (val) { - setState(() { - _selectedPresetValue = val; - if (_labelController.text.isEmpty && val != null) { - _labelController.text = val; - } - }); + validator: (val) { + final v = val?.trim() ?? ''; + if (v.isEmpty) { + return l10n.keyboardPairValueRequiredError; + } + final half = v.length ~/ 2; + // 长度不足 2 或左右完全相同(如 "((" )无法构成有效的前后半段 + if (v.length < 2 || + (v.length.isEven && v.substring(0, half) == v.substring(half))) { + return l10n.keyboardPairValueInvalidError; + } + return null; }, ) else if (_selectedAction == 'command') @@ -295,7 +450,18 @@ class _KeyEditDialogState extends State { items: KeyboardScopeHelper.editorCommands.map( (cmd) => DropdownMenuItem( value: cmd.value, - child: Text('${cmd.label} [${cmd.value}]', overflow: TextOverflow.ellipsis), + child: Row( + children: [ + Icon(KeyboardIconHelper.getIcon(cmd.icon), size: 18), + const SizedBox(width: 8), + Expanded( + child: Text( + l10n.keyboardCommandName(cmd.value), + overflow: TextOverflow.ellipsis, + ), + ), + ], + ), ), ).toList(), onChanged: (val) { @@ -307,45 +473,62 @@ class _KeyEditDialogState extends State { else if (_selectedAction == 'modifier') DropdownButtonFormField( isExpanded: true, - initialValue: _selectedPresetValue, + initialValue: _selectedModifierValue, decoration: InputDecoration( labelText: l10n.keyboardModifierPresetFormField, border: const OutlineInputBorder(), isDense: true, ), - items: KeyboardScopeHelper.terminalModifiers.map( - (m) => DropdownMenuItem( - value: m.value, - child: Text(m.label, overflow: TextOverflow.ellipsis), - ), - ).toList(), + items: KeyboardScopeHelper.terminalModifierValues + .map( + (m) => DropdownMenuItem( + value: m, + child: Text(l10n.keyboardModifierName(m), overflow: TextOverflow.ellipsis), + ), + ) + .toList(), onChanged: (val) { + if (val == null) return; setState(() { - _selectedPresetValue = val; + _selectedModifierValue = val; }); }, ) - else if (_selectedAction == 'terminal_key') - DropdownButtonFormField( + else if (_selectedAction == 'key') ...[ + DropdownButtonFormField( isExpanded: true, - initialValue: _selectedPresetValue, + initialValue: _selectedNamedKey, decoration: InputDecoration( - labelText: l10n.keyboardTerminalKeyPresetFormField, + labelText: l10n.keyboardKeyFormField, border: const OutlineInputBorder(), isDense: true, ), - items: KeyboardScopeHelper.terminalKeys.map( - (k) => DropdownMenuItem( - value: k.value, - child: Text(k.label, overflow: TextOverflow.ellipsis), - ), - ).toList(), + items: _buildNamedKeyItems(l10n), onChanged: (val) { + if (val == null) return; setState(() { - _selectedPresetValue = val; + _selectedNamedKey = val; }); }, + validator: (val) { + final name = val ?? ''; + if (name.isEmpty || !KeyboardScopeHelper.isSupportedTerminalKey(name)) { + return l10n.keyboardKeyInvalidError; + } + return null; + }, ), + const SizedBox(height: 12), + // 单独提供三个修饰键:与下拉里选中的键叠加成 Ctrl+C 这类组合 + Wrap( + spacing: 8, + children: [ + _buildModifierChip(l10n, 'ctrl', _selectedMods.ctrl), + _buildModifierChip(l10n, 'alt', _selectedMods.alt), + _buildModifierChip(l10n, 'shift', _selectedMods.shift), + ], + ), + ], // 仅当 action == pair 时显示 cursorOffset if (_selectedAction == 'pair') ...[ @@ -355,7 +538,6 @@ class _KeyEditDialogState extends State { keyboardType: const TextInputType.numberWithOptions(signed: true), decoration: InputDecoration( labelText: l10n.keyboardCursorOffsetFormField, - helperText: l10n.keyboardCursorOffsetHelper, border: const OutlineInputBorder(), isDense: true, ), diff --git a/lib/widgets/virtual_keyboard_page_config_section.dart b/lib/widgets/virtual_keyboard_page_config_section.dart index ca0440d..0e813db 100644 --- a/lib/widgets/virtual_keyboard_page_config_section.dart +++ b/lib/widgets/virtual_keyboard_page_config_section.dart @@ -24,9 +24,13 @@ class VirtualKeyboardPageConfigSection extends StatelessWidget { children: [ Icon(Icons.tune, size: 20, color: theme.colorScheme.primary), const SizedBox(width: 8), - Text( - l10n.keyboardPageConfigSectionTitle, - style: const TextStyle(fontSize: 16, fontWeight: FontWeight.bold), + Expanded( + child: Text( + l10n.keyboardPageConfigSectionTitle, + maxLines: 1, + overflow: TextOverflow.ellipsis, + style: const TextStyle(fontSize: 16, fontWeight: FontWeight.bold), + ), ), ], ), @@ -41,20 +45,24 @@ class VirtualKeyboardPageConfigSection extends StatelessWidget { child: Padding( padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 14), child: Row( - mainAxisAlignment: MainAxisAlignment.spaceBetween, children: [ - Column( - crossAxisAlignment: CrossAxisAlignment.start, - children: [ - Text(l10n.keyboardRowButtons, style: const TextStyle(fontWeight: FontWeight.w500)), - const SizedBox(height: 2), - Text( - l10n.keyboardRowGridDescription(count), - style: TextStyle(fontSize: 12, color: theme.hintColor), - ), - ], + // 左侧文案必须可收缩,否则 Row 内的定宽控件会被挤出右边界 + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text(l10n.keyboardRowButtons, style: const TextStyle(fontWeight: FontWeight.w500)), + const SizedBox(height: 2), + Text( + l10n.keyboardRowGridDescription(count), + style: TextStyle(fontSize: 12, color: theme.hintColor), + ), + ], + ), ), + const SizedBox(width: 12), Row( + mainAxisSize: MainAxisSize.min, children: [ IconButton.filledTonal( icon: const Icon(Icons.remove, size: 18), diff --git a/lib/widgets/virtual_keyboard_sink.dart b/lib/widgets/virtual_keyboard_sink.dart new file mode 100644 index 0000000..cbb1b6d --- /dev/null +++ b/lib/widgets/virtual_keyboard_sink.dart @@ -0,0 +1,172 @@ +import 'package:flutter/foundation.dart'; +import 'package:flutter/material.dart'; +import 'package:flutter/services.dart'; +import 'package:re_editor/re_editor.dart'; + +import '../models/virtual_keyboard_config.dart'; + +/// 虚拟小键盘的输入汇聚接口。 +/// +/// 键盘组件只负责"按键语义"(文本 / 成对符号 / 编辑器命令 / 命名特殊键), +/// 由具体实现决定把语义落到编辑器还是终端上,避免键盘组件per-scope 分叉。 +/// +/// 不同作用域对同一语义的支持程度不同,不支持的实现应安全降级为空操作, +/// 绝不静默插入无关内容。 +abstract class VirtualKeyboardSink { + /// 发送一段文本(编辑区:插入;终端:写入 PTY) + /// + /// [appendEnter] 仅终端有意义:发送后补一个回车符,实现"输入即执行" + void sendText(String text, {bool appendEnter = false}); + + /// 成对符号:有选区时包裹选区,无选区时插入并把光标按 [cursorOffset] 偏移 + void sendPair(String pairText, int cursorOffset); + + /// 编辑器命令(缩进、撤销、光标移动等) + void sendCommand(String command); + + /// 命名特殊键(终端:escape / tab / arrowUp / keyC + Ctrl 组合等) + void sendNamedKey(String keyName, {KeyboardKeyMods mods = KeyboardKeyMods.none}); + + /// 收起软键盘 + void hideKeyboard(); +} + +/// 编辑区实现:把按键语义落到 [CodeLineEditingController] 上 +class EditorKeyboardSink implements VirtualKeyboardSink { + final CodeLineEditingController controller; + final FocusNode? focusNode; + + EditorKeyboardSink({required this.controller, this.focusNode}); + + @override + void sendText(String text, {bool appendEnter = false}) { + if (text.isEmpty) return; + // 编辑区不存在"回车执行"语义,appendEnter 直接忽略(由校验层禁止该组合) + controller.replaceSelection(text); + } + + @override + void sendPair(String pairText, int cursorOffset) { + final hasSelection = !controller.selection.isCollapsed && + controller.selection.baseOffset != -1 && + controller.selection.extentOffset != -1; + + if (hasSelection) { + final selected = controller.selectedText; + if (pairText.length >= 2) { + final left = pairText.substring(0, pairText.length ~/ 2); + final right = pairText.substring(pairText.length ~/ 2); + controller.replaceSelection(left + selected + right); + } else { + controller.replaceSelection(pairText + selected + pairText); + } + return; + } + + controller.replaceSelection(pairText); + if (cursorOffset != 0) { + final curSel = controller.selection; + final targetOffset = (curSel.extentOffset + cursorOffset).clamp(0, controller.extentLine.length); + controller.selection = CodeLineSelection.collapsed( + index: curSel.extentIndex, + offset: targetOffset, + ); + } + } + + @override + void sendCommand(String command) { + final cmd = command.toLowerCase().trim(); + switch (cmd) { + case 'tab': + controller.applyIndent(); + break; + case 'untab': + case 'outdent': + controller.applyOutdent(); + break; + case 'cursor_left': + case 'left': + controller.moveCursor(AxisDirection.left); + break; + case 'cursor_right': + case 'right': + controller.moveCursor(AxisDirection.right); + break; + case 'cursor_up': + case 'up': + controller.moveCursor(AxisDirection.up); + break; + case 'cursor_down': + case 'down': + controller.moveCursor(AxisDirection.down); + break; + case 'line_start': + case 'home': + controller.moveCursorToLineStart(); + break; + case 'line_end': + case 'end': + controller.moveCursorToLineEnd(); + break; + case 'page_start': + controller.moveCursorToPageStart(); + break; + case 'page_end': + controller.moveCursorToPageEnd(); + break; + case 'undo': + if (controller.canUndo) { + controller.undo(); + } + break; + case 'redo': + if (controller.canRedo) { + controller.redo(); + } + break; + case 'copy': + controller.copy(); + break; + case 'cut': + controller.cut(); + break; + case 'paste': + controller.paste(); + break; + case 'backspace': + case 'delete_backward': + controller.deleteBackward(); + break; + case 'delete': + case 'delete_forward': + controller.deleteForward(); + break; + case 'select_all': + controller.selectAll(); + break; + case 'keyboard_hide': + case 'hide_keyboard': + hideKeyboard(); + break; + default: + // 未知命令安全降级为直接输入其命令名称或原文本 + controller.replaceSelection(command); + break; + } + } + + @override + void sendNamedKey(String keyName, {KeyboardKeyMods mods = KeyboardKeyMods.none}) { + // 编辑区没有"终端命名键"概念;配置校验已禁止该组合,这里仅作兜底不产生副作用 + if (kDebugMode) { + debugPrint('[VirtualKeyboard] 编辑区不支持命名特殊键: $keyName${mods.isEmpty ? '' : ' ($mods)'}'); + } + } + + @override + void hideKeyboard() { + focusNode?.unfocus(); + SystemChannels.textInput.invokeMethod('TextInput.hide'); + } +} diff --git a/lib/widgets/virtual_keyboard_widget.dart b/lib/widgets/virtual_keyboard_widget.dart index db2674f..d3fc2c1 100644 --- a/lib/widgets/virtual_keyboard_widget.dart +++ b/lib/widgets/virtual_keyboard_widget.dart @@ -3,10 +3,22 @@ import 'package:flutter/material.dart'; import 'package:flutter/services.dart'; import 'package:re_editor/re_editor.dart'; +import 'virtual_keyboard_sink.dart'; +import 'terminal_modifier_state.dart'; + /// 编辑器下方的虚拟辅助小键盘组件 class VirtualKeyboardWidget extends StatefulWidget { final CodeLineEditingController? controller; final FocusNode? focusNode; + + /// 输入汇聚实现。为空时按 [controller] 自动构造编辑区实现; + /// 终端作用域传入 `TerminalKeyboardSink`。 + final VirtualKeyboardSink? sink; + + /// 终端修饰键运行时状态。终端作用域由外部注入,使终端也能读到同一份状态 + /// (把修饰符叠加到软键盘/硬件键盘的输入上);为空时组件内部自建一份。 + final TerminalModifierState? modifierState; + final VirtualKeyboardConfig config; final Color? backgroundColor; @@ -14,6 +26,8 @@ class VirtualKeyboardWidget extends StatefulWidget { super.key, required this.controller, this.focusNode, + this.sink, + this.modifierState, required this.config, this.backgroundColor, }); @@ -28,6 +42,15 @@ class _VirtualKeyboardWidgetState extends State late AnimationController _animationController; int _currentPage = 0; + /// 输入汇聚实现(终端作用域由外部注入,否则按 controller 构造编辑区实现) + VirtualKeyboardSink? _sink; + + /// 修饰键运行时状态(终端作用域由外部注入,使终端能共用同一份状态) + late TerminalModifierState _modifiers; + + /// 是否由本组件创建了 [_modifiers](自建时才负责释放) + bool _ownsModifiers = false; + static const double _rowHeight = 30.0; static const double _indicatorHeight = 12.0; @@ -40,18 +63,64 @@ class _VirtualKeyboardWidgetState extends State duration: const Duration(milliseconds: 200), value: 0.0, // 默认折叠(0.0 表示仅显示第一行,1.0 表示完全展开) ); + _resolveSink(); + _resolveModifiers(); + } + + @override + void didUpdateWidget(covariant VirtualKeyboardWidget oldWidget) { + super.didUpdateWidget(oldWidget); + if (oldWidget.sink != widget.sink || oldWidget.controller != widget.controller) { + _resolveSink(); + } + if (oldWidget.modifierState != widget.modifierState) { + _releaseModifiers(); + _resolveModifiers(); + } + } + + /// 终端作用域由外部注入 sink;编辑区按 controller 自动构造 + void _resolveSink() { + _sink = widget.sink ?? + (widget.controller != null + ? EditorKeyboardSink(controller: widget.controller!, focusNode: widget.focusNode) + : null); + } + + void _resolveModifiers() { + final injected = widget.modifierState; + if (injected != null) { + _modifiers = injected; + _ownsModifiers = false; + } else { + _modifiers = TerminalModifierState(); + _ownsModifiers = true; + } + _modifiers.addListener(_onModifiersChanged); + } + + void _releaseModifiers() { + _modifiers.removeListener(_onModifiersChanged); + if (_ownsModifiers) { + _modifiers.dispose(); + } + } + + void _onModifiersChanged() { + if (mounted) setState(() {}); } @override void dispose() { + _releaseModifiers(); _pageController.dispose(); _animationController.dispose(); super.dispose(); } void _handleKeyTap(KeyboardKeyItem keyItem) { - final controller = widget.controller; - if (controller == null) return; + final sink = _sink; + if (sink == null) return; // 轻微触觉反馈提升敲击手感 HapticFeedback.lightImpact(); @@ -61,133 +130,45 @@ class _VirtualKeyboardWidgetState extends State widget.focusNode!.requestFocus(); } + // 修饰键只切换运行时状态,不产生输出 + if (keyItem.action == 'modifier') { + _modifiers.toggle(keyItem.value); + return; + } + + final mods = _effectiveMods(keyItem.mods); + switch (keyItem.action) { case 'command': - _handleCommand(controller, keyItem.value); + sink.sendCommand(keyItem.value); break; case 'pair': - _handlePair(controller, keyItem.value, keyItem.cursorOffset); + sink.sendPair(keyItem.value, keyItem.cursorOffset); + break; + case 'key': + sink.sendNamedKey(keyItem.value, mods: mods); break; case 'input': default: - _handleInput(controller, keyItem.value.isNotEmpty ? keyItem.value : keyItem.label); - break; - } - } - - void _handleInput(CodeLineEditingController controller, String text) { - if (text.isEmpty) return; - controller.replaceSelection(text); - } - - void _handlePair(CodeLineEditingController controller, String pairText, int offset) { - final hasSelection = !controller.selection.isCollapsed && - controller.selection.baseOffset != -1 && - controller.selection.extentOffset != -1; - - if (hasSelection) { - final selected = controller.selectedText; - if (pairText.length >= 2) { - final left = pairText.substring(0, pairText.length ~/ 2); - final right = pairText.substring(pairText.length ~/ 2); - final wrapped = left + selected + right; - controller.replaceSelection(wrapped); - } else { - controller.replaceSelection(pairText + selected + pairText); - } - } else { - controller.replaceSelection(pairText); - if (offset != 0) { - final curSel = controller.selection; - final targetOffset = (curSel.extentOffset + offset).clamp(0, controller.extentLine.length); - controller.selection = CodeLineSelection.collapsed( - index: curSel.extentIndex, - offset: targetOffset, + sink.sendText( + keyItem.value.isNotEmpty ? keyItem.value : keyItem.label, + appendEnter: keyItem.autoEnter, ); - } + break; } + + // 一次性修饰键被"下一次任意按键"消耗(含 Esc、方向键这类不产生字符的键) + _modifiers.consume(); } - void _handleCommand(CodeLineEditingController controller, String command) { - final cmd = command.toLowerCase().trim(); - switch (cmd) { - case 'tab': - controller.applyIndent(); - break; - case 'untab': - case 'outdent': - controller.applyOutdent(); - break; - case 'cursor_left': - case 'left': - controller.moveCursor(AxisDirection.left); - break; - case 'cursor_right': - case 'right': - controller.moveCursor(AxisDirection.right); - break; - case 'cursor_up': - case 'up': - controller.moveCursor(AxisDirection.up); - break; - case 'cursor_down': - case 'down': - controller.moveCursor(AxisDirection.down); - break; - case 'line_start': - case 'home': - controller.moveCursorToLineStart(); - break; - case 'line_end': - case 'end': - controller.moveCursorToLineEnd(); - break; - case 'page_start': - controller.moveCursorToPageStart(); - break; - case 'page_end': - controller.moveCursorToPageEnd(); - break; - case 'undo': - if (controller.canUndo) { - controller.undo(); - } - break; - case 'redo': - if (controller.canRedo) { - controller.redo(); - } - break; - case 'copy': - controller.copy(); - break; - case 'cut': - controller.cut(); - break; - case 'paste': - controller.paste(); - break; - case 'backspace': - case 'delete_backward': - controller.deleteBackward(); - break; - case 'delete': - case 'delete_forward': - controller.deleteForward(); - break; - case 'select_all': - controller.selectAll(); - break; - case 'keyboard_hide': - case 'hide_keyboard': - widget.focusNode?.unfocus(); - SystemChannels.textInput.invokeMethod('TextInput.hide'); - break; - default: - // 未知命令安全降级为直接输入其命令名称或原文本 - controller.replaceSelection(command); - break; - } + /// 合并按键自身配置的修饰符与运行时激活的修饰符 + KeyboardKeyMods _effectiveMods(KeyboardKeyMods own) { + final active = _modifiers.mods; + return KeyboardKeyMods( + ctrl: own.ctrl || active.ctrl, + alt: own.alt || active.alt, + shift: own.shift || active.shift, + ); } @override @@ -392,9 +373,18 @@ class _VirtualKeyboardWidgetState extends State Widget _buildKeyButton(KeyboardKeyItem keyItem, bool isDark) { final iconData = KeyboardIconHelper.getIcon(keyItem.icon); - final btnBgColor = isDark ? const Color(0xFF2C2C2C) : const Color(0xFFFFFFFF); - final btnTextColor = isDark ? const Color(0xFFE0E0E0) : const Color(0xFF303133); - final borderColor = isDark ? const Color(0xFF383838) : const Color(0xFFE4E7ED); + // 修饰键处于激活(一次性或锁定)状态时高亮,让用户看清当前修饰状态 + final isModifierActive = keyItem.action == 'modifier' && _modifiers.isActive(keyItem.value); + + final btnBgColor = isModifierActive + ? (isDark ? const Color(0xFF2F4F6F) : const Color(0xFFD6E6FF)) + : (isDark ? const Color(0xFF2C2C2C) : const Color(0xFFFFFFFF)); + final btnTextColor = isModifierActive + ? (isDark ? const Color(0xFFFFFFFF) : const Color(0xFF0B57D0)) + : (isDark ? const Color(0xFFE0E0E0) : const Color(0xFF303133)); + final borderColor = isModifierActive + ? const Color(0xFF0B57D0) + : (isDark ? const Color(0xFF383838) : const Color(0xFFE4E7ED)); Widget content; if (iconData != null) { diff --git a/packages/re_editor/CHANGELOG.md b/packages/re_editor/CHANGELOG.md new file mode 100644 index 0000000..7fd9e03 --- /dev/null +++ b/packages/re_editor/CHANGELOG.md @@ -0,0 +1,105 @@ +## 0.10.0 +* Fix a typo, using `leadingDivider` instead of `sperator`. +* Ignore the error when _CodeAutocompleteState is disposed. +* Opt range check code in method `_isWrapedByClosureSymbol`. +* Check whether the viewport is still valid before auto scrolling. +* Fix the keyboard appearance issue. + +## 0.9.0 +* Disable autocorrection and smart text features in code editor. +* Fix replace match will cause selection locating to the first match. +* Pressing the delete key will no longer delete both the left and right closur +e symbols. +* Fix stale CodeEditor findController listener swap. +* Add "Enter (keypad)" key to newLine. +* Fix the compile error in Flutter 3.44.0. + +## 0.8.0 +* Add code syntax highlight plugin support. +* Opt mouse cursor display when using the TextSpan with a custom mouse cursor. +* Fix a bug where the highlight span cache was not clean in force repaint. +* Add the fontFamilyFallback param in CodeEditorStyle. +* API makePositionCenterIfInvisible will consider top and bottom padding. +* Fix IME pastes multiline text issue. +* Fix PlatformException issue on new flutter version. + +## 0.7.0 +* Add callback parameter to CodeLineNumberRenderObject for customizable line number behavior. +* Implement floating cursor feature for iOS. +* Long press will select a word on mobile platform. +* Disable ESC shortcuts when nothing the editor can do. +* Added option for maximum rendering length of single line text. +* Fix makePositionCenterIfInvisible was called infinitely. +* Clamp code line substring. +* Fixed a bug: type 'Null' is not a subtype of type '_CodeFieldRender'. + +## 0.6.0 +* Check tap down pointer whether is in the valid region. +* Break changes: Change autocomplete behavior to replace user input with complete match to support more pattern match method. + +## 0.5.0 +* Fix code lint warnings in the example project. +* Fix double newline issue on iOS. +* Allow the gesture pointer overflow when dragging to select text. +* Give an option to tell editor the size of the custom scrollbar. + +## 0.4.0 +* Feature: add shortcuts for word and line direction deleting. +* Feature: add an option to disable autocomplete closed symbols. +* Feature: add borderRadius and clipBehavior properties to editor settings. +* Feature:allow clearing of CodeLineEditingController's undo and redo stack. +* Opt autocomplete quoted symbol logic. +* Fix `IsolateCallback` might be invoked after the isolate was closed. +* Fix controller delegate memory leak issue. +* Fix issue `xxx is used after being disposed`. +* Fix the bug that the underlying text will be selected when trying to click-drag the scroll bar. + +## 0.3.1 +* Fix space key not works in PageView. +* Notify delegate listeners when controller was changed. +* Remove editable shortcut actions when read only. + +## 0.3.0 +* [IMP] Break changes: remove API `CodeLineEditingController.fromFile`. +* Feature: singleline chunks comment. +* Feature: multiline comment formatter +* Feature: moveCursorToWordBoundary and extendSelectionToWordBoundary(forward and backward). + +## 0.2.0 +* Web support. +* Mobile toolbar widget will be built by user rather than the editor. +* Autocomplete will only update after user input. +* Fix desktop focus issue. + +## 0.1.1 +* Clamp mode selection handle positions for mobile. +* Add an auto scrolling list for autocomplete example. +* Fix mobile selection handle invisible issue. +* Delete shift key selection logic for mobile. +* Fix newline action not works with some android input methods. +* Fix a bug that the mobile input keyboard does not popup when tapping the editor. + +## 0.1.0 +* [IMP] Break changes: refactor code autocomplete API. +* [IMP] Break changes: add more params for `CodeLineSpanBuilder`. +* Make `CodeEditorTapRegion` to public. +* Add `MouseTrackerAnnotationTextSpan` for hovering support. +* Add `CodeLineEditingControllerDelegate` for delegating the controller. +* Add an API for editor force repaint. + +## 0.0.4 + +* Update re-highlight version. +* Fix unmounted issue. + +## 0.0.3 + +* Update publisher + +## 0.0.2 + +* Update pubspec.yaml and README. + +## 0.0.1 + +* First Release Version. \ No newline at end of file diff --git a/packages/re_editor/LICENSE b/packages/re_editor/LICENSE new file mode 100644 index 0000000..279fd45 --- /dev/null +++ b/packages/re_editor/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2024 Reqable + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. \ No newline at end of file diff --git a/packages/re_editor/README.md b/packages/re_editor/README.md new file mode 100644 index 0000000..d2a2bea --- /dev/null +++ b/packages/re_editor/README.md @@ -0,0 +1,202 @@ +# Re-Editor + +[![latest version](https://img.shields.io/pub/v/re_editor.svg?color=blue)](https://pub.dev/packages/re_editor) + +[中文版本](./README_CN.md) + +`Re-Editor` is a powerful lightweight text and code editor widget and a module in the [Reqable](https://reqable.com) project. It can be used as a simple text area or to develop a code editor with complex functions. Unlike Flutter's default `TextField`, `Re-Editor` is specifically tailored for the display and input of multi-line text and offers the following features: + +- Two-way horizontal and vertical scrolling. +- Text syntax highlighting. +- Content collapsing and expanding. +- Input hints and auto-completion. +- Search and replace. +- Custom context menu builder. +- Shortcut keys. +- Large text display and editing. +- Line numbers and focus line builder. +- Smart input. + +`Re-Editor` is not a secondary encapsulation based on `TextField`, but independently implements the layout, drawing, event processing, etc. It is specifically optimized for large texts, providing extremely high performance and fixed some issues of `TextField`. + +`Re-Editor` offers a high degree of freedom. For example, developers can control whether to enable horizontal scrolling (word wrap), enable read-only mode, display line numbers, display content folding, define custom shortcut keys, and specify text syntax highlighting. + +You can run the `example` project to experience it. + +![](arts/art01.gif) + +## Getting Started + +Add the followings in `pubspec.yaml`. + +```yaml +dependencies: + re_editor: ^0.10.0 +``` + +Like `TextField`, `Re-Editor` uses `CodeLineEditingController` as the controller. The following sample code creates the simplest multi-line input area, which is not much different from `TextField`. + +```dart +Widget build(BuildContext context) { + return CodeEditor( + controller: CodeLineEditingController.fromText('Hello Reqable'), + ); +} +``` + +### Text Syntax Highlighting + +The text highlighting of `Re-Editor` is based on [Re-Highlight](https://github.com/reqable/re-highlight) and supports nearly a hundred languages ​​and theme styles. Developers can freely choose and configure the code Highlight. The following code specifies the `JSON` syntax highlighting rules and applies the `Atom One Light` code coloring. + +```dart +CodeEditor( + style: CodeEditorStyle( + codeTheme: CodeHighlightTheme( + languages: { + 'json': CodeHighlightThemeMode( + mode: langJson + ) + }, + theme: atomOneLightTheme + ), + ), +); +``` + +### Line Numbers and Fold/Unfold Markers + +`Re-Editor` supports configuring whether to display code line numbers and code folding marks, and developers can also implement display styles and layouts by themselves. The example code below shows the default style, built with `indicatorBuilder`. + +```dart +CodeEditor( + indicatorBuilder: (context, editingController, chunkController, notifier) { + return Row( + children: [ + DefaultCodeLineNumber( + controller: editingController, + notifier: notifier, + ), + DefaultCodeChunkIndicator( + width: 20, + controller: chunkController, + notifier: notifier + ) + ], + ); + }, +); +``` + +### Code Folding and Unfolding Detection + +By default, `Re-Editor` will automatically detect the folding areas of `{}` and `[]`. Developers can control whether to detect or write their own detection rules. `DefaultCodeChunkAnalyzer` is the default detector. If you wish to disable detection, you can use `NonCodeChunkAnalyzer`. + +```dart +CodeEditor( + chunkAnalyzer: DefaultCodeChunkAnalyzer(), +); +``` + +If you want to customize it, just implement the `CodeChunkAnalyzer` interface. + +```dart +abstract class CodeChunkAnalyzer { + + List run(CodeLines codeLines); + +} +``` + +### Scroll Control + +`Re-Editor` supports two-way scrolling, so two `ScrollController` are used, and developers can use `CodeScrollController` to construct. + +```dart +CodeEditor( + scrollController: CodeScrollController( + verticalScroller: ScrollController(), + horizontalScroller: ScrollController(), + ) +); +``` + +### Find and Replace + +`Re-Editor` implements search and replace control logic, but does not provide a default UI. Developers need to write the UI of the search panel according to the actual situation of their own projects, and use the `findBuilder` attribute to set up their own search and replace UI. + +```dart +CodeEditor( + findBuilder: (context, controller, readOnly) => CodeFindPanelView(controller: controller, readOnly: readOnly), +); +``` + +The `CodeFindPanelView` in the above example is implemented by the developer himself. For the detailed implementation process, please refer to the code in `example`. + +### Context Menu + +`Re-Editor` implements the control logic of the desktop context menu and the mobile long-press selection menu, but does not provide a default UI. Developers need to implement the `SelectionToolbarController` interface and setup it through `toolbarController`. + +```dart +CodeEditor( + toolbarController: _MyToolbarController(), +); +``` + +### Shortcuts + +`Re-Editor` has the built-in default shortcut hotkeys, and developers can also use `shortcutsActivatorsBuilder` to set custom shortcut hotkeys. Of course, the shortcut keys only work on the desktop. + +The shortcut keys supported by `Re-Editor` are as follows: +- Select all (Control/Command + A) +- Cut selected/current line (Control/Command + V) +- Copy selected/current line (Control/Command + C) +- Paste (Control/Command + V) +- Undo (Control/Command + Z) +- Redo (Shift + Control/Command + Z) +- Select the current line (Control/Command + L) +- Delete current line (Control/Command + D) +- Move current line (Alt + ↑/↓) +- Continuous selection (Shift + ↑/↓/←/→) +- Move cursor (↑/↓/←/→) +- Move cursor between word boundaries (Alt + ←/→) +- Move to top/bottom of page (Control/Command + ↑/↓) +- Indent (Tab) +- Unindent (Shift + Tab) +- Comment/uncomment a single line (Control/Command + /) +- Comment/uncomment multiple lines (Shift + Control/Command + /) +- Character transpose (Control/Command + T) +- Search (Control/Command + F) +- Replace (Alt + Control/Command + F) +- Save (Control/Command + S) + +### Code Hints and Auto-Completion + +`Re-Editor` supports using the `CodeAutocomplete` widget to implement code input prompts and automatic completion. `Re-Editor` implements basic control logic, but the code prompt content, auto-completion rules and display UI need to be defined by the developer. + +```dart +CodeAutocomplete( + viewBuilder: (context, notifier, onSelected) { + // build the code prompts view + }, + promptsBuilder: DefaultCodeAutocompletePromptsBuilder( + language: langDart, + ), + child: CodeEditor() +); +``` + +Note that `Re-Editor` is only a lightweight editor and does not have the IDE dynamic syntax analysis, so the code prompts and completion have many limitations. You can refer to the code in `example` to implement a simple code prompt and completion. + +## Used By + +`Re-Editor` has been extensively practiced in the Reqable project. You are welcome to download [Reqable](https://reqable.com/download) to experience it. + +![](arts/art02.png) + +## License + +MIT License + +## Sponsor + +If you would like to sponsor this project, you can support us by purchasing a [Reqable](https://reqable.com/pricing) license. diff --git a/packages/re_editor/README_CN.md b/packages/re_editor/README_CN.md new file mode 100644 index 0000000..1187260 --- /dev/null +++ b/packages/re_editor/README_CN.md @@ -0,0 +1,196 @@ +# Re-Editor + +[![latest version](https://img.shields.io/pub/v/re_editor.svg?color=blue)](https://pub.dev/packages/re_editor) + +`Re-Editor`是一个强大的轻量级文本和代码编辑器组件,是[Reqable](https://reqable.com)项目中的一个模块。`Re-Editor`既可以作为一个简单文本输入组件,也可以用来开发一个功能复杂的代码编辑器。和Flutter官方默认的`TextField`组件不一样的是,`Re-Editor`是专为多行文本的显示和输入量身定制,具备下面这些特性: + +- 横向和纵向双向滚动。 +- 文本语法高亮。 +- 内容折叠和展开。 +- 输入提示和自动补全。 +- 搜索替换功能。 +- 自定义上下文菜单。 +- 快捷键支持。 +- 大文本显示和编辑。 +- 显示行号和焦点行。 +- 智能输入。 + +`Re-Editor`并非基于`TextField`进行二次封装,而是自行实现了各项元素的布局、绘制、事件处理等,针对大文本进行了特定优化,因此具备极高的性能,同时解决了`TextField`的各项痛点。 + +`Re-Editor`提供了非常大的自由度,例如开发者可以控制是否横行滚动(Word Wrap),是否只读,是否显示行号,是否显示分析内容折叠,自定义快捷键,指定文本高亮语法等等。 + +您可以运行`example`项目进行体验各项功能。 + +![](arts/art01.gif) + +## 开始使用 + +添加依赖到 `pubspec.yaml`. + +```yaml +dependencies: + re_editor: ^0.10.0 +``` + +和`TextField`一样,`Re-Editor`使用`CodeLineEditingController`作为控制器,下面的示例代码创建了一个最简单的编辑器组件,在显示样式上和`TextField`并没有什么太大的区别。 +```dart +Widget build(BuildContext context) { + return CodeEditor( + controller: CodeLineEditingController.fromText('Hello Reqable'), + ); +} +``` + +### 文本高亮 + +`Re-Editor`的文本高亮是基于[Re-Highlight](https://github.com/reqable/re-highlight)实现,支持近百种语言和主题样式,开发者可以自由选择并配置代码高亮。下面的代码就指定了`JSON`语法高亮规则以及应用了`Atom One Light`代码配色。 +```dart +CodeEditor( + style: CodeEditorStyle( + codeTheme: CodeHighlightTheme( + languages: { + 'json': CodeHighlightThemeMode( + mode: langJson + ) + }, + theme: atomOneLightTheme + ), + ), +); +``` + +### 行号以及折叠/展开标记 + +`Re-Editor`支持配置是否显示代码行号和代码折叠标记,也可以由开发者自行实现显示样式和排版。下面的示例代码显示了默认的样式,通过`indicatorBuilder`来构建。 +```dart +CodeEditor( + indicatorBuilder: (context, editingController, chunkController, notifier) { + return Row( + children: [ + DefaultCodeLineNumber( + controller: editingController, + notifier: notifier, + ), + DefaultCodeChunkIndicator( + width: 20, + controller: chunkController, + notifier: notifier + ) + ], + ); + }, +); +``` + +### 代码折叠展开检测 + +默认情况下,`Re-Editor`会自动检测`{}`和`[]`的折叠区域,开发者可以控制是否检测,也可以自行编写检测规则。`DefaultCodeChunkAnalyzer`是默认的检测器,如果希望禁用检测,可以使用`NonCodeChunkAnalyzer`。 +```dart +CodeEditor( + chunkAnalyzer: DefaultCodeChunkAnalyzer(), +); + +``` + +如果希望自定义,实现`CodeChunkAnalyzer`接口即可。 + +```dart +abstract class CodeChunkAnalyzer { + + List run(CodeLines codeLines); + +} +``` + +### 滚动控制 + +`Re-Editor`支持双向滚动,因此使用了两个`ScrollController`,开发者可以用`CodeScrollController`进行构造。 +```dart +CodeEditor( + scrollController: CodeScrollController( + verticalScroller: ScrollController(), + horizontalScroller: ScrollController(), + ) +); +``` + +### 搜索和替换 + +`Re-Editor`实现了持搜索和替换逻辑,但是并没有提供默认的样式。开发者需要根据自己项目的实际情况编写搜索面板的UI,使用`findBuilder`属性来设置自己实现的搜索和替换UI。 + +```dart +CodeEditor( + findBuilder: (context, controller, readOnly) => CodeFindPanelView(controller: controller, readOnly: readOnly), +); +``` + +上面示例中的`CodeFindPanelView`由开发者自己实现,详细实现过程可以参考`example`中的代码。 + +### 上下文菜单 + +`Re-Editor`实现了桌面端右键菜单和移动端长按选中菜单的控制逻辑,但是并没有提供默认的样式。开发者需要实现`SelectionToolbarController`接口,并通过`toolbarController`进行配置。 + +```dart +CodeEditor( + toolbarController: _MyToolbarController(), +); +``` + +### 快捷键 + +`Re-Editor`内置了默认的快捷键功能,开发者也可以使用`shortcutsActivatorsBuilder`来设置自定义的快捷热键。当然,快捷键功能仅在桌面端有效。 + +`Re-Editor`支持的快捷键功能如下: +- 全选(Control/Command + A) +- 剪切选中/当前行(Control/Command + V) +- 复制选中/当前行(Control/Command + C) +- 粘贴(Control/Command + V) +- 撤销(Control/Command + Z) +- 重做(Shift + Control/Command + Z) +- 选中当前行(Control/Command + L) +- 删除当前行(Control/Command + D) +- 移动当前行(Alt + ↑/↓) +- 连续选择(Shift + ↑/↓/←/→) +- 移动光标(↑/↓/←/→) +- 移动光标(单词边界) (Alt + ←/→) +- 移动到页首/页尾(Control/Command + ↑/↓) +- 缩进(Tab) +- 取消缩进(Shift + Tab) +- 注释/取消单行注释(Control/Command + /) +- 注释/取消多行注释(Shift + Control/Command + /) +- 字符转换(Control/Command + T) +- 搜索(Control/Command + F) +- 替换(Alt + Control/Command + F) +- 保存(Control/Command + S) + +### 代码提示和补全 + +`Re-Editor`支持使用`CodeAutocomplete`组件来实现代码输入提示和自动补全。`Re-Editor`实现了基本的控制逻辑,但是代码提示内容、自动补全规则和显示样式需要由开发者来自行定义。 + +```dart +CodeAutocomplete( + viewBuilder: (context, notifier, onSelected) { + // 创建代码提示View + }, + promptsBuilder: DefaultCodeAutocompletePromptsBuilder( + language: langDart, + ), + child: CodeEditor() +); +``` + +注意,`Re-Editor`只是一个轻量级的编辑器,不具备IDE动态语法分析功能,因此代码提示和补全功能存在较多的局限性。您可以参考`example`中的代码实现一个简单的代码提示和补全功能。 + +## 实现范例 + +`Re-Editor`在Reqable项目中有着深度实践,欢迎下载 [Reqable](https://reqable.com/download) 进行体验。 + +![](arts/art02.png) + +## 许可证 + +MIT License + +## 赞助 + +如果您希望赞助本项目,可以通过购买[Reqable](https://reqable.com/pricing)的许可证来赞助我们。 \ No newline at end of file diff --git a/packages/re_editor/analysis_options.yaml b/packages/re_editor/analysis_options.yaml new file mode 100644 index 0000000..a5744c1 --- /dev/null +++ b/packages/re_editor/analysis_options.yaml @@ -0,0 +1,4 @@ +include: package:flutter_lints/flutter.yaml + +# Additional information about this file can be found at +# https://dart.dev/guides/language/analysis-options diff --git a/packages/re_editor/arts/art01.gif b/packages/re_editor/arts/art01.gif new file mode 100644 index 0000000000000000000000000000000000000000..84cd9c44d8527342b9eb8e649e6147e13f3e040a GIT binary patch literal 3722598 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%0AmVCi@6i97$yZR?y$kzDR?JE^K( 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�s) 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 KJ7iqPRmUa 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�)wB|?$QMZ&WF(s;|c7RC;G)( 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%0DM(@_Yo*&%j=f6^yu>=@(eQjvV{ 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 z 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

Q+@wlxK!NvL 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⩔YSQ;JR86T#1kr)`V0&2WtLth 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%0DEGZy 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.hn?5oJKqakI=8xcR`%*~ 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%0Ad3SiHP2$PVB-k;;c^M1PVQ130hOE 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%0DX3x>4m9E4|6Q(aeVi5ihM#}LUw#JtarGMMpfowB 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%0DE7I+dpDTxjd^l=-9BiotEl6GXq%Y&1$ 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

1lD8xM87JjXT<>bIl4Hd) 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

#EtTmp%^R>tauRYdmp{LI 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 z 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�F#-b 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

T7cq_O#uIreoRqLE4qrzr)(XmeUh=hts@+R!X^h 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

3g5yuP-WOzk5|E4#4>4>M0$;V9w-k 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%0DWC%a=OBD|Baq!T{aNweKaN!10VYUc4Rkr!zd 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

%874fS0xtGU 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
&NL%*9de7SMtToq&RWcuKH)N7j;ZPvKNgrRl~J* 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

ZSlCeM}Vj4ty~)B*lO#{O|V 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

dQ8fwY+Zz_I$s}+= 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 z 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 z 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

Uc&vqB4aPg( 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 literal 0 HcmV?d00001 diff --git a/packages/re_editor/arts/art02.png b/packages/re_editor/arts/art02.png new file mode 100644 index 0000000000000000000000000000000000000000..7778325d0d744681645bf1a1fdbe8e73756965d5 GIT binary patch literal 351173 zcmeFZbzD^2_b^O|l!Tzx0k7i<1^M!9b_eyC5Mhpq(c1wp=SS7Ty8bQBR8VMJK{*A8~9%9 ztE-1J3IUU37ojvsThCSe24!wi&9*9@gv5({{OKI~Ij)69G2zGO1HYsdKOF^#31cw5 z4fDh0#Rr>dhI4l2KZ9i}u{wO(MnhkPazDDJS?sxdB*pYFZt-2cs8#C^ThSz<#ga_hN8OLs*hb2^ z65?{^vCJKh@64BegR zZgx}@x<}<>=-l?O4lyVMMG$5X2w+5G@M5F~3aZ|bT+Xbzhn}t^s-zq-N^KpWBQ8%m zi+B2dOX=anS9pN%?!A?#j?@pP(5hG^=ZA|2{f4h+?)lb{V~JMLKBSMPLBy5%Q59K% zwm3^3m%^jrvFj-Uy7uD^0|N(dMAb6U2eL)Ij3O#fC;7LD+>iysxlsh%P^{agD~wfy zni?{`X-p{9Ja{AWMoD@<`kjQkhIWrow|2LFH^(8=``TqwkgUQ<@_EPm{#Hj}edke44|Oe0cHGA$zm$MUnOep7HU$TNNaALh<*p+dmM!Os_U; zRSe-oTE}yyUq;~%k;A)lmZbDSF@@?WididJe>Y|wisB+RiWo-d9Y-3>*TGZft*-2M zM_O5*QYZLxR#24Og?)WeLA-s(tJQZ9BkH~CB5U29GJo<#DqZ2ZMYIj{y;k!(FJ55~ zXFu``eP$Fe`A7i+^*{8F7^umzSZhV%~g1`Erj*dYo1#hRlT8=>dO`u9!fK z;49MMh$bnK><7i~t+Im)=>^D4vtDx%MM^MaZ*Hj7;Im03=U5L}x$sW=XNYrT^A0K; zqY3yUzkWFK_4QM)j{%hxuUH?-wRcQXln{Yhiz@|69?q{@YcY(6_;iHv;S{W#IG~}g z9Pp85h7WvAUW6T_zeAl5H)wC%_q`+!kbO!sd0z;_rtO`$fFW6Spwf#;1-_SjsF`_o zZGw+u3ngkEH+(gJ7WPRdO-5IIR;+{}gU$_~nh^aJT^vUVOOz@oOK1*l3(3hH*vU_6i z#64bAm5Wh>h(nfwKAtnPDoI6}U!q>oBe$f)rg*!IqLfuBqo7H{qx{h0C;QK6<`iZK zGizcPGeKe=v!I$n@vO3kM4k#;5p>kVO2m~39PF8L5p(e(F@GzoSL0_ftx|LG zg-T?JS$3CNYKcanMz)*SPL+11z?(Uh^t^uM%v}8ZYqFqwcGM0Gvs^E|6bJSAhhAWrgYN;Wf2V2H^DYm zI?5*SYFa-I1P=mR<8*C@bn+3?DN`z?-id(tMh9a$?$@e}gZOpNOAJpozj(M8M-X zd}v+D&)LQCyW8yAJNu7opJJX#8mDwOxmCF?3#bd|QOi-1^SSL#=2w=d?WCRelc(D^ z4(hh)ku=oQdAqtg6E}|6pEP`K%&SwcpEI&}mh(XF!TKELuJ5k%Ty%rqu><_u>Ezx) zazV3s(mMM;Y*YSJ;b4AyZqsisLX z)!uLD${Nb5xlu0(b8~Z8ax=R=hJ7Y>W=|p!q<7QYZscpJGj%*&E?uENV8gV+BqX#V zm}j_PNMdk{q89c&Ig^vQka_H!j zC#%M)qxlZ`6t5nAq08TvJ#PzJRdc?pGF7Brbfrt;j&q7OkX#!+(RaF>e3Y5zk(XEi z|KgQb{(A4neox`I4Z?~$Ftl>c56^i`p#$OHr(?N4rGL`P%uR@obJi+k`c42@Bm1c^ zu!BDpCi^m7RXD#aW10h(*nU9b@X1f^pVnWg&w0YYtE4iT0q!qMzlK<1j^MtY_{5$z z&(rSKwft}Z3l-ZhHEdwD-{!L^r}cG7+0^$boi!R~mGzqM+^IT3wO;yzP3cEWN7ZXL z`m0)M`p0fBmfx=#wJ&>gM*Cr2gC#y|K(YxE2 zG?oL7o1UK|bT^nWBStvSI zjn>JpnH3biK8BBPjGsKuHt)~G5%RjAIGPPR(qE6(->-8xd%R+_LO&sgW6N$E;_H5X zrPOHc)oxnbC$BkM&gK3Q#^*b>zExy>J<+dkZqVXFyDZiH<1Dq-UcPC}Bh|feUEw5M z(;a))7s|UQvgEso3P&f#!=ci+F+7s?DX?CzWWOncNLNPh3a^Ry9?=7Ur0;A}S^dbb_zlIDe&#Jfb;C&zb&acPDMWHQ-#IvzQ7`^@R{PsK8 zCB&4*YH_JC%{_A=*>@08aYVbaQm+`6nc zyW}ZJcUxhUNJ{ZYSzoUnn!fkGVR-%$YM%ILKeNI+n(?_N($?aQmkae}V?A2yysZNQ z4LQubxKM+)^%jhX`1Nj)zQOO>gitx*8Pw} zHoUn@*rexyh$7rnOU6uI9*G$^$3VJ+OooI8oFM}r5oGfJK9@pfL_+=JItmg}h$YgU zzn)P5j<G0}}GZGRB{p|-?Mul!47=O}IP0K|~{x1+fo*U-q`)kXO6<6A)g{r4xHrtd8O z2a=uhU(*66$Z>mz;~D!?j{hDTcva~3s(_N^J5!rCFD-2WngK9Go^f$K75d|a-){X6 z$p7`K*8jZ9`Hbgpul}!FzrL#OZ0aOoZwml*5&0j6{RQ`b-~8)EA&%R*|1VnnN$5YW z0+bfP65{x8u8CkFb)?=36NTkVMK$0Eh}rEQ${_H?_~#KgN3qV588?(eLJ~ugdHF)^ z9rE@Zx_`o0^Xb72i6?q2JB=i3Xdz>$k;L{hGUL}DD~$-`dgXVyds0`|xWo2-$WJ_I ztdz>-)ud$(Cnlfle6Lj~yGIFuuDhEJoPFQ^zT4lw%~_2QZV-H~D178$mZ_I<`}DdDR9sIIPl-u?RIYt;{qEMv(R{~3)*SCq1q zK)qV$lUW*M%G~8;qY+~nnXvkbV6f##*EHDLd}pS%7J#DD9YxtUd%Ql!d0IDdn(4V! zG(%S7SgZ6w1i7p>5|{ncL334A)t>Eao#W{kNHZ0h#9?3u8!xrqfNJ6XXKLJHY7vVf z>~&J(dv)<5&xjY2L#!mev^ zwD#jj*mktmaE;a<2?c}ZKYo=eiwQe_B;)Q4#-%KN+WnYx^^<2m|GJQRvg9;UH;3;* z#Io?|>`^feInU*4JDw;xLH<35x<{(hc5@AI`%K@9%?Y!C4BJ#5TUjvs$iEUBfKXfaH>Sa$NNUmfySNnZ z?AQC#2izr!6X?rTSX#3)c<s4@}@d2d7b;;qD_0}$?H#VX{Do@%r}Sg z7GCX!x|EGwo>c8zxV2VJ;A>-P5kIg=rUD}OGF`?`HLy^kw^1#4;x`yf0 z%QWI&$kQK>I0lsIHBN^yWSp(Al+`V_a1EjJ?E=%peQw^b%W2-9Hn%Kyc<0|Kf>>71 zovx1$tJl8KM$fL4RQFHsqEfV+|FG`|BxQO>9wN>2@m~^6Np5jeRZ;k+m!-U^9i5N8 z`FQx@Uei&(BRI(j<=-+g9`hrWuxA&1!obga$lebzqYy28GC6&Cc<3e%;r+kBB}+b) zM{q#s==)r_@5M+a)zPf;fUur5=9B-dw14t}tG-oPn$p!~h(1~O@I$@x`gIx82~SOj zO(23ySJ&2OPBYqQC-2+1=I7Ev9v!teCYfp}Y%T_kIrnCor=?Cxs~$CjN)2kQU}Hto zx?r2Rq{lkY%5Nm4Ops^|qNz)D-!Grd%8g_)tyn0PEa@9liQPd}Ic3G-V0Bw3_>`Ir zahV-)UwEn0&$1$e>JJqX|Ix|=>Z+a9DuUQPYR?%_5ZvLgo+xW(P2RJw!?yj%QVOZe zGeh+}sW{mY)RIYsnB~!HsHvHZ5ff`DYnTbv?p5T$CZ5})NA`Pe4Z%SQbj3f+ZQgcv9zUe5{vD`dW!j3mr52A z^sj_Wo^=qUSq=-w6}{Y-p7mAeAA>#tKNGByPu!WPjRwPJ$HK#nn zUoh@N8_BY6931K8TzvL-ixL=HJ`xWDQ#QxA-(XNHGICT0MUYM%r%Up*qw%NYq;ci< zD$KVG2S-oNjg`}Bh^iOL283$a>J`&LtWUM!hfKI=^t$DwnchvkRG(F?M%KCHLv!a| zB#!U4%EE-b{lS*&G!e2M9gc^jXAZhE@eNjYY8N1g-A3N)hHS;_BT+v?N&%Npj%$#?)iA_nioov&;qTI% zMHNs>y!dI4WV$*74VErkBo9s>Dw__z=a@RI#H5|u>%&yDbj{-QC{XJxYpoIHBjN1r z*mw3t+%%C*i)(?3l?AfiXH@M3*Auo+<1cHI+8*o1OH?Txlv4k34JHhtQ;UAbrfzAXM~;yG{OrAHzmLYlQkn%%vwwU78Xj*VY`!-5Gy zGC}%+nwiWXx4pSNgMoClSTC1XyY(y=8U!d$DksPyyIeaB6NybBm!+l+X12>dZ$Ne;ZzM&f7mkY7~XYlFIvs<_A$!y@lYYPUMP(xR&PkJrz|F8hDJdZDy=%JC@NcDf;}-0 zh~2O+it9G%B_Td5W?qZurEaHk^$&|*E=A5uyVv&jmk-0mmm9}oa;rnt2Pe4H#K9*6 zK6n&mSe3=~4fRExWxlDrHW2VYY3jz(hpLT#)0Q5PQP8&zUR+5sx@SpK zPlYzSja(j|8E>nzx-Ft$?wW#OhT_qZ>>c|{ZHn6$JDrfHeK2valQPJj0#mIr;>6X< z?GeF_>^b@=afBmd$^Fy^ph_LtBX6IYV5`FOl(h^N3l()s=k>B0>r7VgIcOHfDhn)T zFc;Z+_>5P~Fsa>${#Q8KGRwwRKBe@@UIxOGMK{Ns4694MPOJGtou>sOF?_M|@&i3& zCsqZdE5kwYhJs2%@^5j3_7^cHe~Fu5gGRSfzjAtd`tfEj_XQS{!_>@YE0~S2vc@hRs4Z~a1*gu0&Zw!|I5(WFl$~_6;Y~Na z#~@Rbl)<2Wq4e}?v(x$er-5N4M-TC9zpsIdfM=Y`ff2ucN$TB`w|G=E3>0 zt6lfzMv7Ui+8)}qR9@7-3Y*C;CgbqDUuyj0-q=EjoUTA#;g?CCGHq*E#-x?t!uK-Y zgR5WtxU5bLI&{AAas&H?^M2xk(}^w|QO{XN)$Q%-fs-3{oaaewI%b;s=hRE4ZN|}5 z!rOs_3N_bP2pzz6w*evn9=~gE)s5UX9BFNXhdef)U*7)bgb3GSG52doU6# zNijMSI|?3sB{LJ@BAjRE4PuK3*N%IZ!#LCR0*EM>{Lo6dg6kRzR|L$VoxbVD@? zJhZ=CDw@Yi2L80Ho?p>Op9C^+dG`Wg1*us#bqiu{Z|W;LHH9CgkIK($WZxOv+Uf6~ zpXbICX54IPwp4xn5JLBQB;sdZ^2|={%@5zpmCTNHORx3x)5tSx;h~m^0nr;2!HbRD ztE0fr+#DJuT1z4RQ&2t1SYLe=G(LT=9d*H@?;I1;N%J?E*T>S-?C0LtmF74&4kp%# zO$PeE1+rp&_rD3W9#kugxmB=N)!42`;2z+IeANBaicWnzo0xJ>+=f5-C8N_4PV?aL zSyd%FUr9sN_j#>~N#A;Ta!c>}tz##_6NByR2sqL5lZnwW zQDyDN8sN#OIXUX(eRao5%;c~__VOCdd0k6UzY5zGmi6)N%S29?^CA+9t1r~o&R}ed zpkuEkUxgc?IZhXxr?(a4MO$X%`-%96!vOfTOc-`+Lh@92ZPL^@q6(CG^75BtgvA>a zV7e5J9dwPWadHInm-NZ6!4??eM_^q&$(s}CT8i~H5O9FNT6zI@*-G@e8eBFB3^>&N zS0-AZ(rG8HS#xoGx@u4}B*fPeB1N)m3pNaNw4S|wm1dHFs znGHjle#^-OkTAr!`mf-ngLK_y@)kaM|-kMI^z!tDK=8KLzIa?J-Nd$f@Hi0 zNK@3S8y~anq0-yQG^71c(j>iDD7_h){pohDH-$#mpxZQZu_rufTQynCtX?n)RST-P z86*rTPuj|A*a#wlD~e=lm0UC^yg1g^@UEETnTylAx)eDN{<{Y;jn{+m)`!agZj5d%T3vz-J&{Zxp^dRz3I`k4kay&{b%v&hdku z@A*$mxlz(TNNfI2q-DA#?J0ZfGw(?Zda?wvP@gfSqUcC`k$rwtYC(*zn6*k6G>kz? zC8StSHtKcyY~_%ns7=Th&!kvev-O#0F*wT9&aH|?itS2dcM}y;EqqG?-&`lI)x&-K zbMt+*uXF4Bw!>`ztJGI=qc3rZC?Ch?m>)bXT>_EJwPa?UX7wU?7uUO5&M)fiI}e?2 z*qo80e%#?(77_YI5JNHP(4Pagd(SH$Lqyo~xI$I&>b-o1(A1TV)(ui*;)YWSkiu|3 zGZbpS1c))?dxKawPfh{8Z@zk-?oyh~T%I58khYu+oWT~ZPuxW|?q@D$2%WFSpDcdB z)1D~P+it_=sEVbXlc$Z1qgWh#%0VVTpWtyMQUNN53N+OKu4Oc)>)GOmddwqLG``Wk zuF~3ht7@}m8^lg+rVmVK0iuvD&{>(T=IP+jQRU&sP$i~;epq2tqQM*jZlp8NJJoe&DpWk5BKK7P0SlQ&Vqb*Y-)LjN0>j@ z7aGRQyc@pTO)FPdjN86EKdB^kI}F?%&sRlgy=#ZR&9-8qyKh8JHZD1J&%kzPVIbm% z`mn@7s1Yw`n1KXK$inI}ghvwZj<&c3QCtSaShzSEp zY^Sr3#~ugYc7uq zM8TaAq>>D84hLynf#4XA+K}+c$667e3vFrl^c;y0-28pX?TeQ-)o?UEB9r>Foto;1D%|7~c&#Tp(g9hSsWb{0kH^zG4*436h@ zF14PeTrxX&C|7#M@3K4bz;zV+8!yz+?$Y<$64wQg=rfq27j3abnWAAEAT~auhL( z#$?M40S<|8DaybkOa4v`!Fcp7GGiOO+n@}!3*g8aB zaB6n=NCqwVprX|pgm3g2)zx_k^YlI!k~ zW3w28xK0oi^J8wE30N~;3sCNv@m-@w7?CG&x<+7!X1hAxCD3Y;ayLn@i(36+u%A8< zqAVDgP6)j*!q%7=74(q6@zxtIm=?%TvAa5%Z{Hc%dG)S8U)FVWBxUDpo!gS|M%R$A z#kw|7oV?SC<0KlZpyX3+2SjAJi&@i5v*j)nheYDPDw;-0+8D;@2ndp<>%-F}yifIB=Kj6-hL za@KhxuXXtzyPp@QlYlLR!l_Wtv6J{frUyA{L;;Zl%Uk(=c6pHjEQDGxJI3?*Q>c#h z^II!zv)6nYrf9Gl>~r-;DnU=vpH>HSrtt3f^Z}bT4Gby7rQc4|wg7L#ct@|ca5wHX zYu(Z?+LmVfDan0|xe}`&{L80L8XR&tPNx+oRBLMx)0K|7!gVf*bG6TTmp+s$meg=4 zZrM;axH*x2tnnl5-}frVOtrXSC%#_}GP^LHjmJ-MfFFWgA4co|nK0A=`^rXxUim!| z%BYeGeQDR~emk2*EBDGib3R>ribtb45xSKZ4W45}{G^QnJ&FUw*Nnqn4($atQx!ww zBDG&310^^8xfQ}x_y6uzX-5OGAuXAe(&BQGjvW}tR(HJMS`7;(4!g_MF92f|gpYD` zB+HO`hjPRmzr0y%UWpQ1xj7lz2674ulZ|`O)QVM)^>q7q2E{1AusZCv$|(84^ZNZ#2rXLX-)G z2E|jdpT2)j^wad@BBxWN=|Co_+5RlO-k$bCW2T;vd3zAmOD7hTSss6q_cm~^N1Q{~ zCn3$jRr6bJ-IKa(87$elel~AP5KHe4m{)Tqog;a=n}2IAr^Wyb&Qvq>!P~aa+eP`@ zV%W1YG0}<6FBDmxn-SKhIfKqOi%ra{Oghz@z5qDY)BT@qON{E1zWkavk6~2O^p}v! z@K{UUsTom_)7k_|5)}YpSww7sf>ad{ZI~ZST=2q)HFfRC=j0y_aoWxD!6qwnQ`JlW z4;nn7@5Ls9=pwf-{!E(sWxw;Z<)-=U5~x>A0k5tHW-I3)=tv2(}_DAqNN~_)8@YEcKm#p`esvpXV*F|uPK(f;Uv0ruM zGk(N}A#$eYepXp5p&%BjjJ%+_IzROIJ@=Rek7Ag~pBcG>+?v(u(t@$A>O2dh$}}o- z!nnbsD9pu8*X{;el*ZQ~EIR=cvfER52^-(^EE^5-z=Gd{_@uTC>FM(hGWd)H-Ce_? zPjecI;H$HRTwF%r08 z0}~CTdM<{Sa1Ot77IIFLSC`-ni+71r)#f@OxH~)h?a{9=-dXr^wZ;~cMknig4vk%r zw4?=Vgq;xNz{v>~2b}=>lhJ&0jo@+FP*TN^M1&{FaWs#@_bZu1ipr2eNP5Trj~sa8 zFCnfvtuZ6BJKaC{^}~_juoqj4-}iKh#Wldo+};;-adk+9b2GWQa)4?S*UD?8 z=h?xV&Q9d>7<=V&0qh-)4nc4#k=6sSYrwr)cTHZLy&QI4x+=RsC*+Q`2qNdGMXgcF9{3WXWP8%0=GDUm{l8%LK z8kmY8GlNLdZFl4KoBqqaG_(SiT$@q?w=V3zWAJAkn;*yF)hl5~icKlysqz6J_i0V) zUP(vdw*Lr+SCr(%AmPMbP#gw(Rz-WH3}U{Rn5P=kb6zPu=O-hO(S4T7YZadSRnwn3StNKQdI@Zo=4pzDm89XXM^vl@w4AkCFC(57~TN`vYmq1zyjLlw` zHGcfm@L;(!KTDbsSRF4;T3lfou+bt_t>$?uK8glQLc0vw5Nw-Qjdk>^cLW48NlYtA;~vLi}Fl?BUpu)O>~9J z=~YQ!M)f+exC`5D&qC)!bZY14i=TQm=X?_>vY}eN?*rNyTvF$;bI60kW~Kz(EUayH zufkp2W8PB`Cu%^dXWh0LtMmG5r^zE^ZBBr4*?}xI%;Hcs>Dc*ERP3(xyFAz3k+Esl zjkok=-7#@IxMO-^ASbsi$6Ol(?o5?YuKIWPuaVKRB~BhkqvbuwlgNJ$7sTSRUZ;D8 z$)|8JL8Djonc6-A#n>@mC1hF3^Gg%|VQy4-ONOW)^y+HQueOh)W!Cc;h*rxO zB1k!^fY`Mb0u<~4_^}j=XSIF^DAT<--72u`JXQHG%RIhV)=vyB8GqXSd#)a#_sdYD zzS574PY9nl2um@xR?g#~SGB?2DhruOrnM$te~nZs-{-SAwIbhaBamEt1d?>Isj56|p```B+uVr# zrlfK}1o53CXP(y=4l?K_Roo4r6=@f?T!1!5K6us!SmNb2k_ewkS^?3K^{sjdM7dLQ z2)lO8;M_(f?TGvrJrNyH4Y}Ffzq1*@gs4O;{w^PuMo{?g$vb@v6Ceu}fu)N1o2?Mb zibc7@M~2yL^-IwT=yx~pPZNZM97V+VTKw<+@NHgz zNz6Z2l1gKq=vUm?B(i{D`ecRrhVI%7VmD`{sR#F4Dfjr@SH-9yLPnur`}yinw&Rza(c7I>yw^-V8~U_=!1|ibSRo$3${50cyv#XUJ;4@3pfRm_%j&R+|Ai?n za3dMzqA|)@PoIj6`JWmqV(7&DX))v{a4=@S9=T9d6ZY8WR@fQmv-k0Fjk8InL7Ft z+P5O4^@cR3s%LYcce(Z#V*``}{E9ObVCi#?Bq?CZb%O?fGGB}bfLt|X ztak^Wkq8*$FG=}r>AuwqQB;5&cT8OG9I62_^%t~NH9)Wx_@^GA+~T(0ASC=$4f`L~ zsjMVm2yMF0@&HRelgiNoQ`X(!_>=iG7UGxi3A|q z9BYyOVJ4jQ{-2rnPiCS9=oRrtMlG>lfNCf!8&dmSRswBFr9IIOKsgBL12xubbOVzb zcn=kWK+ip?B_$=@I_^tPc14og_NVbbEbVKg4nSPo)fGi)-5!inJv=f4D~)&Kr2%V!kLy5y97~s7I2_+1rnO9D0uGxPINsApEY+zsyWDHM z+bl!!Pm7PmeH1kE#X-sK+sr$FqkT5=^Yc)lYhXW~CwyzQhu!DnDZ=mjCb_vWMvX&&o=>)DF9`cOS1Pi~=VYqeZNcX> zVZDiW!F%L%l29*ty$B7cX5%52Nn19|Mc|{VA|0`wJ;$ofm669f=C~+77zW7(T(Pcq z>(?`=&NFW=&6_8;mTWK24t(p^GyR}FH;~twkFIb(33*gyHk^+xJ$O!c@u$NSKS4b;dmREk;E7D$T!EHuhzMlVfz|_y zZ*DcVC=^A3pU30S+~D<5K!|Ydaxnj!Nk$5o#afm0mv|KF;O>Dq*@1b7Y$=PoV{h3V z#nMVozd)y4Z6`}93qBtt57A$6U+{6YV zH=S&8j?`=bD*7~lkwpVYPIAtM`rTr{b$!0y#b&{^hcUFMQeuyLDL_ zswV=rfjdV*%|K^vFV)rVJ<@wcuj(lX$)8lPuph%N3+@W|z_+KKXXgmI?;fvV<7P4THq!b@sS7er^nf)&i^%l`?|Tkue%I$f7Dba<=o)5l zlX8ff)#AvYkhT$`^qJdQdOG=-6RRh?l^R!QrRL?}4cSfJD zE$CVeQD&Xe#qGBgM7pI-$8a>N6Ttp4IA7Y|1BD99GqB2TPC%#9D9G{w zTB5_f<4b_Q6%3i)DvHh;4aa*n@qQi&3-jAB{o0@QWrg4!;iv~2ZRF^qDO68Nbn3pE zU0-xge~o@zty;!EKkZ^;oY~y)UBB_*M+FwpoMBOheRXj@3rLrbBKgqU*y0lB02FJi zM|oS3>uJvY2RI(iYu^uqySSEZA-(EO_o3f9d9>+8>>H9={T;7t1_J}eowe|+C+bTR zZP}{9nI*OK)ydPG?(Ftk!+;G7A_Mfn9Pr>I612=TF*X*ww;m}qFIZaeU6qzmk-$$q zi(4F>^t#ssCh|bM$Wbnwucd$YiSb{NOy(iua%%@uJkrd)?U`flSdCz`q`RX40 zWvnjO%V4tUG3OvMaf$PZmTOZiS1#8cQ~#A=IS%*>5}b(rvz2H>v0@5W4=x|g_^0y9 zxLm`)4X^ltVo7A43L{y=g zhDJ(ogABWX2#{#kKU_^~p#rk>-i%>|28U7N?ZNph8#x)+IrR6ka|Y7iGxQwg_VKKp zSGEWZH=OJl&G2qlbo=3BN4~5baek>Ncqkpx$xxcsIIZ#hjb*y0d(BceE_ZV8!O>{N zY1a??&SY%GUy*@9)cl9~KI!Nk)_ zt&DnM!AZM7F-9O+zBV%WwPrbu!0DEEgJFAc0%$`wi%O!VBx$H#Fn%~&0=)(5**C3L0p-RwxDqwkTFz zd6j0*V1CsNx&v70p@w2Jz~_j_G;q0=g&(Ecp?cns%`5ojO8cEiM^o7X8=qdZ`1-Zn$eB9G|BcH3Pfi7CHuPYNu|&J0G{=Z z?_qg#6}yihVv}0orep1Tpy`a0(tXcDwM=As!hn#v<NAUqQLD!Zwy+e7daF+N$6TQQEts2069?ODQ3 zmx$(Hdq6D~HZHOBJUv=9an<&Fx*+eE(eMjnjXKR)GMZA~2 zvY7a_eba%IOD*QWSVb{a#VCvN17B9wtcBdI&#$73WRI(J<|`BgHov^fQtX5IFuf|0 zst5M=jqFLcv`Y+`uXd6eyne9E{N0)@I^Ng&6PzrAPfexx6l(X?)9ZRG8Fr5-PrE#O z1dvPi383z2%-ew`Lp)q}&_%v;Jfc_&^+7zj)ZH|2y~>bfhOMH z?vwHzTFpr2oQmQZj6n+N=Md293ZlU ziW2I9*bNOz1zpf+(d)Vw(k~-}Zk?4D&@&G-TNvOu7rO=sdDQDR_pAF$JOTJqRz42Y zB7TxLA3wf>OXab8U#H@2K&IdL8}svE#jDeWy#i3|c7m$H0jUU3OV$=;n{&JR z&e~#1xEPa4#!JMgZ0uMZ*Fy;pq4s^(#7l}J8ecr5fxyTB$_pov5k)66F_stG!GhyJ zPh6^--;iyjh?fDmZyHRpJ+T|;BoPGqD~E<%W3b;{J|@{OoP1*#t$PrtuKDET<#Wi&f z9<0xK%vf_wStN7PF8th=EKPtua3zo=4PA58Eux5uzLxV{5Y~1}yxUBYSd zK;FTX*en=A(BveQQq^DxotgXqAw*%0#ZHV-V;e3l_+ zd%dqSF0kj#PwxPmWUVd)^RrE-s!V++yMx&?dz|V;CQPgB+2s6bRi7pO!y2t!-pY>Y zU{M%tk()`@GK_;0w>wyv>ILVEoppc%9_OcBS(~yr5R$YDMncQwPYx);YmU(ro0Yjr1a`617~zIvpWxza9OI z&$G(qr=ZjHvJK%rWyEVu7tQV4z{4C=`63dR8BgRa%jXZL_bh)vr&v%HF5==n+M2;G z@y-`}c5BTv0GTd72{qr=v=wY*yQvXSBz=*_o8wQdWXi+sb>7hZgP^p-|j5 zS}a6EK<8v-GKLkmzCR##q@oCCo z-}I5%Gr$|vZXwN$1ZhiOPY3(fZdFsaNs%4?j1t@}QtPr;uQ!xmu)w*p_k(1e1|EuqhF$*G{{p!1dL;_l0!y^t z+w{(U8yJ2K2|ejm1G=vOsh-gz9$48|{3H=-w-wO+U1w`p?<_P~k z_TDaA@Xm6Q+=0Z~#!K)O4nyF*$;y1PpWK>-EnTy%q^G=hpqcS%VtSTrnp!8h05 z&wk$TyxaYJXN+^k8Rw7pA9bLv-}=pY&wJi+UDpjC5jsE9Q*-bQ65`)Dk*>YH_}aEM zef=DfH-EQlcO<;6M$a^$PNU0vya8d91>2l8J@7}R=y}*8`@1leVQ344sW`e@qJofQbR7g+>7}lOo-(ySC>4F?>VLe5XjS zl5W%Dk+DW@Fxjnfj<^cx2rH~`16|R^M_vRK+eJ$I?lQY_U6?G!O+04r>y2k;dV=0! zNa^+)o3kSVJv;qd1r}Qn4$!=(xohSNK_i}yGx~P-Rj|6sijrb%lEh5xQXF43PjiZk zcdD75Uf%J$i1D&z?Fv1|Nc|<*9ymZEGCG(KJP^;9uYi1hhis3;WN0vYCm5e@CQarZ z8Dpa#qRQT!y6a3925TvUaB3!4FQ<#a&IRAx%~+SRR>bq$Bw;WZ%O(mR(p=8-rHqq# z+!GxEjC(UdTKod%p7piaV@3z5XoxSnEzgMm+&&fS@LpI!p>HKwiIS*HvGkx;;LD4< zbFxR56l)RTWUZCgpkz`^qB)kaZ9Apov-PoiD_%_uyOa;gnXXq?<$JA8nIn^x0b;vZ zHAOK@p_|MSxp5UJe7+T090#D{a@ZT;G&~r!W|N}s&NjJc02x+YN=-5i6zn^WB{lJe zP%Fxd;ZVrN26et<-IKX?L2L~9IJMA|r;pJEUP|}+YCqt(^rMUSDyUMccv(D*;QQLh)`U3EjA+NL zHFB-AgqQdF|E{DyK?e*pCSFyDG0>`(EaB=T=(<7Um#vZTR#n%X2_4$3Z=_BGz)44t zHSx4WM3FU(E#~K73h;iB@r!(I(t#`p{K88zlgF6bFaCy>01{Dwojfz096X%B5SBIz zvPG=s5tqq~sZDx)x}O;f$-;?0`7@txHvOVjs9wTG`@#Uh9m3sVUx3O)Fm>p&HQ2}w3pyGem=-LGk~Yu(|kKG zi^8%s9DdXdg}kATuE^Z;?>xc(*p_RKcX911m8abZ(Y&Mhewx%N22Z1QX*BwHi`_&% zx&KW#HqR;ufUin#h7Ku(h^d{6ln|OO-Q>*-nx4W>OC#g{n`N)l~eu`6&nP(hsVKX1>ex|8$Ixob(X6AwE8x>(NoH}`INnhYhj#xJ{UXEB%7lp~^g5|S6g zXG-D41KXQ2(#Df|Iyzqmy=F{~L<+<8csuAx1FmWb5HWAAuCRM$#F@>$S8%Asl2I`n z)#lxZe#tYO^FT|$YQb~XVc*T!Jtgtnf2F6(VS#&ufc5=OK;gyQd&jeIRVUzHp@NSm zLA1G~M)?M4GkhmdA;FuLjn$BPNjltq9T%aFJ!=a}SN32x0FGqpIjFNSzyt*D*;@fB8mxA2*eG+M zcWXHc&8X*mTpH)~cE3ES(&Y0RqYgY>@>~qLd9JeIczt^jYZgBirw8hmyTnXc)dtW;JeN%zpAV_c!srQ(tG^g`alys<86~758oH5?llX=bVDdedr0F zS!d{JqjHuZZ=lSZPReuTh{MzYK{8nd7|cqcD}1FSRQAl>>vaSobe`x)=;#LVT39z4 zC|b;Sg%0%MsD#}a@bGo&F)OT6J`zd#DRD0mJC;mS*6X~)FOWA6YWM3)q{}2np7v8Q zvbG}F&-@b(n~_KDso`>(&zL_z`Eu5c`eTphAs#%pR7!H@KWOJbnzeiB)JAtT12DC7 z+S%ihlum?%{1uySL{H$+yww&(9Xrv-rpeWY+0LH-w0lfKf(OY7|23g$pcO3D%|kut zG2E`?O1UUcYKtpQbWZ-O306@GcX5*6d+2LoUvfk4=rSibIsBQT4zca{E^SzM4hcs7x7dPL-IChtfF@zF z1-=<^d6K_efEGBxpJP_O&FqP}qv*8)y`f}chpo8_rCj?lg)T%(Vc>DPgUMakewSL& znddpH<0s4${rPI!Qqi+ztK6D9nY)5MucOa40|RGZ4XqAYZAbdx_APQsPB38RfFw$Q z&+o*CyZM3}>ziLK)@YZx>nV-@T^Npds0Vkzt>}YdUn8v9kuzjRL``5f+-HM|mssf@ zlM*aqK0If=R2#;Wm;LRFI{>0`Kq@ZdrPzCBOPD+Mf4yO!NposTX^9G=q#YmI!k1-9o6v?kl04w1% z1L4T&sscT2r3UBqx@^{R{78X zCYJ1HZ>YxYR3A5DIk$jj*KsFq7J(cwp2nkyCdqqh7X%(S9+6_Ur#CR*FWgV&yyUFL z&-{n7pLl{q=)&Si*y(s{+Jh}iB>sk6wftcl+qU}iLL)y(S(?Y=d&9c}Rn@E(f|d4m zB9k&`6drI%qN-f8S1VNYwaQZ_N?6X)gATq<8w2}7L1BlppfEsvP0mfWsIG1(TA9zZ z86wwy2zK_5BYe&u7wCE9Cmx@(U6rK;v6h`q-T;D)3}-5;s3_ zxGME`%2^>3$m1RJ(Y)K>lXrf&60a|BE%aAbxXSPzBcupLi}Va11T3d>FeKu+7*gJ- z2uz`*=B*??pCDEMak&hGryNca{ z-0{VTa?GU}l!|@g0e^T$bdc_(gHZGY>gdT^Wc&ENwE)YEpES65!|@>p(A?M=KrdW& zVxRe*La}&{^SN|O17q0c2p;6l!qafI94QKau%k$(p=E8D^=W>^HyDuAnFP4bC32g1 z@i*`QU1&(|j#Tx6-tk95t>ZF3$oHRWnMTic=lS`$=)BYnmm7CJEyo-}^cd-{FAL)E zJ`46M@w)3M0jD5Qn&p)64ILvlD5ykF1Yw+60!}?sLL$FP$k-LaJgA0mWsb3|&3UOa zoF#RiOU0wY&RV7oUhZ^uyDf3D{S~s~6khSe^><#oTp4-a13i*TO7O2TpL(qno0URj zNM}8|eIIZBy58@mK4Bj>Mj)eLHxD-eW#5hXntI6z%5XZT$Yz9SRFRoxw4LqB+eGUw z%X^Y^LZ;Dv3zuvBh>T}|sa6MM!We{vtp;az z7qReCJm!qaH`6!wvx{#|Q7zv**B@oeawM5$wqw1EXL$)TjMdli(J8m!S%PL!o6X(y zD&>Z{oF)*JoqRWGdvXC0>U_ZH)gjG}G=Xuqm%g_&z0CosKhP9N!icNczSVoxDCWe} zgZBn>e-FeNiaRL-!&utKCm&PuQIpLd9Xii>OrDuYb+&|yguA^=R3UxvI{X2k;+fsM zU!L`oJG`LS`m~6n78w2o`}K!RN@EvKf9g3~HpUnH?;Cc{_jmT5jhPKtwn z-rHQ#Tjo#)@bGqmoHkY0pd8E^?f1DYr$Eo{IkR+|Tu^KtnPy?zAP!0lmSt+;pJmT0 zpU1rY&+GqH_SB+Uc89&-Y6T6?95a31yJ~5CtgQMjE+31Rbi|36im!HX)@z%tWU*Rv zRxfTd`Np1;YqrP74YsE0nQE~6;G7i~MWA48X(l-1kBay%%F~Ux7DQ8t3N1OEy6-Bt za&LNB^1MxPoc^ZlRN`hV1(OWUg=n%w{05PLyxBc2Dk>6m##rs8c148NlFctaEd|P) zsF0pgfgsL1cZsnu{TI0??=`>y)FI<`mYJ1U6~e{W`1v`G@X2z+q&=}sT<4;sxXK^| z>}zCY~X^?bP>p!lcwQhm?ca$9>m3;VJZm~j7kU4ORexn23V zTsqg!W8r`gSz?FnCiNcF3{)poos5%IP7Xr#A1TQJL6ACc=j+;(Y2&=exyQ#J2a0~D zhIj;uVF7#AS3CB+_UqL&Pw+wtGdxqBhH#dmfx_K%idCkKnmD4C`k}({(qTb%_)9cj zZEUNTdaJ4FBXdI4u26xGtiUC%Dru* z?2+UTTISn8F{s3pud$FgY-zx&%cB_D3W_BM9N0Ky8(#HM$JapA>ui0=Fd&NrmEs8# z!rZ1?Qy7}_apF4o>8^5dqS4g=lizY;gC>4+g6-KiWxFWZet+@F4W}583Oy35eHG5= zjet+u?QaA?Ys#`1NWx-yS>#=NWP)jrj`AH~R$RUVw=UjXA(GfACf;pZ`vK7nuS?7E zns>hUq7wI-Wk)UhQ!S7MYWI3^r+{rc(?d}OhlRGeN&cn|izMT_)T)v}l`slY*7JrA z;8v)!q=RWyhaYA^7ZlF}?rzI)o<&!fw$C3msGRyS_yn?<@Pmvx-j{IkyYw52zvnI? z6Rdv(pk&3vjKs!cbDvzyz4c)lcuxUE&Hu8q@vi#bGAOu5#YUG^WO}$5_m&hfpDB}1 zBBG)%Cy0SNlZp15YxZgYG}_4${Ug-C65%IxFUgL_p!!Kp<#<*CG-ORhrB51Z@W_XS zJGFQVN^CvmG#18C@Qsgja+{*axW=yH^14r9(j;v=R|OrxU%5SLCS z^>x(a_*O^LL0-aJ%@L>lj!#>LGg~*qR*a`Qu+i*)el75Wv>(W_;}W-`=tDE2CzEn4#nw+Ux@z$- z>}v6N*}@l?dqg4DXP}ln>=rI*BV<(s(H3RexGcM^^eNZWs|c1($Vx`G1@6Ys2!W%#FoJ=lT zXdMP&Zx{dwl{W*OIgl>FX=pcJj`ay(wVd)8N2vVk@pEIpdEtYDhgPes3%)tCB9j8F-~P zq#=4H{bpcEj>;!5>k)s(wR_CCpn<5u1_cQ#2o=d#Pa0pUH*eRc5nMrcDd70|K{e$D zbw7e8(#|vZyBjMiP5{)FjdJaG2v}*1RNf8Q*F%`g;#KC zW=7WIQIpd-7Q@5OGpGJ;_vsccWFzLMga6Y1_YMh)~;K#=DO7k>=*m0 z2mmg>e= zOU%^q5;kSUiRZqSvt@Qwp`})=y1VEb8@Jg_e@x^%Ng_h?Y#GLbYSCN`LZMB*69KT%#i|yLcA}xES9IO>rtit=@skO^7wql+#$AQ(JCoBf7vma%jdYbPb^MOL z%x2Ur*2zd@gc`}b`qL+^5202HULmDLNjP(ea;ke{5(OrNJiG7ZsBEUvzB?BWeadb& z+Xc`>-$`98bI`S(XmDBxwHSY0JWp>qkiOx!D4%@a2ZAXHwdhUS1CJuF?aEV_dsTT9w1#9vA!88O+ymEX5zC-a!s-(Lv7&= ziU9PXl)R?vkKvYi9-}0Pov{mDHHw}mWOMNAm3XxRuqd(OPS zdyFoDve{!6yyAP?bu8n@$>9?9r~qJLCqLJ@tHPRAVpSe)|H|U;us0x&86i<~Q()|# z7l5vPV_z#VQ^vDis*s(tsQ6Z7{VKgF4nNv{sS5hMD%>2X(kdmtXu6U9v)|9(k_eC# z-lyG&z*hqWJ$|`hDUVyxJieJF&;bMZop@XCH}O{@U%g^Y^-d*Q?Um2>%_i)g4r-^J zjFvE!ZWU*VS{dp&DmC`KGY_Ada(hlwOnS{RtJ{92bx%yJHQ4?UI1}RM}wK1f1Wh z4Qpca*ab^@{n~JRHpf{e94DoLHf|m(y0-gE*K1-phYBA=RwNlKem{qd{cL~Uq8oQL zGtm;OUjs@Y%)3oHi?<**Dc9YN-$a;?O$l!j2ybx&O_tQV^|CfRx>Z9|U)~L*aXTX- z#%@%E@2%tr50B%%`~ms~Pnlms!c{Tex)Tcc$`#Mg0$}N-aZ_xu6#yNevn^4I&J+j+I{)GoS z`#K-+tRmpR+dlcNJFE^iKkpm8Ws`B?UR%w&S|9isbN17x9mM0y{jcO|TuE#n$EnLd zk_K@L&#k4H#7elCKqq}v=7tJ46P_HhwVnPFdL;*MNqCu|5}f;tfRcp$0eCSC_o^Z$ zR4g8YY{5Z~Vy0pVzk4zAT@~ZJU-V1hDgRAn>JPf!kS}^FU5AE|k-b%hM`CeWK*GsF z&_e8708rMsa6F7}9FJ}bSJvP^gg{?TPJJ|Y00k#(QR<>$t)*z?CO7=qzOTy_Sk6WB zrspF`{&1ka6SVfrp(@()j=<7MeEBO}OMCsgubG$oZh{N2j(vo~&oMNFr|G}${q)`3 zI(uh5Q)sLZ(9oMXF*pM9$jRZ|)~p~tvlAR?88l|>Xmr%utZ@Qb;%p)QLX*6cewO0D zt3HG=4zZxbAd$6TJIF}S0VFVBmkgkikO-_Vg>qR)VX;_5IRx`4KU>;$_#FvS8OM~( z$Hc95UI!&+%{OR^p#gPM!+a#+qlrLf^EsWNcu;_<7so1p_tU~Tp^*z&eC@`eEVM5y z{G6cd4x4X9%8JAZ>(tZ&=En%ObA=K^mpk~P3V=9bFfzQ-`gg7fDyw0(J_!D}>VXuD ziKbL8P)_D<Sh;L@R&N5}X=&DY*xUUg=$_s2+qE>Dw6D3Z zCl+7BFX}z=KzOf(vmonZ_cg+1_G6&jK>ZvU|Cg|<3GXqVL9ALaU=HQG$%iq7*3rnX zv#hZ$`kR{UpR0zfFYz;xl91#Bc^k7=toqeokN|e^GR1>x+Yj?i9;F11{s3|w=x4(} z@s=CQnTOUBcUni7KlBI6dQAPp$>P4WhQ5!;3ZsveUw~OCe5$6oJh|q_UD0L%hFSZ5 z@+HY2JF)W?FLZ-gz$KY*EAuJDs6^TKjz6tQNJxgKeGb!a$jwvWFuepMEI`Qm8y)R`BZ&Q-ePb;dLQmj) z1Rd^D61G}z$@(MF0TxOW#F&UEuV0q}8n6$y>ePWK4gK6d7 z*<*%?5Fv?ml($P>-9S}AGT{`SPCo|RA>`+a2tUxi`I`qkD3_=~7Z}-T#pnZkLR9>R zPADP7;A^UdbUp%>=z`q(pERp@fR=^>R+~{hIrKL*89-zN{3Q{V{~Bn&`MpUvXYyNXww(zQ!@}bJ8<~)xBx`X-7)>GIuNhO6b8aN3K$vt75}Y{4JECMIX;bE*d&gvAeL ze-pL*##TrK9{Lji)X433{eO=peq)WnI27;OZi2oi)A!@weB9r;!V(xUSPOvW`w;zw z+i$Q}e}6frYZjZasS?w|5~!54#EvT zK-$5Wo2Vy z8_{~<_kUPu+h_^U!XmzV_eX_sb6n~GEN5$ZS~|L~m!o@_ME|Ef(vAtn6!hGhGP|<*L^~6Y z$-g;Ssb)<(v$s{Li)Hnk6>CcF_WVRPg~m(L81#%`LahSv?~^F z=p_jqU`~NUj2C#<@y$D#xr6jW9D z{Dznw%#aqv4vSzCsKpkPN@N2zkY%M|y?yb^*6wd?b+N|n-EcocYL6eiz42RHTTJ2r z*hOgavgDSt^=fo&Ee}J>N1sE>c>Jin4^zP8m>z@D@k?j>-zAEF+N;DZTx<9n*=Vv9 z+OgZ+6Xk|++n%CEGJwfT zu9V<7e+qhH|ML@PXU#L<6N+wu)1Cm4C;w-E@})u|o?b=dI=Id_K&sTy8V(kXNeiro zvr2g~=lvQP`}>K3TS z5oL8;;krwE&#R>#YA@_bCh=iAqX!X8=?K*RP}L#P06z8dJhU#a1eF3z?&00Y0wiib zgG@#ibX~xmrj-bO#s43M2=N+9h-XwH+zlwDE;d?{x0bYOaU?V}-jg2uoKcI-T-&QPZDa^tQ)eA0&+!nTVpivxpUt0v3HAoYBOiBX{m^%8H6n_vLKC zxVN0^=Qb@2pohx#poS29$zwbcApPLIFKF>kM|?2dr8W-p*8T3lV8 zwc+L*Mct75kUfouIxf-C26@<_fyZ_?;=ikS{nynbfq~JoLr^u#(4p}e_lqSBh%7@_ zT)1#`#urE@fhOp$p$O>q2tK9I_oWDGDrbhUu&}tSEOueft#^5OkA}^3?%cV9TG8yX zEPJ-oyeo}HIh+p8gjQMr&FxvRmO45JiC729n13El7m`Zz*J`Hj2S(P_fa7o;H6_DP zQqo@e1C@fzA39xA$m2BsQ?4jGTjDOO!6P8~6A#oH&R9lC_xJZl+5-GGfV3vI$0xm^ zy>Ec>Pdhz5y)&ID#?Z0E$R16rUXH#+UQ%)%Vp3iu@E^Q;N%3FnU9v&`=ozAd2B4oMLt0JV5w zE(4ooAY>i~s-6OeodI#l$&Ulhj|eZK3uZyn-B|2wg=kp)^&}Arer1>qb;u^|9|l$= zHu;wJ|2kLXzd{ut9M*zra&mKOn`rUzZh{%Y8GS1d9(B|oF&gM$S~!6rkji889F_Dq zthc{E0YJl|@G~@#OQ5PMvM-&r^c2h{{YY19?TCKvb8kv z_iwpHA)p=?7nkl)yRAMez%08LdP5G~+dfJH?+?e|JXVFH<3hkN2TE1>U0(Q+a>gGhyDruUuS(ua@{5$$R1&-=z|e5WbXGw zysNY*&4I>3HNcs@6C%NOhTdiZA)D(Ao|X8(4-#+CpF*{^e<^`Sg7m-6V?(%oHvjCp zo?&~>Q9o-?3x3s*MhdQa$NbGwle8Df)Wya0A zZGeI_#5FMzg(>iJThaz^5Ygifbp)1(>4a!fzKH|9REf z1~Cf$ht%dJ&cAk&7E1T*2|98wm&c(ue8BsMy_daRMEK|Xleq{AV*k?t4S9_9h@M^%%t%#+UjbA7;1{c) zpkV2T=r~Q~wfoT;Aj9{ENwha%3jA7LUhP05_yER8^a9>0bE$559Ee)=sW(mU)dn>@ zoP?A#G+rL`=6mhN_nEbv{=zM|{X~aaOW*?dKZD|LHwBK4K&K~25KOcQcocZKFK2a+ zBnu;uofrzBqeK_cFWBcB-3rg>v5sC%8K0R0gFXN<3NvXs=d>s>iVXQr&`ZjL1Egev zb7xE>@&7SjeeeSnO!921b(}MBb#t>AE7DkxV$VjzAt}qLF@Ob{F|x3*)U`DA1MT0S)RRoAlhVqV4?x3K z?~PW~#ax5^v?gl||IAH&W-vOa2}~sI;q0a`5A+VaMx1EQiyLml8&tVXK}muGq4r77jgZWN%8rwi7s zCYcuW6sUX-fG4em+@vDryC~D=wm8|D%gIjw10J1WNe=!~vzt-EUTeJoFZH7ikC|3o zA1p$G9!d!Co5mW0Fl#hOiVKBxJ&QOXHth&I; z8_<<|jGaGYxPraMn41U+@qB#+@QQKo-_tm?!t1YpahbySw>Jt;*xf{RB|30XF2aA5 z-slE|X=WrfQSgYp?bHZZ*VG-z3q|wH}_+n1MQG}e0^qz zTlcxXxUXCRnR$=!UqfQWAO|}1ng^&Por43W;d?mwc-l8NQ+BxgktfE`a6cDZCa4#3M9z)wW$mYE_i-X?iTBQi= z`}u$qAmw!X#RjlMT88wYQUB9pAm9ZT`C?{;*Rr{b>zX>SCBVF|xz$p#riL$iq`vX9 zvBvFg`{ltK7L%4KpY5;lsbGdr?Jw{?RwZU1EDAqI0-rVGf7m!l*ReFQ=%Ydk?vEA_ z((9w(t8fP$4R^0$+JKQtx}9g$?~>NW_2fW6rqU;bb`zf?;e({3djDP9$DpSe7w2m* zya7a<@w_o(MGjt%e>Of4mQ`x*&lD9#ZVo+4OsZR57dGd3dd;fx{~j#=RjV#BkhlQT zWseOGy==?N9D|-2Uf&h<-h1ZeJu_H%eaV0zZ*VLf1yX6!rTefvouzGvHoaP=y-skl z*_z+}*S{9|6Bw}krJ@3&!w+O2ma?}1r=j7{th!jM@H?PT5xE=V!D^irOn{x5Gu4$D z)F~o|aF?9joRu#PhAtpHG{u{rze=U@oHDb_!$NR0;xFGB$fF4bs$xSFQh|YO#XC7t za45jse##bZF{|Wt`6bQ#MWc;?!4wR8(DhzMZ;mVq6~J;9`1xMc2B^^-f%#Q7(h;`9 zoE5dwu}NAgc+OCE!SY~8J34})+&^boZ-YSPT0!{b+_Fvre}_viD}OI&awwCK_!XgE z2ZZ{nV8o~k@w%n7>8XkAe^C@|1nO3*KIKzzJ8u7rg2*7O68(__GB;2i|#`8mUv0I163@?iUvzapxZ$w?%-^V zKh+#0ijdaiJ;-0>v&0G$HxDll2gO%`Qk=`YpIG!ILX!Cnm=Kmd#<{YxlFT&6kU2H` zmJCt~6NEMDMJPnPom7bUxNqyKXW_D&D?$?kaEhui;#b}$Yinm9D0~*(x$jbZmcW~< zdsBet()rtctK>NO_iz1>Vmb-{PcAcCQ&`!4HS?%wYtlq?V(dmYk(vl2GMprsMS3Q% zTNUFUTfbgrk9-VwY}u#J!l4A5(gd(9-=_z}J0J=@>czss7=?J&T)igG)Pw%g0tg}# z_DtsnD`z}Gup2U9cM;i)=SLOGt0&Qgg;dUKq$zz{GqxDsHV9vOZ; z>bc>XEchBAb=jXW8Aj+0<6sEcR3DEhv2zaEU66uoW|`7?vp8TCFdVrVa#8Am0$7t} z`aK|S_4ixob`9zbV`-NS^yaFG_Y#I%`uWll5(gzhE$mrV_Vii zWCead1q8egKx{Bl*MCUWECZxI<`~$={GSQfBWO;LIbwSgx`6vB@pjcDBR{`hMf;V| zFhQuE`^e(A#m`cbj#Op7-O>E>kGm;G=j@xEmrzT6zdd;}I}JiKBiEj<0~{hdB=D}T z9Z|{yz>vFas*$93Bty-BjBtAk-8-9buf%MY%bY{S92e%i3x~ z1kQGJUKy%lXD_&G!vdkIr3bLQF7K%>R*`G}MI1cKuUPGWWO+{4<)WQkaQ{OvO4T5U zf8p>m$F|=opvSEMj5U+jLZ$BdC-}r{y7|O|K_FnNOdWDeVx9F$RIwxI`ogqS?U2^W zIN%qsTDt&oo9|ZVM>aX#9spLWus%T7l@B{`YNvE6X@$D^jhw83;B{?FF2WGVOcsoH za}M6>%IPY%Tl_9cxae%R?jXDIfLex_JuBnm!dl&qG@aULWUD76TfOHUte zgV9sV)VgPo*6k!N|I^-qJtA}gio2QKEVpf5(~j(gXJ!USk(A$vh=F_d&?TjYe(W#h ze@Ip~wDg+i-g+jG@WCxx(j0IbWP-PtwvYC;to0jyXfoS3)sG+>Ud#|}y*ejXeXREC zww{qoK2+sX0Ifx3p%{V4Ua-yxn>$16d^V-u)636OI)2~woQoyf z8HGX2-l%J7YF0N!j(ODPWzsvKses{bb%E<2&~Jgj^$E;!pVX?Z4g2D|N;E!SrBh!f z6XhmPoSWvXqHl&Yw^Ls|377x6q*Xvb4&{;6m;>E<<3x?#(@$-=yf$d#nnB6Mk$Yf1mZOw2ua(mQ&qQ-QKD2a)GOk7@w zfw$gDFjni3?|V(-VR==Ds#WGiWKeLfg@2UMD}9;{TfQFKc0s$nZ^ll4?HYM^yzefIhTzbD&!)+aAnuXc+AmbF$pF}L#+G9DG) z56BYv7*J8hHb8r%zmnOY%OH4;1KP%)tzLnH{P_s)tgqHY8fb1^l-Hr)i=IhHWkLP7(+wM4^Q{>l zZEKHf3Ntb?=9oX+Xa^%|B4Z|Z#BF?SK_la;Ml`^f2#rFB<%a@8#>yufD;P*cH(J;R ziLP&SS6lQVa|HaU&_JOe03%09n&vL@alHSwM4%hQL+^|6Y(YQeB(>g8_<=r)O=dF6+C00J!9o|YY z{ji+5Eh1j6O62nh;k@pV%|KT1DPZ;}ScmK9Zn0MbTm0eZG45EX_0#pW{`T+j(J@EZ zUZ3=omJkdPvthY4{tHQUIhC zoa_x+Kj%NDQ@U%Y(REh zx5IwAfEzn}wc;DVs(5RTUTs~UcAxEh)s;yi=o5tQZ*p2EkX|d4x{Dl7Ef3hEQsB#U zFnpGzh^I%a+{(>M81g$3s2@8XzU2fRu=5C(Lg7h<*sxqHk~OjXR0w(pOWr<@rr0i~ z#}q(Tvr667Nh4g55&L&q0^v${#Eea0#v1pRsG1?)9Lk2{x;+BtPm_m16*_3OQv72e zwfcbHtDW5f3>(J@+Ln8NaR{+-1ftnDfw7K1KYb@8`cXb)$^d7A3}N z;dsv!d(?{(+C8wq>(~72;0;f5tE~toK6A1asq)&#|R>4*LoDw#8{16y7 zolw~a)exaia~a#mvZe+kch|P(Sp;=gqtbJXtINDgTjf>DMkROTcdbqAZeA8PGFzxV zsn1g|7G(MunV#4bt6xA9(p$rDv+T$@aL&_Jqbu&l>k59)3#Jr}svfdDTGg1MG{yi} z!-thqbgQfoAVb>nBZ%8q2xfD-GHI-@t8O0g!a%C&mZBr8934NWgYpkU27cGu%EU10%EUq%Ytm^SuKqYku22%4PiQ~D+ibtN{6AuC-gbpLTtNgcBg5SIV8dr zs=`Cqkd{V|$d+cil)>|3Tm*H_^+kJHzY^jq=vO4emdx+9Cl^zKuUHMQP0A@(*jv;O zu>H&DgQhL$g2;h-dhFM$syzJS;c`QM?#r*=-_!PU+N@d`>s{Pm?@wFTUf&%pjI|E4 zq{Q)`sxr%@Z2vR8Ek=!qE|*FK9K;*k=;2}nJR2TB;<^x2DgDL0y(f*mlnPbpsD;uw zmV{xi3M$cOj4%nPSU@(GsDBLDiiR}V{2B0{C^3;l?MXnjYg&ITFed3%P z=*`#_m=woZiKesetXrGeay$de*)`0-a=sV-&Qvl?;LGO1P~f9$#+fC&x%Rp47uUBA z#OW(dyY+9kwPKp=a>`#AjL0j|Vw98-z97=Nqae&q%4P)BB4e03H|hH$$jjXfMmzS8 z^6g8G&Ct}boyw8HEhX0JVgD{sU@)QBFdTV9?g7o359@8m*STC>CY^Kv)Qszb_`ouy zs0MchiGmvs+^Hs;nEJibb3W_F0|jJQ`|QRA9qa~)ubQv`t^dlifE;cQk>)3_29EW20?i^sk1$mRRh%{v40!kFU3<$dkMk7b zS3tgcsQ-bHp!(+(!q_PK90Md%JM zH8i_3o?R3OZ$W~jCI|Gky@O8X;&5Kr9kcq$;QuBxHp@2C``?Esl>~_zCmnRIJYQ$CpU%nFb zIe1ixK9q^yE00Ry%Zi4Vk}W){sQ~2E-_$Hfr~wG0e3(xNI;ab1dwNU7er|(A$p%YB zBnkneMa^i!wt}9)ROCR6s#s10s&QoK2DvWsuQPq4}ITwz&qORT}kG z=?r&ECZFo&xC5=;rD)%GEkQR6|D{b$m~~y`I+=R{8jP1q>P31Q_h&0gFN|2ii7Gnk z?W-=UM#Qh2FUJEz7CcYrz4zVQdb!+AEsqX zqeb4?MXx_C!65X)k}HigYVe2}G}t-O&UTKjxO|4_%CkE#v24Dmw)!!aGeUPMCckUZ z`N&ty>O~N&hTuX*fQH`B`1ff`5laYYpf#?g+V$Op*P@x0HpB9y>}I7xU?RqA)Qiqe z&HiVu$eK@I{YRjPR8>9XH>}`MK{HAkg6j#RvOQsQi4QTgpN!i{Zsq^~V zK(x8~s^0XV;hB}?eKmKi43Iet==XvV)`G5~{ud65?a`RH&d`V#+hT7)&oAv+_~@qv zqH@PF3>^1|9ZL~JzbyV2dv6(5)!O#`N+XR33QS561Qeu0I;6W>q`SK@Xe32ixdD>Y^LIw3U+6OdolJ)Z{-~(%AdD3PRIHko$C2Jy6uz64z`#$A{Q1$dN426{GM>3Ik~g% z(xeQ3x8j)m^U2Z|%?JJ}C$F_5@*hl&s>SCZ@_v+u!#bYKyn5^Mv$^%Z12hr1AH- zS8!O@8lNesuT!&$n&$-?db)KHw;zSkga_EMs*B~ zpJx;a*Z_I!dO*{Ou;-*0hx@VVnoZSXvTcjkeABrjizja)bY*_2k1lV$<_eC2jO)Q9 znMyifdvwlIsQ^XzMxXb_Z*o1!+B@G_GcJkHykLuRo40*hmiN8@PG)OP?qrB6tAmODQ` zr==nCD0e zsvl6m^!U!_r1aw{CM9Cx;1(5k$ZprUiubc=7OHL^#Sc-!(ab%EO&W9Jekwcv75lRc$AilV>~A+jXI8|18-y$6$*!+GFTN;)vca546U%(QyszrC`*_Y@3-x}mkup8p)6}0&SJtbdLX~tDwb+^^V05bOs7Q@Nh0GWb>#Mia>U<48mNF z5XVpR@hm3Dnni=FZZN5l9tk|;!o{&jB+cg%G_G~}w@jC|E;I?%X?ET?VjmUbe*uz3 z(~o8=7)75IW@!iS1gQGC-JCz@v99!4Nw6r!az_O)n>y2#2Ouy-G(xK*mk-Ry2eD!) z;J@mYZGQO-(!}E=z8lw2xwVbfcjyRMHiKzxEvn;75^JwFaA7bFZNddQ8ix9PAAqh0e%P;QkpawmLU$$lf;0b+)7F>plx`kQljTI|miujx?Da*m zG3ksR>(>LoP?FNDvfKa}{+LDX8o&1yM{mO+-+&!H3o}vTkBYLFpBIvW$cX_o(&9AM zK+GK(KTToG@eH5GC?4veVeiiEy?ejDN{l~0y@3alo6Fjp z>xz;obcEOqpFO2-#?4O;tnzXRKH-LKj~>I!arBi6 z#Jlw-=Iuv&sSM#B2GYKB8S4ARw0*lhb$Ae#^Hm z>rt5j>p`0z5(zkq^_S~!;FlvFF4e% z*Z5-rWKKeYNe~AUXFVXYlB{{F^N(&S&b<5?2qpRu?S`*GloJU=K`iT!*JtXhRpKut z%eDDy+y+D+aBrp9chQbM=LC7OhK7bcfP!&%Ps;)Ahf%86DN{L+&YQpsoF0mU+C#6$ zUKsmY1{_||d(w5!V}ygVxm({xEqF+{$azYQFysr)Y<~uj%r;p(bg&rvdMDsfszWcA z{lYsBNrDZYotV)D1=gNOAP2q>R_@3fR8%>I6$ZM2T*nytlexP5el{Ig^qop`Xxgv<=)zBl3MM#%Y*ptrl%hb!fj?M)P~oR4P*vg0BL0;xm*cC zN*eX-DOhvl;~w;uZ+um7&BEyem=uo}jf$nJAaP6@Qf|Fy#_rLnq8q_es>oN{4Q5Ta(DN zGU8}DEi|zxnCeJKnaZv7Mt_jajd3W&XPoknnGRcY`3war~Nr-b_Yi zV`r*51j}m?wqi=-EKDwmRq;Q7VQ=Rg3L7PjFtu|D793Xl2zJPZQ@?~TD^OkOHR}(Y z%~Z#-QFXpahr>v|da-?iPH()EbFx>gNXtli9~_qt#tW;G>egz{(~yY2*`L8?T~$pWyRo$nVm z*}T?&)QpR+M&WOen+J#Wc%UN5Ipsp`0$qN{@kU8d(2r18z^7$0+6M{C!@E=r)5jE* zY8(`tK4Bag2>w!aQyc<~%H{O)+L8~{`QV}7e$p_{;^145^}0+k&az{)myEgwnWKFh z=2$>|ZMiOJ&#t6+?6Q^Q$fYuXe$xC?2Y$Ef6AqAJQX8w5V(r>;PwlX$mbO07xxv!= ziJholqBOdMe}WYuh&lObq zfhNU`j#enB`WlRXL^|x;jfKP3EAaA+bqm&D=it|}p5Xgo(kPG5IX$(xPrJ4%y+2V^ zrd!jPy=)b6>CmnB`e6ENmA%H~&1yu-6ptPsBWenBHGSTCSB{oolBe1@YzN5%u}Nx@ z96yPLcdCV37lkmg8o}e8-|7eD8Q@4HSKi{uMu5(IB9_-}*pBbZQr`e9{j^x)2S7xA z!Lej2{VM=bivx$jh&L#?K-_nvhOylkbm~NahTjOuQ8V}ybAA7bGg(Hl1E_-}Z0%Z_ z@@`C4CbCg=-*T0+;xOCH@>nz)sg8ts{irMk{um8ib@eA8Cix;Ky59vT47W;h*Hd?+ zwx?@{h}gYTfSgzxi+f!F2HWy#C3b&~$eARix|0fMt*ddR)S!1?dkW4sDPv=aHKSaq zEa4o}^OGPvnv24hzHI?-9Gup>ru(EJ?zDf|9ZXO{hqBadAX~c zeE*DmMvX|GmUajC`$wtyk9VE?c}wUI4i#Q9vV4`%Rq)e}&t<0vgLMNt2Zao>$fa(o+FliQimvg|9}+sIb|0-ZfQF#wD?^mH__gxI=9P_=MhMmp7X zF-Y~|)VRDC45KV0Zr$2m?a4qEfayy*zkiPaZ7(Tm89EYK7)v7g&}1!%MI7jt7lz(9 zaV`c@t^jT1^COeqBr_-HIOXl`(Q}tmznD6>rAL?S@erpg=2L z7#PgAMqs&ZDBOEIMTGG+&z5HIiKJgRQ=uliy-AY_3W9Ver8>UpUkOr;qqnzPWRhsBLi ze~M>%LSO|%SG|=SXKp;_%h59YIlRjujkZ9uY#ewtB*!ld$aI`6m$7Q^yWif$+g5pf zF+l345A0Y>UP&rWw!knW*%WoEMGOyNkG<(1(Tf7dcWhG9kFr-Sd!tY!J_Ejqt;0Y8 ztNWlF@EXWE$BcVE-AcTEErC+@KF#~usjg7FRuXjAXB6XhLBte!x+C@eT|Y4)$*TCR z*Uh;}RBR;;=RDbb|9cp;WO7uJP^S(;4XAzgT^VM?U|nkEU562!B(Pdd4)=^1TyEr$ z72$j{JkqqOs~DPSIv{3R#3uyGA~|Aio{*2Pha~VyHT6Xb5GSIoL7u@m^fI@Li0Ixx zY2dGBu;=;817|$G4-1Y}^&GYVxD|tK94}P6ZR#BiL-55-wQ~G0WM}#|rf-?g7~QCC zQal`vJOyS(?VZ}99EJ(?tZ$W!w`UF8Q5KhTze;oE-OTb$A)?u8rw$9s%FT=w=IFmW zaI-KJY#}hiO?^7Ex$~GNll9DuGU-l$_2;$^(i63U><@OL-rx~+cAjW)uN~>^61g$& zaj5Y|M(M=h&j*&PUP70JGe3-clqFjHRBBMvL;pR}b<3SpkwypkmUlRW!G~v!BVNAd zWh%E40zKz}-BMJuf3GK}N!68lO)qG+Z)(I!q*&U%g(#O$l~#C;sm6bT$`WWYSQT0f z73tz_T%F-?y6+$x`7qXN3#XbA7Zs9s9&L!d@QVd18NMf{mwN4f@tC`O>)WX~q z$6Tg!rn}Wx^f0h+{OAb4>dP1QT>|@WYznW`dmOv+ zlP#Bo%PhBIqrTm`tzE?tABWC5R+Q-ld%rCM z7}AxzQP65PpYLG;^ z;lmQ_&p?Tnwdx6GIMZl`)At`AcDMb?^+I5}3Pd`;Sm1Dn>2&VeWoE`GBlKf}pjLAA zto;2`?x`4l7ECQYAtX-V@-ji9K@P#XOuw|316vf!(qL_YOHJICL!+DPeoH{1velNN zAQs6kFc^qwsfc|0X=AKwAyH0j{WB-86o}7D?1AIqvM{HuAjxr1!gzLnp>3tS@7wv) zYQ6R6ERzF8v3Dzk1WWVegrsWE_vTwM6SI+bhFxq*;6nL;(r4mCs}mG}WrhrnuodAlEWs608TRIWrvJB!DCaaje2~Wb7Hang2P`L4* zZpT8)=zM>FG;j)=j@fSq%=8CE@wzhOnqjvr%qiS z!ah+D=ibnc)|m8Kg+`;+Bk{_j8v`iuvPK68WeWB6-cwb^4k=1Ceb|m2b~g6@82Vj{ zimO=PYI|i@4ATxn!rB5!mU*UJl-|X&&MWrrhvf@QErXJWy&jvJ?kHWp$VES>5!k(G zrb1k%5?_449^;?JI7`3ep}f>G@dkQGSkHv1WUVLunadmr=htP+X1w3*7GMY2$NkgE zh5dq&P6E{YOhGT???&SWG+S4vM}&lgFpDRiGODUk>umMMd?{d31T*Zc4tJios5SM2 z7rQz=x^6v!dSZgB%=IAM9(&~T$^aPegD2-ED%|PZN(!?ht(hx)&nUqhWaTDY|d9$NN zuf!TjWrm}s#*V+17$FkW@Ev8NQ3#oHn|-M$O)a4#OZ^~_Q^STt*xNUs?6huyXS7<= z{9c@8rQ%a!`ZV5KugwGVpP7+HIUV`d^+kT-t?{ggQ8t8AFVm{>EGCRKt7z@+mJLjr z7qIonxY4LsLE@-_RJFLJWvlS7o}gLmt;{I>+_Gri0OJXnh(jMTwGt_=5AAap%l!T} zKleFPMJ~BO*uFuAhcrwy-~ey0CKv>4n)*pk(wB0T5f>#;U>LY_=}N4})14pTPb-w( z5kpEmvSg_*d#`%Pxt1gdcjf@{RG^vm>L~*#x$ilts(m0`MS#HJe$p^Nnx@DGX`t4^ zlesQBw$ra%Ouzk2=p>q9r6Ml?18{6H{U!!X)YxKq4-h#eBb7@CVfNgUMN`~;#XoZE z#p33LEH}5Q-TsAFZooG7!x#*DkA1OsrPfTX>t^&e`ZE?ghDrV%!g4ZnG$cFe`uz_j*ZUY1E@R>Uul|Xm~%jjqE z0G3t~41>nozgAG5hK5Ra;{Ys@LYyI`Z?Ay&+rEROddwVKmh`tLWH9P~e0&*? z)B>!!?!lf!;BTHp{v^@7>-oyUV40EB5*X-romErAX@0t}yACFb#=&fkh2Ef;Ch6?# zoCjzHR&*sz++97XEGFRqNIsJ_n#aKMK8J*I!zs$}rr6T$xr?(Cmu2{nupg+8sWE`j zj^zOg8M?8cE&8>sae(#jLT+GIWmEd|X|Ww$D~*`InB)Ls@$2*jhSzhcuW*lW*nkly zzY6f>k$;5$JtFw?9^?xBNdiz_5G`)02V*HN7J*-X2k%JguI<;W$BTDx0~3C^<|xgV zw^9H6e}6-}_~oMi=LS-4##O0qM*wqpH^9VI$n`KjZpJ-|3q%khH~+&@m>XG6`P*gq z>-S7&_|xy6t2e3n1Z_lPak;TMOG313o3Avm_gI-|G!CpSqA@?-lRc*RH*=| z-s0lo+wjFtJ|VWgmEvHVT)ZqJ&~cQ-|ECw`^XT2bph6s~FNslYU0b!bh{4Np@rxG% zUYsI;AsNb+c}zheI9j5|2>g{yd*I!cCx#sf@Q}&{bBFNXM}lCNs8kTRT&qZxh5gkV zk_Q9CctyaR(7^1>=q#96sSb|y{SY!TGDb5qGeuCA1KBKkQ+j~ZA}}K>Z0ldLHEn>a z%go7<0yGfQLk13x>TfR`{80hc5gszKKxY^Fk3Sq$S^G0EVy36|&wVin0G1u)hBO>4 zcC$f|dw6(1_<(8_|FsMOg}gWTq?RAYm$H}hCzsa1pw^;xYkbfBXeLwh;6z?Ajk75$BK3BO@(bWMc{$8hj=)WL8xZ2Oz z*hWJA(?)E76M(=|6gv*a-l_&v8O;=l0$WqG@7;PhxQC@&@RgF_&J@*6Cq4b`_6sgr z;2EB+PqSu$jcIdhK_}@;QF<@=cWv}5lM@VZ;mu<+#Z3yaZ8__axbvuAf&)wJ8-&#{kWD zZQZ4T9geJI2Ec7DsfY6{OL3xz%7Fh6 z_5gMR8JTGQk#!=Ejx zh6bL_-riFkimnm>GeOmj1($dH^QY?oVhYJ(|2@eI1nmO5h_500i)CE!EBC<wJbIY!T(9~fm{+3Em}2Vr|jD`DVr6TI7|uverp`XfCi3@HuLs) zoOQb8pI765e#XLGQ*q%JPHZ)4x39Af86gJ(53y0he5547i$c z7xKPv{kQA?6@!Vu!uz-V{~s`MH~`7jbQkvIzpwuD4)B)%4`4(FVVF2^q>0}~Uw_*q zfyQb9hKYOYYZ?CM!}`nT{SUC?fBp?%;*MdMI7Pv#e_m&QT2x{07Qn>)gwgsa$P@pO zxAZ@s4!cM|>+^!q`jjJf{>uaT<4^>&KHOilzJGm_kix}((faWJD@5*(%>mH*-oj{o zxbWaD`!~-)SqCW`IQk@j2mLYllipow(1E4V;QD2IvXVaCnXZlrEu1X*li4#yl9|b_{1HB-) zybRhk^4W5!qzc6NGk|dgBar-Uh5RQp`|Be`wDh9`iYqunLqp{*96A6wIz1P;j=Uo_ z+&MwTzN z1;3kL!mmq|F|_Re><5VC8Pq96YyWlM`?Vew?gg6rW~daX4pv!d!Ccf|+uKz(X~F5z z4O;bvE&fPlVDyBf)eB_<5SMS1V*IPe+=?5h>6>BFmjZIIZrgC$MJMCFlxH9X4Xa7E zC3=M#Ya65fuP$sKiJ67vM;8z~EZ8Xj7z>s3g{^12q9)uQW`Cf5g!)`0eA^seJOAa* z{?mRW-wifjSKF4Qr6r^95fr@}Ll;oh*I0f3u45LB6X%QPoep1Be2H1!|1tgTSFLeG=BMB~n!Z%*!x{ z*wA;-iZBG2r${#SZ=;BuU3XqH{hJT}BLFD1Rdqq(Bw*Bi3NQvzoQW!~$-q~k2`d7X z^TLIrv6TI*cT@#1soD_S;UT1-2dVzePiF&RZUD*y(8ET_WexhLhxeD~D}V{GzzZ$y z0Hgp%C-Yk&#b3S~_JQ(m02R*F*6yyYtFL7AzuAe0UxBAds;&Kh>t&3Q%&XTq=1Iph zx4&uJHY)>Z$zZY03l;-lO)UdQ6fZijt7?ucNoQBr;b)@+k^j9X{brx|>n$w*_U;Q5!B)h;3K^?u z1l8lm@uNU3LJ!RU_?QmLtC?wG;Qf{a@0?6I&@di?607Pe1AG-I%8;Y8;0k>^Ac?2S& zdyULh0D;$-7oqUYJhtp7ObiExys1fQ8L@#j`csOJ|0e#C=K~9N<%sTV66A{Z&2T8< zf8a5Tr>Ej7TLA0Ha3Eb2Y{wtVREsKB{zPcS!tY#E#C{zXIk%W3ny53k$a-j4(HCKy zd>TcPcxc#uMo*t5LnL^|Z~TGjR8^AK8~6drlmu{n8-ethxd7gbJ_{M?QDJzZVF4QY~=`g2}qvHESg&YD-(XXo~pJJl~r-24TM zP)$+6Si{lmJa7(t(-s#;Smbp-#7P7Sr>pxoZ`p`SUDPW3M+FA5S$#b9yH`BXc6nL*iyM`EcdOl4!70ks`gx`q@hW zbQ1O918>jhnujn{&)(i%q<{+yUDPWBQfE4r{NBACI^iSR4q!Bn20d{dR;qzgePO)t z;WHQ%xyNG#jFA3l1HB$?qkK|thG_wDnLg+ZcJ~BiAqU-~Om{Sh*YUvWECawQgAret zM=1qeEE@op32|RfTg3sxNg3*$ck;X1Xe(_ng_3|2!??-Yr|ITmD{C|;i;zgDal5R$ zhhpPwo4%ysot`C^?H7H6v$3&}4rE4#nIj}@_tV-OfkdBcWUzrV4t%rX zF~so#@Joy)%8Yck-?RTcVerdEbH$xE9nOse=pm}bBVZcH+@5WGvFLn799Yhm^|Cqz zD#@kWA?cd|3OCHQ^8!P(gq!;(A0og8R>V$noYwo!s09f|ShSj~V4`n09+aZ~isxy? zl$t%#E0KJRSHNQ2gIej{^R%Ehc^V~kNbrX9^U z*FhqCq#3`S9>U9}Ur2#jfB-NO*#k(>0mNWbJmACd2AG~kkKaq)tZ({y zQ3}wFmVvF~BbefZ%u9NGn+p{4LV(Cg>X;n-loME3Wkx-xiT43m>QWqB}h%Pg5KQ;_*gb7EAfoDDB3x9o#s0SkV&L$5!Zt) zu-9H^4K&NMrOSne`#WbOWPB-+8Ou(J+`rL#J#Lb1u)J|7@Vph+;2%x3o%<3so1ez@ zvzF|JK?-`f^VD?W2b!z4?!Eo*Q%Q_^Gl~~Ow>dmc>6wO9-MbAlhZ84y9poa%*qzsn zX{os*y$?OiK~#QTQFN_I<`j6RND^;{RueA#D{|0av7FXKy%dXtm8Kq=3w~$z3Rl_Y z8g#j@(?|5O!ob=G=Dacuu&o&aG(-xHXNj-M4=0E&{uo#mx!3oZ3Nt=y|mt>7tp$2$Gu$8?6JZl%i2l~LtWvfBU;nG`Mf zUGsZr=_3rsKBx@|$KHcj4zdZX5&)Z`VXg*yejfToWtq1K>_%NNbYw!J1%B&J!y7+1 z=2&APR|?qN>*Plc#=FzCpk4U-w!I z9H@vEVe!Nf_aF_B4SdPW%8I88f=S88wZX%6Cq2cXySOO{Qpy;`%#tY?9o&wfjv9V0 z;cPwknD~KlCmEia9DBLeKG`?d3A}hF7Dl9E&YK$M zs$hjQojeTqd3(&pq~q%0jYZ2!y)1J#GODuLD-ID(o8P)O+TWV+xt_Itx8x>qQ@-xMiCl=zl6^+D* z$Kw^OTHb_wO3oM85cC@RXYqNDueNWwzQ~;~ec)%`f#6tpbLA z-qo?CDD6#2ac$^et<1j5|Vd{NS4r}etD)dIW zfW>86t9Si1*W177bF)ieV3~7zs_T#s@Ha+WdCrAzlvNe&ba!uNo}SscOvbRi4Q~3t z%*@=AbN{67-AI+-q{; zzwjy!dT}kXdU3Mlq?#wezf<5x=LOw7d!4&c+RZIhV4#_x@=eDEGc{`MvN19uiTqk` z+u);(=ErCJd>0PQtKl{IA=?hav&IuH*jMCQx5sQUW(kjScqY4_>RpX6$KNja`|b>9 z$1ix>XuB@FTV0Er1l{UK%a__x^ILt~nBP{Gm)~lS&2bN&Rrz=*+a9WUZP+@G2ElfzMMs9!Q~<{zMM= zwPcrBeFgzoC?U@4=3;3#+L~pCL2QO2CF!XRE^2SSa13sefoP;!uL~HJL|!}q!49R@ zMbaaggl!{C4>k$M)C-nek2BKVI%4)h4t&FHLhi4@H;{@Pn57!bB$tHwUH}V_nSTlB z)n4Tjtjm+^O3W?6C}9_bYGZXwjb9tZ!GtWfEfWL3yKlqEZo~SRFGXR24BIiMghf+F zr|znEk7k*Kw|j%JxB0YJ$^y?=Dkc%~phQV6R(smWj zGoe~1COJ*ezRn9iGOzm;4NnHQh**iWV9BHMq#;j@>v>e}uW>VVUC97up) z*gh5>$4xq5W?$vK{c_^qjmvP|a@B(SJ#x6eefb^B_`-)DUtec-&n`Sx&b-erdnbZe z=fe%Au`>0`ID;6%q&u!$L2)sYgu3Y>cQ^Xe-b{u;@6)e#UxRq_NsfP`p8R79&l27M zR{OjR9nMhcH~k2$_Z}+Zf98J(S5hs8IuC-tJk&?I2mxata(%vK@SURQs2UJrwAih> zlCZX3B@YvQK5x9hvn9vGhTz(M{Dho?ept6RQ$O~!YW08^R&P?yl^1M;jM3ZPEVS={ zNzvEA;Q&LM1-3Ri<;YnqrMC|Q+U~7k>hcMTGutnVmj@>VDB(|09#@*VPJ}vGfm(<0 zmjs)!;^Y`Qm9BdtPMgD>_RDR4A#+@IB zW$m|5`eTx&pupp>0`#0J^%ua_0ILzLS{J#!^$VCsU6u2+?^A+CM>$1{h>X7XHvZ_{ zpdEfgL}*ly%8)5>01AS1IFhEqoYyzkmm8uM!GVa`xo~Dud_U*CEO?D=pIvO13rYsA zRxYl>?|R%`j6n?#7DaUn6p#l3*aO)XmqMiCnX505)^0)=o5;b-sF2RC^8jm7x6yiK zA55Y4Z$2p8S^97*$L-`UBKh%YUPvMBqfnm9ZI+MwgS13JD(9;h;b}67qo=PcwL9@J za}R%*3WVc_wpPwrN6Z|ZK71VSK+wnRn(aqXrU_;!Aa3B=?!A38*4Yvo;e)f>EZ-r) z8FFa{96!n=NlT_EWBA&7R};X2CK}?tjmv5Kp`91+%>7|6LXwA4wzOS?b$U3|gQaSw z(WBa3^{dx##j6y2wPNkO6cQASho9L+QwLnECM8PZu4R&w*37;PDl*s|&ysWRPB_r_m?RF*BiUg*68~f-urK|_qzNQ@=i4mh_&m2)N1HyBsLbR& z`zAPD8<+IEEvIvzpnF|&fKlv|FfP$!3Mv6<{OLwqJFufb{<`4zJsrL=6IaP z2lm6PsGR$Xq>RfHo24%Xe$)Z8@TYqZ=i49ax=-pACOFxworBjkLC_u^D>PP@~?tNR3HE8i!@!6S=J56Dq6K+JHIuuf*B5!ec{2U`|Lk zK>HrQ9%PlwZ0paQlmEO z@?B9%i$)a-cdn*XnY((hl$+;UA7#~wSi%%RoUu&5qd@I zkLa`Du`*Fw*@jao=)TjJT&WacsWlHAC%=r!F+B|D*xnu=#VcEWV{}s&Yu1J9g)nyl zDCo=J?TnC&rK1&mbO+F%#mMiMCDQipKd9>qoz6yrR9cLk2D2O3j5Vkwz+(kk*g+kc zr>Agr`$_S!&J4Bn5O^O5+<{lfrd7Oqs)2jvEwbjn0D1pOaS9CLTsw;w8fzK$o{{S; z$4KcrNZRe&e_Hs?@1owh&Nv5|ahh>k)}>sJUbPVC%E-9wDBXLO<(32OorGk{3xuHH ziijsMb2KSZdv#k3BRc>@r#Zvn!w*iV=jwO*j!rK>%))uI{3OG=Wt`VF3l@{_kmk<- zi)S3!%wqdiZIc^`HxGq)TADYv8(v1ut5Wv#*$i1O+F0bByAgl;G9-tOyl+dcY1S=2xy7VLJ==TfaMrxVG3lF!oU>L4ufPts!*0F?dP*{F!TOh-FfJDX@JN z40Pfo&bM>DeE6C)^m){fG)pwEp0nAB0!!sgcx}Dmb?)47!%zo_%5KDEYVDeF4CWjW zj*;a-=F17z7Or~;RW*H-$2CVynF`I(m%X;3g9}rKJ6ciGHV9Z&oKGqdM9{xWKjPdY zb6=-WK}1;sc-8#3M4UEEt;#u-t!Kcs>$)}Fg1nG2rK#>;#nehVra2U0p8*Dl{8-$yAkCt2t6Y2{{BZky+E$gIYu&54!PO~3Fn#Ei0?_a66(jk@C)m7tf)Z~gUr zczf>2Y*y`G3x?`HkpJ8OnwxYwc$!Ey%ma zg0bpN^PTH&PQ9T&)22ehgH-(~8k4437he1KxZZRu=g*98QIx$KC&$IT=x_BP=o7 z_?DGr+-I(9Y|NO*0vuuH!< z2$M9JR6#v!-w0hyH&|Z!3A(7bnZH0JE~{D!KUP7iozo(_7xWU-h9`>MKj$? z#I`wv?-LjE%#ETq06%ZGr{tS@&Ogo}^$J(mF>PaI@d}=ywHfWkILeMDV)QvkMr01% zAI{j^UW<~Y_22OUHb0F@^H?<{aSA{FhpiHnm2cQB(Q%O=9^wZE+$j4~EnEmDF{Jv1 z)huGfkC+2^GdV>b+ZtwIe$r`%qmifl5D0JV0-uIKs}ezkWbC7FiN-nqswKp+J{lsc z_Le7r!l`GuGkT=q#`lN}i%ff&=|U}puar-3qv3GAKmx05j@s&D(U2D<>$>yqekf<* zKt}#od?-GWNJ-oAU|x5bbEepM*>0f5Hk*&jS-xVi8KKJQwccu17G7M#s7V#lQ8k?Y zC(?zmBOE9K;LJb?MdX><_AFE{Gy{xsEW!wbP@(*xLSqEGwU{}?#n;bsSn0UE&@Ql1 z7+$tag~4OJz+E%C>J7jq!+jo%%}K`R`5mv)Je_uH4|iJy+-I zw`<%Tpp;-MblyF0KB;!u({)$4yGAX&Paq~_`&xIZsEfno$$TlEgf}5P6Keab8t-{- zcni>+h&@DJ6bST{W=ZZ(L*;ZN#vy`@DS7q?a~QN1j_EAS!JYp8&UWZNli>VNwT+(B zZ5tawo=^qFP7Fcd_})}5f*q1##)2kBTcb*j3Hqr9Q-rTD+vdJLA0B6rf#Su}H#+g@ zW~Kh0MyziTA$gtMhIwZnA`xp|wj{kBsM9t6wCHw^mb$W3os4BS&6VJ5<-ON3mo~Cv z=xeojRy;SZiikKqj7ah{pXN+T;lt&7Q8M9$B*`BZpWtYWmz*1aC7gaB11AP*<|BJ| zrV=+km14B9gvn~4_(2=3hSPiz?wkHD9CN!{Lp$$lgUTn1!93848C}6k#Jt(eA0%il zyT|#%sx3apmlEQhVl|}Ltlu;r-~h=Wd&9(1fvzjw3U?P>tl96uDQIyh?Yv@L0YIdY zhI79Mhpu_pEMgo9j4MoKgp7Mv@!{@w0xm%JYgGkv5i5`fzVYgKa-LoHdGc@?X|@jF z#G>B_A*FeFo^hgV_iiqqS_KR5mpx$g((mNTlNY0(er^L5Phc#yOBqLcIF6j>i}M5F zQskjqqm5EC9K}6Ea%Yx4BhFm%=S(E(rx&aC0|}y8yAEgh=_764k&Pi|@dZWaikMR3 zMPe4}-Dac zkVp3*UQP)dlWFJdn{eax?2$(LM@V*c9-FG5iu7pjgM-6XcJb_e0Ai>n$58IPcji#e zytnVAe>Bs(U_AUaW)Y#ES4S-$g(qrN6={npaExEY)U%_ur?@UkH0FM_1aoPs-U_P^ zWJ#&fPZNDypt`!8yM3>biVCUu2(aj69SRF+VBL9&eZ^2(esh$gQV=lGbl_)TK15Bs zg7?ub8C#{tXaarl5{sruH)gV%6r)lNPWbTQ z#g)AY3|Sa&I6p(H!Zb3NGqNXbcC^3_Yu<;Rhj@|9h2~8&%39;~#Pg&z+3mFhR5VT@ zUNY&0yl7MW>wuqVi>f?{^G*6UyFdI80_OviY14?5a^FgZo=E(CpPoN`H2={T;f*~g z`>nAx-)o`>WZ#9}ddD&lP=RSBkLr1E95LRC)!C8wJ&b>Xb9V+a!V^TnLE=`K&QT( zXsd#v4342}{K3sUYKc~L@kta!)|vzpZs6IxvfmOUBQUw=s&@w->)COOGwR5;VPMo} z%GP=9uUvPB;IS^zO+AP;$NlXCIc$5Ez>rF>aDUuJue_I!vsCvs&F#)j3YPm5+T3H= z!srQUWOQw89nRku{`3rkXght^{6HwO_Vb!-OPoN?9e#Z9wlE@tI6TkoDC77|R;F=D zy~;qDoLbjHU9Zqg5LO4sE6BHx9rD->|t_5c|>DPqx;6g$HX_6|E0Qdt%CG zg762mC`Pb*AcADOwPB~v?-5YGwhK=%Qb~7 z5cAmg&T@73t!f`@|wX6RryP6|0@Fd0O(o^9ddghKd|9FryUd@~eZ$eE{A;X6gczeV&aRsqf)F9l7V~}tUql;#Or8_O;YEcc4{puTBJsvO8E#@KRVl!nn zABIJ1kP~q${Jm5$M4SD*1g=81_`K@_YqC<2w!H?s(|EdHCE9|GxV?MM;Y)mehjd=< z2exwA1D=pe+P5gK)|ELkEw%opey;EP33?r9CS7^_!M59na;+Wey%^t?`bvWg;pZoK zEEaQ;NnckSF9Fu}WpA6@lA;NZFe;aYY4?FW)&ukOo~tFxTIY>~Ic{yi-zLOgP-`gW zpT8mTMV@tQ=11da!?=0WkXjBUR;1@8+iz^G4s@ZgeuxCoR|LTcN^327H9H2S^MW+S zx6-g)j?n#a)M!lDM%*A^8;D}@aOEdx6BTT(O1U{yWGQK_hPbhW1;_KXrwX^^HBMFb zI4WL-2$5&MBZ%fk*i~pRXws#* z{J34M7P-k=(4`X=J(yB>{w>VbN}sc`_XU zzL8x~(Nv`z=S9b(`JY?Oe+$JO(VTyyy<_sRs2fhtuFSERu6Ge)dG8ER*Nw zD}xp%%mEzR;&IFYxr-C2VD^)fu{K0mMXR4p$XHh;y3)?(4{YZzu0T19+xkJiufhI& zpApbw@ma~lGmmW5odQ~>I%T#J-MqkX+&3Hch?>_DLV~HuvrjpjcHTbq_KAm%#HVZD zhTE0aoC@UX6Aj{;60@1dNbY@(qkJ~MAD4}kF3SnkUv1QxON_3sw(!fOUBo!m81R&x z25bmPgY5J19Am0_By@t@3XM~4cdo~M%;W43xPYmKp5eFmZP#rkUC{iny0BzIh)Xa0oHE*coW8=7q+x2)@*-}6<-^$b96kp-)eXl{B z1{EBgZ=gdE>)OU=i-cgtr2gaBCLIeoWnreS(cAo9HrSjKV4JfrSt9PUs25Z$Yn5F7 zJm5MAF%f%(Syp@}$V6lWs8BemUWP;RRFRGp2P}nOa7fc+$)>)>=CHPoi(h?Xr@`2oh0d*bfEk)jD3q3y1qtH3mKW3uQvN|WNYH9+e3ZkKrC#bK zcNp5PD7RM^n6ZZ>;L_^ zL5I88l)wx~YYQAyY|dIx$kcH~6~W@wa$9te+POIs*S0gk?FibTF>0S@vtJoDYTT0M zXy+Bp5l35{-+?-zaYpTSU%23iH^T++e8qpRgtPsX7c9v-5;RWMpiusH2g;kdehTJD zAzb+q};W0?GOjxH+sTx~i{!IZTLg3q@`S&21qnqFJyG6zoMj)I; z(U<4gt)A3OGozc-A5N~)~^bgBS2&fv{ouqXR?UBuD-8DuBv%cpQj1+I+dMxZk(Z_*2j9D zBi4+Yy1blp+t+UIen!~XWs$(kP+xIT6Hj+UGhdTqBSWi^Qt^&PN!M7$a1^>;#0k(=$N_ciA`h7NzSO~{ z&<$pEJWE6D0@{^y(p9iyigbOHxhJ3IdA6$quODGHFfc$Dr>m@7A@=@>hb+fp+~OOr5H01b)?W5w`_YPUQ@RM}cULYhDLY)vifsj4tkb8WYuvzS~KS z-4@VzJGkB-V0s3kH>Y=?VzM-Slby{wVUAUv1_x?Wj+|#|C zd;k9ZciMIK@OrP;>$TRip7lJWt!GK{2+nZvEr)g`h0<)8tByqay>u|&=Mqk8&0wBc z`@ztA7q^<)_jxZZ^5dRwYq-xbNCUnG?jBO=qLa#dMuAkj9ikR2D&d_YP`mBFdrT=i zNm>~%x^R{4T~Tx_P0yR$B$l4Voqd~e6_MGK=|&x=goTugj>Zl)lxyJb-rR5=sf0+pvzLUd*NLSMO%)mi+Nx!D-}kKv}&_^4k5iB$7EkBWfi|J&1wdET!B}ngh~Rnb6>O1)Z{ZQ*FF74O3wY2 z=v>tyr2u~{#k+|6G^~Y1&d14!?r>9$o&$aMlNpR+!|d-wswV1zi)UXA+Lyj%L8tj} z^?8rxpJY*g-T^xZo90FXmXgHM7dy1ob8yvodx8=qNlZZ15GgPAM2*w9cB$dF0LmjL zOgfXc7c73vtADC#E()jSM?F?8yJqh@Nl`4JOazRlXx6i_TvExAAHa`SI+yz`edpUq z&+*q4+k#~`hs2HRTzJA71>pwdXIuN$U|4lS7i<_F4CieN9tZ3Vx)a5%mE^f}I84KY z4qu>l(1u{(QrAj{MVNfL_;34Z(`Q7e(5r_+0gOKvQG;vv&V0-|m-8}ruS(0CQ*k>( zTs%GLH#Diyi&=ujeT;8b`XU$vj?wwqTsx+8g-&AlW#IfKe?BppHa)tmyB!1!`RQ6) z5R})_Ypj`ndeqKv(Ag4^@4fYCjY&`;Qcc?IGXW%E?l*#|yLPmZajGooec@Jy0#>co z2xi3A;!vgd%|X%1dat2~#5d^cNw7)9m5v^JegC1?-qu>c+x=Y5Vqp@lW9g)MUxA`h zYDm7TH+EA~)e-kVJN(fr&AAJ`ZAlIvBR6)G#Uq8Jcu&tKiQHQfDLv~p&;9xVuQGNE zQm?pLa>)6YTU$pZnc9te)ZCv}f6t1y3Jp!@v=Qzs zmhUPr?RM>K-aqr^R-16-IsM~GdH#@UDt}!Z`t4k+2KN`f z_ZRdPTff2Yy>w%bc|mt2C_xUd?t_(Ez1iyZg{Kdx;&dyopZCQ3lk1y)-91CKc97DUG{{ACL+UiZ5K|<` z+|{9*7E5m@P;eZdvQfF#vLW@TZ)rvcH$e#c*cX&(64Gw;dKkt2PYjJ@U$BiI=&@RB zaoca`=5O(OU7;$%%D(T(o~b(wVSk8-ykvJSBQlOC^BrIb?|-<^MJi&#Uf5Prqu=sQ zJ-9bVJRq=JKH+(MQX=WQuja=Sc|XC&Fo@(-zYzq@meDF3-HP;T_rVvc2NPs{_GWOU zYU(cA>(*Z;pT^h(iJF_+RW@0jV|S(SO>0vd3iyt<=0jeFUC}g+Rh2%Z)Z<6Gt7pE# zbWy@2M7WjD72Rpe=I^I^jL4rv(2R)u6$O@If>iimfj*t*ftD~XqS4VUxxSr!+tmj0Vb=0lnt@j+N1IZVbB02Vi*D9E2 z84r$diXRlN!p6QYxjdqADKwZMyHv(mzI*g-HxJ7+kauA(r& zc0n_2oTYT{hOuZZz2Zc5T{1M|wzM{P)X?*_%tvkitGjIlu+ zUHWU0+t01Pw^=M1h<~iu9>IOP9?5l&k9bxUPC_A7(gQ-PA+A{2zUwN!3PFd`Qn$|I z8_Dt1*{wz0hWpwbD!;LyZ}q}{zgWWb$6QS z)dKmwi70`bAl=t1g3HgMWL!F%muvi9I;lFAfS8%l`;^%Mz% zsM*NoE#z{uM?&B|I5rxYCsmdxK74bRd8T+5v6gBcOc*dK@Sa3LkYk{)smc-NH<1!C zdzkm7H<7m8B{WoaV+@-LqW4xvTHUu+uV}t5ZPEm^}vZ(7m$}eXWUbXx@|iNQbrj;lbuRic0&?TDqH^ zS4%VTBLG24mA^3@j`KgoFRjNFB<7LZ+hQc6!K^GJn^_uu|2>r`0uG8bsoaAlc6xWf8 z%s|kv3o0bm|26%nRVh$jCMR&cKtm$;@)=&vo zuJ1xF{g#o0KIGISH=@Ps*iJ~BX)a3g_rQyseRQXLMMAmv(L=d4)+Cy_sbv=bN7k!p z2;K1S+wI{Mk27olvE2Oayg37Qbmv1e^T3_&;`k58$E7HIIlHU##?(JU{_7Wlh3aj6 zm^nzPmN6+|bfr%S+Jy(!#D`lwuN~*&e#3;X)!e*zRou2Jl2siHb{1bcY zcRttKm797a>`pWec`Pnj)LlLhS3$~el9SYUQcPm$pplrkxnMEol zNLu)mDa01`rGJ-B`)d6 z$TEgE`QDAJdCf;~U)Dh4_^V8>wlE@I=S^#F^7P2<78~5J@%o~nQR&~Z_KDX+ zSy=I`@&m>-rAzbHve8*=I~y-)$9K^*<=Un&upk@R@L~RnVPf;p;0y1wjcv9RByaMs z?tWV_vh|7`8D%&%xZ;28UF4l2PluLofv!>^+;npS2=Dys+OWebC8thg`e|&<}va7gYBJYFY0#+;?F0NXy%r+p{_7sgVdQtGWAT?j$BXd?|i9vkIER8jcv({QoEgb zF%8$e1!h2A5sp9yxR?+g7lpsVl>2Ntk4#I>lMaPYd*ibE3-$?uVvlU@;g?C9YdXCqAh1cly@(tA zhV@b82wgDY8>qVAbx7>UPVjfUF`|cIANeV>YT^1v>?3Pzg9lA>W%%XChqW>!xJoS} zPs)C1C(!B6PV5EY4)AYPUEoaGzrQgWI!^rPq;n+R%(+5sPwtD4bGPCa=}RXDU+r8} zyI&t@PA};z$4~sA2)9x=etgeY4fSV|D!k%9MS%EmXOlpUq~P+o27iS{Q2_9)L7NGF ze<7Ntw%JQE91$s6kgH0h`uLpqON{-O3y*g`yRn)-zShryq{eC;WH}?)=pO%_i%1or z7KQLvc1^f3bP8~?M|1Kff!B!J8TOaU=k;xjJW3HjJf9U7Kjx1?L>_eKTNM7i7UrI$;lX8V}bWy83YmSyC<=4N#9sQ0X&cPf&z^4L|CF9Y_ zz9~YKvxoJj>0B5)_-Px*FI88&w3!Sw?O_V5I#qff9Z+fEvSLzsnIK@Gq3n#Q3gSF> zKmUfh?fAK`9F2z`19IXcvB*UD;@M7!>pN01w=gokQ*HF|KGZ#^kV2wB95Kr9m@&%R zH)E0YC%@0?6vB}LO{Ys7b9&MCW;zK{t!^Y=7d3s6UB&~ew5p4vKQR-20#C7l?Yn#H z&i*>Q<4CotUQF zGMiCB*~1uApC(JNgqPcHBKBEzTIR_(F-h51a!2+5ZQ z&+N0qMt>%j5njPi{oYRU7J3;>`>gjjARfIX+FTsExIW#<`~3Dw0+1+j@f3>VL5Rq= z$({}hM8Qln157aPn#1M9;kp8_=;tcebo6atZbm<%z;kB8jH%1g@M$n4$}YaV5L#B@ z>+3bowHvEV*#I`GdVpaT-DdaMa&lv@rb3_l`}syh!C}VN@&E=YFSyKh3jwuNHwI0^ zCc_7$`Yvn?D=|{Q=%?JcY!qS5qlIgHf9!Y6hTnK{EXn0_FV8zfBn;qD>J3QVc#8p< zBZdg6TQhAi6NOT|5Bo;!B0LL>qxR2F*PoVkX9%BDMxB0~bb~M=4L)?{^QbvMIY?0}gfCkXzAOmeY-RxSKfJ*O+!f-M*He_h@0CG)_-V`N=P&wS zpa2p|TZViSfmaS=l_y|aw5&q$EaPK#rc^-|NIqw}cKmuU&r8|uuNV!HE1n*}+#zwq2#ogxhhk*92 zQ^!I|xY6Sw%7|QU{X9GV>2j6PW6$A0Ws$~n=X2isM>B7dQ7n><`WrA%od_sb!S>OU zhHX%)X2X=`VJ0SC;94aB5;^QO+sy@;vTOt;`YRe*ZJT93Bt!Are=P+|9<|W zB?=JlC(wunyWDG1Zu4;j{mS7_Fuhfh&zUrbLr*x;kcDC13N5b%1g;hJhq$797mjxqn!`30w|G4D-A#||Hx^TJ? zLc>V^P`0{1_!qvUm2U$cO#fX7#vB-mHFtYY#UxMot-^o!tH!V3!g8Rm^TVQXzPEzSYgv64DFeCP_)gSFWPPEwhfU<%M9!He1(0z~e0ik_Q?fM43y(dke!flq zF;)>tXuzYFMOhgLhj!v04{f+g8L-()i3&uj!|StS|7rc;H$b{1>&?QPEy94ciWUj` z$o=zE^e3C9O_W3r4y4oehM^B0P%k7MIed5usDM|h=@)+s$I%P&%YWg+uM*#X{hxo! zAO1F45mCU2&o?Ma=r6U9zbC6Uyg2##fw=43+p=K__iI$>0G{bQHd3Syt}N+4KAk_F zXnJZeFUAni`6d-Q#K}$GY-j&tNdNP>@5e&;mGp2Wky0_N&YNp#g`aX7GjoBXh;Sl8 zbWDe^Mb#h@_#NTZ#@nV?5@M(yI7F_5PeGxP1r&cXNQzTUPNIbIei}I*Ym<@R zRmYMD5)&{~z&ddDs3OK0Oa`ei_NHJ%xH$4mN2Fdl$M2;G|IOt=MLyuub# z60)|3Y%;*VAj_fx2EAf|^-}bOn4D(QROGagk{RwDNEXHOl93bTbig1BH`sc95W5U6 zXCMs4s?QJs4XL*8-^NA6#Kb;)^*W))MFY$UXYK#AE&mw2Y8-Ba)E-k7O1R}|gdtBc zEHV2$Xgqho>)W!Bv$M0n!!~?#AnQVo`xPY;B*X(DJC|}_Ov2=3J+a0#h&c?O;=$d3 zVSSB)0OFtyYw)`DK{<1Lp_-rVOzfF-o@gPBzn^3GzR++8@RcbD<_{GtP{7qH#5=_P zyWsrO>sHqZx%K1Aa|5LrR-FmwGhtY?NbqvKKDeIdC6vFo@h)q9^(Cz)uq6zJ2pU`< zj7+~Rz{Q2f#DznhQgnlb?xuc`;d!A?6r7VuU{Q+k(|w|HNTKcUAo!FMR9@`H_V|oS z()yp84hSf|iac%qfspa&8-wz@vTqD@u^F~SC%-bFyNt!HrCBP)Fb2Lpw3HJ`Jl?A+8{~@K0w=rlaop{we z5ev}Fwd#3vImc+5Af=-Jw00Z5Fg3q^ezZyb-R%mkM>0bJ29GgBIYG@Ggns*#wyrL- z)C;(Y<0fac{&EEqtxj3XgFn!1R_CG)2M`ZzS)b1;;_LU9gBB1pQ$e;cFglizVn_db zlaog?Ve_!PWgQsH6pq0UobJuhG#`OX#t>R#Ht|B{4VQAX6^QiV0GZNVp!@s@&KE=3 zXK-6#9|(@{{Ph(qCfrCja^FfYh?twv#S>qRgeu#LENPyU-wCI;4(B=Q!-@l)F9>V4hpD7CPOix0a^M}@i&-P{>alX z{Hi;B_V%*Ar(J_UT@{8XSkrPy@Gl?Ym|Pw@N+MOSz=e80;tPOb7DV2Gch}3+VlL1x zh-C@}Q?gD_5YlHRVTDVm(shV7IGw7t$!oj#2Wzz5>^|U;=ETN&Hx?eV1>u$|jtxvUkiE&+|LURQqpXL1PL8C+n8e9+U<(Bl@ zW1rO+lI207t+fY89H32CtyeIpjO5jM6nBrB$xC?*_Z3hD*P|C)A}-=$ zkens|MWyQhmI8M69F!dlCk?gSW}vTL0sVc215`>M+u~0qzG`hHD9ey2(hkB*x)mW1 z#+IT&DAAAg39a>P{Q^CosLwE7Dek@F+Qdb3aV?hZ6$_e<3ccr({&NoUza#sQu=YM4pwa{OH z+IkLYHG%$ZQLQf&RqOY1Q8vp3zXD9%crdUsDdLzUxO!9R1}NTWk0?eMfpC>zXoMAOzBaV-guovCPXpqOs9POTJT_hr> zK}<#f4zi2Xd8~%4^;$ttuIKHIey&?~yXVK$YICUL zsjf4>&NDbJ(uG8J3Dw!1dU)&PiJYQOPxW%b2;NHX<+@;27c?#A=H>K;(JCuOPfZL! z!hi?p;ju!dXW|_W_-IhDMzYHb6A;F8!8AFpOeK!N`(GCZM64#dp!%|gqoL%h(CBZ3 zX;L07${g0M6kbr}Ag5(JXkB@#gk^et->G)gXSM4&C*IGGvOw4J-2H%z(>1XD4C2ALeKQ-ppVof-{L3FYmz$5A3FkCde6tFulNZE1mPqk6N zl)+fO`GzL1RZ09)i;>_MwAqu+`@dWYM|(uhyjqFLWgg8Bf_n3}tEXQ5Htn)H(iEb~ zADtU~`ERJeEu|e%n6P%`3Gl;`BK!f~A$QxOyCrz340A}4)-I63K)}4A)^)z0U-^#a z3Rk2mySF}^+)V4`*4*@}C1%q(c3*T9<$k+xX3OFG#v>f%h~m(z>Uv0>-VWJ3@>EfN zOxRz&e0XG;=_47>Y$)sJC7Y}}8Mi^+Z_&WaSX+W9_;Q07>~g8w%V|ogs+s^4Bf`+f zPu+N|e}$5gGT`l*^73*H6`w1j5<-J;cJ(#(4`YMNI~ zycnGaNs(}^TpxJqnfIxKkB})Bmx>i9|GoIpXQ4BFYF4L5!!B3M<-j1Iucka$_hWyT z)a1Y*0Eh-wtkw8+)f5W!UZ`Yr6a|wQg#;oLeW0Tu3FCPY?vaI-&>L)@TBDdoPmR`u zbKv>(vvcD3ce6(L8ivQKH=0})+XPF+g+n?>2cDYVzIU}FuAP4;^Al&LQfRCI`v43f zgv9^qzQ>>8r1Ktsa+t;9*%*I>o#g6gsIg=W zZre)Zp={zusYYtO|9Z}$81R0=?b;b???`LGgKScJdZ07??6c#K9hqb-)4yH@6qDhB ztsSggZx$wQ!ioS0!Bw?etWnBEv$5A~`QzOa)!j{2(vYlxQ{wKO6oge=95?Am;5>GY zI|aBx+#@&;sDPfKk9v){ok0kkq!}JhfR!!ad$2d33b}sfE zKW(Q5+Rc*HvUk3=Whp;cG|=--M$p(~J5r;)zWL}cH#J3WbhBz$cupTxr|nP)`rx%a z-Bid1#GFKN(A^InBNIL@b~W4U07fpiJDr`4(rzD{vL~`r`77yT-~y!(cGr9beQ*e-yiQ z#EF24mN`P^Ccx!y+#|CC$yL!?p6kXFE%!(xZ)RKgbFMJz6=K?FbPTK=*_UNVk=-O8 z8L@Y_CR779PFz|T`DRPF@ygy`E>a~5w!bkX`iuO|>Jp+{XgoeY$@KHNH^ghac(mv@ zd#OgeeP!XoMsDDqJ0o_gBVLp3&Y~E5-g2Qqkrjvn5|O8U()7Dl3*D!VAGSXHs}?k@ z()!jY(N2_9h6xZsq#8rfZ#E=A=mBZu#pL`rD)}|!X-NmyQiDANAy_q{uyb!S^)+d& zmwA)6Apz0SB@@=}%hNH+dH{D6SfP!6;v2&>X87!=6V9Z_*DwN+rVjEc+>m`5J!gtkyEks8OLGyH=e1AD6FkBlJESPaNU(Y=`|=~piR`jb(J5y9>Ied#9mq*{UBwfX)6 zU^O1`KVre6j7(7))<*H*)kdCdj@^OMyO!>h z_4Db}CMdn9Sw9a*g-+K3ZB?V|XFcd}fmizdyPWSGNY8e?0h*YkfI+xH{u!q_!Q2p3 zEFuze?(70RvB6uUUjRj7Fe%pjMaIJX5aT~~j$7K4M(V4BZ)pA9v26|+frvrFm9wQ1 z8l7WC-#+x7j|uirVk4J9L`qQi*^op6sX!g3tM!A(K6)zU@LkLe4=av(x1^oGrk8KY zAh&bn_$!wEotqzSrQFtd4Uh)IG>co|iaTLWbmC>OCWIBi-^)-}#nqzkK?n+BN2vSr zyC=a$^DJTLP02KOs1D35qaKL$rVxtc5{o9`3!p?uV;I!%AePC~I*YoP zdm^X2*+m6#%&rszNX2*vSvgd5`5Q-DW78(?7GKB=pem^J`R)ZnkYVHJ_bAa+jGG}> z1PmC0ZYi?y2QBW|F7Bk zZ*R`%9g^iaiI%>6Lz9rSoo!R~QPIvjs&r0OcYB_{sd1HEE9Bl=E!6k%j&V5OJK0QX z;Yosgi5#dixFOy4J?DZgG+0_^b=BRj0OBQX(~Ugsl<=}C*niMnlNJ#PsxJj0KkA)k z#O5k4)3UyP8EgXNRxa3!0qGsnFumpo#MMGKwZ*d=<@gkuKO8E?O>(Y#7c*9cj zrwqn)mfXB!I2Ay#dI9~YmhCr%zN7xejUx`Ic{05meMk+Z-o5WgWxw`YcubK|X^L`z zTm~~KvOQGtfK($j8a7qFl5(xW{`e1XZs6Ld=qM!;;G4564NFGR&d}a&Cy&iH&*X>3oP8yW{e5~T1Q8f-3gswq~y1#VP_NiFxj$c~pW`#gg3@YQ*nVljX)=K=O z(?g!lvFXD6b$cHYBz0eg-xGi%&G+kp2i8$`HfQnwp}C1wFs(EFvo$9w=)9O=*F zO-;*@$1lkNUj3N-y9vwib|&_nRr$Y@VEC3eRT+bRY;({4Q0Rd_i1oURJQP4dU3a|;rmzlh{G!k0&rBvKwaha zRFa8fa%)z8T>L@*U6@h`kp#Ph$;xzLKim|6v2-%0-u;|E`cLbvmx%FKm9;&ebq&cP zD^-|b<+MlJ>c$teve-fUWA)Wa?evAGdnUd3>$@uCOdfjqg2%6mxVsIxMvuV3|C(j4 z4G>9dkkl;HS^ad{adfcA*PUL~gc`m4V%O0VYV)UZU<5DJam26ru z?puQ2hyG6WuQW`(S=>VLCWs4Prb?q;atEGc0&E^0qps>NGuzB+IR66(VzPs)8pKEP zFK+p8)~eGcoHX(*F!}yae+hbrlr9r{j8bL3acQ!ZXADMYo{2#di)XG(cHLBVT}>~A zJbb_PwVJ8u9x|4}(ibj( z&%Y#=+EQ+uyMLPmCI?*ILq4XqnuWooFyi{ZUeWzV~L1 zkrO3aW``!~2SSlH=G=o936-A#N-Z=vIo%_1Hp;(nOX5&q<(C5vmmR~zZ?i5_Zy752&d&l-8b|x!6lVWmj0fJ7Q15nR z`NhHYoDS`p@e>6m%Wwj2GBP;?artvj60K9j3mWT5wdj(qy#|1kcqYQXrRY-m)%=o0 zunQ%?bl`B68}EadjCB6gkp8j$g=t?nAKuU7({v)$NpAML9{K_F&Ouybn3o^`g>OZa z2gsX3bLb#)%cAtXG=iKe=FSp`m<-x~hmQ9$J)4`MHC#0bv~nKfCKgTm#2WFz0n8G) zodm4ZEy?q9j=UyhQ~E=z6XOI#^1Y1QA|eu!n6_Z{{SlL>CPVk9u5P0eI#CzA> ze1Vt}4Kh&Ky}5YKi3myaZ@Tw<)?WW0k-R=gP~aQ)b?U5}t>zW}xBP~GVEx%~n8<`u z&6}Ce(Ig7w9{C9vs-_!Rfs6q*yl#3Dz4lk$#`m~fq4R>iudcG zwf%Vh)?uf)FWOv@{1vz9X<`v*pVJJBJ7e~%?$RHVmp53q)?SLsl@5oDl;8a!{gq}J7p$;cBc z<0*29L7X`OPK=_$WOV@1#-8s|OWnPpCz@nd`U&Rh2DQ(%`EPIlH;IsS7=w9eS?YZQ z5iSJ5w~D~R?omD{+vN47u*1m>M1cLs1E>#VVMpB(Gg#7X?9CVe{a`Lj?>A3=2ZJjf z=PK2-U(pwO5HG3d;WDFMjx$K^f#k_=_SKA7d>WwfPkSO5oRm&-@F$H#13S`JDqO;JLeDytL zu(WXn28NDC?A+!=R4@3AgBa+4wftJ0rjEhQFb#IEh_-Ez8@&4}f2P>*8!7%}|p zI*7mK_GS~x2IvdkvA^d)BU!w)H93Ekl_{}RqN_Bk`|&U^T&LN8)W&zhEO@a+lllJF zXGS-l@(9W8%w2=povC_t{KtOl!!hd`gC0mU0J~fV8HPeHik^FIoZ8^NCvR}j(R){J zN&lYpFVEuwg~#0zu_s?tSaltpeO7(();^DJuEAEcPqA27X z1#&fBA?fiw+Ch=KFd6?XJt~B_dk{qNscPPlDZGN#O}r>aER=*q-5%-6m~XA)n~-@U zoXH{&(cCS=iXS`^jDFb;Lhz+r1=l_T@DNYeQt&9%nx7tvWBLF;yU0|!MdSJdoNg`l zid**$I?V(@-4~9HX)$?2*B+=xj3262g7v-2yZg;2eI_^#vZ#Zjt*5C2N?-tun@fi4 z1U{tgU3Rm!c$Ob=5}cvg`VIbHQT+J1!SXB|hfttJs{C&=}yZiX6>zu+PBg#6;V{sggdDV{rHiaw@wE_a`s z?TfXGSeC|(!T7F--oefJ_noS*h?>D6uD3mgmLbejw%N126X5XjTNZUwZjDV+8(N z&^8Enhj0-qknBHZcyHI$Plpw}Bx)hIw|dUf0H*cUI!^jN1WIXvG=;^qPJb+L)#{-0 znI`Y6y^2-%IY;`R)>rK^!ua^!`K+r~8;?hHr(AYn;F~nKZh@AaQ4g(m{#aDIce0xv z9Vw{IPLFoANmoK1<34+(g~T8S?3V}~@5`6BFKVrk87i58?8^z>NzA5ih$Q}w*rC>4 zd?0OM^9w$C=!t8kp6NRLB*{&TU_KcovmRm)PO%P#A{7a!(?`Pmh>4TwJLp|*nH{z!Rh5^UAk4jm?_DcNO)Sj zz_@pD-R;mKiHz)LsnB|tvEhr;9=k}{j;xh!=$TGGkfbFsWN&G4RCg4tAjG>fY(F(4y` zUZ%on{02bfm*!;o_i)j~apN5;Alk%aLTVe|5URJYmgsQloAUDSP`DbxYV zqIqEmN;FUxc;Q->kgT4O-&;i~WYZ2liTe7rBObzCw+zoJV0E+xnzzZ|Pco8}^HXZ` zKR*Da5ZwE-_L?{A4CU@TcexSq>Si*e8A{5UW5WK*NTzS4G4`7Bx?egQ8*q8D3`pZx zP>h>1f`TmvI`{(VRK1!U0i*}tb;g7pn2dmqV+W8w4eGXI4B?D!7M}DwfCnRri~Agv zQT)llM}}RGp^kO}fkv-ae{cj!pIWGpvjO+xALCUL0_jIX`o)W*Y7{K@x$u60KH%fU zA0~WtrT4>A)9Kxnre{pgYmrBlM#ciTgvN09)e({M1!uBk2A&Ked9q!TXSsFEP8WTA zn)-t?Pv>a`+{M2UW^a|%VvZC$43;SX0Ly;!OW6W}FW&;E6A=mIesN)vZ_TgMVez?r zl{U2TpQu|8p4*H70cqbyZ_lZFF2a&u7=Oe@YE8genJo5*uNw$g1H+=g^E*L);|pXF zx?!T5Ad6z22wmERu6_p34i1`T&*wn6+6E1^nd(Q>zq}(S=tCS=X+y)huby^s_}s)j zKhI-t+%x5Am2V__xg^hHz}Io_qTX`PhHK2gW|=C^c|ULSsQ=5NK>kZ=pv6>Qq>NNc zM68j$2*e(GvJI9&>I$xh9YR(eRV)UkW0GJwF}^-OcE>xx(QM&;HQ*eVS{QGAgrv72 z>x0u!#p}bX9;flWihKwfS0a9IyZ-!%!BnUVy_B!`sSz7yDw39he(jQ8!L0_W%VurK zl~wvhV(1~+n|oh$T=qv*40;%xxSwa{wY;VtnI8Dkb7!VS{zu@D#bascB8gs*m%4IT z$&fB%X}oE?lL?t$T2LJcbYt}~VFZn(s4{W_G8;p(DX&3bRkc^#Za2;Bl%dZ~Jf zmgO6o+BknNwH)!=%g8UEoO-iEXH_ogWIcIeaAf?hgchAiM-_~p0G#Q?hS9r{)R_0nNA&rC3JBLXdf=dVmIYdEVV?ba^sA zWRTz0$#kh+@!ML%?TYwP2@=q;F!^slI{qG9JuEU}&Jm}kYoUU!sa|2MIHy7}rA-m3u2iSp@v71j}m z%C^?Q5qIj7M4p27N5D2{wiNGY|E2{60||n75Ttaiw^k<#-rXE@z~uY!&8<=kLkBsM zP4;-%dE_~m7HQm*AH*HHPIPv%OdRm^Q(zr;X8O6J7v-hvN3e6(RHz~~6YutM@$(7$ zLeuaZmDj6dy1M?TZ)q|w+8#FJH@n6>9-t2&j_k|~y!Kvti>K5pp(kT}KKT*0?pvnh zN{t`%9Fc_=ZNGR+(_bN>;T7PF)5T33>~tUs-Y`d5q=2~+54VEwDW!hVzN(*$?{b3u}FSY@ZsSM!zg#NLVRu7@XhP)Vjxk3WY5JEoWI z$0EExN#J@lAdiCg{2;VJp>T_*H7dP*M*{{Bg81=RvLs^?WVdRM-mg{zIIiiK zt3$sXHfjtWxUYemFqjOT621M{Y@5feFLBU)qL#u&HZ3)#jKFFI;p*d|mq|xe?T`{_ zI5@Fyg*UKaXN8NasL^`2m_DoHVp3Y&?ogmH-0H7jI^=FH6BfAB7C`3A(LQn!N8lh9 zK<8uNb0E>Wh41(3%OC;d~UkmU@1TI zi`FA-0V@~8zyrg?Q8)84K8Ce$k^%RrJg2G2FsIF{ukwynk3nV24@gJRu8MvL45D}; zqK;*%nSH#5|Bch@#)snMunPLx+;1jIBYw9$fK)bivKLzby>WsMoROEP{RhFJ8i&-A z4&;6L$pO4cJIx>biG88**legX`z4Ezd`R7PKPSCnqxWqz1n0jn2$lw=?l5maN-&kP z3}a9Lf}7EF2tGjV?AFpt;IZ%#Xnh-wzJwWs2_OK3LF{d!m-z$y0~eI4T>JaQ@mL;vL;g!y*^4Z@a!LoVK36w)F5mvh18t_*xw$$0 z?cbo?Rg#tu!%Y{mf;YLwL}^Q)-L417Q~N{SsQCHUW~H++!UVg(3V3WG5yJz!G}nj0 zZmz(jx)9fsY~nuihMB-B?c4OAW)#fty^7ye7t++yB8;!K4_C*WH;Oa)-ZQsEpb1O= zp5UDdBs)~mdz_Ptyu_hQq-js@auoCjP+KpZyavmz*rkuK6NZq`C<-(-lMeF~imp_A5W~SEAwX|0en%VQ5F~ zdw-q|J5LA3Bo2O7Xk>@~GRF>C78XZWK)jHos65ej3|8MNd?mE;znHc_6TUxwj@|(U z4D&~C4kucJ2Y?<3_Qz9w{@aYi1=4(|67+yEeY)w&OR{8n-xn#jcLVwLTe$zHxj-H~ zABbjFIgO9iNX9_-s~tFb`kr8%m~$ah5uw`(oGc#TtO6ZF1(Jy?djHda*ANe;{34$;a51h8tax6lDlS5u45@ZC3t{*G1rbJ=r$J8S>@89-3o@G@Hc#(Uz# z{OeO0gsB;$KTgg3-!ueX-u`F?3Av03pN^Ypr% zuu;q>Ai$`!NU9%p>N7=e_P4Rl{S1qQS2h*NLvOCT4;jnVC7w;@)`|7ZdxPwe>-9U*Dp^C!;WZ&-#7Go8jQiMk<{NFrUu&O+9K7~M|uBa}gXCNT7Pv(3H zPXVMm#-82w+(>{&YlJ}36Y)p>EbRW}HHbnHFdY}r2ORT0+VnVhl)~ihE9P(HXxBPw z;aW@>lZY@p+=rk>^5%bi`})vMktQ?XEX`K6h+Ta}0h65(1UEjH7D`@1i^>X^TfNX- zYHw@9epO2}F28#3e~lnQOv0nPjW`Y*?%1_Yt(t`CNU*0DyAuuj0Bk|r5v*bo>#K)g z)ocID@N|`cVkjQARwvNE3DZ53?wMH|1ch6IIUvl0whdR?yXn0+1n;YN1Rp}7=1lTu zBi}y-4c4Yulj{}PV>@<+@Sy0-IvPhdI;uG@$p zc3)5v1T-THXAQph6{2D>xCt8U)QqC~re_k9_G4gI>D9a1LZh;Baj+a^#+mT1MxTE= zc1U{Fa7)ZwLtdW&jtu!waG$xV+YNxgAx0itOhgc+6eS(LO+6pm&5P4TN1e=|`qR_< zmj~=~6uvP^tCOY4k<(rZe;$aDZDn4H-qd~U#o%|-mmTa0?V@D_orAo zJl5LdkPv*QQwEtP(FasBrPJ;n`_;pypi?`8dspLN%5Pj@g-daHR0S>hAtQ#X8rQGqhO^6$nZ_On zR&7?h1b*aKa;OGeNYGRRYg2u{j23r)D`F&AKD57x<<1Rfk?b~2`5)g1K6&W;x{Jnd z>b&W3$%!m{iwh@kx`R>J)mgYc7hCjywN`vGuo&y#E)i}fhzBmq6h>ZLOfGrkN0nc# z%3Jt96))ykDZnAl44a=st8bD7-Mfh^ANf_((3$uhP`yzYC#VJ=i6Y!9wkBx@R8!c{ z?kvBG5JhSTsq^u%r0|he+;D7&o_}xzuhvK0>iDZX0doV^E3-haf&)G>oN%b-+BzeU zwqE!_hhHre#owY(gAqP5CI;><+$kY#Kh$|zN1Hk*8#_i)VgyE(I~dshT3dLk%C< zMp)^8_i%OShE)Hd1@MQ+|NU9`|NjsA?+^Mio>ZLs-0*385#=z37>BdZ+DCbAQSHf9 z22xBt!*q3=&T;(W)qUM}XPS4Y!uwY5^9u!L)>66MV$PjHrW+56hsy+(?_SR?#iSRy zWgEU9?j}!qZdFn@;COzV_T?kgg%Hw?cwv#QdC6OH6Jc(h*01Z2s{5Lhe9La<`||}v z1ltdBVI6z;9|-~(L#bX}7(pH5>*B{FqR%X~Gz|QnxVDSy6=?`bVex)~CUtLju{%*u zd7^}Q7M>L+o;Q{B>f5l(_9&m!Yf>S$`C@YA*+=~}-s4rVjpYSfoo#JxHJ9M5s~k^# z=FoAb=h5T%;P_6X8eSgcc%x0Cpy_kL3Gw!BLF26K{sKeE+@$3nHLRxApK2m1oPNAW z@@#0o<9}88LHknT_|nZAJ!2o&SKpGa`#ibH$%AO^x1Ah4Qgd^h%U<%Sx>q_+SbVhC z>G`wMEu+D)V;D{W(bdgn7qcfHx_OVw`o!&t-cjt$SnfYkum0@F|6}hxqnZr2by2Z^ zihvDJq}TwZD!mAZQlxi~u1Ig8haRK~2na~8f^@DgEAxA1d*(9-Kj>q+E{y#oJbkb*XwmuOTE1#cmL^nnV)`J9 zntZ9X?VKF8TiU|-e%EAQ;Z5S3ei)Bk+xS5C{;i{Zie!-l6a+MZoUs z+kjy8Mt8^C5^o!i8-J~g7eAw#j43?Rb(=MvnYC6}i;vF%OAhw*@(d|x<+5h0$Q#ID zWBTX=Pf6E#U^tt~VUae4(Dg}#+!b#)7;!>>61|Rz^v&hJqa%uE+P#U(bjtHolP{l6ng!$7rsx>Y=1#lu5|I$huY^aZB~~cT*~eH@7m4yR zJ|(F|u&l;!JP*Q@niTvxcD4IRP4nJ=+egYTyDU}BoAOV%95n_IoyhnSK&U3*0i7Ff z?R4afxV~xHex` zhtE+jw`K0(JMr2_S&E{j)9{9c=9^s#YZFCk{TvJ56i2WZReaQw@ zt&S;|g5sV`l2L9XkQp_=g^jFUMRUVa!_LSSWGg5{$m>d;0q5xpTCsPfoVa9Opw!8k zZ;a>Gkn{z&F{Lr+HSg1U`2KXRpAkMwuWMVd-9I5I^f9Qa`m3|Zp3DB5_2b7p_MPAm zN6_WvT=HJrHIhhw58pDKKfNM-DDbYfarr<5e(HO{erX~uF~D$O=+OlVS$V%j?Hl7l zGv@`&xzpFQE(;c+47h~QCLv3qf+zPGYI*$c+;T0p}5Fdwu*BQ%*Db{PE*MT>xJB6H-L-sQ-p<(_IQZEh_6B*KQdCcMcwQYx`M?PKJKt8WKOAd{47mC zEg8V{!M4#|D0dF4WSMHZo=@pIB1^g42WrSWJIbSIp_t2G@3&t2Igzs`=j0aRoT__X z$Ul%0Ta|9;sSrYwmYQ~p*n#E&_oNzZUL}d-sL}LTUcXD<`GO$|%^@bT=d|BSBzW8c z7d*FXxC=1V<{zo%k&6CV+i1OZ>d+xn5&(Q6&kH$`xsP0+?FbYEh~rqz&#<^9*%y8< z*~LID3-)BH?U!#@M1VW@3c8iMT%&AJjBV|CC<-IZiXCKO++_mCU1YjagP z{PSZi?UGI0osrAl47360p+NBCYD7L?)q~GiLYYFd!kOxvojxkLSqG#af zyZ&a28}r@1{g+2i&2pnFBwam`81Yj zMh2b0PO4AZ(b&z~hnrqc@tY8h zCKFdHRao=}0wzlXH2_A2K>OS=i(V8_tHSCHrnhyg?SqP6x4hU-l82QAxOHfZRXM0b zom_?8=lzPO%k;EC25Bw_Qu=CZ;NE)mQazs?U7FyaO6kBKMCq7yc==Rd$ z`Lsc=nb{{f6A;VKDCou&ht$AzUrr*B!Ur2(DrU~(LyHpJ?4O~l^j?Othoei4llOLK z+%W+b2raMDSvUK*CYJekRGwF=gHq0Q8tacfj!~1Mo3Q85V$+Tz;P-p{m&jv81cCUW zP`j9gpAGJyS36y27EsJXbEnq6Oz@7i!4Q;j*^20t)7w*Zs8Q+ac+;9Wgyv}Tuw`gH zi-lK%&ppnzRZhRD-mW`MnViuLtiH7`2_p{g=!XD~ytl1CV6aYEw8lu|v4_j!yuEZY zn}nW*0h=_BE#j)j=jS}vu z=iJ@_Iy2+(hzP=_S|%=8`IRjqw|dY~>F2GR^ZB~BG!fSE{v5L+aukA}J`R~Bp;r6#K@=rQ9$_EuzyjyYG@u`uYOx}4mQXOa6 zRKGR8w^nU9OOn}%OyTR27{0>kSMr~Q^lCPz){lcn<4dnoG?a8!(Jxob zG?D2E8@TBB3AEx+U-B|z$$R7K5&Q2k6!)!lf+N=X+?o{tlvp^nf5p=3SXY9}+|gjT zlk`q~z-6r36;GpE@0;V?G&LF8i9kPG2Te)MzG3`3aA5_2PPjB*0q`@AfHVN?2edw8 zCTz4tp^9}jk2Xjs30=f7<<(_hgAqvn1mxGmTTIL}ayNG`Sri(*!4G}LVX#%nODO6w zUVeRT4SF~98Vr4o5aLD=F%C6C>9&tOATr>X^!J!-KnzYHl?GWfLM|ktcNefS9lG!L z^6rufx!{r~ZCGg2eL^eqJPjB}ZO5>=( zp2I~o%}$e{7GCeqdENF=-){#=beG>RACmJ~N)+juk#2G{4AGuEI7f~=+Z^qz!f>}s z&5#A`+!oTI0U7dq)Dmu5fNkYp!mNqMT>oV+Vt6PBDpb~3m|+GQj@ zahnUePt>k z%TxSAp#!4bNz09o-d@m{+gmL^Ud2->=_ppt$q6@GCp@w5<7xQijFs5bEc^L-xc2$d zw${&F$yy-|+7!Pb_H5&A&gdO|QNCY2-$!`fF4qMH`8p#hSiZ+h5MtbTbKb}MF3&i> z)VBX2g=5)dS&MNFKA+B7r1;u;wTrt8>h1zZ6)7-Tfg%-TWP(L|JP=iO*&33FLdQER z1hRL?I4knpPL6EQIHpnKNFi-~uVP?q$E)+(+V)nR+Iu*RVLtI0j*PX=gh|ElOUa^a zrQs$Wo2^-{4~LU=Xb*Bt(|rcrx9L8P&r5&#($gTGb37lP4WCZQpd#Ne+9+Yix|VEi z!fJ$DY&PC~ftq;>?&u3cH`ksr*>p6RZMRSn@9=Vtr1W_iTAjTbkt$8xo0M?AV!uYn zeb+ZQJ*Z-5C;w8#K3s5Xa7fcT&&nb5#Oj=qLylGrVOYDf^Z20pW7?6@x1CDK2-4A& zpU!FM4s14VvV2+8YNHBd;;V9$K<=4QY~iyryLw#7<%C%y?pe{=f*^<5-%wU+C13)j zEiyBwa#{`La~Cm__Tz%coX-fF;JhRHZtf#?P7YbbpuNSi{N(y>n!{o%%CklP#OB*4 z$uH59T~$xJygya$2eH$17csS5ugigzG!7j?(KUl^<{_0i8sUS=cRRQ;TcScBTft&I zcR=d6*SB4c4vlE7FdygU@N*UWVo&n04=A+OxARgKe~`u@_Ew8X>ts^A4jOZuH+!Z# z^%LI};apCz=bAG54?G%ZYvfEFg-XG&YOy9kSId!+we=o5tr0>ioq*3`<=ac8Hz*dr zZVMK}?2P^@6Wnb8>H@35J;m?O$nxls^j)97_`GN7>o>;vVR;AWm7#%O@rPY#VeRe* zg6NBE&fm&6Q-|LVrW}o#>RRb}uKK7;Sd4^LcJ*~FN?c}JuCl)hIOlf1J4#Dl6c%E7 zYE5sZk6T^Wzx&h85BtCf6|k>~9$Bhnkd7enI8RrU&AW65SDIaduIX9fQXd|^Uj^@= z9I#&-;W=`M+-CK1P<6#36X=+;OkF2Kq{ZwPwo=RQdx@lJt;bpXmLOB#q)8w|*axCJ z#NHqKGond1lc#w*pzhNiwJA8!Sw;Bx4H!LdGYN zThzsx82v{kL&wXx8WAkT(l1Z%>(Dp7QmGuS6N=_y!cI^gG+Mu)vR~yuZcC0qPUChO z>G2=;#s<`tIR}oH8&7z@L?jOu@|nIN`?#@Zqrf?{5C$18iRH6hqB5H5v&zBmFp0A^ zP@ZJQx#{fHvpjMCVXTcJo3;)oZF$Ps{&0qjvxwU0!~@@Bi@PG)`lXMV&eupBRgZnB z*O_LaV-!r`AhqXG%do^xjT`c0dByv+i&_{d(UQC!bmLYT4o=}PHTLZzbf96Z_NJR7>iq_1?@|Y7 z${pY4@@JNK^_3A2%x;^j$zPrSkY&+(S_`wJ<_27lk7p%Z&ZkjjBbcsAnrzcZG6aZ& z`bI(;NQZM1sLajzmrj~J`~kj?@}7fhhE0=v_llAN8M4J1uqc$>`HLdbf;Kz3CDa>4pF?74|P(#Dj=_eV(qhiwLDqr|(`)v*PJ=qX+KaWGmd4O!9hg z0!onyB~X=pwvP}VmB8k==`2H5mdMPYE8>eU@=|?kXq9qm+<2pP0vP5UYQLxmMx_bJ zROw&beDO1NP%KBWrx^3NYI~*pEmc=leC9xHf`|*lnn(%HNB~ za9o)#o$>r0y8Kud$U&@vl2#si!S(=#* z#IeC}%~VfmIR3`m+y1K3CG=zC22h#~#P4N*p|RrO+?sgi$4j5nMu`21+7G`4pNXY# z`1*}^Ibdm932F3PKK(jZH@z znM}J%7)C49*jMn~lpPn+G71iqD_f#=kLX1ScamCM(hm(|AA3?*q4_bt_Qtu*KGq8! zk>Lf~=*BKg<=qgEug=x~dU-j$m_-RKhzt8jk55-jlj!iuuzYx1g(7@StcyWA83XG~ zc~^i6s8&>XF4nLcQ<2Ng#;_}Lj7LYAqh;9E_b^lrt61J9(3)7``?bQnqBY8nO%rL{ zViNe|T|>SuG*wG5U!O{8mEijA&M1;xA7FQ16Z*IWQ3h$+DtyIQ59 zO;q-X@`3X~3PLEHXFo&$5i$L;s1s`TytWPbu&KoN$(O}*%g@G89C1hhLemNUNVKg?K5bLzgzcNKtt@qa)PbZS^A!^!+6%#ALl}U)s&G5+0qfZ zc14w9(IVda?W{(z@EPfEa=D|jCtEwswAhO9uigf@Q=@kzN@`_%@S0yLCY0-Qf6%#2 z&jO&l!SsrC>0X4?`>VM2={WwVD?WGigX&-gg+`kYKe+jlF>$q{t_b6`?cwxd%x%yc zR#6bS7C>D0ZE?))A{TP`N4a2=BfD#VM2G2P!Td;xtv!PijF#t?80IB#XWtWjMtpyO z7Kh+*8?7B9 zJB~>x?cOdxxlxL@D4lhz!7bM{Z|CBm5=OhUrPRTh+R__~bXActEYEiFyg6@k!iVa|(aF6`7{_z;```kC7>F#jD$6h+LZq1YZD1bqP$!bf znBAkgLZ?N7?_$!bxNXRVs=ngd7J9}?-_4kx6-GK9C}!dgFOYY-7EbU()eTo{b#R9e zrf0EG7zIp=r@Vs%nx9U?K1LusIS0BP^6WzQ@SM?QbzK`P~f%-o}TLR z+$ur8g=tRp3yPQeG!~z-eUWzJiw{j~P4ksKLA9nd*_S&ViH&X54UT4OaOXTR1er<5 zrrsujZ1VuGsQ?6_zfm?ZC3mE|M-P6PB-xhMuzU>b6*)O>sW*Wipkb!XK(OHM?_YnU zzdS^XTK1tjcxl`)(YB1Q3_4_-c-yx>us!|((%~Itb@3>E2ZD7?quKS*xLN`R%;4>K zo+9nXqqKKadC6Q4VQCJ*ypNGMH6ucBH7?+9hCp`{5Q5IlF6BN1{>j$`THUX2U6YOa zdL~3*!Z*i?`Z*b%$+dLVC(h$?H|Pw1y!rD#>*^EJ zhCVTRu%h7~K$hel=UGWJ@Cn@P*_VVlSrq7lj#XzIVe=qpPNyu7>-7m9dKzS#yo4=5 z#+~Kq2LVHTCsU}qXeK;LfO@i$c4*t&=E9<(4q`>C*DCz7-r5pVm4BA|$b#~Rd&uUa zzMm^zz$2m_n_-h4ej}K{sOe#n@c1H0q5+Gi`9yLa%6T;*_V1fSLnn?Xr6^7K1mX{!+*FW5OjOv zOh}Epmt;*KvE$xz@82@o6)YE1>LQpA*abJ`&6-NBK3PXuwSAW`aM@>e zvTZUSG=&6}Xg^;k=#bgHWqtHK``)LPM4Edp7aJ%y&d4@~sn{{R#EN1*X^_8aFaS7O zn(hsFn%|-6tRn6qv!c6f$Ti~@>Z!D7U+mgbM_AK{z2cm_ykP4O32mGK!LM=@tDGsAFfSpYv6W_CDxs$H z%x!5WfJMq0oH0HeNXl=S6|iXmaijRM_k@#Yt?XM>F0b2+;Glb!M34K-N}Z?m)mGGK zjC~(vwk6tNMm|CG>w;(PIr^;zgq3N7$Q_f0XJeAMJtS>~o`y57-IvpnBr?<9c!N;g zC7KwY?U_vT)#U?RDSpryqJpk#ncz!XW{M$*kM2~e*Y^%uSB1A5E{pa{Om%I>hUSJ> zCY2ke*5fERX>ZbuuepV*5YNa;)}IE?jo9pkT=H)%$t4$E%L42N&+p`w9S6HgP?i2! zFTE)PG?fp%G=Z+i?kV|dn9cX$1)+_+BCOXBE^L9i-8aJ&g?$}5J;ld&s#9J;c6Qzx z<&@U!{+exT0oU9pb?O1AAyqH+)Q*T#;CBu5p*p#D$%FXGWx|MZyVOEmzzK)`n6?!H$R@~3V7euW{-IA z=zFG0pD_||ja{^ylFv{#vQOTUNDbI`ER8D_v7{ALi8@djg=HfYb|vgSX(;P6j?ldN zcE!zaF|9PXuUMM5{pJl=$JI^JAFj?QayqsI=tG^vNp_cCI#*}##fEu}d~9A|5j`$7 zzn3es0pe|?E0Si;J_-EyZa}+7+w9VfGc21=a=cQlFo0u<&Yz&RyZsyvZC79-s>CPT zdtayMIWMICBgxYE+hDloi6+EnTR-Hkjh6%$FZE9fCFy!fx8Zi^hk@`jA%?<*hOY@G z4N{?kQ;5eLdWV%)7zj@DS)sp657TJ(PH*m#(4D4yTy5C0XCL3m*nB%sLq!tT9qV_( zyqa1+)@WxL-sc25BDs5)N}qQ}n?6e!7t`j#h=130ZY=3@$qnYy-tu0B*`6~9rqI6OA2{qARGyU4ltHcdj*!xHRb$R zE3@x}fqleo`F6+Gp*gMd%`>=t0L16w*03gaBl1HQ6g}$>CgGGu-COKCUj3A})`S<` zbXQwIb?9*&3X6T=Lj#K#iB>h$5->jbXcZsLV}+sGm;KebNh5&qAX0)FMAdKkwl`!1 z>HL|DUCsvZ`&g_HASHO7lE5sfC1TFfW5x>hHF9P+1Kq5$+PiLu$AngPiY|I=v7+VL zy;5m-cI5`}#tpMp$p}O|Li)LCABpef}(vmLU-Z|m1y;+I_S&`_XA*bB8dAg%puf`#6ajeOks8 zVZdyU7sdGPGQ2PrV>Y%C1&>lK(z{O_iF|p7u3#hI#u?60?>A@lX0~N30vNtuT;FCz z9&I?ilx?vb+?3v;iAX{=X;7_s8^9B-gqudRZFd=0Dfd^>c|bAV2M97uaUxub`X|O; z&jZTIIKf*Q8l0&rIdvw4VVwMin;c7P^yML`4AG6oeB97_oOSo!a&tj|o66SrUy$#J zD#ZOr!ydFR)d9Onc1`OSMA@8geT}-t_c;lZp^nV7s(|3o27Y-L--Zlnc*ZQ2&x>J( zAr)Eb#9L)Or$_2?Cl#7s)0iz8xkjGb6XwcZF%TtqPj^UTCY>d(R&-3)P*w2tR?Q7Q zvEDsKf!4P=el5?|J#;HP<%Uac)}4`6HS?X1ObHddQrF`$pd*IdXkBw-cYaTv7`l&> zpTa({bHt3hA-?*I-AMc8+USaQf%vs!%)3#{u}$exK=;zADFmojv}^@Ldb~ZLuwfGI z{IekS$o6+H^TR)RM44KRPsoIl1ugISP>D(AF&(ZhFgNANBkZ~OG=B*ED1mC%4Qx~4 zO)YyfYCzV>`z^zKTUbiEM`a;wOGU!eG9pSDVel|Eud;LWGuEx|+8MXZ(Xmza(BkqF zM;#c;MeD-3S=GxjGXlbGUcF*@;)|tg;I#1)J@|B?;k9+`;WdlNutN8Mn$a&R%;>Ur z@cmnrDWr(|M^tc;#wXh?6}Fo^7S9ABz42_UKsL48ptn`}Qos7Z5`&Zce5NbN!k9w|%@3Xw>txU$zVzz#Z)?@s}3}ez6l>6A5C&X!zSNLc9+$#_WP*atUyR4Pg zbK-+7XpNWIi07bzK7qD+A6G#52l1(T?=EtfvNUi`bfhrxiRGcd^@rl4s&S+(bJ|05 zo9o~o#B=ymd)u(2cp(>IhGY1<%Ab>WbW$DtU-OcS&PU!G{)d5f9wGKlgP zVW@FT5n+=X#b>zMUm?G2uNiQaZro~mRcP!;HrrMu#FwXSw@ci{0Hd8Ak`wv;jI1)J z!_?fwKx`N1o!S`ly_BS|>~*87iU}j}+Pic8==oT;#YMNLF^WqW1mTUzJ4nLvrm7)F z{gU&Y`7(A`e2V=e^Tc?4Cpw^gdV5S-q1Mf!yTA@6+>uM<)0OeX`_8j%conz!H=2g3 zE8}=?-_|wEvDBf>P&ww)H_O+*#K_$G7JL|;{{l|9`rDbV*$ejC05uZvfl`${beS36 z{BR`&5(N`=Bd2$(z2ZSVU#5TO)i`r7tbHb{?{Qbga$_2wMV2=o<|SCW-zMvKY6MQy zei@dGz00r=G-~4Z==&Y0DI8l#!*W%>EAVj?4>Z0$fK-}@YvZkOBFKZ)=WQy||C9Kl zqs%FG!G2g#vEvlHt_k#i4m;BYG*B2;)8N26(|=@VCUfqYFolgkvGSCUrah43;4?_a zn$!2=j^8vmPg`^%z6{9`z8Y5ENUH@RIG~;PbH*9uu-t(zQMF*X>~QllS}cx)lI;7j z92`}KA?}3zLD75u_LSVyA{z&g>_Dd^JLp1?Frac_U{*SWDWoov?+b>es+1roErX&d z)AZcj*rsuq*$0coG~BzPYn!6A!hK)YqYNdpRj!axbc9jkSR^dd%W6;5j$V;FOsN>o zB9M=UK|?1^V=MKMU0(OKR+tMft|O{Tt3XIe+Sn&5x}xMPhq4*T3=T8T3v_d8G}QH# z>xQcKRfmHgaJH(I8!#Vk&Z9&_?oB`WTr)HF#f()L)-H_HXhta#F2mIUG5Ae z=aun)`n=&V`$;sFh9#BenGp}CyJ;}iiJ|J4~b!{Av0AjY_eLON|<2BItt-7sp>&YwLF{UrGBds?eg?aunhnwNFMvP842; z7LYRol*=HC;T2^!J-~E~WWk268I`(XOjyWPdL2TsgFO8A?84f1R@{V0u|cgtI(}Z) z;@Joj{`j=s*T}aX)Y@_5ccl#G@e3;j!L42`&605Fib>4p%)7EG(0%EZWqImHr^V^I z{ijY=QGIDm@-;bk^FAHMhMhuCJLTZR%Wcbmv#XV&;WkJGECr8e%?}cSizUJ5yqO4x zF|&;{<>`!DAYGW1QjHQ|2U7?Z7VD%(|9}sGxbo{=ZXf9NiSG{MAEeXw-yWWlL!wyz z!GXAcRb^orM)xUDgjdZ0V1M zOLz_3#+@9tOGDg}gD2ORR1RLT4ANmaO~6Z8&_}DWlac`fIi*Ui=y^yovFe6$LhNkn zLjN5>G`=-=zdCDszYn`D9*&6lpiy?_xaTwg9@!ojJ&AEmfwSz%DcoegS8M2&r@@lX zAL!2R47)vY7}b3AsSd$B-G>uhdgiP+D;(?J06Hj|#;D~kC7jDO(S?60CI0walh?Dh zIq1T|T3EH0&^LfLk)@7pNp^mvA2n6uTyzZ7-I<%{VEoB*&nD7m&x9aG{l&`xz40!y zoqeVE_|goGm(0E(=;z5^EAR)f!40iXvv9}8)_BBM$gr^BKS_S}-}Pnp)B+XhIqyww{$^U*fc3q`i(v5nTYROZT`P;TU|vk10Y|0yAI zqK)b1MA^rhsxR#}8IAYDbvWICn!4K=E;Z)5_@0Qon)EL#!J?;hoO9=@-N3hqUV3aL z;8|Yep%r*6MkB%AE&rj~)d9jB#^z*<)Z?w`3HBEFHl8tt)-Znx1)gC@^CjybKeG;+ zNY(q=JAjLJ3(qoaUH#NOLuCAQ;x=C4HgA4FTiOTENL`%z-;jM+;Y#9cZ*gx=F;*?X z0S%kWfPG@;pZNcYSNDG771@8oD}XTeuFS&|7UU7;g-bWw{!m~r(njo>=Vpa)p@>4A zF>;&v1S+WHN#=$Q2ewO|yuvFW;{s#rL*lS?`^8HyF zl#p>+lrp5d(cFVv8Yp0OiM3}<{lSqPr|3C{W17OojVzWD8fXP2Nf~ z+mg+&unl+7VvV%D7y&&#B#}A$ygMbc7EDHw+1rQ;yV{wBlI}^ z=7zqMvNAymQ%8s#7V5+G`pt?LR={DiKFWYa@V(mW3MVcgjQ1)d57svmoejXML)-+V zuPw&L{3{uVu+$xZ(bBVtizXGCL#dbg9y`_S=<9c_PuJJh7Jw9K*-?szyWNCf$GZGoClIinhq;V}tit%nm{?r=uSrVpUXfe(ys9UAM_ zxar>P4K&+iCGPe}`-F*G4lk#H1PN2^9DVgf;F`_U;A9n$0W4HhK_-f6X*U+5B*f?BZx!^V)GDHlfu`j3-AdZQ z7|vYv!nd0;qf2!qNQnjRf0RxtVEH?RvqxjnwPCY+5g06(w>eIlokm_wqfHa$X(+sR zFxL3#mFkj0|7EHs;UO2;=yKv>lP+rD7Q6BBuOyuK!~?+P3c(hIM{_3RkR{4b5!Zp@ z3To|Lljjnh`aqz=LUrl_O~c#P2z96l#R^p0J>u!T6fLxlyzZE_@}{+`DI94yZ2*)= zX~uh7u(=SlCLezx;cPHkZ|%b7|EZ z`iS6hc$Ps)==jHrvHOZ^#zWYZ0UryG5BNy0lTj~!fsvN3REwS~p6N(|pUNxFHh1L% zWO^vo&eGEj4u>g&hu;-&P8Pq0&0PZaR5*X+D?)uMN*r@uYR8H@(1MNrSs6;n98Xdz}F3rk)CHoE$H>=VO zFg2TeUb*_cJg1$I>YP+bd?HB)lI{P1$nsN$@7Np-NhIIxCb6;|96I8s^TaWvVI?G7 z^#Bjb^=!6ES&JJjYJ{crq_2KqjJ@5(G&_lwSFXkN1OjZPNg;+kQi?i51Xd8~MHoE7 zbd^_lF0!o%t+`sFUIvtC)jHf%p?HdPYGazy5^f>c^_(clX4A@gU;L{!eSRM)&73AAA6S~ zbAlgzY_;}`bRCaxOvCcAVsPT00ePqV$gHp`w=28 zvVP^raJzjjw8DN&Z%51!;myjpSp6iMyz%hxNs@(c>|qEnB|ul<4Es8^qhI<|jFnF@ z8_})Fq5s(2S#l*$LbHgZ3?N+fk~){53H4S@=0<+6b!cwRKe`C_VmnLkv3Eyc`R=d3 zhu-d=HYdL)xV$|}FBjW!I;MlZwuCq(%Hs?1X^>;0eM7;;jL%xvkkxxVPTCg_}_V~ZT& z5-Ei?gjrPs5qC!`*ORJLV*Ab~XD(d&U}SAcfrL_YG^&{vc=Ec-wA8?lm8y~_J3IG**3m<# zi<7?4rJ1Nyw#ISo(h&E6lO8X_L8kc+I@pxqx?BB(@=L9?9>*#^g&MTRIdFL2%gB_qDI1LOfVRLUo{iU1#DI*}u3-6|(F z^`c?<&Sut(ghf}L=|G-^YQ@o&ufC%t)1hB#?r2JiXU^WWny6FC-){I+Q}!h;05ebJ zP&XD})HQIdES_>8SEK9J_k7yCGwF%vT!?ZIR7{jQegEhfMKROc)5p|g$$ec2L*;v( z^YbdP04ify%WxD3X_REQu2y&oHLVWOBoo@;Qa*lr%?q~G>E(i9X3%$w6cjc096n46 z!}38>C$Uj8Aq|qD)A@Tc0kTZD#xmPbVUoi8BlCWjx zmv4ZqeAq6eo(#QLh!_|!ddBVm&h}=qDwEZ}EAOJbx{oLeZ<$~OhX4iY#{r6c-WVs$ zZYDhQOb8dat`v+B8dUYz*O;VLX0o#LG8r%X%2HS<*^PZcOr1VQn@_VYlasG8MZA>qUg4v@rS zEOF6Sm3QHb4x@=AtbUnkS@F}zq6{;K8JWTcOMSJ;vcOm)jItiFV#;>cRdh@5(XdB7 z&~TR9979N~j%|qIHlA>@6g#9l8CvP-UF5YyZ5S#kP%$gEp!YMOULTL_P3Lc9?mLN; zs2J>HW^{T#v)$RDI-1$*g)fKd`OZXwJ0s|Ih(Nn?>#RTnW1z%Zq?S-vYCl% zkf2SpH?4A#G&JHH=;9XSl>0f6$(cFl+kqHdzro;)zclv*5o{S0qwR0S4229Y?kt21 zk=2x#aC_M{RN{3f9yZ88E`P-=T!TuZDE9oMw9^drxF1S*ga^C?RgK3Y| zs*-%fXqgy2A^GNb0=go@+jsiB@#)}&@xv~hrw@g|0NMsFLcA>G(?9^|FukT@M>1KG zLz0`ytq^g``R6dLe4F&lNq|aYpzl3=d3qKdt3oVfE1Rq-D76oTf$>`Ij~CHoEEym51zs^FIkyZ~WxWz8eU z*gs^X&F@&y}DqIOuqrR1v zi)*6Ht^Sfd0FD*Q?;&FuP8=(T+Uscw;l_zZHe~xEyYz4xmu7%pwa+kRF|^&Ou~Y!h z!ZVnlc*k8jhsFl51yqYQuWs(0HWC*HRwm*#=V-pnQ570GSYBnx&$$G?eNq%$r!3a2 zU*nbOn=6+q9q!(8t-9|^rOGqb+*C&LCJSGiZ#|HP18oZp@_2%22}*~M;);YBep;=; z_}oL|Oy~VCu~99LGq3F)^X9nbY#h!Fiyw1*^wth2h)qE z3~(bGrS+ZGK3qfi_eSeJ1=@61ImM#a4SsGuIX_^1o`y>tpcBd{-S-~O07Vp!Yb2e^ zO;*(&o=38}rnhK41|Mpk1iQlf*#G)?rD*dFVKtR8)a*_eBO}_4QRbpq+?>6~T%EE0 z#;Le@W%3>xVn;1pi&jbiW|r?WKK{pCsk{9-daEPH>CJ~1cGs5la@qX@lE}=0F18moDut=ZEHJKAz78QCG~@`ko;mm^&k%iw&l^b|?B+BDxzdcJ?3 zVX5|WGLJj8NmqyrJw@~VFAMlGazyQ#xriegOsHxp7M*$azw3Nh#9Ym$2%0iqmM@=#1_ zZ=5i((=$2U%~*%C+*4<*eorY9SSUy>mKGwNShjEwJfJxoO{y z*=J6Q`%UANwbm)v1TgxdLq@@{viY#rC!`m9(n*!ScZ6_Dy8(N_{oUK>FZsfEDHM-%Ee%%U=8>y~j7I9$yUC)7nW>A9N|m!DSB23WV2WU0bg8 zN0$w9l(ukF!ZTNbeS^2ndPPx{4JX1LU$+5XRvy11*p^Oxrr9~=l1mBY(h6?WMhaFs zg1x#~DF3puhw{Rbr;1xkK)lKXXe!f{m*S6_7|Hns& zw%XlCtpBmn=3ZCCTjG|G=;HfPF>_9c|Xk^-_l=+3z`zIR$G7Q4k*j^}~Ru zcCO`YznagkifJs$k2dOY>7la~QsNkOJy78jchU<&qeq!H{n8|2nxihC0k(hqQ3W}3 zHt6~9sY9v%m^%FL6X-v)pTE8A@biKGm#Le8mVx7~!>bo>UIfyz3ky%mZv5HAzw7tM zJlG$%2K%T9VT ze0xP<;_^g44et_!=~!of6O|C9Z=n&QG5=K{?-lypj1cU}5uVDdXPr6389W8di+?SD z4xeOINMY#`&6rLKTw^&cCYYo~|@vqnc%u^3^ z-^||t@vp!-{|gYb=tjK*Fe6J4VA7G$0P9{G(k7J(b&444{DFA78;ENdnA!uV9eb~i7)T<&_I#Dvy3Uh%az+i78XTQ11Bh4ZJLz$t zR)C36u#>=tzu@%`lsx1(#kID75S^l*y@|qzeU*=6QwHRJsd|4tjy2ng>2UhhDrp5s z{Z@&7Ni#Jy71{w7Qa^rxyc2yavt4(dB=Q-l`Q9JL{`IHB6acP2v8S3qBPnNOo&10W zX$j3uc+Vhzy{UX{XtIk$5v;afAKS?6wZE~2qz$|V!1|9zWmJD1^@q#&lyJ&YP#45E zTyiiKl(W7JJe9hy(mOQD)rfT>MI)(s`Bw1Ye09!HWM>rJAd?< zt{*WLuz&j##-~4_AYvo>kJj@m$})u&uF*QRcX^+JdH7PV@$IfpE3j!5|Lji|u`BFP z=M}XqZx@I-)AcsnqW#~Vu5x<%rK4eUKWXl zdj@n)=o!H^e|9?mddG*S(}5?&t_uIS+z%ITsWt*~22Sem*i_+DT{FSpmU~G_NhAu4 z&2s03C^N+L|E)62@iib&kQl^hUv#LuUhfSk6e-jR0c}xsmH^T#*Ig&xB2{)wM}NvW z#*2HOUZ=QM&Bwnk?2kur_~6v|QV~!<6NuUA5KvJ|aBvJuo5dPD*3T{G1p_*S+k-Id z&ALfJmlZ&_N!U;E-(Kg7-)B-W|I<p2=(B;*ql+L5OJeY!R;{Nae zXcsN0z0LR=YyTB+?#2N&q+XD;(*S&Bwx1m?ou$9z;gmX^|MtP!Oioel+=g(a*?Lt0 z67Mha0$^G&-rgtw*AxC$22y7RZe1(p$K*@D2dNr!Ilv3Z>2Z`9pyOZa=N;UQ*ROMk z{+RNs3DgxQXZrKo@mw%t~FIWCv^Ws&Y$82)o3h4cSsOx}m>Ulgpt9G%fn&;jI zGa$t@SOF~8{>#qL*LRHn% z8Gmf_e?lys_v%=Yic?Vk=wfG7Y*082iy>DjAl}u@t~(k2m!$24E+BHLH)l<2i#8;by630G* zkWX@dDnC1*wDo@vJ~z1lmvQLz>_3S66lE@Jqv|kiyHl0zo1A)@0(LVGZ6-^A?d6kF z`i_hV%4U9xf%oH8wf(T3P%^tX$i2#&Y_9ofS-P)pgOFk-xg77`4BIfiNJ7D| z1`)AzusR_U?#Y*5{Hw6{U$+xT4FI<`8~ihvk``%iV z54#Ni81#-Jn6fqIPvW(Ua|lYUm^c=3|eNMlgtPVMmznj~JZvZwFW zeY*ck2loCf+iBoNb>$yHRty;jpaGvMvFe@I5s@n2f@|}t@WJn=()8gD0YayNepbO1 zj@jYqlOEV)Ux29ZXNK$e^B&iFJ_W=iVKbsBauc2djWsPcooHaqWrz1KMub;)=%$KG zZjLiKy_urlq9J?hQ_FUp3T9_ezr~W0(0lf9CU*Ytco&R()JCe~Ype=RzQ+27y)`8Kab_ne1w zS}qnnS-@@xbJ_dGK!+T@Dl2(MoqFEA(N#8ASMGv@&yHZymyBY3Cffzc|;}i;K_nOTzisj0SZpR*r@g ze{Q__pzcxGZ3j6lauMCDD)w2MjpfqZ4o<4R|A&kJ&p+wge&4|Sf5=REv?_2nkF)db z!^$gwh11xk$j^WZ`q4fHt>m@22bT(9ykPZ8%WpA2-og`+m)b;(_20cVoxpbki0RGA zI3mC}2Y~RO6S2=)mGGrKILxgwr#%9GlCirvHgp)diY$WV>E*dG2oIbW-Ngrx{PQvX zPl6gJZoo2dZuO7l{2mBeYu`RgPb2eTB#fF(9&6N;#*712_=2uL9+Zt|k_7x*&5m+g z_Sx^SxKN^dJVz?TCU*(DW1d)|hRkvh;ZXut6P4hfzd}`?(P@RqOeUG@L zd3jACGP$Z@Se6oo+A-)s6Ph(2|$WzHeq0H9h&Q->zan zF9R}dqAt}d|I}ieX4{a-E>i&ITD`>#1X|<_VvB2OX*6Q%jF$3m?Z%w7oN4F(!cqlaWv=G7N7S7z4`4N0o17pBYKg(%`3llzUINc_m{O<>1XozGP*Mc; zRD^qsMac|~F+AN@ne@~~<{Ku^|13Q;QdD`SO5CXTGuMOgc#fD*3B}Kx`ZW({TxvYj z^yfdUC)tI(P<~`n5@oV{bdioSxhI7ecYeSrH;!+`NzR#IX=@u>&$gRvovzkqU_)kx zY#UfUnz9%?y5fw~`7CcPYD0;MzmTL~;mVwasJS`Bai6RopkGv5CIv6g6vwNn@0-zo zI$UljD@D|anhrd&nJj?E8=*X#pu9TTQ||iq*xNY~vX?5wzy}sVk-6k?>VvZi@TjNY zq$wI9w

4BLnO|!R5weqOeWwvy+7#Wt=$ObRB_K@#1ZfEn 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�oPJzuc4k(Z<vY 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 z

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 literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/android/app/build.gradle b/packages/re_editor/example/android/app/build.gradle new file mode 100644 index 0000000..118ee1d --- /dev/null +++ b/packages/re_editor/example/android/app/build.gradle @@ -0,0 +1,67 @@ +plugins { + id "com.android.application" + id "kotlin-android" + id "dev.flutter.flutter-gradle-plugin" +} + +def localProperties = new Properties() +def localPropertiesFile = rootProject.file('local.properties') +if (localPropertiesFile.exists()) { + localPropertiesFile.withReader('UTF-8') { reader -> + localProperties.load(reader) + } +} + +def flutterVersionCode = localProperties.getProperty('flutter.versionCode') +if (flutterVersionCode == null) { + flutterVersionCode = '1' +} + +def flutterVersionName = localProperties.getProperty('flutter.versionName') +if (flutterVersionName == null) { + flutterVersionName = '1.0' +} + +android { + namespace "com.example.example" + compileSdkVersion flutter.compileSdkVersion + ndkVersion flutter.ndkVersion + + compileOptions { + sourceCompatibility JavaVersion.VERSION_1_8 + targetCompatibility JavaVersion.VERSION_1_8 + } + + kotlinOptions { + jvmTarget = '1.8' + } + + sourceSets { + main.java.srcDirs += 'src/main/kotlin' + } + + defaultConfig { + // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html). + applicationId "com.example.example" + // You can update the following values to match your application needs. + // For more information, see: https://docs.flutter.dev/deployment/android#reviewing-the-gradle-build-configuration. + minSdkVersion flutter.minSdkVersion + targetSdkVersion flutter.targetSdkVersion + versionCode flutterVersionCode.toInteger() + versionName flutterVersionName + } + + buildTypes { + release { + // TODO: Add your own signing config for the release build. + // Signing with the debug keys for now, so `flutter run --release` works. + signingConfig signingConfigs.debug + } + } +} + +flutter { + source '../..' +} + +dependencies {} diff --git a/packages/re_editor/example/android/app/src/debug/AndroidManifest.xml b/packages/re_editor/example/android/app/src/debug/AndroidManifest.xml new file mode 100644 index 0000000..399f698 --- /dev/null +++ b/packages/re_editor/example/android/app/src/debug/AndroidManifest.xml @@ -0,0 +1,7 @@ + + + + diff --git a/packages/re_editor/example/android/app/src/main/AndroidManifest.xml b/packages/re_editor/example/android/app/src/main/AndroidManifest.xml new file mode 100644 index 0000000..19b862e --- /dev/null +++ b/packages/re_editor/example/android/app/src/main/AndroidManifest.xml @@ -0,0 +1,33 @@ + + + + + + + + + + + + + + diff --git a/packages/re_editor/example/android/app/src/main/kotlin/com/example/example/MainActivity.kt b/packages/re_editor/example/android/app/src/main/kotlin/com/example/example/MainActivity.kt new file mode 100644 index 0000000..e793a00 --- /dev/null +++ b/packages/re_editor/example/android/app/src/main/kotlin/com/example/example/MainActivity.kt @@ -0,0 +1,6 @@ +package com.example.example + +import io.flutter.embedding.android.FlutterActivity + +class MainActivity: FlutterActivity() { +} diff --git a/packages/re_editor/example/android/app/src/main/res/drawable-v21/launch_background.xml b/packages/re_editor/example/android/app/src/main/res/drawable-v21/launch_background.xml new file mode 100644 index 0000000..f74085f --- /dev/null +++ b/packages/re_editor/example/android/app/src/main/res/drawable-v21/launch_background.xml @@ -0,0 +1,12 @@ + + + + + + + + diff --git a/packages/re_editor/example/android/app/src/main/res/drawable/launch_background.xml b/packages/re_editor/example/android/app/src/main/res/drawable/launch_background.xml new file mode 100644 index 0000000..304732f --- /dev/null +++ b/packages/re_editor/example/android/app/src/main/res/drawable/launch_background.xml @@ -0,0 +1,12 @@ + + + + + + + + diff --git a/packages/re_editor/example/android/app/src/main/res/mipmap-hdpi/ic_launcher.png b/packages/re_editor/example/android/app/src/main/res/mipmap-hdpi/ic_launcher.png new file mode 100644 index 0000000000000000000000000000000000000000..db77bb4b7b0906d62b1847e87f15cdcacf6a4f29 GIT binary patch literal 544 zcmeAS@N?(olHy`uVBq!ia0vp^9w5xY3?!3`olAj~WQl7;NpOBzNqJ&XDuZK6ep0G} zXKrG8YEWuoN@d~6R2!h8bpbvhu0Wd6uZuB!w&u2PAxD2eNXD>P5D~Wn-+_Wa#27Xc zC?Zj|6r#X(-D3u$NCt}(Ms06KgJ4FxJVv{GM)!I~&n8Bnc94O7-Hd)cjDZswgC;Qs zO=b+9!WcT8F?0rF7!Uys2bs@gozCP?z~o%U|N3vA*22NaGQG zlg@K`O_XuxvZ&Ks^m&R!`&1=spLvfx7oGDKDwpwW`#iqdw@AL`7MR}m`rwr|mZgU`8P7SBkL78fFf!WnuYWm$5Z0 zNXhDbCv&49sM544K|?c)WrFfiZvCi9h0O)B3Pgg&ebxsLQ05GG~ AQ2+n{ literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/android/app/src/main/res/mipmap-mdpi/ic_launcher.png b/packages/re_editor/example/android/app/src/main/res/mipmap-mdpi/ic_launcher.png new file mode 100644 index 0000000000000000000000000000000000000000..17987b79bb8a35cc66c3c1fd44f5a5526c1b78be GIT binary patch literal 442 zcmeAS@N?(olHy`uVBq!ia0vp^1|ZDA3?vioaBc-sk|nMYCBgY=CFO}lsSJ)O`AMk? zp1FzXsX?iUDV2pMQ*D5Xx&nMcT!A!W`0S9QKQy;}1Cl^CgaH=;G9cpY;r$Q>i*pfB zP2drbID<_#qf;rPZx^FqH)F_D#*k@@q03KywUtLX8Ua?`H+NMzkczFPK3lFz@i_kW%1NOn0|D2I9n9wzH8m|-tHjsw|9>@K=iMBhxvkv6m8Y-l zytQ?X=U+MF$@3 zt`~i=@j|6y)RWMK--}M|=T`o&^Ni>IoWKHEbBXz7?A@mgWoL>!*SXo`SZH-*HSdS+ yn*9;$7;m`l>wYBC5bq;=U}IMqLzqbYCidGC!)_gkIk_C@Uy!y&wkt5C($~2D>~)O*cj@FGjOCM)M>_ixfudOh)?xMu#Fs z#}Y=@YDTwOM)x{K_j*Q;dPdJ?Mz0n|pLRx{4n|)f>SXlmV)XB04CrSJn#dS5nK2lM zrZ9#~WelCp7&e13Y$jvaEXHskn$2V!!DN-nWS__6T*l;H&Fopn?A6HZ-6WRLFP=R` zqG+CE#d4|IbyAI+rJJ`&x9*T`+a=p|0O(+s{UBcyZdkhj=yS1>AirP+0R;mf2uMgM zC}@~JfByORAh4SyRgi&!(cja>F(l*O+nd+@4m$|6K6KDn_&uvCpV23&>G9HJp{xgg zoq1^2_p9@|WEo z*X_Uko@K)qYYv~>43eQGMdbiGbo>E~Q& zrYBH{QP^@Sti!`2)uG{irBBq@y*$B zi#&(U-*=fp74j)RyIw49+0MRPMRU)+a2r*PJ$L5roHt2$UjExCTZSbq%V!HeS7J$N zdG@vOZB4v_lF7Plrx+hxo7(fCV&}fHq)$ literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png b/packages/re_editor/example/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png new file mode 100644 index 0000000000000000000000000000000000000000..d5f1c8d34e7a88e3f88bea192c3a370d44689c3c GIT binary patch literal 1031 zcmeAS@N?(olHy`uVBq!ia0vp^6F``Q8Ax83A=Cw=BuiW)N`mv#O3D+9QW+dm@{>{( zJaZG%Q-e|yQz{EjrrIztFa`(sgt!6~Yi|1%a`XoT0ojZ}lNrNjb9xjc(B0U1_% zz5^97Xt*%oq$rQy4?0GKNfJ44uvxI)gC`h-NZ|&0-7(qS@?b!5r36oQ}zyZrNO3 zMO=Or+<~>+A&uN&E!^Sl+>xE!QC-|oJv`ApDhqC^EWD|@=#J`=d#Xzxs4ah}w&Jnc z$|q_opQ^2TrnVZ0o~wh<3t%W&flvYGe#$xqda2bR_R zvPYgMcHgjZ5nSA^lJr%;<&0do;O^tDDh~=pIxA#coaCY>&N%M2^tq^U%3DB@ynvKo}b?yu-bFc-u0JHzced$sg7S3zqI(2 z#Km{dPr7I=pQ5>FuK#)QwK?Y`E`B?nP+}U)I#c1+FM*1kNvWG|a(TpksZQ3B@sD~b zpQ2)*V*TdwjFOtHvV|;OsiDqHi=6%)o4b!)x$)%9pGTsE z-JL={-Ffv+T87W(Xpooq<`r*VzWQcgBN$$`u}f>-ZQI1BB8ykN*=e4rIsJx9>z}*o zo~|9I;xof literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png b/packages/re_editor/example/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png new file mode 100644 index 0000000000000000000000000000000000000000..4d6372eebdb28e45604e46eeda8dd24651419bc0 GIT binary patch literal 1443 zcmb`G{WsKk6vsdJTdFg%tJav9_E4vzrOaqkWF|A724Nly!y+?N9`YV6wZ}5(X(D_N(?!*n3`|_r0Hc?=PQw&*vnU?QTFY zB_MsH|!j$PP;I}?dppoE_gA(4uc!jV&0!l7_;&p2^pxNo>PEcNJv za5_RT$o2Mf!<+r?&EbHH6nMoTsDOa;mN(wv8RNsHpG)`^ymG-S5By8=l9iVXzN_eG%Xg2@Xeq76tTZ*dGh~Lo9vl;Zfs+W#BydUw zCkZ$o1LqWQO$FC9aKlLl*7x9^0q%0}$OMlp@Kk_jHXOjofdePND+j!A{q!8~Jn+s3 z?~~w@4?egS02}8NuulUA=L~QQfm;MzCGd)XhiftT;+zFO&JVyp2mBww?;QByS_1w! zrQlx%{^cMj0|Bo1FjwY@Q8?Hx0cIPF*@-ZRFpPc#bBw{5@tD(5%sClzIfl8WU~V#u zm5Q;_F!wa$BSpqhN>W@2De?TKWR*!ujY;Yylk_X5#~V!L*Gw~;$%4Q8~Mad z@`-kG?yb$a9cHIApZDVZ^U6Xkp<*4rU82O7%}0jjHlK{id@?-wpN*fCHXyXh(bLt* zPc}H-x0e4E&nQ>y%B-(EL=9}RyC%MyX=upHuFhAk&MLbsF0LP-q`XnH78@fT+pKPW zu72MW`|?8ht^tz$iC}ZwLp4tB;Q49K!QCF3@!iB1qOI=?w z7In!}F~ij(18UYUjnbmC!qKhPo%24?8U1x{7o(+?^Zu0Hx81|FuS?bJ0jgBhEMzf< zCgUq7r2OCB(`XkKcN-TL>u5y#dD6D!)5W?`O5)V^>jb)P)GBdy%t$uUMpf$SNV31$ zb||OojAbvMP?T@$h_ZiFLFVHDmbyMhJF|-_)HX3%m=CDI+ID$0^C>kzxprBW)hw(v zr!Gmda);ICoQyhV_oP5+C%?jcG8v+D@9f?Dk*!BxY}dazmrT@64UrP3hlslANK)bq z$67n83eh}OeW&SV@HG95P|bjfqJ7gw$e+`Hxo!4cx`jdK1bJ>YDSpGKLPZ^1cv$ek zIB?0S<#tX?SJCLWdMd{-ME?$hc7A$zBOdIJ)4!KcAwb=VMov)nK;9z>x~rfT1>dS+ zZ6#`2v@`jgbqq)P22H)Tx2CpmM^o1$B+xT6`(v%5xJ(?j#>Q$+rx_R|7TzDZe{J6q zG1*EcU%tE?!kO%^M;3aM6JN*LAKUVb^xz8-Pxo#jR5(-KBeLJvA@-gxNHx0M-ZJLl z;#JwQoh~9V?`UVo#}{6ka@II>++D@%KqGpMdlQ}?9E*wFcf5(#XQnP$Dk5~%iX^>f z%$y;?M0BLp{O3a(-4A?ewryHrrD%cx#Q^%KY1H zNre$ve+vceSLZcNY4U(RBX&)oZn*Py()h)XkE?PL$!bNb{N5FVI2Y%LKEm%yvpyTP z(1P?z~7YxD~Rf<(a@_y` literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/android/app/src/main/res/values-night/styles.xml b/packages/re_editor/example/android/app/src/main/res/values-night/styles.xml new file mode 100644 index 0000000..06952be --- /dev/null +++ b/packages/re_editor/example/android/app/src/main/res/values-night/styles.xml @@ -0,0 +1,18 @@ + + + + + + + diff --git a/packages/re_editor/example/android/app/src/main/res/values/styles.xml b/packages/re_editor/example/android/app/src/main/res/values/styles.xml new file mode 100644 index 0000000..cb1ef88 --- /dev/null +++ b/packages/re_editor/example/android/app/src/main/res/values/styles.xml @@ -0,0 +1,18 @@ + + + + + + + diff --git a/packages/re_editor/example/android/app/src/profile/AndroidManifest.xml b/packages/re_editor/example/android/app/src/profile/AndroidManifest.xml new file mode 100644 index 0000000..399f698 --- /dev/null +++ b/packages/re_editor/example/android/app/src/profile/AndroidManifest.xml @@ -0,0 +1,7 @@ + + + + diff --git a/packages/re_editor/example/android/build.gradle b/packages/re_editor/example/android/build.gradle new file mode 100644 index 0000000..e83fb5d --- /dev/null +++ b/packages/re_editor/example/android/build.gradle @@ -0,0 +1,30 @@ +buildscript { + ext.kotlin_version = '1.7.10' + repositories { + google() + mavenCentral() + } + + dependencies { + classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version" + } +} + +allprojects { + repositories { + google() + mavenCentral() + } +} + +rootProject.buildDir = '../build' +subprojects { + project.buildDir = "${rootProject.buildDir}/${project.name}" +} +subprojects { + project.evaluationDependsOn(':app') +} + +tasks.register("clean", Delete) { + delete rootProject.buildDir +} diff --git a/packages/re_editor/example/android/gradle.properties b/packages/re_editor/example/android/gradle.properties new file mode 100644 index 0000000..598d13f --- /dev/null +++ b/packages/re_editor/example/android/gradle.properties @@ -0,0 +1,3 @@ +org.gradle.jvmargs=-Xmx4G +android.useAndroidX=true +android.enableJetifier=true diff --git a/packages/re_editor/example/android/gradle/wrapper/gradle-wrapper.properties b/packages/re_editor/example/android/gradle/wrapper/gradle-wrapper.properties new file mode 100644 index 0000000..3c472b9 --- /dev/null +++ b/packages/re_editor/example/android/gradle/wrapper/gradle-wrapper.properties @@ -0,0 +1,5 @@ +distributionBase=GRADLE_USER_HOME +distributionPath=wrapper/dists +zipStoreBase=GRADLE_USER_HOME +zipStorePath=wrapper/dists +distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip diff --git a/packages/re_editor/example/android/settings.gradle b/packages/re_editor/example/android/settings.gradle new file mode 100644 index 0000000..7cd7128 --- /dev/null +++ b/packages/re_editor/example/android/settings.gradle @@ -0,0 +1,29 @@ +pluginManagement { + def flutterSdkPath = { + def properties = new Properties() + file("local.properties").withInputStream { properties.load(it) } + def flutterSdkPath = properties.getProperty("flutter.sdk") + assert flutterSdkPath != null, "flutter.sdk not set in local.properties" + return flutterSdkPath + } + settings.ext.flutterSdkPath = flutterSdkPath() + + includeBuild("${settings.ext.flutterSdkPath}/packages/flutter_tools/gradle") + + repositories { + google() + mavenCentral() + gradlePluginPortal() + } + + plugins { + id "dev.flutter.flutter-gradle-plugin" version "1.0.0" apply false + } +} + +plugins { + id "dev.flutter.flutter-plugin-loader" version "1.0.0" + id "com.android.application" version "7.3.0" apply false +} + +include ":app" diff --git a/packages/re_editor/example/assets/code.dart b/packages/re_editor/example/assets/code.dart new file mode 100644 index 0000000..0828525 --- /dev/null +++ b/packages/re_editor/example/assets/code.dart @@ -0,0 +1,16 @@ +import 'package:flutter/foundation.dart'; + +class ReEditor { + + final String foo; + final String bar; + + ReEditor(this.foo, this.bar); + + void hello(String name) { + if (kDebugMode) { + print('hello $name'); + } + } + +} \ No newline at end of file diff --git a/packages/re_editor/example/assets/code.json b/packages/re_editor/example/assets/code.json new file mode 100644 index 0000000..3d9d538 --- /dev/null +++ b/packages/re_editor/example/assets/code.json @@ -0,0 +1,152 @@ +{ + "configVersion": 2, + "packages": [ + { + "name": "async", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/async-2.11.0", + "packageUri": "lib/", + "languageVersion": "2.18" + }, + { + "name": "boolean_selector", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/boolean_selector-2.1.1", + "packageUri": "lib/", + "languageVersion": "2.17" + }, + { + "name": "characters", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/characters-1.3.0", + "packageUri": "lib/", + "languageVersion": "2.12" + }, + { + "name": "clock", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/clock-1.1.1", + "packageUri": "lib/", + "languageVersion": "2.12" + }, + { + "name": "collection", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/collection-1.18.0", + "packageUri": "lib/", + "languageVersion": "2.18" + }, + { + "name": "fake_async", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/fake_async-1.3.1", + "packageUri": "lib/", + "languageVersion": "2.12" + }, + { + "name": "flutter", + "rootUri": "file:///Users/megatronking/Workspace/Flutter/packages/flutter", + "packageUri": "lib/", + "languageVersion": "3.2" + }, + { + "name": "flutter_lints", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/flutter_lints-2.0.3", + "packageUri": "lib/", + "languageVersion": "2.19" + }, + { + "name": "flutter_test", + "rootUri": "file:///Users/megatronking/Workspace/Flutter/packages/flutter_test", + "packageUri": "lib/", + "languageVersion": "3.2" + }, + { + "name": "lints", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/lints-2.1.1", + "packageUri": "lib/", + "languageVersion": "3.0" + }, + { + "name": "matcher", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/matcher-0.12.16", + "packageUri": "lib/", + "languageVersion": "2.18" + }, + { + "name": "material_color_utilities", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/material_color_utilities-0.5.0", + "packageUri": "lib/", + "languageVersion": "2.17" + }, + { + "name": "meta", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/meta-1.10.0", + "packageUri": "lib/", + "languageVersion": "2.12" + }, + { + "name": "path", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/path-1.8.3", + "packageUri": "lib/", + "languageVersion": "2.12" + }, + { + "name": "sky_engine", + "rootUri": "file:///Users/megatronking/Workspace/Flutter/bin/cache/pkg/sky_engine", + "packageUri": "lib/", + "languageVersion": "3.2" + }, + { + "name": "source_span", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/source_span-1.10.0", + "packageUri": "lib/", + "languageVersion": "2.18" + }, + { + "name": "stack_trace", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/stack_trace-1.11.1", + "packageUri": "lib/", + "languageVersion": "2.18" + }, + { + "name": "stream_channel", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/stream_channel-2.1.2", + "packageUri": "lib/", + "languageVersion": "2.19" + }, + { + "name": "string_scanner", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/string_scanner-1.2.0", + "packageUri": "lib/", + "languageVersion": "2.18" + }, + { + "name": "term_glyph", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/term_glyph-1.2.1", + "packageUri": "lib/", + "languageVersion": "2.12" + }, + { + "name": "test_api", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/test_api-0.6.1", + "packageUri": "lib/", + "languageVersion": "3.0" + }, + { + "name": "vector_math", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/vector_math-2.1.4", + "packageUri": "lib/", + "languageVersion": "2.14" + }, + { + "name": "web", + "rootUri": "file:///Users/megatronking/.pub-cache/hosted/pub.dev/web-0.3.0", + "packageUri": "lib/", + "languageVersion": "3.2" + }, + { + "name": "re_highlight", + "rootUri": "../", + "packageUri": "lib/", + "languageVersion": "2.17" + } + ], + "generated": "2024-02-03T08:26:42.912338Z", + "generator": "pub", + "generatorVersion": "3.2.3" +} diff --git a/packages/re_editor/example/assets/large.txt b/packages/re_editor/example/assets/large.txt new file mode 100644 index 0000000..a6643bf --- /dev/null +++ b/packages/re_editor/example/assets/large.txt @@ -0,0 +1,108162 @@ +Network Working Group R. Fielding +Request for Comments: 2616 UC Irvine +Obsoletes: 2068 J. Gettys +Category: Standards Track Compaq/W3C + J. Mogul + Compaq + H. Frystyk + W3C/MIT + L. Masinter + Xerox + P. Leach + Microsoft + T. Berners-Lee + W3C/MIT + June 1999 + + + Hypertext Transfer Protocol -- HTTP/1.1 + +Status of this Memo + + This document specifies an Internet standards track protocol for the + Internet community, and requests discussion and suggestions for + improvements. Please refer to the current edition of the "Internet + Official Protocol Standards" (STD 1) for the standardization state + and status of this protocol. Distribution of this memo is unlimited. + +Copyright Notice + + Copyright (C) The Internet Society (1999). All Rights Reserved. + +Abstract + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. It is a generic, stateless, protocol which can be used for + many tasks beyond its use for hypertext, such as name servers and + distributed object management systems, through extension of its + request methods, error codes and headers [47]. A feature of HTTP is + the typing and negotiation of data representation, allowing systems + to be built independently of the data being transferred. + + HTTP has been in use by the World-Wide Web global information + initiative since 1990. This specification defines the protocol + referred to as "HTTP/1.1", and is an update to RFC 2068 [33]. + + + + + + +Fielding, et al. Standards Track [Page 1] + +RFC 2616 HTTP/1.1 June 1999 + + +Table of Contents + + 1 Introduction ...................................................7 + 1.1 Purpose......................................................7 + 1.2 Requirements .................................................8 + 1.3 Terminology ..................................................8 + 1.4 Overall Operation ...........................................12 + 2 Notational Conventions and Generic Grammar ....................14 + 2.1 Augmented BNF ...............................................14 + 2.2 Basic Rules .................................................15 + 3 Protocol Parameters ...........................................17 + 3.1 HTTP Version ................................................17 + 3.2 Uniform Resource Identifiers ................................18 + 3.2.1 General Syntax ...........................................19 + 3.2.2 http URL .................................................19 + 3.2.3 URI Comparison ...........................................20 + 3.3 Date/Time Formats ...........................................20 + 3.3.1 Full Date ................................................20 + 3.3.2 Delta Seconds ............................................21 + 3.4 Character Sets ..............................................21 + 3.4.1 Missing Charset ..........................................22 + 3.5 Content Codings .............................................23 + 3.6 Transfer Codings ............................................24 + 3.6.1 Chunked Transfer Coding ..................................25 + 3.7 Media Types .................................................26 + 3.7.1 Canonicalization and Text Defaults .......................27 + 3.7.2 Multipart Types ..........................................27 + 3.8 Product Tokens ..............................................28 + 3.9 Quality Values ..............................................29 + 3.10 Language Tags ...............................................29 + 3.11 Entity Tags .................................................30 + 3.12 Range Units .................................................30 + 4 HTTP Message ..................................................31 + 4.1 Message Types ...............................................31 + 4.2 Message Headers .............................................31 + 4.3 Message Body ................................................32 + 4.4 Message Length ..............................................33 + 4.5 General Header Fields .......................................34 + 5 Request .......................................................35 + 5.1 Request-Line ................................................35 + 5.1.1 Method ...................................................36 + 5.1.2 Request-URI ..............................................36 + 5.2 The Resource Identified by a Request ........................38 + 5.3 Request Header Fields .......................................38 + 6 Response ......................................................39 + 6.1 Status-Line .................................................39 + 6.1.1 Status Code and Reason Phrase ............................39 + 6.2 Response Header Fields ......................................41 + + + +Fielding, et al. Standards Track [Page 2] + +RFC 2616 HTTP/1.1 June 1999 + + + 7 Entity ........................................................42 + 7.1 Entity Header Fields ........................................42 + 7.2 Entity Body .................................................43 + 7.2.1 Type .....................................................43 + 7.2.2 Entity Length ............................................43 + 8 Connections ...................................................44 + 8.1 Persistent Connections ......................................44 + 8.1.1 Purpose ..................................................44 + 8.1.2 Overall Operation ........................................45 + 8.1.3 Proxy Servers ............................................46 + 8.1.4 Practical Considerations .................................46 + 8.2 Message Transmission Requirements ...........................47 + 8.2.1 Persistent Connections and Flow Control ..................47 + 8.2.2 Monitoring Connections for Error Status Messages .........48 + 8.2.3 Use of the 100 (Continue) Status .........................48 + 8.2.4 Client Behavior if Server Prematurely Closes Connection ..50 + 9 Method Definitions ............................................51 + 9.1 Safe and Idempotent Methods .................................51 + 9.1.1 Safe Methods .............................................51 + 9.1.2 Idempotent Methods .......................................51 + 9.2 OPTIONS .....................................................52 + 9.3 GET .........................................................53 + 9.4 HEAD ........................................................54 + 9.5 POST ........................................................54 + 9.6 PUT .........................................................55 + 9.7 DELETE ......................................................56 + 9.8 TRACE .......................................................56 + 9.9 CONNECT .....................................................57 + 10 Status Code Definitions ......................................57 + 10.1 Informational 1xx ...........................................57 + 10.1.1 100 Continue .............................................58 + 10.1.2 101 Switching Protocols ..................................58 + 10.2 Successful 2xx ..............................................58 + 10.2.1 200 OK ...................................................58 + 10.2.2 201 Created ..............................................59 + 10.2.3 202 Accepted .............................................59 + 10.2.4 203 Non-Authoritative Information ........................59 + 10.2.5 204 No Content ...........................................60 + 10.2.6 205 Reset Content ........................................60 + 10.2.7 206 Partial Content ......................................60 + 10.3 Redirection 3xx .............................................61 + 10.3.1 300 Multiple Choices .....................................61 + 10.3.2 301 Moved Permanently ....................................62 + 10.3.3 302 Found ................................................62 + 10.3.4 303 See Other ............................................63 + 10.3.5 304 Not Modified .........................................63 + 10.3.6 305 Use Proxy ............................................64 + 10.3.7 306 (Unused) .............................................64 + + + +Fielding, et al. Standards Track [Page 3] + +RFC 2616 HTTP/1.1 June 1999 + + + 10.3.8 307 Temporary Redirect ...................................65 + 10.4 Client Error 4xx ............................................65 + 10.4.1 400 Bad Request .........................................65 + 10.4.2 401 Unauthorized ........................................66 + 10.4.3 402 Payment Required ....................................66 + 10.4.4 403 Forbidden ...........................................66 + 10.4.5 404 Not Found ...........................................66 + 10.4.6 405 Method Not Allowed ..................................66 + 10.4.7 406 Not Acceptable ......................................67 + 10.4.8 407 Proxy Authentication Required .......................67 + 10.4.9 408 Request Timeout .....................................67 + 10.4.10 409 Conflict ............................................67 + 10.4.11 410 Gone ................................................68 + 10.4.12 411 Length Required .....................................68 + 10.4.13 412 Precondition Failed .................................68 + 10.4.14 413 Request Entity Too Large ............................69 + 10.4.15 414 Request-URI Too Long ................................69 + 10.4.16 415 Unsupported Media Type ..............................69 + 10.4.17 416 Requested Range Not Satisfiable .....................69 + 10.4.18 417 Expectation Failed ..................................70 + 10.5 Server Error 5xx ............................................70 + 10.5.1 500 Internal Server Error ................................70 + 10.5.2 501 Not Implemented ......................................70 + 10.5.3 502 Bad Gateway ..........................................70 + 10.5.4 503 Service Unavailable ..................................70 + 10.5.5 504 Gateway Timeout ......................................71 + 10.5.6 505 HTTP Version Not Supported ...........................71 + 11 Access Authentication ........................................71 + 12 Content Negotiation ..........................................71 + 12.1 Server-driven Negotiation ...................................72 + 12.2 Agent-driven Negotiation ....................................73 + 12.3 Transparent Negotiation .....................................74 + 13 Caching in HTTP ..............................................74 + 13.1.1 Cache Correctness ........................................75 + 13.1.2 Warnings .................................................76 + 13.1.3 Cache-control Mechanisms .................................77 + 13.1.4 Explicit User Agent Warnings .............................78 + 13.1.5 Exceptions to the Rules and Warnings .....................78 + 13.1.6 Client-controlled Behavior ...............................79 + 13.2 Expiration Model ............................................79 + 13.2.1 Server-Specified Expiration ..............................79 + 13.2.2 Heuristic Expiration .....................................80 + 13.2.3 Age Calculations .........................................80 + 13.2.4 Expiration Calculations ..................................83 + 13.2.5 Disambiguating Expiration Values .........................84 + 13.2.6 Disambiguating Multiple Responses ........................84 + 13.3 Validation Model ............................................85 + 13.3.1 Last-Modified Dates ......................................86 + + + +Fielding, et al. Standards Track [Page 4] + +RFC 2616 HTTP/1.1 June 1999 + + + 13.3.2 Entity Tag Cache Validators ..............................86 + 13.3.3 Weak and Strong Validators ...............................86 + 13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates.89 + 13.3.5 Non-validating Conditionals ..............................90 + 13.4 Response Cacheability .......................................91 + 13.5 Constructing Responses From Caches ..........................92 + 13.5.1 End-to-end and Hop-by-hop Headers ........................92 + 13.5.2 Non-modifiable Headers ...................................92 + 13.5.3 Combining Headers ........................................94 + 13.5.4 Combining Byte Ranges ....................................95 + 13.6 Caching Negotiated Responses ................................95 + 13.7 Shared and Non-Shared Caches ................................96 + 13.8 Errors or Incomplete Response Cache Behavior ................97 + 13.9 Side Effects of GET and HEAD ................................97 + 13.10 Invalidation After Updates or Deletions ...................97 + 13.11 Write-Through Mandatory ...................................98 + 13.12 Cache Replacement .........................................99 + 13.13 History Lists .............................................99 + 14 Header Field Definitions ....................................100 + 14.1 Accept .....................................................100 + 14.2 Accept-Charset .............................................102 + 14.3 Accept-Encoding ............................................102 + 14.4 Accept-Language ............................................104 + 14.5 Accept-Ranges ..............................................105 + 14.6 Age ........................................................106 + 14.7 Allow ......................................................106 + 14.8 Authorization ..............................................107 + 14.9 Cache-Control ..............................................108 + 14.9.1 What is Cacheable .......................................109 + 14.9.2 What May be Stored by Caches ............................110 + 14.9.3 Modifications of the Basic Expiration Mechanism .........111 + 14.9.4 Cache Revalidation and Reload Controls ..................113 + 14.9.5 No-Transform Directive ..................................115 + 14.9.6 Cache Control Extensions ................................116 + 14.10 Connection ...............................................117 + 14.11 Content-Encoding .........................................118 + 14.12 Content-Language .........................................118 + 14.13 Content-Length ...........................................119 + 14.14 Content-Location .........................................120 + 14.15 Content-MD5 ..............................................121 + 14.16 Content-Range ............................................122 + 14.17 Content-Type .............................................124 + 14.18 Date .....................................................124 + 14.18.1 Clockless Origin Server Operation ......................125 + 14.19 ETag .....................................................126 + 14.20 Expect ...................................................126 + 14.21 Expires ..................................................127 + 14.22 From .....................................................128 + + + +Fielding, et al. Standards Track [Page 5] + +RFC 2616 HTTP/1.1 June 1999 + + + 14.23 Host .....................................................128 + 14.24 If-Match .................................................129 + 14.25 If-Modified-Since ........................................130 + 14.26 If-None-Match ............................................132 + 14.27 If-Range .................................................133 + 14.28 If-Unmodified-Since ......................................134 + 14.29 Last-Modified ............................................134 + 14.30 Location .................................................135 + 14.31 Max-Forwards .............................................136 + 14.32 Pragma ...................................................136 + 14.33 Proxy-Authenticate .......................................137 + 14.34 Proxy-Authorization ......................................137 + 14.35 Range ....................................................138 + 14.35.1 Byte Ranges ...........................................138 + 14.35.2 Range Retrieval Requests ..............................139 + 14.36 Referer ..................................................140 + 14.37 Retry-After ..............................................141 + 14.38 Server ...................................................141 + 14.39 TE .......................................................142 + 14.40 Trailer ..................................................143 + 14.41 Transfer-Encoding..........................................143 + 14.42 Upgrade ..................................................144 + 14.43 User-Agent ...............................................145 + 14.44 Vary .....................................................145 + 14.45 Via ......................................................146 + 14.46 Warning ..................................................148 + 14.47 WWW-Authenticate .........................................150 + 15 Security Considerations .......................................150 + 15.1 Personal Information....................................151 + 15.1.1 Abuse of Server Log Information .........................151 + 15.1.2 Transfer of Sensitive Information .......................151 + 15.1.3 Encoding Sensitive Information in URI's .................152 + 15.1.4 Privacy Issues Connected to Accept Headers ..............152 + 15.2 Attacks Based On File and Path Names .......................153 + 15.3 DNS Spoofing ...............................................154 + 15.4 Location Headers and Spoofing ..............................154 + 15.5 Content-Disposition Issues .................................154 + 15.6 Authentication Credentials and Idle Clients ................155 + 15.7 Proxies and Caching ........................................155 + 15.7.1 Denial of Service Attacks on Proxies....................156 + 16 Acknowledgments .............................................156 + 17 References ..................................................158 + 18 Authors' Addresses ..........................................162 + 19 Appendices ..................................................164 + 19.1 Internet Media Type message/http and application/http ......164 + 19.2 Internet Media Type multipart/byteranges ...................165 + 19.3 Tolerant Applications ......................................166 + 19.4 Differences Between HTTP Entities and RFC 2045 Entities ....167 + + + +Fielding, et al. Standards Track [Page 6] + +RFC 2616 HTTP/1.1 June 1999 + + + 19.4.1 MIME-Version ............................................167 + 19.4.2 Conversion to Canonical Form ............................167 + 19.4.3 Conversion of Date Formats ..............................168 + 19.4.4 Introduction of Content-Encoding ........................168 + 19.4.5 No Content-Transfer-Encoding ............................168 + 19.4.6 Introduction of Transfer-Encoding .......................169 + 19.4.7 MHTML and Line Length Limitations .......................169 + 19.5 Additional Features ........................................169 + 19.5.1 Content-Disposition .....................................170 + 19.6 Compatibility with Previous Versions .......................170 + 19.6.1 Changes from HTTP/1.0 ...................................171 + 19.6.2 Compatibility with HTTP/1.0 Persistent Connections ......172 + 19.6.3 Changes from RFC 2068 ...................................172 + 20 Index .......................................................175 + 21 Full Copyright Statement ....................................176 + +1 Introduction + +1.1 Purpose + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. HTTP has been in use by the World-Wide Web global + information initiative since 1990. The first version of HTTP, + referred to as HTTP/0.9, was a simple protocol for raw data transfer + across the Internet. HTTP/1.0, as defined by RFC 1945 [6], improved + the protocol by allowing messages to be in the format of MIME-like + messages, containing metainformation about the data transferred and + modifiers on the request/response semantics. However, HTTP/1.0 does + not sufficiently take into consideration the effects of hierarchical + proxies, caching, the need for persistent connections, or virtual + hosts. In addition, the proliferation of incompletely-implemented + applications calling themselves "HTTP/1.0" has necessitated a + protocol version change in order for two communicating applications + to determine each other's true capabilities. + + This specification defines the protocol referred to as "HTTP/1.1". + This protocol includes more stringent requirements than HTTP/1.0 in + order to ensure reliable implementation of its features. + + Practical information systems require more functionality than simple + retrieval, including search, front-end update, and annotation. HTTP + allows an open-ended set of methods and headers that indicate the + purpose of a request [47]. It builds on the discipline of reference + provided by the Uniform Resource Identifier (URI) [3], as a location + (URL) [4] or name (URN) [20], for indicating the resource to which a + + + + + +Fielding, et al. Standards Track [Page 7] + +RFC 2616 HTTP/1.1 June 1999 + + + method is to be applied. Messages are passed in a format similar to + that used by Internet mail [9] as defined by the Multipurpose + Internet Mail Extensions (MIME) [7]. + + HTTP is also used as a generic protocol for communication between + user agents and proxies/gateways to other Internet systems, including + those supported by the SMTP [16], NNTP [13], FTP [18], Gopher [2], + and WAIS [10] protocols. In this way, HTTP allows basic hypermedia + access to resources available from diverse applications. + +1.2 Requirements + + The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", + "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this + document are to be interpreted as described in RFC 2119 [34]. + + An implementation is not compliant if it fails to satisfy one or more + of the MUST or REQUIRED level requirements for the protocols it + implements. An implementation that satisfies all the MUST or REQUIRED + level and all the SHOULD level requirements for its protocols is said + to be "unconditionally compliant"; one that satisfies all the MUST + level requirements but not all the SHOULD level requirements for its + protocols is said to be "conditionally compliant." + +1.3 Terminology + + This specification uses a number of terms to refer to the roles + played by participants in, and objects of, the HTTP communication. + + connection + A transport layer virtual circuit established between two programs + for the purpose of communication. + + message + The basic unit of HTTP communication, consisting of a structured + sequence of octets matching the syntax defined in section 4 and + transmitted via the connection. + + request + An HTTP request message, as defined in section 5. + + response + An HTTP response message, as defined in section 6. + + + + + + + + +Fielding, et al. Standards Track [Page 8] + +RFC 2616 HTTP/1.1 June 1999 + + + resource + A network data object or service that can be identified by a URI, + as defined in section 3.2. Resources may be available in multiple + representations (e.g. multiple languages, data formats, size, and + resolutions) or vary in other ways. + + entity + The information transferred as the payload of a request or + response. An entity consists of metainformation in the form of + entity-header fields and content in the form of an entity-body, as + described in section 7. + + representation + An entity included with a response that is subject to content + negotiation, as described in section 12. There may exist multiple + representations associated with a particular response status. + + content negotiation + The mechanism for selecting the appropriate representation when + servicing a request, as described in section 12. The + representation of entities in any response can be negotiated + (including error responses). + + variant + A resource may have one, or more than one, representation(s) + associated with it at any given instant. Each of these + representations is termed a `varriant'. Use of the term `variant' + does not necessarily imply that the resource is subject to content + negotiation. + + client + A program that establishes connections for the purpose of sending + requests. + + user agent + The client which initiates a request. These are often browsers, + editors, spiders (web-traversing robots), or other end user tools. + + server + An application program that accepts connections in order to + service requests by sending back responses. Any given program may + be capable of being both a client and a server; our use of these + terms refers only to the role being performed by the program for a + particular connection, rather than to the program's capabilities + in general. Likewise, any server may act as an origin server, + proxy, gateway, or tunnel, switching behavior based on the nature + of each request. + + + + +Fielding, et al. Standards Track [Page 9] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server + The server on which a given resource resides or is to be created. + + proxy + An intermediary program which acts as both a server and a client + for the purpose of making requests on behalf of other clients. + Requests are serviced internally or by passing them on, with + possible translation, to other servers. A proxy MUST implement + both the client and server requirements of this specification. A + "transparent proxy" is a proxy that does not modify the request or + response beyond what is required for proxy authentication and + identification. A "non-transparent proxy" is a proxy that modifies + the request or response in order to provide some added service to + the user agent, such as group annotation services, media type + transformation, protocol reduction, or anonymity filtering. Except + where either transparent or non-transparent behavior is explicitly + stated, the HTTP proxy requirements apply to both types of + proxies. + + gateway + A server which acts as an intermediary for some other server. + Unlike a proxy, a gateway receives requests as if it were the + origin server for the requested resource; the requesting client + may not be aware that it is communicating with a gateway. + + tunnel + An intermediary program which is acting as a blind relay between + two connections. Once active, a tunnel is not considered a party + to the HTTP communication, though the tunnel may have been + initiated by an HTTP request. The tunnel ceases to exist when both + ends of the relayed connections are closed. + + cache + A program's local store of response messages and the subsystem + that controls its message storage, retrieval, and deletion. A + cache stores cacheable responses in order to reduce the response + time and network bandwidth consumption on future, equivalent + requests. Any client or server may include a cache, though a cache + cannot be used by a server that is acting as a tunnel. + + cacheable + A response is cacheable if a cache is allowed to store a copy of + the response message for use in answering subsequent requests. The + rules for determining the cacheability of HTTP responses are + defined in section 13. Even if a resource is cacheable, there may + be additional constraints on whether a cache can use the cached + copy for a particular request. + + + + +Fielding, et al. Standards Track [Page 10] + +RFC 2616 HTTP/1.1 June 1999 + + + first-hand + A response is first-hand if it comes directly and without + unnecessary delay from the origin server, perhaps via one or more + proxies. A response is also first-hand if its validity has just + been checked directly with the origin server. + + explicit expiration time + The time at which the origin server intends that an entity should + no longer be returned by a cache without further validation. + + heuristic expiration time + An expiration time assigned by a cache when no explicit expiration + time is available. + + age + The age of a response is the time since it was sent by, or + successfully validated with, the origin server. + + freshness lifetime + The length of time between the generation of a response and its + expiration time. + + fresh + A response is fresh if its age has not yet exceeded its freshness + lifetime. + + stale + A response is stale if its age has passed its freshness lifetime. + + semantically transparent + A cache behaves in a "semantically transparent" manner, with + respect to a particular response, when its use affects neither the + requesting client nor the origin server, except to improve + performance. When a cache is semantically transparent, the client + receives exactly the same response (except for hop-by-hop headers) + that it would have received had its request been handled directly + by the origin server. + + validator + A protocol element (e.g., an entity tag or a Last-Modified time) + that is used to find out whether a cache entry is an equivalent + copy of an entity. + + upstream/downstream + Upstream and downstream describe the flow of a message: all + messages flow from upstream to downstream. + + + + + +Fielding, et al. Standards Track [Page 11] + +RFC 2616 HTTP/1.1 June 1999 + + + inbound/outbound + Inbound and outbound refer to the request and response paths for + messages: "inbound" means "traveling toward the origin server", + and "outbound" means "traveling toward the user agent" + +1.4 Overall Operation + + The HTTP protocol is a request/response protocol. A client sends a + request to the server in the form of a request method, URI, and + protocol version, followed by a MIME-like message containing request + modifiers, client information, and possible body content over a + connection with a server. The server responds with a status line, + including the message's protocol version and a success or error code, + followed by a MIME-like message containing server information, entity + metainformation, and possible entity-body content. The relationship + between HTTP and MIME is described in appendix 19.4. + + Most HTTP communication is initiated by a user agent and consists of + a request to be applied to a resource on some origin server. In the + simplest case, this may be accomplished via a single connection (v) + between the user agent (UA) and the origin server (O). + + request chain ------------------------> + UA -------------------v------------------- O + <----------------------- response chain + + A more complicated situation occurs when one or more intermediaries + are present in the request/response chain. There are three common + forms of intermediary: proxy, gateway, and tunnel. A proxy is a + forwarding agent, receiving requests for a URI in its absolute form, + rewriting all or part of the message, and forwarding the reformatted + request toward the server identified by the URI. A gateway is a + receiving agent, acting as a layer above some other server(s) and, if + necessary, translating the requests to the underlying server's + protocol. A tunnel acts as a relay point between two connections + without changing the messages; tunnels are used when the + communication needs to pass through an intermediary (such as a + firewall) even when the intermediary cannot understand the contents + of the messages. + + request chain --------------------------------------> + UA -----v----- A -----v----- B -----v----- C -----v----- O + <------------------------------------- response chain + + The figure above shows three intermediaries (A, B, and C) between the + user agent and origin server. A request or response message that + travels the whole chain will pass through four separate connections. + This distinction is important because some HTTP communication options + + + +Fielding, et al. Standards Track [Page 12] + +RFC 2616 HTTP/1.1 June 1999 + + + may apply only to the connection with the nearest, non-tunnel + neighbor, only to the end-points of the chain, or to all connections + along the chain. Although the diagram is linear, each participant may + be engaged in multiple, simultaneous communications. For example, B + may be receiving requests from many clients other than A, and/or + forwarding requests to servers other than C, at the same time that it + is handling A's request. + + Any party to the communication which is not acting as a tunnel may + employ an internal cache for handling requests. The effect of a cache + is that the request/response chain is shortened if one of the + participants along the chain has a cached response applicable to that + request. The following illustrates the resulting chain if B has a + cached copy of an earlier response from O (via C) for a request which + has not been cached by UA or A. + + request chain ----------> + UA -----v----- A -----v----- B - - - - - - C - - - - - - O + <--------- response chain + + Not all responses are usefully cacheable, and some requests may + contain modifiers which place special requirements on cache behavior. + HTTP requirements for cache behavior and cacheable responses are + defined in section 13. + + In fact, there are a wide variety of architectures and configurations + of caches and proxies currently being experimented with or deployed + across the World Wide Web. These systems include national hierarchies + of proxy caches to save transoceanic bandwidth, systems that + broadcast or multicast cache entries, organizations that distribute + subsets of cached data via CD-ROM, and so on. HTTP systems are used + in corporate intranets over high-bandwidth links, and for access via + PDAs with low-power radio links and intermittent connectivity. The + goal of HTTP/1.1 is to support the wide diversity of configurations + already deployed while introducing protocol constructs that meet the + needs of those who build web applications that require high + reliability and, failing that, at least reliable indications of + failure. + + HTTP communication usually takes place over TCP/IP connections. The + default port is TCP 80 [19], but other ports can be used. This does + not preclude HTTP from being implemented on top of any other protocol + on the Internet, or on other networks. HTTP only presumes a reliable + transport; any protocol that provides such guarantees can be used; + the mapping of the HTTP/1.1 request and response structures onto the + transport data units of the protocol in question is outside the scope + of this specification. + + + + +Fielding, et al. Standards Track [Page 13] + +RFC 2616 HTTP/1.1 June 1999 + + + In HTTP/1.0, most implementations used a new connection for each + request/response exchange. In HTTP/1.1, a connection may be used for + one or more request/response exchanges, although connections may be + closed for a variety of reasons (see section 8.1). + +2 Notational Conventions and Generic Grammar + +2.1 Augmented BNF + + All of the mechanisms specified in this document are described in + both prose and an augmented Backus-Naur Form (BNF) similar to that + used by RFC 822 [9]. Implementors will need to be familiar with the + notation in order to understand this specification. The augmented BNF + includes the following constructs: + + name = definition + The name of a rule is simply the name itself (without any + enclosing "<" and ">") and is separated from its definition by the + equal "=" character. White space is only significant in that + indentation of continuation lines is used to indicate a rule + definition that spans more than one line. Certain basic rules are + in uppercase, such as SP, LWS, HT, CRLF, DIGIT, ALPHA, etc. Angle + brackets are used within definitions whenever their presence will + facilitate discerning the use of rule names. + + "literal" + Quotation marks surround literal text. Unless stated otherwise, + the text is case-insensitive. + + rule1 | rule2 + Elements separated by a bar ("|") are alternatives, e.g., "yes | + no" will accept yes or no. + + (rule1 rule2) + Elements enclosed in parentheses are treated as a single element. + Thus, "(elem (foo | bar) elem)" allows the token sequences "elem + foo elem" and "elem bar elem". + + *rule + The character "*" preceding an element indicates repetition. The + full form is "*element" indicating at least and at most + occurrences of element. Default values are 0 and infinity so + that "*(element)" allows any number, including zero; "1*element" + requires at least one; and "1*2element" allows one or two. + + [rule] + Square brackets enclose optional elements; "[foo bar]" is + equivalent to "*1(foo bar)". + + + +Fielding, et al. Standards Track [Page 14] + +RFC 2616 HTTP/1.1 June 1999 + + + N rule + Specific repetition: "(element)" is equivalent to + "*(element)"; that is, exactly occurrences of (element). + Thus 2DIGIT is a 2-digit number, and 3ALPHA is a string of three + alphabetic characters. + + #rule + A construct "#" is defined, similar to "*", for defining lists of + elements. The full form is "#element" indicating at least + and at most elements, each separated by one or more commas + (",") and OPTIONAL linear white space (LWS). This makes the usual + form of lists very easy; a rule such as + ( *LWS element *( *LWS "," *LWS element )) + can be shown as + 1#element + Wherever this construct is used, null elements are allowed, but do + not contribute to the count of elements present. That is, + "(element), , (element) " is permitted, but counts as only two + elements. Therefore, where at least one element is required, at + least one non-null element MUST be present. Default values are 0 + and infinity so that "#element" allows any number, including zero; + "1#element" requires at least one; and "1#2element" allows one or + two. + + ; comment + A semi-colon, set off some distance to the right of rule text, + starts a comment that continues to the end of line. This is a + simple way of including useful notes in parallel with the + specifications. + + implied *LWS + The grammar described by this specification is word-based. Except + where noted otherwise, linear white space (LWS) can be included + between any two adjacent words (token or quoted-string), and + between adjacent words and separators, without changing the + interpretation of a field. At least one delimiter (LWS and/or + + separators) MUST exist between any two tokens (for the definition + of "token" below), since they would otherwise be interpreted as a + single token. + +2.2 Basic Rules + + The following rules are used throughout this specification to + describe basic parsing constructs. The US-ASCII coded character set + is defined by ANSI X3.4-1986 [21]. + + + + + +Fielding, et al. Standards Track [Page 15] + +RFC 2616 HTTP/1.1 June 1999 + + + OCTET = + CHAR = + UPALPHA = + LOALPHA = + ALPHA = UPALPHA | LOALPHA + DIGIT = + CTL = + CR = + LF = + SP = + HT = + <"> = + + HTTP/1.1 defines the sequence CR LF as the end-of-line marker for all + protocol elements except the entity-body (see appendix 19.3 for + tolerant applications). The end-of-line marker within an entity-body + is defined by its associated media type, as described in section 3.7. + + CRLF = CR LF + + HTTP/1.1 header field values can be folded onto multiple lines if the + continuation line begins with a space or horizontal tab. All linear + white space, including folding, has the same semantics as SP. A + recipient MAY replace any linear white space with a single SP before + interpreting the field value or forwarding the message downstream. + + LWS = [CRLF] 1*( SP | HT ) + + The TEXT rule is only used for descriptive field contents and values + that are not intended to be interpreted by the message parser. Words + of *TEXT MAY contain characters from character sets other than ISO- + 8859-1 [22] only when encoded according to the rules of RFC 2047 + [14]. + + TEXT = + + A CRLF is allowed in the definition of TEXT only as part of a header + field continuation. It is expected that the folding LWS will be + replaced with a single SP before interpretation of the TEXT value. + + Hexadecimal numeric characters are used in several protocol elements. + + HEX = "A" | "B" | "C" | "D" | "E" | "F" + | "a" | "b" | "c" | "d" | "e" | "f" | DIGIT + + + + + +Fielding, et al. Standards Track [Page 16] + +RFC 2616 HTTP/1.1 June 1999 + + + Many HTTP/1.1 header field values consist of words separated by LWS + or special characters. These special characters MUST be in a quoted + string to be used within a parameter value (as defined in section + 3.6). + + token = 1* + separators = "(" | ")" | "<" | ">" | "@" + | "," | ";" | ":" | "\" | <"> + | "/" | "[" | "]" | "?" | "=" + | "{" | "}" | SP | HT + + Comments can be included in some HTTP header fields by surrounding + the comment text with parentheses. Comments are only allowed in + fields containing "comment" as part of their field value definition. + In all other fields, parentheses are considered part of the field + value. + + comment = "(" *( ctext | quoted-pair | comment ) ")" + ctext = + + A string of text is parsed as a single word if it is quoted using + double-quote marks. + + quoted-string = ( <"> *(qdtext | quoted-pair ) <"> ) + qdtext = > + + The backslash character ("\") MAY be used as a single-character + quoting mechanism only within quoted-string and comment constructs. + + quoted-pair = "\" CHAR + +3 Protocol Parameters + +3.1 HTTP Version + + HTTP uses a "." numbering scheme to indicate versions + of the protocol. The protocol versioning policy is intended to allow + the sender to indicate the format of a message and its capacity for + understanding further HTTP communication, rather than the features + obtained via that communication. No change is made to the version + number for the addition of message components which do not affect + communication behavior or which only add to extensible field values. + The number is incremented when the changes made to the + protocol add features which do not change the general message parsing + algorithm, but which may add to the message semantics and imply + additional capabilities of the sender. The number is + incremented when the format of a message within the protocol is + changed. See RFC 2145 [36] for a fuller explanation. + + + +Fielding, et al. Standards Track [Page 17] + +RFC 2616 HTTP/1.1 June 1999 + + + The version of an HTTP message is indicated by an HTTP-Version field + in the first line of the message. + + HTTP-Version = "HTTP" "/" 1*DIGIT "." 1*DIGIT + + Note that the major and minor numbers MUST be treated as separate + integers and that each MAY be incremented higher than a single digit. + Thus, HTTP/2.4 is a lower version than HTTP/2.13, which in turn is + lower than HTTP/12.3. Leading zeros MUST be ignored by recipients and + MUST NOT be sent. + + An application that sends a request or response message that includes + HTTP-Version of "HTTP/1.1" MUST be at least conditionally compliant + with this specification. Applications that are at least conditionally + compliant with this specification SHOULD use an HTTP-Version of + "HTTP/1.1" in their messages, and MUST do so for any message that is + not compatible with HTTP/1.0. For more details on when to send + specific HTTP-Version values, see RFC 2145 [36]. + + The HTTP version of an application is the highest HTTP version for + which the application is at least conditionally compliant. + + Proxy and gateway applications need to be careful when forwarding + messages in protocol versions different from that of the application. + Since the protocol version indicates the protocol capability of the + sender, a proxy/gateway MUST NOT send a message with a version + indicator which is greater than its actual version. If a higher + version request is received, the proxy/gateway MUST either downgrade + the request version, or respond with an error, or switch to tunnel + behavior. + + Due to interoperability problems with HTTP/1.0 proxies discovered + since the publication of RFC 2068[33], caching proxies MUST, gateways + MAY, and tunnels MUST NOT upgrade the request to the highest version + they support. The proxy/gateway's response to that request MUST be in + the same major version as the request. + + Note: Converting between versions of HTTP may involve modification + of header fields required or forbidden by the versions involved. + +3.2 Uniform Resource Identifiers + + URIs have been known by many names: WWW addresses, Universal Document + Identifiers, Universal Resource Identifiers [3], and finally the + combination of Uniform Resource Locators (URL) [4] and Names (URN) + [20]. As far as HTTP is concerned, Uniform Resource Identifiers are + simply formatted strings which identify--via name, location, or any + other characteristic--a resource. + + + +Fielding, et al. Standards Track [Page 18] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.1 General Syntax + + URIs in HTTP can be represented in absolute form or relative to some + known base URI [11], depending upon the context of their use. The two + forms are differentiated by the fact that absolute URIs always begin + with a scheme name followed by a colon. For definitive information on + URL syntax and semantics, see "Uniform Resource Identifiers (URI): + Generic Syntax and Semantics," RFC 2396 [42] (which replaces RFCs + 1738 [4] and RFC 1808 [11]). This specification adopts the + definitions of "URI-reference", "absoluteURI", "relativeURI", "port", + "host","abs_path", "rel_path", and "authority" from that + specification. + + The HTTP protocol does not place any a priori limit on the length of + a URI. Servers MUST be able to handle the URI of any resource they + serve, and SHOULD be able to handle URIs of unbounded length if they + provide GET-based forms that could generate such URIs. A server + SHOULD return 414 (Request-URI Too Long) status if a URI is longer + than the server can handle (see section 10.4.15). + + Note: Servers ought to be cautious about depending on URI lengths + above 255 bytes, because some older client or proxy + implementations might not properly support these lengths. + +3.2.2 http URL + + The "http" scheme is used to locate network resources via the HTTP + protocol. This section defines the scheme-specific syntax and + semantics for http URLs. + + http_URL = "http:" "//" host [ ":" port ] [ abs_path [ "?" query ]] + + If the port is empty or not given, port 80 is assumed. The semantics + are that the identified resource is located at the server listening + for TCP connections on that port of that host, and the Request-URI + for the resource is abs_path (section 5.1.2). The use of IP addresses + in URLs SHOULD be avoided whenever possible (see RFC 1900 [24]). If + the abs_path is not present in the URL, it MUST be given as "/" when + used as a Request-URI for a resource (section 5.1.2). If a proxy + receives a host name which is not a fully qualified domain name, it + MAY add its domain to the host name it received. If a proxy receives + a fully qualified domain name, the proxy MUST NOT change the host + name. + + + + + + + + +Fielding, et al. Standards Track [Page 19] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.3 URI Comparison + + When comparing two URIs to decide if they match or not, a client + SHOULD use a case-sensitive octet-by-octet comparison of the entire + URIs, with these exceptions: + + - A port that is empty or not given is equivalent to the default + port for that URI-reference; + + - Comparisons of host names MUST be case-insensitive; + + - Comparisons of scheme names MUST be case-insensitive; + + - An empty abs_path is equivalent to an abs_path of "/". + + Characters other than those in the "reserved" and "unsafe" sets (see + RFC 2396 [42]) are equivalent to their ""%" HEX HEX" encoding. + + For example, the following three URIs are equivalent: + + http://abc.com:80/~smith/home.html + http://ABC.com/%7Esmith/home.html + http://ABC.com:/%7esmith/home.html + +3.3 Date/Time Formats + +3.3.1 Full Date + + HTTP applications have historically allowed three different formats + for the representation of date/time stamps: + + Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123 + Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036 + Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format + + The first format is preferred as an Internet standard and represents + a fixed-length subset of that defined by RFC 1123 [8] (an update to + RFC 822 [9]). The second format is in common use, but is based on the + obsolete RFC 850 [12] date format and lacks a four-digit year. + HTTP/1.1 clients and servers that parse the date value MUST accept + all three formats (for compatibility with HTTP/1.0), though they MUST + only generate the RFC 1123 format for representing HTTP-date values + in header fields. See section 19.3 for further information. + + Note: Recipients of date values are encouraged to be robust in + accepting date values that may have been sent by non-HTTP + applications, as is sometimes the case when retrieving or posting + messages via proxies/gateways to SMTP or NNTP. + + + +Fielding, et al. Standards Track [Page 20] + +RFC 2616 HTTP/1.1 June 1999 + + + All HTTP date/time stamps MUST be represented in Greenwich Mean Time + (GMT), without exception. For the purposes of HTTP, GMT is exactly + equal to UTC (Coordinated Universal Time). This is indicated in the + first two formats by the inclusion of "GMT" as the three-letter + abbreviation for time zone, and MUST be assumed when reading the + asctime format. HTTP-date is case sensitive and MUST NOT include + additional LWS beyond that specifically included as SP in the + grammar. + + HTTP-date = rfc1123-date | rfc850-date | asctime-date + rfc1123-date = wkday "," SP date1 SP time SP "GMT" + rfc850-date = weekday "," SP date2 SP time SP "GMT" + asctime-date = wkday SP date3 SP time SP 4DIGIT + date1 = 2DIGIT SP month SP 4DIGIT + ; day month year (e.g., 02 Jun 1982) + date2 = 2DIGIT "-" month "-" 2DIGIT + ; day-month-year (e.g., 02-Jun-82) + date3 = month SP ( 2DIGIT | ( SP 1DIGIT )) + ; month day (e.g., Jun 2) + time = 2DIGIT ":" 2DIGIT ":" 2DIGIT + ; 00:00:00 - 23:59:59 + wkday = "Mon" | "Tue" | "Wed" + | "Thu" | "Fri" | "Sat" | "Sun" + weekday = "Monday" | "Tuesday" | "Wednesday" + | "Thursday" | "Friday" | "Saturday" | "Sunday" + month = "Jan" | "Feb" | "Mar" | "Apr" + | "May" | "Jun" | "Jul" | "Aug" + | "Sep" | "Oct" | "Nov" | "Dec" + + Note: HTTP requirements for the date/time stamp format apply only + to their usage within the protocol stream. Clients and servers are + not required to use these formats for user presentation, request + logging, etc. + +3.3.2 Delta Seconds + + Some HTTP header fields allow a time value to be specified as an + integer number of seconds, represented in decimal, after the time + that the message was received. + + delta-seconds = 1*DIGIT + +3.4 Character Sets + + HTTP uses the same definition of the term "character set" as that + described for MIME: + + + + + +Fielding, et al. Standards Track [Page 21] + +RFC 2616 HTTP/1.1 June 1999 + + + The term "character set" is used in this document to refer to a + method used with one or more tables to convert a sequence of octets + into a sequence of characters. Note that unconditional conversion in + the other direction is not required, in that not all characters may + be available in a given character set and a character set may provide + more than one sequence of octets to represent a particular character. + This definition is intended to allow various kinds of character + encoding, from simple single-table mappings such as US-ASCII to + complex table switching methods such as those that use ISO-2022's + techniques. However, the definition associated with a MIME character + set name MUST fully specify the mapping to be performed from octets + to characters. In particular, use of external profiling information + to determine the exact mapping is not permitted. + + Note: This use of the term "character set" is more commonly + referred to as a "character encoding." However, since HTTP and + MIME share the same registry, it is important that the terminology + also be shared. + + HTTP character sets are identified by case-insensitive tokens. The + complete set of tokens is defined by the IANA Character Set registry + [19]. + + charset = token + + Although HTTP allows an arbitrary token to be used as a charset + value, any token that has a predefined value within the IANA + Character Set registry [19] MUST represent the character set defined + by that registry. Applications SHOULD limit their use of character + sets to those defined by the IANA registry. + + Implementors should be aware of IETF character set requirements [38] + [41]. + +3.4.1 Missing Charset + + Some HTTP/1.0 software has interpreted a Content-Type header without + charset parameter incorrectly to mean "recipient should guess." + Senders wishing to defeat this behavior MAY include a charset + parameter even when the charset is ISO-8859-1 and SHOULD do so when + it is known that it will not confuse the recipient. + + Unfortunately, some older HTTP/1.0 clients did not deal properly with + an explicit charset parameter. HTTP/1.1 recipients MUST respect the + charset label provided by the sender; and those user agents that have + a provision to "guess" a charset MUST use the charset from the + + + + + +Fielding, et al. Standards Track [Page 22] + +RFC 2616 HTTP/1.1 June 1999 + + + content-type field if they support that charset, rather than the + recipient's preference, when initially displaying a document. See + section 3.7.1. + +3.5 Content Codings + + Content coding values indicate an encoding transformation that has + been or can be applied to an entity. Content codings are primarily + used to allow a document to be compressed or otherwise usefully + transformed without losing the identity of its underlying media type + and without loss of information. Frequently, the entity is stored in + coded form, transmitted directly, and only decoded by the recipient. + + content-coding = token + + All content-coding values are case-insensitive. HTTP/1.1 uses + content-coding values in the Accept-Encoding (section 14.3) and + Content-Encoding (section 14.11) header fields. Although the value + describes the content-coding, what is more important is that it + indicates what decoding mechanism will be required to remove the + encoding. + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + content-coding value tokens. Initially, the registry contains the + following tokens: + + gzip An encoding format produced by the file compression program + "gzip" (GNU zip) as described in RFC 1952 [25]. This format is a + Lempel-Ziv coding (LZ77) with a 32 bit CRC. + + compress + The encoding format produced by the common UNIX file compression + program "compress". This format is an adaptive Lempel-Ziv-Welch + coding (LZW). + + Use of program names for the identification of encoding formats + is not desirable and is discouraged for future encodings. Their + use here is representative of historical practice, not good + design. For compatibility with previous implementations of HTTP, + applications SHOULD consider "x-gzip" and "x-compress" to be + equivalent to "gzip" and "compress" respectively. + + deflate + The "zlib" format defined in RFC 1950 [31] in combination with + the "deflate" compression mechanism described in RFC 1951 [29]. + + + + + + +Fielding, et al. Standards Track [Page 23] + +RFC 2616 HTTP/1.1 June 1999 + + + identity + The default (identity) encoding; the use of no transformation + whatsoever. This content-coding is used only in the Accept- + Encoding header, and SHOULD NOT be used in the Content-Encoding + header. + + New content-coding value tokens SHOULD be registered; to allow + interoperability between clients and servers, specifications of the + content coding algorithms needed to implement a new value SHOULD be + publicly available and adequate for independent implementation, and + conform to the purpose of content coding defined in this section. + +3.6 Transfer Codings + + Transfer-coding values are used to indicate an encoding + transformation that has been, can be, or may need to be applied to an + entity-body in order to ensure "safe transport" through the network. + This differs from a content coding in that the transfer-coding is a + property of the message, not of the original entity. + + transfer-coding = "chunked" | transfer-extension + transfer-extension = token *( ";" parameter ) + + Parameters are in the form of attribute/value pairs. + + parameter = attribute "=" value + attribute = token + value = token | quoted-string + + All transfer-coding values are case-insensitive. HTTP/1.1 uses + transfer-coding values in the TE header field (section 14.39) and in + the Transfer-Encoding header field (section 14.41). + + Whenever a transfer-coding is applied to a message-body, the set of + transfer-codings MUST include "chunked", unless the message is + terminated by closing the connection. When the "chunked" transfer- + coding is used, it MUST be the last transfer-coding applied to the + message-body. The "chunked" transfer-coding MUST NOT be applied more + than once to a message-body. These rules allow the recipient to + determine the transfer-length of the message (section 4.4). + + Transfer-codings are analogous to the Content-Transfer-Encoding + values of MIME [7], which were designed to enable safe transport of + binary data over a 7-bit transport service. However, safe transport + has a different focus for an 8bit-clean transfer protocol. In HTTP, + the only unsafe characteristic of message-bodies is the difficulty in + determining the exact body length (section 7.2.2), or the desire to + encrypt data over a shared transport. + + + +Fielding, et al. Standards Track [Page 24] + +RFC 2616 HTTP/1.1 June 1999 + + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + transfer-coding value tokens. Initially, the registry contains the + following tokens: "chunked" (section 3.6.1), "identity" (section + 3.6.2), "gzip" (section 3.5), "compress" (section 3.5), and "deflate" + (section 3.5). + + New transfer-coding value tokens SHOULD be registered in the same way + as new content-coding value tokens (section 3.5). + + A server which receives an entity-body with a transfer-coding it does + not understand SHOULD return 501 (Unimplemented), and close the + connection. A server MUST NOT send transfer-codings to an HTTP/1.0 + client. + +3.6.1 Chunked Transfer Coding + + The chunked encoding modifies the body of a message in order to + transfer it as a series of chunks, each with its own size indicator, + followed by an OPTIONAL trailer containing entity-header fields. This + allows dynamically produced content to be transferred along with the + information necessary for the recipient to verify that it has + received the full message. + + Chunked-Body = *chunk + last-chunk + trailer + CRLF + + chunk = chunk-size [ chunk-extension ] CRLF + chunk-data CRLF + chunk-size = 1*HEX + last-chunk = 1*("0") [ chunk-extension ] CRLF + + chunk-extension= *( ";" chunk-ext-name [ "=" chunk-ext-val ] ) + chunk-ext-name = token + chunk-ext-val = token | quoted-string + chunk-data = chunk-size(OCTET) + trailer = *(entity-header CRLF) + + The chunk-size field is a string of hex digits indicating the size of + the chunk. The chunked encoding is ended by any chunk whose size is + zero, followed by the trailer, which is terminated by an empty line. + + The trailer allows the sender to include additional HTTP header + fields at the end of the message. The Trailer header field can be + used to indicate which header fields are included in a trailer (see + section 14.40). + + + + +Fielding, et al. Standards Track [Page 25] + +RFC 2616 HTTP/1.1 June 1999 + + + A server using chunked transfer-coding in a response MUST NOT use the + trailer for any header fields unless at least one of the following is + true: + + a)the request included a TE header field that indicates "trailers" is + acceptable in the transfer-coding of the response, as described in + section 14.39; or, + + b)the server is the origin server for the response, the trailer + fields consist entirely of optional metadata, and the recipient + could use the message (in a manner acceptable to the origin server) + without receiving this metadata. In other words, the origin server + is willing to accept the possibility that the trailer fields might + be silently discarded along the path to the client. + + This requirement prevents an interoperability failure when the + message is being received by an HTTP/1.1 (or later) proxy and + forwarded to an HTTP/1.0 recipient. It avoids a situation where + compliance with the protocol would have necessitated a possibly + infinite buffer on the proxy. + + An example process for decoding a Chunked-Body is presented in + appendix 19.4.6. + + All HTTP/1.1 applications MUST be able to receive and decode the + "chunked" transfer-coding, and MUST ignore chunk-extension extensions + they do not understand. + +3.7 Media Types + + HTTP uses Internet Media Types [17] in the Content-Type (section + 14.17) and Accept (section 14.1) header fields in order to provide + open and extensible data typing and type negotiation. + + media-type = type "/" subtype *( ";" parameter ) + type = token + subtype = token + + Parameters MAY follow the type/subtype in the form of attribute/value + pairs (as defined in section 3.6). + + The type, subtype, and parameter attribute names are case- + insensitive. Parameter values might or might not be case-sensitive, + depending on the semantics of the parameter name. Linear white space + (LWS) MUST NOT be used between the type and subtype, nor between an + attribute and its value. The presence or absence of a parameter might + be significant to the processing of a media-type, depending on its + definition within the media type registry. + + + +Fielding, et al. Standards Track [Page 26] + +RFC 2616 HTTP/1.1 June 1999 + + + Note that some older HTTP applications do not recognize media type + parameters. When sending data to older HTTP applications, + implementations SHOULD only use media type parameters when they are + required by that type/subtype definition. + + Media-type values are registered with the Internet Assigned Number + Authority (IANA [19]). The media type registration process is + outlined in RFC 1590 [17]. Use of non-registered media types is + discouraged. + +3.7.1 Canonicalization and Text Defaults + + Internet media types are registered with a canonical form. An + entity-body transferred via HTTP messages MUST be represented in the + appropriate canonical form prior to its transmission except for + "text" types, as defined in the next paragraph. + + When in canonical form, media subtypes of the "text" type use CRLF as + the text line break. HTTP relaxes this requirement and allows the + transport of text media with plain CR or LF alone representing a line + break when it is done consistently for an entire entity-body. HTTP + applications MUST accept CRLF, bare CR, and bare LF as being + representative of a line break in text media received via HTTP. In + addition, if the text is represented in a character set that does not + use octets 13 and 10 for CR and LF respectively, as is the case for + some multi-byte character sets, HTTP allows the use of whatever octet + sequences are defined by that character set to represent the + equivalent of CR and LF for line breaks. This flexibility regarding + line breaks applies only to text media in the entity-body; a bare CR + or LF MUST NOT be substituted for CRLF within any of the HTTP control + structures (such as header fields and multipart boundaries). + + If an entity-body is encoded with a content-coding, the underlying + data MUST be in a form defined above prior to being encoded. + + The "charset" parameter is used with some media types to define the + character set (section 3.4) of the data. When no explicit charset + parameter is provided by the sender, media subtypes of the "text" + type are defined to have a default charset value of "ISO-8859-1" when + received via HTTP. Data in character sets other than "ISO-8859-1" or + its subsets MUST be labeled with an appropriate charset value. See + section 3.4.1 for compatibility problems. + +3.7.2 Multipart Types + + MIME provides for a number of "multipart" types -- encapsulations of + one or more entities within a single message-body. All multipart + types share a common syntax, as defined in section 5.1.1 of RFC 2046 + + + +Fielding, et al. Standards Track [Page 27] + +RFC 2616 HTTP/1.1 June 1999 + + + [40], and MUST include a boundary parameter as part of the media type + value. The message body is itself a protocol element and MUST + therefore use only CRLF to represent line breaks between body-parts. + Unlike in RFC 2046, the epilogue of any multipart message MUST be + empty; HTTP applications MUST NOT transmit the epilogue (even if the + original multipart contains an epilogue). These restrictions exist in + order to preserve the self-delimiting nature of a multipart message- + body, wherein the "end" of the message-body is indicated by the + ending multipart boundary. + + In general, HTTP treats a multipart message-body no differently than + any other media type: strictly as payload. The one exception is the + "multipart/byteranges" type (appendix 19.2) when it appears in a 206 + (Partial Content) response, which will be interpreted by some HTTP + caching mechanisms as described in sections 13.5.4 and 14.16. In all + other cases, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + The MIME header fields within each body-part of a multipart message- + body do not have any significance to HTTP beyond that defined by + their MIME semantics. + + In general, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + If an application receives an unrecognized multipart subtype, the + application MUST treat it as being equivalent to "multipart/mixed". + + Note: The "multipart/form-data" type has been specifically defined + for carrying form data suitable for processing via the POST + request method, as described in RFC 1867 [15]. + +3.8 Product Tokens + + Product tokens are used to allow communicating applications to + identify themselves by software name and version. Most fields using + product tokens also allow sub-products which form a significant part + of the application to be listed, separated by white space. By + convention, the products are listed in order of their significance + for identifying the application. + + product = token ["/" product-version] + product-version = token + + Examples: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + Server: Apache/0.8.4 + + + + + +Fielding, et al. Standards Track [Page 28] + +RFC 2616 HTTP/1.1 June 1999 + + + Product tokens SHOULD be short and to the point. They MUST NOT be + used for advertising or other non-essential information. Although any + token character MAY appear in a product-version, this token SHOULD + only be used for a version identifier (i.e., successive versions of + the same product SHOULD only differ in the product-version portion of + the product value). + +3.9 Quality Values + + HTTP content negotiation (section 12) uses short "floating point" + numbers to indicate the relative importance ("weight") of various + negotiable parameters. A weight is normalized to a real number in + the range 0 through 1, where 0 is the minimum and 1 the maximum + value. If a parameter has a quality value of 0, then content with + this parameter is `not acceptable' for the client. HTTP/1.1 + applications MUST NOT generate more than three digits after the + decimal point. User configuration of these values SHOULD also be + limited in this fashion. + + qvalue = ( "0" [ "." 0*3DIGIT ] ) + | ( "1" [ "." 0*3("0") ] ) + + "Quality values" is a misnomer, since these values merely represent + relative degradation in desired quality. + +3.10 Language Tags + + A language tag identifies a natural language spoken, written, or + otherwise conveyed by human beings for communication of information + to other human beings. Computer languages are explicitly excluded. + HTTP uses language tags within the Accept-Language and Content- + Language fields. + + The syntax and registry of HTTP language tags is the same as that + defined by RFC 1766 [1]. In summary, a language tag is composed of 1 + or more parts: A primary language tag and a possibly empty series of + subtags: + + language-tag = primary-tag *( "-" subtag ) + primary-tag = 1*8ALPHA + subtag = 1*8ALPHA + + White space is not allowed within the tag and all tags are case- + insensitive. The name space of language tags is administered by the + IANA. Example tags include: + + en, en-US, en-cockney, i-cherokee, x-pig-latin + + + + +Fielding, et al. Standards Track [Page 29] + +RFC 2616 HTTP/1.1 June 1999 + + + where any two-letter primary-tag is an ISO-639 language abbreviation + and any two-letter initial subtag is an ISO-3166 country code. (The + last three tags above are not registered tags; all but the last are + examples of tags which could be registered in future.) + +3.11 Entity Tags + + Entity tags are used for comparing two or more entities from the same + requested resource. HTTP/1.1 uses entity tags in the ETag (section + 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and + If-Range (section 14.27) header fields. The definition of how they + are used and compared as cache validators is in section 13.3.3. An + entity tag consists of an opaque quoted string, possibly prefixed by + a weakness indicator. + + entity-tag = [ weak ] opaque-tag + weak = "W/" + opaque-tag = quoted-string + + A "strong entity tag" MAY be shared by two entities of a resource + only if they are equivalent by octet equality. + + A "weak entity tag," indicated by the "W/" prefix, MAY be shared by + two entities of a resource only if the entities are equivalent and + could be substituted for each other with no significant change in + semantics. A weak entity tag can only be used for weak comparison. + + An entity tag MUST be unique across all versions of all entities + associated with a particular resource. A given entity tag value MAY + be used for entities obtained by requests on different URIs. The use + of the same entity tag value in conjunction with entities obtained by + requests on different URIs does not imply the equivalence of those + entities. + +3.12 Range Units + + HTTP/1.1 allows a client to request that only part (a range of) the + response entity be included within the response. HTTP/1.1 uses range + units in the Range (section 14.35) and Content-Range (section 14.16) + header fields. An entity can be broken down into subranges according + to various structural units. + + range-unit = bytes-unit | other-range-unit + bytes-unit = "bytes" + other-range-unit = token + + The only range unit defined by HTTP/1.1 is "bytes". HTTP/1.1 + implementations MAY ignore ranges specified using other units. + + + +Fielding, et al. Standards Track [Page 30] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 has been designed to allow implementations of applications + that do not depend on knowledge of ranges. + +4 HTTP Message + +4.1 Message Types + + HTTP messages consist of requests from client to server and responses + from server to client. + + HTTP-message = Request | Response ; HTTP/1.1 messages + + Request (section 5) and Response (section 6) messages use the generic + message format of RFC 822 [9] for transferring entities (the payload + of the message). Both types of message consist of a start-line, zero + or more header fields (also known as "headers"), an empty line (i.e., + a line with nothing preceding the CRLF) indicating the end of the + header fields, and possibly a message-body. + + generic-message = start-line + *(message-header CRLF) + CRLF + [ message-body ] + start-line = Request-Line | Status-Line + + In the interest of robustness, servers SHOULD ignore any empty + line(s) received where a Request-Line is expected. In other words, if + the server is reading the protocol stream at the beginning of a + message and receives a CRLF first, it should ignore the CRLF. + + Certain buggy HTTP/1.0 client implementations generate extra CRLF's + after a POST request. To restate what is explicitly forbidden by the + BNF, an HTTP/1.1 client MUST NOT preface or follow a request with an + extra CRLF. + +4.2 Message Headers + + HTTP header fields, which include general-header (section 4.5), + request-header (section 5.3), response-header (section 6.2), and + entity-header (section 7.1) fields, follow the same generic format as + that given in Section 3.1 of RFC 822 [9]. Each header field consists + of a name followed by a colon (":") and the field value. Field names + are case-insensitive. The field value MAY be preceded by any amount + of LWS, though a single SP is preferred. Header fields can be + extended over multiple lines by preceding each extra line with at + least one SP or HT. Applications ought to follow "common form", where + one is known or indicated, when generating HTTP constructs, since + there might exist some implementations that fail to accept anything + + + +Fielding, et al. Standards Track [Page 31] + +RFC 2616 HTTP/1.1 June 1999 + + + beyond the common forms. + + message-header = field-name ":" [ field-value ] + field-name = token + field-value = *( field-content | LWS ) + field-content = + + The field-content does not include any leading or trailing LWS: + linear white space occurring before the first non-whitespace + character of the field-value or after the last non-whitespace + character of the field-value. Such leading or trailing LWS MAY be + removed without changing the semantics of the field value. Any LWS + that occurs between field-content MAY be replaced with a single SP + before interpreting the field value or forwarding the message + downstream. + + The order in which header fields with differing field names are + received is not significant. However, it is "good practice" to send + general-header fields first, followed by request-header or response- + header fields, and ending with the entity-header fields. + + Multiple message-header fields with the same field-name MAY be + present in a message if and only if the entire field-value for that + header field is defined as a comma-separated list [i.e., #(values)]. + It MUST be possible to combine the multiple header fields into one + "field-name: field-value" pair, without changing the semantics of the + message, by appending each subsequent field-value to the first, each + separated by a comma. The order in which header fields with the same + field-name are received is therefore significant to the + interpretation of the combined field value, and thus a proxy MUST NOT + change the order of these field values when a message is forwarded. + +4.3 Message Body + + The message-body (if any) of an HTTP message is used to carry the + entity-body associated with the request or response. The message-body + differs from the entity-body only when a transfer-coding has been + applied, as indicated by the Transfer-Encoding header field (section + 14.41). + + message-body = entity-body + | + + Transfer-Encoding MUST be used to indicate any transfer-codings + applied by an application to ensure safe and proper transfer of the + message. Transfer-Encoding is a property of the message, not of the + + + +Fielding, et al. Standards Track [Page 32] + +RFC 2616 HTTP/1.1 June 1999 + + + entity, and thus MAY be added or removed by any application along the + request/response chain. (However, section 3.6 places restrictions on + when certain transfer-codings may be used.) + + The rules for when a message-body is allowed in a message differ for + requests and responses. + + The presence of a message-body in a request is signaled by the + inclusion of a Content-Length or Transfer-Encoding header field in + the request's message-headers. A message-body MUST NOT be included in + a request if the specification of the request method (section 5.1.1) + does not allow sending an entity-body in requests. A server SHOULD + read and forward a message-body on any request; if the request method + does not include defined semantics for an entity-body, then the + message-body SHOULD be ignored when handling the request. + + For response messages, whether or not a message-body is included with + a message is dependent on both the request method and the response + status code (section 6.1.1). All responses to the HEAD request method + MUST NOT include a message-body, even though the presence of entity- + header fields might lead one to believe they do. All 1xx + (informational), 204 (no content), and 304 (not modified) responses + MUST NOT include a message-body. All other responses do include a + message-body, although it MAY be of zero length. + +4.4 Message Length + + The transfer-length of a message is the length of the message-body as + it appears in the message; that is, after any transfer-codings have + been applied. When a message-body is included with a message, the + transfer-length of that body is determined by one of the following + (in order of precedence): + + 1.Any response message which "MUST NOT" include a message-body (such + as the 1xx, 204, and 304 responses and any response to a HEAD + request) is always terminated by the first empty line after the + header fields, regardless of the entity-header fields present in + the message. + + 2.If a Transfer-Encoding header field (section 14.41) is present and + has any value other than "identity", then the transfer-length is + defined by use of the "chunked" transfer-coding (section 3.6), + unless the message is terminated by closing the connection. + + 3.If a Content-Length header field (section 14.13) is present, its + decimal value in OCTETs represents both the entity-length and the + transfer-length. The Content-Length header field MUST NOT be sent + if these two lengths are different (i.e., if a Transfer-Encoding + + + +Fielding, et al. Standards Track [Page 33] + +RFC 2616 HTTP/1.1 June 1999 + + + header field is present). If a message is received with both a + Transfer-Encoding header field and a Content-Length header field, + the latter MUST be ignored. + + 4.If the message uses the media type "multipart/byteranges", and the + ransfer-length is not otherwise specified, then this self- + elimiting media type defines the transfer-length. This media type + UST NOT be used unless the sender knows that the recipient can arse + it; the presence in a request of a Range header with ultiple byte- + range specifiers from a 1.1 client implies that the lient can parse + multipart/byteranges responses. + + A range header might be forwarded by a 1.0 proxy that does not + understand multipart/byteranges; in this case the server MUST + delimit the message using methods defined in items 1,3 or 5 of + this section. + + 5.By the server closing the connection. (Closing the connection + cannot be used to indicate the end of a request body, since that + would leave no possibility for the server to send back a response.) + + For compatibility with HTTP/1.0 applications, HTTP/1.1 requests + containing a message-body MUST include a valid Content-Length header + field unless the server is known to be HTTP/1.1 compliant. If a + request contains a message-body and a Content-Length is not given, + the server SHOULD respond with 400 (bad request) if it cannot + determine the length of the message, or with 411 (length required) if + it wishes to insist on receiving a valid Content-Length. + + All HTTP/1.1 applications that receive entities MUST accept the + "chunked" transfer-coding (section 3.6), thus allowing this mechanism + to be used for messages when the message length cannot be determined + in advance. + + Messages MUST NOT include both a Content-Length header field and a + non-identity transfer-coding. If the message does include a non- + identity transfer-coding, the Content-Length MUST be ignored. + + When a Content-Length is given in a message where a message-body is + allowed, its field value MUST exactly match the number of OCTETs in + the message-body. HTTP/1.1 user agents MUST notify the user when an + invalid length is received and detected. + +4.5 General Header Fields + + There are a few header fields which have general applicability for + both request and response messages, but which do not apply to the + entity being transferred. These header fields apply only to the + + + +Fielding, et al. Standards Track [Page 34] + +RFC 2616 HTTP/1.1 June 1999 + + + message being transmitted. + + general-header = Cache-Control ; Section 14.9 + | Connection ; Section 14.10 + | Date ; Section 14.18 + | Pragma ; Section 14.32 + | Trailer ; Section 14.40 + | Transfer-Encoding ; Section 14.41 + | Upgrade ; Section 14.42 + | Via ; Section 14.45 + | Warning ; Section 14.46 + + General-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields may be given the semantics of general + header fields if all parties in the communication recognize them to + be general-header fields. Unrecognized header fields are treated as + entity-header fields. + +5 Request + + A request message from a client to a server includes, within the + first line of that message, the method to be applied to the resource, + the identifier of the resource, and the protocol version in use. + + Request = Request-Line ; Section 5.1 + *(( general-header ; Section 4.5 + | request-header ; Section 5.3 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 4.3 + +5.1 Request-Line + + The Request-Line begins with a method token, followed by the + Request-URI and the protocol version, and ending with CRLF. The + elements are separated by SP characters. No CR or LF is allowed + except in the final CRLF sequence. + + Request-Line = Method SP Request-URI SP HTTP-Version CRLF + + + + + + + + + + + +Fielding, et al. Standards Track [Page 35] + +RFC 2616 HTTP/1.1 June 1999 + + +5.1.1 Method + + The Method token indicates the method to be performed on the + resource identified by the Request-URI. The method is case-sensitive. + + Method = "OPTIONS" ; Section 9.2 + | "GET" ; Section 9.3 + | "HEAD" ; Section 9.4 + | "POST" ; Section 9.5 + | "PUT" ; Section 9.6 + | "DELETE" ; Section 9.7 + | "TRACE" ; Section 9.8 + | "CONNECT" ; Section 9.9 + | extension-method + extension-method = token + + The list of methods allowed by a resource can be specified in an + Allow header field (section 14.7). The return code of the response + always notifies the client whether a method is currently allowed on a + resource, since the set of allowed methods can change dynamically. An + origin server SHOULD return the status code 405 (Method Not Allowed) + if the method is known by the origin server but not allowed for the + requested resource, and 501 (Not Implemented) if the method is + unrecognized or not implemented by the origin server. The methods GET + and HEAD MUST be supported by all general-purpose servers. All other + methods are OPTIONAL; however, if the above methods are implemented, + they MUST be implemented with the same semantics as those specified + in section 9. + +5.1.2 Request-URI + + The Request-URI is a Uniform Resource Identifier (section 3.2) and + identifies the resource upon which to apply the request. + + Request-URI = "*" | absoluteURI | abs_path | authority + + The four options for Request-URI are dependent on the nature of the + request. The asterisk "*" means that the request does not apply to a + particular resource, but to the server itself, and is only allowed + when the method used does not necessarily apply to a resource. One + example would be + + OPTIONS * HTTP/1.1 + + The absoluteURI form is REQUIRED when the request is being made to a + proxy. The proxy is requested to forward the request or service it + from a valid cache, and return the response. Note that the proxy MAY + forward the request on to another proxy or directly to the server + + + +Fielding, et al. Standards Track [Page 36] + +RFC 2616 HTTP/1.1 June 1999 + + + specified by the absoluteURI. In order to avoid request loops, a + proxy MUST be able to recognize all of its server names, including + any aliases, local variations, and the numeric IP address. An example + Request-Line would be: + + GET http://www.w3.org/pub/WWW/TheProject.html HTTP/1.1 + + To allow for transition to absoluteURIs in all requests in future + versions of HTTP, all HTTP/1.1 servers MUST accept the absoluteURI + form in requests, even though HTTP/1.1 clients will only generate + them in requests to proxies. + + The authority form is only used by the CONNECT method (section 9.9). + + The most common form of Request-URI is that used to identify a + resource on an origin server or gateway. In this case the absolute + path of the URI MUST be transmitted (see section 3.2.1, abs_path) as + the Request-URI, and the network location of the URI (authority) MUST + be transmitted in a Host header field. For example, a client wishing + to retrieve the resource above directly from the origin server would + create a TCP connection to port 80 of the host "www.w3.org" and send + the lines: + + GET /pub/WWW/TheProject.html HTTP/1.1 + Host: www.w3.org + + followed by the remainder of the Request. Note that the absolute path + cannot be empty; if none is present in the original URI, it MUST be + given as "/" (the server root). + + The Request-URI is transmitted in the format specified in section + 3.2.1. If the Request-URI is encoded using the "% HEX HEX" encoding + [42], the origin server MUST decode the Request-URI in order to + properly interpret the request. Servers SHOULD respond to invalid + Request-URIs with an appropriate status code. + + A transparent proxy MUST NOT rewrite the "abs_path" part of the + received Request-URI when forwarding it to the next inbound server, + except as noted above to replace a null abs_path with "/". + + Note: The "no rewrite" rule prevents the proxy from changing the + meaning of the request when the origin server is improperly using + a non-reserved URI character for a reserved purpose. Implementors + should be aware that some pre-HTTP/1.1 proxies have been known to + rewrite the Request-URI. + + + + + + +Fielding, et al. Standards Track [Page 37] + +RFC 2616 HTTP/1.1 June 1999 + + +5.2 The Resource Identified by a Request + + The exact resource identified by an Internet request is determined by + examining both the Request-URI and the Host header field. + + An origin server that does not allow resources to differ by the + requested host MAY ignore the Host header field value when + determining the resource identified by an HTTP/1.1 request. (But see + section 19.6.1.1 for other requirements on Host support in HTTP/1.1.) + + An origin server that does differentiate resources based on the host + requested (sometimes referred to as virtual hosts or vanity host + names) MUST use the following rules for determining the requested + resource on an HTTP/1.1 request: + + 1. If Request-URI is an absoluteURI, the host is part of the + Request-URI. Any Host header field value in the request MUST be + ignored. + + 2. If the Request-URI is not an absoluteURI, and the request includes + a Host header field, the host is determined by the Host header + field value. + + 3. If the host as determined by rule 1 or 2 is not a valid host on + the server, the response MUST be a 400 (Bad Request) error message. + + Recipients of an HTTP/1.0 request that lacks a Host header field MAY + attempt to use heuristics (e.g., examination of the URI path for + something unique to a particular host) in order to determine what + exact resource is being requested. + +5.3 Request Header Fields + + The request-header fields allow the client to pass additional + information about the request, and about the client itself, to the + server. These fields act as request modifiers, with semantics + equivalent to the parameters on a programming language method + invocation. + + request-header = Accept ; Section 14.1 + | Accept-Charset ; Section 14.2 + | Accept-Encoding ; Section 14.3 + | Accept-Language ; Section 14.4 + | Authorization ; Section 14.8 + | Expect ; Section 14.20 + | From ; Section 14.22 + | Host ; Section 14.23 + | If-Match ; Section 14.24 + + + +Fielding, et al. Standards Track [Page 38] + +RFC 2616 HTTP/1.1 June 1999 + + + | If-Modified-Since ; Section 14.25 + | If-None-Match ; Section 14.26 + | If-Range ; Section 14.27 + | If-Unmodified-Since ; Section 14.28 + | Max-Forwards ; Section 14.31 + | Proxy-Authorization ; Section 14.34 + | Range ; Section 14.35 + | Referer ; Section 14.36 + | TE ; Section 14.39 + | User-Agent ; Section 14.43 + + Request-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of request- + header fields if all parties in the communication recognize them to + be request-header fields. Unrecognized header fields are treated as + entity-header fields. + +6 Response + + After receiving and interpreting a request message, a server responds + with an HTTP response message. + + Response = Status-Line ; Section 6.1 + *(( general-header ; Section 4.5 + | response-header ; Section 6.2 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 7.2 + +6.1 Status-Line + + The first line of a Response message is the Status-Line, consisting + of the protocol version followed by a numeric status code and its + associated textual phrase, with each element separated by SP + characters. No CR or LF is allowed except in the final CRLF sequence. + + Status-Line = HTTP-Version SP Status-Code SP Reason-Phrase CRLF + +6.1.1 Status Code and Reason Phrase + + The Status-Code element is a 3-digit integer result code of the + attempt to understand and satisfy the request. These codes are fully + defined in section 10. The Reason-Phrase is intended to give a short + textual description of the Status-Code. The Status-Code is intended + for use by automata and the Reason-Phrase is intended for the human + user. The client is not required to examine or display the Reason- + Phrase. + + + +Fielding, et al. Standards Track [Page 39] + +RFC 2616 HTTP/1.1 June 1999 + + + The first digit of the Status-Code defines the class of response. The + last two digits do not have any categorization role. There are 5 + values for the first digit: + + - 1xx: Informational - Request received, continuing process + + - 2xx: Success - The action was successfully received, + understood, and accepted + + - 3xx: Redirection - Further action must be taken in order to + complete the request + + - 4xx: Client Error - The request contains bad syntax or cannot + be fulfilled + + - 5xx: Server Error - The server failed to fulfill an apparently + valid request + + The individual values of the numeric status codes defined for + HTTP/1.1, and an example set of corresponding Reason-Phrase's, are + presented below. The reason phrases listed here are only + recommendations -- they MAY be replaced by local equivalents without + affecting the protocol. + + Status-Code = + "100" ; Section 10.1.1: Continue + | "101" ; Section 10.1.2: Switching Protocols + | "200" ; Section 10.2.1: OK + | "201" ; Section 10.2.2: Created + | "202" ; Section 10.2.3: Accepted + | "203" ; Section 10.2.4: Non-Authoritative Information + | "204" ; Section 10.2.5: No Content + | "205" ; Section 10.2.6: Reset Content + | "206" ; Section 10.2.7: Partial Content + | "300" ; Section 10.3.1: Multiple Choices + | "301" ; Section 10.3.2: Moved Permanently + | "302" ; Section 10.3.3: Found + | "303" ; Section 10.3.4: See Other + | "304" ; Section 10.3.5: Not Modified + | "305" ; Section 10.3.6: Use Proxy + | "307" ; Section 10.3.8: Temporary Redirect + | "400" ; Section 10.4.1: Bad Request + | "401" ; Section 10.4.2: Unauthorized + | "402" ; Section 10.4.3: Payment Required + | "403" ; Section 10.4.4: Forbidden + | "404" ; Section 10.4.5: Not Found + | "405" ; Section 10.4.6: Method Not Allowed + | "406" ; Section 10.4.7: Not Acceptable + + + +Fielding, et al. Standards Track [Page 40] + +RFC 2616 HTTP/1.1 June 1999 + + + | "407" ; Section 10.4.8: Proxy Authentication Required + | "408" ; Section 10.4.9: Request Time-out + | "409" ; Section 10.4.10: Conflict + | "410" ; Section 10.4.11: Gone + | "411" ; Section 10.4.12: Length Required + | "412" ; Section 10.4.13: Precondition Failed + | "413" ; Section 10.4.14: Request Entity Too Large + | "414" ; Section 10.4.15: Request-URI Too Large + | "415" ; Section 10.4.16: Unsupported Media Type + | "416" ; Section 10.4.17: Requested range not satisfiable + | "417" ; Section 10.4.18: Expectation Failed + | "500" ; Section 10.5.1: Internal Server Error + | "501" ; Section 10.5.2: Not Implemented + | "502" ; Section 10.5.3: Bad Gateway + | "503" ; Section 10.5.4: Service Unavailable + | "504" ; Section 10.5.5: Gateway Time-out + | "505" ; Section 10.5.6: HTTP Version not supported + | extension-code + + extension-code = 3DIGIT + Reason-Phrase = * + + HTTP status codes are extensible. HTTP applications are not required + to understand the meaning of all registered status codes, though such + understanding is obviously desirable. However, applications MUST + understand the class of any status code, as indicated by the first + digit, and treat any unrecognized response as being equivalent to the + x00 status code of that class, with the exception that an + unrecognized response MUST NOT be cached. For example, if an + unrecognized status code of 431 is received by the client, it can + safely assume that there was something wrong with its request and + treat the response as if it had received a 400 status code. In such + cases, user agents SHOULD present to the user the entity returned + with the response, since that entity is likely to include human- + readable information which will explain the unusual status. + +6.2 Response Header Fields + + The response-header fields allow the server to pass additional + information about the response which cannot be placed in the Status- + Line. These header fields give information about the server and about + further access to the resource identified by the Request-URI. + + response-header = Accept-Ranges ; Section 14.5 + | Age ; Section 14.6 + | ETag ; Section 14.19 + | Location ; Section 14.30 + | Proxy-Authenticate ; Section 14.33 + + + +Fielding, et al. Standards Track [Page 41] + +RFC 2616 HTTP/1.1 June 1999 + + + | Retry-After ; Section 14.37 + | Server ; Section 14.38 + | Vary ; Section 14.44 + | WWW-Authenticate ; Section 14.47 + + Response-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of response- + header fields if all parties in the communication recognize them to + be response-header fields. Unrecognized header fields are treated as + entity-header fields. + +7 Entity + + Request and Response messages MAY transfer an entity if not otherwise + restricted by the request method or response status code. An entity + consists of entity-header fields and an entity-body, although some + responses will only include the entity-headers. + + In this section, both sender and recipient refer to either the client + or the server, depending on who sends and who receives the entity. + +7.1 Entity Header Fields + + Entity-header fields define metainformation about the entity-body or, + if no body is present, about the resource identified by the request. + Some of this metainformation is OPTIONAL; some might be REQUIRED by + portions of this specification. + + entity-header = Allow ; Section 14.7 + | Content-Encoding ; Section 14.11 + | Content-Language ; Section 14.12 + | Content-Length ; Section 14.13 + | Content-Location ; Section 14.14 + | Content-MD5 ; Section 14.15 + | Content-Range ; Section 14.16 + | Content-Type ; Section 14.17 + | Expires ; Section 14.21 + | Last-Modified ; Section 14.29 + | extension-header + + extension-header = message-header + + The extension-header mechanism allows additional entity-header fields + to be defined without changing the protocol, but these fields cannot + be assumed to be recognizable by the recipient. Unrecognized header + fields SHOULD be ignored by the recipient and MUST be forwarded by + transparent proxies. + + + +Fielding, et al. Standards Track [Page 42] + +RFC 2616 HTTP/1.1 June 1999 + + +7.2 Entity Body + + The entity-body (if any) sent with an HTTP request or response is in + a format and encoding defined by the entity-header fields. + + entity-body = *OCTET + + An entity-body is only present in a message when a message-body is + present, as described in section 4.3. The entity-body is obtained + from the message-body by decoding any Transfer-Encoding that might + have been applied to ensure safe and proper transfer of the message. + +7.2.1 Type + + When an entity-body is included with a message, the data type of that + body is determined via the header fields Content-Type and Content- + Encoding. These define a two-layer, ordered encoding model: + + entity-body := Content-Encoding( Content-Type( data ) ) + + Content-Type specifies the media type of the underlying data. + Content-Encoding may be used to indicate any additional content + codings applied to the data, usually for the purpose of data + compression, that are a property of the requested resource. There is + no default encoding. + + Any HTTP/1.1 message containing an entity-body SHOULD include a + Content-Type header field defining the media type of that body. If + and only if the media type is not given by a Content-Type field, the + recipient MAY attempt to guess the media type via inspection of its + content and/or the name extension(s) of the URI used to identify the + resource. If the media type remains unknown, the recipient SHOULD + treat it as type "application/octet-stream". + +7.2.2 Entity Length + + The entity-length of a message is the length of the message-body + before any transfer-codings have been applied. Section 4.4 defines + how the transfer-length of a message-body is determined. + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 43] + +RFC 2616 HTTP/1.1 June 1999 + + +8 Connections + +8.1 Persistent Connections + +8.1.1 Purpose + + Prior to persistent connections, a separate TCP connection was + established to fetch each URL, increasing the load on HTTP servers + and causing congestion on the Internet. The use of inline images and + other associated data often require a client to make multiple + requests of the same server in a short amount of time. Analysis of + these performance problems and results from a prototype + implementation are available [26] [30]. Implementation experience and + measurements of actual HTTP/1.1 (RFC 2068) implementations show good + results [39]. Alternatives have also been explored, for example, + T/TCP [27]. + + Persistent HTTP connections have a number of advantages: + + - By opening and closing fewer TCP connections, CPU time is saved + in routers and hosts (clients, servers, proxies, gateways, + tunnels, or caches), and memory used for TCP protocol control + blocks can be saved in hosts. + + - HTTP requests and responses can be pipelined on a connection. + Pipelining allows a client to make multiple requests without + waiting for each response, allowing a single TCP connection to + be used much more efficiently, with much lower elapsed time. + + - Network congestion is reduced by reducing the number of packets + caused by TCP opens, and by allowing TCP sufficient time to + determine the congestion state of the network. + + - Latency on subsequent requests is reduced since there is no time + spent in TCP's connection opening handshake. + + - HTTP can evolve more gracefully, since errors can be reported + without the penalty of closing the TCP connection. Clients using + future versions of HTTP might optimistically try a new feature, + but if communicating with an older server, retry with old + semantics after an error is reported. + + HTTP implementations SHOULD implement persistent connections. + + + + + + + + +Fielding, et al. Standards Track [Page 44] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2 Overall Operation + + A significant difference between HTTP/1.1 and earlier versions of + HTTP is that persistent connections are the default behavior of any + HTTP connection. That is, unless otherwise indicated, the client + SHOULD assume that the server will maintain a persistent connection, + even after error responses from the server. + + Persistent connections provide a mechanism by which a client and a + server can signal the close of a TCP connection. This signaling takes + place using the Connection header field (section 14.10). Once a close + has been signaled, the client MUST NOT send any more requests on that + connection. + +8.1.2.1 Negotiation + + An HTTP/1.1 server MAY assume that a HTTP/1.1 client intends to + maintain a persistent connection unless a Connection header including + the connection-token "close" was sent in the request. If the server + chooses to close the connection immediately after sending the + response, it SHOULD send a Connection header including the + connection-token close. + + An HTTP/1.1 client MAY expect a connection to remain open, but would + decide to keep it open based on whether the response from a server + contains a Connection header with the connection-token close. In case + the client does not want to maintain a connection for more than that + request, it SHOULD send a Connection header including the + connection-token close. + + If either the client or the server sends the close token in the + Connection header, that request becomes the last one for the + connection. + + Clients and servers SHOULD NOT assume that a persistent connection is + maintained for HTTP versions less than 1.1 unless it is explicitly + signaled. See section 19.6.2 for more information on backward + compatibility with HTTP/1.0 clients. + + In order to remain persistent, all messages on the connection MUST + have a self-defined message length (i.e., one not defined by closure + of the connection), as described in section 4.4. + + + + + + + + + +Fielding, et al. Standards Track [Page 45] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2.2 Pipelining + + A client that supports persistent connections MAY "pipeline" its + requests (i.e., send multiple requests without waiting for each + response). A server MUST send its responses to those requests in the + same order that the requests were received. + + Clients which assume persistent connections and pipeline immediately + after connection establishment SHOULD be prepared to retry their + connection if the first pipelined attempt fails. If a client does + such a retry, it MUST NOT pipeline before it knows the connection is + persistent. Clients MUST also be prepared to resend their requests if + the server closes the connection before sending all of the + corresponding responses. + + Clients SHOULD NOT pipeline requests using non-idempotent methods or + non-idempotent sequences of methods (see section 9.1.2). Otherwise, a + premature termination of the transport connection could lead to + indeterminate results. A client wishing to send a non-idempotent + request SHOULD wait to send that request until it has received the + response status for the previous request. + +8.1.3 Proxy Servers + + It is especially important that proxies correctly implement the + properties of the Connection header field as specified in section + 14.10. + + The proxy server MUST signal persistent connections separately with + its clients and the origin servers (or other proxy servers) that it + connects to. Each persistent connection applies to only one transport + link. + + A proxy server MUST NOT establish a HTTP/1.1 persistent connection + with an HTTP/1.0 client (but see RFC 2068 [33] for information and + discussion of the problems with the Keep-Alive header implemented by + many HTTP/1.0 clients). + +8.1.4 Practical Considerations + + Servers will usually have some time-out value beyond which they will + no longer maintain an inactive connection. Proxy servers might make + this a higher value since it is likely that the client will be making + more connections through the same server. The use of persistent + connections places no requirements on the length (or existence) of + this time-out for either the client or the server. + + + + + +Fielding, et al. Standards Track [Page 46] + +RFC 2616 HTTP/1.1 June 1999 + + + When a client or server wishes to time-out it SHOULD issue a graceful + close on the transport connection. Clients and servers SHOULD both + constantly watch for the other side of the transport close, and + respond to it as appropriate. If a client or server does not detect + the other side's close promptly it could cause unnecessary resource + drain on the network. + + A client, server, or proxy MAY close the transport connection at any + time. For example, a client might have started to send a new request + at the same time that the server has decided to close the "idle" + connection. From the server's point of view, the connection is being + closed while it was idle, but from the client's point of view, a + request is in progress. + + This means that clients, servers, and proxies MUST be able to recover + from asynchronous close events. Client software SHOULD reopen the + transport connection and retransmit the aborted sequence of requests + without user interaction so long as the request sequence is + idempotent (see section 9.1.2). Non-idempotent methods or sequences + MUST NOT be automatically retried, although user agents MAY offer a + human operator the choice of retrying the request(s). Confirmation by + user-agent software with semantic understanding of the application + MAY substitute for user confirmation. The automatic retry SHOULD NOT + be repeated if the second sequence of requests fails. + + Servers SHOULD always respond to at least one request per connection, + if at all possible. Servers SHOULD NOT close a connection in the + middle of transmitting a response, unless a network or client failure + is suspected. + + Clients that use persistent connections SHOULD limit the number of + simultaneous connections that they maintain to a given server. A + single-user client SHOULD NOT maintain more than 2 connections with + any server or proxy. A proxy SHOULD use up to 2*N connections to + another server or proxy, where N is the number of simultaneously + active users. These guidelines are intended to improve HTTP response + times and avoid congestion. + +8.2 Message Transmission Requirements + +8.2.1 Persistent Connections and Flow Control + + HTTP/1.1 servers SHOULD maintain persistent connections and use TCP's + flow control mechanisms to resolve temporary overloads, rather than + terminating connections with the expectation that clients will retry. + The latter technique can exacerbate network congestion. + + + + + +Fielding, et al. Standards Track [Page 47] + +RFC 2616 HTTP/1.1 June 1999 + + +8.2.2 Monitoring Connections for Error Status Messages + + An HTTP/1.1 (or later) client sending a message-body SHOULD monitor + the network connection for an error status while it is transmitting + the request. If the client sees an error status, it SHOULD + immediately cease transmitting the body. If the body is being sent + using a "chunked" encoding (section 3.6), a zero length chunk and + empty trailer MAY be used to prematurely mark the end of the message. + If the body was preceded by a Content-Length header, the client MUST + close the connection. + +8.2.3 Use of the 100 (Continue) Status + + The purpose of the 100 (Continue) status (see section 10.1.1) is to + allow a client that is sending a request message with a request body + to determine if the origin server is willing to accept the request + (based on the request headers) before the client sends the request + body. In some cases, it might either be inappropriate or highly + inefficient for the client to send the body if the server will reject + the message without looking at the body. + + Requirements for HTTP/1.1 clients: + + - If a client will wait for a 100 (Continue) response before + sending the request body, it MUST send an Expect request-header + field (section 14.20) with the "100-continue" expectation. + + - A client MUST NOT send an Expect request-header field (section + 14.20) with the "100-continue" expectation if it does not intend + to send a request body. + + Because of the presence of older implementations, the protocol allows + ambiguous situations in which a client may send "Expect: 100- + continue" without receiving either a 417 (Expectation Failed) status + or a 100 (Continue) status. Therefore, when a client sends this + header field to an origin server (possibly via a proxy) from which it + has never seen a 100 (Continue) status, the client SHOULD NOT wait + for an indefinite period before sending the request body. + + Requirements for HTTP/1.1 origin servers: + + - Upon receiving a request which includes an Expect request-header + field with the "100-continue" expectation, an origin server MUST + either respond with 100 (Continue) status and continue to read + from the input stream, or respond with a final status code. The + origin server MUST NOT wait for the request body before sending + the 100 (Continue) response. If it responds with a final status + code, it MAY close the transport connection or it MAY continue + + + +Fielding, et al. Standards Track [Page 48] + +RFC 2616 HTTP/1.1 June 1999 + + + to read and discard the rest of the request. It MUST NOT + perform the requested method if it returns a final status code. + + - An origin server SHOULD NOT send a 100 (Continue) response if + the request message does not include an Expect request-header + field with the "100-continue" expectation, and MUST NOT send a + 100 (Continue) response if such a request comes from an HTTP/1.0 + (or earlier) client. There is an exception to this rule: for + compatibility with RFC 2068, a server MAY send a 100 (Continue) + status in response to an HTTP/1.1 PUT or POST request that does + not include an Expect request-header field with the "100- + continue" expectation. This exception, the purpose of which is + to minimize any client processing delays associated with an + undeclared wait for 100 (Continue) status, applies only to + HTTP/1.1 requests, and not to requests with any other HTTP- + version value. + + - An origin server MAY omit a 100 (Continue) response if it has + already received some or all of the request body for the + corresponding request. + + - An origin server that sends a 100 (Continue) response MUST + ultimately send a final status code, once the request body is + received and processed, unless it terminates the transport + connection prematurely. + + - If an origin server receives a request that does not include an + Expect request-header field with the "100-continue" expectation, + the request includes a request body, and the server responds + with a final status code before reading the entire request body + from the transport connection, then the server SHOULD NOT close + the transport connection until it has read the entire request, + or until the client closes the connection. Otherwise, the client + might not reliably receive the response message. However, this + requirement is not be construed as preventing a server from + defending itself against denial-of-service attacks, or from + badly broken client implementations. + + Requirements for HTTP/1.1 proxies: + + - If a proxy receives a request that includes an Expect request- + header field with the "100-continue" expectation, and the proxy + either knows that the next-hop server complies with HTTP/1.1 or + higher, or does not know the HTTP version of the next-hop + server, it MUST forward the request, including the Expect header + field. + + + + + +Fielding, et al. Standards Track [Page 49] + +RFC 2616 HTTP/1.1 June 1999 + + + - If the proxy knows that the version of the next-hop server is + HTTP/1.0 or lower, it MUST NOT forward the request, and it MUST + respond with a 417 (Expectation Failed) status. + + - Proxies SHOULD maintain a cache recording the HTTP version + numbers received from recently-referenced next-hop servers. + + - A proxy MUST NOT forward a 100 (Continue) response if the + request message was received from an HTTP/1.0 (or earlier) + client and did not include an Expect request-header field with + the "100-continue" expectation. This requirement overrides the + general rule for forwarding of 1xx responses (see section 10.1). + +8.2.4 Client Behavior if Server Prematurely Closes Connection + + If an HTTP/1.1 client sends a request which includes a request body, + but which does not include an Expect request-header field with the + "100-continue" expectation, and if the client is not directly + connected to an HTTP/1.1 origin server, and if the client sees the + connection close before receiving any status from the server, the + client SHOULD retry the request. If the client does retry this + request, it MAY use the following "binary exponential backoff" + algorithm to be assured of obtaining a reliable response: + + 1. Initiate a new connection to the server + + 2. Transmit the request-headers + + 3. Initialize a variable R to the estimated round-trip time to the + server (e.g., based on the time it took to establish the + connection), or to a constant value of 5 seconds if the round- + trip time is not available. + + 4. Compute T = R * (2**N), where N is the number of previous + retries of this request. + + 5. Wait either for an error response from the server, or for T + seconds (whichever comes first) + + 6. If no error response is received, after T seconds transmit the + body of the request. + + 7. If client sees that the connection is closed prematurely, + repeat from step 1 until the request is accepted, an error + response is received, or the user becomes impatient and + terminates the retry process. + + + + + +Fielding, et al. Standards Track [Page 50] + +RFC 2616 HTTP/1.1 June 1999 + + + If at any point an error status is received, the client + + - SHOULD NOT continue and + + - SHOULD close the connection if it has not completed sending the + request message. + +9 Method Definitions + + The set of common methods for HTTP/1.1 is defined below. Although + this set can be expanded, additional methods cannot be assumed to + share the same semantics for separately extended clients and servers. + + The Host request-header field (section 14.23) MUST accompany all + HTTP/1.1 requests. + +9.1 Safe and Idempotent Methods + +9.1.1 Safe Methods + + Implementors should be aware that the software represents the user in + their interactions over the Internet, and should be careful to allow + the user to be aware of any actions they might take which may have an + unexpected significance to themselves or others. + + In particular, the convention has been established that the GET and + HEAD methods SHOULD NOT have the significance of taking an action + other than retrieval. These methods ought to be considered "safe". + This allows user agents to represent other methods, such as POST, PUT + and DELETE, in a special way, so that the user is made aware of the + fact that a possibly unsafe action is being requested. + + Naturally, it is not possible to ensure that the server does not + generate side-effects as a result of performing a GET request; in + fact, some dynamic resources consider that a feature. The important + distinction here is that the user did not request the side-effects, + so therefore cannot be held accountable for them. + +9.1.2 Idempotent Methods + + Methods can also have the property of "idempotence" in that (aside + from error or expiration issues) the side-effects of N > 0 identical + requests is the same as for a single request. The methods GET, HEAD, + PUT and DELETE share this property. Also, the methods OPTIONS and + TRACE SHOULD NOT have side effects, and so are inherently idempotent. + + + + + + +Fielding, et al. Standards Track [Page 51] + +RFC 2616 HTTP/1.1 June 1999 + + + However, it is possible that a sequence of several requests is non- + idempotent, even if all of the methods executed in that sequence are + idempotent. (A sequence is idempotent if a single execution of the + entire sequence always yields a result that is not changed by a + reexecution of all, or part, of that sequence.) For example, a + sequence is non-idempotent if its result depends on a value that is + later modified in the same sequence. + + A sequence that never has side effects is idempotent, by definition + (provided that no concurrent operations are being executed on the + same set of resources). + +9.2 OPTIONS + + The OPTIONS method represents a request for information about the + communication options available on the request/response chain + identified by the Request-URI. This method allows the client to + determine the options and/or requirements associated with a resource, + or the capabilities of a server, without implying a resource action + or initiating a resource retrieval. + + Responses to this method are not cacheable. + + If the OPTIONS request includes an entity-body (as indicated by the + presence of Content-Length or Transfer-Encoding), then the media type + MUST be indicated by a Content-Type field. Although this + specification does not define any use for such a body, future + extensions to HTTP might use the OPTIONS body to make more detailed + queries on the server. A server that does not support such an + extension MAY discard the request body. + + If the Request-URI is an asterisk ("*"), the OPTIONS request is + intended to apply to the server in general rather than to a specific + resource. Since a server's communication options typically depend on + the resource, the "*" request is only useful as a "ping" or "no-op" + type of method; it does nothing beyond allowing the client to test + the capabilities of the server. For example, this can be used to test + a proxy for HTTP/1.1 compliance (or lack thereof). + + If the Request-URI is not an asterisk, the OPTIONS request applies + only to the options that are available when communicating with that + resource. + + A 200 response SHOULD include any header fields that indicate + optional features implemented by the server and applicable to that + resource (e.g., Allow), possibly including extensions not defined by + this specification. The response body, if any, SHOULD also include + information about the communication options. The format for such a + + + +Fielding, et al. Standards Track [Page 52] + +RFC 2616 HTTP/1.1 June 1999 + + + body is not defined by this specification, but might be defined by + future extensions to HTTP. Content negotiation MAY be used to select + the appropriate response format. If no response body is included, the + response MUST include a Content-Length field with a field-value of + "0". + + The Max-Forwards request-header field MAY be used to target a + specific proxy in the request chain. When a proxy receives an OPTIONS + request on an absoluteURI for which request forwarding is permitted, + the proxy MUST check for a Max-Forwards field. If the Max-Forwards + field-value is zero ("0"), the proxy MUST NOT forward the message; + instead, the proxy SHOULD respond with its own communication options. + If the Max-Forwards field-value is an integer greater than zero, the + proxy MUST decrement the field-value when it forwards the request. If + no Max-Forwards field is present in the request, then the forwarded + request MUST NOT include a Max-Forwards field. + +9.3 GET + + The GET method means retrieve whatever information (in the form of an + entity) is identified by the Request-URI. If the Request-URI refers + to a data-producing process, it is the produced data which shall be + returned as the entity in the response and not the source text of the + process, unless that text happens to be the output of the process. + + The semantics of the GET method change to a "conditional GET" if the + request message includes an If-Modified-Since, If-Unmodified-Since, + If-Match, If-None-Match, or If-Range header field. A conditional GET + method requests that the entity be transferred only under the + circumstances described by the conditional header field(s). The + conditional GET method is intended to reduce unnecessary network + usage by allowing cached entities to be refreshed without requiring + multiple requests or transferring data already held by the client. + + The semantics of the GET method change to a "partial GET" if the + request message includes a Range header field. A partial GET requests + that only part of the entity be transferred, as described in section + 14.35. The partial GET method is intended to reduce unnecessary + network usage by allowing partially-retrieved entities to be + completed without transferring data already held by the client. + + The response to a GET request is cacheable if and only if it meets + the requirements for HTTP caching described in section 13. + + See section 15.1.3 for security considerations when used for forms. + + + + + + +Fielding, et al. Standards Track [Page 53] + +RFC 2616 HTTP/1.1 June 1999 + + +9.4 HEAD + + The HEAD method is identical to GET except that the server MUST NOT + return a message-body in the response. The metainformation contained + in the HTTP headers in response to a HEAD request SHOULD be identical + to the information sent in response to a GET request. This method can + be used for obtaining metainformation about the entity implied by the + request without transferring the entity-body itself. This method is + often used for testing hypertext links for validity, accessibility, + and recent modification. + + The response to a HEAD request MAY be cacheable in the sense that the + information contained in the response MAY be used to update a + previously cached entity from that resource. If the new field values + indicate that the cached entity differs from the current entity (as + would be indicated by a change in Content-Length, Content-MD5, ETag + or Last-Modified), then the cache MUST treat the cache entry as + stale. + +9.5 POST + + The POST method is used to request that the origin server accept the + entity enclosed in the request as a new subordinate of the resource + identified by the Request-URI in the Request-Line. POST is designed + to allow a uniform method to cover the following functions: + + - Annotation of existing resources; + + - Posting a message to a bulletin board, newsgroup, mailing list, + or similar group of articles; + + - Providing a block of data, such as the result of submitting a + form, to a data-handling process; + + - Extending a database through an append operation. + + The actual function performed by the POST method is determined by the + server and is usually dependent on the Request-URI. The posted entity + is subordinate to that URI in the same way that a file is subordinate + to a directory containing it, a news article is subordinate to a + newsgroup to which it is posted, or a record is subordinate to a + database. + + The action performed by the POST method might not result in a + resource that can be identified by a URI. In this case, either 200 + (OK) or 204 (No Content) is the appropriate response status, + depending on whether or not the response includes an entity that + describes the result. + + + +Fielding, et al. Standards Track [Page 54] + +RFC 2616 HTTP/1.1 June 1999 + + + If a resource has been created on the origin server, the response + SHOULD be 201 (Created) and contain an entity which describes the + status of the request and refers to the new resource, and a Location + header (see section 14.30). + + Responses to this method are not cacheable, unless the response + includes appropriate Cache-Control or Expires header fields. However, + the 303 (See Other) response can be used to direct the user agent to + retrieve a cacheable resource. + + POST requests MUST obey the message transmission requirements set out + in section 8.2. + + See section 15.1.3 for security considerations. + +9.6 PUT + + The PUT method requests that the enclosed entity be stored under the + supplied Request-URI. If the Request-URI refers to an already + existing resource, the enclosed entity SHOULD be considered as a + modified version of the one residing on the origin server. If the + Request-URI does not point to an existing resource, and that URI is + capable of being defined as a new resource by the requesting user + agent, the origin server can create the resource with that URI. If a + new resource is created, the origin server MUST inform the user agent + via the 201 (Created) response. If an existing resource is modified, + either the 200 (OK) or 204 (No Content) response codes SHOULD be sent + to indicate successful completion of the request. If the resource + could not be created or modified with the Request-URI, an appropriate + error response SHOULD be given that reflects the nature of the + problem. The recipient of the entity MUST NOT ignore any Content-* + (e.g. Content-Range) headers that it does not understand or implement + and MUST return a 501 (Not Implemented) response in such cases. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + + The fundamental difference between the POST and PUT requests is + reflected in the different meaning of the Request-URI. The URI in a + POST request identifies the resource that will handle the enclosed + entity. That resource might be a data-accepting process, a gateway to + some other protocol, or a separate entity that accepts annotations. + In contrast, the URI in a PUT request identifies the entity enclosed + with the request -- the user agent knows what URI is intended and the + server MUST NOT attempt to apply the request to some other resource. + If the server desires that the request be applied to a different URI, + + + + +Fielding, et al. Standards Track [Page 55] + +RFC 2616 HTTP/1.1 June 1999 + + + it MUST send a 301 (Moved Permanently) response; the user agent MAY + then make its own decision regarding whether or not to redirect the + request. + + A single resource MAY be identified by many different URIs. For + example, an article might have a URI for identifying "the current + version" which is separate from the URI identifying each particular + version. In this case, a PUT request on a general URI might result in + several other URIs being defined by the origin server. + + HTTP/1.1 does not define how a PUT method affects the state of an + origin server. + + PUT requests MUST obey the message transmission requirements set out + in section 8.2. + + Unless otherwise specified for a particular entity-header, the + entity-headers in the PUT request SHOULD be applied to the resource + created or modified by the PUT. + +9.7 DELETE + + The DELETE method requests that the origin server delete the resource + identified by the Request-URI. This method MAY be overridden by human + intervention (or other means) on the origin server. The client cannot + be guaranteed that the operation has been carried out, even if the + status code returned from the origin server indicates that the action + has been completed successfully. However, the server SHOULD NOT + indicate success unless, at the time the response is given, it + intends to delete the resource or move it to an inaccessible + location. + + A successful response SHOULD be 200 (OK) if the response includes an + entity describing the status, 202 (Accepted) if the action has not + yet been enacted, or 204 (No Content) if the action has been enacted + but the response does not include an entity. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + +9.8 TRACE + + The TRACE method is used to invoke a remote, application-layer loop- + back of the request message. The final recipient of the request + SHOULD reflect the message received back to the client as the + entity-body of a 200 (OK) response. The final recipient is either the + + + + +Fielding, et al. Standards Track [Page 56] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server or the first proxy or gateway to receive a Max-Forwards + value of zero (0) in the request (see section 14.31). A TRACE request + MUST NOT include an entity. + + TRACE allows the client to see what is being received at the other + end of the request chain and use that data for testing or diagnostic + information. The value of the Via header field (section 14.45) is of + particular interest, since it acts as a trace of the request chain. + Use of the Max-Forwards header field allows the client to limit the + length of the request chain, which is useful for testing a chain of + proxies forwarding messages in an infinite loop. + + If the request is valid, the response SHOULD contain the entire + request message in the entity-body, with a Content-Type of + "message/http". Responses to this method MUST NOT be cached. + +9.9 CONNECT + + This specification reserves the method name CONNECT for use with a + proxy that can dynamically switch to being a tunnel (e.g. SSL + tunneling [44]). + +10 Status Code Definitions + + Each Status-Code is described below, including a description of which + method(s) it can follow and any metainformation required in the + response. + +10.1 Informational 1xx + + This class of status code indicates a provisional response, + consisting only of the Status-Line and optional headers, and is + terminated by an empty line. There are no required headers for this + class of status code. Since HTTP/1.0 did not define any 1xx status + codes, servers MUST NOT send a 1xx response to an HTTP/1.0 client + except under experimental conditions. + + A client MUST be prepared to accept one or more 1xx status responses + prior to a regular response, even if the client does not expect a 100 + (Continue) status message. Unexpected 1xx status responses MAY be + ignored by a user agent. + + Proxies MUST forward 1xx responses, unless the connection between the + proxy and its client has been closed, or unless the proxy itself + requested the generation of the 1xx response. (For example, if a + + + + + + +Fielding, et al. Standards Track [Page 57] + +RFC 2616 HTTP/1.1 June 1999 + + + proxy adds a "Expect: 100-continue" field when it forwards a request, + then it need not forward the corresponding 100 (Continue) + response(s).) + +10.1.1 100 Continue + + The client SHOULD continue with its request. This interim response is + used to inform the client that the initial part of the request has + been received and has not yet been rejected by the server. The client + SHOULD continue by sending the remainder of the request or, if the + request has already been completed, ignore this response. The server + MUST send a final response after the request has been completed. See + section 8.2.3 for detailed discussion of the use and handling of this + status code. + +10.1.2 101 Switching Protocols + + The server understands and is willing to comply with the client's + request, via the Upgrade message header field (section 14.42), for a + change in the application protocol being used on this connection. The + server will switch protocols to those defined by the response's + Upgrade header field immediately after the empty line which + terminates the 101 response. + + The protocol SHOULD be switched only when it is advantageous to do + so. For example, switching to a newer version of HTTP is advantageous + over older versions, and switching to a real-time, synchronous + protocol might be advantageous when delivering resources that use + such features. + +10.2 Successful 2xx + + This class of status code indicates that the client's request was + successfully received, understood, and accepted. + +10.2.1 200 OK + + The request has succeeded. The information returned with the response + is dependent on the method used in the request, for example: + + GET an entity corresponding to the requested resource is sent in + the response; + + HEAD the entity-header fields corresponding to the requested + resource are sent in the response without any message-body; + + POST an entity describing or containing the result of the action; + + + + +Fielding, et al. Standards Track [Page 58] + +RFC 2616 HTTP/1.1 June 1999 + + + TRACE an entity containing the request message as received by the + end server. + +10.2.2 201 Created + + The request has been fulfilled and resulted in a new resource being + created. The newly created resource can be referenced by the URI(s) + returned in the entity of the response, with the most specific URI + for the resource given by a Location header field. The response + SHOULD include an entity containing a list of resource + characteristics and location(s) from which the user or user agent can + choose the one most appropriate. The entity format is specified by + the media type given in the Content-Type header field. The origin + server MUST create the resource before returning the 201 status code. + If the action cannot be carried out immediately, the server SHOULD + respond with 202 (Accepted) response instead. + + A 201 response MAY contain an ETag response header field indicating + the current value of the entity tag for the requested variant just + created, see section 14.19. + +10.2.3 202 Accepted + + The request has been accepted for processing, but the processing has + not been completed. The request might or might not eventually be + acted upon, as it might be disallowed when processing actually takes + place. There is no facility for re-sending a status code from an + asynchronous operation such as this. + + The 202 response is intentionally non-committal. Its purpose is to + allow a server to accept a request for some other process (perhaps a + batch-oriented process that is only run once per day) without + requiring that the user agent's connection to the server persist + until the process is completed. The entity returned with this + response SHOULD include an indication of the request's current status + and either a pointer to a status monitor or some estimate of when the + user can expect the request to be fulfilled. + +10.2.4 203 Non-Authoritative Information + + The returned metainformation in the entity-header is not the + definitive set as available from the origin server, but is gathered + from a local or a third-party copy. The set presented MAY be a subset + or superset of the original version. For example, including local + annotation information about the resource might result in a superset + of the metainformation known by the origin server. Use of this + response code is not required and is only appropriate when the + response would otherwise be 200 (OK). + + + +Fielding, et al. Standards Track [Page 59] + +RFC 2616 HTTP/1.1 June 1999 + + +10.2.5 204 No Content + + The server has fulfilled the request but does not need to return an + entity-body, and might want to return updated metainformation. The + response MAY include new or updated metainformation in the form of + entity-headers, which if present SHOULD be associated with the + requested variant. + + If the client is a user agent, it SHOULD NOT change its document view + from that which caused the request to be sent. This response is + primarily intended to allow input for actions to take place without + causing a change to the user agent's active document view, although + any new or updated metainformation SHOULD be applied to the document + currently in the user agent's active view. + + The 204 response MUST NOT include a message-body, and thus is always + terminated by the first empty line after the header fields. + +10.2.6 205 Reset Content + + The server has fulfilled the request and the user agent SHOULD reset + the document view which caused the request to be sent. This response + is primarily intended to allow input for actions to take place via + user input, followed by a clearing of the form in which the input is + given so that the user can easily initiate another input action. The + response MUST NOT include an entity. + +10.2.7 206 Partial Content + + The server has fulfilled the partial GET request for the resource. + The request MUST have included a Range header field (section 14.35) + indicating the desired range, and MAY have included an If-Range + header field (section 14.27) to make the request conditional. + + The response MUST include the following header fields: + + - Either a Content-Range header field (section 14.16) indicating + the range included with this response, or a multipart/byteranges + Content-Type including Content-Range fields for each part. If a + Content-Length header field is present in the response, its + value MUST match the actual number of OCTETs transmitted in the + message-body. + + - Date + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + + + +Fielding, et al. Standards Track [Page 60] + +RFC 2616 HTTP/1.1 June 1999 + + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the 206 response is the result of an If-Range request that used a + strong cache validator (see section 13.3.3), the response SHOULD NOT + include other entity-headers. If the response is the result of an + If-Range request that used a weak validator, the response MUST NOT + include other entity-headers; this prevents inconsistencies between + cached entity-bodies and updated headers. Otherwise, the response + MUST include all of the entity-headers that would have been returned + with a 200 (OK) response to the same request. + + A cache MUST NOT combine a 206 response with other previously cached + content if the ETag or Last-Modified headers do not match exactly, + see 13.5.4. + + A cache that does not support the Range and Content-Range headers + MUST NOT cache 206 (Partial) responses. + +10.3 Redirection 3xx + + This class of status code indicates that further action needs to be + taken by the user agent in order to fulfill the request. The action + required MAY be carried out by the user agent without interaction + with the user if and only if the method used in the second request is + GET or HEAD. A client SHOULD detect infinite redirection loops, since + such loops generate network traffic for each redirection. + + Note: previous versions of this specification recommended a + maximum of five redirections. Content developers should be aware + that there might be clients that implement such a fixed + limitation. + +10.3.1 300 Multiple Choices + + The requested resource corresponds to any one of a set of + representations, each with its own specific location, and agent- + driven negotiation information (section 12) is being provided so that + the user (or user agent) can select a preferred representation and + redirect its request to that location. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of resource characteristics and location(s) from + which the user or user agent can choose the one most appropriate. The + entity format is specified by the media type given in the Content- + Type header field. Depending upon the format and the capabilities of + + + + +Fielding, et al. Standards Track [Page 61] + +RFC 2616 HTTP/1.1 June 1999 + + + the user agent, selection of the most appropriate choice MAY be + performed automatically. However, this specification does not define + any standard for such automatic selection. + + If the server has a preferred choice of representation, it SHOULD + include the specific URI for that representation in the Location + field; user agents MAY use the Location field value for automatic + redirection. This response is cacheable unless indicated otherwise. + +10.3.2 301 Moved Permanently + + The requested resource has been assigned a new permanent URI and any + future references to this resource SHOULD use one of the returned + URIs. Clients with link editing capabilities ought to automatically + re-link references to the Request-URI to one or more of the new + references returned by the server, where possible. This response is + cacheable unless indicated otherwise. + + The new permanent URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + If the 301 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: When automatically redirecting a POST request after + receiving a 301 status code, some existing HTTP/1.0 user agents + will erroneously change it into a GET request. + +10.3.3 302 Found + + The requested resource resides temporarily under a different URI. + Since the redirection might be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + + + + + + +Fielding, et al. Standards Track [Page 62] + +RFC 2616 HTTP/1.1 June 1999 + + + If the 302 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: RFC 1945 and RFC 2068 specify that the client is not allowed + to change the method on the redirected request. However, most + existing user agent implementations treat 302 as if it were a 303 + response, performing a GET on the Location field-value regardless + of the original request method. The status codes 303 and 307 have + been added for servers that wish to make unambiguously clear which + kind of reaction is expected of the client. + +10.3.4 303 See Other + + The response to the request can be found under a different URI and + SHOULD be retrieved using a GET method on that resource. This method + exists primarily to allow the output of a POST-activated script to + redirect the user agent to a selected resource. The new URI is not a + substitute reference for the originally requested resource. The 303 + response MUST NOT be cached, but the response to the second + (redirected) request might be cacheable. + + The different URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + Note: Many pre-HTTP/1.1 user agents do not understand the 303 + status. When interoperability with such clients is a concern, the + 302 status code may be used instead, since most user agents react + to a 302 response as described here for 303. + +10.3.5 304 Not Modified + + If the client has performed a conditional GET request and access is + allowed, but the document has not been modified, the server SHOULD + respond with this status code. The 304 response MUST NOT contain a + message-body, and thus is always terminated by the first empty line + after the header fields. + + The response MUST include the following header fields: + + - Date, unless its omission is required by section 14.18.1 + + + + + + + +Fielding, et al. Standards Track [Page 63] + +RFC 2616 HTTP/1.1 June 1999 + + + If a clockless origin server obeys these rules, and proxies and + clients add their own Date to any response received without one (as + already specified by [RFC 2068], section 14.19), caches will operate + correctly. + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the conditional GET used a strong cache validator (see section + 13.3.3), the response SHOULD NOT include other entity-headers. + Otherwise (i.e., the conditional GET used a weak validator), the + response MUST NOT include other entity-headers; this prevents + inconsistencies between cached entity-bodies and updated headers. + + If a 304 response indicates an entity not currently cached, then the + cache MUST disregard the response and repeat the request without the + conditional. + + If a cache uses a received 304 response to update a cache entry, the + cache MUST update the entry to reflect any new field values given in + the response. + +10.3.6 305 Use Proxy + + The requested resource MUST be accessed through the proxy given by + the Location field. The Location field gives the URI of the proxy. + The recipient is expected to repeat this single request via the + proxy. 305 responses MUST only be generated by origin servers. + + Note: RFC 2068 was not clear that 305 was intended to redirect a + single request, and to be generated by origin servers only. Not + observing these limitations has significant security consequences. + +10.3.7 306 (Unused) + + The 306 status code was used in a previous version of the + specification, is no longer used, and the code is reserved. + + + + + + + + + + +Fielding, et al. Standards Track [Page 64] + +RFC 2616 HTTP/1.1 June 1999 + + +10.3.8 307 Temporary Redirect + + The requested resource resides temporarily under a different URI. + Since the redirection MAY be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s) , since many pre-HTTP/1.1 user agents do not + understand the 307 status. Therefore, the note SHOULD contain the + information necessary for a user to repeat the original request on + the new URI. + + If the 307 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + +10.4 Client Error 4xx + + The 4xx class of status code is intended for cases in which the + client seems to have erred. Except when responding to a HEAD request, + the server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. These status codes are applicable to any request method. + User agents SHOULD display any included entity to the user. + + If the client is sending data, a server implementation using TCP + SHOULD be careful to ensure that the client acknowledges receipt of + the packet(s) containing the response, before the server closes the + input connection. If the client continues sending data to the server + after the close, the server's TCP stack will send a reset packet to + the client, which may erase the client's unacknowledged input buffers + before they can be read and interpreted by the HTTP application. + +10.4.1 400 Bad Request + + The request could not be understood by the server due to malformed + syntax. The client SHOULD NOT repeat the request without + modifications. + + + + + + + + +Fielding, et al. Standards Track [Page 65] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.2 401 Unauthorized + + The request requires user authentication. The response MUST include a + WWW-Authenticate header field (section 14.47) containing a challenge + applicable to the requested resource. The client MAY repeat the + request with a suitable Authorization header field (section 14.8). If + the request already included Authorization credentials, then the 401 + response indicates that authorization has been refused for those + credentials. If the 401 response contains the same challenge as the + prior response, and the user agent has already attempted + authentication at least once, then the user SHOULD be presented the + entity that was given in the response, since that entity might + include relevant diagnostic information. HTTP access authentication + is explained in "HTTP Authentication: Basic and Digest Access + Authentication" [43]. + +10.4.3 402 Payment Required + + This code is reserved for future use. + +10.4.4 403 Forbidden + + The server understood the request, but is refusing to fulfill it. + Authorization will not help and the request SHOULD NOT be repeated. + If the request method was not HEAD and the server wishes to make + public why the request has not been fulfilled, it SHOULD describe the + reason for the refusal in the entity. If the server does not wish to + make this information available to the client, the status code 404 + (Not Found) can be used instead. + +10.4.5 404 Not Found + + The server has not found anything matching the Request-URI. No + indication is given of whether the condition is temporary or + permanent. The 410 (Gone) status code SHOULD be used if the server + knows, through some internally configurable mechanism, that an old + resource is permanently unavailable and has no forwarding address. + This status code is commonly used when the server does not wish to + reveal exactly why the request has been refused, or when no other + response is applicable. + +10.4.6 405 Method Not Allowed + + The method specified in the Request-Line is not allowed for the + resource identified by the Request-URI. The response MUST include an + Allow header containing a list of valid methods for the requested + resource. + + + + +Fielding, et al. Standards Track [Page 66] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.7 406 Not Acceptable + + The resource identified by the request is only capable of generating + response entities which have content characteristics not acceptable + according to the accept headers sent in the request. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of available entity characteristics and location(s) + from which the user or user agent can choose the one most + appropriate. The entity format is specified by the media type given + in the Content-Type header field. Depending upon the format and the + capabilities of the user agent, selection of the most appropriate + choice MAY be performed automatically. However, this specification + does not define any standard for such automatic selection. + + Note: HTTP/1.1 servers are allowed to return responses which are + not acceptable according to the accept headers sent in the + request. In some cases, this may even be preferable to sending a + 406 response. User agents are encouraged to inspect the headers of + an incoming response to determine if it is acceptable. + + If the response could be unacceptable, a user agent SHOULD + temporarily stop receipt of more data and query the user for a + decision on further actions. + +10.4.8 407 Proxy Authentication Required + + This code is similar to 401 (Unauthorized), but indicates that the + client must first authenticate itself with the proxy. The proxy MUST + return a Proxy-Authenticate header field (section 14.33) containing a + challenge applicable to the proxy for the requested resource. The + client MAY repeat the request with a suitable Proxy-Authorization + header field (section 14.34). HTTP access authentication is explained + in "HTTP Authentication: Basic and Digest Access Authentication" + [43]. + +10.4.9 408 Request Timeout + + The client did not produce a request within the time that the server + was prepared to wait. The client MAY repeat the request without + modifications at any later time. + +10.4.10 409 Conflict + + The request could not be completed due to a conflict with the current + state of the resource. This code is only allowed in situations where + it is expected that the user might be able to resolve the conflict + and resubmit the request. The response body SHOULD include enough + + + +Fielding, et al. Standards Track [Page 67] + +RFC 2616 HTTP/1.1 June 1999 + + + information for the user to recognize the source of the conflict. + Ideally, the response entity would include enough information for the + user or user agent to fix the problem; however, that might not be + possible and is not required. + + Conflicts are most likely to occur in response to a PUT request. For + example, if versioning were being used and the entity being PUT + included changes to a resource which conflict with those made by an + earlier (third-party) request, the server might use the 409 response + to indicate that it can't complete the request. In this case, the + response entity would likely contain a list of the differences + between the two versions in a format defined by the response + Content-Type. + +10.4.11 410 Gone + + The requested resource is no longer available at the server and no + forwarding address is known. This condition is expected to be + considered permanent. Clients with link editing capabilities SHOULD + delete references to the Request-URI after user approval. If the + server does not know, or has no facility to determine, whether or not + the condition is permanent, the status code 404 (Not Found) SHOULD be + used instead. This response is cacheable unless indicated otherwise. + + The 410 response is primarily intended to assist the task of web + maintenance by notifying the recipient that the resource is + intentionally unavailable and that the server owners desire that + remote links to that resource be removed. Such an event is common for + limited-time, promotional services and for resources belonging to + individuals no longer working at the server's site. It is not + necessary to mark all permanently unavailable resources as "gone" or + to keep the mark for any length of time -- that is left to the + discretion of the server owner. + +10.4.12 411 Length Required + + The server refuses to accept the request without a defined Content- + Length. The client MAY repeat the request if it adds a valid + Content-Length header field containing the length of the message-body + in the request message. + +10.4.13 412 Precondition Failed + + The precondition given in one or more of the request-header fields + evaluated to false when it was tested on the server. This response + code allows the client to place preconditions on the current resource + metainformation (header field data) and thus prevent the requested + method from being applied to a resource other than the one intended. + + + +Fielding, et al. Standards Track [Page 68] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.14 413 Request Entity Too Large + + The server is refusing to process a request because the request + entity is larger than the server is willing or able to process. The + server MAY close the connection to prevent the client from continuing + the request. + + If the condition is temporary, the server SHOULD include a Retry- + After header field to indicate that it is temporary and after what + time the client MAY try again. + +10.4.15 414 Request-URI Too Long + + The server is refusing to service the request because the Request-URI + is longer than the server is willing to interpret. This rare + condition is only likely to occur when a client has improperly + converted a POST request to a GET request with long query + information, when the client has descended into a URI "black hole" of + redirection (e.g., a redirected URI prefix that points to a suffix of + itself), or when the server is under attack by a client attempting to + exploit security holes present in some servers using fixed-length + buffers for reading or manipulating the Request-URI. + +10.4.16 415 Unsupported Media Type + + The server is refusing to service the request because the entity of + the request is in a format not supported by the requested resource + for the requested method. + +10.4.17 416 Requested Range Not Satisfiable + + A server SHOULD return a response with this status code if a request + included a Range request-header field (section 14.35), and none of + the range-specifier values in this field overlap the current extent + of the selected resource, and the request did not include an If-Range + request-header field. (For byte-ranges, this means that the first- + byte-pos of all of the byte-range-spec values were greater than the + current length of the selected resource.) + + When this status code is returned for a byte-range request, the + response SHOULD include a Content-Range entity-header field + specifying the current length of the selected resource (see section + 14.16). This response MUST NOT use the multipart/byteranges content- + type. + + + + + + + +Fielding, et al. Standards Track [Page 69] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.18 417 Expectation Failed + + The expectation given in an Expect request-header field (see section + 14.20) could not be met by this server, or, if the server is a proxy, + the server has unambiguous evidence that the request could not be met + by the next-hop server. + +10.5 Server Error 5xx + + Response status codes beginning with the digit "5" indicate cases in + which the server is aware that it has erred or is incapable of + performing the request. Except when responding to a HEAD request, the + server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. User agents SHOULD display any included entity to the + user. These response codes are applicable to any request method. + +10.5.1 500 Internal Server Error + + The server encountered an unexpected condition which prevented it + from fulfilling the request. + +10.5.2 501 Not Implemented + + The server does not support the functionality required to fulfill the + request. This is the appropriate response when the server does not + recognize the request method and is not capable of supporting it for + any resource. + +10.5.3 502 Bad Gateway + + The server, while acting as a gateway or proxy, received an invalid + response from the upstream server it accessed in attempting to + fulfill the request. + +10.5.4 503 Service Unavailable + + The server is currently unable to handle the request due to a + temporary overloading or maintenance of the server. The implication + is that this is a temporary condition which will be alleviated after + some delay. If known, the length of the delay MAY be indicated in a + Retry-After header. If no Retry-After is given, the client SHOULD + handle the response as it would for a 500 response. + + Note: The existence of the 503 status code does not imply that a + server must use it when becoming overloaded. Some servers may wish + to simply refuse the connection. + + + + +Fielding, et al. Standards Track [Page 70] + +RFC 2616 HTTP/1.1 June 1999 + + +10.5.5 504 Gateway Timeout + + The server, while acting as a gateway or proxy, did not receive a + timely response from the upstream server specified by the URI (e.g. + HTTP, FTP, LDAP) or some other auxiliary server (e.g. DNS) it needed + to access in attempting to complete the request. + + Note: Note to implementors: some deployed proxies are known to + return 400 or 500 when DNS lookups time out. + +10.5.6 505 HTTP Version Not Supported + + The server does not support, or refuses to support, the HTTP protocol + version that was used in the request message. The server is + indicating that it is unable or unwilling to complete the request + using the same major version as the client, as described in section + 3.1, other than with this error message. The response SHOULD contain + an entity describing why that version is not supported and what other + protocols are supported by that server. + +11 Access Authentication + + HTTP provides several OPTIONAL challenge-response authentication + mechanisms which can be used by a server to challenge a client + request and by a client to provide authentication information. The + general framework for access authentication, and the specification of + "basic" and "digest" authentication, are specified in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. This + specification adopts the definitions of "challenge" and "credentials" + from that specification. + +12 Content Negotiation + + Most HTTP responses include an entity which contains information for + interpretation by a human user. Naturally, it is desirable to supply + the user with the "best available" entity corresponding to the + request. Unfortunately for servers and caches, not all users have the + same preferences for what is "best," and not all user agents are + equally capable of rendering all entity types. For that reason, HTTP + has provisions for several mechanisms for "content negotiation" -- + the process of selecting the best representation for a given response + when there are multiple representations available. + + Note: This is not called "format negotiation" because the + alternate representations may be of the same media type, but use + different capabilities of that type, be in different languages, + etc. + + + + +Fielding, et al. Standards Track [Page 71] + +RFC 2616 HTTP/1.1 June 1999 + + + Any response containing an entity-body MAY be subject to negotiation, + including error responses. + + There are two kinds of content negotiation which are possible in + HTTP: server-driven and agent-driven negotiation. These two kinds of + negotiation are orthogonal and thus may be used separately or in + combination. One method of combination, referred to as transparent + negotiation, occurs when a cache uses the agent-driven negotiation + information provided by the origin server in order to provide + server-driven negotiation for subsequent requests. + +12.1 Server-driven Negotiation + + If the selection of the best representation for a response is made by + an algorithm located at the server, it is called server-driven + negotiation. Selection is based on the available representations of + the response (the dimensions over which it can vary; e.g. language, + content-coding, etc.) and the contents of particular header fields in + the request message or on other information pertaining to the request + (such as the network address of the client). + + Server-driven negotiation is advantageous when the algorithm for + selecting from among the available representations is difficult to + describe to the user agent, or when the server desires to send its + "best guess" to the client along with the first response (hoping to + avoid the round-trip delay of a subsequent request if the "best + guess" is good enough for the user). In order to improve the server's + guess, the user agent MAY include request header fields (Accept, + Accept-Language, Accept-Encoding, etc.) which describe its + preferences for such a response. + + Server-driven negotiation has disadvantages: + + 1. It is impossible for the server to accurately determine what + might be "best" for any given user, since that would require + complete knowledge of both the capabilities of the user agent + and the intended use for the response (e.g., does the user want + to view it on screen or print it on paper?). + + 2. Having the user agent describe its capabilities in every + request can be both very inefficient (given that only a small + percentage of responses have multiple representations) and a + potential violation of the user's privacy. + + 3. It complicates the implementation of an origin server and the + algorithms for generating responses to a request. + + + + + +Fielding, et al. Standards Track [Page 72] + +RFC 2616 HTTP/1.1 June 1999 + + + 4. It may limit a public cache's ability to use the same response + for multiple user's requests. + + HTTP/1.1 includes the following request-header fields for enabling + server-driven negotiation through description of user agent + capabilities and user preferences: Accept (section 14.1), Accept- + Charset (section 14.2), Accept-Encoding (section 14.3), Accept- + Language (section 14.4), and User-Agent (section 14.43). However, an + origin server is not limited to these dimensions and MAY vary the + response based on any aspect of the request, including information + outside the request-header fields or within extension header fields + not defined by this specification. + + The Vary header field can be used to express the parameters the + server uses to select a representation that is subject to server- + driven negotiation. See section 13.6 for use of the Vary header field + by caches and section 14.44 for use of the Vary header field by + servers. + +12.2 Agent-driven Negotiation + + With agent-driven negotiation, selection of the best representation + for a response is performed by the user agent after receiving an + initial response from the origin server. Selection is based on a list + of the available representations of the response included within the + header fields or entity-body of the initial response, with each + representation identified by its own URI. Selection from among the + representations may be performed automatically (if the user agent is + capable of doing so) or manually by the user selecting from a + generated (possibly hypertext) menu. + + Agent-driven negotiation is advantageous when the response would vary + over commonly-used dimensions (such as type, language, or encoding), + when the origin server is unable to determine a user agent's + capabilities from examining the request, and generally when public + caches are used to distribute server load and reduce network usage. + + Agent-driven negotiation suffers from the disadvantage of needing a + second request to obtain the best alternate representation. This + second request is only efficient when caching is used. In addition, + this specification does not define any mechanism for supporting + automatic selection, though it also does not prevent any such + mechanism from being developed as an extension and used within + HTTP/1.1. + + + + + + + +Fielding, et al. Standards Track [Page 73] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 defines the 300 (Multiple Choices) and 406 (Not Acceptable) + status codes for enabling agent-driven negotiation when the server is + unwilling or unable to provide a varying response using server-driven + negotiation. + +12.3 Transparent Negotiation + + Transparent negotiation is a combination of both server-driven and + agent-driven negotiation. When a cache is supplied with a form of the + list of available representations of the response (as in agent-driven + negotiation) and the dimensions of variance are completely understood + by the cache, then the cache becomes capable of performing server- + driven negotiation on behalf of the origin server for subsequent + requests on that resource. + + Transparent negotiation has the advantage of distributing the + negotiation work that would otherwise be required of the origin + server and also removing the second request delay of agent-driven + negotiation when the cache is able to correctly guess the right + response. + + This specification does not define any mechanism for transparent + negotiation, though it also does not prevent any such mechanism from + being developed as an extension that could be used within HTTP/1.1. + +13 Caching in HTTP + + HTTP is typically used for distributed information systems, where + performance can be improved by the use of response caches. The + HTTP/1.1 protocol includes a number of elements intended to make + caching work as well as possible. Because these elements are + inextricable from other aspects of the protocol, and because they + interact with each other, it is useful to describe the basic caching + design of HTTP separately from the detailed descriptions of methods, + headers, response codes, etc. + + Caching would be useless if it did not significantly improve + performance. The goal of caching in HTTP/1.1 is to eliminate the need + to send requests in many cases, and to eliminate the need to send + full responses in many other cases. The former reduces the number of + network round-trips required for many operations; we use an + "expiration" mechanism for this purpose (see section 13.2). The + latter reduces network bandwidth requirements; we use a "validation" + mechanism for this purpose (see section 13.3). + + Requirements for performance, availability, and disconnected + operation require us to be able to relax the goal of semantic + transparency. The HTTP/1.1 protocol allows origin servers, caches, + + + +Fielding, et al. Standards Track [Page 74] + +RFC 2616 HTTP/1.1 June 1999 + + + and clients to explicitly reduce transparency when necessary. + However, because non-transparent operation may confuse non-expert + users, and might be incompatible with certain server applications + (such as those for ordering merchandise), the protocol requires that + transparency be relaxed + + - only by an explicit protocol-level request when relaxed by + client or origin server + + - only with an explicit warning to the end user when relaxed by + cache or client + + Therefore, the HTTP/1.1 protocol provides these important elements: + + 1. Protocol features that provide full semantic transparency when + this is required by all parties. + + 2. Protocol features that allow an origin server or user agent to + explicitly request and control non-transparent operation. + + 3. Protocol features that allow a cache to attach warnings to + responses that do not preserve the requested approximation of + semantic transparency. + + A basic principle is that it must be possible for the clients to + detect any potential relaxation of semantic transparency. + + Note: The server, cache, or client implementor might be faced with + design decisions not explicitly discussed in this specification. + If a decision might affect semantic transparency, the implementor + ought to err on the side of maintaining transparency unless a + careful and complete analysis shows significant benefits in + breaking transparency. + +13.1.1 Cache Correctness + + A correct cache MUST respond to a request with the most up-to-date + response held by the cache that is appropriate to the request (see + sections 13.2.5, 13.2.6, and 13.12) which meets one of the following + conditions: + + 1. It has been checked for equivalence with what the origin server + would have returned by revalidating the response with the + origin server (section 13.3); + + + + + + + +Fielding, et al. Standards Track [Page 75] + +RFC 2616 HTTP/1.1 June 1999 + + + 2. It is "fresh enough" (see section 13.2). In the default case, + this means it meets the least restrictive freshness requirement + of the client, origin server, and cache (see section 14.9); if + the origin server so specifies, it is the freshness requirement + of the origin server alone. + + If a stored response is not "fresh enough" by the most + restrictive freshness requirement of both the client and the + origin server, in carefully considered circumstances the cache + MAY still return the response with the appropriate Warning + header (see section 13.1.5 and 14.46), unless such a response + is prohibited (e.g., by a "no-store" cache-directive, or by a + "no-cache" cache-request-directive; see section 14.9). + + 3. It is an appropriate 304 (Not Modified), 305 (Proxy Redirect), + or error (4xx or 5xx) response message. + + If the cache can not communicate with the origin server, then a + correct cache SHOULD respond as above if the response can be + correctly served from the cache; if not it MUST return an error or + warning indicating that there was a communication failure. + + If a cache receives a response (either an entire response, or a 304 + (Not Modified) response) that it would normally forward to the + requesting client, and the received response is no longer fresh, the + cache SHOULD forward it to the requesting client without adding a new + Warning (but without removing any existing Warning headers). A cache + SHOULD NOT attempt to revalidate a response simply because that + response became stale in transit; this might lead to an infinite + loop. A user agent that receives a stale response without a Warning + MAY display a warning indication to the user. + +13.1.2 Warnings + + Whenever a cache returns a response that is neither first-hand nor + "fresh enough" (in the sense of condition 2 in section 13.1.1), it + MUST attach a warning to that effect, using a Warning general-header. + The Warning header and the currently defined warnings are described + in section 14.46. The warning allows clients to take appropriate + action. + + Warnings MAY be used for other purposes, both cache-related and + otherwise. The use of a warning, rather than an error status code, + distinguish these responses from true failures. + + Warnings are assigned three digit warn-codes. The first digit + indicates whether the Warning MUST or MUST NOT be deleted from a + stored cache entry after a successful revalidation: + + + +Fielding, et al. Standards Track [Page 76] + +RFC 2616 HTTP/1.1 June 1999 + + + 1xx Warnings that describe the freshness or revalidation status of + the response, and so MUST be deleted after a successful + revalidation. 1XX warn-codes MAY be generated by a cache only when + validating a cached entry. It MUST NOT be generated by clients. + + 2xx Warnings that describe some aspect of the entity body or entity + headers that is not rectified by a revalidation (for example, a + lossy compression of the entity bodies) and which MUST NOT be + deleted after a successful revalidation. + + See section 14.46 for the definitions of the codes themselves. + + HTTP/1.0 caches will cache all Warnings in responses, without + deleting the ones in the first category. Warnings in responses that + are passed to HTTP/1.0 caches carry an extra warning-date field, + which prevents a future HTTP/1.1 recipient from believing an + erroneously cached Warning. + + Warnings also carry a warning text. The text MAY be in any + appropriate natural language (perhaps based on the client's Accept + headers), and include an OPTIONAL indication of what character set is + used. + + Multiple warnings MAY be attached to a response (either by the origin + server or by a cache), including multiple warnings with the same code + number. For example, a server might provide the same warning with + texts in both English and Basque. + + When multiple warnings are attached to a response, it might not be + practical or reasonable to display all of them to the user. This + version of HTTP does not specify strict priority rules for deciding + which warnings to display and in what order, but does suggest some + heuristics. + +13.1.3 Cache-control Mechanisms + + The basic cache mechanisms in HTTP/1.1 (server-specified expiration + times and validators) are implicit directives to caches. In some + cases, a server or client might need to provide explicit directives + to the HTTP caches. We use the Cache-Control header for this purpose. + + The Cache-Control header allows a client or server to transmit a + variety of directives in either requests or responses. These + directives typically override the default caching algorithms. As a + general rule, if there is any apparent conflict between header + values, the most restrictive interpretation is applied (that is, the + one that is most likely to preserve semantic transparency). However, + + + + +Fielding, et al. Standards Track [Page 77] + +RFC 2616 HTTP/1.1 June 1999 + + + in some cases, cache-control directives are explicitly specified as + weakening the approximation of semantic transparency (for example, + "max-stale" or "public"). + + The cache-control directives are described in detail in section 14.9. + +13.1.4 Explicit User Agent Warnings + + Many user agents make it possible for users to override the basic + caching mechanisms. For example, the user agent might allow the user + to specify that cached entities (even explicitly stale ones) are + never validated. Or the user agent might habitually add "Cache- + Control: max-stale=3600" to every request. The user agent SHOULD NOT + default to either non-transparent behavior, or behavior that results + in abnormally ineffective caching, but MAY be explicitly configured + to do so by an explicit action of the user. + + If the user has overridden the basic caching mechanisms, the user + agent SHOULD explicitly indicate to the user whenever this results in + the display of information that might not meet the server's + transparency requirements (in particular, if the displayed entity is + known to be stale). Since the protocol normally allows the user agent + to determine if responses are stale or not, this indication need only + be displayed when this actually happens. The indication need not be a + dialog box; it could be an icon (for example, a picture of a rotting + fish) or some other indicator. + + If the user has overridden the caching mechanisms in a way that would + abnormally reduce the effectiveness of caches, the user agent SHOULD + continually indicate this state to the user (for example, by a + display of a picture of currency in flames) so that the user does not + inadvertently consume excess resources or suffer from excessive + latency. + +13.1.5 Exceptions to the Rules and Warnings + + In some cases, the operator of a cache MAY choose to configure it to + return stale responses even when not requested by clients. This + decision ought not be made lightly, but may be necessary for reasons + of availability or performance, especially when the cache is poorly + connected to the origin server. Whenever a cache returns a stale + response, it MUST mark it as such (using a Warning header) enabling + the client software to alert the user that there might be a potential + problem. + + + + + + + +Fielding, et al. Standards Track [Page 78] + +RFC 2616 HTTP/1.1 June 1999 + + + It also allows the user agent to take steps to obtain a first-hand or + fresh response. For this reason, a cache SHOULD NOT return a stale + response if the client explicitly requests a first-hand or fresh one, + unless it is impossible to comply for technical or policy reasons. + +13.1.6 Client-controlled Behavior + + While the origin server (and to a lesser extent, intermediate caches, + by their contribution to the age of a response) are the primary + source of expiration information, in some cases the client might need + to control a cache's decision about whether to return a cached + response without validating it. Clients do this using several + directives of the Cache-Control header. + + A client's request MAY specify the maximum age it is willing to + accept of an unvalidated response; specifying a value of zero forces + the cache(s) to revalidate all responses. A client MAY also specify + the minimum time remaining before a response expires. Both of these + options increase constraints on the behavior of caches, and so cannot + further relax the cache's approximation of semantic transparency. + + A client MAY also specify that it will accept stale responses, up to + some maximum amount of staleness. This loosens the constraints on the + caches, and so might violate the origin server's specified + constraints on semantic transparency, but might be necessary to + support disconnected operation, or high availability in the face of + poor connectivity. + +13.2 Expiration Model + +13.2.1 Server-Specified Expiration + + HTTP caching works best when caches can entirely avoid making + requests to the origin server. The primary mechanism for avoiding + requests is for an origin server to provide an explicit expiration + time in the future, indicating that a response MAY be used to satisfy + subsequent requests. In other words, a cache can return a fresh + response without first contacting the server. + + Our expectation is that servers will assign future explicit + expiration times to responses in the belief that the entity is not + likely to change, in a semantically significant way, before the + expiration time is reached. This normally preserves semantic + transparency, as long as the server's expiration times are carefully + chosen. + + + + + + +Fielding, et al. Standards Track [Page 79] + +RFC 2616 HTTP/1.1 June 1999 + + + The expiration mechanism applies only to responses taken from a cache + and not to first-hand responses forwarded immediately to the + requesting client. + + If an origin server wishes to force a semantically transparent cache + to validate every request, it MAY assign an explicit expiration time + in the past. This means that the response is always stale, and so the + cache SHOULD validate it before using it for subsequent requests. See + section 14.9.4 for a more restrictive way to force revalidation. + + If an origin server wishes to force any HTTP/1.1 cache, no matter how + it is configured, to validate every request, it SHOULD use the "must- + revalidate" cache-control directive (see section 14.9). + + Servers specify explicit expiration times using either the Expires + header, or the max-age directive of the Cache-Control header. + + An expiration time cannot be used to force a user agent to refresh + its display or reload a resource; its semantics apply only to caching + mechanisms, and such mechanisms need only check a resource's + expiration status when a new request for that resource is initiated. + See section 13.13 for an explanation of the difference between caches + and history mechanisms. + +13.2.2 Heuristic Expiration + + Since origin servers do not always provide explicit expiration times, + HTTP caches typically assign heuristic expiration times, employing + algorithms that use other header values (such as the Last-Modified + time) to estimate a plausible expiration time. The HTTP/1.1 + specification does not provide specific algorithms, but does impose + worst-case constraints on their results. Since heuristic expiration + times might compromise semantic transparency, they ought to used + cautiously, and we encourage origin servers to provide explicit + expiration times as much as possible. + +13.2.3 Age Calculations + + In order to know if a cached entry is fresh, a cache needs to know if + its age exceeds its freshness lifetime. We discuss how to calculate + the latter in section 13.2.4; this section describes how to calculate + the age of a response or cache entry. + + In this discussion, we use the term "now" to mean "the current value + of the clock at the host performing the calculation." Hosts that use + HTTP, but especially hosts running origin servers and caches, SHOULD + use NTP [28] or some similar protocol to synchronize their clocks to + a globally accurate time standard. + + + +Fielding, et al. Standards Track [Page 80] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 requires origin servers to send a Date header, if possible, + with every response, giving the time at which the response was + generated (see section 14.18). We use the term "date_value" to denote + the value of the Date header, in a form appropriate for arithmetic + operations. + + HTTP/1.1 uses the Age response-header to convey the estimated age of + the response message when obtained from a cache. The Age field value + is the cache's estimate of the amount of time since the response was + generated or revalidated by the origin server. + + In essence, the Age value is the sum of the time that the response + has been resident in each of the caches along the path from the + origin server, plus the amount of time it has been in transit along + network paths. + + We use the term "age_value" to denote the value of the Age header, in + a form appropriate for arithmetic operations. + + A response's age can be calculated in two entirely independent ways: + + 1. now minus date_value, if the local clock is reasonably well + synchronized to the origin server's clock. If the result is + negative, the result is replaced by zero. + + 2. age_value, if all of the caches along the response path + implement HTTP/1.1. + + Given that we have two independent ways to compute the age of a + response when it is received, we can combine these as + + corrected_received_age = max(now - date_value, age_value) + + and as long as we have either nearly synchronized clocks or all- + HTTP/1.1 paths, one gets a reliable (conservative) result. + + Because of network-imposed delays, some significant interval might + pass between the time that a server generates a response and the time + it is received at the next outbound cache or client. If uncorrected, + this delay could result in improperly low ages. + + Because the request that resulted in the returned Age value must have + been initiated prior to that Age value's generation, we can correct + for delays imposed by the network by recording the time at which the + request was initiated. Then, when an Age value is received, it MUST + be interpreted relative to the time the request was initiated, not + + + + + +Fielding, et al. Standards Track [Page 81] + +RFC 2616 HTTP/1.1 June 1999 + + + the time that the response was received. This algorithm results in + conservative behavior no matter how much delay is experienced. So, we + compute: + + corrected_initial_age = corrected_received_age + + (now - request_time) + + where "request_time" is the time (according to the local clock) when + the request that elicited this response was sent. + + Summary of age calculation algorithm, when a cache receives a + response: + + /* + * age_value + * is the value of Age: header received by the cache with + * this response. + * date_value + * is the value of the origin server's Date: header + * request_time + * is the (local) time when the cache made the request + * that resulted in this cached response + * response_time + * is the (local) time when the cache received the + * response + * now + * is the current (local) time + */ + + apparent_age = max(0, response_time - date_value); + corrected_received_age = max(apparent_age, age_value); + response_delay = response_time - request_time; + corrected_initial_age = corrected_received_age + response_delay; + resident_time = now - response_time; + current_age = corrected_initial_age + resident_time; + + The current_age of a cache entry is calculated by adding the amount + of time (in seconds) since the cache entry was last validated by the + origin server to the corrected_initial_age. When a response is + generated from a cache entry, the cache MUST include a single Age + header field in the response with a value equal to the cache entry's + current_age. + + The presence of an Age header field in a response implies that a + response is not first-hand. However, the converse is not true, since + the lack of an Age header field in a response does not imply that the + + + + + +Fielding, et al. Standards Track [Page 82] + +RFC 2616 HTTP/1.1 June 1999 + + + response is first-hand unless all caches along the request path are + compliant with HTTP/1.1 (i.e., older HTTP caches did not implement + the Age header field). + +13.2.4 Expiration Calculations + + In order to decide whether a response is fresh or stale, we need to + compare its freshness lifetime to its age. The age is calculated as + described in section 13.2.3; this section describes how to calculate + the freshness lifetime, and to determine if a response has expired. + In the discussion below, the values can be represented in any form + appropriate for arithmetic operations. + + We use the term "expires_value" to denote the value of the Expires + header. We use the term "max_age_value" to denote an appropriate + value of the number of seconds carried by the "max-age" directive of + the Cache-Control header in a response (see section 14.9.3). + + The max-age directive takes priority over Expires, so if max-age is + present in a response, the calculation is simply: + + freshness_lifetime = max_age_value + + Otherwise, if Expires is present in the response, the calculation is: + + freshness_lifetime = expires_value - date_value + + Note that neither of these calculations is vulnerable to clock skew, + since all of the information comes from the origin server. + + If none of Expires, Cache-Control: max-age, or Cache-Control: s- + maxage (see section 14.9.3) appears in the response, and the response + does not include other restrictions on caching, the cache MAY compute + a freshness lifetime using a heuristic. The cache MUST attach Warning + 113 to any response whose age is more than 24 hours if such warning + has not already been added. + + Also, if the response does have a Last-Modified time, the heuristic + expiration value SHOULD be no more than some fraction of the interval + since that time. A typical setting of this fraction might be 10%. + + The calculation to determine if a response has expired is quite + simple: + + response_is_fresh = (freshness_lifetime > current_age) + + + + + + +Fielding, et al. Standards Track [Page 83] + +RFC 2616 HTTP/1.1 June 1999 + + +13.2.5 Disambiguating Expiration Values + + Because expiration values are assigned optimistically, it is possible + for two caches to contain fresh values for the same resource that are + different. + + If a client performing a retrieval receives a non-first-hand response + for a request that was already fresh in its own cache, and the Date + header in its existing cache entry is newer than the Date on the new + response, then the client MAY ignore the response. If so, it MAY + retry the request with a "Cache-Control: max-age=0" directive (see + section 14.9), to force a check with the origin server. + + If a cache has two fresh responses for the same representation with + different validators, it MUST use the one with the more recent Date + header. This situation might arise because the cache is pooling + responses from other caches, or because a client has asked for a + reload or a revalidation of an apparently fresh cache entry. + +13.2.6 Disambiguating Multiple Responses + + Because a client might be receiving responses via multiple paths, so + that some responses flow through one set of caches and other + responses flow through a different set of caches, a client might + receive responses in an order different from that in which the origin + server sent them. We would like the client to use the most recently + generated response, even if older responses are still apparently + fresh. + + Neither the entity tag nor the expiration value can impose an + ordering on responses, since it is possible that a later response + intentionally carries an earlier expiration time. The Date values are + ordered to a granularity of one second. + + When a client tries to revalidate a cache entry, and the response it + receives contains a Date header that appears to be older than the one + for the existing entry, then the client SHOULD repeat the request + unconditionally, and include + + Cache-Control: max-age=0 + + to force any intermediate caches to validate their copies directly + with the origin server, or + + Cache-Control: no-cache + + to force any intermediate caches to obtain a new copy from the origin + server. + + + +Fielding, et al. Standards Track [Page 84] + +RFC 2616 HTTP/1.1 June 1999 + + + If the Date values are equal, then the client MAY use either response + (or MAY, if it is being extremely prudent, request a new response). + Servers MUST NOT depend on clients being able to choose + deterministically between responses generated during the same second, + if their expiration times overlap. + +13.3 Validation Model + + When a cache has a stale entry that it would like to use as a + response to a client's request, it first has to check with the origin + server (or possibly an intermediate cache with a fresh response) to + see if its cached entry is still usable. We call this "validating" + the cache entry. Since we do not want to have to pay the overhead of + retransmitting the full response if the cached entry is good, and we + do not want to pay the overhead of an extra round trip if the cached + entry is invalid, the HTTP/1.1 protocol supports the use of + conditional methods. + + The key protocol features for supporting conditional methods are + those concerned with "cache validators." When an origin server + generates a full response, it attaches some sort of validator to it, + which is kept with the cache entry. When a client (user agent or + proxy cache) makes a conditional request for a resource for which it + has a cache entry, it includes the associated validator in the + request. + + The server then checks that validator against the current validator + for the entity, and, if they match (see section 13.3.3), it responds + with a special status code (usually, 304 (Not Modified)) and no + entity-body. Otherwise, it returns a full response (including + entity-body). Thus, we avoid transmitting the full response if the + validator matches, and we avoid an extra round trip if it does not + match. + + In HTTP/1.1, a conditional request looks exactly the same as a normal + request for the same resource, except that it carries a special + header (which includes the validator) that implicitly turns the + method (usually, GET) into a conditional. + + The protocol includes both positive and negative senses of cache- + validating conditions. That is, it is possible to request either that + a method be performed if and only if a validator matches or if and + only if no validators match. + + + + + + + + +Fielding, et al. Standards Track [Page 85] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: a response that lacks a validator may still be cached, and + served from cache until it expires, unless this is explicitly + prohibited by a cache-control directive. However, a cache cannot + do a conditional retrieval if it does not have a validator for the + entity, which means it will not be refreshable after it expires. + +13.3.1 Last-Modified Dates + + The Last-Modified entity-header field value is often used as a cache + validator. In simple terms, a cache entry is considered to be valid + if the entity has not been modified since the Last-Modified value. + +13.3.2 Entity Tag Cache Validators + + The ETag response-header field value, an entity tag, provides for an + "opaque" cache validator. This might allow more reliable validation + in situations where it is inconvenient to store modification dates, + where the one-second resolution of HTTP date values is not + sufficient, or where the origin server wishes to avoid certain + paradoxes that might arise from the use of modification dates. + + Entity Tags are described in section 3.11. The headers used with + entity tags are described in sections 14.19, 14.24, 14.26 and 14.44. + +13.3.3 Weak and Strong Validators + + Since both origin servers and caches will compare two validators to + decide if they represent the same or different entities, one normally + would expect that if the entity (the entity-body or any entity- + headers) changes in any way, then the associated validator would + change as well. If this is true, then we call this validator a + "strong validator." + + However, there might be cases when a server prefers to change the + validator only on semantically significant changes, and not when + insignificant aspects of the entity change. A validator that does not + always change when the resource changes is a "weak validator." + + Entity tags are normally "strong validators," but the protocol + provides a mechanism to tag an entity tag as "weak." One can think of + a strong validator as one that changes whenever the bits of an entity + changes, while a weak value changes whenever the meaning of an entity + changes. Alternatively, one can think of a strong validator as part + of an identifier for a specific entity, while a weak validator is + part of an identifier for a set of semantically equivalent entities. + + Note: One example of a strong validator is an integer that is + incremented in stable storage every time an entity is changed. + + + +Fielding, et al. Standards Track [Page 86] + +RFC 2616 HTTP/1.1 June 1999 + + + An entity's modification time, if represented with one-second + resolution, could be a weak validator, since it is possible that + the resource might be modified twice during a single second. + + Support for weak validators is optional. However, weak validators + allow for more efficient caching of equivalent objects; for + example, a hit counter on a site is probably good enough if it is + updated every few days or weeks, and any value during that period + is likely "good enough" to be equivalent. + + A "use" of a validator is either when a client generates a request + and includes the validator in a validating header field, or when a + server compares two validators. + + Strong validators are usable in any context. Weak validators are only + usable in contexts that do not depend on exact equality of an entity. + For example, either kind is usable for a conditional GET of a full + entity. However, only a strong validator is usable for a sub-range + retrieval, since otherwise the client might end up with an internally + inconsistent entity. + + Clients MAY issue simple (non-subrange) GET requests with either weak + validators or strong validators. Clients MUST NOT use weak validators + in other forms of request. + + The only function that the HTTP/1.1 protocol defines on validators is + comparison. There are two validator comparison functions, depending + on whether the comparison context allows the use of weak validators + or not: + + - The strong comparison function: in order to be considered equal, + both validators MUST be identical in every way, and both MUST + NOT be weak. + + - The weak comparison function: in order to be considered equal, + both validators MUST be identical in every way, but either or + both of them MAY be tagged as "weak" without affecting the + result. + + An entity tag is strong unless it is explicitly tagged as weak. + Section 3.11 gives the syntax for entity tags. + + A Last-Modified time, when used as a validator in a request, is + implicitly weak unless it is possible to deduce that it is strong, + using the following rules: + + - The validator is being compared by an origin server to the + actual current validator for the entity and, + + + +Fielding, et al. Standards Track [Page 87] + +RFC 2616 HTTP/1.1 June 1999 + + + - That origin server reliably knows that the associated entity did + not change twice during the second covered by the presented + validator. + + or + + - The validator is about to be used by a client in an If- + Modified-Since or If-Unmodified-Since header, because the client + has a cache entry for the associated entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + or + + - The validator is being compared by an intermediate cache to the + validator stored in its cache entry for the entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + This method relies on the fact that if two different responses were + sent by the origin server during the same second, but both had the + same Last-Modified time, then at least one of those responses would + have a Date value equal to its Last-Modified time. The arbitrary 60- + second limit guards against the possibility that the Date and Last- + Modified values are generated from different clocks, or at somewhat + different times during the preparation of the response. An + implementation MAY use a value larger than 60 seconds, if it is + believed that 60 seconds is too short. + + If a client wishes to perform a sub-range retrieval on a value for + which it has only a Last-Modified time and no opaque validator, it + MAY do this only if the Last-Modified time is strong in the sense + described here. + + A cache or origin server receiving a conditional request, other than + a full-body GET request, MUST use the strong comparison function to + evaluate the condition. + + These rules allow HTTP/1.1 caches and clients to safely perform sub- + range retrievals on values that have been obtained from HTTP/1.0 + + + +Fielding, et al. Standards Track [Page 88] + +RFC 2616 HTTP/1.1 June 1999 + + + servers. + +13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates + + We adopt a set of rules and recommendations for origin servers, + clients, and caches regarding when various validator types ought to + be used, and for what purposes. + + HTTP/1.1 origin servers: + + - SHOULD send an entity tag validator unless it is not feasible to + generate one. + + - MAY send a weak entity tag instead of a strong entity tag, if + performance considerations support the use of weak entity tags, + or if it is unfeasible to send a strong entity tag. + + - SHOULD send a Last-Modified value if it is feasible to send one, + unless the risk of a breakdown in semantic transparency that + could result from using this date in an If-Modified-Since header + would lead to serious problems. + + In other words, the preferred behavior for an HTTP/1.1 origin server + is to send both a strong entity tag and a Last-Modified value. + + In order to be legal, a strong entity tag MUST change whenever the + associated entity value changes in any way. A weak entity tag SHOULD + change whenever the associated entity changes in a semantically + significant way. + + Note: in order to provide semantically transparent caching, an + origin server must avoid reusing a specific strong entity tag + value for two different entities, or reusing a specific weak + entity tag value for two semantically different entities. Cache + entries might persist for arbitrarily long periods, regardless of + expiration times, so it might be inappropriate to expect that a + cache will never again attempt to validate an entry using a + validator that it obtained at some point in the past. + + HTTP/1.1 clients: + + - If an entity tag has been provided by the origin server, MUST + use that entity tag in any cache-conditional request (using If- + Match or If-None-Match). + + - If only a Last-Modified value has been provided by the origin + server, SHOULD use that value in non-subrange cache-conditional + requests (using If-Modified-Since). + + + +Fielding, et al. Standards Track [Page 89] + +RFC 2616 HTTP/1.1 June 1999 + + + - If only a Last-Modified value has been provided by an HTTP/1.0 + origin server, MAY use that value in subrange cache-conditional + requests (using If-Unmodified-Since:). The user agent SHOULD + provide a way to disable this, in case of difficulty. + + - If both an entity tag and a Last-Modified value have been + provided by the origin server, SHOULD use both validators in + cache-conditional requests. This allows both HTTP/1.0 and + HTTP/1.1 caches to respond appropriately. + + An HTTP/1.1 origin server, upon receiving a conditional request that + includes both a Last-Modified date (e.g., in an If-Modified-Since or + If-Unmodified-Since header field) and one or more entity tags (e.g., + in an If-Match, If-None-Match, or If-Range header field) as cache + validators, MUST NOT return a response status of 304 (Not Modified) + unless doing so is consistent with all of the conditional header + fields in the request. + + An HTTP/1.1 caching proxy, upon receiving a conditional request that + includes both a Last-Modified date and one or more entity tags as + cache validators, MUST NOT return a locally cached response to the + client unless that cached response is consistent with all of the + conditional header fields in the request. + + Note: The general principle behind these rules is that HTTP/1.1 + servers and clients should transmit as much non-redundant + information as is available in their responses and requests. + HTTP/1.1 systems receiving this information will make the most + conservative assumptions about the validators they receive. + + HTTP/1.0 clients and caches will ignore entity tags. Generally, + last-modified values received or used by these systems will + support transparent and efficient caching, and so HTTP/1.1 origin + servers should provide Last-Modified values. In those rare cases + where the use of a Last-Modified value as a validator by an + HTTP/1.0 system could result in a serious problem, then HTTP/1.1 + origin servers should not provide one. + +13.3.5 Non-validating Conditionals + + The principle behind entity tags is that only the service author + knows the semantics of a resource well enough to select an + appropriate cache validation mechanism, and the specification of any + validator comparison function more complex than byte-equality would + open up a can of worms. Thus, comparisons of any other headers + (except Last-Modified, for compatibility with HTTP/1.0) are never + used for purposes of validating a cache entry. + + + + +Fielding, et al. Standards Track [Page 90] + +RFC 2616 HTTP/1.1 June 1999 + + +13.4 Response Cacheability + + Unless specifically constrained by a cache-control (section 14.9) + directive, a caching system MAY always store a successful response + (see section 13.8) as a cache entry, MAY return it without validation + if it is fresh, and MAY return it after successful validation. If + there is neither a cache validator nor an explicit expiration time + associated with a response, we do not expect it to be cached, but + certain caches MAY violate this expectation (for example, when little + or no network connectivity is available). A client can usually detect + that such a response was taken from a cache by comparing the Date + header to the current time. + + Note: some HTTP/1.0 caches are known to violate this expectation + without providing any Warning. + + However, in some cases it might be inappropriate for a cache to + retain an entity, or to return it in response to a subsequent + request. This might be because absolute semantic transparency is + deemed necessary by the service author, or because of security or + privacy considerations. Certain cache-control directives are + therefore provided so that the server can indicate that certain + resource entities, or portions thereof, are not to be cached + regardless of other considerations. + + Note that section 14.8 normally prevents a shared cache from saving + and returning a response to a previous request if that request + included an Authorization header. + + A response received with a status code of 200, 203, 206, 300, 301 or + 410 MAY be stored by a cache and used in reply to a subsequent + request, subject to the expiration mechanism, unless a cache-control + directive prohibits caching. However, a cache that does not support + the Range and Content-Range headers MUST NOT cache 206 (Partial + Content) responses. + + A response received with any other status code (e.g. status codes 302 + and 307) MUST NOT be returned in a reply to a subsequent request + unless there are cache-control directives or another header(s) that + explicitly allow it. For example, these include the following: an + Expires header (section 14.21); a "max-age", "s-maxage", "must- + revalidate", "proxy-revalidate", "public" or "private" cache-control + directive (section 14.9). + + + + + + + + +Fielding, et al. Standards Track [Page 91] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5 Constructing Responses From Caches + + The purpose of an HTTP cache is to store information received in + response to requests for use in responding to future requests. In + many cases, a cache simply returns the appropriate parts of a + response to the requester. However, if the cache holds a cache entry + based on a previous response, it might have to combine parts of a new + response with what is held in the cache entry. + +13.5.1 End-to-end and Hop-by-hop Headers + + For the purpose of defining the behavior of caches and non-caching + proxies, we divide HTTP headers into two categories: + + - End-to-end headers, which are transmitted to the ultimate + recipient of a request or response. End-to-end headers in + responses MUST be stored as part of a cache entry and MUST be + transmitted in any response formed from a cache entry. + + - Hop-by-hop headers, which are meaningful only for a single + transport-level connection, and are not stored by caches or + forwarded by proxies. + + The following HTTP/1.1 headers are hop-by-hop headers: + + - Connection + - Keep-Alive + - Proxy-Authenticate + - Proxy-Authorization + - TE + - Trailers + - Transfer-Encoding + - Upgrade + + All other headers defined by HTTP/1.1 are end-to-end headers. + + Other hop-by-hop headers MUST be listed in a Connection header, + (section 14.10) to be introduced into HTTP/1.1 (or later). + +13.5.2 Non-modifiable Headers + + Some features of the HTTP/1.1 protocol, such as Digest + Authentication, depend on the value of certain end-to-end headers. A + transparent proxy SHOULD NOT modify an end-to-end header unless the + definition of that header requires or specifically allows that. + + + + + + +Fielding, et al. Standards Track [Page 92] + +RFC 2616 HTTP/1.1 June 1999 + + + A transparent proxy MUST NOT modify any of the following fields in a + request or response, and it MUST NOT add any of these fields if not + already present: + + - Content-Location + + - Content-MD5 + + - ETag + + - Last-Modified + + A transparent proxy MUST NOT modify any of the following fields in a + response: + + - Expires + + but it MAY add any of these fields if not already present. If an + Expires header is added, it MUST be given a field-value identical to + that of the Date header in that response. + + A proxy MUST NOT modify or add any of the following fields in a + message that contains the no-transform cache-control directive, or in + any request: + + - Content-Encoding + + - Content-Range + + - Content-Type + + A non-transparent proxy MAY modify or add these fields to a message + that does not include no-transform, but if it does so, it MUST add a + Warning 214 (Transformation applied) if one does not already appear + in the message (see section 14.46). + + Warning: unnecessary modification of end-to-end headers might + cause authentication failures if stronger authentication + mechanisms are introduced in later versions of HTTP. Such + authentication mechanisms MAY rely on the values of header fields + not listed here. + + The Content-Length field of a request or response is added or deleted + according to the rules in section 4.4. A transparent proxy MUST + preserve the entity-length (section 7.2.2) of the entity-body, + although it MAY change the transfer-length (section 4.4). + + + + + +Fielding, et al. Standards Track [Page 93] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.3 Combining Headers + + When a cache makes a validating request to a server, and the server + provides a 304 (Not Modified) response or a 206 (Partial Content) + response, the cache then constructs a response to send to the + requesting client. + + If the status code is 304 (Not Modified), the cache uses the entity- + body stored in the cache entry as the entity-body of this outgoing + response. If the status code is 206 (Partial Content) and the ETag or + Last-Modified headers match exactly, the cache MAY combine the + contents stored in the cache entry with the new contents received in + the response and use the result as the entity-body of this outgoing + response, (see 13.5.4). + + The end-to-end headers stored in the cache entry are used for the + constructed response, except that + + - any stored Warning headers with warn-code 1xx (see section + 14.46) MUST be deleted from the cache entry and the forwarded + response. + + - any stored Warning headers with warn-code 2xx MUST be retained + in the cache entry and the forwarded response. + + - any end-to-end headers provided in the 304 or 206 response MUST + replace the corresponding headers from the cache entry. + + Unless the cache decides to remove the cache entry, it MUST also + replace the end-to-end headers stored with the cache entry with + corresponding headers received in the incoming response, except for + Warning headers as described immediately above. If a header field- + name in the incoming response matches more than one header in the + cache entry, all such old headers MUST be replaced. + + In other words, the set of end-to-end headers received in the + incoming response overrides all corresponding end-to-end headers + stored with the cache entry (except for stored Warning headers with + warn-code 1xx, which are deleted even if not overridden). + + Note: this rule allows an origin server to use a 304 (Not + Modified) or a 206 (Partial Content) response to update any header + associated with a previous response for the same entity or sub- + ranges thereof, although it might not always be meaningful or + correct to do so. This rule does not allow an origin server to use + a 304 (Not Modified) or a 206 (Partial Content) response to + entirely delete a header that it had provided with a previous + response. + + + +Fielding, et al. Standards Track [Page 94] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.4 Combining Byte Ranges + + A response might transfer only a subrange of the bytes of an entity- + body, either because the request included one or more Range + specifications, or because a connection was broken prematurely. After + several such transfers, a cache might have received several ranges of + the same entity-body. + + If a cache has a stored non-empty set of subranges for an entity, and + an incoming response transfers another subrange, the cache MAY + combine the new subrange with the existing set if both the following + conditions are met: + + - Both the incoming response and the cache entry have a cache + validator. + + - The two cache validators match using the strong comparison + function (see section 13.3.3). + + If either requirement is not met, the cache MUST use only the most + recent partial response (based on the Date values transmitted with + every response, and using the incoming response if these values are + equal or missing), and MUST discard the other partial information. + +13.6 Caching Negotiated Responses + + Use of server-driven content negotiation (section 12.1), as indicated + by the presence of a Vary header field in a response, alters the + conditions and procedure by which a cache can use the response for + subsequent requests. See section 14.44 for use of the Vary header + field by servers. + + A server SHOULD use the Vary header field to inform a cache of what + request-header fields were used to select among multiple + representations of a cacheable response subject to server-driven + negotiation. The set of header fields named by the Vary field value + is known as the "selecting" request-headers. + + When the cache receives a subsequent request whose Request-URI + specifies one or more cache entries including a Vary header field, + the cache MUST NOT use such a cache entry to construct a response to + the new request unless all of the selecting request-headers present + in the new request match the corresponding stored request-headers in + the original request. + + The selecting request-headers from two requests are defined to match + if and only if the selecting request-headers in the first request can + be transformed to the selecting request-headers in the second request + + + +Fielding, et al. Standards Track [Page 95] + +RFC 2616 HTTP/1.1 June 1999 + + + by adding or removing linear white space (LWS) at places where this + is allowed by the corresponding BNF, and/or combining multiple + message-header fields with the same field name following the rules + about message headers in section 4.2. + + A Vary header field-value of "*" always fails to match and subsequent + requests on that resource can only be properly interpreted by the + origin server. + + If the selecting request header fields for the cached entry do not + match the selecting request header fields of the new request, then + the cache MUST NOT use a cached entry to satisfy the request unless + it first relays the new request to the origin server in a conditional + request and the server responds with 304 (Not Modified), including an + entity tag or Content-Location that indicates the entity to be used. + + If an entity tag was assigned to a cached representation, the + forwarded request SHOULD be conditional and include the entity tags + in an If-None-Match header field from all its cache entries for the + resource. This conveys to the server the set of entities currently + held by the cache, so that if any one of these entities matches the + requested entity, the server can use the ETag header field in its 304 + (Not Modified) response to tell the cache which entry is appropriate. + If the entity-tag of the new response matches that of an existing + entry, the new response SHOULD be used to update the header fields of + the existing entry, and the result MUST be returned to the client. + + If any of the existing cache entries contains only partial content + for the associated entity, its entity-tag SHOULD NOT be included in + the If-None-Match header field unless the request is for a range that + would be fully satisfied by that entry. + + If a cache receives a successful response whose Content-Location + field matches that of an existing cache entry for the same Request- + ]URI, whose entity-tag differs from that of the existing entry, and + whose Date is more recent than that of the existing entry, the + existing entry SHOULD NOT be returned in response to future requests + and SHOULD be deleted from the cache. + +13.7 Shared and Non-Shared Caches + + For reasons of security and privacy, it is necessary to make a + distinction between "shared" and "non-shared" caches. A non-shared + cache is one that is accessible only to a single user. Accessibility + in this case SHOULD be enforced by appropriate security mechanisms. + All other caches are considered to be "shared." Other sections of + + + + + +Fielding, et al. Standards Track [Page 96] + +RFC 2616 HTTP/1.1 June 1999 + + + this specification place certain constraints on the operation of + shared caches in order to prevent loss of privacy or failure of + access controls. + +13.8 Errors or Incomplete Response Cache Behavior + + A cache that receives an incomplete response (for example, with fewer + bytes of data than specified in a Content-Length header) MAY store + the response. However, the cache MUST treat this as a partial + response. Partial responses MAY be combined as described in section + 13.5.4; the result might be a full response or might still be + partial. A cache MUST NOT return a partial response to a client + without explicitly marking it as such, using the 206 (Partial + Content) status code. A cache MUST NOT return a partial response + using a status code of 200 (OK). + + If a cache receives a 5xx response while attempting to revalidate an + entry, it MAY either forward this response to the requesting client, + or act as if the server failed to respond. In the latter case, it MAY + return a previously received response unless the cached entry + includes the "must-revalidate" cache-control directive (see section + 14.9). + +13.9 Side Effects of GET and HEAD + + Unless the origin server explicitly prohibits the caching of their + responses, the application of GET and HEAD methods to any resources + SHOULD NOT have side effects that would lead to erroneous behavior if + these responses are taken from a cache. They MAY still have side + effects, but a cache is not required to consider such side effects in + its caching decisions. Caches are always expected to observe an + origin server's explicit restrictions on caching. + + We note one exception to this rule: since some applications have + traditionally used GETs and HEADs with query URLs (those containing a + "?" in the rel_path part) to perform operations with significant side + effects, caches MUST NOT treat responses to such URIs as fresh unless + the server provides an explicit expiration time. This specifically + means that responses from HTTP/1.0 servers for such URIs SHOULD NOT + be taken from a cache. See section 9.1.1 for related information. + +13.10 Invalidation After Updates or Deletions + + The effect of certain methods performed on a resource at the origin + server might cause one or more existing cache entries to become non- + transparently invalid. That is, although they might continue to be + "fresh," they do not accurately reflect what the origin server would + return for a new request on that resource. + + + +Fielding, et al. Standards Track [Page 97] + +RFC 2616 HTTP/1.1 June 1999 + + + There is no way for the HTTP protocol to guarantee that all such + cache entries are marked invalid. For example, the request that + caused the change at the origin server might not have gone through + the proxy where a cache entry is stored. However, several rules help + reduce the likelihood of erroneous behavior. + + In this section, the phrase "invalidate an entity" means that the + cache will either remove all instances of that entity from its + storage, or will mark these as "invalid" and in need of a mandatory + revalidation before they can be returned in response to a subsequent + request. + + Some HTTP methods MUST cause a cache to invalidate an entity. This is + either the entity referred to by the Request-URI, or by the Location + or Content-Location headers (if present). These methods are: + + - PUT + + - DELETE + + - POST + + In order to prevent denial of service attacks, an invalidation based + on the URI in a Location or Content-Location header MUST only be + performed if the host part is the same as in the Request-URI. + + A cache that passes through requests for methods it does not + understand SHOULD invalidate any entities referred to by the + Request-URI. + +13.11 Write-Through Mandatory + + All methods that might be expected to cause modifications to the + origin server's resources MUST be written through to the origin + server. This currently includes all methods except for GET and HEAD. + A cache MUST NOT reply to such a request from a client before having + transmitted the request to the inbound server, and having received a + corresponding response from the inbound server. This does not prevent + a proxy cache from sending a 100 (Continue) response before the + inbound server has sent its final reply. + + The alternative (known as "write-back" or "copy-back" caching) is not + allowed in HTTP/1.1, due to the difficulty of providing consistent + updates and the problems arising from server, cache, or network + failure prior to write-back. + + + + + + +Fielding, et al. Standards Track [Page 98] + +RFC 2616 HTTP/1.1 June 1999 + + +13.12 Cache Replacement + + If a new cacheable (see sections 14.9.2, 13.2.5, 13.2.6 and 13.8) + response is received from a resource while any existing responses for + the same resource are cached, the cache SHOULD use the new response + to reply to the current request. It MAY insert it into cache storage + and MAY, if it meets all other requirements, use it to respond to any + future requests that would previously have caused the old response to + be returned. If it inserts the new response into cache storage the + rules in section 13.5.3 apply. + + Note: a new response that has an older Date header value than + existing cached responses is not cacheable. + +13.13 History Lists + + User agents often have history mechanisms, such as "Back" buttons and + history lists, which can be used to redisplay an entity retrieved + earlier in a session. + + History mechanisms and caches are different. In particular history + mechanisms SHOULD NOT try to show a semantically transparent view of + the current state of a resource. Rather, a history mechanism is meant + to show exactly what the user saw at the time when the resource was + retrieved. + + By default, an expiration time does not apply to history mechanisms. + If the entity is still in storage, a history mechanism SHOULD display + it even if the entity has expired, unless the user has specifically + configured the agent to refresh expired history documents. + + This is not to be construed to prohibit the history mechanism from + telling the user that a view might be stale. + + Note: if history list mechanisms unnecessarily prevent users from + viewing stale resources, this will tend to force service authors + to avoid using HTTP expiration controls and cache controls when + they would otherwise like to. Service authors may consider it + important that users not be presented with error messages or + warning messages when they use navigation controls (such as BACK) + to view previously fetched resources. Even though sometimes such + resources ought not to cached, or ought to expire quickly, user + interface considerations may force service authors to resort to + other means of preventing caching (e.g. "once-only" URLs) in order + not to suffer the effects of improperly functioning history + mechanisms. + + + + + +Fielding, et al. Standards Track [Page 99] + +RFC 2616 HTTP/1.1 June 1999 + + +14 Header Field Definitions + + This section defines the syntax and semantics of all standard + HTTP/1.1 header fields. For entity-header fields, both sender and + recipient refer to either the client or the server, depending on who + sends and who receives the entity. + +14.1 Accept + + The Accept request-header field can be used to specify certain media + types which are acceptable for the response. Accept headers can be + used to indicate that the request is specifically limited to a small + set of desired types, as in the case of a request for an in-line + image. + + Accept = "Accept" ":" + #( media-range [ accept-params ] ) + + media-range = ( "*/*" + | ( type "/" "*" ) + | ( type "/" subtype ) + ) *( ";" parameter ) + accept-params = ";" "q" "=" qvalue *( accept-extension ) + accept-extension = ";" token [ "=" ( token | quoted-string ) ] + + The asterisk "*" character is used to group media types into ranges, + with "*/*" indicating all media types and "type/*" indicating all + subtypes of that type. The media-range MAY include media type + parameters that are applicable to that range. + + Each media-range MAY be followed by one or more accept-params, + beginning with the "q" parameter for indicating a relative quality + factor. The first "q" parameter (if any) separates the media-range + parameter(s) from the accept-params. Quality factors allow the user + or user agent to indicate the relative degree of preference for that + media-range, using the qvalue scale from 0 to 1 (section 3.9). The + default value is q=1. + + Note: Use of the "q" parameter name to separate media type + parameters from Accept extension parameters is due to historical + practice. Although this prevents any media type parameter named + "q" from being used with a media range, such an event is believed + to be unlikely given the lack of any "q" parameters in the IANA + media type registry and the rare usage of any media type + parameters in Accept. Future media types are discouraged from + registering any parameter named "q". + + + + + +Fielding, et al. Standards Track [Page 100] + +RFC 2616 HTTP/1.1 June 1999 + + + The example + + Accept: audio/*; q=0.2, audio/basic + + SHOULD be interpreted as "I prefer audio/basic, but send me any audio + type if it is the best available after an 80% mark-down in quality." + + If no Accept header field is present, then it is assumed that the + client accepts all media types. If an Accept header field is present, + and if the server cannot send a response which is acceptable + according to the combined Accept field value, then the server SHOULD + send a 406 (not acceptable) response. + + A more elaborate example is + + Accept: text/plain; q=0.5, text/html, + text/x-dvi; q=0.8, text/x-c + + Verbally, this would be interpreted as "text/html and text/x-c are + the preferred media types, but if they do not exist, then send the + text/x-dvi entity, and if that does not exist, send the text/plain + entity." + + Media ranges can be overridden by more specific media ranges or + specific media types. If more than one media range applies to a given + type, the most specific reference has precedence. For example, + + Accept: text/*, text/html, text/html;level=1, */* + + have the following precedence: + + 1) text/html;level=1 + 2) text/html + 3) text/* + 4) */* + + The media type quality factor associated with a given type is + determined by finding the media range with the highest precedence + which matches that type. For example, + + Accept: text/*;q=0.3, text/html;q=0.7, text/html;level=1, + text/html;level=2;q=0.4, */*;q=0.5 + + would cause the following values to be associated: + + text/html;level=1 = 1 + text/html = 0.7 + text/plain = 0.3 + + + +Fielding, et al. Standards Track [Page 101] + +RFC 2616 HTTP/1.1 June 1999 + + + image/jpeg = 0.5 + text/html;level=2 = 0.4 + text/html;level=3 = 0.7 + + Note: A user agent might be provided with a default set of quality + values for certain media ranges. However, unless the user agent is + a closed system which cannot interact with other rendering agents, + this default set ought to be configurable by the user. + +14.2 Accept-Charset + + The Accept-Charset request-header field can be used to indicate what + character sets are acceptable for the response. This field allows + clients capable of understanding more comprehensive or special- + purpose character sets to signal that capability to a server which is + capable of representing documents in those character sets. + + Accept-Charset = "Accept-Charset" ":" + 1#( ( charset | "*" )[ ";" "q" "=" qvalue ] ) + + + Character set values are described in section 3.4. Each charset MAY + be given an associated quality value which represents the user's + preference for that charset. The default value is q=1. An example is + + Accept-Charset: iso-8859-5, unicode-1-1;q=0.8 + + The special value "*", if present in the Accept-Charset field, + matches every character set (including ISO-8859-1) which is not + mentioned elsewhere in the Accept-Charset field. If no "*" is present + in an Accept-Charset field, then all character sets not explicitly + mentioned get a quality value of 0, except for ISO-8859-1, which gets + a quality value of 1 if not explicitly mentioned. + + If no Accept-Charset header is present, the default is that any + character set is acceptable. If an Accept-Charset header is present, + and if the server cannot send a response which is acceptable + according to the Accept-Charset header, then the server SHOULD send + an error response with the 406 (not acceptable) status code, though + the sending of an unacceptable response is also allowed. + +14.3 Accept-Encoding + + The Accept-Encoding request-header field is similar to Accept, but + restricts the content-codings (section 3.5) that are acceptable in + the response. + + Accept-Encoding = "Accept-Encoding" ":" + + + +Fielding, et al. Standards Track [Page 102] + +RFC 2616 HTTP/1.1 June 1999 + + + 1#( codings [ ";" "q" "=" qvalue ] ) + codings = ( content-coding | "*" ) + + Examples of its use are: + + Accept-Encoding: compress, gzip + Accept-Encoding: + Accept-Encoding: * + Accept-Encoding: compress;q=0.5, gzip;q=1.0 + Accept-Encoding: gzip;q=1.0, identity; q=0.5, *;q=0 + + A server tests whether a content-coding is acceptable, according to + an Accept-Encoding field, using these rules: + + 1. If the content-coding is one of the content-codings listed in + the Accept-Encoding field, then it is acceptable, unless it is + accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + 2. The special "*" symbol in an Accept-Encoding field matches any + available content-coding not explicitly listed in the header + field. + + 3. If multiple content-codings are acceptable, then the acceptable + content-coding with the highest non-zero qvalue is preferred. + + 4. The "identity" content-coding is always acceptable, unless + specifically refused because the Accept-Encoding field includes + "identity;q=0", or because the field includes "*;q=0" and does + not explicitly include the "identity" content-coding. If the + Accept-Encoding field-value is empty, then only the "identity" + encoding is acceptable. + + If an Accept-Encoding field is present in a request, and if the + server cannot send a response which is acceptable according to the + Accept-Encoding header, then the server SHOULD send an error response + with the 406 (Not Acceptable) status code. + + If no Accept-Encoding field is present in a request, the server MAY + assume that the client will accept any content coding. In this case, + if "identity" is one of the available content-codings, then the + server SHOULD use the "identity" content-coding, unless it has + additional information that a different content-coding is meaningful + to the client. + + Note: If the request does not include an Accept-Encoding field, + and if the "identity" content-coding is unavailable, then + content-codings commonly understood by HTTP/1.0 clients (i.e., + + + +Fielding, et al. Standards Track [Page 103] + +RFC 2616 HTTP/1.1 June 1999 + + + "gzip" and "compress") are preferred; some older clients + improperly display messages sent with other content-codings. The + server might also make this decision based on information about + the particular user-agent or client. + + Note: Most HTTP/1.0 applications do not recognize or obey qvalues + associated with content-codings. This means that qvalues will not + work and are not permitted with x-gzip or x-compress. + +14.4 Accept-Language + + The Accept-Language request-header field is similar to Accept, but + restricts the set of natural languages that are preferred as a + response to the request. Language tags are defined in section 3.10. + + Accept-Language = "Accept-Language" ":" + 1#( language-range [ ";" "q" "=" qvalue ] ) + language-range = ( ( 1*8ALPHA *( "-" 1*8ALPHA ) ) | "*" ) + + Each language-range MAY be given an associated quality value which + represents an estimate of the user's preference for the languages + specified by that range. The quality value defaults to "q=1". For + example, + + Accept-Language: da, en-gb;q=0.8, en;q=0.7 + + would mean: "I prefer Danish, but will accept British English and + other types of English." A language-range matches a language-tag if + it exactly equals the tag, or if it exactly equals a prefix of the + tag such that the first tag character following the prefix is "-". + The special range "*", if present in the Accept-Language field, + matches every tag not matched by any other range present in the + Accept-Language field. + + Note: This use of a prefix matching rule does not imply that + language tags are assigned to languages in such a way that it is + always true that if a user understands a language with a certain + tag, then this user will also understand all languages with tags + for which this tag is a prefix. The prefix rule simply allows the + use of prefix tags if this is the case. + + The language quality factor assigned to a language-tag by the + Accept-Language field is the quality value of the longest language- + range in the field that matches the language-tag. If no language- + range in the field matches the tag, the language quality factor + assigned is 0. If no Accept-Language header is present in the + request, the server + + + + +Fielding, et al. Standards Track [Page 104] + +RFC 2616 HTTP/1.1 June 1999 + + + SHOULD assume that all languages are equally acceptable. If an + Accept-Language header is present, then all languages which are + assigned a quality factor greater than 0 are acceptable. + + It might be contrary to the privacy expectations of the user to send + an Accept-Language header with the complete linguistic preferences of + the user in every request. For a discussion of this issue, see + section 15.1.4. + + As intelligibility is highly dependent on the individual user, it is + recommended that client applications make the choice of linguistic + preference available to the user. If the choice is not made + available, then the Accept-Language header field MUST NOT be given in + the request. + + Note: When making the choice of linguistic preference available to + the user, we remind implementors of the fact that users are not + familiar with the details of language matching as described above, + and should provide appropriate guidance. As an example, users + might assume that on selecting "en-gb", they will be served any + kind of English document if British English is not available. A + user agent might suggest in such a case to add "en" to get the + best matching behavior. + +14.5 Accept-Ranges + + The Accept-Ranges response-header field allows the server to + indicate its acceptance of range requests for a resource: + + Accept-Ranges = "Accept-Ranges" ":" acceptable-ranges + acceptable-ranges = 1#range-unit | "none" + + Origin servers that accept byte-range requests MAY send + + Accept-Ranges: bytes + + but are not required to do so. Clients MAY generate byte-range + requests without having received this header for the resource + involved. Range units are defined in section 3.12. + + Servers that do not accept any kind of range request for a + resource MAY send + + Accept-Ranges: none + + to advise the client not to attempt a range request. + + + + + +Fielding, et al. Standards Track [Page 105] + +RFC 2616 HTTP/1.1 June 1999 + + +14.6 Age + + The Age response-header field conveys the sender's estimate of the + amount of time since the response (or its revalidation) was + generated at the origin server. A cached response is "fresh" if + its age does not exceed its freshness lifetime. Age values are + calculated as specified in section 13.2.3. + + Age = "Age" ":" age-value + age-value = delta-seconds + + Age values are non-negative decimal integers, representing time in + seconds. + + If a cache receives a value larger than the largest positive + integer it can represent, or if any of its age calculations + overflows, it MUST transmit an Age header with a value of + 2147483648 (2^31). An HTTP/1.1 server that includes a cache MUST + include an Age header field in every response generated from its + own cache. Caches SHOULD use an arithmetic type of at least 31 + bits of range. + +14.7 Allow + + The Allow entity-header field lists the set of methods supported + by the resource identified by the Request-URI. The purpose of this + field is strictly to inform the recipient of valid methods + associated with the resource. An Allow header field MUST be + present in a 405 (Method Not Allowed) response. + + Allow = "Allow" ":" #Method + + Example of use: + + Allow: GET, HEAD, PUT + + This field cannot prevent a client from trying other methods. + However, the indications given by the Allow header field value + SHOULD be followed. The actual set of allowed methods is defined + by the origin server at the time of each request. + + The Allow header field MAY be provided with a PUT request to + recommend the methods to be supported by the new or modified + resource. The server is not required to support these methods and + SHOULD include an Allow header in the response giving the actual + supported methods. + + + + + +Fielding, et al. Standards Track [Page 106] + +RFC 2616 HTTP/1.1 June 1999 + + + A proxy MUST NOT modify the Allow header field even if it does not + understand all the methods specified, since the user agent might + have other means of communicating with the origin server. + +14.8 Authorization + + A user agent that wishes to authenticate itself with a server-- + usually, but not necessarily, after receiving a 401 response--does + so by including an Authorization request-header field with the + request. The Authorization field value consists of credentials + containing the authentication information of the user agent for + the realm of the resource being requested. + + Authorization = "Authorization" ":" credentials + + HTTP access authentication is described in "HTTP Authentication: + Basic and Digest Access Authentication" [43]. If a request is + authenticated and a realm specified, the same credentials SHOULD + be valid for all other requests within this realm (assuming that + the authentication scheme itself does not require otherwise, such + as credentials that vary according to a challenge value or using + synchronized clocks). + + When a shared cache (see section 13.7) receives a request + containing an Authorization field, it MUST NOT return the + corresponding response as a reply to any other request, unless one + of the following specific exceptions holds: + + 1. If the response includes the "s-maxage" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But (if the specified maximum age has + passed) a proxy cache MUST first revalidate it with the origin + server, using the request-headers from the new request to allow + the origin server to authenticate the new request. (This is the + defined behavior for s-maxage.) If the response includes "s- + maxage=0", the proxy MUST always revalidate it before re-using + it. + + 2. If the response includes the "must-revalidate" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But if the response is stale, all caches + MUST first revalidate it with the origin server, using the + request-headers from the new request to allow the origin server + to authenticate the new request. + + 3. If the response includes the "public" cache-control directive, + it MAY be returned in reply to any subsequent request. + + + + +Fielding, et al. Standards Track [Page 107] + +RFC 2616 HTTP/1.1 June 1999 + + +14.9 Cache-Control + + The Cache-Control general-header field is used to specify directives + that MUST be obeyed by all caching mechanisms along the + request/response chain. The directives specify behavior intended to + prevent caches from adversely interfering with the request or + response. These directives typically override the default caching + algorithms. Cache directives are unidirectional in that the presence + of a directive in a request does not imply that the same directive is + to be given in the response. + + Note that HTTP/1.0 caches might not implement Cache-Control and + might only implement Pragma: no-cache (see section 14.32). + + Cache directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a cache- + directive for a specific cache. + + Cache-Control = "Cache-Control" ":" 1#cache-directive + + cache-directive = cache-request-directive + | cache-response-directive + + cache-request-directive = + "no-cache" ; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "max-age" "=" delta-seconds ; Section 14.9.3, 14.9.4 + | "max-stale" [ "=" delta-seconds ] ; Section 14.9.3 + | "min-fresh" "=" delta-seconds ; Section 14.9.3 + | "no-transform" ; Section 14.9.5 + | "only-if-cached" ; Section 14.9.4 + | cache-extension ; Section 14.9.6 + + cache-response-directive = + "public" ; Section 14.9.1 + | "private" [ "=" <"> 1#field-name <"> ] ; Section 14.9.1 + | "no-cache" [ "=" <"> 1#field-name <"> ]; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "no-transform" ; Section 14.9.5 + | "must-revalidate" ; Section 14.9.4 + | "proxy-revalidate" ; Section 14.9.4 + | "max-age" "=" delta-seconds ; Section 14.9.3 + | "s-maxage" "=" delta-seconds ; Section 14.9.3 + | cache-extension ; Section 14.9.6 + + cache-extension = token [ "=" ( token | quoted-string ) ] + + + +Fielding, et al. Standards Track [Page 108] + +RFC 2616 HTTP/1.1 June 1999 + + + When a directive appears without any 1#field-name parameter, the + directive applies to the entire request or response. When such a + directive appears with a 1#field-name parameter, it applies only to + the named field or fields, and not to the rest of the request or + response. This mechanism supports extensibility; implementations of + future versions of the HTTP protocol might apply these directives to + header fields not defined in HTTP/1.1. + + The cache-control directives can be broken down into these general + categories: + + - Restrictions on what are cacheable; these may only be imposed by + the origin server. + + - Restrictions on what may be stored by a cache; these may be + imposed by either the origin server or the user agent. + + - Modifications of the basic expiration mechanism; these may be + imposed by either the origin server or the user agent. + + - Controls over cache revalidation and reload; these may only be + imposed by a user agent. + + - Control over transformation of entities. + + - Extensions to the caching system. + +14.9.1 What is Cacheable + + By default, a response is cacheable if the requirements of the + request method, request header fields, and the response status + indicate that it is cacheable. Section 13.4 summarizes these defaults + for cacheability. The following Cache-Control response directives + allow an origin server to override the default cacheability of a + response: + + public + Indicates that the response MAY be cached by any cache, even if it + would normally be non-cacheable or cacheable only within a non- + shared cache. (See also Authorization, section 14.8, for + additional details.) + + private + Indicates that all or part of the response message is intended for + a single user and MUST NOT be cached by a shared cache. This + allows an origin server to state that the specified parts of the + + + + + +Fielding, et al. Standards Track [Page 109] + +RFC 2616 HTTP/1.1 June 1999 + + + response are intended for only one user and are not a valid + response for requests by other users. A private (non-shared) cache + MAY cache the response. + + Note: This usage of the word private only controls where the + response may be cached, and cannot ensure the privacy of the + message content. + + no-cache + If the no-cache directive does not specify a field-name, then a + cache MUST NOT use the response to satisfy a subsequent request + without successful revalidation with the origin server. This + allows an origin server to prevent caching even by caches that + have been configured to return stale responses to client requests. + + If the no-cache directive does specify one or more field-names, + then a cache MAY use the response to satisfy a subsequent request, + subject to any other restrictions on caching. However, the + specified field-name(s) MUST NOT be sent in the response to a + subsequent request without successful revalidation with the origin + server. This allows an origin server to prevent the re-use of + certain header fields in a response, while still allowing caching + of the rest of the response. + + Note: Most HTTP/1.0 caches will not recognize or obey this + directive. + +14.9.2 What May be Stored by Caches + + no-store + The purpose of the no-store directive is to prevent the + inadvertent release or retention of sensitive information (for + example, on backup tapes). The no-store directive applies to the + entire message, and MAY be sent either in a response or in a + request. If sent in a request, a cache MUST NOT store any part of + either this request or any response to it. If sent in a response, + a cache MUST NOT store any part of either this response or the + request that elicited it. This directive applies to both non- + shared and shared caches. "MUST NOT store" in this context means + that the cache MUST NOT intentionally store the information in + non-volatile storage, and MUST make a best-effort attempt to + remove the information from volatile storage as promptly as + possible after forwarding it. + + Even when this directive is associated with a response, users + might explicitly store such a response outside of the caching + system (e.g., with a "Save As" dialog). History buffers MAY store + such responses as part of their normal operation. + + + +Fielding, et al. Standards Track [Page 110] + +RFC 2616 HTTP/1.1 June 1999 + + + The purpose of this directive is to meet the stated requirements + of certain users and service authors who are concerned about + accidental releases of information via unanticipated accesses to + cache data structures. While the use of this directive might + improve privacy in some cases, we caution that it is NOT in any + way a reliable or sufficient mechanism for ensuring privacy. In + particular, malicious or compromised caches might not recognize or + obey this directive, and communications networks might be + vulnerable to eavesdropping. + +14.9.3 Modifications of the Basic Expiration Mechanism + + The expiration time of an entity MAY be specified by the origin + server using the Expires header (see section 14.21). Alternatively, + it MAY be specified using the max-age directive in a response. When + the max-age cache-control directive is present in a cached response, + the response is stale if its current age is greater than the age + value given (in seconds) at the time of a new request for that + resource. The max-age directive on a response implies that the + response is cacheable (i.e., "public") unless some other, more + restrictive cache directive is also present. + + If a response includes both an Expires header and a max-age + directive, the max-age directive overrides the Expires header, even + if the Expires header is more restrictive. This rule allows an origin + server to provide, for a given response, a longer expiration time to + an HTTP/1.1 (or later) cache than to an HTTP/1.0 cache. This might be + useful if certain HTTP/1.0 caches improperly calculate ages or + expiration times, perhaps due to desynchronized clocks. + + Many HTTP/1.0 cache implementations will treat an Expires value that + is less than or equal to the response Date value as being equivalent + to the Cache-Control response directive "no-cache". If an HTTP/1.1 + cache receives such a response, and the response does not include a + Cache-Control header field, it SHOULD consider the response to be + non-cacheable in order to retain compatibility with HTTP/1.0 servers. + + Note: An origin server might wish to use a relatively new HTTP + cache control feature, such as the "private" directive, on a + network including older caches that do not understand that + feature. The origin server will need to combine the new feature + with an Expires field whose value is less than or equal to the + Date value. This will prevent older caches from improperly + caching the response. + + + + + + + +Fielding, et al. Standards Track [Page 111] + +RFC 2616 HTTP/1.1 June 1999 + + + s-maxage + If a response includes an s-maxage directive, then for a shared + cache (but not for a private cache), the maximum age specified by + this directive overrides the maximum age specified by either the + max-age directive or the Expires header. The s-maxage directive + also implies the semantics of the proxy-revalidate directive (see + section 14.9.4), i.e., that the shared cache must not use the + entry after it becomes stale to respond to a subsequent request + without first revalidating it with the origin server. The s- + maxage directive is always ignored by a private cache. + + Note that most older caches, not compliant with this specification, + do not implement any cache-control directives. An origin server + wishing to use a cache-control directive that restricts, but does not + prevent, caching by an HTTP/1.1-compliant cache MAY exploit the + requirement that the max-age directive overrides the Expires header, + and the fact that pre-HTTP/1.1-compliant caches do not observe the + max-age directive. + + Other directives allow a user agent to modify the basic expiration + mechanism. These directives MAY be specified on a request: + + max-age + Indicates that the client is willing to accept a response whose + age is no greater than the specified time in seconds. Unless max- + stale directive is also included, the client is not willing to + accept a stale response. + + min-fresh + Indicates that the client is willing to accept a response whose + freshness lifetime is no less than its current age plus the + specified time in seconds. That is, the client wants a response + that will still be fresh for at least the specified number of + seconds. + + max-stale + Indicates that the client is willing to accept a response that has + exceeded its expiration time. If max-stale is assigned a value, + then the client is willing to accept a response that has exceeded + its expiration time by no more than the specified number of + seconds. If no value is assigned to max-stale, then the client is + willing to accept a stale response of any age. + + If a cache returns a stale response, either because of a max-stale + directive on a request, or because the cache is configured to + override the expiration time of a response, the cache MUST attach a + Warning header to the stale response, using Warning 110 (Response is + stale). + + + +Fielding, et al. Standards Track [Page 112] + +RFC 2616 HTTP/1.1 June 1999 + + + A cache MAY be configured to return stale responses without + validation, but only if this does not conflict with any "MUST"-level + requirements concerning cache validation (e.g., a "must-revalidate" + cache-control directive). + + If both the new request and the cached entry include "max-age" + directives, then the lesser of the two values is used for determining + the freshness of the cached entry for that request. + +14.9.4 Cache Revalidation and Reload Controls + + Sometimes a user agent might want or need to insist that a cache + revalidate its cache entry with the origin server (and not just with + the next cache along the path to the origin server), or to reload its + cache entry from the origin server. End-to-end revalidation might be + necessary if either the cache or the origin server has overestimated + the expiration time of the cached response. End-to-end reload may be + necessary if the cache entry has become corrupted for some reason. + + End-to-end revalidation may be requested either when the client does + not have its own local cached copy, in which case we call it + "unspecified end-to-end revalidation", or when the client does have a + local cached copy, in which case we call it "specific end-to-end + revalidation." + + The client can specify these three kinds of action using Cache- + Control request directives: + + End-to-end reload + The request includes a "no-cache" cache-control directive or, for + compatibility with HTTP/1.0 clients, "Pragma: no-cache". Field + names MUST NOT be included with the no-cache directive in a + request. The server MUST NOT use a cached copy when responding to + such a request. + + Specific end-to-end revalidation + The request includes a "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request includes a cache-validating conditional with + the client's current validator. + + Unspecified end-to-end revalidation + The request includes "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request does not include a cache-validating + + + + +Fielding, et al. Standards Track [Page 113] + +RFC 2616 HTTP/1.1 June 1999 + + + conditional; the first cache along the path (if any) that holds a + cache entry for this resource includes a cache-validating + conditional with its current validator. + + max-age + When an intermediate cache is forced, by means of a max-age=0 + directive, to revalidate its own cache entry, and the client has + supplied its own validator in the request, the supplied validator + might differ from the validator currently stored with the cache + entry. In this case, the cache MAY use either validator in making + its own request without affecting semantic transparency. + + However, the choice of validator might affect performance. The + best approach is for the intermediate cache to use its own + validator when making its request. If the server replies with 304 + (Not Modified), then the cache can return its now validated copy + to the client with a 200 (OK) response. If the server replies with + a new entity and cache validator, however, the intermediate cache + can compare the returned validator with the one provided in the + client's request, using the strong comparison function. If the + client's validator is equal to the origin server's, then the + intermediate cache simply returns 304 (Not Modified). Otherwise, + it returns the new entity with a 200 (OK) response. + + If a request includes the no-cache directive, it SHOULD NOT + include min-fresh, max-stale, or max-age. + + only-if-cached + In some cases, such as times of extremely poor network + connectivity, a client may want a cache to return only those + responses that it currently has stored, and not to reload or + revalidate with the origin server. To do this, the client may + include the only-if-cached directive in a request. If it receives + this directive, a cache SHOULD either respond using a cached entry + that is consistent with the other constraints of the request, or + respond with a 504 (Gateway Timeout) status. However, if a group + of caches is being operated as a unified system with good internal + connectivity, such a request MAY be forwarded within that group of + caches. + + must-revalidate + Because a cache MAY be configured to ignore a server's specified + expiration time, and because a client request MAY include a max- + stale directive (which has a similar effect), the protocol also + includes a mechanism for the origin server to require revalidation + of a cache entry on any subsequent use. When the must-revalidate + directive is present in a response received by a cache, that cache + MUST NOT use the entry after it becomes stale to respond to a + + + +Fielding, et al. Standards Track [Page 114] + +RFC 2616 HTTP/1.1 June 1999 + + + subsequent request without first revalidating it with the origin + server. (I.e., the cache MUST do an end-to-end revalidation every + time, if, based solely on the origin server's Expires or max-age + value, the cached response is stale.) + + The must-revalidate directive is necessary to support reliable + operation for certain protocol features. In all circumstances an + HTTP/1.1 cache MUST obey the must-revalidate directive; in + particular, if the cache cannot reach the origin server for any + reason, it MUST generate a 504 (Gateway Timeout) response. + + Servers SHOULD send the must-revalidate directive if and only if + failure to revalidate a request on the entity could result in + incorrect operation, such as a silently unexecuted financial + transaction. Recipients MUST NOT take any automated action that + violates this directive, and MUST NOT automatically provide an + unvalidated copy of the entity if revalidation fails. + + Although this is not recommended, user agents operating under + severe connectivity constraints MAY violate this directive but, if + so, MUST explicitly warn the user that an unvalidated response has + been provided. The warning MUST be provided on each unvalidated + access, and SHOULD require explicit user confirmation. + + proxy-revalidate + The proxy-revalidate directive has the same meaning as the must- + revalidate directive, except that it does not apply to non-shared + user agent caches. It can be used on a response to an + authenticated request to permit the user's cache to store and + later return the response without needing to revalidate it (since + it has already been authenticated once by that user), while still + requiring proxies that service many users to revalidate each time + (in order to make sure that each user has been authenticated). + Note that such authenticated responses also need the public cache + control directive in order to allow them to be cached at all. + +14.9.5 No-Transform Directive + + no-transform + Implementors of intermediate caches (proxies) have found it useful + to convert the media type of certain entity bodies. A non- + transparent proxy might, for example, convert between image + formats in order to save cache space or to reduce the amount of + traffic on a slow link. + + Serious operational problems occur, however, when these + transformations are applied to entity bodies intended for certain + kinds of applications. For example, applications for medical + + + +Fielding, et al. Standards Track [Page 115] + +RFC 2616 HTTP/1.1 June 1999 + + + imaging, scientific data analysis and those using end-to-end + authentication, all depend on receiving an entity body that is bit + for bit identical to the original entity-body. + + Therefore, if a message includes the no-transform directive, an + intermediate cache or proxy MUST NOT change those headers that are + listed in section 13.5.2 as being subject to the no-transform + directive. This implies that the cache or proxy MUST NOT change + any aspect of the entity-body that is specified by these headers, + including the value of the entity-body itself. + +14.9.6 Cache Control Extensions + + The Cache-Control header field can be extended through the use of one + or more cache-extension tokens, each with an optional assigned value. + Informational extensions (those which do not require a change in + cache behavior) MAY be added without changing the semantics of other + directives. Behavioral extensions are designed to work by acting as + modifiers to the existing base of cache directives. Both the new + directive and the standard directive are supplied, such that + applications which do not understand the new directive will default + to the behavior specified by the standard directive, and those that + understand the new directive will recognize it as modifying the + requirements associated with the standard directive. In this way, + extensions to the cache-control directives can be made without + requiring changes to the base protocol. + + This extension mechanism depends on an HTTP cache obeying all of the + cache-control directives defined for its native HTTP-version, obeying + certain extensions, and ignoring all directives that it does not + understand. + + For example, consider a hypothetical new response directive called + community which acts as a modifier to the private directive. We + define this new directive to mean that, in addition to any non-shared + cache, any cache which is shared only by members of the community + named within its value may cache the response. An origin server + wishing to allow the UCI community to use an otherwise private + response in their shared cache(s) could do so by including + + Cache-Control: private, community="UCI" + + A cache seeing this header field will act correctly even if the cache + does not understand the community cache-extension, since it will also + see and understand the private directive and thus default to the safe + behavior. + + + + + +Fielding, et al. Standards Track [Page 116] + +RFC 2616 HTTP/1.1 June 1999 + + + Unrecognized cache-directives MUST be ignored; it is assumed that any + cache-directive likely to be unrecognized by an HTTP/1.1 cache will + be combined with standard directives (or the response's default + cacheability) such that the cache behavior will remain minimally + correct even if the cache does not understand the extension(s). + +14.10 Connection + + The Connection general-header field allows the sender to specify + options that are desired for that particular connection and MUST NOT + be communicated by proxies over further connections. + + The Connection header has the following grammar: + + Connection = "Connection" ":" 1#(connection-token) + connection-token = token + + HTTP/1.1 proxies MUST parse the Connection header field before a + message is forwarded and, for each connection-token in this field, + remove any header field(s) from the message with the same name as the + connection-token. Connection options are signaled by the presence of + a connection-token in the Connection header field, not by any + corresponding additional header field(s), since the additional header + field may not be sent if there are no parameters associated with that + connection option. + + Message headers listed in the Connection header MUST NOT include + end-to-end headers, such as Cache-Control. + + HTTP/1.1 defines the "close" connection option for the sender to + signal that the connection will be closed after completion of the + response. For example, + + Connection: close + + in either the request or the response header fields indicates that + the connection SHOULD NOT be considered `persistent' (section 8.1) + after the current request/response is complete. + + HTTP/1.1 applications that do not support persistent connections MUST + include the "close" connection option in every message. + + A system receiving an HTTP/1.0 (or lower-version) message that + includes a Connection header MUST, for each connection-token in this + field, remove and ignore any header field(s) from the message with + the same name as the connection-token. This protects against mistaken + forwarding of such header fields by pre-HTTP/1.1 proxies. See section + 19.6.2. + + + +Fielding, et al. Standards Track [Page 117] + +RFC 2616 HTTP/1.1 June 1999 + + +14.11 Content-Encoding + + The Content-Encoding entity-header field is used as a modifier to the + media-type. When present, its value indicates what additional content + codings have been applied to the entity-body, and thus what decoding + mechanisms must be applied in order to obtain the media-type + referenced by the Content-Type header field. Content-Encoding is + primarily used to allow a document to be compressed without losing + the identity of its underlying media type. + + Content-Encoding = "Content-Encoding" ":" 1#content-coding + + Content codings are defined in section 3.5. An example of its use is + + Content-Encoding: gzip + + The content-coding is a characteristic of the entity identified by + the Request-URI. Typically, the entity-body is stored with this + encoding and is only decoded before rendering or analogous usage. + However, a non-transparent proxy MAY modify the content-coding if the + new coding is known to be acceptable to the recipient, unless the + "no-transform" cache-control directive is present in the message. + + If the content-coding of an entity is not "identity", then the + response MUST include a Content-Encoding entity-header (section + 14.11) that lists the non-identity content-coding(s) used. + + If the content-coding of an entity in a request message is not + acceptable to the origin server, the server SHOULD respond with a + status code of 415 (Unsupported Media Type). + + If multiple encodings have been applied to an entity, the content + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + +14.12 Content-Language + + The Content-Language entity-header field describes the natural + language(s) of the intended audience for the enclosed entity. Note + that this might not be equivalent to all the languages used within + the entity-body. + + Content-Language = "Content-Language" ":" 1#language-tag + + + + + + + +Fielding, et al. Standards Track [Page 118] + +RFC 2616 HTTP/1.1 June 1999 + + + Language tags are defined in section 3.10. The primary purpose of + Content-Language is to allow a user to identify and differentiate + entities according to the user's own preferred language. Thus, if the + body content is intended only for a Danish-literate audience, the + appropriate field is + + Content-Language: da + + If no Content-Language is specified, the default is that the content + is intended for all language audiences. This might mean that the + sender does not consider it to be specific to any natural language, + or that the sender does not know for which language it is intended. + + Multiple languages MAY be listed for content that is intended for + multiple audiences. For example, a rendition of the "Treaty of + Waitangi," presented simultaneously in the original Maori and English + versions, would call for + + Content-Language: mi, en + + However, just because multiple languages are present within an entity + does not mean that it is intended for multiple linguistic audiences. + An example would be a beginner's language primer, such as "A First + Lesson in Latin," which is clearly intended to be used by an + English-literate audience. In this case, the Content-Language would + properly only include "en". + + Content-Language MAY be applied to any media type -- it is not + limited to textual documents. + +14.13 Content-Length + + The Content-Length entity-header field indicates the size of the + entity-body, in decimal number of OCTETs, sent to the recipient or, + in the case of the HEAD method, the size of the entity-body that + would have been sent had the request been a GET. + + Content-Length = "Content-Length" ":" 1*DIGIT + + An example is + + Content-Length: 3495 + + Applications SHOULD use this field to indicate the transfer-length of + the message-body, unless this is prohibited by the rules in section + 4.4. + + + + + +Fielding, et al. Standards Track [Page 119] + +RFC 2616 HTTP/1.1 June 1999 + + + Any Content-Length greater than or equal to zero is a valid value. + Section 4.4 describes how to determine the length of a message-body + if a Content-Length is not given. + + Note that the meaning of this field is significantly different from + the corresponding definition in MIME, where it is an optional field + used within the "message/external-body" content-type. In HTTP, it + SHOULD be sent whenever the message's length can be determined prior + to being transferred, unless this is prohibited by the rules in + section 4.4. + +14.14 Content-Location + + The Content-Location entity-header field MAY be used to supply the + resource location for the entity enclosed in the message when that + entity is accessible from a location separate from the requested + resource's URI. A server SHOULD provide a Content-Location for the + variant corresponding to the response entity; especially in the case + where a resource has multiple entities associated with it, and those + entities actually have separate locations by which they might be + individually accessed, the server SHOULD provide a Content-Location + for the particular variant which is returned. + + Content-Location = "Content-Location" ":" + ( absoluteURI | relativeURI ) + + The value of Content-Location also defines the base URI for the + entity. + + The Content-Location value is not a replacement for the original + requested URI; it is only a statement of the location of the resource + corresponding to this particular entity at the time of the request. + Future requests MAY specify the Content-Location URI as the request- + URI if the desire is to identify the source of that particular + entity. + + A cache cannot assume that an entity with a Content-Location + different from the URI used to retrieve it can be used to respond to + later requests on that Content-Location URI. However, the Content- + Location can be used to differentiate between multiple entities + retrieved from a single requested resource, as described in section + 13.6. + + If the Content-Location is a relative URI, the relative URI is + interpreted relative to the Request-URI. + + The meaning of the Content-Location header in PUT or POST requests is + undefined; servers are free to ignore it in those cases. + + + +Fielding, et al. Standards Track [Page 120] + +RFC 2616 HTTP/1.1 June 1999 + + +14.15 Content-MD5 + + The Content-MD5 entity-header field, as defined in RFC 1864 [23], is + an MD5 digest of the entity-body for the purpose of providing an + end-to-end message integrity check (MIC) of the entity-body. (Note: a + MIC is good for detecting accidental modification of the entity-body + in transit, but is not proof against malicious attacks.) + + Content-MD5 = "Content-MD5" ":" md5-digest + md5-digest = + + The Content-MD5 header field MAY be generated by an origin server or + client to function as an integrity check of the entity-body. Only + origin servers or clients MAY generate the Content-MD5 header field; + proxies and gateways MUST NOT generate it, as this would defeat its + value as an end-to-end integrity check. Any recipient of the entity- + body, including gateways and proxies, MAY check that the digest value + in this header field matches that of the entity-body as received. + + The MD5 digest is computed based on the content of the entity-body, + including any content-coding that has been applied, but not including + any transfer-encoding applied to the message-body. If the message is + received with a transfer-encoding, that encoding MUST be removed + prior to checking the Content-MD5 value against the received entity. + + This has the result that the digest is computed on the octets of the + entity-body exactly as, and in the order that, they would be sent if + no transfer-encoding were being applied. + + HTTP extends RFC 1864 to permit the digest to be computed for MIME + composite media-types (e.g., multipart/* and message/rfc822), but + this does not change how the digest is computed as defined in the + preceding paragraph. + + There are several consequences of this. The entity-body for composite + types MAY contain many body-parts, each with its own MIME and HTTP + headers (including Content-MD5, Content-Transfer-Encoding, and + Content-Encoding headers). If a body-part has a Content-Transfer- + Encoding or Content-Encoding header, it is assumed that the content + of the body-part has had the encoding applied, and the body-part is + included in the Content-MD5 digest as is -- i.e., after the + application. The Transfer-Encoding header field is not allowed within + body-parts. + + Conversion of all line breaks to CRLF MUST NOT be done before + computing or checking the digest: the line break convention used in + the text actually transmitted MUST be left unaltered when computing + the digest. + + + +Fielding, et al. Standards Track [Page 121] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: while the definition of Content-MD5 is exactly the same for + HTTP as in RFC 1864 for MIME entity-bodies, there are several ways + in which the application of Content-MD5 to HTTP entity-bodies + differs from its application to MIME entity-bodies. One is that + HTTP, unlike MIME, does not use Content-Transfer-Encoding, and + does use Transfer-Encoding and Content-Encoding. Another is that + HTTP more frequently uses binary content types than MIME, so it is + worth noting that, in such cases, the byte order used to compute + the digest is the transmission byte order defined for the type. + Lastly, HTTP allows transmission of text types with any of several + line break conventions and not just the canonical form using CRLF. + +14.16 Content-Range + + The Content-Range entity-header is sent with a partial entity-body to + specify where in the full entity-body the partial body should be + applied. Range units are defined in section 3.12. + + Content-Range = "Content-Range" ":" content-range-spec + + content-range-spec = byte-content-range-spec + byte-content-range-spec = bytes-unit SP + byte-range-resp-spec "/" + ( instance-length | "*" ) + + byte-range-resp-spec = (first-byte-pos "-" last-byte-pos) + | "*" + instance-length = 1*DIGIT + + The header SHOULD indicate the total length of the full entity-body, + unless this length is unknown or difficult to determine. The asterisk + "*" character means that the instance-length is unknown at the time + when the response was generated. + + Unlike byte-ranges-specifier values (see section 14.35.1), a byte- + range-resp-spec MUST only specify one range, and MUST contain + absolute byte positions for both the first and last byte of the + range. + + A byte-content-range-spec with a byte-range-resp-spec whose last- + byte-pos value is less than its first-byte-pos value, or whose + instance-length value is less than or equal to its last-byte-pos + value, is invalid. The recipient of an invalid byte-content-range- + spec MUST ignore it and any content transferred along with it. + + A server sending a response with status code 416 (Requested range not + satisfiable) SHOULD include a Content-Range field with a byte-range- + resp-spec of "*". The instance-length specifies the current length of + + + +Fielding, et al. Standards Track [Page 122] + +RFC 2616 HTTP/1.1 June 1999 + + + the selected resource. A response with status code 206 (Partial + Content) MUST NOT include a Content-Range field with a byte-range- + resp-spec of "*". + + Examples of byte-content-range-spec values, assuming that the entity + contains a total of 1234 bytes: + + . The first 500 bytes: + bytes 0-499/1234 + + . The second 500 bytes: + bytes 500-999/1234 + + . All except for the first 500 bytes: + bytes 500-1233/1234 + + . The last 500 bytes: + bytes 734-1233/1234 + + When an HTTP message includes the content of a single range (for + example, a response to a request for a single range, or to a request + for a set of ranges that overlap without any holes), this content is + transmitted with a Content-Range header, and a Content-Length header + showing the number of bytes actually transferred. For example, + + HTTP/1.1 206 Partial content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-Range: bytes 21010-47021/47022 + Content-Length: 26012 + Content-Type: image/gif + + When an HTTP message includes the content of multiple ranges (for + example, a response to a request for multiple non-overlapping + ranges), these are transmitted as a multipart message. The multipart + media type used for this purpose is "multipart/byteranges" as defined + in appendix 19.2. See appendix 19.6.3 for a compatibility issue. + + A response to a request for a single range MUST NOT be sent using the + multipart/byteranges media type. A response to a request for + multiple ranges, whose result is a single range, MAY be sent as a + multipart/byteranges media type with one part. A client that cannot + decode a multipart/byteranges message MUST NOT ask for multiple + byte-ranges in a single request. + + When a client requests multiple byte-ranges in one request, the + server SHOULD return them in the order that they appeared in the + request. + + + +Fielding, et al. Standards Track [Page 123] + +RFC 2616 HTTP/1.1 June 1999 + + + If the server ignores a byte-range-spec because it is syntactically + invalid, the server SHOULD treat the request as if the invalid Range + header field did not exist. (Normally, this means return a 200 + response containing the full entity). + + If the server receives a request (other than one including an If- + Range request-header field) with an unsatisfiable Range request- + header field (that is, all of whose byte-range-spec values have a + first-byte-pos value greater than the current length of the selected + resource), it SHOULD return a response code of 416 (Requested range + not satisfiable) (section 10.4.17). + + Note: clients cannot depend on servers to send a 416 (Requested + range not satisfiable) response instead of a 200 (OK) response for + an unsatisfiable Range request-header, since not all servers + implement this request-header. + +14.17 Content-Type + + The Content-Type entity-header field indicates the media type of the + entity-body sent to the recipient or, in the case of the HEAD method, + the media type that would have been sent had the request been a GET. + + Content-Type = "Content-Type" ":" media-type + + Media types are defined in section 3.7. An example of the field is + + Content-Type: text/html; charset=ISO-8859-4 + + Further discussion of methods for identifying the media type of an + entity is provided in section 7.2.1. + +14.18 Date + + The Date general-header field represents the date and time at which + the message was originated, having the same semantics as orig-date in + RFC 822. The field value is an HTTP-date, as described in section + 3.3.1; it MUST be sent in RFC 1123 [8]-date format. + + Date = "Date" ":" HTTP-date + + An example is + + Date: Tue, 15 Nov 1994 08:12:31 GMT + + Origin servers MUST include a Date header field in all responses, + except in these cases: + + + + +Fielding, et al. Standards Track [Page 124] + +RFC 2616 HTTP/1.1 June 1999 + + + 1. If the response status code is 100 (Continue) or 101 (Switching + Protocols), the response MAY include a Date header field, at + the server's option. + + 2. If the response status code conveys a server error, e.g. 500 + (Internal Server Error) or 503 (Service Unavailable), and it is + inconvenient or impossible to generate a valid Date. + + 3. If the server does not have a clock that can provide a + reasonable approximation of the current time, its responses + MUST NOT include a Date header field. In this case, the rules + in section 14.18.1 MUST be followed. + + A received message that does not have a Date header field MUST be + assigned one by the recipient if the message will be cached by that + recipient or gatewayed via a protocol which requires a Date. An HTTP + implementation without a clock MUST NOT cache responses without + revalidating them on every use. An HTTP cache, especially a shared + cache, SHOULD use a mechanism, such as NTP [28], to synchronize its + clock with a reliable external standard. + + Clients SHOULD only send a Date header field in messages that include + an entity-body, as in the case of the PUT and POST requests, and even + then it is optional. A client without a clock MUST NOT send a Date + header field in a request. + + The HTTP-date sent in a Date header SHOULD NOT represent a date and + time subsequent to the generation of the message. It SHOULD represent + the best available approximation of the date and time of message + generation, unless the implementation has no means of generating a + reasonably accurate date and time. In theory, the date ought to + represent the moment just before the entity is generated. In + practice, the date can be generated at any time during the message + origination without affecting its semantic value. + +14.18.1 Clockless Origin Server Operation + + Some origin server implementations might not have a clock available. + An origin server without a clock MUST NOT assign Expires or Last- + Modified values to a response, unless these values were associated + with the resource by a system or user with a reliable clock. It MAY + assign an Expires value that is known, at or before server + configuration time, to be in the past (this allows "pre-expiration" + of responses without storing separate Expires values for each + resource). + + + + + + +Fielding, et al. Standards Track [Page 125] + +RFC 2616 HTTP/1.1 June 1999 + + +14.19 ETag + + The ETag response-header field provides the current value of the + entity tag for the requested variant. The headers used with entity + tags are described in sections 14.24, 14.26 and 14.44. The entity tag + MAY be used for comparison with other entities from the same resource + (see section 13.3.3). + + ETag = "ETag" ":" entity-tag + + Examples: + + ETag: "xyzzy" + ETag: W/"xyzzy" + ETag: "" + +14.20 Expect + + The Expect request-header field is used to indicate that particular + server behaviors are required by the client. + + Expect = "Expect" ":" 1#expectation + + expectation = "100-continue" | expectation-extension + expectation-extension = token [ "=" ( token | quoted-string ) + *expect-params ] + expect-params = ";" token [ "=" ( token | quoted-string ) ] + + + A server that does not understand or is unable to comply with any of + the expectation values in the Expect field of a request MUST respond + with appropriate error status. The server MUST respond with a 417 + (Expectation Failed) status if any of the expectations cannot be met + or, if there are other problems with the request, some other 4xx + status. + + This header field is defined with extensible syntax to allow for + future extensions. If a server receives a request containing an + Expect field that includes an expectation-extension that it does not + support, it MUST respond with a 417 (Expectation Failed) status. + + Comparison of expectation values is case-insensitive for unquoted + tokens (including the 100-continue token), and is case-sensitive for + quoted-string expectation-extensions. + + + + + + + +Fielding, et al. Standards Track [Page 126] + +RFC 2616 HTTP/1.1 June 1999 + + + The Expect mechanism is hop-by-hop: that is, an HTTP/1.1 proxy MUST + return a 417 (Expectation Failed) status if it receives a request + with an expectation that it cannot meet. However, the Expect + request-header itself is end-to-end; it MUST be forwarded if the + request is forwarded. + + Many older HTTP/1.0 and HTTP/1.1 applications do not understand the + Expect header. + + See section 8.2.3 for the use of the 100 (continue) status. + +14.21 Expires + + The Expires entity-header field gives the date/time after which the + response is considered stale. A stale cache entry may not normally be + returned by a cache (either a proxy cache or a user agent cache) + unless it is first validated with the origin server (or with an + intermediate cache that has a fresh copy of the entity). See section + 13.2 for further discussion of the expiration model. + + The presence of an Expires field does not imply that the original + resource will change or cease to exist at, before, or after that + time. + + The format is an absolute date and time as defined by HTTP-date in + section 3.3.1; it MUST be in RFC 1123 date format: + + Expires = "Expires" ":" HTTP-date + + An example of its use is + + Expires: Thu, 01 Dec 1994 16:00:00 GMT + + Note: if a response includes a Cache-Control field with the max- + age directive (see section 14.9.3), that directive overrides the + Expires field. + + HTTP/1.1 clients and caches MUST treat other invalid date formats, + especially including the value "0", as in the past (i.e., "already + expired"). + + To mark a response as "already expired," an origin server sends an + Expires date that is equal to the Date header value. (See the rules + for expiration calculations in section 13.2.4.) + + + + + + + +Fielding, et al. Standards Track [Page 127] + +RFC 2616 HTTP/1.1 June 1999 + + + To mark a response as "never expires," an origin server sends an + Expires date approximately one year from the time the response is + sent. HTTP/1.1 servers SHOULD NOT send Expires dates more than one + year in the future. + + The presence of an Expires header field with a date value of some + time in the future on a response that otherwise would by default be + non-cacheable indicates that the response is cacheable, unless + indicated otherwise by a Cache-Control header field (section 14.9). + +14.22 From + + The From request-header field, if given, SHOULD contain an Internet + e-mail address for the human user who controls the requesting user + agent. The address SHOULD be machine-usable, as defined by "mailbox" + in RFC 822 [9] as updated by RFC 1123 [8]: + + From = "From" ":" mailbox + + An example is: + + From: webmaster@w3.org + + This header field MAY be used for logging purposes and as a means for + identifying the source of invalid or unwanted requests. It SHOULD NOT + be used as an insecure form of access protection. The interpretation + of this field is that the request is being performed on behalf of the + person given, who accepts responsibility for the method performed. In + particular, robot agents SHOULD include this header so that the + person responsible for running the robot can be contacted if problems + occur on the receiving end. + + The Internet e-mail address in this field MAY be separate from the + Internet host which issued the request. For example, when a request + is passed through a proxy the original issuer's address SHOULD be + used. + + The client SHOULD NOT send the From header field without the user's + approval, as it might conflict with the user's privacy interests or + their site's security policy. It is strongly recommended that the + user be able to disable, enable, and modify the value of this field + at any time prior to a request. + +14.23 Host + + The Host request-header field specifies the Internet host and port + number of the resource being requested, as obtained from the original + URI given by the user or referring resource (generally an HTTP URL, + + + +Fielding, et al. Standards Track [Page 128] + +RFC 2616 HTTP/1.1 June 1999 + + + as described in section 3.2.2). The Host field value MUST represent + the naming authority of the origin server or gateway given by the + original URL. This allows the origin server or gateway to + differentiate between internally-ambiguous URLs, such as the root "/" + URL of a server for multiple host names on a single IP address. + + Host = "Host" ":" host [ ":" port ] ; Section 3.2.2 + + A "host" without any trailing port information implies the default + port for the service requested (e.g., "80" for an HTTP URL). For + example, a request on the origin server for + would properly include: + + GET /pub/WWW/ HTTP/1.1 + Host: www.w3.org + + A client MUST include a Host header field in all HTTP/1.1 request + messages . If the requested URI does not include an Internet host + name for the service being requested, then the Host header field MUST + be given with an empty value. An HTTP/1.1 proxy MUST ensure that any + request message it forwards does contain an appropriate Host header + field that identifies the service being requested by the proxy. All + Internet-based HTTP/1.1 servers MUST respond with a 400 (Bad Request) + status code to any HTTP/1.1 request message which lacks a Host header + field. + + See sections 5.2 and 19.6.1.1 for other requirements relating to + Host. + +14.24 If-Match + + The If-Match request-header field is used with a method to make it + conditional. A client that has one or more entities previously + obtained from the resource can verify that one of those entities is + current by including a list of their associated entity tags in the + If-Match header field. Entity tags are defined in section 3.11. The + purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. It is also + used, on updating requests, to prevent inadvertent modification of + the wrong version of a resource. As a special case, the value "*" + matches any current entity of the resource. + + If-Match = "If-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-Match header) on that resource, or if "*" is given + + + + +Fielding, et al. Standards Track [Page 129] + +RFC 2616 HTTP/1.1 June 1999 + + + and any current entity exists for that resource, then the server MAY + perform the requested method as if the If-Match header field did not + exist. + + A server MUST use the strong comparison function (see section 13.3.3) + to compare the entity tags in If-Match. + + If none of the entity tags match, or if "*" is given and no current + entity exists, the server MUST NOT perform the requested method, and + MUST return a 412 (Precondition Failed) response. This behavior is + most useful when the client wants to prevent an updating method, such + as PUT, from modifying a resource that has changed since the client + last retrieved it. + + If the request would, without the If-Match header field, result in + anything other than a 2xx or 412 status, then the If-Match header + MUST be ignored. + + The meaning of "If-Match: *" is that the method SHOULD be performed + if the representation selected by the origin server (or by a cache, + possibly using the Vary mechanism, see section 14.44) exists, and + MUST NOT be performed if the representation does not exist. + + A request intended to update a resource (e.g., a PUT) MAY include an + If-Match header field to signal that the request method MUST NOT be + applied if the entity corresponding to the If-Match value (a single + entity tag) is no longer a representation of that resource. This + allows the user to indicate that they do not wish the request to be + successful if the resource has been changed without their knowledge. + Examples: + + If-Match: "xyzzy" + If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-Match: * + + The result of a request having both an If-Match header field and + either an If-None-Match or an If-Modified-Since header fields is + undefined by this specification. + +14.25 If-Modified-Since + + The If-Modified-Since request-header field is used with a method to + make it conditional: if the requested variant has not been modified + since the time specified in this field, an entity will not be + returned from the server; instead, a 304 (not modified) response will + be returned without any message-body. + + If-Modified-Since = "If-Modified-Since" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 130] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of the field is: + + If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + A GET method with an If-Modified-Since header and no Range header + requests that the identified entity be transferred only if it has + been modified since the date given by the If-Modified-Since header. + The algorithm for determining this includes the following cases: + + a) If the request would normally result in anything other than a + 200 (OK) status, or if the passed If-Modified-Since date is + invalid, the response is exactly the same as for a normal GET. + A date which is later than the server's current time is + invalid. + + b) If the variant has been modified since the If-Modified-Since + date, the response is exactly the same as for a normal GET. + + c) If the variant has not been modified since a valid If- + Modified-Since date, the server SHOULD return a 304 (Not + Modified) response. + + The purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. + + Note: The Range request-header field modifies the meaning of If- + Modified-Since; see section 14.35 for full details. + + Note: If-Modified-Since times are interpreted by the server, whose + clock might not be synchronized with the client. + + Note: When handling an If-Modified-Since header field, some + servers will use an exact date comparison function, rather than a + less-than function, for deciding whether to send a 304 (Not + Modified) response. To get best results when sending an If- + Modified-Since header field for cache validation, clients are + advised to use the exact date string received in a previous Last- + Modified header field whenever possible. + + Note: If a client uses an arbitrary date in the If-Modified-Since + header instead of a date taken from the Last-Modified header for + the same request, the client should be aware of the fact that this + date is interpreted in the server's understanding of time. The + client should consider unsynchronized clocks and rounding problems + due to the different encodings of time between the client and + server. This includes the possibility of race conditions if the + document has changed between the time it was first requested and + the If-Modified-Since date of a subsequent request, and the + + + +Fielding, et al. Standards Track [Page 131] + +RFC 2616 HTTP/1.1 June 1999 + + + possibility of clock-skew-related problems if the If-Modified- + Since date is derived from the client's clock without correction + to the server's clock. Corrections for different time bases + between client and server are at best approximate due to network + latency. + + The result of a request having both an If-Modified-Since header field + and either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.26 If-None-Match + + The If-None-Match request-header field is used with a method to make + it conditional. A client that has one or more entities previously + obtained from the resource can verify that none of those entities is + current by including a list of their associated entity tags in the + If-None-Match header field. The purpose of this feature is to allow + efficient updates of cached information with a minimum amount of + transaction overhead. It is also used to prevent a method (e.g. PUT) + from inadvertently modifying an existing resource when the client + believes that the resource does not exist. + + As a special case, the value "*" matches any current entity of the + resource. + + If-None-Match = "If-None-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-None-Match header) on that resource, or if "*" is + given and any current entity exists for that resource, then the + server MUST NOT perform the requested method, unless required to do + so because the resource's modification date fails to match that + supplied in an If-Modified-Since header field in the request. + Instead, if the request method was GET or HEAD, the server SHOULD + respond with a 304 (Not Modified) response, including the cache- + related header fields (particularly ETag) of one of the entities that + matched. For all other request methods, the server MUST respond with + a status of 412 (Precondition Failed). + + See section 13.3.3 for rules on how to determine if two entities tags + match. The weak comparison function can only be used with GET or HEAD + requests. + + + + + + + + +Fielding, et al. Standards Track [Page 132] + +RFC 2616 HTTP/1.1 June 1999 + + + If none of the entity tags match, then the server MAY perform the + requested method as if the If-None-Match header field did not exist, + but MUST also ignore any If-Modified-Since header field(s) in the + request. That is, if no entity tags match, then the server MUST NOT + return a 304 (Not Modified) response. + + If the request would, without the If-None-Match header field, result + in anything other than a 2xx or 304 status, then the If-None-Match + header MUST be ignored. (See section 13.3.4 for a discussion of + server behavior when both If-Modified-Since and If-None-Match appear + in the same request.) + + The meaning of "If-None-Match: *" is that the method MUST NOT be + performed if the representation selected by the origin server (or by + a cache, possibly using the Vary mechanism, see section 14.44) + exists, and SHOULD be performed if the representation does not exist. + This feature is intended to be useful in preventing races between PUT + operations. + + Examples: + + If-None-Match: "xyzzy" + If-None-Match: W/"xyzzy" + If-None-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-None-Match: W/"xyzzy", W/"r2d2xxxx", W/"c3piozzzz" + If-None-Match: * + + The result of a request having both an If-None-Match header field and + either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.27 If-Range + + If a client has a partial copy of an entity in its cache, and wishes + to have an up-to-date copy of the entire entity in its cache, it + could use the Range request-header with a conditional GET (using + either or both of If-Unmodified-Since and If-Match.) However, if the + condition fails because the entity has been modified, the client + would then have to make a second request to obtain the entire current + entity-body. + + The If-Range header allows a client to "short-circuit" the second + request. Informally, its meaning is `if the entity is unchanged, send + me the part(s) that I am missing; otherwise, send me the entire new + entity'. + + If-Range = "If-Range" ":" ( entity-tag | HTTP-date ) + + + + +Fielding, et al. Standards Track [Page 133] + +RFC 2616 HTTP/1.1 June 1999 + + + If the client has no entity tag for an entity, but does have a Last- + Modified date, it MAY use that date in an If-Range header. (The + server can distinguish between a valid HTTP-date and any form of + entity-tag by examining no more than two characters.) The If-Range + header SHOULD only be used together with a Range header, and MUST be + ignored if the request does not include a Range header, or if the + server does not support the sub-range operation. + + If the entity tag given in the If-Range header matches the current + entity tag for the entity, then the server SHOULD provide the + specified sub-range of the entity using a 206 (Partial content) + response. If the entity tag does not match, then the server SHOULD + return the entire entity using a 200 (OK) response. + +14.28 If-Unmodified-Since + + The If-Unmodified-Since request-header field is used with a method to + make it conditional. If the requested resource has not been modified + since the time specified in this field, the server SHOULD perform the + requested operation as if the If-Unmodified-Since header were not + present. + + If the requested variant has been modified since the specified time, + the server MUST NOT perform the requested operation, and MUST return + a 412 (Precondition Failed). + + If-Unmodified-Since = "If-Unmodified-Since" ":" HTTP-date + + An example of the field is: + + If-Unmodified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + If the request normally (i.e., without the If-Unmodified-Since + header) would result in anything other than a 2xx or 412 status, the + If-Unmodified-Since header SHOULD be ignored. + + If the specified date is invalid, the header is ignored. + + The result of a request having both an If-Unmodified-Since header + field and either an If-None-Match or an If-Modified-Since header + fields is undefined by this specification. + +14.29 Last-Modified + + The Last-Modified entity-header field indicates the date and time at + which the origin server believes the variant was last modified. + + Last-Modified = "Last-Modified" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 134] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of its use is + + Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT + + The exact meaning of this header field depends on the implementation + of the origin server and the nature of the original resource. For + files, it may be just the file system last-modified time. For + entities with dynamically included parts, it may be the most recent + of the set of last-modify times for its component parts. For database + gateways, it may be the last-update time stamp of the record. For + virtual objects, it may be the last time the internal state changed. + + An origin server MUST NOT send a Last-Modified date which is later + than the server's time of message origination. In such cases, where + the resource's last modification would indicate some time in the + future, the server MUST replace that date with the message + origination date. + + An origin server SHOULD obtain the Last-Modified value of the entity + as close as possible to the time that it generates the Date value of + its response. This allows a recipient to make an accurate assessment + of the entity's modification time, especially if the entity changes + near the time that the response is generated. + + HTTP/1.1 servers SHOULD send Last-Modified whenever feasible. + +14.30 Location + + The Location response-header field is used to redirect the recipient + to a location other than the Request-URI for completion of the + request or identification of a new resource. For 201 (Created) + responses, the Location is that of the new resource which was created + by the request. For 3xx responses, the location SHOULD indicate the + server's preferred URI for automatic redirection to the resource. The + field value consists of a single absolute URI. + + Location = "Location" ":" absoluteURI + + An example is: + + Location: http://www.w3.org/pub/WWW/People.html + + Note: The Content-Location header field (section 14.14) differs + from Location in that the Content-Location identifies the original + location of the entity enclosed in the request. It is therefore + possible for a response to contain header fields for both Location + and Content-Location. Also see section 13.10 for cache + requirements of some methods. + + + +Fielding, et al. Standards Track [Page 135] + +RFC 2616 HTTP/1.1 June 1999 + + +14.31 Max-Forwards + + The Max-Forwards request-header field provides a mechanism with the + TRACE (section 9.8) and OPTIONS (section 9.2) methods to limit the + number of proxies or gateways that can forward the request to the + next inbound server. This can be useful when the client is attempting + to trace a request chain which appears to be failing or looping in + mid-chain. + + Max-Forwards = "Max-Forwards" ":" 1*DIGIT + + The Max-Forwards value is a decimal integer indicating the remaining + number of times this request message may be forwarded. + + Each proxy or gateway recipient of a TRACE or OPTIONS request + containing a Max-Forwards header field MUST check and update its + value prior to forwarding the request. If the received value is zero + (0), the recipient MUST NOT forward the request; instead, it MUST + respond as the final recipient. If the received Max-Forwards value is + greater than zero, then the forwarded message MUST contain an updated + Max-Forwards field with a value decremented by one (1). + + The Max-Forwards header field MAY be ignored for all other methods + defined by this specification and for any extension methods for which + it is not explicitly referred to as part of that method definition. + +14.32 Pragma + + The Pragma general-header field is used to include implementation- + specific directives that might apply to any recipient along the + request/response chain. All pragma directives specify optional + behavior from the viewpoint of the protocol; however, some systems + MAY require that behavior be consistent with the directives. + + Pragma = "Pragma" ":" 1#pragma-directive + pragma-directive = "no-cache" | extension-pragma + extension-pragma = token [ "=" ( token | quoted-string ) ] + + When the no-cache directive is present in a request message, an + application SHOULD forward the request toward the origin server even + if it has a cached copy of what is being requested. This pragma + directive has the same semantics as the no-cache cache-directive (see + section 14.9) and is defined here for backward compatibility with + HTTP/1.0. Clients SHOULD include both header fields when a no-cache + request is sent to a server not known to be HTTP/1.1 compliant. + + + + + + +Fielding, et al. Standards Track [Page 136] + +RFC 2616 HTTP/1.1 June 1999 + + + Pragma directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a pragma for a + specific recipient; however, any pragma directive not relevant to a + recipient SHOULD be ignored by that recipient. + + HTTP/1.1 caches SHOULD treat "Pragma: no-cache" as if the client had + sent "Cache-Control: no-cache". No new Pragma directives will be + defined in HTTP. + + Note: because the meaning of "Pragma: no-cache as a response + header field is not actually specified, it does not provide a + reliable replacement for "Cache-Control: no-cache" in a response + +14.33 Proxy-Authenticate + + The Proxy-Authenticate response-header field MUST be included as part + of a 407 (Proxy Authentication Required) response. The field value + consists of a challenge that indicates the authentication scheme and + parameters applicable to the proxy for this Request-URI. + + Proxy-Authenticate = "Proxy-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. Unlike + WWW-Authenticate, the Proxy-Authenticate header field applies only to + the current connection and SHOULD NOT be passed on to downstream + clients. However, an intermediate proxy might need to obtain its own + credentials by requesting them from the downstream client, which in + some circumstances will appear as if the proxy is forwarding the + Proxy-Authenticate header field. + +14.34 Proxy-Authorization + + The Proxy-Authorization request-header field allows the client to + identify itself (or its user) to a proxy which requires + authentication. The Proxy-Authorization field value consists of + credentials containing the authentication information of the user + agent for the proxy and/or realm of the resource being requested. + + Proxy-Authorization = "Proxy-Authorization" ":" credentials + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43] . Unlike + Authorization, the Proxy-Authorization header field applies only to + the next outbound proxy that demanded authentication using the Proxy- + Authenticate field. When multiple proxies are used in a chain, the + + + +Fielding, et al. Standards Track [Page 137] + +RFC 2616 HTTP/1.1 June 1999 + + + Proxy-Authorization header field is consumed by the first outbound + proxy that was expecting to receive credentials. A proxy MAY relay + the credentials from the client request to the next proxy if that is + the mechanism by which the proxies cooperatively authenticate a given + request. + +14.35 Range + +14.35.1 Byte Ranges + + Since all HTTP entities are represented in HTTP messages as sequences + of bytes, the concept of a byte range is meaningful for any HTTP + entity. (However, not all clients and servers need to support byte- + range operations.) + + Byte range specifications in HTTP apply to the sequence of bytes in + the entity-body (not necessarily the same as the message-body). + + A byte range operation MAY specify a single range of bytes, or a set + of ranges within a single entity. + + ranges-specifier = byte-ranges-specifier + byte-ranges-specifier = bytes-unit "=" byte-range-set + byte-range-set = 1#( byte-range-spec | suffix-byte-range-spec ) + byte-range-spec = first-byte-pos "-" [last-byte-pos] + first-byte-pos = 1*DIGIT + last-byte-pos = 1*DIGIT + + The first-byte-pos value in a byte-range-spec gives the byte-offset + of the first byte in a range. The last-byte-pos value gives the + byte-offset of the last byte in the range; that is, the byte + positions specified are inclusive. Byte offsets start at zero. + + If the last-byte-pos value is present, it MUST be greater than or + equal to the first-byte-pos in that byte-range-spec, or the byte- + range-spec is syntactically invalid. The recipient of a byte-range- + set that includes one or more syntactically invalid byte-range-spec + values MUST ignore the header field that includes that byte-range- + set. + + If the last-byte-pos value is absent, or if the value is greater than + or equal to the current length of the entity-body, last-byte-pos is + taken to be equal to one less than the current length of the entity- + body in bytes. + + By its choice of last-byte-pos, a client can limit the number of + bytes retrieved without knowing the size of the entity. + + + + +Fielding, et al. Standards Track [Page 138] + +RFC 2616 HTTP/1.1 June 1999 + + + suffix-byte-range-spec = "-" suffix-length + suffix-length = 1*DIGIT + + A suffix-byte-range-spec is used to specify the suffix of the + entity-body, of a length given by the suffix-length value. (That is, + this form specifies the last N bytes of an entity-body.) If the + entity is shorter than the specified suffix-length, the entire + entity-body is used. + + If a syntactically valid byte-range-set includes at least one byte- + range-spec whose first-byte-pos is less than the current length of + the entity-body, or at least one suffix-byte-range-spec with a non- + zero suffix-length, then the byte-range-set is satisfiable. + Otherwise, the byte-range-set is unsatisfiable. If the byte-range-set + is unsatisfiable, the server SHOULD return a response with a status + of 416 (Requested range not satisfiable). Otherwise, the server + SHOULD return a response with a status of 206 (Partial Content) + containing the satisfiable ranges of the entity-body. + + Examples of byte-ranges-specifier values (assuming an entity-body of + length 10000): + + - The first 500 bytes (byte offsets 0-499, inclusive): bytes=0- + 499 + + - The second 500 bytes (byte offsets 500-999, inclusive): + bytes=500-999 + + - The final 500 bytes (byte offsets 9500-9999, inclusive): + bytes=-500 + + - Or bytes=9500- + + - The first and last bytes only (bytes 0 and 9999): bytes=0-0,-1 + + - Several legal but not canonical specifications of the second 500 + bytes (byte offsets 500-999, inclusive): + bytes=500-600,601-999 + bytes=500-700,601-999 + +14.35.2 Range Retrieval Requests + + HTTP retrieval requests using conditional or unconditional GET + methods MAY request one or more sub-ranges of the entity, instead of + the entire entity, using the Range request header, which applies to + the entity returned as the result of the request: + + Range = "Range" ":" ranges-specifier + + + +Fielding, et al. Standards Track [Page 139] + +RFC 2616 HTTP/1.1 June 1999 + + + A server MAY ignore the Range header. However, HTTP/1.1 origin + servers and intermediate caches ought to support byte ranges when + possible, since Range supports efficient recovery from partially + failed transfers, and supports efficient partial retrieval of large + entities. + + If the server supports the Range header and the specified range or + ranges are appropriate for the entity: + + - The presence of a Range header in an unconditional GET modifies + what is returned if the GET is otherwise successful. In other + words, the response carries a status code of 206 (Partial + Content) instead of 200 (OK). + + - The presence of a Range header in a conditional GET (a request + using one or both of If-Modified-Since and If-None-Match, or + one or both of If-Unmodified-Since and If-Match) modifies what + is returned if the GET is otherwise successful and the + condition is true. It does not affect the 304 (Not Modified) + response returned if the conditional is false. + + In some cases, it might be more appropriate to use the If-Range + header (see section 14.27) in addition to the Range header. + + If a proxy that supports ranges receives a Range request, forwards + the request to an inbound server, and receives an entire entity in + reply, it SHOULD only return the requested range to its client. It + SHOULD store the entire received response in its cache if that is + consistent with its cache allocation policies. + +14.36 Referer + + The Referer[sic] request-header field allows the client to specify, + for the server's benefit, the address (URI) of the resource from + which the Request-URI was obtained (the "referrer", although the + header field is misspelled.) The Referer request-header allows a + server to generate lists of back-links to resources for interest, + logging, optimized caching, etc. It also allows obsolete or mistyped + links to be traced for maintenance. The Referer field MUST NOT be + sent if the Request-URI was obtained from a source that does not have + its own URI, such as input from the user keyboard. + + Referer = "Referer" ":" ( absoluteURI | relativeURI ) + + Example: + + Referer: http://www.w3.org/hypertext/DataSources/Overview.html + + + + +Fielding, et al. Standards Track [Page 140] + +RFC 2616 HTTP/1.1 June 1999 + + + If the field value is a relative URI, it SHOULD be interpreted + relative to the Request-URI. The URI MUST NOT include a fragment. See + section 15.1.3 for security considerations. + +14.37 Retry-After + + The Retry-After response-header field can be used with a 503 (Service + Unavailable) response to indicate how long the service is expected to + be unavailable to the requesting client. This field MAY also be used + with any 3xx (Redirection) response to indicate the minimum time the + user-agent is asked wait before issuing the redirected request. The + value of this field can be either an HTTP-date or an integer number + of seconds (in decimal) after the time of the response. + + Retry-After = "Retry-After" ":" ( HTTP-date | delta-seconds ) + + Two examples of its use are + + Retry-After: Fri, 31 Dec 1999 23:59:59 GMT + Retry-After: 120 + + In the latter example, the delay is 2 minutes. + +14.38 Server + + The Server response-header field contains information about the + software used by the origin server to handle the request. The field + can contain multiple product tokens (section 3.8) and comments + identifying the server and any significant subproducts. The product + tokens are listed in order of their significance for identifying the + application. + + Server = "Server" ":" 1*( product | comment ) + + Example: + + Server: CERN/3.0 libwww/2.17 + + If the response is being forwarded through a proxy, the proxy + application MUST NOT modify the Server response-header. Instead, it + SHOULD include a Via field (as described in section 14.45). + + Note: Revealing the specific software version of the server might + allow the server machine to become more vulnerable to attacks + against software that is known to contain security holes. Server + implementors are encouraged to make this field a configurable + option. + + + + +Fielding, et al. Standards Track [Page 141] + +RFC 2616 HTTP/1.1 June 1999 + + +14.39 TE + + The TE request-header field indicates what extension transfer-codings + it is willing to accept in the response and whether or not it is + willing to accept trailer fields in a chunked transfer-coding. Its + value may consist of the keyword "trailers" and/or a comma-separated + list of extension transfer-coding names with optional accept + parameters (as described in section 3.6). + + TE = "TE" ":" #( t-codings ) + t-codings = "trailers" | ( transfer-extension [ accept-params ] ) + + The presence of the keyword "trailers" indicates that the client is + willing to accept trailer fields in a chunked transfer-coding, as + defined in section 3.6.1. This keyword is reserved for use with + transfer-coding values even though it does not itself represent a + transfer-coding. + + Examples of its use are: + + TE: deflate + TE: + TE: trailers, deflate;q=0.5 + + The TE header field only applies to the immediate connection. + Therefore, the keyword MUST be supplied within a Connection header + field (section 14.10) whenever TE is present in an HTTP/1.1 message. + + A server tests whether a transfer-coding is acceptable, according to + a TE field, using these rules: + + 1. The "chunked" transfer-coding is always acceptable. If the + keyword "trailers" is listed, the client indicates that it is + willing to accept trailer fields in the chunked response on + behalf of itself and any downstream clients. The implication is + that, if given, the client is stating that either all + downstream clients are willing to accept trailer fields in the + forwarded response, or that it will attempt to buffer the + response on behalf of downstream recipients. + + Note: HTTP/1.1 does not define any means to limit the size of a + chunked response such that a client can be assured of buffering + the entire response. + + 2. If the transfer-coding being tested is one of the transfer- + codings listed in the TE field, then it is acceptable unless it + is accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + + +Fielding, et al. Standards Track [Page 142] + +RFC 2616 HTTP/1.1 June 1999 + + + 3. If multiple transfer-codings are acceptable, then the + acceptable transfer-coding with the highest non-zero qvalue is + preferred. The "chunked" transfer-coding always has a qvalue + of 1. + + If the TE field-value is empty or if no TE field is present, the only + transfer-coding is "chunked". A message with no transfer-coding is + always acceptable. + +14.40 Trailer + + The Trailer general field value indicates that the given set of + header fields is present in the trailer of a message encoded with + chunked transfer-coding. + + Trailer = "Trailer" ":" 1#field-name + + An HTTP/1.1 message SHOULD include a Trailer header field in a + message using chunked transfer-coding with a non-empty trailer. Doing + so allows the recipient to know which header fields to expect in the + trailer. + + If no Trailer header field is present, the trailer SHOULD NOT include + any header fields. See section 3.6.1 for restrictions on the use of + trailer fields in a "chunked" transfer-coding. + + Message header fields listed in the Trailer header field MUST NOT + include the following header fields: + + . Transfer-Encoding + + . Content-Length + + . Trailer + +14.41 Transfer-Encoding + + The Transfer-Encoding general-header field indicates what (if any) + type of transformation has been applied to the message body in order + to safely transfer it between the sender and the recipient. This + differs from the content-coding in that the transfer-coding is a + property of the message, not of the entity. + + Transfer-Encoding = "Transfer-Encoding" ":" 1#transfer-coding + + Transfer-codings are defined in section 3.6. An example is: + + Transfer-Encoding: chunked + + + +Fielding, et al. Standards Track [Page 143] + +RFC 2616 HTTP/1.1 June 1999 + + + If multiple encodings have been applied to an entity, the transfer- + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + + Many older HTTP/1.0 applications do not understand the Transfer- + Encoding header. + +14.42 Upgrade + + The Upgrade general-header allows the client to specify what + additional communication protocols it supports and would like to use + if the server finds it appropriate to switch protocols. The server + MUST use the Upgrade header field within a 101 (Switching Protocols) + response to indicate which protocol(s) are being switched. + + Upgrade = "Upgrade" ":" 1#product + + For example, + + Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11 + + The Upgrade header field is intended to provide a simple mechanism + for transition from HTTP/1.1 to some other, incompatible protocol. It + does so by allowing the client to advertise its desire to use another + protocol, such as a later version of HTTP with a higher major version + number, even though the current request has been made using HTTP/1.1. + This eases the difficult transition between incompatible protocols by + allowing the client to initiate a request in the more commonly + supported protocol while indicating to the server that it would like + to use a "better" protocol if available (where "better" is determined + by the server, possibly according to the nature of the method and/or + resource being requested). + + The Upgrade header field only applies to switching application-layer + protocols upon the existing transport-layer connection. Upgrade + cannot be used to insist on a protocol change; its acceptance and use + by the server is optional. The capabilities and nature of the + application-layer communication after the protocol change is entirely + dependent upon the new protocol chosen, although the first action + after changing the protocol MUST be a response to the initial HTTP + request containing the Upgrade header field. + + The Upgrade header field only applies to the immediate connection. + Therefore, the upgrade keyword MUST be supplied within a Connection + header field (section 14.10) whenever Upgrade is present in an + HTTP/1.1 message. + + + + +Fielding, et al. Standards Track [Page 144] + +RFC 2616 HTTP/1.1 June 1999 + + + The Upgrade header field cannot be used to indicate a switch to a + protocol on a different connection. For that purpose, it is more + appropriate to use a 301, 302, 303, or 305 redirection response. + + This specification only defines the protocol name "HTTP" for use by + the family of Hypertext Transfer Protocols, as defined by the HTTP + version rules of section 3.1 and future updates to this + specification. Any token can be used as a protocol name; however, it + will only be useful if both the client and server associate the name + with the same protocol. + +14.43 User-Agent + + The User-Agent request-header field contains information about the + user agent originating the request. This is for statistical purposes, + the tracing of protocol violations, and automated recognition of user + agents for the sake of tailoring responses to avoid particular user + agent limitations. User agents SHOULD include this field with + requests. The field can contain multiple product tokens (section 3.8) + and comments identifying the agent and any subproducts which form a + significant part of the user agent. By convention, the product tokens + are listed in order of their significance for identifying the + application. + + User-Agent = "User-Agent" ":" 1*( product | comment ) + + Example: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + +14.44 Vary + + The Vary field value indicates the set of request-header fields that + fully determines, while the response is fresh, whether a cache is + permitted to use the response to reply to a subsequent request + without revalidation. For uncacheable or stale responses, the Vary + field value advises the user agent about the criteria that were used + to select the representation. A Vary field value of "*" implies that + a cache cannot determine from the request headers of a subsequent + request whether this response is the appropriate representation. See + section 13.6 for use of the Vary header field by caches. + + Vary = "Vary" ":" ( "*" | 1#field-name ) + + An HTTP/1.1 server SHOULD include a Vary header field with any + cacheable response that is subject to server-driven negotiation. + Doing so allows a cache to properly interpret future requests on that + resource and informs the user agent about the presence of negotiation + + + +Fielding, et al. Standards Track [Page 145] + +RFC 2616 HTTP/1.1 June 1999 + + + on that resource. A server MAY include a Vary header field with a + non-cacheable response that is subject to server-driven negotiation, + since this might provide the user agent with useful information about + the dimensions over which the response varies at the time of the + response. + + A Vary field value consisting of a list of field-names signals that + the representation selected for the response is based on a selection + algorithm which considers ONLY the listed request-header field values + in selecting the most appropriate representation. A cache MAY assume + that the same selection will be made for future requests with the + same values for the listed field names, for the duration of time for + which the response is fresh. + + The field-names given are not limited to the set of standard + request-header fields defined by this specification. Field names are + case-insensitive. + + A Vary field value of "*" signals that unspecified parameters not + limited to the request-headers (e.g., the network address of the + client), play a role in the selection of the response representation. + The "*" value MUST NOT be generated by a proxy server; it may only be + generated by an origin server. + +14.45 Via + + The Via general-header field MUST be used by gateways and proxies to + indicate the intermediate protocols and recipients between the user + agent and the server on requests, and between the origin server and + the client on responses. It is analogous to the "Received" field of + RFC 822 [9] and is intended to be used for tracking message forwards, + avoiding request loops, and identifying the protocol capabilities of + all senders along the request/response chain. + + Via = "Via" ":" 1#( received-protocol received-by [ comment ] ) + received-protocol = [ protocol-name "/" ] protocol-version + protocol-name = token + protocol-version = token + received-by = ( host [ ":" port ] ) | pseudonym + pseudonym = token + + The received-protocol indicates the protocol version of the message + received by the server or client along each segment of the + request/response chain. The received-protocol version is appended to + the Via field value when the message is forwarded so that information + about the protocol capabilities of upstream applications remains + visible to all recipients. + + + + +Fielding, et al. Standards Track [Page 146] + +RFC 2616 HTTP/1.1 June 1999 + + + The protocol-name is optional if and only if it would be "HTTP". The + received-by field is normally the host and optional port number of a + recipient server or client that subsequently forwarded the message. + However, if the real host is considered to be sensitive information, + it MAY be replaced by a pseudonym. If the port is not given, it MAY + be assumed to be the default port of the received-protocol. + + Multiple Via field values represents each proxy or gateway that has + forwarded the message. Each recipient MUST append its information + such that the end result is ordered according to the sequence of + forwarding applications. + + Comments MAY be used in the Via header field to identify the software + of the recipient proxy or gateway, analogous to the User-Agent and + Server header fields. However, all comments in the Via field are + optional and MAY be removed by any recipient prior to forwarding the + message. + + For example, a request message could be sent from an HTTP/1.0 user + agent to an internal proxy code-named "fred", which uses HTTP/1.1 to + forward the request to a public proxy at nowhere.com, which completes + the request by forwarding it to the origin server at www.ics.uci.edu. + The request received by www.ics.uci.edu would then have the following + Via header field: + + Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1) + + Proxies and gateways used as a portal through a network firewall + SHOULD NOT, by default, forward the names and ports of hosts within + the firewall region. This information SHOULD only be propagated if + explicitly enabled. If not enabled, the received-by host of any host + behind the firewall SHOULD be replaced by an appropriate pseudonym + for that host. + + For organizations that have strong privacy requirements for hiding + internal structures, a proxy MAY combine an ordered subsequence of + Via header field entries with identical received-protocol values into + a single such entry. For example, + + Via: 1.0 ricky, 1.1 ethel, 1.1 fred, 1.0 lucy + + could be collapsed to + + Via: 1.0 ricky, 1.1 mertz, 1.0 lucy + + + + + + + +Fielding, et al. Standards Track [Page 147] + +RFC 2616 HTTP/1.1 June 1999 + + + Applications SHOULD NOT combine multiple entries unless they are all + under the same organizational control and the hosts have already been + replaced by pseudonyms. Applications MUST NOT combine entries which + have different received-protocol values. + +14.46 Warning + + The Warning general-header field is used to carry additional + information about the status or transformation of a message which + might not be reflected in the message. This information is typically + used to warn about a possible lack of semantic transparency from + caching operations or transformations applied to the entity body of + the message. + + Warning headers are sent with responses using: + + Warning = "Warning" ":" 1#warning-value + + warning-value = warn-code SP warn-agent SP warn-text + [SP warn-date] + + warn-code = 3DIGIT + warn-agent = ( host [ ":" port ] ) | pseudonym + ; the name or pseudonym of the server adding + ; the Warning header, for use in debugging + warn-text = quoted-string + warn-date = <"> HTTP-date <"> + + A response MAY carry more than one Warning header. + + The warn-text SHOULD be in a natural language and character set that + is most likely to be intelligible to the human user receiving the + response. This decision MAY be based on any available knowledge, such + as the location of the cache or user, the Accept-Language field in a + request, the Content-Language field in a response, etc. The default + language is English and the default character set is ISO-8859-1. + + If a character set other than ISO-8859-1 is used, it MUST be encoded + in the warn-text using the method described in RFC 2047 [14]. + + Warning headers can in general be applied to any message, however + some specific warn-codes are specific to caches and can only be + applied to response messages. New Warning headers SHOULD be added + after any existing Warning headers. A cache MUST NOT delete any + Warning header that it received with a message. However, if a cache + successfully validates a cache entry, it SHOULD remove any Warning + headers previously attached to that entry except as specified for + + + + +Fielding, et al. Standards Track [Page 148] + +RFC 2616 HTTP/1.1 June 1999 + + + specific Warning codes. It MUST then add any Warning headers received + in the validating response. In other words, Warning headers are those + that would be attached to the most recent relevant response. + + When multiple Warning headers are attached to a response, the user + agent ought to inform the user of as many of them as possible, in the + order that they appear in the response. If it is not possible to + inform the user of all of the warnings, the user agent SHOULD follow + these heuristics: + + - Warnings that appear early in the response take priority over + those appearing later in the response. + + - Warnings in the user's preferred character set take priority + over warnings in other character sets but with identical warn- + codes and warn-agents. + + Systems that generate multiple Warning headers SHOULD order them with + this user agent behavior in mind. + + Requirements for the behavior of caches with respect to Warnings are + stated in section 13.1.2. + + This is a list of the currently-defined warn-codes, each with a + recommended warn-text in English, and a description of its meaning. + + 110 Response is stale + MUST be included whenever the returned response is stale. + + 111 Revalidation failed + MUST be included if a cache returns a stale response because an + attempt to revalidate the response failed, due to an inability to + reach the server. + + 112 Disconnected operation + SHOULD be included if the cache is intentionally disconnected from + the rest of the network for a period of time. + + 113 Heuristic expiration + MUST be included if the cache heuristically chose a freshness + lifetime greater than 24 hours and the response's age is greater + than 24 hours. + + 199 Miscellaneous warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action, besides presenting the warning to + the user. + + + +Fielding, et al. Standards Track [Page 149] + +RFC 2616 HTTP/1.1 June 1999 + + + 214 Transformation applied + MUST be added by an intermediate cache or proxy if it applies any + transformation changing the content-coding (as specified in the + Content-Encoding header) or media-type (as specified in the + Content-Type header) of the response, or the entity-body of the + response, unless this Warning code already appears in the response. + + 299 Miscellaneous persistent warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action. + + If an implementation sends a message with one or more Warning headers + whose version is HTTP/1.0 or lower, then the sender MUST include in + each warning-value a warn-date that matches the date in the response. + + If an implementation receives a message with a warning-value that + includes a warn-date, and that warn-date is different from the Date + value in the response, then that warning-value MUST be deleted from + the message before storing, forwarding, or using it. (This prevents + bad consequences of naive caching of Warning header fields.) If all + of the warning-values are deleted for this reason, the Warning header + MUST be deleted as well. + +14.47 WWW-Authenticate + + The WWW-Authenticate response-header field MUST be included in 401 + (Unauthorized) response messages. The field value consists of at + least one challenge that indicates the authentication scheme(s) and + parameters applicable to the Request-URI. + + WWW-Authenticate = "WWW-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. User + agents are advised to take special care in parsing the WWW- + Authenticate field value as it might contain more than one challenge, + or if more than one WWW-Authenticate header field is provided, the + contents of a challenge itself can contain a comma-separated list of + authentication parameters. + +15 Security Considerations + + This section is meant to inform application developers, information + providers, and users of the security limitations in HTTP/1.1 as + described by this document. The discussion does not include + definitive solutions to the problems revealed, though it does make + some suggestions for reducing security risks. + + + +Fielding, et al. Standards Track [Page 150] + +RFC 2616 HTTP/1.1 June 1999 + + +15.1 Personal Information + + HTTP clients are often privy to large amounts of personal information + (e.g. the user's name, location, mail address, passwords, encryption + keys, etc.), and SHOULD be very careful to prevent unintentional + leakage of this information via the HTTP protocol to other sources. + We very strongly recommend that a convenient interface be provided + for the user to control dissemination of such information, and that + designers and implementors be particularly careful in this area. + History shows that errors in this area often create serious security + and/or privacy problems and generate highly adverse publicity for the + implementor's company. + +15.1.1 Abuse of Server Log Information + + A server is in the position to save personal data about a user's + requests which might identify their reading patterns or subjects of + interest. This information is clearly confidential in nature and its + handling can be constrained by law in certain countries. People using + the HTTP protocol to provide data are responsible for ensuring that + such material is not distributed without the permission of any + individuals that are identifiable by the published results. + +15.1.2 Transfer of Sensitive Information + + Like any generic data transfer protocol, HTTP cannot regulate the + content of the data that is transferred, nor is there any a priori + method of determining the sensitivity of any particular piece of + information within the context of any given request. Therefore, + applications SHOULD supply as much control over this information as + possible to the provider of that information. Four header fields are + worth special mention in this context: Server, Via, Referer and From. + + Revealing the specific software version of the server might allow the + server machine to become more vulnerable to attacks against software + that is known to contain security holes. Implementors SHOULD make the + Server header field a configurable option. + + Proxies which serve as a portal through a network firewall SHOULD + take special precautions regarding the transfer of header information + that identifies the hosts behind the firewall. In particular, they + SHOULD remove, or replace with sanitized versions, any Via fields + generated behind the firewall. + + The Referer header allows reading patterns to be studied and reverse + links drawn. Although it can be very useful, its power can be abused + if user details are not separated from the information contained in + + + + +Fielding, et al. Standards Track [Page 151] + +RFC 2616 HTTP/1.1 June 1999 + + + the Referer. Even when the personal information has been removed, the + Referer header might indicate a private document's URI whose + publication would be inappropriate. + + The information sent in the From field might conflict with the user's + privacy interests or their site's security policy, and hence it + SHOULD NOT be transmitted without the user being able to disable, + enable, and modify the contents of the field. The user MUST be able + to set the contents of this field within a user preference or + application defaults configuration. + + We suggest, though do not require, that a convenient toggle interface + be provided for the user to enable or disable the sending of From and + Referer information. + + The User-Agent (section 14.43) or Server (section 14.38) header + fields can sometimes be used to determine that a specific client or + server have a particular security hole which might be exploited. + Unfortunately, this same information is often used for other valuable + purposes for which HTTP currently has no better mechanism. + +15.1.3 Encoding Sensitive Information in URI's + + Because the source of a link might be private information or might + reveal an otherwise private information source, it is strongly + recommended that the user be able to select whether or not the + Referer field is sent. For example, a browser client could have a + toggle switch for browsing openly/anonymously, which would + respectively enable/disable the sending of Referer and From + information. + + Clients SHOULD NOT include a Referer header field in a (non-secure) + HTTP request if the referring page was transferred with a secure + protocol. + + Authors of services which use the HTTP protocol SHOULD NOT use GET + based forms for the submission of sensitive data, because this will + cause this data to be encoded in the Request-URI. Many existing + servers, proxies, and user agents will log the request URI in some + place where it might be visible to third parties. Servers can use + POST-based form submission instead + +15.1.4 Privacy Issues Connected to Accept Headers + + Accept request-headers can reveal information about the user to all + servers which are accessed. The Accept-Language header in particular + can reveal information the user would consider to be of a private + nature, because the understanding of particular languages is often + + + +Fielding, et al. Standards Track [Page 152] + +RFC 2616 HTTP/1.1 June 1999 + + + strongly correlated to the membership of a particular ethnic group. + User agents which offer the option to configure the contents of an + Accept-Language header to be sent in every request are strongly + encouraged to let the configuration process include a message which + makes the user aware of the loss of privacy involved. + + An approach that limits the loss of privacy would be for a user agent + to omit the sending of Accept-Language headers by default, and to ask + the user whether or not to start sending Accept-Language headers to a + server if it detects, by looking for any Vary response-header fields + generated by the server, that such sending could improve the quality + of service. + + Elaborate user-customized accept header fields sent in every request, + in particular if these include quality values, can be used by servers + as relatively reliable and long-lived user identifiers. Such user + identifiers would allow content providers to do click-trail tracking, + and would allow collaborating content providers to match cross-server + click-trails or form submissions of individual users. Note that for + many users not behind a proxy, the network address of the host + running the user agent will also serve as a long-lived user + identifier. In environments where proxies are used to enhance + privacy, user agents ought to be conservative in offering accept + header configuration options to end users. As an extreme privacy + measure, proxies could filter the accept headers in relayed requests. + General purpose user agents which provide a high degree of header + configurability SHOULD warn users about the loss of privacy which can + be involved. + +15.2 Attacks Based On File and Path Names + + Implementations of HTTP origin servers SHOULD be careful to restrict + the documents returned by HTTP requests to be only those that were + intended by the server administrators. If an HTTP server translates + HTTP URIs directly into file system calls, the server MUST take + special care not to serve files that were not intended to be + delivered to HTTP clients. For example, UNIX, Microsoft Windows, and + other operating systems use ".." as a path component to indicate a + directory level above the current one. On such a system, an HTTP + server MUST disallow any such construct in the Request-URI if it + would otherwise allow access to a resource outside those intended to + be accessible via the HTTP server. Similarly, files intended for + reference only internally to the server (such as access control + files, configuration files, and script code) MUST be protected from + inappropriate retrieval, since they might contain sensitive + information. Experience has shown that minor bugs in such HTTP server + implementations have turned into security risks. + + + + +Fielding, et al. Standards Track [Page 153] + +RFC 2616 HTTP/1.1 June 1999 + + +15.3 DNS Spoofing + + Clients using HTTP rely heavily on the Domain Name Service, and are + thus generally prone to security attacks based on the deliberate + mis-association of IP addresses and DNS names. Clients need to be + cautious in assuming the continuing validity of an IP number/DNS name + association. + + In particular, HTTP clients SHOULD rely on their name resolver for + confirmation of an IP number/DNS name association, rather than + caching the result of previous host name lookups. Many platforms + already can cache host name lookups locally when appropriate, and + they SHOULD be configured to do so. It is proper for these lookups to + be cached, however, only when the TTL (Time To Live) information + reported by the name server makes it likely that the cached + information will remain useful. + + If HTTP clients cache the results of host name lookups in order to + achieve a performance improvement, they MUST observe the TTL + information reported by DNS. + + If HTTP clients do not observe this rule, they could be spoofed when + a previously-accessed server's IP address changes. As network + renumbering is expected to become increasingly common [24], the + possibility of this form of attack will grow. Observing this + requirement thus reduces this potential security vulnerability. + + This requirement also improves the load-balancing behavior of clients + for replicated servers using the same DNS name and reduces the + likelihood of a user's experiencing failure in accessing sites which + use that strategy. + +15.4 Location Headers and Spoofing + + If a single server supports multiple organizations that do not trust + one another, then it MUST check the values of Location and Content- + Location headers in responses that are generated under control of + said organizations to make sure that they do not attempt to + invalidate resources over which they have no authority. + +15.5 Content-Disposition Issues + + RFC 1806 [35], from which the often implemented Content-Disposition + (see section 19.5.1) header in HTTP is derived, has a number of very + serious security considerations. Content-Disposition is not part of + the HTTP standard, but since it is widely implemented, we are + documenting its use and risks for implementors. See RFC 2183 [49] + (which updates RFC 1806) for details. + + + +Fielding, et al. Standards Track [Page 154] + +RFC 2616 HTTP/1.1 June 1999 + + +15.6 Authentication Credentials and Idle Clients + + Existing HTTP clients and user agents typically retain authentication + information indefinitely. HTTP/1.1. does not provide a method for a + server to direct clients to discard these cached credentials. This is + a significant defect that requires further extensions to HTTP. + Circumstances under which credential caching can interfere with the + application's security model include but are not limited to: + + - Clients which have been idle for an extended period following + which the server might wish to cause the client to reprompt the + user for credentials. + + - Applications which include a session termination indication + (such as a `logout' or `commit' button on a page) after which + the server side of the application `knows' that there is no + further reason for the client to retain the credentials. + + This is currently under separate study. There are a number of work- + arounds to parts of this problem, and we encourage the use of + password protection in screen savers, idle time-outs, and other + methods which mitigate the security problems inherent in this + problem. In particular, user agents which cache credentials are + encouraged to provide a readily accessible mechanism for discarding + cached credentials under user control. + +15.7 Proxies and Caching + + By their very nature, HTTP proxies are men-in-the-middle, and + represent an opportunity for man-in-the-middle attacks. Compromise of + the systems on which the proxies run can result in serious security + and privacy problems. Proxies have access to security-related + information, personal information about individual users and + organizations, and proprietary information belonging to users and + content providers. A compromised proxy, or a proxy implemented or + configured without regard to security and privacy considerations, + might be used in the commission of a wide range of potential attacks. + + Proxy operators should protect the systems on which proxies run as + they would protect any system that contains or transports sensitive + information. In particular, log information gathered at proxies often + contains highly sensitive personal information, and/or information + about organizations. Log information should be carefully guarded, and + appropriate guidelines for use developed and followed. (Section + 15.1.1). + + + + + + +Fielding, et al. Standards Track [Page 155] + +RFC 2616 HTTP/1.1 June 1999 + + + Caching proxies provide additional potential vulnerabilities, since + the contents of the cache represent an attractive target for + malicious exploitation. Because cache contents persist after an HTTP + request is complete, an attack on the cache can reveal information + long after a user believes that the information has been removed from + the network. Therefore, cache contents should be protected as + sensitive information. + + Proxy implementors should consider the privacy and security + implications of their design and coding decisions, and of the + configuration options they provide to proxy operators (especially the + default configuration). + + Users of a proxy need to be aware that they are no trustworthier than + the people who run the proxy; HTTP itself cannot solve this problem. + + The judicious use of cryptography, when appropriate, may suffice to + protect against a broad range of security and privacy attacks. Such + cryptography is beyond the scope of the HTTP/1.1 specification. + +15.7.1 Denial of Service Attacks on Proxies + + They exist. They are hard to defend against. Research continues. + Beware. + +16 Acknowledgments + + This specification makes heavy use of the augmented BNF and generic + constructs defined by David H. Crocker for RFC 822 [9]. Similarly, it + reuses many of the definitions provided by Nathaniel Borenstein and + Ned Freed for MIME [7]. We hope that their inclusion in this + specification will help reduce past confusion over the relationship + between HTTP and Internet mail message formats. + + The HTTP protocol has evolved considerably over the years. It has + benefited from a large and active developer community--the many + people who have participated on the www-talk mailing list--and it is + that community which has been most responsible for the success of + HTTP and of the World-Wide Web in general. Marc Andreessen, Robert + Cailliau, Daniel W. Connolly, Bob Denny, John Franks, Jean-Francois + Groff, Phillip M. Hallam-Baker, Hakon W. Lie, Ari Luotonen, Rob + McCool, Lou Montulli, Dave Raggett, Tony Sanders, and Marc + VanHeyningen deserve special recognition for their efforts in + defining early aspects of the protocol. + + This document has benefited greatly from the comments of all those + participating in the HTTP-WG. In addition to those already mentioned, + the following individuals have contributed to this specification: + + + +Fielding, et al. Standards Track [Page 156] + +RFC 2616 HTTP/1.1 June 1999 + + + Gary Adams Ross Patterson + Harald Tveit Alvestrand Albert Lunde + Keith Ball John C. Mallery + Brian Behlendorf Jean-Philippe Martin-Flatin + Paul Burchard Mitra + Maurizio Codogno David Morris + Mike Cowlishaw Gavin Nicol + Roman Czyborra Bill Perry + Michael A. Dolan Jeffrey Perry + David J. Fiander Scott Powers + Alan Freier Owen Rees + Marc Hedlund Luigi Rizzo + Greg Herlihy David Robinson + Koen Holtman Marc Salomon + Alex Hopmann Rich Salz + Bob Jernigan Allan M. Schiffman + Shel Kaphan Jim Seidman + Rohit Khare Chuck Shotton + John Klensin Eric W. Sink + Martijn Koster Simon E. Spero + Alexei Kosut Richard N. Taylor + David M. Kristol Robert S. Thau + Daniel LaLiberte Bill (BearHeart) Weinman + Ben Laurie Francois Yergeau + Paul J. Leach Mary Ellen Zurko + Daniel DuBois Josh Cohen + + + Much of the content and presentation of the caching design is due to + suggestions and comments from individuals including: Shel Kaphan, + Paul Leach, Koen Holtman, David Morris, and Larry Masinter. + + Most of the specification of ranges is based on work originally done + by Ari Luotonen and John Franks, with additional input from Steve + Zilles. + + Thanks to the "cave men" of Palo Alto. You know who you are. + + Jim Gettys (the current editor of this document) wishes particularly + to thank Roy Fielding, the previous editor of this document, along + with John Klensin, Jeff Mogul, Paul Leach, Dave Kristol, Koen + Holtman, John Franks, Josh Cohen, Alex Hopmann, Scott Lawrence, and + Larry Masinter for their help. And thanks go particularly to Jeff + Mogul and Scott Lawrence for performing the "MUST/MAY/SHOULD" audit. + + + + + + + +Fielding, et al. Standards Track [Page 157] + +RFC 2616 HTTP/1.1 June 1999 + + + The Apache Group, Anselm Baird-Smith, author of Jigsaw, and Henrik + Frystyk implemented RFC 2068 early, and we wish to thank them for the + discovery of many of the problems that this document attempts to + rectify. + +17 References + + [1] Alvestrand, H., "Tags for the Identification of Languages", RFC + 1766, March 1995. + + [2] Anklesaria, F., McCahill, M., Lindner, P., Johnson, D., Torrey, + D. and B. Alberti, "The Internet Gopher Protocol (a distributed + document search and retrieval protocol)", RFC 1436, March 1993. + + [3] Berners-Lee, T., "Universal Resource Identifiers in WWW", RFC + 1630, June 1994. + + [4] Berners-Lee, T., Masinter, L. and M. McCahill, "Uniform Resource + Locators (URL)", RFC 1738, December 1994. + + [5] Berners-Lee, T. and D. Connolly, "Hypertext Markup Language - + 2.0", RFC 1866, November 1995. + + [6] Berners-Lee, T., Fielding, R. and H. Frystyk, "Hypertext Transfer + Protocol -- HTTP/1.0", RFC 1945, May 1996. + + [7] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part One: Format of Internet Message Bodies", + RFC 2045, November 1996. + + [8] Braden, R., "Requirements for Internet Hosts -- Communication + Layers", STD 3, RFC 1123, October 1989. + + [9] Crocker, D., "Standard for The Format of ARPA Internet Text + Messages", STD 11, RFC 822, August 1982. + + [10] Davis, F., Kahle, B., Morris, H., Salem, J., Shen, T., Wang, R., + Sui, J., and M. Grinbaum, "WAIS Interface Protocol Prototype + Functional Specification," (v1.5), Thinking Machines + Corporation, April 1990. + + [11] Fielding, R., "Relative Uniform Resource Locators", RFC 1808, + June 1995. + + [12] Horton, M. and R. Adams, "Standard for Interchange of USENET + Messages", RFC 1036, December 1987. + + + + + +Fielding, et al. Standards Track [Page 158] + +RFC 2616 HTTP/1.1 June 1999 + + + [13] Kantor, B. and P. Lapsley, "Network News Transfer Protocol", RFC + 977, February 1986. + + [14] Moore, K., "MIME (Multipurpose Internet Mail Extensions) Part + Three: Message Header Extensions for Non-ASCII Text", RFC 2047, + November 1996. + + [15] Nebel, E. and L. Masinter, "Form-based File Upload in HTML", RFC + 1867, November 1995. + + [16] Postel, J., "Simple Mail Transfer Protocol", STD 10, RFC 821, + August 1982. + + [17] Postel, J., "Media Type Registration Procedure", RFC 1590, + November 1996. + + [18] Postel, J. and J. Reynolds, "File Transfer Protocol", STD 9, RFC + 959, October 1985. + + [19] Reynolds, J. and J. Postel, "Assigned Numbers", STD 2, RFC 1700, + October 1994. + + [20] Sollins, K. and L. Masinter, "Functional Requirements for + Uniform Resource Names", RFC 1737, December 1994. + + [21] US-ASCII. Coded Character Set - 7-Bit American Standard Code for + Information Interchange. Standard ANSI X3.4-1986, ANSI, 1986. + + [22] ISO-8859. International Standard -- Information Processing -- + 8-bit Single-Byte Coded Graphic Character Sets -- + Part 1: Latin alphabet No. 1, ISO-8859-1:1987. + Part 2: Latin alphabet No. 2, ISO-8859-2, 1987. + Part 3: Latin alphabet No. 3, ISO-8859-3, 1988. + Part 4: Latin alphabet No. 4, ISO-8859-4, 1988. + Part 5: Latin/Cyrillic alphabet, ISO-8859-5, 1988. + Part 6: Latin/Arabic alphabet, ISO-8859-6, 1987. + Part 7: Latin/Greek alphabet, ISO-8859-7, 1987. + Part 8: Latin/Hebrew alphabet, ISO-8859-8, 1988. + Part 9: Latin alphabet No. 5, ISO-8859-9, 1990. + + [23] Meyers, J. and M. Rose, "The Content-MD5 Header Field", RFC + 1864, October 1995. + + [24] Carpenter, B. and Y. Rekhter, "Renumbering Needs Work", RFC + 1900, February 1996. + + [25] Deutsch, P., "GZIP file format specification version 4.3", RFC + 1952, May 1996. + + + +Fielding, et al. Standards Track [Page 159] + +RFC 2616 HTTP/1.1 June 1999 + + + [26] Venkata N. Padmanabhan, and Jeffrey C. Mogul. "Improving HTTP + Latency", Computer Networks and ISDN Systems, v. 28, pp. 25-35, + Dec. 1995. Slightly revised version of paper in Proc. 2nd + International WWW Conference '94: Mosaic and the Web, Oct. 1994, + which is available at + http://www.ncsa.uiuc.edu/SDG/IT94/Proceedings/DDay/mogul/HTTPLat + ency.html. + + [27] Joe Touch, John Heidemann, and Katia Obraczka. "Analysis of HTTP + Performance", , + ISI Research Report ISI/RR-98-463, (original report dated Aug. + 1996), USC/Information Sciences Institute, August 1998. + + [28] Mills, D., "Network Time Protocol (Version 3) Specification, + Implementation and Analysis", RFC 1305, March 1992. + + [29] Deutsch, P., "DEFLATE Compressed Data Format Specification + version 1.3", RFC 1951, May 1996. + + [30] S. Spero, "Analysis of HTTP Performance Problems," + http://sunsite.unc.edu/mdma-release/http-prob.html. + + [31] Deutsch, P. and J. Gailly, "ZLIB Compressed Data Format + Specification version 3.3", RFC 1950, May 1996. + + [32] Franks, J., Hallam-Baker, P., Hostetler, J., Leach, P., + Luotonen, A., Sink, E. and L. Stewart, "An Extension to HTTP: + Digest Access Authentication", RFC 2069, January 1997. + + [33] Fielding, R., Gettys, J., Mogul, J., Frystyk, H. and T. + Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1", RFC + 2068, January 1997. + + [34] Bradner, S., "Key words for use in RFCs to Indicate Requirement + Levels", BCP 14, RFC 2119, March 1997. + + [35] Troost, R. and Dorner, S., "Communicating Presentation + Information in Internet Messages: The Content-Disposition + Header", RFC 1806, June 1995. + + [36] Mogul, J., Fielding, R., Gettys, J. and H. Frystyk, "Use and + Interpretation of HTTP Version Numbers", RFC 2145, May 1997. + [jg639] + + [37] Palme, J., "Common Internet Message Headers", RFC 2076, February + 1997. [jg640] + + + + + +Fielding, et al. Standards Track [Page 160] + +RFC 2616 HTTP/1.1 June 1999 + + + [38] Yergeau, F., "UTF-8, a transformation format of Unicode and + ISO-10646", RFC 2279, January 1998. [jg641] + + [39] Nielsen, H.F., Gettys, J., Baird-Smith, A., Prud'hommeaux, E., + Lie, H., and C. Lilley. "Network Performance Effects of + HTTP/1.1, CSS1, and PNG," Proceedings of ACM SIGCOMM '97, Cannes + France, September 1997.[jg642] + + [40] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Two: Media Types", RFC 2046, November + 1996. [jg643] + + [41] Alvestrand, H., "IETF Policy on Character Sets and Languages", + BCP 18, RFC 2277, January 1998. [jg644] + + [42] Berners-Lee, T., Fielding, R. and L. Masinter, "Uniform Resource + Identifiers (URI): Generic Syntax and Semantics", RFC 2396, + August 1998. [jg645] + + [43] Franks, J., Hallam-Baker, P., Hostetler, J., Lawrence, S., + Leach, P., Luotonen, A., Sink, E. and L. Stewart, "HTTP + Authentication: Basic and Digest Access Authentication", RFC + 2617, June 1999. [jg646] + + [44] Luotonen, A., "Tunneling TCP based protocols through Web proxy + servers," Work in Progress. [jg647] + + [45] Palme, J. and A. Hopmann, "MIME E-mail Encapsulation of + Aggregate Documents, such as HTML (MHTML)", RFC 2110, March + 1997. + + [46] Bradner, S., "The Internet Standards Process -- Revision 3", BCP + 9, RFC 2026, October 1996. + + [47] Masinter, L., "Hyper Text Coffee Pot Control Protocol + (HTCPCP/1.0)", RFC 2324, 1 April 1998. + + [48] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Five: Conformance Criteria and Examples", + RFC 2049, November 1996. + + [49] Troost, R., Dorner, S. and K. Moore, "Communicating Presentation + Information in Internet Messages: The Content-Disposition Header + Field", RFC 2183, August 1997. + + + + + + + +Fielding, et al. Standards Track [Page 161] + +RFC 2616 HTTP/1.1 June 1999 + + +18 Authors' Addresses + + Roy T. Fielding + Information and Computer Science + University of California, Irvine + Irvine, CA 92697-3425, USA + + Fax: +1 (949) 824-1715 + EMail: fielding@ics.uci.edu + + + James Gettys + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: jg@w3.org + + + Jeffrey C. Mogul + Western Research Laboratory + Compaq Computer Corporation + 250 University Avenue + Palo Alto, California, 94305, USA + + EMail: mogul@wrl.dec.com + + + Henrik Frystyk Nielsen + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: frystyk@w3.org + + + Larry Masinter + Xerox Corporation + 3333 Coyote Hill Road + Palo Alto, CA 94034, USA + + EMail: masinter@parc.xerox.com + + + + + +Fielding, et al. Standards Track [Page 162] + +RFC 2616 HTTP/1.1 June 1999 + + + Paul J. Leach + Microsoft Corporation + 1 Microsoft Way + Redmond, WA 98052, USA + + EMail: paulle@microsoft.com + + + Tim Berners-Lee + Director, World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: timbl@w3.org + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 163] + +RFC 2616 HTTP/1.1 June 1999 + + +19 Appendices + +19.1 Internet Media Type message/http and application/http + + In addition to defining the HTTP/1.1 protocol, this document serves + as the specification for the Internet media type "message/http" and + "application/http". The message/http type can be used to enclose a + single HTTP request or response message, provided that it obeys the + MIME restrictions for all "message" types regarding line length and + encodings. The application/http type can be used to enclose a + pipeline of one or more HTTP request or response messages (not + intermixed). The following is to be registered with IANA [17]. + + Media Type name: message + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed message + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + Media Type name: application + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed messages + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: HTTP messages enclosed by this type + are in "binary" format; use of an appropriate + Content-Transfer-Encoding is required when + transmitted via E-mail. + Security considerations: none + + + + + + + + + +Fielding, et al. Standards Track [Page 164] + +RFC 2616 HTTP/1.1 June 1999 + + +19.2 Internet Media Type multipart/byteranges + + When an HTTP 206 (Partial Content) response message includes the + content of multiple ranges (a response to a request for multiple + non-overlapping ranges), these are transmitted as a multipart + message-body. The media type for this purpose is called + "multipart/byteranges". + + The multipart/byteranges media type includes two or more parts, each + with its own Content-Type and Content-Range fields. The required + boundary parameter specifies the boundary string used to separate + each body-part. + + Media Type name: multipart + Media subtype name: byteranges + Required parameters: boundary + Optional parameters: none + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + + For example: + + HTTP/1.1 206 Partial Content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-type: multipart/byteranges; boundary=THIS_STRING_SEPARATES + + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 500-999/8000 + + ...the first range... + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 7000-7999/8000 + + ...the second range + --THIS_STRING_SEPARATES-- + + Notes: + + 1) Additional CRLFs may precede the first boundary string in the + entity. + + + + + + +Fielding, et al. Standards Track [Page 165] + +RFC 2616 HTTP/1.1 June 1999 + + + 2) Although RFC 2046 [40] permits the boundary string to be + quoted, some existing implementations handle a quoted boundary + string incorrectly. + + 3) A number of browsers and servers were coded to an early draft + of the byteranges specification to use a media type of + multipart/x-byteranges, which is almost, but not quite + compatible with the version documented in HTTP/1.1. + +19.3 Tolerant Applications + + Although this document specifies the requirements for the generation + of HTTP/1.1 messages, not all applications will be correct in their + implementation. We therefore recommend that operational applications + be tolerant of deviations whenever those deviations can be + interpreted unambiguously. + + Clients SHOULD be tolerant in parsing the Status-Line and servers + tolerant when parsing the Request-Line. In particular, they SHOULD + accept any amount of SP or HT characters between fields, even though + only a single SP is required. + + The line terminator for message-header fields is the sequence CRLF. + However, we recommend that applications, when parsing such headers, + recognize a single LF as a line terminator and ignore the leading CR. + + The character set of an entity-body SHOULD be labeled as the lowest + common denominator of the character codes used within that body, with + the exception that not labeling the entity is preferred over labeling + the entity with the labels US-ASCII or ISO-8859-1. See section 3.7.1 + and 3.4.1. + + Additional rules for requirements on parsing and encoding of dates + and other potential problems with date encodings include: + + - HTTP/1.1 clients and caches SHOULD assume that an RFC-850 date + which appears to be more than 50 years in the future is in fact + in the past (this helps solve the "year 2000" problem). + + - An HTTP/1.1 implementation MAY internally represent a parsed + Expires date as earlier than the proper value, but MUST NOT + internally represent a parsed Expires date as later than the + proper value. + + - All expiration-related calculations MUST be done in GMT. The + local time zone MUST NOT influence the calculation or comparison + of an age or expiration time. + + + + +Fielding, et al. Standards Track [Page 166] + +RFC 2616 HTTP/1.1 June 1999 + + + - If an HTTP header incorrectly carries a date value with a time + zone other than GMT, it MUST be converted into GMT using the + most conservative possible conversion. + +19.4 Differences Between HTTP Entities and RFC 2045 Entities + + HTTP/1.1 uses many of the constructs defined for Internet Mail (RFC + 822 [9]) and the Multipurpose Internet Mail Extensions (MIME [7]) to + allow entities to be transmitted in an open variety of + representations and with extensible mechanisms. However, RFC 2045 + discusses mail, and HTTP has a few features that are different from + those described in RFC 2045. These differences were carefully chosen + to optimize performance over binary connections, to allow greater + freedom in the use of new media types, to make date comparisons + easier, and to acknowledge the practice of some early HTTP servers + and clients. + + This appendix describes specific areas where HTTP differs from RFC + 2045. Proxies and gateways to strict MIME environments SHOULD be + aware of these differences and provide the appropriate conversions + where necessary. Proxies and gateways from MIME environments to HTTP + also need to be aware of the differences because some conversions + might be required. + +19.4.1 MIME-Version + + HTTP is not a MIME-compliant protocol. However, HTTP/1.1 messages MAY + include a single MIME-Version general-header field to indicate what + version of the MIME protocol was used to construct the message. Use + of the MIME-Version header field indicates that the message is in + full compliance with the MIME protocol (as defined in RFC 2045[7]). + Proxies/gateways are responsible for ensuring full compliance (where + possible) when exporting HTTP messages to strict MIME environments. + + MIME-Version = "MIME-Version" ":" 1*DIGIT "." 1*DIGIT + + MIME version "1.0" is the default for use in HTTP/1.1. However, + HTTP/1.1 message parsing and semantics are defined by this document + and not the MIME specification. + +19.4.2 Conversion to Canonical Form + + RFC 2045 [7] requires that an Internet mail entity be converted to + canonical form prior to being transferred, as described in section 4 + of RFC 2049 [48]. Section 3.7.1 of this document describes the forms + allowed for subtypes of the "text" media type when transmitted over + HTTP. RFC 2046 requires that content with a type of "text" represent + line breaks as CRLF and forbids the use of CR or LF outside of line + + + +Fielding, et al. Standards Track [Page 167] + +RFC 2616 HTTP/1.1 June 1999 + + + break sequences. HTTP allows CRLF, bare CR, and bare LF to indicate a + line break within text content when a message is transmitted over + HTTP. + + Where it is possible, a proxy or gateway from HTTP to a strict MIME + environment SHOULD translate all line breaks within the text media + types described in section 3.7.1 of this document to the RFC 2049 + canonical form of CRLF. Note, however, that this might be complicated + by the presence of a Content-Encoding and by the fact that HTTP + allows the use of some character sets which do not use octets 13 and + 10 to represent CR and LF, as is the case for some multi-byte + character sets. + + Implementors should note that conversion will break any cryptographic + checksums applied to the original content unless the original content + is already in canonical form. Therefore, the canonical form is + recommended for any content that uses such checksums in HTTP. + +19.4.3 Conversion of Date Formats + + HTTP/1.1 uses a restricted set of date formats (section 3.3.1) to + simplify the process of date comparison. Proxies and gateways from + other protocols SHOULD ensure that any Date header field present in a + message conforms to one of the HTTP/1.1 formats and rewrite the date + if necessary. + +19.4.4 Introduction of Content-Encoding + + RFC 2045 does not include any concept equivalent to HTTP/1.1's + Content-Encoding header field. Since this acts as a modifier on the + media type, proxies and gateways from HTTP to MIME-compliant + protocols MUST either change the value of the Content-Type header + field or decode the entity-body before forwarding the message. (Some + experimental applications of Content-Type for Internet mail have used + a media-type parameter of ";conversions=" to perform + a function equivalent to Content-Encoding. However, this parameter is + not part of RFC 2045.) + +19.4.5 No Content-Transfer-Encoding + + HTTP does not use the Content-Transfer-Encoding (CTE) field of RFC + 2045. Proxies and gateways from MIME-compliant protocols to HTTP MUST + remove any non-identity CTE ("quoted-printable" or "base64") encoding + prior to delivering the response message to an HTTP client. + + Proxies and gateways from HTTP to MIME-compliant protocols are + responsible for ensuring that the message is in the correct format + and encoding for safe transport on that protocol, where "safe + + + +Fielding, et al. Standards Track [Page 168] + +RFC 2616 HTTP/1.1 June 1999 + + + transport" is defined by the limitations of the protocol being used. + Such a proxy or gateway SHOULD label the data with an appropriate + Content-Transfer-Encoding if doing so will improve the likelihood of + safe transport over the destination protocol. + +19.4.6 Introduction of Transfer-Encoding + + HTTP/1.1 introduces the Transfer-Encoding header field (section + 14.41). Proxies/gateways MUST remove any transfer-coding prior to + forwarding a message via a MIME-compliant protocol. + + A process for decoding the "chunked" transfer-coding (section 3.6) + can be represented in pseudo-code as: + + length := 0 + read chunk-size, chunk-extension (if any) and CRLF + while (chunk-size > 0) { + read chunk-data and CRLF + append chunk-data to entity-body + length := length + chunk-size + read chunk-size and CRLF + } + read entity-header + while (entity-header not empty) { + append entity-header to existing header fields + read entity-header + } + Content-Length := length + Remove "chunked" from Transfer-Encoding + +19.4.7 MHTML and Line Length Limitations + + HTTP implementations which share code with MHTML [45] implementations + need to be aware of MIME line length limitations. Since HTTP does not + have this limitation, HTTP does not fold long lines. MHTML messages + being transported by HTTP follow all conventions of MHTML, including + line length limitations and folding, canonicalization, etc., since + HTTP transports all message-bodies as payload (see section 3.7.2) and + does not interpret the content or any MIME header lines that might be + contained therein. + +19.5 Additional Features + + RFC 1945 and RFC 2068 document protocol elements used by some + existing HTTP implementations, but not consistently and correctly + across most HTTP/1.1 applications. Implementors are advised to be + aware of these features, but cannot rely upon their presence in, or + interoperability with, other HTTP/1.1 applications. Some of these + + + +Fielding, et al. Standards Track [Page 169] + +RFC 2616 HTTP/1.1 June 1999 + + + describe proposed experimental features, and some describe features + that experimental deployment found lacking that are now addressed in + the base HTTP/1.1 specification. + + A number of other headers, such as Content-Disposition and Title, + from SMTP and MIME are also often implemented (see RFC 2076 [37]). + +19.5.1 Content-Disposition + + The Content-Disposition response-header field has been proposed as a + means for the origin server to suggest a default filename if the user + requests that the content is saved to a file. This usage is derived + from the definition of Content-Disposition in RFC 1806 [35]. + + content-disposition = "Content-Disposition" ":" + disposition-type *( ";" disposition-parm ) + disposition-type = "attachment" | disp-extension-token + disposition-parm = filename-parm | disp-extension-parm + filename-parm = "filename" "=" quoted-string + disp-extension-token = token + disp-extension-parm = token "=" ( token | quoted-string ) + + An example is + + Content-Disposition: attachment; filename="fname.ext" + + The receiving user agent SHOULD NOT respect any directory path + information present in the filename-parm parameter, which is the only + parameter believed to apply to HTTP implementations at this time. The + filename SHOULD be treated as a terminal component only. + + If this header is used in a response with the application/octet- + stream content-type, the implied suggestion is that the user agent + should not display the response, but directly enter a `save response + as...' dialog. + + See section 15.5 for Content-Disposition security issues. + +19.6 Compatibility with Previous Versions + + It is beyond the scope of a protocol specification to mandate + compliance with previous versions. HTTP/1.1 was deliberately + designed, however, to make supporting previous versions easy. It is + worth noting that, at the time of composing this specification + (1996), we would expect commercial HTTP/1.1 servers to: + + - recognize the format of the Request-Line for HTTP/0.9, 1.0, and + 1.1 requests; + + + +Fielding, et al. Standards Track [Page 170] + +RFC 2616 HTTP/1.1 June 1999 + + + - understand any valid request in the format of HTTP/0.9, 1.0, or + 1.1; + + - respond appropriately with a message in the same major version + used by the client. + + And we would expect HTTP/1.1 clients to: + + - recognize the format of the Status-Line for HTTP/1.0 and 1.1 + responses; + + - understand any valid response in the format of HTTP/0.9, 1.0, or + 1.1. + + For most implementations of HTTP/1.0, each connection is established + by the client prior to the request and closed by the server after + sending the response. Some implementations implement the Keep-Alive + version of persistent connections described in section 19.7.1 of RFC + 2068 [33]. + +19.6.1 Changes from HTTP/1.0 + + This section summarizes major differences between versions HTTP/1.0 + and HTTP/1.1. + +19.6.1.1 Changes to Simplify Multi-homed Web Servers and Conserve IP + Addresses + + The requirements that clients and servers support the Host request- + header, report an error if the Host request-header (section 14.23) is + missing from an HTTP/1.1 request, and accept absolute URIs (section + 5.1.2) are among the most important changes defined by this + specification. + + Older HTTP/1.0 clients assumed a one-to-one relationship of IP + addresses and servers; there was no other established mechanism for + distinguishing the intended server of a request than the IP address + to which that request was directed. The changes outlined above will + allow the Internet, once older HTTP clients are no longer common, to + support multiple Web sites from a single IP address, greatly + simplifying large operational Web servers, where allocation of many + IP addresses to a single host has created serious problems. The + Internet will also be able to recover the IP addresses that have been + allocated for the sole purpose of allowing special-purpose domain + names to be used in root-level HTTP URLs. Given the rate of growth of + the Web, and the number of servers already deployed, it is extremely + + + + + +Fielding, et al. Standards Track [Page 171] + +RFC 2616 HTTP/1.1 June 1999 + + + important that all implementations of HTTP (including updates to + existing HTTP/1.0 applications) correctly implement these + requirements: + + - Both clients and servers MUST support the Host request-header. + + - A client that sends an HTTP/1.1 request MUST send a Host header. + + - Servers MUST report a 400 (Bad Request) error if an HTTP/1.1 + request does not include a Host request-header. + + - Servers MUST accept absolute URIs. + +19.6.2 Compatibility with HTTP/1.0 Persistent Connections + + Some clients and servers might wish to be compatible with some + previous implementations of persistent connections in HTTP/1.0 + clients and servers. Persistent connections in HTTP/1.0 are + explicitly negotiated as they are not the default behavior. HTTP/1.0 + experimental implementations of persistent connections are faulty, + and the new facilities in HTTP/1.1 are designed to rectify these + problems. The problem was that some existing 1.0 clients may be + sending Keep-Alive to a proxy server that doesn't understand + Connection, which would then erroneously forward it to the next + inbound server, which would establish the Keep-Alive connection and + result in a hung HTTP/1.0 proxy waiting for the close on the + response. The result is that HTTP/1.0 clients must be prevented from + using Keep-Alive when talking to proxies. + + However, talking to proxies is the most important use of persistent + connections, so that prohibition is clearly unacceptable. Therefore, + we need some other mechanism for indicating a persistent connection + is desired, which is safe to use even when talking to an old proxy + that ignores Connection. Persistent connections are the default for + HTTP/1.1 messages; we introduce a new keyword (Connection: close) for + declaring non-persistence. See section 14.10. + + The original HTTP/1.0 form of persistent connections (the Connection: + Keep-Alive and Keep-Alive header) is documented in RFC 2068. [33] + +19.6.3 Changes from RFC 2068 + + This specification has been carefully audited to correct and + disambiguate key word usage; RFC 2068 had many problems in respect to + the conventions laid out in RFC 2119 [34]. + + Clarified which error code should be used for inbound server failures + (e.g. DNS failures). (Section 10.5.5). + + + +Fielding, et al. Standards Track [Page 172] + +RFC 2616 HTTP/1.1 June 1999 + + + CREATE had a race that required an Etag be sent when a resource is + first created. (Section 10.2.2). + + Content-Base was deleted from the specification: it was not + implemented widely, and there is no simple, safe way to introduce it + without a robust extension mechanism. In addition, it is used in a + similar, but not identical fashion in MHTML [45]. + + Transfer-coding and message lengths all interact in ways that + required fixing exactly when chunked encoding is used (to allow for + transfer encoding that may not be self delimiting); it was important + to straighten out exactly how message lengths are computed. (Sections + 3.6, 4.4, 7.2.2, 13.5.2, 14.13, 14.16) + + A content-coding of "identity" was introduced, to solve problems + discovered in caching. (section 3.5) + + Quality Values of zero should indicate that "I don't want something" + to allow clients to refuse a representation. (Section 3.9) + + The use and interpretation of HTTP version numbers has been clarified + by RFC 2145. Require proxies to upgrade requests to highest protocol + version they support to deal with problems discovered in HTTP/1.0 + implementations (Section 3.1) + + Charset wildcarding is introduced to avoid explosion of character set + names in accept headers. (Section 14.2) + + A case was missed in the Cache-Control model of HTTP/1.1; s-maxage + was introduced to add this missing case. (Sections 13.4, 14.8, 14.9, + 14.9.3) + + The Cache-Control: max-age directive was not properly defined for + responses. (Section 14.9.3) + + There are situations where a server (especially a proxy) does not + know the full length of a response but is capable of serving a + byterange request. We therefore need a mechanism to allow byteranges + with a content-range not indicating the full length of the message. + (Section 14.16) + + Range request responses would become very verbose if all meta-data + were always returned; by allowing the server to only send needed + headers in a 206 response, this problem can be avoided. (Section + 10.2.7, 13.5.3, and 14.27) + + + + + + +Fielding, et al. Standards Track [Page 173] + +RFC 2616 HTTP/1.1 June 1999 + + + Fix problem with unsatisfiable range requests; there are two cases: + syntactic problems, and range doesn't exist in the document. The 416 + status code was needed to resolve this ambiguity needed to indicate + an error for a byte range request that falls outside of the actual + contents of a document. (Section 10.4.17, 14.16) + + Rewrite of message transmission requirements to make it much harder + for implementors to get it wrong, as the consequences of errors here + can have significant impact on the Internet, and to deal with the + following problems: + + 1. Changing "HTTP/1.1 or later" to "HTTP/1.1", in contexts where + this was incorrectly placing a requirement on the behavior of + an implementation of a future version of HTTP/1.x + + 2. Made it clear that user-agents should retry requests, not + "clients" in general. + + 3. Converted requirements for clients to ignore unexpected 100 + (Continue) responses, and for proxies to forward 100 responses, + into a general requirement for 1xx responses. + + 4. Modified some TCP-specific language, to make it clearer that + non-TCP transports are possible for HTTP. + + 5. Require that the origin server MUST NOT wait for the request + body before it sends a required 100 (Continue) response. + + 6. Allow, rather than require, a server to omit 100 (Continue) if + it has already seen some of the request body. + + 7. Allow servers to defend against denial-of-service attacks and + broken clients. + + This change adds the Expect header and 417 status code. The message + transmission requirements fixes are in sections 8.2, 10.4.18, + 8.1.2.2, 13.11, and 14.20. + + Proxies should be able to add Content-Length when appropriate. + (Section 13.5.2) + + Clean up confusion between 403 and 404 responses. (Section 10.4.4, + 10.4.5, and 10.4.11) + + Warnings could be cached incorrectly, or not updated appropriately. + (Section 13.1.2, 13.2.4, 13.5.2, 13.5.3, 14.9.3, and 14.46) Warning + also needed to be a general header, as PUT or other methods may have + need for it in requests. + + + +Fielding, et al. Standards Track [Page 174] + +RFC 2616 HTTP/1.1 June 1999 + + + Transfer-coding had significant problems, particularly with + interactions with chunked encoding. The solution is that transfer- + codings become as full fledged as content-codings. This involves + adding an IANA registry for transfer-codings (separate from content + codings), a new header field (TE) and enabling trailer headers in the + future. Transfer encoding is a major performance benefit, so it was + worth fixing [39]. TE also solves another, obscure, downward + interoperability problem that could have occurred due to interactions + between authentication trailers, chunked encoding and HTTP/1.0 + clients.(Section 3.6, 3.6.1, and 14.39) + + The PATCH, LINK, UNLINK methods were defined but not commonly + implemented in previous versions of this specification. See RFC 2068 + [33]. + + The Alternates, Content-Version, Derived-From, Link, URI, Public and + Content-Base header fields were defined in previous versions of this + specification, but not commonly implemented. See RFC 2068 [33]. + +20 Index + + Please see the PostScript version of this RFC for the INDEX. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 175] + +RFC 2616 HTTP/1.1 June 1999 + + +21. Full Copyright Statement + + Copyright (C) The Internet Society (1999). All Rights Reserved. + + This document and translations of it may be copied and furnished to + others, and derivative works that comment on or otherwise explain it + or assist in its implementation may be prepared, copied, published + and distributed, in whole or in part, without restriction of any + kind, provided that the above copyright notice and this paragraph are + included on all such copies and derivative works. However, this + document itself may not be modified in any way, such as by removing + the copyright notice or references to the Internet Society or other + Internet organizations, except as needed for the purpose of + developing Internet standards in which case the procedures for + copyrights defined in the Internet Standards process must be + followed, or as required to translate it into languages other than + English. + + The limited permissions granted above are perpetual and will not be + revoked by the Internet Society or its successors or assigns. + + This document and the information contained herein is provided on an + "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING + TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING + BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION + HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF + MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + +Acknowledgement + + Funding for the RFC Editor function is currently provided by the + Internet Society. + + Network Working Group R. Fielding +Request for Comments: 2616 UC Irvine +Obsoletes: 2068 J. Gettys +Category: Standards Track Compaq/W3C + J. Mogul + Compaq + H. Frystyk + W3C/MIT + L. Masinter + Xerox + P. Leach + Microsoft + T. Berners-Lee + W3C/MIT + June 1999 + + + Hypertext Transfer Protocol -- HTTP/1.1 + +Status of this Memo + + This document specifies an Internet standards track protocol for the + Internet community, and requests discussion and suggestions for + improvements. Please refer to the current edition of the "Internet + Official Protocol Standards" (STD 1) for the standardization state + and status of this protocol. Distribution of this memo is unlimited. + +Copyright Notice + + Copyright (C) The Internet Society (1999). All Rights Reserved. + +Abstract + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. It is a generic, stateless, protocol which can be used for + many tasks beyond its use for hypertext, such as name servers and + distributed object management systems, through extension of its + request methods, error codes and headers [47]. A feature of HTTP is + the typing and negotiation of data representation, allowing systems + to be built independently of the data being transferred. + + HTTP has been in use by the World-Wide Web global information + initiative since 1990. This specification defines the protocol + referred to as "HTTP/1.1", and is an update to RFC 2068 [33]. + + + + + + +Fielding, et al. Standards Track [Page 1] + +RFC 2616 HTTP/1.1 June 1999 + + +Table of Contents + + 1 Introduction ...................................................7 + 1.1 Purpose......................................................7 + 1.2 Requirements .................................................8 + 1.3 Terminology ..................................................8 + 1.4 Overall Operation ...........................................12 + 2 Notational Conventions and Generic Grammar ....................14 + 2.1 Augmented BNF ...............................................14 + 2.2 Basic Rules .................................................15 + 3 Protocol Parameters ...........................................17 + 3.1 HTTP Version ................................................17 + 3.2 Uniform Resource Identifiers ................................18 + 3.2.1 General Syntax ...........................................19 + 3.2.2 http URL .................................................19 + 3.2.3 URI Comparison ...........................................20 + 3.3 Date/Time Formats ...........................................20 + 3.3.1 Full Date ................................................20 + 3.3.2 Delta Seconds ............................................21 + 3.4 Character Sets ..............................................21 + 3.4.1 Missing Charset ..........................................22 + 3.5 Content Codings .............................................23 + 3.6 Transfer Codings ............................................24 + 3.6.1 Chunked Transfer Coding ..................................25 + 3.7 Media Types .................................................26 + 3.7.1 Canonicalization and Text Defaults .......................27 + 3.7.2 Multipart Types ..........................................27 + 3.8 Product Tokens ..............................................28 + 3.9 Quality Values ..............................................29 + 3.10 Language Tags ...............................................29 + 3.11 Entity Tags .................................................30 + 3.12 Range Units .................................................30 + 4 HTTP Message ..................................................31 + 4.1 Message Types ...............................................31 + 4.2 Message Headers .............................................31 + 4.3 Message Body ................................................32 + 4.4 Message Length ..............................................33 + 4.5 General Header Fields .......................................34 + 5 Request .......................................................35 + 5.1 Request-Line ................................................35 + 5.1.1 Method ...................................................36 + 5.1.2 Request-URI ..............................................36 + 5.2 The Resource Identified by a Request ........................38 + 5.3 Request Header Fields .......................................38 + 6 Response ......................................................39 + 6.1 Status-Line .................................................39 + 6.1.1 Status Code and Reason Phrase ............................39 + 6.2 Response Header Fields ......................................41 + + + +Fielding, et al. Standards Track [Page 2] + +RFC 2616 HTTP/1.1 June 1999 + + + 7 Entity ........................................................42 + 7.1 Entity Header Fields ........................................42 + 7.2 Entity Body .................................................43 + 7.2.1 Type .....................................................43 + 7.2.2 Entity Length ............................................43 + 8 Connections ...................................................44 + 8.1 Persistent Connections ......................................44 + 8.1.1 Purpose ..................................................44 + 8.1.2 Overall Operation ........................................45 + 8.1.3 Proxy Servers ............................................46 + 8.1.4 Practical Considerations .................................46 + 8.2 Message Transmission Requirements ...........................47 + 8.2.1 Persistent Connections and Flow Control ..................47 + 8.2.2 Monitoring Connections for Error Status Messages .........48 + 8.2.3 Use of the 100 (Continue) Status .........................48 + 8.2.4 Client Behavior if Server Prematurely Closes Connection ..50 + 9 Method Definitions ............................................51 + 9.1 Safe and Idempotent Methods .................................51 + 9.1.1 Safe Methods .............................................51 + 9.1.2 Idempotent Methods .......................................51 + 9.2 OPTIONS .....................................................52 + 9.3 GET .........................................................53 + 9.4 HEAD ........................................................54 + 9.5 POST ........................................................54 + 9.6 PUT .........................................................55 + 9.7 DELETE ......................................................56 + 9.8 TRACE .......................................................56 + 9.9 CONNECT .....................................................57 + 10 Status Code Definitions ......................................57 + 10.1 Informational 1xx ...........................................57 + 10.1.1 100 Continue .............................................58 + 10.1.2 101 Switching Protocols ..................................58 + 10.2 Successful 2xx ..............................................58 + 10.2.1 200 OK ...................................................58 + 10.2.2 201 Created ..............................................59 + 10.2.3 202 Accepted .............................................59 + 10.2.4 203 Non-Authoritative Information ........................59 + 10.2.5 204 No Content ...........................................60 + 10.2.6 205 Reset Content ........................................60 + 10.2.7 206 Partial Content ......................................60 + 10.3 Redirection 3xx .............................................61 + 10.3.1 300 Multiple Choices .....................................61 + 10.3.2 301 Moved Permanently ....................................62 + 10.3.3 302 Found ................................................62 + 10.3.4 303 See Other ............................................63 + 10.3.5 304 Not Modified .........................................63 + 10.3.6 305 Use Proxy ............................................64 + 10.3.7 306 (Unused) .............................................64 + + + +Fielding, et al. Standards Track [Page 3] + +RFC 2616 HTTP/1.1 June 1999 + + + 10.3.8 307 Temporary Redirect ...................................65 + 10.4 Client Error 4xx ............................................65 + 10.4.1 400 Bad Request .........................................65 + 10.4.2 401 Unauthorized ........................................66 + 10.4.3 402 Payment Required ....................................66 + 10.4.4 403 Forbidden ...........................................66 + 10.4.5 404 Not Found ...........................................66 + 10.4.6 405 Method Not Allowed ..................................66 + 10.4.7 406 Not Acceptable ......................................67 + 10.4.8 407 Proxy Authentication Required .......................67 + 10.4.9 408 Request Timeout .....................................67 + 10.4.10 409 Conflict ............................................67 + 10.4.11 410 Gone ................................................68 + 10.4.12 411 Length Required .....................................68 + 10.4.13 412 Precondition Failed .................................68 + 10.4.14 413 Request Entity Too Large ............................69 + 10.4.15 414 Request-URI Too Long ................................69 + 10.4.16 415 Unsupported Media Type ..............................69 + 10.4.17 416 Requested Range Not Satisfiable .....................69 + 10.4.18 417 Expectation Failed ..................................70 + 10.5 Server Error 5xx ............................................70 + 10.5.1 500 Internal Server Error ................................70 + 10.5.2 501 Not Implemented ......................................70 + 10.5.3 502 Bad Gateway ..........................................70 + 10.5.4 503 Service Unavailable ..................................70 + 10.5.5 504 Gateway Timeout ......................................71 + 10.5.6 505 HTTP Version Not Supported ...........................71 + 11 Access Authentication ........................................71 + 12 Content Negotiation ..........................................71 + 12.1 Server-driven Negotiation ...................................72 + 12.2 Agent-driven Negotiation ....................................73 + 12.3 Transparent Negotiation .....................................74 + 13 Caching in HTTP ..............................................74 + 13.1.1 Cache Correctness ........................................75 + 13.1.2 Warnings .................................................76 + 13.1.3 Cache-control Mechanisms .................................77 + 13.1.4 Explicit User Agent Warnings .............................78 + 13.1.5 Exceptions to the Rules and Warnings .....................78 + 13.1.6 Client-controlled Behavior ...............................79 + 13.2 Expiration Model ............................................79 + 13.2.1 Server-Specified Expiration ..............................79 + 13.2.2 Heuristic Expiration .....................................80 + 13.2.3 Age Calculations .........................................80 + 13.2.4 Expiration Calculations ..................................83 + 13.2.5 Disambiguating Expiration Values .........................84 + 13.2.6 Disambiguating Multiple Responses ........................84 + 13.3 Validation Model ............................................85 + 13.3.1 Last-Modified Dates ......................................86 + + + +Fielding, et al. Standards Track [Page 4] + +RFC 2616 HTTP/1.1 June 1999 + + + 13.3.2 Entity Tag Cache Validators ..............................86 + 13.3.3 Weak and Strong Validators ...............................86 + 13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates.89 + 13.3.5 Non-validating Conditionals ..............................90 + 13.4 Response Cacheability .......................................91 + 13.5 Constructing Responses From Caches ..........................92 + 13.5.1 End-to-end and Hop-by-hop Headers ........................92 + 13.5.2 Non-modifiable Headers ...................................92 + 13.5.3 Combining Headers ........................................94 + 13.5.4 Combining Byte Ranges ....................................95 + 13.6 Caching Negotiated Responses ................................95 + 13.7 Shared and Non-Shared Caches ................................96 + 13.8 Errors or Incomplete Response Cache Behavior ................97 + 13.9 Side Effects of GET and HEAD ................................97 + 13.10 Invalidation After Updates or Deletions ...................97 + 13.11 Write-Through Mandatory ...................................98 + 13.12 Cache Replacement .........................................99 + 13.13 History Lists .............................................99 + 14 Header Field Definitions ....................................100 + 14.1 Accept .....................................................100 + 14.2 Accept-Charset .............................................102 + 14.3 Accept-Encoding ............................................102 + 14.4 Accept-Language ............................................104 + 14.5 Accept-Ranges ..............................................105 + 14.6 Age ........................................................106 + 14.7 Allow ......................................................106 + 14.8 Authorization ..............................................107 + 14.9 Cache-Control ..............................................108 + 14.9.1 What is Cacheable .......................................109 + 14.9.2 What May be Stored by Caches ............................110 + 14.9.3 Modifications of the Basic Expiration Mechanism .........111 + 14.9.4 Cache Revalidation and Reload Controls ..................113 + 14.9.5 No-Transform Directive ..................................115 + 14.9.6 Cache Control Extensions ................................116 + 14.10 Connection ...............................................117 + 14.11 Content-Encoding .........................................118 + 14.12 Content-Language .........................................118 + 14.13 Content-Length ...........................................119 + 14.14 Content-Location .........................................120 + 14.15 Content-MD5 ..............................................121 + 14.16 Content-Range ............................................122 + 14.17 Content-Type .............................................124 + 14.18 Date .....................................................124 + 14.18.1 Clockless Origin Server Operation ......................125 + 14.19 ETag .....................................................126 + 14.20 Expect ...................................................126 + 14.21 Expires ..................................................127 + 14.22 From .....................................................128 + + + +Fielding, et al. Standards Track [Page 5] + +RFC 2616 HTTP/1.1 June 1999 + + + 14.23 Host .....................................................128 + 14.24 If-Match .................................................129 + 14.25 If-Modified-Since ........................................130 + 14.26 If-None-Match ............................................132 + 14.27 If-Range .................................................133 + 14.28 If-Unmodified-Since ......................................134 + 14.29 Last-Modified ............................................134 + 14.30 Location .................................................135 + 14.31 Max-Forwards .............................................136 + 14.32 Pragma ...................................................136 + 14.33 Proxy-Authenticate .......................................137 + 14.34 Proxy-Authorization ......................................137 + 14.35 Range ....................................................138 + 14.35.1 Byte Ranges ...........................................138 + 14.35.2 Range Retrieval Requests ..............................139 + 14.36 Referer ..................................................140 + 14.37 Retry-After ..............................................141 + 14.38 Server ...................................................141 + 14.39 TE .......................................................142 + 14.40 Trailer ..................................................143 + 14.41 Transfer-Encoding..........................................143 + 14.42 Upgrade ..................................................144 + 14.43 User-Agent ...............................................145 + 14.44 Vary .....................................................145 + 14.45 Via ......................................................146 + 14.46 Warning ..................................................148 + 14.47 WWW-Authenticate .........................................150 + 15 Security Considerations .......................................150 + 15.1 Personal Information....................................151 + 15.1.1 Abuse of Server Log Information .........................151 + 15.1.2 Transfer of Sensitive Information .......................151 + 15.1.3 Encoding Sensitive Information in URI's .................152 + 15.1.4 Privacy Issues Connected to Accept Headers ..............152 + 15.2 Attacks Based On File and Path Names .......................153 + 15.3 DNS Spoofing ...............................................154 + 15.4 Location Headers and Spoofing ..............................154 + 15.5 Content-Disposition Issues .................................154 + 15.6 Authentication Credentials and Idle Clients ................155 + 15.7 Proxies and Caching ........................................155 + 15.7.1 Denial of Service Attacks on Proxies....................156 + 16 Acknowledgments .............................................156 + 17 References ..................................................158 + 18 Authors' Addresses ..........................................162 + 19 Appendices ..................................................164 + 19.1 Internet Media Type message/http and application/http ......164 + 19.2 Internet Media Type multipart/byteranges ...................165 + 19.3 Tolerant Applications ......................................166 + 19.4 Differences Between HTTP Entities and RFC 2045 Entities ....167 + + + +Fielding, et al. Standards Track [Page 6] + +RFC 2616 HTTP/1.1 June 1999 + + + 19.4.1 MIME-Version ............................................167 + 19.4.2 Conversion to Canonical Form ............................167 + 19.4.3 Conversion of Date Formats ..............................168 + 19.4.4 Introduction of Content-Encoding ........................168 + 19.4.5 No Content-Transfer-Encoding ............................168 + 19.4.6 Introduction of Transfer-Encoding .......................169 + 19.4.7 MHTML and Line Length Limitations .......................169 + 19.5 Additional Features ........................................169 + 19.5.1 Content-Disposition .....................................170 + 19.6 Compatibility with Previous Versions .......................170 + 19.6.1 Changes from HTTP/1.0 ...................................171 + 19.6.2 Compatibility with HTTP/1.0 Persistent Connections ......172 + 19.6.3 Changes from RFC 2068 ...................................172 + 20 Index .......................................................175 + 21 Full Copyright Statement ....................................176 + +1 Introduction + +1.1 Purpose + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. HTTP has been in use by the World-Wide Web global + information initiative since 1990. The first version of HTTP, + referred to as HTTP/0.9, was a simple protocol for raw data transfer + across the Internet. HTTP/1.0, as defined by RFC 1945 [6], improved + the protocol by allowing messages to be in the format of MIME-like + messages, containing metainformation about the data transferred and + modifiers on the request/response semantics. However, HTTP/1.0 does + not sufficiently take into consideration the effects of hierarchical + proxies, caching, the need for persistent connections, or virtual + hosts. In addition, the proliferation of incompletely-implemented + applications calling themselves "HTTP/1.0" has necessitated a + protocol version change in order for two communicating applications + to determine each other's true capabilities. + + This specification defines the protocol referred to as "HTTP/1.1". + This protocol includes more stringent requirements than HTTP/1.0 in + order to ensure reliable implementation of its features. + + Practical information systems require more functionality than simple + retrieval, including search, front-end update, and annotation. HTTP + allows an open-ended set of methods and headers that indicate the + purpose of a request [47]. It builds on the discipline of reference + provided by the Uniform Resource Identifier (URI) [3], as a location + (URL) [4] or name (URN) [20], for indicating the resource to which a + + + + + +Fielding, et al. Standards Track [Page 7] + +RFC 2616 HTTP/1.1 June 1999 + + + method is to be applied. Messages are passed in a format similar to + that used by Internet mail [9] as defined by the Multipurpose + Internet Mail Extensions (MIME) [7]. + + HTTP is also used as a generic protocol for communication between + user agents and proxies/gateways to other Internet systems, including + those supported by the SMTP [16], NNTP [13], FTP [18], Gopher [2], + and WAIS [10] protocols. In this way, HTTP allows basic hypermedia + access to resources available from diverse applications. + +1.2 Requirements + + The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", + "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this + document are to be interpreted as described in RFC 2119 [34]. + + An implementation is not compliant if it fails to satisfy one or more + of the MUST or REQUIRED level requirements for the protocols it + implements. An implementation that satisfies all the MUST or REQUIRED + level and all the SHOULD level requirements for its protocols is said + to be "unconditionally compliant"; one that satisfies all the MUST + level requirements but not all the SHOULD level requirements for its + protocols is said to be "conditionally compliant." + +1.3 Terminology + + This specification uses a number of terms to refer to the roles + played by participants in, and objects of, the HTTP communication. + + connection + A transport layer virtual circuit established between two programs + for the purpose of communication. + + message + The basic unit of HTTP communication, consisting of a structured + sequence of octets matching the syntax defined in section 4 and + transmitted via the connection. + + request + An HTTP request message, as defined in section 5. + + response + An HTTP response message, as defined in section 6. + + + + + + + + +Fielding, et al. Standards Track [Page 8] + +RFC 2616 HTTP/1.1 June 1999 + + + resource + A network data object or service that can be identified by a URI, + as defined in section 3.2. Resources may be available in multiple + representations (e.g. multiple languages, data formats, size, and + resolutions) or vary in other ways. + + entity + The information transferred as the payload of a request or + response. An entity consists of metainformation in the form of + entity-header fields and content in the form of an entity-body, as + described in section 7. + + representation + An entity included with a response that is subject to content + negotiation, as described in section 12. There may exist multiple + representations associated with a particular response status. + + content negotiation + The mechanism for selecting the appropriate representation when + servicing a request, as described in section 12. The + representation of entities in any response can be negotiated + (including error responses). + + variant + A resource may have one, or more than one, representation(s) + associated with it at any given instant. Each of these + representations is termed a `varriant'. Use of the term `variant' + does not necessarily imply that the resource is subject to content + negotiation. + + client + A program that establishes connections for the purpose of sending + requests. + + user agent + The client which initiates a request. These are often browsers, + editors, spiders (web-traversing robots), or other end user tools. + + server + An application program that accepts connections in order to + service requests by sending back responses. Any given program may + be capable of being both a client and a server; our use of these + terms refers only to the role being performed by the program for a + particular connection, rather than to the program's capabilities + in general. Likewise, any server may act as an origin server, + proxy, gateway, or tunnel, switching behavior based on the nature + of each request. + + + + +Fielding, et al. Standards Track [Page 9] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server + The server on which a given resource resides or is to be created. + + proxy + An intermediary program which acts as both a server and a client + for the purpose of making requests on behalf of other clients. + Requests are serviced internally or by passing them on, with + possible translation, to other servers. A proxy MUST implement + both the client and server requirements of this specification. A + "transparent proxy" is a proxy that does not modify the request or + response beyond what is required for proxy authentication and + identification. A "non-transparent proxy" is a proxy that modifies + the request or response in order to provide some added service to + the user agent, such as group annotation services, media type + transformation, protocol reduction, or anonymity filtering. Except + where either transparent or non-transparent behavior is explicitly + stated, the HTTP proxy requirements apply to both types of + proxies. + + gateway + A server which acts as an intermediary for some other server. + Unlike a proxy, a gateway receives requests as if it were the + origin server for the requested resource; the requesting client + may not be aware that it is communicating with a gateway. + + tunnel + An intermediary program which is acting as a blind relay between + two connections. Once active, a tunnel is not considered a party + to the HTTP communication, though the tunnel may have been + initiated by an HTTP request. The tunnel ceases to exist when both + ends of the relayed connections are closed. + + cache + A program's local store of response messages and the subsystem + that controls its message storage, retrieval, and deletion. A + cache stores cacheable responses in order to reduce the response + time and network bandwidth consumption on future, equivalent + requests. Any client or server may include a cache, though a cache + cannot be used by a server that is acting as a tunnel. + + cacheable + A response is cacheable if a cache is allowed to store a copy of + the response message for use in answering subsequent requests. The + rules for determining the cacheability of HTTP responses are + defined in section 13. Even if a resource is cacheable, there may + be additional constraints on whether a cache can use the cached + copy for a particular request. + + + + +Fielding, et al. Standards Track [Page 10] + +RFC 2616 HTTP/1.1 June 1999 + + + first-hand + A response is first-hand if it comes directly and without + unnecessary delay from the origin server, perhaps via one or more + proxies. A response is also first-hand if its validity has just + been checked directly with the origin server. + + explicit expiration time + The time at which the origin server intends that an entity should + no longer be returned by a cache without further validation. + + heuristic expiration time + An expiration time assigned by a cache when no explicit expiration + time is available. + + age + The age of a response is the time since it was sent by, or + successfully validated with, the origin server. + + freshness lifetime + The length of time between the generation of a response and its + expiration time. + + fresh + A response is fresh if its age has not yet exceeded its freshness + lifetime. + + stale + A response is stale if its age has passed its freshness lifetime. + + semantically transparent + A cache behaves in a "semantically transparent" manner, with + respect to a particular response, when its use affects neither the + requesting client nor the origin server, except to improve + performance. When a cache is semantically transparent, the client + receives exactly the same response (except for hop-by-hop headers) + that it would have received had its request been handled directly + by the origin server. + + validator + A protocol element (e.g., an entity tag or a Last-Modified time) + that is used to find out whether a cache entry is an equivalent + copy of an entity. + + upstream/downstream + Upstream and downstream describe the flow of a message: all + messages flow from upstream to downstream. + + + + + +Fielding, et al. Standards Track [Page 11] + +RFC 2616 HTTP/1.1 June 1999 + + + inbound/outbound + Inbound and outbound refer to the request and response paths for + messages: "inbound" means "traveling toward the origin server", + and "outbound" means "traveling toward the user agent" + +1.4 Overall Operation + + The HTTP protocol is a request/response protocol. A client sends a + request to the server in the form of a request method, URI, and + protocol version, followed by a MIME-like message containing request + modifiers, client information, and possible body content over a + connection with a server. The server responds with a status line, + including the message's protocol version and a success or error code, + followed by a MIME-like message containing server information, entity + metainformation, and possible entity-body content. The relationship + between HTTP and MIME is described in appendix 19.4. + + Most HTTP communication is initiated by a user agent and consists of + a request to be applied to a resource on some origin server. In the + simplest case, this may be accomplished via a single connection (v) + between the user agent (UA) and the origin server (O). + + request chain ------------------------> + UA -------------------v------------------- O + <----------------------- response chain + + A more complicated situation occurs when one or more intermediaries + are present in the request/response chain. There are three common + forms of intermediary: proxy, gateway, and tunnel. A proxy is a + forwarding agent, receiving requests for a URI in its absolute form, + rewriting all or part of the message, and forwarding the reformatted + request toward the server identified by the URI. A gateway is a + receiving agent, acting as a layer above some other server(s) and, if + necessary, translating the requests to the underlying server's + protocol. A tunnel acts as a relay point between two connections + without changing the messages; tunnels are used when the + communication needs to pass through an intermediary (such as a + firewall) even when the intermediary cannot understand the contents + of the messages. + + request chain --------------------------------------> + UA -----v----- A -----v----- B -----v----- C -----v----- O + <------------------------------------- response chain + + The figure above shows three intermediaries (A, B, and C) between the + user agent and origin server. A request or response message that + travels the whole chain will pass through four separate connections. + This distinction is important because some HTTP communication options + + + +Fielding, et al. Standards Track [Page 12] + +RFC 2616 HTTP/1.1 June 1999 + + + may apply only to the connection with the nearest, non-tunnel + neighbor, only to the end-points of the chain, or to all connections + along the chain. Although the diagram is linear, each participant may + be engaged in multiple, simultaneous communications. For example, B + may be receiving requests from many clients other than A, and/or + forwarding requests to servers other than C, at the same time that it + is handling A's request. + + Any party to the communication which is not acting as a tunnel may + employ an internal cache for handling requests. The effect of a cache + is that the request/response chain is shortened if one of the + participants along the chain has a cached response applicable to that + request. The following illustrates the resulting chain if B has a + cached copy of an earlier response from O (via C) for a request which + has not been cached by UA or A. + + request chain ----------> + UA -----v----- A -----v----- B - - - - - - C - - - - - - O + <--------- response chain + + Not all responses are usefully cacheable, and some requests may + contain modifiers which place special requirements on cache behavior. + HTTP requirements for cache behavior and cacheable responses are + defined in section 13. + + In fact, there are a wide variety of architectures and configurations + of caches and proxies currently being experimented with or deployed + across the World Wide Web. These systems include national hierarchies + of proxy caches to save transoceanic bandwidth, systems that + broadcast or multicast cache entries, organizations that distribute + subsets of cached data via CD-ROM, and so on. HTTP systems are used + in corporate intranets over high-bandwidth links, and for access via + PDAs with low-power radio links and intermittent connectivity. The + goal of HTTP/1.1 is to support the wide diversity of configurations + already deployed while introducing protocol constructs that meet the + needs of those who build web applications that require high + reliability and, failing that, at least reliable indications of + failure. + + HTTP communication usually takes place over TCP/IP connections. The + default port is TCP 80 [19], but other ports can be used. This does + not preclude HTTP from being implemented on top of any other protocol + on the Internet, or on other networks. HTTP only presumes a reliable + transport; any protocol that provides such guarantees can be used; + the mapping of the HTTP/1.1 request and response structures onto the + transport data units of the protocol in question is outside the scope + of this specification. + + + + +Fielding, et al. Standards Track [Page 13] + +RFC 2616 HTTP/1.1 June 1999 + + + In HTTP/1.0, most implementations used a new connection for each + request/response exchange. In HTTP/1.1, a connection may be used for + one or more request/response exchanges, although connections may be + closed for a variety of reasons (see section 8.1). + +2 Notational Conventions and Generic Grammar + +2.1 Augmented BNF + + All of the mechanisms specified in this document are described in + both prose and an augmented Backus-Naur Form (BNF) similar to that + used by RFC 822 [9]. Implementors will need to be familiar with the + notation in order to understand this specification. The augmented BNF + includes the following constructs: + + name = definition + The name of a rule is simply the name itself (without any + enclosing "<" and ">") and is separated from its definition by the + equal "=" character. White space is only significant in that + indentation of continuation lines is used to indicate a rule + definition that spans more than one line. Certain basic rules are + in uppercase, such as SP, LWS, HT, CRLF, DIGIT, ALPHA, etc. Angle + brackets are used within definitions whenever their presence will + facilitate discerning the use of rule names. + + "literal" + Quotation marks surround literal text. Unless stated otherwise, + the text is case-insensitive. + + rule1 | rule2 + Elements separated by a bar ("|") are alternatives, e.g., "yes | + no" will accept yes or no. + + (rule1 rule2) + Elements enclosed in parentheses are treated as a single element. + Thus, "(elem (foo | bar) elem)" allows the token sequences "elem + foo elem" and "elem bar elem". + + *rule + The character "*" preceding an element indicates repetition. The + full form is "*element" indicating at least and at most + occurrences of element. Default values are 0 and infinity so + that "*(element)" allows any number, including zero; "1*element" + requires at least one; and "1*2element" allows one or two. + + [rule] + Square brackets enclose optional elements; "[foo bar]" is + equivalent to "*1(foo bar)". + + + +Fielding, et al. Standards Track [Page 14] + +RFC 2616 HTTP/1.1 June 1999 + + + N rule + Specific repetition: "(element)" is equivalent to + "*(element)"; that is, exactly occurrences of (element). + Thus 2DIGIT is a 2-digit number, and 3ALPHA is a string of three + alphabetic characters. + + #rule + A construct "#" is defined, similar to "*", for defining lists of + elements. The full form is "#element" indicating at least + and at most elements, each separated by one or more commas + (",") and OPTIONAL linear white space (LWS). This makes the usual + form of lists very easy; a rule such as + ( *LWS element *( *LWS "," *LWS element )) + can be shown as + 1#element + Wherever this construct is used, null elements are allowed, but do + not contribute to the count of elements present. That is, + "(element), , (element) " is permitted, but counts as only two + elements. Therefore, where at least one element is required, at + least one non-null element MUST be present. Default values are 0 + and infinity so that "#element" allows any number, including zero; + "1#element" requires at least one; and "1#2element" allows one or + two. + + ; comment + A semi-colon, set off some distance to the right of rule text, + starts a comment that continues to the end of line. This is a + simple way of including useful notes in parallel with the + specifications. + + implied *LWS + The grammar described by this specification is word-based. Except + where noted otherwise, linear white space (LWS) can be included + between any two adjacent words (token or quoted-string), and + between adjacent words and separators, without changing the + interpretation of a field. At least one delimiter (LWS and/or + + separators) MUST exist between any two tokens (for the definition + of "token" below), since they would otherwise be interpreted as a + single token. + +2.2 Basic Rules + + The following rules are used throughout this specification to + describe basic parsing constructs. The US-ASCII coded character set + is defined by ANSI X3.4-1986 [21]. + + + + + +Fielding, et al. Standards Track [Page 15] + +RFC 2616 HTTP/1.1 June 1999 + + + OCTET = + CHAR = + UPALPHA = + LOALPHA = + ALPHA = UPALPHA | LOALPHA + DIGIT = + CTL = + CR = + LF = + SP = + HT = + <"> = + + HTTP/1.1 defines the sequence CR LF as the end-of-line marker for all + protocol elements except the entity-body (see appendix 19.3 for + tolerant applications). The end-of-line marker within an entity-body + is defined by its associated media type, as described in section 3.7. + + CRLF = CR LF + + HTTP/1.1 header field values can be folded onto multiple lines if the + continuation line begins with a space or horizontal tab. All linear + white space, including folding, has the same semantics as SP. A + recipient MAY replace any linear white space with a single SP before + interpreting the field value or forwarding the message downstream. + + LWS = [CRLF] 1*( SP | HT ) + + The TEXT rule is only used for descriptive field contents and values + that are not intended to be interpreted by the message parser. Words + of *TEXT MAY contain characters from character sets other than ISO- + 8859-1 [22] only when encoded according to the rules of RFC 2047 + [14]. + + TEXT = + + A CRLF is allowed in the definition of TEXT only as part of a header + field continuation. It is expected that the folding LWS will be + replaced with a single SP before interpretation of the TEXT value. + + Hexadecimal numeric characters are used in several protocol elements. + + HEX = "A" | "B" | "C" | "D" | "E" | "F" + | "a" | "b" | "c" | "d" | "e" | "f" | DIGIT + + + + + +Fielding, et al. Standards Track [Page 16] + +RFC 2616 HTTP/1.1 June 1999 + + + Many HTTP/1.1 header field values consist of words separated by LWS + or special characters. These special characters MUST be in a quoted + string to be used within a parameter value (as defined in section + 3.6). + + token = 1* + separators = "(" | ")" | "<" | ">" | "@" + | "," | ";" | ":" | "\" | <"> + | "/" | "[" | "]" | "?" | "=" + | "{" | "}" | SP | HT + + Comments can be included in some HTTP header fields by surrounding + the comment text with parentheses. Comments are only allowed in + fields containing "comment" as part of their field value definition. + In all other fields, parentheses are considered part of the field + value. + + comment = "(" *( ctext | quoted-pair | comment ) ")" + ctext = + + A string of text is parsed as a single word if it is quoted using + double-quote marks. + + quoted-string = ( <"> *(qdtext | quoted-pair ) <"> ) + qdtext = > + + The backslash character ("\") MAY be used as a single-character + quoting mechanism only within quoted-string and comment constructs. + + quoted-pair = "\" CHAR + +3 Protocol Parameters + +3.1 HTTP Version + + HTTP uses a "." numbering scheme to indicate versions + of the protocol. The protocol versioning policy is intended to allow + the sender to indicate the format of a message and its capacity for + understanding further HTTP communication, rather than the features + obtained via that communication. No change is made to the version + number for the addition of message components which do not affect + communication behavior or which only add to extensible field values. + The number is incremented when the changes made to the + protocol add features which do not change the general message parsing + algorithm, but which may add to the message semantics and imply + additional capabilities of the sender. The number is + incremented when the format of a message within the protocol is + changed. See RFC 2145 [36] for a fuller explanation. + + + +Fielding, et al. Standards Track [Page 17] + +RFC 2616 HTTP/1.1 June 1999 + + + The version of an HTTP message is indicated by an HTTP-Version field + in the first line of the message. + + HTTP-Version = "HTTP" "/" 1*DIGIT "." 1*DIGIT + + Note that the major and minor numbers MUST be treated as separate + integers and that each MAY be incremented higher than a single digit. + Thus, HTTP/2.4 is a lower version than HTTP/2.13, which in turn is + lower than HTTP/12.3. Leading zeros MUST be ignored by recipients and + MUST NOT be sent. + + An application that sends a request or response message that includes + HTTP-Version of "HTTP/1.1" MUST be at least conditionally compliant + with this specification. Applications that are at least conditionally + compliant with this specification SHOULD use an HTTP-Version of + "HTTP/1.1" in their messages, and MUST do so for any message that is + not compatible with HTTP/1.0. For more details on when to send + specific HTTP-Version values, see RFC 2145 [36]. + + The HTTP version of an application is the highest HTTP version for + which the application is at least conditionally compliant. + + Proxy and gateway applications need to be careful when forwarding + messages in protocol versions different from that of the application. + Since the protocol version indicates the protocol capability of the + sender, a proxy/gateway MUST NOT send a message with a version + indicator which is greater than its actual version. If a higher + version request is received, the proxy/gateway MUST either downgrade + the request version, or respond with an error, or switch to tunnel + behavior. + + Due to interoperability problems with HTTP/1.0 proxies discovered + since the publication of RFC 2068[33], caching proxies MUST, gateways + MAY, and tunnels MUST NOT upgrade the request to the highest version + they support. The proxy/gateway's response to that request MUST be in + the same major version as the request. + + Note: Converting between versions of HTTP may involve modification + of header fields required or forbidden by the versions involved. + +3.2 Uniform Resource Identifiers + + URIs have been known by many names: WWW addresses, Universal Document + Identifiers, Universal Resource Identifiers [3], and finally the + combination of Uniform Resource Locators (URL) [4] and Names (URN) + [20]. As far as HTTP is concerned, Uniform Resource Identifiers are + simply formatted strings which identify--via name, location, or any + other characteristic--a resource. + + + +Fielding, et al. Standards Track [Page 18] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.1 General Syntax + + URIs in HTTP can be represented in absolute form or relative to some + known base URI [11], depending upon the context of their use. The two + forms are differentiated by the fact that absolute URIs always begin + with a scheme name followed by a colon. For definitive information on + URL syntax and semantics, see "Uniform Resource Identifiers (URI): + Generic Syntax and Semantics," RFC 2396 [42] (which replaces RFCs + 1738 [4] and RFC 1808 [11]). This specification adopts the + definitions of "URI-reference", "absoluteURI", "relativeURI", "port", + "host","abs_path", "rel_path", and "authority" from that + specification. + + The HTTP protocol does not place any a priori limit on the length of + a URI. Servers MUST be able to handle the URI of any resource they + serve, and SHOULD be able to handle URIs of unbounded length if they + provide GET-based forms that could generate such URIs. A server + SHOULD return 414 (Request-URI Too Long) status if a URI is longer + than the server can handle (see section 10.4.15). + + Note: Servers ought to be cautious about depending on URI lengths + above 255 bytes, because some older client or proxy + implementations might not properly support these lengths. + +3.2.2 http URL + + The "http" scheme is used to locate network resources via the HTTP + protocol. This section defines the scheme-specific syntax and + semantics for http URLs. + + http_URL = "http:" "//" host [ ":" port ] [ abs_path [ "?" query ]] + + If the port is empty or not given, port 80 is assumed. The semantics + are that the identified resource is located at the server listening + for TCP connections on that port of that host, and the Request-URI + for the resource is abs_path (section 5.1.2). The use of IP addresses + in URLs SHOULD be avoided whenever possible (see RFC 1900 [24]). If + the abs_path is not present in the URL, it MUST be given as "/" when + used as a Request-URI for a resource (section 5.1.2). If a proxy + receives a host name which is not a fully qualified domain name, it + MAY add its domain to the host name it received. If a proxy receives + a fully qualified domain name, the proxy MUST NOT change the host + name. + + + + + + + + +Fielding, et al. Standards Track [Page 19] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.3 URI Comparison + + When comparing two URIs to decide if they match or not, a client + SHOULD use a case-sensitive octet-by-octet comparison of the entire + URIs, with these exceptions: + + - A port that is empty or not given is equivalent to the default + port for that URI-reference; + + - Comparisons of host names MUST be case-insensitive; + + - Comparisons of scheme names MUST be case-insensitive; + + - An empty abs_path is equivalent to an abs_path of "/". + + Characters other than those in the "reserved" and "unsafe" sets (see + RFC 2396 [42]) are equivalent to their ""%" HEX HEX" encoding. + + For example, the following three URIs are equivalent: + + http://abc.com:80/~smith/home.html + http://ABC.com/%7Esmith/home.html + http://ABC.com:/%7esmith/home.html + +3.3 Date/Time Formats + +3.3.1 Full Date + + HTTP applications have historically allowed three different formats + for the representation of date/time stamps: + + Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123 + Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036 + Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format + + The first format is preferred as an Internet standard and represents + a fixed-length subset of that defined by RFC 1123 [8] (an update to + RFC 822 [9]). The second format is in common use, but is based on the + obsolete RFC 850 [12] date format and lacks a four-digit year. + HTTP/1.1 clients and servers that parse the date value MUST accept + all three formats (for compatibility with HTTP/1.0), though they MUST + only generate the RFC 1123 format for representing HTTP-date values + in header fields. See section 19.3 for further information. + + Note: Recipients of date values are encouraged to be robust in + accepting date values that may have been sent by non-HTTP + applications, as is sometimes the case when retrieving or posting + messages via proxies/gateways to SMTP or NNTP. + + + +Fielding, et al. Standards Track [Page 20] + +RFC 2616 HTTP/1.1 June 1999 + + + All HTTP date/time stamps MUST be represented in Greenwich Mean Time + (GMT), without exception. For the purposes of HTTP, GMT is exactly + equal to UTC (Coordinated Universal Time). This is indicated in the + first two formats by the inclusion of "GMT" as the three-letter + abbreviation for time zone, and MUST be assumed when reading the + asctime format. HTTP-date is case sensitive and MUST NOT include + additional LWS beyond that specifically included as SP in the + grammar. + + HTTP-date = rfc1123-date | rfc850-date | asctime-date + rfc1123-date = wkday "," SP date1 SP time SP "GMT" + rfc850-date = weekday "," SP date2 SP time SP "GMT" + asctime-date = wkday SP date3 SP time SP 4DIGIT + date1 = 2DIGIT SP month SP 4DIGIT + ; day month year (e.g., 02 Jun 1982) + date2 = 2DIGIT "-" month "-" 2DIGIT + ; day-month-year (e.g., 02-Jun-82) + date3 = month SP ( 2DIGIT | ( SP 1DIGIT )) + ; month day (e.g., Jun 2) + time = 2DIGIT ":" 2DIGIT ":" 2DIGIT + ; 00:00:00 - 23:59:59 + wkday = "Mon" | "Tue" | "Wed" + | "Thu" | "Fri" | "Sat" | "Sun" + weekday = "Monday" | "Tuesday" | "Wednesday" + | "Thursday" | "Friday" | "Saturday" | "Sunday" + month = "Jan" | "Feb" | "Mar" | "Apr" + | "May" | "Jun" | "Jul" | "Aug" + | "Sep" | "Oct" | "Nov" | "Dec" + + Note: HTTP requirements for the date/time stamp format apply only + to their usage within the protocol stream. Clients and servers are + not required to use these formats for user presentation, request + logging, etc. + +3.3.2 Delta Seconds + + Some HTTP header fields allow a time value to be specified as an + integer number of seconds, represented in decimal, after the time + that the message was received. + + delta-seconds = 1*DIGIT + +3.4 Character Sets + + HTTP uses the same definition of the term "character set" as that + described for MIME: + + + + + +Fielding, et al. Standards Track [Page 21] + +RFC 2616 HTTP/1.1 June 1999 + + + The term "character set" is used in this document to refer to a + method used with one or more tables to convert a sequence of octets + into a sequence of characters. Note that unconditional conversion in + the other direction is not required, in that not all characters may + be available in a given character set and a character set may provide + more than one sequence of octets to represent a particular character. + This definition is intended to allow various kinds of character + encoding, from simple single-table mappings such as US-ASCII to + complex table switching methods such as those that use ISO-2022's + techniques. However, the definition associated with a MIME character + set name MUST fully specify the mapping to be performed from octets + to characters. In particular, use of external profiling information + to determine the exact mapping is not permitted. + + Note: This use of the term "character set" is more commonly + referred to as a "character encoding." However, since HTTP and + MIME share the same registry, it is important that the terminology + also be shared. + + HTTP character sets are identified by case-insensitive tokens. The + complete set of tokens is defined by the IANA Character Set registry + [19]. + + charset = token + + Although HTTP allows an arbitrary token to be used as a charset + value, any token that has a predefined value within the IANA + Character Set registry [19] MUST represent the character set defined + by that registry. Applications SHOULD limit their use of character + sets to those defined by the IANA registry. + + Implementors should be aware of IETF character set requirements [38] + [41]. + +3.4.1 Missing Charset + + Some HTTP/1.0 software has interpreted a Content-Type header without + charset parameter incorrectly to mean "recipient should guess." + Senders wishing to defeat this behavior MAY include a charset + parameter even when the charset is ISO-8859-1 and SHOULD do so when + it is known that it will not confuse the recipient. + + Unfortunately, some older HTTP/1.0 clients did not deal properly with + an explicit charset parameter. HTTP/1.1 recipients MUST respect the + charset label provided by the sender; and those user agents that have + a provision to "guess" a charset MUST use the charset from the + + + + + +Fielding, et al. Standards Track [Page 22] + +RFC 2616 HTTP/1.1 June 1999 + + + content-type field if they support that charset, rather than the + recipient's preference, when initially displaying a document. See + section 3.7.1. + +3.5 Content Codings + + Content coding values indicate an encoding transformation that has + been or can be applied to an entity. Content codings are primarily + used to allow a document to be compressed or otherwise usefully + transformed without losing the identity of its underlying media type + and without loss of information. Frequently, the entity is stored in + coded form, transmitted directly, and only decoded by the recipient. + + content-coding = token + + All content-coding values are case-insensitive. HTTP/1.1 uses + content-coding values in the Accept-Encoding (section 14.3) and + Content-Encoding (section 14.11) header fields. Although the value + describes the content-coding, what is more important is that it + indicates what decoding mechanism will be required to remove the + encoding. + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + content-coding value tokens. Initially, the registry contains the + following tokens: + + gzip An encoding format produced by the file compression program + "gzip" (GNU zip) as described in RFC 1952 [25]. This format is a + Lempel-Ziv coding (LZ77) with a 32 bit CRC. + + compress + The encoding format produced by the common UNIX file compression + program "compress". This format is an adaptive Lempel-Ziv-Welch + coding (LZW). + + Use of program names for the identification of encoding formats + is not desirable and is discouraged for future encodings. Their + use here is representative of historical practice, not good + design. For compatibility with previous implementations of HTTP, + applications SHOULD consider "x-gzip" and "x-compress" to be + equivalent to "gzip" and "compress" respectively. + + deflate + The "zlib" format defined in RFC 1950 [31] in combination with + the "deflate" compression mechanism described in RFC 1951 [29]. + + + + + + +Fielding, et al. Standards Track [Page 23] + +RFC 2616 HTTP/1.1 June 1999 + + + identity + The default (identity) encoding; the use of no transformation + whatsoever. This content-coding is used only in the Accept- + Encoding header, and SHOULD NOT be used in the Content-Encoding + header. + + New content-coding value tokens SHOULD be registered; to allow + interoperability between clients and servers, specifications of the + content coding algorithms needed to implement a new value SHOULD be + publicly available and adequate for independent implementation, and + conform to the purpose of content coding defined in this section. + +3.6 Transfer Codings + + Transfer-coding values are used to indicate an encoding + transformation that has been, can be, or may need to be applied to an + entity-body in order to ensure "safe transport" through the network. + This differs from a content coding in that the transfer-coding is a + property of the message, not of the original entity. + + transfer-coding = "chunked" | transfer-extension + transfer-extension = token *( ";" parameter ) + + Parameters are in the form of attribute/value pairs. + + parameter = attribute "=" value + attribute = token + value = token | quoted-string + + All transfer-coding values are case-insensitive. HTTP/1.1 uses + transfer-coding values in the TE header field (section 14.39) and in + the Transfer-Encoding header field (section 14.41). + + Whenever a transfer-coding is applied to a message-body, the set of + transfer-codings MUST include "chunked", unless the message is + terminated by closing the connection. When the "chunked" transfer- + coding is used, it MUST be the last transfer-coding applied to the + message-body. The "chunked" transfer-coding MUST NOT be applied more + than once to a message-body. These rules allow the recipient to + determine the transfer-length of the message (section 4.4). + + Transfer-codings are analogous to the Content-Transfer-Encoding + values of MIME [7], which were designed to enable safe transport of + binary data over a 7-bit transport service. However, safe transport + has a different focus for an 8bit-clean transfer protocol. In HTTP, + the only unsafe characteristic of message-bodies is the difficulty in + determining the exact body length (section 7.2.2), or the desire to + encrypt data over a shared transport. + + + +Fielding, et al. Standards Track [Page 24] + +RFC 2616 HTTP/1.1 June 1999 + + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + transfer-coding value tokens. Initially, the registry contains the + following tokens: "chunked" (section 3.6.1), "identity" (section + 3.6.2), "gzip" (section 3.5), "compress" (section 3.5), and "deflate" + (section 3.5). + + New transfer-coding value tokens SHOULD be registered in the same way + as new content-coding value tokens (section 3.5). + + A server which receives an entity-body with a transfer-coding it does + not understand SHOULD return 501 (Unimplemented), and close the + connection. A server MUST NOT send transfer-codings to an HTTP/1.0 + client. + +3.6.1 Chunked Transfer Coding + + The chunked encoding modifies the body of a message in order to + transfer it as a series of chunks, each with its own size indicator, + followed by an OPTIONAL trailer containing entity-header fields. This + allows dynamically produced content to be transferred along with the + information necessary for the recipient to verify that it has + received the full message. + + Chunked-Body = *chunk + last-chunk + trailer + CRLF + + chunk = chunk-size [ chunk-extension ] CRLF + chunk-data CRLF + chunk-size = 1*HEX + last-chunk = 1*("0") [ chunk-extension ] CRLF + + chunk-extension= *( ";" chunk-ext-name [ "=" chunk-ext-val ] ) + chunk-ext-name = token + chunk-ext-val = token | quoted-string + chunk-data = chunk-size(OCTET) + trailer = *(entity-header CRLF) + + The chunk-size field is a string of hex digits indicating the size of + the chunk. The chunked encoding is ended by any chunk whose size is + zero, followed by the trailer, which is terminated by an empty line. + + The trailer allows the sender to include additional HTTP header + fields at the end of the message. The Trailer header field can be + used to indicate which header fields are included in a trailer (see + section 14.40). + + + + +Fielding, et al. Standards Track [Page 25] + +RFC 2616 HTTP/1.1 June 1999 + + + A server using chunked transfer-coding in a response MUST NOT use the + trailer for any header fields unless at least one of the following is + true: + + a)the request included a TE header field that indicates "trailers" is + acceptable in the transfer-coding of the response, as described in + section 14.39; or, + + b)the server is the origin server for the response, the trailer + fields consist entirely of optional metadata, and the recipient + could use the message (in a manner acceptable to the origin server) + without receiving this metadata. In other words, the origin server + is willing to accept the possibility that the trailer fields might + be silently discarded along the path to the client. + + This requirement prevents an interoperability failure when the + message is being received by an HTTP/1.1 (or later) proxy and + forwarded to an HTTP/1.0 recipient. It avoids a situation where + compliance with the protocol would have necessitated a possibly + infinite buffer on the proxy. + + An example process for decoding a Chunked-Body is presented in + appendix 19.4.6. + + All HTTP/1.1 applications MUST be able to receive and decode the + "chunked" transfer-coding, and MUST ignore chunk-extension extensions + they do not understand. + +3.7 Media Types + + HTTP uses Internet Media Types [17] in the Content-Type (section + 14.17) and Accept (section 14.1) header fields in order to provide + open and extensible data typing and type negotiation. + + media-type = type "/" subtype *( ";" parameter ) + type = token + subtype = token + + Parameters MAY follow the type/subtype in the form of attribute/value + pairs (as defined in section 3.6). + + The type, subtype, and parameter attribute names are case- + insensitive. Parameter values might or might not be case-sensitive, + depending on the semantics of the parameter name. Linear white space + (LWS) MUST NOT be used between the type and subtype, nor between an + attribute and its value. The presence or absence of a parameter might + be significant to the processing of a media-type, depending on its + definition within the media type registry. + + + +Fielding, et al. Standards Track [Page 26] + +RFC 2616 HTTP/1.1 June 1999 + + + Note that some older HTTP applications do not recognize media type + parameters. When sending data to older HTTP applications, + implementations SHOULD only use media type parameters when they are + required by that type/subtype definition. + + Media-type values are registered with the Internet Assigned Number + Authority (IANA [19]). The media type registration process is + outlined in RFC 1590 [17]. Use of non-registered media types is + discouraged. + +3.7.1 Canonicalization and Text Defaults + + Internet media types are registered with a canonical form. An + entity-body transferred via HTTP messages MUST be represented in the + appropriate canonical form prior to its transmission except for + "text" types, as defined in the next paragraph. + + When in canonical form, media subtypes of the "text" type use CRLF as + the text line break. HTTP relaxes this requirement and allows the + transport of text media with plain CR or LF alone representing a line + break when it is done consistently for an entire entity-body. HTTP + applications MUST accept CRLF, bare CR, and bare LF as being + representative of a line break in text media received via HTTP. In + addition, if the text is represented in a character set that does not + use octets 13 and 10 for CR and LF respectively, as is the case for + some multi-byte character sets, HTTP allows the use of whatever octet + sequences are defined by that character set to represent the + equivalent of CR and LF for line breaks. This flexibility regarding + line breaks applies only to text media in the entity-body; a bare CR + or LF MUST NOT be substituted for CRLF within any of the HTTP control + structures (such as header fields and multipart boundaries). + + If an entity-body is encoded with a content-coding, the underlying + data MUST be in a form defined above prior to being encoded. + + The "charset" parameter is used with some media types to define the + character set (section 3.4) of the data. When no explicit charset + parameter is provided by the sender, media subtypes of the "text" + type are defined to have a default charset value of "ISO-8859-1" when + received via HTTP. Data in character sets other than "ISO-8859-1" or + its subsets MUST be labeled with an appropriate charset value. See + section 3.4.1 for compatibility problems. + +3.7.2 Multipart Types + + MIME provides for a number of "multipart" types -- encapsulations of + one or more entities within a single message-body. All multipart + types share a common syntax, as defined in section 5.1.1 of RFC 2046 + + + +Fielding, et al. Standards Track [Page 27] + +RFC 2616 HTTP/1.1 June 1999 + + + [40], and MUST include a boundary parameter as part of the media type + value. The message body is itself a protocol element and MUST + therefore use only CRLF to represent line breaks between body-parts. + Unlike in RFC 2046, the epilogue of any multipart message MUST be + empty; HTTP applications MUST NOT transmit the epilogue (even if the + original multipart contains an epilogue). These restrictions exist in + order to preserve the self-delimiting nature of a multipart message- + body, wherein the "end" of the message-body is indicated by the + ending multipart boundary. + + In general, HTTP treats a multipart message-body no differently than + any other media type: strictly as payload. The one exception is the + "multipart/byteranges" type (appendix 19.2) when it appears in a 206 + (Partial Content) response, which will be interpreted by some HTTP + caching mechanisms as described in sections 13.5.4 and 14.16. In all + other cases, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + The MIME header fields within each body-part of a multipart message- + body do not have any significance to HTTP beyond that defined by + their MIME semantics. + + In general, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + If an application receives an unrecognized multipart subtype, the + application MUST treat it as being equivalent to "multipart/mixed". + + Note: The "multipart/form-data" type has been specifically defined + for carrying form data suitable for processing via the POST + request method, as described in RFC 1867 [15]. + +3.8 Product Tokens + + Product tokens are used to allow communicating applications to + identify themselves by software name and version. Most fields using + product tokens also allow sub-products which form a significant part + of the application to be listed, separated by white space. By + convention, the products are listed in order of their significance + for identifying the application. + + product = token ["/" product-version] + product-version = token + + Examples: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + Server: Apache/0.8.4 + + + + + +Fielding, et al. Standards Track [Page 28] + +RFC 2616 HTTP/1.1 June 1999 + + + Product tokens SHOULD be short and to the point. They MUST NOT be + used for advertising or other non-essential information. Although any + token character MAY appear in a product-version, this token SHOULD + only be used for a version identifier (i.e., successive versions of + the same product SHOULD only differ in the product-version portion of + the product value). + +3.9 Quality Values + + HTTP content negotiation (section 12) uses short "floating point" + numbers to indicate the relative importance ("weight") of various + negotiable parameters. A weight is normalized to a real number in + the range 0 through 1, where 0 is the minimum and 1 the maximum + value. If a parameter has a quality value of 0, then content with + this parameter is `not acceptable' for the client. HTTP/1.1 + applications MUST NOT generate more than three digits after the + decimal point. User configuration of these values SHOULD also be + limited in this fashion. + + qvalue = ( "0" [ "." 0*3DIGIT ] ) + | ( "1" [ "." 0*3("0") ] ) + + "Quality values" is a misnomer, since these values merely represent + relative degradation in desired quality. + +3.10 Language Tags + + A language tag identifies a natural language spoken, written, or + otherwise conveyed by human beings for communication of information + to other human beings. Computer languages are explicitly excluded. + HTTP uses language tags within the Accept-Language and Content- + Language fields. + + The syntax and registry of HTTP language tags is the same as that + defined by RFC 1766 [1]. In summary, a language tag is composed of 1 + or more parts: A primary language tag and a possibly empty series of + subtags: + + language-tag = primary-tag *( "-" subtag ) + primary-tag = 1*8ALPHA + subtag = 1*8ALPHA + + White space is not allowed within the tag and all tags are case- + insensitive. The name space of language tags is administered by the + IANA. Example tags include: + + en, en-US, en-cockney, i-cherokee, x-pig-latin + + + + +Fielding, et al. Standards Track [Page 29] + +RFC 2616 HTTP/1.1 June 1999 + + + where any two-letter primary-tag is an ISO-639 language abbreviation + and any two-letter initial subtag is an ISO-3166 country code. (The + last three tags above are not registered tags; all but the last are + examples of tags which could be registered in future.) + +3.11 Entity Tags + + Entity tags are used for comparing two or more entities from the same + requested resource. HTTP/1.1 uses entity tags in the ETag (section + 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and + If-Range (section 14.27) header fields. The definition of how they + are used and compared as cache validators is in section 13.3.3. An + entity tag consists of an opaque quoted string, possibly prefixed by + a weakness indicator. + + entity-tag = [ weak ] opaque-tag + weak = "W/" + opaque-tag = quoted-string + + A "strong entity tag" MAY be shared by two entities of a resource + only if they are equivalent by octet equality. + + A "weak entity tag," indicated by the "W/" prefix, MAY be shared by + two entities of a resource only if the entities are equivalent and + could be substituted for each other with no significant change in + semantics. A weak entity tag can only be used for weak comparison. + + An entity tag MUST be unique across all versions of all entities + associated with a particular resource. A given entity tag value MAY + be used for entities obtained by requests on different URIs. The use + of the same entity tag value in conjunction with entities obtained by + requests on different URIs does not imply the equivalence of those + entities. + +3.12 Range Units + + HTTP/1.1 allows a client to request that only part (a range of) the + response entity be included within the response. HTTP/1.1 uses range + units in the Range (section 14.35) and Content-Range (section 14.16) + header fields. An entity can be broken down into subranges according + to various structural units. + + range-unit = bytes-unit | other-range-unit + bytes-unit = "bytes" + other-range-unit = token + + The only range unit defined by HTTP/1.1 is "bytes". HTTP/1.1 + implementations MAY ignore ranges specified using other units. + + + +Fielding, et al. Standards Track [Page 30] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 has been designed to allow implementations of applications + that do not depend on knowledge of ranges. + +4 HTTP Message + +4.1 Message Types + + HTTP messages consist of requests from client to server and responses + from server to client. + + HTTP-message = Request | Response ; HTTP/1.1 messages + + Request (section 5) and Response (section 6) messages use the generic + message format of RFC 822 [9] for transferring entities (the payload + of the message). Both types of message consist of a start-line, zero + or more header fields (also known as "headers"), an empty line (i.e., + a line with nothing preceding the CRLF) indicating the end of the + header fields, and possibly a message-body. + + generic-message = start-line + *(message-header CRLF) + CRLF + [ message-body ] + start-line = Request-Line | Status-Line + + In the interest of robustness, servers SHOULD ignore any empty + line(s) received where a Request-Line is expected. In other words, if + the server is reading the protocol stream at the beginning of a + message and receives a CRLF first, it should ignore the CRLF. + + Certain buggy HTTP/1.0 client implementations generate extra CRLF's + after a POST request. To restate what is explicitly forbidden by the + BNF, an HTTP/1.1 client MUST NOT preface or follow a request with an + extra CRLF. + +4.2 Message Headers + + HTTP header fields, which include general-header (section 4.5), + request-header (section 5.3), response-header (section 6.2), and + entity-header (section 7.1) fields, follow the same generic format as + that given in Section 3.1 of RFC 822 [9]. Each header field consists + of a name followed by a colon (":") and the field value. Field names + are case-insensitive. The field value MAY be preceded by any amount + of LWS, though a single SP is preferred. Header fields can be + extended over multiple lines by preceding each extra line with at + least one SP or HT. Applications ought to follow "common form", where + one is known or indicated, when generating HTTP constructs, since + there might exist some implementations that fail to accept anything + + + +Fielding, et al. Standards Track [Page 31] + +RFC 2616 HTTP/1.1 June 1999 + + + beyond the common forms. + + message-header = field-name ":" [ field-value ] + field-name = token + field-value = *( field-content | LWS ) + field-content = + + The field-content does not include any leading or trailing LWS: + linear white space occurring before the first non-whitespace + character of the field-value or after the last non-whitespace + character of the field-value. Such leading or trailing LWS MAY be + removed without changing the semantics of the field value. Any LWS + that occurs between field-content MAY be replaced with a single SP + before interpreting the field value or forwarding the message + downstream. + + The order in which header fields with differing field names are + received is not significant. However, it is "good practice" to send + general-header fields first, followed by request-header or response- + header fields, and ending with the entity-header fields. + + Multiple message-header fields with the same field-name MAY be + present in a message if and only if the entire field-value for that + header field is defined as a comma-separated list [i.e., #(values)]. + It MUST be possible to combine the multiple header fields into one + "field-name: field-value" pair, without changing the semantics of the + message, by appending each subsequent field-value to the first, each + separated by a comma. The order in which header fields with the same + field-name are received is therefore significant to the + interpretation of the combined field value, and thus a proxy MUST NOT + change the order of these field values when a message is forwarded. + +4.3 Message Body + + The message-body (if any) of an HTTP message is used to carry the + entity-body associated with the request or response. The message-body + differs from the entity-body only when a transfer-coding has been + applied, as indicated by the Transfer-Encoding header field (section + 14.41). + + message-body = entity-body + | + + Transfer-Encoding MUST be used to indicate any transfer-codings + applied by an application to ensure safe and proper transfer of the + message. Transfer-Encoding is a property of the message, not of the + + + +Fielding, et al. Standards Track [Page 32] + +RFC 2616 HTTP/1.1 June 1999 + + + entity, and thus MAY be added or removed by any application along the + request/response chain. (However, section 3.6 places restrictions on + when certain transfer-codings may be used.) + + The rules for when a message-body is allowed in a message differ for + requests and responses. + + The presence of a message-body in a request is signaled by the + inclusion of a Content-Length or Transfer-Encoding header field in + the request's message-headers. A message-body MUST NOT be included in + a request if the specification of the request method (section 5.1.1) + does not allow sending an entity-body in requests. A server SHOULD + read and forward a message-body on any request; if the request method + does not include defined semantics for an entity-body, then the + message-body SHOULD be ignored when handling the request. + + For response messages, whether or not a message-body is included with + a message is dependent on both the request method and the response + status code (section 6.1.1). All responses to the HEAD request method + MUST NOT include a message-body, even though the presence of entity- + header fields might lead one to believe they do. All 1xx + (informational), 204 (no content), and 304 (not modified) responses + MUST NOT include a message-body. All other responses do include a + message-body, although it MAY be of zero length. + +4.4 Message Length + + The transfer-length of a message is the length of the message-body as + it appears in the message; that is, after any transfer-codings have + been applied. When a message-body is included with a message, the + transfer-length of that body is determined by one of the following + (in order of precedence): + + 1.Any response message which "MUST NOT" include a message-body (such + as the 1xx, 204, and 304 responses and any response to a HEAD + request) is always terminated by the first empty line after the + header fields, regardless of the entity-header fields present in + the message. + + 2.If a Transfer-Encoding header field (section 14.41) is present and + has any value other than "identity", then the transfer-length is + defined by use of the "chunked" transfer-coding (section 3.6), + unless the message is terminated by closing the connection. + + 3.If a Content-Length header field (section 14.13) is present, its + decimal value in OCTETs represents both the entity-length and the + transfer-length. The Content-Length header field MUST NOT be sent + if these two lengths are different (i.e., if a Transfer-Encoding + + + +Fielding, et al. Standards Track [Page 33] + +RFC 2616 HTTP/1.1 June 1999 + + + header field is present). If a message is received with both a + Transfer-Encoding header field and a Content-Length header field, + the latter MUST be ignored. + + 4.If the message uses the media type "multipart/byteranges", and the + ransfer-length is not otherwise specified, then this self- + elimiting media type defines the transfer-length. This media type + UST NOT be used unless the sender knows that the recipient can arse + it; the presence in a request of a Range header with ultiple byte- + range specifiers from a 1.1 client implies that the lient can parse + multipart/byteranges responses. + + A range header might be forwarded by a 1.0 proxy that does not + understand multipart/byteranges; in this case the server MUST + delimit the message using methods defined in items 1,3 or 5 of + this section. + + 5.By the server closing the connection. (Closing the connection + cannot be used to indicate the end of a request body, since that + would leave no possibility for the server to send back a response.) + + For compatibility with HTTP/1.0 applications, HTTP/1.1 requests + containing a message-body MUST include a valid Content-Length header + field unless the server is known to be HTTP/1.1 compliant. If a + request contains a message-body and a Content-Length is not given, + the server SHOULD respond with 400 (bad request) if it cannot + determine the length of the message, or with 411 (length required) if + it wishes to insist on receiving a valid Content-Length. + + All HTTP/1.1 applications that receive entities MUST accept the + "chunked" transfer-coding (section 3.6), thus allowing this mechanism + to be used for messages when the message length cannot be determined + in advance. + + Messages MUST NOT include both a Content-Length header field and a + non-identity transfer-coding. If the message does include a non- + identity transfer-coding, the Content-Length MUST be ignored. + + When a Content-Length is given in a message where a message-body is + allowed, its field value MUST exactly match the number of OCTETs in + the message-body. HTTP/1.1 user agents MUST notify the user when an + invalid length is received and detected. + +4.5 General Header Fields + + There are a few header fields which have general applicability for + both request and response messages, but which do not apply to the + entity being transferred. These header fields apply only to the + + + +Fielding, et al. Standards Track [Page 34] + +RFC 2616 HTTP/1.1 June 1999 + + + message being transmitted. + + general-header = Cache-Control ; Section 14.9 + | Connection ; Section 14.10 + | Date ; Section 14.18 + | Pragma ; Section 14.32 + | Trailer ; Section 14.40 + | Transfer-Encoding ; Section 14.41 + | Upgrade ; Section 14.42 + | Via ; Section 14.45 + | Warning ; Section 14.46 + + General-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields may be given the semantics of general + header fields if all parties in the communication recognize them to + be general-header fields. Unrecognized header fields are treated as + entity-header fields. + +5 Request + + A request message from a client to a server includes, within the + first line of that message, the method to be applied to the resource, + the identifier of the resource, and the protocol version in use. + + Request = Request-Line ; Section 5.1 + *(( general-header ; Section 4.5 + | request-header ; Section 5.3 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 4.3 + +5.1 Request-Line + + The Request-Line begins with a method token, followed by the + Request-URI and the protocol version, and ending with CRLF. The + elements are separated by SP characters. No CR or LF is allowed + except in the final CRLF sequence. + + Request-Line = Method SP Request-URI SP HTTP-Version CRLF + + + + + + + + + + + +Fielding, et al. Standards Track [Page 35] + +RFC 2616 HTTP/1.1 June 1999 + + +5.1.1 Method + + The Method token indicates the method to be performed on the + resource identified by the Request-URI. The method is case-sensitive. + + Method = "OPTIONS" ; Section 9.2 + | "GET" ; Section 9.3 + | "HEAD" ; Section 9.4 + | "POST" ; Section 9.5 + | "PUT" ; Section 9.6 + | "DELETE" ; Section 9.7 + | "TRACE" ; Section 9.8 + | "CONNECT" ; Section 9.9 + | extension-method + extension-method = token + + The list of methods allowed by a resource can be specified in an + Allow header field (section 14.7). The return code of the response + always notifies the client whether a method is currently allowed on a + resource, since the set of allowed methods can change dynamically. An + origin server SHOULD return the status code 405 (Method Not Allowed) + if the method is known by the origin server but not allowed for the + requested resource, and 501 (Not Implemented) if the method is + unrecognized or not implemented by the origin server. The methods GET + and HEAD MUST be supported by all general-purpose servers. All other + methods are OPTIONAL; however, if the above methods are implemented, + they MUST be implemented with the same semantics as those specified + in section 9. + +5.1.2 Request-URI + + The Request-URI is a Uniform Resource Identifier (section 3.2) and + identifies the resource upon which to apply the request. + + Request-URI = "*" | absoluteURI | abs_path | authority + + The four options for Request-URI are dependent on the nature of the + request. The asterisk "*" means that the request does not apply to a + particular resource, but to the server itself, and is only allowed + when the method used does not necessarily apply to a resource. One + example would be + + OPTIONS * HTTP/1.1 + + The absoluteURI form is REQUIRED when the request is being made to a + proxy. The proxy is requested to forward the request or service it + from a valid cache, and return the response. Note that the proxy MAY + forward the request on to another proxy or directly to the server + + + +Fielding, et al. Standards Track [Page 36] + +RFC 2616 HTTP/1.1 June 1999 + + + specified by the absoluteURI. In order to avoid request loops, a + proxy MUST be able to recognize all of its server names, including + any aliases, local variations, and the numeric IP address. An example + Request-Line would be: + + GET http://www.w3.org/pub/WWW/TheProject.html HTTP/1.1 + + To allow for transition to absoluteURIs in all requests in future + versions of HTTP, all HTTP/1.1 servers MUST accept the absoluteURI + form in requests, even though HTTP/1.1 clients will only generate + them in requests to proxies. + + The authority form is only used by the CONNECT method (section 9.9). + + The most common form of Request-URI is that used to identify a + resource on an origin server or gateway. In this case the absolute + path of the URI MUST be transmitted (see section 3.2.1, abs_path) as + the Request-URI, and the network location of the URI (authority) MUST + be transmitted in a Host header field. For example, a client wishing + to retrieve the resource above directly from the origin server would + create a TCP connection to port 80 of the host "www.w3.org" and send + the lines: + + GET /pub/WWW/TheProject.html HTTP/1.1 + Host: www.w3.org + + followed by the remainder of the Request. Note that the absolute path + cannot be empty; if none is present in the original URI, it MUST be + given as "/" (the server root). + + The Request-URI is transmitted in the format specified in section + 3.2.1. If the Request-URI is encoded using the "% HEX HEX" encoding + [42], the origin server MUST decode the Request-URI in order to + properly interpret the request. Servers SHOULD respond to invalid + Request-URIs with an appropriate status code. + + A transparent proxy MUST NOT rewrite the "abs_path" part of the + received Request-URI when forwarding it to the next inbound server, + except as noted above to replace a null abs_path with "/". + + Note: The "no rewrite" rule prevents the proxy from changing the + meaning of the request when the origin server is improperly using + a non-reserved URI character for a reserved purpose. Implementors + should be aware that some pre-HTTP/1.1 proxies have been known to + rewrite the Request-URI. + + + + + + +Fielding, et al. Standards Track [Page 37] + +RFC 2616 HTTP/1.1 June 1999 + + +5.2 The Resource Identified by a Request + + The exact resource identified by an Internet request is determined by + examining both the Request-URI and the Host header field. + + An origin server that does not allow resources to differ by the + requested host MAY ignore the Host header field value when + determining the resource identified by an HTTP/1.1 request. (But see + section 19.6.1.1 for other requirements on Host support in HTTP/1.1.) + + An origin server that does differentiate resources based on the host + requested (sometimes referred to as virtual hosts or vanity host + names) MUST use the following rules for determining the requested + resource on an HTTP/1.1 request: + + 1. If Request-URI is an absoluteURI, the host is part of the + Request-URI. Any Host header field value in the request MUST be + ignored. + + 2. If the Request-URI is not an absoluteURI, and the request includes + a Host header field, the host is determined by the Host header + field value. + + 3. If the host as determined by rule 1 or 2 is not a valid host on + the server, the response MUST be a 400 (Bad Request) error message. + + Recipients of an HTTP/1.0 request that lacks a Host header field MAY + attempt to use heuristics (e.g., examination of the URI path for + something unique to a particular host) in order to determine what + exact resource is being requested. + +5.3 Request Header Fields + + The request-header fields allow the client to pass additional + information about the request, and about the client itself, to the + server. These fields act as request modifiers, with semantics + equivalent to the parameters on a programming language method + invocation. + + request-header = Accept ; Section 14.1 + | Accept-Charset ; Section 14.2 + | Accept-Encoding ; Section 14.3 + | Accept-Language ; Section 14.4 + | Authorization ; Section 14.8 + | Expect ; Section 14.20 + | From ; Section 14.22 + | Host ; Section 14.23 + | If-Match ; Section 14.24 + + + +Fielding, et al. Standards Track [Page 38] + +RFC 2616 HTTP/1.1 June 1999 + + + | If-Modified-Since ; Section 14.25 + | If-None-Match ; Section 14.26 + | If-Range ; Section 14.27 + | If-Unmodified-Since ; Section 14.28 + | Max-Forwards ; Section 14.31 + | Proxy-Authorization ; Section 14.34 + | Range ; Section 14.35 + | Referer ; Section 14.36 + | TE ; Section 14.39 + | User-Agent ; Section 14.43 + + Request-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of request- + header fields if all parties in the communication recognize them to + be request-header fields. Unrecognized header fields are treated as + entity-header fields. + +6 Response + + After receiving and interpreting a request message, a server responds + with an HTTP response message. + + Response = Status-Line ; Section 6.1 + *(( general-header ; Section 4.5 + | response-header ; Section 6.2 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 7.2 + +6.1 Status-Line + + The first line of a Response message is the Status-Line, consisting + of the protocol version followed by a numeric status code and its + associated textual phrase, with each element separated by SP + characters. No CR or LF is allowed except in the final CRLF sequence. + + Status-Line = HTTP-Version SP Status-Code SP Reason-Phrase CRLF + +6.1.1 Status Code and Reason Phrase + + The Status-Code element is a 3-digit integer result code of the + attempt to understand and satisfy the request. These codes are fully + defined in section 10. The Reason-Phrase is intended to give a short + textual description of the Status-Code. The Status-Code is intended + for use by automata and the Reason-Phrase is intended for the human + user. The client is not required to examine or display the Reason- + Phrase. + + + +Fielding, et al. Standards Track [Page 39] + +RFC 2616 HTTP/1.1 June 1999 + + + The first digit of the Status-Code defines the class of response. The + last two digits do not have any categorization role. There are 5 + values for the first digit: + + - 1xx: Informational - Request received, continuing process + + - 2xx: Success - The action was successfully received, + understood, and accepted + + - 3xx: Redirection - Further action must be taken in order to + complete the request + + - 4xx: Client Error - The request contains bad syntax or cannot + be fulfilled + + - 5xx: Server Error - The server failed to fulfill an apparently + valid request + + The individual values of the numeric status codes defined for + HTTP/1.1, and an example set of corresponding Reason-Phrase's, are + presented below. The reason phrases listed here are only + recommendations -- they MAY be replaced by local equivalents without + affecting the protocol. + + Status-Code = + "100" ; Section 10.1.1: Continue + | "101" ; Section 10.1.2: Switching Protocols + | "200" ; Section 10.2.1: OK + | "201" ; Section 10.2.2: Created + | "202" ; Section 10.2.3: Accepted + | "203" ; Section 10.2.4: Non-Authoritative Information + | "204" ; Section 10.2.5: No Content + | "205" ; Section 10.2.6: Reset Content + | "206" ; Section 10.2.7: Partial Content + | "300" ; Section 10.3.1: Multiple Choices + | "301" ; Section 10.3.2: Moved Permanently + | "302" ; Section 10.3.3: Found + | "303" ; Section 10.3.4: See Other + | "304" ; Section 10.3.5: Not Modified + | "305" ; Section 10.3.6: Use Proxy + | "307" ; Section 10.3.8: Temporary Redirect + | "400" ; Section 10.4.1: Bad Request + | "401" ; Section 10.4.2: Unauthorized + | "402" ; Section 10.4.3: Payment Required + | "403" ; Section 10.4.4: Forbidden + | "404" ; Section 10.4.5: Not Found + | "405" ; Section 10.4.6: Method Not Allowed + | "406" ; Section 10.4.7: Not Acceptable + + + +Fielding, et al. Standards Track [Page 40] + +RFC 2616 HTTP/1.1 June 1999 + + + | "407" ; Section 10.4.8: Proxy Authentication Required + | "408" ; Section 10.4.9: Request Time-out + | "409" ; Section 10.4.10: Conflict + | "410" ; Section 10.4.11: Gone + | "411" ; Section 10.4.12: Length Required + | "412" ; Section 10.4.13: Precondition Failed + | "413" ; Section 10.4.14: Request Entity Too Large + | "414" ; Section 10.4.15: Request-URI Too Large + | "415" ; Section 10.4.16: Unsupported Media Type + | "416" ; Section 10.4.17: Requested range not satisfiable + | "417" ; Section 10.4.18: Expectation Failed + | "500" ; Section 10.5.1: Internal Server Error + | "501" ; Section 10.5.2: Not Implemented + | "502" ; Section 10.5.3: Bad Gateway + | "503" ; Section 10.5.4: Service Unavailable + | "504" ; Section 10.5.5: Gateway Time-out + | "505" ; Section 10.5.6: HTTP Version not supported + | extension-code + + extension-code = 3DIGIT + Reason-Phrase = * + + HTTP status codes are extensible. HTTP applications are not required + to understand the meaning of all registered status codes, though such + understanding is obviously desirable. However, applications MUST + understand the class of any status code, as indicated by the first + digit, and treat any unrecognized response as being equivalent to the + x00 status code of that class, with the exception that an + unrecognized response MUST NOT be cached. For example, if an + unrecognized status code of 431 is received by the client, it can + safely assume that there was something wrong with its request and + treat the response as if it had received a 400 status code. In such + cases, user agents SHOULD present to the user the entity returned + with the response, since that entity is likely to include human- + readable information which will explain the unusual status. + +6.2 Response Header Fields + + The response-header fields allow the server to pass additional + information about the response which cannot be placed in the Status- + Line. These header fields give information about the server and about + further access to the resource identified by the Request-URI. + + response-header = Accept-Ranges ; Section 14.5 + | Age ; Section 14.6 + | ETag ; Section 14.19 + | Location ; Section 14.30 + | Proxy-Authenticate ; Section 14.33 + + + +Fielding, et al. Standards Track [Page 41] + +RFC 2616 HTTP/1.1 June 1999 + + + | Retry-After ; Section 14.37 + | Server ; Section 14.38 + | Vary ; Section 14.44 + | WWW-Authenticate ; Section 14.47 + + Response-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of response- + header fields if all parties in the communication recognize them to + be response-header fields. Unrecognized header fields are treated as + entity-header fields. + +7 Entity + + Request and Response messages MAY transfer an entity if not otherwise + restricted by the request method or response status code. An entity + consists of entity-header fields and an entity-body, although some + responses will only include the entity-headers. + + In this section, both sender and recipient refer to either the client + or the server, depending on who sends and who receives the entity. + +7.1 Entity Header Fields + + Entity-header fields define metainformation about the entity-body or, + if no body is present, about the resource identified by the request. + Some of this metainformation is OPTIONAL; some might be REQUIRED by + portions of this specification. + + entity-header = Allow ; Section 14.7 + | Content-Encoding ; Section 14.11 + | Content-Language ; Section 14.12 + | Content-Length ; Section 14.13 + | Content-Location ; Section 14.14 + | Content-MD5 ; Section 14.15 + | Content-Range ; Section 14.16 + | Content-Type ; Section 14.17 + | Expires ; Section 14.21 + | Last-Modified ; Section 14.29 + | extension-header + + extension-header = message-header + + The extension-header mechanism allows additional entity-header fields + to be defined without changing the protocol, but these fields cannot + be assumed to be recognizable by the recipient. Unrecognized header + fields SHOULD be ignored by the recipient and MUST be forwarded by + transparent proxies. + + + +Fielding, et al. Standards Track [Page 42] + +RFC 2616 HTTP/1.1 June 1999 + + +7.2 Entity Body + + The entity-body (if any) sent with an HTTP request or response is in + a format and encoding defined by the entity-header fields. + + entity-body = *OCTET + + An entity-body is only present in a message when a message-body is + present, as described in section 4.3. The entity-body is obtained + from the message-body by decoding any Transfer-Encoding that might + have been applied to ensure safe and proper transfer of the message. + +7.2.1 Type + + When an entity-body is included with a message, the data type of that + body is determined via the header fields Content-Type and Content- + Encoding. These define a two-layer, ordered encoding model: + + entity-body := Content-Encoding( Content-Type( data ) ) + + Content-Type specifies the media type of the underlying data. + Content-Encoding may be used to indicate any additional content + codings applied to the data, usually for the purpose of data + compression, that are a property of the requested resource. There is + no default encoding. + + Any HTTP/1.1 message containing an entity-body SHOULD include a + Content-Type header field defining the media type of that body. If + and only if the media type is not given by a Content-Type field, the + recipient MAY attempt to guess the media type via inspection of its + content and/or the name extension(s) of the URI used to identify the + resource. If the media type remains unknown, the recipient SHOULD + treat it as type "application/octet-stream". + +7.2.2 Entity Length + + The entity-length of a message is the length of the message-body + before any transfer-codings have been applied. Section 4.4 defines + how the transfer-length of a message-body is determined. + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 43] + +RFC 2616 HTTP/1.1 June 1999 + + +8 Connections + +8.1 Persistent Connections + +8.1.1 Purpose + + Prior to persistent connections, a separate TCP connection was + established to fetch each URL, increasing the load on HTTP servers + and causing congestion on the Internet. The use of inline images and + other associated data often require a client to make multiple + requests of the same server in a short amount of time. Analysis of + these performance problems and results from a prototype + implementation are available [26] [30]. Implementation experience and + measurements of actual HTTP/1.1 (RFC 2068) implementations show good + results [39]. Alternatives have also been explored, for example, + T/TCP [27]. + + Persistent HTTP connections have a number of advantages: + + - By opening and closing fewer TCP connections, CPU time is saved + in routers and hosts (clients, servers, proxies, gateways, + tunnels, or caches), and memory used for TCP protocol control + blocks can be saved in hosts. + + - HTTP requests and responses can be pipelined on a connection. + Pipelining allows a client to make multiple requests without + waiting for each response, allowing a single TCP connection to + be used much more efficiently, with much lower elapsed time. + + - Network congestion is reduced by reducing the number of packets + caused by TCP opens, and by allowing TCP sufficient time to + determine the congestion state of the network. + + - Latency on subsequent requests is reduced since there is no time + spent in TCP's connection opening handshake. + + - HTTP can evolve more gracefully, since errors can be reported + without the penalty of closing the TCP connection. Clients using + future versions of HTTP might optimistically try a new feature, + but if communicating with an older server, retry with old + semantics after an error is reported. + + HTTP implementations SHOULD implement persistent connections. + + + + + + + + +Fielding, et al. Standards Track [Page 44] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2 Overall Operation + + A significant difference between HTTP/1.1 and earlier versions of + HTTP is that persistent connections are the default behavior of any + HTTP connection. That is, unless otherwise indicated, the client + SHOULD assume that the server will maintain a persistent connection, + even after error responses from the server. + + Persistent connections provide a mechanism by which a client and a + server can signal the close of a TCP connection. This signaling takes + place using the Connection header field (section 14.10). Once a close + has been signaled, the client MUST NOT send any more requests on that + connection. + +8.1.2.1 Negotiation + + An HTTP/1.1 server MAY assume that a HTTP/1.1 client intends to + maintain a persistent connection unless a Connection header including + the connection-token "close" was sent in the request. If the server + chooses to close the connection immediately after sending the + response, it SHOULD send a Connection header including the + connection-token close. + + An HTTP/1.1 client MAY expect a connection to remain open, but would + decide to keep it open based on whether the response from a server + contains a Connection header with the connection-token close. In case + the client does not want to maintain a connection for more than that + request, it SHOULD send a Connection header including the + connection-token close. + + If either the client or the server sends the close token in the + Connection header, that request becomes the last one for the + connection. + + Clients and servers SHOULD NOT assume that a persistent connection is + maintained for HTTP versions less than 1.1 unless it is explicitly + signaled. See section 19.6.2 for more information on backward + compatibility with HTTP/1.0 clients. + + In order to remain persistent, all messages on the connection MUST + have a self-defined message length (i.e., one not defined by closure + of the connection), as described in section 4.4. + + + + + + + + + +Fielding, et al. Standards Track [Page 45] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2.2 Pipelining + + A client that supports persistent connections MAY "pipeline" its + requests (i.e., send multiple requests without waiting for each + response). A server MUST send its responses to those requests in the + same order that the requests were received. + + Clients which assume persistent connections and pipeline immediately + after connection establishment SHOULD be prepared to retry their + connection if the first pipelined attempt fails. If a client does + such a retry, it MUST NOT pipeline before it knows the connection is + persistent. Clients MUST also be prepared to resend their requests if + the server closes the connection before sending all of the + corresponding responses. + + Clients SHOULD NOT pipeline requests using non-idempotent methods or + non-idempotent sequences of methods (see section 9.1.2). Otherwise, a + premature termination of the transport connection could lead to + indeterminate results. A client wishing to send a non-idempotent + request SHOULD wait to send that request until it has received the + response status for the previous request. + +8.1.3 Proxy Servers + + It is especially important that proxies correctly implement the + properties of the Connection header field as specified in section + 14.10. + + The proxy server MUST signal persistent connections separately with + its clients and the origin servers (or other proxy servers) that it + connects to. Each persistent connection applies to only one transport + link. + + A proxy server MUST NOT establish a HTTP/1.1 persistent connection + with an HTTP/1.0 client (but see RFC 2068 [33] for information and + discussion of the problems with the Keep-Alive header implemented by + many HTTP/1.0 clients). + +8.1.4 Practical Considerations + + Servers will usually have some time-out value beyond which they will + no longer maintain an inactive connection. Proxy servers might make + this a higher value since it is likely that the client will be making + more connections through the same server. The use of persistent + connections places no requirements on the length (or existence) of + this time-out for either the client or the server. + + + + + +Fielding, et al. Standards Track [Page 46] + +RFC 2616 HTTP/1.1 June 1999 + + + When a client or server wishes to time-out it SHOULD issue a graceful + close on the transport connection. Clients and servers SHOULD both + constantly watch for the other side of the transport close, and + respond to it as appropriate. If a client or server does not detect + the other side's close promptly it could cause unnecessary resource + drain on the network. + + A client, server, or proxy MAY close the transport connection at any + time. For example, a client might have started to send a new request + at the same time that the server has decided to close the "idle" + connection. From the server's point of view, the connection is being + closed while it was idle, but from the client's point of view, a + request is in progress. + + This means that clients, servers, and proxies MUST be able to recover + from asynchronous close events. Client software SHOULD reopen the + transport connection and retransmit the aborted sequence of requests + without user interaction so long as the request sequence is + idempotent (see section 9.1.2). Non-idempotent methods or sequences + MUST NOT be automatically retried, although user agents MAY offer a + human operator the choice of retrying the request(s). Confirmation by + user-agent software with semantic understanding of the application + MAY substitute for user confirmation. The automatic retry SHOULD NOT + be repeated if the second sequence of requests fails. + + Servers SHOULD always respond to at least one request per connection, + if at all possible. Servers SHOULD NOT close a connection in the + middle of transmitting a response, unless a network or client failure + is suspected. + + Clients that use persistent connections SHOULD limit the number of + simultaneous connections that they maintain to a given server. A + single-user client SHOULD NOT maintain more than 2 connections with + any server or proxy. A proxy SHOULD use up to 2*N connections to + another server or proxy, where N is the number of simultaneously + active users. These guidelines are intended to improve HTTP response + times and avoid congestion. + +8.2 Message Transmission Requirements + +8.2.1 Persistent Connections and Flow Control + + HTTP/1.1 servers SHOULD maintain persistent connections and use TCP's + flow control mechanisms to resolve temporary overloads, rather than + terminating connections with the expectation that clients will retry. + The latter technique can exacerbate network congestion. + + + + + +Fielding, et al. Standards Track [Page 47] + +RFC 2616 HTTP/1.1 June 1999 + + +8.2.2 Monitoring Connections for Error Status Messages + + An HTTP/1.1 (or later) client sending a message-body SHOULD monitor + the network connection for an error status while it is transmitting + the request. If the client sees an error status, it SHOULD + immediately cease transmitting the body. If the body is being sent + using a "chunked" encoding (section 3.6), a zero length chunk and + empty trailer MAY be used to prematurely mark the end of the message. + If the body was preceded by a Content-Length header, the client MUST + close the connection. + +8.2.3 Use of the 100 (Continue) Status + + The purpose of the 100 (Continue) status (see section 10.1.1) is to + allow a client that is sending a request message with a request body + to determine if the origin server is willing to accept the request + (based on the request headers) before the client sends the request + body. In some cases, it might either be inappropriate or highly + inefficient for the client to send the body if the server will reject + the message without looking at the body. + + Requirements for HTTP/1.1 clients: + + - If a client will wait for a 100 (Continue) response before + sending the request body, it MUST send an Expect request-header + field (section 14.20) with the "100-continue" expectation. + + - A client MUST NOT send an Expect request-header field (section + 14.20) with the "100-continue" expectation if it does not intend + to send a request body. + + Because of the presence of older implementations, the protocol allows + ambiguous situations in which a client may send "Expect: 100- + continue" without receiving either a 417 (Expectation Failed) status + or a 100 (Continue) status. Therefore, when a client sends this + header field to an origin server (possibly via a proxy) from which it + has never seen a 100 (Continue) status, the client SHOULD NOT wait + for an indefinite period before sending the request body. + + Requirements for HTTP/1.1 origin servers: + + - Upon receiving a request which includes an Expect request-header + field with the "100-continue" expectation, an origin server MUST + either respond with 100 (Continue) status and continue to read + from the input stream, or respond with a final status code. The + origin server MUST NOT wait for the request body before sending + the 100 (Continue) response. If it responds with a final status + code, it MAY close the transport connection or it MAY continue + + + +Fielding, et al. Standards Track [Page 48] + +RFC 2616 HTTP/1.1 June 1999 + + + to read and discard the rest of the request. It MUST NOT + perform the requested method if it returns a final status code. + + - An origin server SHOULD NOT send a 100 (Continue) response if + the request message does not include an Expect request-header + field with the "100-continue" expectation, and MUST NOT send a + 100 (Continue) response if such a request comes from an HTTP/1.0 + (or earlier) client. There is an exception to this rule: for + compatibility with RFC 2068, a server MAY send a 100 (Continue) + status in response to an HTTP/1.1 PUT or POST request that does + not include an Expect request-header field with the "100- + continue" expectation. This exception, the purpose of which is + to minimize any client processing delays associated with an + undeclared wait for 100 (Continue) status, applies only to + HTTP/1.1 requests, and not to requests with any other HTTP- + version value. + + - An origin server MAY omit a 100 (Continue) response if it has + already received some or all of the request body for the + corresponding request. + + - An origin server that sends a 100 (Continue) response MUST + ultimately send a final status code, once the request body is + received and processed, unless it terminates the transport + connection prematurely. + + - If an origin server receives a request that does not include an + Expect request-header field with the "100-continue" expectation, + the request includes a request body, and the server responds + with a final status code before reading the entire request body + from the transport connection, then the server SHOULD NOT close + the transport connection until it has read the entire request, + or until the client closes the connection. Otherwise, the client + might not reliably receive the response message. However, this + requirement is not be construed as preventing a server from + defending itself against denial-of-service attacks, or from + badly broken client implementations. + + Requirements for HTTP/1.1 proxies: + + - If a proxy receives a request that includes an Expect request- + header field with the "100-continue" expectation, and the proxy + either knows that the next-hop server complies with HTTP/1.1 or + higher, or does not know the HTTP version of the next-hop + server, it MUST forward the request, including the Expect header + field. + + + + + +Fielding, et al. Standards Track [Page 49] + +RFC 2616 HTTP/1.1 June 1999 + + + - If the proxy knows that the version of the next-hop server is + HTTP/1.0 or lower, it MUST NOT forward the request, and it MUST + respond with a 417 (Expectation Failed) status. + + - Proxies SHOULD maintain a cache recording the HTTP version + numbers received from recently-referenced next-hop servers. + + - A proxy MUST NOT forward a 100 (Continue) response if the + request message was received from an HTTP/1.0 (or earlier) + client and did not include an Expect request-header field with + the "100-continue" expectation. This requirement overrides the + general rule for forwarding of 1xx responses (see section 10.1). + +8.2.4 Client Behavior if Server Prematurely Closes Connection + + If an HTTP/1.1 client sends a request which includes a request body, + but which does not include an Expect request-header field with the + "100-continue" expectation, and if the client is not directly + connected to an HTTP/1.1 origin server, and if the client sees the + connection close before receiving any status from the server, the + client SHOULD retry the request. If the client does retry this + request, it MAY use the following "binary exponential backoff" + algorithm to be assured of obtaining a reliable response: + + 1. Initiate a new connection to the server + + 2. Transmit the request-headers + + 3. Initialize a variable R to the estimated round-trip time to the + server (e.g., based on the time it took to establish the + connection), or to a constant value of 5 seconds if the round- + trip time is not available. + + 4. Compute T = R * (2**N), where N is the number of previous + retries of this request. + + 5. Wait either for an error response from the server, or for T + seconds (whichever comes first) + + 6. If no error response is received, after T seconds transmit the + body of the request. + + 7. If client sees that the connection is closed prematurely, + repeat from step 1 until the request is accepted, an error + response is received, or the user becomes impatient and + terminates the retry process. + + + + + +Fielding, et al. Standards Track [Page 50] + +RFC 2616 HTTP/1.1 June 1999 + + + If at any point an error status is received, the client + + - SHOULD NOT continue and + + - SHOULD close the connection if it has not completed sending the + request message. + +9 Method Definitions + + The set of common methods for HTTP/1.1 is defined below. Although + this set can be expanded, additional methods cannot be assumed to + share the same semantics for separately extended clients and servers. + + The Host request-header field (section 14.23) MUST accompany all + HTTP/1.1 requests. + +9.1 Safe and Idempotent Methods + +9.1.1 Safe Methods + + Implementors should be aware that the software represents the user in + their interactions over the Internet, and should be careful to allow + the user to be aware of any actions they might take which may have an + unexpected significance to themselves or others. + + In particular, the convention has been established that the GET and + HEAD methods SHOULD NOT have the significance of taking an action + other than retrieval. These methods ought to be considered "safe". + This allows user agents to represent other methods, such as POST, PUT + and DELETE, in a special way, so that the user is made aware of the + fact that a possibly unsafe action is being requested. + + Naturally, it is not possible to ensure that the server does not + generate side-effects as a result of performing a GET request; in + fact, some dynamic resources consider that a feature. The important + distinction here is that the user did not request the side-effects, + so therefore cannot be held accountable for them. + +9.1.2 Idempotent Methods + + Methods can also have the property of "idempotence" in that (aside + from error or expiration issues) the side-effects of N > 0 identical + requests is the same as for a single request. The methods GET, HEAD, + PUT and DELETE share this property. Also, the methods OPTIONS and + TRACE SHOULD NOT have side effects, and so are inherently idempotent. + + + + + + +Fielding, et al. Standards Track [Page 51] + +RFC 2616 HTTP/1.1 June 1999 + + + However, it is possible that a sequence of several requests is non- + idempotent, even if all of the methods executed in that sequence are + idempotent. (A sequence is idempotent if a single execution of the + entire sequence always yields a result that is not changed by a + reexecution of all, or part, of that sequence.) For example, a + sequence is non-idempotent if its result depends on a value that is + later modified in the same sequence. + + A sequence that never has side effects is idempotent, by definition + (provided that no concurrent operations are being executed on the + same set of resources). + +9.2 OPTIONS + + The OPTIONS method represents a request for information about the + communication options available on the request/response chain + identified by the Request-URI. This method allows the client to + determine the options and/or requirements associated with a resource, + or the capabilities of a server, without implying a resource action + or initiating a resource retrieval. + + Responses to this method are not cacheable. + + If the OPTIONS request includes an entity-body (as indicated by the + presence of Content-Length or Transfer-Encoding), then the media type + MUST be indicated by a Content-Type field. Although this + specification does not define any use for such a body, future + extensions to HTTP might use the OPTIONS body to make more detailed + queries on the server. A server that does not support such an + extension MAY discard the request body. + + If the Request-URI is an asterisk ("*"), the OPTIONS request is + intended to apply to the server in general rather than to a specific + resource. Since a server's communication options typically depend on + the resource, the "*" request is only useful as a "ping" or "no-op" + type of method; it does nothing beyond allowing the client to test + the capabilities of the server. For example, this can be used to test + a proxy for HTTP/1.1 compliance (or lack thereof). + + If the Request-URI is not an asterisk, the OPTIONS request applies + only to the options that are available when communicating with that + resource. + + A 200 response SHOULD include any header fields that indicate + optional features implemented by the server and applicable to that + resource (e.g., Allow), possibly including extensions not defined by + this specification. The response body, if any, SHOULD also include + information about the communication options. The format for such a + + + +Fielding, et al. Standards Track [Page 52] + +RFC 2616 HTTP/1.1 June 1999 + + + body is not defined by this specification, but might be defined by + future extensions to HTTP. Content negotiation MAY be used to select + the appropriate response format. If no response body is included, the + response MUST include a Content-Length field with a field-value of + "0". + + The Max-Forwards request-header field MAY be used to target a + specific proxy in the request chain. When a proxy receives an OPTIONS + request on an absoluteURI for which request forwarding is permitted, + the proxy MUST check for a Max-Forwards field. If the Max-Forwards + field-value is zero ("0"), the proxy MUST NOT forward the message; + instead, the proxy SHOULD respond with its own communication options. + If the Max-Forwards field-value is an integer greater than zero, the + proxy MUST decrement the field-value when it forwards the request. If + no Max-Forwards field is present in the request, then the forwarded + request MUST NOT include a Max-Forwards field. + +9.3 GET + + The GET method means retrieve whatever information (in the form of an + entity) is identified by the Request-URI. If the Request-URI refers + to a data-producing process, it is the produced data which shall be + returned as the entity in the response and not the source text of the + process, unless that text happens to be the output of the process. + + The semantics of the GET method change to a "conditional GET" if the + request message includes an If-Modified-Since, If-Unmodified-Since, + If-Match, If-None-Match, or If-Range header field. A conditional GET + method requests that the entity be transferred only under the + circumstances described by the conditional header field(s). The + conditional GET method is intended to reduce unnecessary network + usage by allowing cached entities to be refreshed without requiring + multiple requests or transferring data already held by the client. + + The semantics of the GET method change to a "partial GET" if the + request message includes a Range header field. A partial GET requests + that only part of the entity be transferred, as described in section + 14.35. The partial GET method is intended to reduce unnecessary + network usage by allowing partially-retrieved entities to be + completed without transferring data already held by the client. + + The response to a GET request is cacheable if and only if it meets + the requirements for HTTP caching described in section 13. + + See section 15.1.3 for security considerations when used for forms. + + + + + + +Fielding, et al. Standards Track [Page 53] + +RFC 2616 HTTP/1.1 June 1999 + + +9.4 HEAD + + The HEAD method is identical to GET except that the server MUST NOT + return a message-body in the response. The metainformation contained + in the HTTP headers in response to a HEAD request SHOULD be identical + to the information sent in response to a GET request. This method can + be used for obtaining metainformation about the entity implied by the + request without transferring the entity-body itself. This method is + often used for testing hypertext links for validity, accessibility, + and recent modification. + + The response to a HEAD request MAY be cacheable in the sense that the + information contained in the response MAY be used to update a + previously cached entity from that resource. If the new field values + indicate that the cached entity differs from the current entity (as + would be indicated by a change in Content-Length, Content-MD5, ETag + or Last-Modified), then the cache MUST treat the cache entry as + stale. + +9.5 POST + + The POST method is used to request that the origin server accept the + entity enclosed in the request as a new subordinate of the resource + identified by the Request-URI in the Request-Line. POST is designed + to allow a uniform method to cover the following functions: + + - Annotation of existing resources; + + - Posting a message to a bulletin board, newsgroup, mailing list, + or similar group of articles; + + - Providing a block of data, such as the result of submitting a + form, to a data-handling process; + + - Extending a database through an append operation. + + The actual function performed by the POST method is determined by the + server and is usually dependent on the Request-URI. The posted entity + is subordinate to that URI in the same way that a file is subordinate + to a directory containing it, a news article is subordinate to a + newsgroup to which it is posted, or a record is subordinate to a + database. + + The action performed by the POST method might not result in a + resource that can be identified by a URI. In this case, either 200 + (OK) or 204 (No Content) is the appropriate response status, + depending on whether or not the response includes an entity that + describes the result. + + + +Fielding, et al. Standards Track [Page 54] + +RFC 2616 HTTP/1.1 June 1999 + + + If a resource has been created on the origin server, the response + SHOULD be 201 (Created) and contain an entity which describes the + status of the request and refers to the new resource, and a Location + header (see section 14.30). + + Responses to this method are not cacheable, unless the response + includes appropriate Cache-Control or Expires header fields. However, + the 303 (See Other) response can be used to direct the user agent to + retrieve a cacheable resource. + + POST requests MUST obey the message transmission requirements set out + in section 8.2. + + See section 15.1.3 for security considerations. + +9.6 PUT + + The PUT method requests that the enclosed entity be stored under the + supplied Request-URI. If the Request-URI refers to an already + existing resource, the enclosed entity SHOULD be considered as a + modified version of the one residing on the origin server. If the + Request-URI does not point to an existing resource, and that URI is + capable of being defined as a new resource by the requesting user + agent, the origin server can create the resource with that URI. If a + new resource is created, the origin server MUST inform the user agent + via the 201 (Created) response. If an existing resource is modified, + either the 200 (OK) or 204 (No Content) response codes SHOULD be sent + to indicate successful completion of the request. If the resource + could not be created or modified with the Request-URI, an appropriate + error response SHOULD be given that reflects the nature of the + problem. The recipient of the entity MUST NOT ignore any Content-* + (e.g. Content-Range) headers that it does not understand or implement + and MUST return a 501 (Not Implemented) response in such cases. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + + The fundamental difference between the POST and PUT requests is + reflected in the different meaning of the Request-URI. The URI in a + POST request identifies the resource that will handle the enclosed + entity. That resource might be a data-accepting process, a gateway to + some other protocol, or a separate entity that accepts annotations. + In contrast, the URI in a PUT request identifies the entity enclosed + with the request -- the user agent knows what URI is intended and the + server MUST NOT attempt to apply the request to some other resource. + If the server desires that the request be applied to a different URI, + + + + +Fielding, et al. Standards Track [Page 55] + +RFC 2616 HTTP/1.1 June 1999 + + + it MUST send a 301 (Moved Permanently) response; the user agent MAY + then make its own decision regarding whether or not to redirect the + request. + + A single resource MAY be identified by many different URIs. For + example, an article might have a URI for identifying "the current + version" which is separate from the URI identifying each particular + version. In this case, a PUT request on a general URI might result in + several other URIs being defined by the origin server. + + HTTP/1.1 does not define how a PUT method affects the state of an + origin server. + + PUT requests MUST obey the message transmission requirements set out + in section 8.2. + + Unless otherwise specified for a particular entity-header, the + entity-headers in the PUT request SHOULD be applied to the resource + created or modified by the PUT. + +9.7 DELETE + + The DELETE method requests that the origin server delete the resource + identified by the Request-URI. This method MAY be overridden by human + intervention (or other means) on the origin server. The client cannot + be guaranteed that the operation has been carried out, even if the + status code returned from the origin server indicates that the action + has been completed successfully. However, the server SHOULD NOT + indicate success unless, at the time the response is given, it + intends to delete the resource or move it to an inaccessible + location. + + A successful response SHOULD be 200 (OK) if the response includes an + entity describing the status, 202 (Accepted) if the action has not + yet been enacted, or 204 (No Content) if the action has been enacted + but the response does not include an entity. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + +9.8 TRACE + + The TRACE method is used to invoke a remote, application-layer loop- + back of the request message. The final recipient of the request + SHOULD reflect the message received back to the client as the + entity-body of a 200 (OK) response. The final recipient is either the + + + + +Fielding, et al. Standards Track [Page 56] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server or the first proxy or gateway to receive a Max-Forwards + value of zero (0) in the request (see section 14.31). A TRACE request + MUST NOT include an entity. + + TRACE allows the client to see what is being received at the other + end of the request chain and use that data for testing or diagnostic + information. The value of the Via header field (section 14.45) is of + particular interest, since it acts as a trace of the request chain. + Use of the Max-Forwards header field allows the client to limit the + length of the request chain, which is useful for testing a chain of + proxies forwarding messages in an infinite loop. + + If the request is valid, the response SHOULD contain the entire + request message in the entity-body, with a Content-Type of + "message/http". Responses to this method MUST NOT be cached. + +9.9 CONNECT + + This specification reserves the method name CONNECT for use with a + proxy that can dynamically switch to being a tunnel (e.g. SSL + tunneling [44]). + +10 Status Code Definitions + + Each Status-Code is described below, including a description of which + method(s) it can follow and any metainformation required in the + response. + +10.1 Informational 1xx + + This class of status code indicates a provisional response, + consisting only of the Status-Line and optional headers, and is + terminated by an empty line. There are no required headers for this + class of status code. Since HTTP/1.0 did not define any 1xx status + codes, servers MUST NOT send a 1xx response to an HTTP/1.0 client + except under experimental conditions. + + A client MUST be prepared to accept one or more 1xx status responses + prior to a regular response, even if the client does not expect a 100 + (Continue) status message. Unexpected 1xx status responses MAY be + ignored by a user agent. + + Proxies MUST forward 1xx responses, unless the connection between the + proxy and its client has been closed, or unless the proxy itself + requested the generation of the 1xx response. (For example, if a + + + + + + +Fielding, et al. Standards Track [Page 57] + +RFC 2616 HTTP/1.1 June 1999 + + + proxy adds a "Expect: 100-continue" field when it forwards a request, + then it need not forward the corresponding 100 (Continue) + response(s).) + +10.1.1 100 Continue + + The client SHOULD continue with its request. This interim response is + used to inform the client that the initial part of the request has + been received and has not yet been rejected by the server. The client + SHOULD continue by sending the remainder of the request or, if the + request has already been completed, ignore this response. The server + MUST send a final response after the request has been completed. See + section 8.2.3 for detailed discussion of the use and handling of this + status code. + +10.1.2 101 Switching Protocols + + The server understands and is willing to comply with the client's + request, via the Upgrade message header field (section 14.42), for a + change in the application protocol being used on this connection. The + server will switch protocols to those defined by the response's + Upgrade header field immediately after the empty line which + terminates the 101 response. + + The protocol SHOULD be switched only when it is advantageous to do + so. For example, switching to a newer version of HTTP is advantageous + over older versions, and switching to a real-time, synchronous + protocol might be advantageous when delivering resources that use + such features. + +10.2 Successful 2xx + + This class of status code indicates that the client's request was + successfully received, understood, and accepted. + +10.2.1 200 OK + + The request has succeeded. The information returned with the response + is dependent on the method used in the request, for example: + + GET an entity corresponding to the requested resource is sent in + the response; + + HEAD the entity-header fields corresponding to the requested + resource are sent in the response without any message-body; + + POST an entity describing or containing the result of the action; + + + + +Fielding, et al. Standards Track [Page 58] + +RFC 2616 HTTP/1.1 June 1999 + + + TRACE an entity containing the request message as received by the + end server. + +10.2.2 201 Created + + The request has been fulfilled and resulted in a new resource being + created. The newly created resource can be referenced by the URI(s) + returned in the entity of the response, with the most specific URI + for the resource given by a Location header field. The response + SHOULD include an entity containing a list of resource + characteristics and location(s) from which the user or user agent can + choose the one most appropriate. The entity format is specified by + the media type given in the Content-Type header field. The origin + server MUST create the resource before returning the 201 status code. + If the action cannot be carried out immediately, the server SHOULD + respond with 202 (Accepted) response instead. + + A 201 response MAY contain an ETag response header field indicating + the current value of the entity tag for the requested variant just + created, see section 14.19. + +10.2.3 202 Accepted + + The request has been accepted for processing, but the processing has + not been completed. The request might or might not eventually be + acted upon, as it might be disallowed when processing actually takes + place. There is no facility for re-sending a status code from an + asynchronous operation such as this. + + The 202 response is intentionally non-committal. Its purpose is to + allow a server to accept a request for some other process (perhaps a + batch-oriented process that is only run once per day) without + requiring that the user agent's connection to the server persist + until the process is completed. The entity returned with this + response SHOULD include an indication of the request's current status + and either a pointer to a status monitor or some estimate of when the + user can expect the request to be fulfilled. + +10.2.4 203 Non-Authoritative Information + + The returned metainformation in the entity-header is not the + definitive set as available from the origin server, but is gathered + from a local or a third-party copy. The set presented MAY be a subset + or superset of the original version. For example, including local + annotation information about the resource might result in a superset + of the metainformation known by the origin server. Use of this + response code is not required and is only appropriate when the + response would otherwise be 200 (OK). + + + +Fielding, et al. Standards Track [Page 59] + +RFC 2616 HTTP/1.1 June 1999 + + +10.2.5 204 No Content + + The server has fulfilled the request but does not need to return an + entity-body, and might want to return updated metainformation. The + response MAY include new or updated metainformation in the form of + entity-headers, which if present SHOULD be associated with the + requested variant. + + If the client is a user agent, it SHOULD NOT change its document view + from that which caused the request to be sent. This response is + primarily intended to allow input for actions to take place without + causing a change to the user agent's active document view, although + any new or updated metainformation SHOULD be applied to the document + currently in the user agent's active view. + + The 204 response MUST NOT include a message-body, and thus is always + terminated by the first empty line after the header fields. + +10.2.6 205 Reset Content + + The server has fulfilled the request and the user agent SHOULD reset + the document view which caused the request to be sent. This response + is primarily intended to allow input for actions to take place via + user input, followed by a clearing of the form in which the input is + given so that the user can easily initiate another input action. The + response MUST NOT include an entity. + +10.2.7 206 Partial Content + + The server has fulfilled the partial GET request for the resource. + The request MUST have included a Range header field (section 14.35) + indicating the desired range, and MAY have included an If-Range + header field (section 14.27) to make the request conditional. + + The response MUST include the following header fields: + + - Either a Content-Range header field (section 14.16) indicating + the range included with this response, or a multipart/byteranges + Content-Type including Content-Range fields for each part. If a + Content-Length header field is present in the response, its + value MUST match the actual number of OCTETs transmitted in the + message-body. + + - Date + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + + + +Fielding, et al. Standards Track [Page 60] + +RFC 2616 HTTP/1.1 June 1999 + + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the 206 response is the result of an If-Range request that used a + strong cache validator (see section 13.3.3), the response SHOULD NOT + include other entity-headers. If the response is the result of an + If-Range request that used a weak validator, the response MUST NOT + include other entity-headers; this prevents inconsistencies between + cached entity-bodies and updated headers. Otherwise, the response + MUST include all of the entity-headers that would have been returned + with a 200 (OK) response to the same request. + + A cache MUST NOT combine a 206 response with other previously cached + content if the ETag or Last-Modified headers do not match exactly, + see 13.5.4. + + A cache that does not support the Range and Content-Range headers + MUST NOT cache 206 (Partial) responses. + +10.3 Redirection 3xx + + This class of status code indicates that further action needs to be + taken by the user agent in order to fulfill the request. The action + required MAY be carried out by the user agent without interaction + with the user if and only if the method used in the second request is + GET or HEAD. A client SHOULD detect infinite redirection loops, since + such loops generate network traffic for each redirection. + + Note: previous versions of this specification recommended a + maximum of five redirections. Content developers should be aware + that there might be clients that implement such a fixed + limitation. + +10.3.1 300 Multiple Choices + + The requested resource corresponds to any one of a set of + representations, each with its own specific location, and agent- + driven negotiation information (section 12) is being provided so that + the user (or user agent) can select a preferred representation and + redirect its request to that location. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of resource characteristics and location(s) from + which the user or user agent can choose the one most appropriate. The + entity format is specified by the media type given in the Content- + Type header field. Depending upon the format and the capabilities of + + + + +Fielding, et al. Standards Track [Page 61] + +RFC 2616 HTTP/1.1 June 1999 + + + the user agent, selection of the most appropriate choice MAY be + performed automatically. However, this specification does not define + any standard for such automatic selection. + + If the server has a preferred choice of representation, it SHOULD + include the specific URI for that representation in the Location + field; user agents MAY use the Location field value for automatic + redirection. This response is cacheable unless indicated otherwise. + +10.3.2 301 Moved Permanently + + The requested resource has been assigned a new permanent URI and any + future references to this resource SHOULD use one of the returned + URIs. Clients with link editing capabilities ought to automatically + re-link references to the Request-URI to one or more of the new + references returned by the server, where possible. This response is + cacheable unless indicated otherwise. + + The new permanent URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + If the 301 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: When automatically redirecting a POST request after + receiving a 301 status code, some existing HTTP/1.0 user agents + will erroneously change it into a GET request. + +10.3.3 302 Found + + The requested resource resides temporarily under a different URI. + Since the redirection might be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + + + + + + +Fielding, et al. Standards Track [Page 62] + +RFC 2616 HTTP/1.1 June 1999 + + + If the 302 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: RFC 1945 and RFC 2068 specify that the client is not allowed + to change the method on the redirected request. However, most + existing user agent implementations treat 302 as if it were a 303 + response, performing a GET on the Location field-value regardless + of the original request method. The status codes 303 and 307 have + been added for servers that wish to make unambiguously clear which + kind of reaction is expected of the client. + +10.3.4 303 See Other + + The response to the request can be found under a different URI and + SHOULD be retrieved using a GET method on that resource. This method + exists primarily to allow the output of a POST-activated script to + redirect the user agent to a selected resource. The new URI is not a + substitute reference for the originally requested resource. The 303 + response MUST NOT be cached, but the response to the second + (redirected) request might be cacheable. + + The different URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + Note: Many pre-HTTP/1.1 user agents do not understand the 303 + status. When interoperability with such clients is a concern, the + 302 status code may be used instead, since most user agents react + to a 302 response as described here for 303. + +10.3.5 304 Not Modified + + If the client has performed a conditional GET request and access is + allowed, but the document has not been modified, the server SHOULD + respond with this status code. The 304 response MUST NOT contain a + message-body, and thus is always terminated by the first empty line + after the header fields. + + The response MUST include the following header fields: + + - Date, unless its omission is required by section 14.18.1 + + + + + + + +Fielding, et al. Standards Track [Page 63] + +RFC 2616 HTTP/1.1 June 1999 + + + If a clockless origin server obeys these rules, and proxies and + clients add their own Date to any response received without one (as + already specified by [RFC 2068], section 14.19), caches will operate + correctly. + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the conditional GET used a strong cache validator (see section + 13.3.3), the response SHOULD NOT include other entity-headers. + Otherwise (i.e., the conditional GET used a weak validator), the + response MUST NOT include other entity-headers; this prevents + inconsistencies between cached entity-bodies and updated headers. + + If a 304 response indicates an entity not currently cached, then the + cache MUST disregard the response and repeat the request without the + conditional. + + If a cache uses a received 304 response to update a cache entry, the + cache MUST update the entry to reflect any new field values given in + the response. + +10.3.6 305 Use Proxy + + The requested resource MUST be accessed through the proxy given by + the Location field. The Location field gives the URI of the proxy. + The recipient is expected to repeat this single request via the + proxy. 305 responses MUST only be generated by origin servers. + + Note: RFC 2068 was not clear that 305 was intended to redirect a + single request, and to be generated by origin servers only. Not + observing these limitations has significant security consequences. + +10.3.7 306 (Unused) + + The 306 status code was used in a previous version of the + specification, is no longer used, and the code is reserved. + + + + + + + + + + +Fielding, et al. Standards Track [Page 64] + +RFC 2616 HTTP/1.1 June 1999 + + +10.3.8 307 Temporary Redirect + + The requested resource resides temporarily under a different URI. + Since the redirection MAY be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s) , since many pre-HTTP/1.1 user agents do not + understand the 307 status. Therefore, the note SHOULD contain the + information necessary for a user to repeat the original request on + the new URI. + + If the 307 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + +10.4 Client Error 4xx + + The 4xx class of status code is intended for cases in which the + client seems to have erred. Except when responding to a HEAD request, + the server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. These status codes are applicable to any request method. + User agents SHOULD display any included entity to the user. + + If the client is sending data, a server implementation using TCP + SHOULD be careful to ensure that the client acknowledges receipt of + the packet(s) containing the response, before the server closes the + input connection. If the client continues sending data to the server + after the close, the server's TCP stack will send a reset packet to + the client, which may erase the client's unacknowledged input buffers + before they can be read and interpreted by the HTTP application. + +10.4.1 400 Bad Request + + The request could not be understood by the server due to malformed + syntax. The client SHOULD NOT repeat the request without + modifications. + + + + + + + + +Fielding, et al. Standards Track [Page 65] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.2 401 Unauthorized + + The request requires user authentication. The response MUST include a + WWW-Authenticate header field (section 14.47) containing a challenge + applicable to the requested resource. The client MAY repeat the + request with a suitable Authorization header field (section 14.8). If + the request already included Authorization credentials, then the 401 + response indicates that authorization has been refused for those + credentials. If the 401 response contains the same challenge as the + prior response, and the user agent has already attempted + authentication at least once, then the user SHOULD be presented the + entity that was given in the response, since that entity might + include relevant diagnostic information. HTTP access authentication + is explained in "HTTP Authentication: Basic and Digest Access + Authentication" [43]. + +10.4.3 402 Payment Required + + This code is reserved for future use. + +10.4.4 403 Forbidden + + The server understood the request, but is refusing to fulfill it. + Authorization will not help and the request SHOULD NOT be repeated. + If the request method was not HEAD and the server wishes to make + public why the request has not been fulfilled, it SHOULD describe the + reason for the refusal in the entity. If the server does not wish to + make this information available to the client, the status code 404 + (Not Found) can be used instead. + +10.4.5 404 Not Found + + The server has not found anything matching the Request-URI. No + indication is given of whether the condition is temporary or + permanent. The 410 (Gone) status code SHOULD be used if the server + knows, through some internally configurable mechanism, that an old + resource is permanently unavailable and has no forwarding address. + This status code is commonly used when the server does not wish to + reveal exactly why the request has been refused, or when no other + response is applicable. + +10.4.6 405 Method Not Allowed + + The method specified in the Request-Line is not allowed for the + resource identified by the Request-URI. The response MUST include an + Allow header containing a list of valid methods for the requested + resource. + + + + +Fielding, et al. Standards Track [Page 66] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.7 406 Not Acceptable + + The resource identified by the request is only capable of generating + response entities which have content characteristics not acceptable + according to the accept headers sent in the request. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of available entity characteristics and location(s) + from which the user or user agent can choose the one most + appropriate. The entity format is specified by the media type given + in the Content-Type header field. Depending upon the format and the + capabilities of the user agent, selection of the most appropriate + choice MAY be performed automatically. However, this specification + does not define any standard for such automatic selection. + + Note: HTTP/1.1 servers are allowed to return responses which are + not acceptable according to the accept headers sent in the + request. In some cases, this may even be preferable to sending a + 406 response. User agents are encouraged to inspect the headers of + an incoming response to determine if it is acceptable. + + If the response could be unacceptable, a user agent SHOULD + temporarily stop receipt of more data and query the user for a + decision on further actions. + +10.4.8 407 Proxy Authentication Required + + This code is similar to 401 (Unauthorized), but indicates that the + client must first authenticate itself with the proxy. The proxy MUST + return a Proxy-Authenticate header field (section 14.33) containing a + challenge applicable to the proxy for the requested resource. The + client MAY repeat the request with a suitable Proxy-Authorization + header field (section 14.34). HTTP access authentication is explained + in "HTTP Authentication: Basic and Digest Access Authentication" + [43]. + +10.4.9 408 Request Timeout + + The client did not produce a request within the time that the server + was prepared to wait. The client MAY repeat the request without + modifications at any later time. + +10.4.10 409 Conflict + + The request could not be completed due to a conflict with the current + state of the resource. This code is only allowed in situations where + it is expected that the user might be able to resolve the conflict + and resubmit the request. The response body SHOULD include enough + + + +Fielding, et al. Standards Track [Page 67] + +RFC 2616 HTTP/1.1 June 1999 + + + information for the user to recognize the source of the conflict. + Ideally, the response entity would include enough information for the + user or user agent to fix the problem; however, that might not be + possible and is not required. + + Conflicts are most likely to occur in response to a PUT request. For + example, if versioning were being used and the entity being PUT + included changes to a resource which conflict with those made by an + earlier (third-party) request, the server might use the 409 response + to indicate that it can't complete the request. In this case, the + response entity would likely contain a list of the differences + between the two versions in a format defined by the response + Content-Type. + +10.4.11 410 Gone + + The requested resource is no longer available at the server and no + forwarding address is known. This condition is expected to be + considered permanent. Clients with link editing capabilities SHOULD + delete references to the Request-URI after user approval. If the + server does not know, or has no facility to determine, whether or not + the condition is permanent, the status code 404 (Not Found) SHOULD be + used instead. This response is cacheable unless indicated otherwise. + + The 410 response is primarily intended to assist the task of web + maintenance by notifying the recipient that the resource is + intentionally unavailable and that the server owners desire that + remote links to that resource be removed. Such an event is common for + limited-time, promotional services and for resources belonging to + individuals no longer working at the server's site. It is not + necessary to mark all permanently unavailable resources as "gone" or + to keep the mark for any length of time -- that is left to the + discretion of the server owner. + +10.4.12 411 Length Required + + The server refuses to accept the request without a defined Content- + Length. The client MAY repeat the request if it adds a valid + Content-Length header field containing the length of the message-body + in the request message. + +10.4.13 412 Precondition Failed + + The precondition given in one or more of the request-header fields + evaluated to false when it was tested on the server. This response + code allows the client to place preconditions on the current resource + metainformation (header field data) and thus prevent the requested + method from being applied to a resource other than the one intended. + + + +Fielding, et al. Standards Track [Page 68] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.14 413 Request Entity Too Large + + The server is refusing to process a request because the request + entity is larger than the server is willing or able to process. The + server MAY close the connection to prevent the client from continuing + the request. + + If the condition is temporary, the server SHOULD include a Retry- + After header field to indicate that it is temporary and after what + time the client MAY try again. + +10.4.15 414 Request-URI Too Long + + The server is refusing to service the request because the Request-URI + is longer than the server is willing to interpret. This rare + condition is only likely to occur when a client has improperly + converted a POST request to a GET request with long query + information, when the client has descended into a URI "black hole" of + redirection (e.g., a redirected URI prefix that points to a suffix of + itself), or when the server is under attack by a client attempting to + exploit security holes present in some servers using fixed-length + buffers for reading or manipulating the Request-URI. + +10.4.16 415 Unsupported Media Type + + The server is refusing to service the request because the entity of + the request is in a format not supported by the requested resource + for the requested method. + +10.4.17 416 Requested Range Not Satisfiable + + A server SHOULD return a response with this status code if a request + included a Range request-header field (section 14.35), and none of + the range-specifier values in this field overlap the current extent + of the selected resource, and the request did not include an If-Range + request-header field. (For byte-ranges, this means that the first- + byte-pos of all of the byte-range-spec values were greater than the + current length of the selected resource.) + + When this status code is returned for a byte-range request, the + response SHOULD include a Content-Range entity-header field + specifying the current length of the selected resource (see section + 14.16). This response MUST NOT use the multipart/byteranges content- + type. + + + + + + + +Fielding, et al. Standards Track [Page 69] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.18 417 Expectation Failed + + The expectation given in an Expect request-header field (see section + 14.20) could not be met by this server, or, if the server is a proxy, + the server has unambiguous evidence that the request could not be met + by the next-hop server. + +10.5 Server Error 5xx + + Response status codes beginning with the digit "5" indicate cases in + which the server is aware that it has erred or is incapable of + performing the request. Except when responding to a HEAD request, the + server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. User agents SHOULD display any included entity to the + user. These response codes are applicable to any request method. + +10.5.1 500 Internal Server Error + + The server encountered an unexpected condition which prevented it + from fulfilling the request. + +10.5.2 501 Not Implemented + + The server does not support the functionality required to fulfill the + request. This is the appropriate response when the server does not + recognize the request method and is not capable of supporting it for + any resource. + +10.5.3 502 Bad Gateway + + The server, while acting as a gateway or proxy, received an invalid + response from the upstream server it accessed in attempting to + fulfill the request. + +10.5.4 503 Service Unavailable + + The server is currently unable to handle the request due to a + temporary overloading or maintenance of the server. The implication + is that this is a temporary condition which will be alleviated after + some delay. If known, the length of the delay MAY be indicated in a + Retry-After header. If no Retry-After is given, the client SHOULD + handle the response as it would for a 500 response. + + Note: The existence of the 503 status code does not imply that a + server must use it when becoming overloaded. Some servers may wish + to simply refuse the connection. + + + + +Fielding, et al. Standards Track [Page 70] + +RFC 2616 HTTP/1.1 June 1999 + + +10.5.5 504 Gateway Timeout + + The server, while acting as a gateway or proxy, did not receive a + timely response from the upstream server specified by the URI (e.g. + HTTP, FTP, LDAP) or some other auxiliary server (e.g. DNS) it needed + to access in attempting to complete the request. + + Note: Note to implementors: some deployed proxies are known to + return 400 or 500 when DNS lookups time out. + +10.5.6 505 HTTP Version Not Supported + + The server does not support, or refuses to support, the HTTP protocol + version that was used in the request message. The server is + indicating that it is unable or unwilling to complete the request + using the same major version as the client, as described in section + 3.1, other than with this error message. The response SHOULD contain + an entity describing why that version is not supported and what other + protocols are supported by that server. + +11 Access Authentication + + HTTP provides several OPTIONAL challenge-response authentication + mechanisms which can be used by a server to challenge a client + request and by a client to provide authentication information. The + general framework for access authentication, and the specification of + "basic" and "digest" authentication, are specified in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. This + specification adopts the definitions of "challenge" and "credentials" + from that specification. + +12 Content Negotiation + + Most HTTP responses include an entity which contains information for + interpretation by a human user. Naturally, it is desirable to supply + the user with the "best available" entity corresponding to the + request. Unfortunately for servers and caches, not all users have the + same preferences for what is "best," and not all user agents are + equally capable of rendering all entity types. For that reason, HTTP + has provisions for several mechanisms for "content negotiation" -- + the process of selecting the best representation for a given response + when there are multiple representations available. + + Note: This is not called "format negotiation" because the + alternate representations may be of the same media type, but use + different capabilities of that type, be in different languages, + etc. + + + + +Fielding, et al. Standards Track [Page 71] + +RFC 2616 HTTP/1.1 June 1999 + + + Any response containing an entity-body MAY be subject to negotiation, + including error responses. + + There are two kinds of content negotiation which are possible in + HTTP: server-driven and agent-driven negotiation. These two kinds of + negotiation are orthogonal and thus may be used separately or in + combination. One method of combination, referred to as transparent + negotiation, occurs when a cache uses the agent-driven negotiation + information provided by the origin server in order to provide + server-driven negotiation for subsequent requests. + +12.1 Server-driven Negotiation + + If the selection of the best representation for a response is made by + an algorithm located at the server, it is called server-driven + negotiation. Selection is based on the available representations of + the response (the dimensions over which it can vary; e.g. language, + content-coding, etc.) and the contents of particular header fields in + the request message or on other information pertaining to the request + (such as the network address of the client). + + Server-driven negotiation is advantageous when the algorithm for + selecting from among the available representations is difficult to + describe to the user agent, or when the server desires to send its + "best guess" to the client along with the first response (hoping to + avoid the round-trip delay of a subsequent request if the "best + guess" is good enough for the user). In order to improve the server's + guess, the user agent MAY include request header fields (Accept, + Accept-Language, Accept-Encoding, etc.) which describe its + preferences for such a response. + + Server-driven negotiation has disadvantages: + + 1. It is impossible for the server to accurately determine what + might be "best" for any given user, since that would require + complete knowledge of both the capabilities of the user agent + and the intended use for the response (e.g., does the user want + to view it on screen or print it on paper?). + + 2. Having the user agent describe its capabilities in every + request can be both very inefficient (given that only a small + percentage of responses have multiple representations) and a + potential violation of the user's privacy. + + 3. It complicates the implementation of an origin server and the + algorithms for generating responses to a request. + + + + + +Fielding, et al. Standards Track [Page 72] + +RFC 2616 HTTP/1.1 June 1999 + + + 4. It may limit a public cache's ability to use the same response + for multiple user's requests. + + HTTP/1.1 includes the following request-header fields for enabling + server-driven negotiation through description of user agent + capabilities and user preferences: Accept (section 14.1), Accept- + Charset (section 14.2), Accept-Encoding (section 14.3), Accept- + Language (section 14.4), and User-Agent (section 14.43). However, an + origin server is not limited to these dimensions and MAY vary the + response based on any aspect of the request, including information + outside the request-header fields or within extension header fields + not defined by this specification. + + The Vary header field can be used to express the parameters the + server uses to select a representation that is subject to server- + driven negotiation. See section 13.6 for use of the Vary header field + by caches and section 14.44 for use of the Vary header field by + servers. + +12.2 Agent-driven Negotiation + + With agent-driven negotiation, selection of the best representation + for a response is performed by the user agent after receiving an + initial response from the origin server. Selection is based on a list + of the available representations of the response included within the + header fields or entity-body of the initial response, with each + representation identified by its own URI. Selection from among the + representations may be performed automatically (if the user agent is + capable of doing so) or manually by the user selecting from a + generated (possibly hypertext) menu. + + Agent-driven negotiation is advantageous when the response would vary + over commonly-used dimensions (such as type, language, or encoding), + when the origin server is unable to determine a user agent's + capabilities from examining the request, and generally when public + caches are used to distribute server load and reduce network usage. + + Agent-driven negotiation suffers from the disadvantage of needing a + second request to obtain the best alternate representation. This + second request is only efficient when caching is used. In addition, + this specification does not define any mechanism for supporting + automatic selection, though it also does not prevent any such + mechanism from being developed as an extension and used within + HTTP/1.1. + + + + + + + +Fielding, et al. Standards Track [Page 73] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 defines the 300 (Multiple Choices) and 406 (Not Acceptable) + status codes for enabling agent-driven negotiation when the server is + unwilling or unable to provide a varying response using server-driven + negotiation. + +12.3 Transparent Negotiation + + Transparent negotiation is a combination of both server-driven and + agent-driven negotiation. When a cache is supplied with a form of the + list of available representations of the response (as in agent-driven + negotiation) and the dimensions of variance are completely understood + by the cache, then the cache becomes capable of performing server- + driven negotiation on behalf of the origin server for subsequent + requests on that resource. + + Transparent negotiation has the advantage of distributing the + negotiation work that would otherwise be required of the origin + server and also removing the second request delay of agent-driven + negotiation when the cache is able to correctly guess the right + response. + + This specification does not define any mechanism for transparent + negotiation, though it also does not prevent any such mechanism from + being developed as an extension that could be used within HTTP/1.1. + +13 Caching in HTTP + + HTTP is typically used for distributed information systems, where + performance can be improved by the use of response caches. The + HTTP/1.1 protocol includes a number of elements intended to make + caching work as well as possible. Because these elements are + inextricable from other aspects of the protocol, and because they + interact with each other, it is useful to describe the basic caching + design of HTTP separately from the detailed descriptions of methods, + headers, response codes, etc. + + Caching would be useless if it did not significantly improve + performance. The goal of caching in HTTP/1.1 is to eliminate the need + to send requests in many cases, and to eliminate the need to send + full responses in many other cases. The former reduces the number of + network round-trips required for many operations; we use an + "expiration" mechanism for this purpose (see section 13.2). The + latter reduces network bandwidth requirements; we use a "validation" + mechanism for this purpose (see section 13.3). + + Requirements for performance, availability, and disconnected + operation require us to be able to relax the goal of semantic + transparency. The HTTP/1.1 protocol allows origin servers, caches, + + + +Fielding, et al. Standards Track [Page 74] + +RFC 2616 HTTP/1.1 June 1999 + + + and clients to explicitly reduce transparency when necessary. + However, because non-transparent operation may confuse non-expert + users, and might be incompatible with certain server applications + (such as those for ordering merchandise), the protocol requires that + transparency be relaxed + + - only by an explicit protocol-level request when relaxed by + client or origin server + + - only with an explicit warning to the end user when relaxed by + cache or client + + Therefore, the HTTP/1.1 protocol provides these important elements: + + 1. Protocol features that provide full semantic transparency when + this is required by all parties. + + 2. Protocol features that allow an origin server or user agent to + explicitly request and control non-transparent operation. + + 3. Protocol features that allow a cache to attach warnings to + responses that do not preserve the requested approximation of + semantic transparency. + + A basic principle is that it must be possible for the clients to + detect any potential relaxation of semantic transparency. + + Note: The server, cache, or client implementor might be faced with + design decisions not explicitly discussed in this specification. + If a decision might affect semantic transparency, the implementor + ought to err on the side of maintaining transparency unless a + careful and complete analysis shows significant benefits in + breaking transparency. + +13.1.1 Cache Correctness + + A correct cache MUST respond to a request with the most up-to-date + response held by the cache that is appropriate to the request (see + sections 13.2.5, 13.2.6, and 13.12) which meets one of the following + conditions: + + 1. It has been checked for equivalence with what the origin server + would have returned by revalidating the response with the + origin server (section 13.3); + + + + + + + +Fielding, et al. Standards Track [Page 75] + +RFC 2616 HTTP/1.1 June 1999 + + + 2. It is "fresh enough" (see section 13.2). In the default case, + this means it meets the least restrictive freshness requirement + of the client, origin server, and cache (see section 14.9); if + the origin server so specifies, it is the freshness requirement + of the origin server alone. + + If a stored response is not "fresh enough" by the most + restrictive freshness requirement of both the client and the + origin server, in carefully considered circumstances the cache + MAY still return the response with the appropriate Warning + header (see section 13.1.5 and 14.46), unless such a response + is prohibited (e.g., by a "no-store" cache-directive, or by a + "no-cache" cache-request-directive; see section 14.9). + + 3. It is an appropriate 304 (Not Modified), 305 (Proxy Redirect), + or error (4xx or 5xx) response message. + + If the cache can not communicate with the origin server, then a + correct cache SHOULD respond as above if the response can be + correctly served from the cache; if not it MUST return an error or + warning indicating that there was a communication failure. + + If a cache receives a response (either an entire response, or a 304 + (Not Modified) response) that it would normally forward to the + requesting client, and the received response is no longer fresh, the + cache SHOULD forward it to the requesting client without adding a new + Warning (but without removing any existing Warning headers). A cache + SHOULD NOT attempt to revalidate a response simply because that + response became stale in transit; this might lead to an infinite + loop. A user agent that receives a stale response without a Warning + MAY display a warning indication to the user. + +13.1.2 Warnings + + Whenever a cache returns a response that is neither first-hand nor + "fresh enough" (in the sense of condition 2 in section 13.1.1), it + MUST attach a warning to that effect, using a Warning general-header. + The Warning header and the currently defined warnings are described + in section 14.46. The warning allows clients to take appropriate + action. + + Warnings MAY be used for other purposes, both cache-related and + otherwise. The use of a warning, rather than an error status code, + distinguish these responses from true failures. + + Warnings are assigned three digit warn-codes. The first digit + indicates whether the Warning MUST or MUST NOT be deleted from a + stored cache entry after a successful revalidation: + + + +Fielding, et al. Standards Track [Page 76] + +RFC 2616 HTTP/1.1 June 1999 + + + 1xx Warnings that describe the freshness or revalidation status of + the response, and so MUST be deleted after a successful + revalidation. 1XX warn-codes MAY be generated by a cache only when + validating a cached entry. It MUST NOT be generated by clients. + + 2xx Warnings that describe some aspect of the entity body or entity + headers that is not rectified by a revalidation (for example, a + lossy compression of the entity bodies) and which MUST NOT be + deleted after a successful revalidation. + + See section 14.46 for the definitions of the codes themselves. + + HTTP/1.0 caches will cache all Warnings in responses, without + deleting the ones in the first category. Warnings in responses that + are passed to HTTP/1.0 caches carry an extra warning-date field, + which prevents a future HTTP/1.1 recipient from believing an + erroneously cached Warning. + + Warnings also carry a warning text. The text MAY be in any + appropriate natural language (perhaps based on the client's Accept + headers), and include an OPTIONAL indication of what character set is + used. + + Multiple warnings MAY be attached to a response (either by the origin + server or by a cache), including multiple warnings with the same code + number. For example, a server might provide the same warning with + texts in both English and Basque. + + When multiple warnings are attached to a response, it might not be + practical or reasonable to display all of them to the user. This + version of HTTP does not specify strict priority rules for deciding + which warnings to display and in what order, but does suggest some + heuristics. + +13.1.3 Cache-control Mechanisms + + The basic cache mechanisms in HTTP/1.1 (server-specified expiration + times and validators) are implicit directives to caches. In some + cases, a server or client might need to provide explicit directives + to the HTTP caches. We use the Cache-Control header for this purpose. + + The Cache-Control header allows a client or server to transmit a + variety of directives in either requests or responses. These + directives typically override the default caching algorithms. As a + general rule, if there is any apparent conflict between header + values, the most restrictive interpretation is applied (that is, the + one that is most likely to preserve semantic transparency). However, + + + + +Fielding, et al. Standards Track [Page 77] + +RFC 2616 HTTP/1.1 June 1999 + + + in some cases, cache-control directives are explicitly specified as + weakening the approximation of semantic transparency (for example, + "max-stale" or "public"). + + The cache-control directives are described in detail in section 14.9. + +13.1.4 Explicit User Agent Warnings + + Many user agents make it possible for users to override the basic + caching mechanisms. For example, the user agent might allow the user + to specify that cached entities (even explicitly stale ones) are + never validated. Or the user agent might habitually add "Cache- + Control: max-stale=3600" to every request. The user agent SHOULD NOT + default to either non-transparent behavior, or behavior that results + in abnormally ineffective caching, but MAY be explicitly configured + to do so by an explicit action of the user. + + If the user has overridden the basic caching mechanisms, the user + agent SHOULD explicitly indicate to the user whenever this results in + the display of information that might not meet the server's + transparency requirements (in particular, if the displayed entity is + known to be stale). Since the protocol normally allows the user agent + to determine if responses are stale or not, this indication need only + be displayed when this actually happens. The indication need not be a + dialog box; it could be an icon (for example, a picture of a rotting + fish) or some other indicator. + + If the user has overridden the caching mechanisms in a way that would + abnormally reduce the effectiveness of caches, the user agent SHOULD + continually indicate this state to the user (for example, by a + display of a picture of currency in flames) so that the user does not + inadvertently consume excess resources or suffer from excessive + latency. + +13.1.5 Exceptions to the Rules and Warnings + + In some cases, the operator of a cache MAY choose to configure it to + return stale responses even when not requested by clients. This + decision ought not be made lightly, but may be necessary for reasons + of availability or performance, especially when the cache is poorly + connected to the origin server. Whenever a cache returns a stale + response, it MUST mark it as such (using a Warning header) enabling + the client software to alert the user that there might be a potential + problem. + + + + + + + +Fielding, et al. Standards Track [Page 78] + +RFC 2616 HTTP/1.1 June 1999 + + + It also allows the user agent to take steps to obtain a first-hand or + fresh response. For this reason, a cache SHOULD NOT return a stale + response if the client explicitly requests a first-hand or fresh one, + unless it is impossible to comply for technical or policy reasons. + +13.1.6 Client-controlled Behavior + + While the origin server (and to a lesser extent, intermediate caches, + by their contribution to the age of a response) are the primary + source of expiration information, in some cases the client might need + to control a cache's decision about whether to return a cached + response without validating it. Clients do this using several + directives of the Cache-Control header. + + A client's request MAY specify the maximum age it is willing to + accept of an unvalidated response; specifying a value of zero forces + the cache(s) to revalidate all responses. A client MAY also specify + the minimum time remaining before a response expires. Both of these + options increase constraints on the behavior of caches, and so cannot + further relax the cache's approximation of semantic transparency. + + A client MAY also specify that it will accept stale responses, up to + some maximum amount of staleness. This loosens the constraints on the + caches, and so might violate the origin server's specified + constraints on semantic transparency, but might be necessary to + support disconnected operation, or high availability in the face of + poor connectivity. + +13.2 Expiration Model + +13.2.1 Server-Specified Expiration + + HTTP caching works best when caches can entirely avoid making + requests to the origin server. The primary mechanism for avoiding + requests is for an origin server to provide an explicit expiration + time in the future, indicating that a response MAY be used to satisfy + subsequent requests. In other words, a cache can return a fresh + response without first contacting the server. + + Our expectation is that servers will assign future explicit + expiration times to responses in the belief that the entity is not + likely to change, in a semantically significant way, before the + expiration time is reached. This normally preserves semantic + transparency, as long as the server's expiration times are carefully + chosen. + + + + + + +Fielding, et al. Standards Track [Page 79] + +RFC 2616 HTTP/1.1 June 1999 + + + The expiration mechanism applies only to responses taken from a cache + and not to first-hand responses forwarded immediately to the + requesting client. + + If an origin server wishes to force a semantically transparent cache + to validate every request, it MAY assign an explicit expiration time + in the past. This means that the response is always stale, and so the + cache SHOULD validate it before using it for subsequent requests. See + section 14.9.4 for a more restrictive way to force revalidation. + + If an origin server wishes to force any HTTP/1.1 cache, no matter how + it is configured, to validate every request, it SHOULD use the "must- + revalidate" cache-control directive (see section 14.9). + + Servers specify explicit expiration times using either the Expires + header, or the max-age directive of the Cache-Control header. + + An expiration time cannot be used to force a user agent to refresh + its display or reload a resource; its semantics apply only to caching + mechanisms, and such mechanisms need only check a resource's + expiration status when a new request for that resource is initiated. + See section 13.13 for an explanation of the difference between caches + and history mechanisms. + +13.2.2 Heuristic Expiration + + Since origin servers do not always provide explicit expiration times, + HTTP caches typically assign heuristic expiration times, employing + algorithms that use other header values (such as the Last-Modified + time) to estimate a plausible expiration time. The HTTP/1.1 + specification does not provide specific algorithms, but does impose + worst-case constraints on their results. Since heuristic expiration + times might compromise semantic transparency, they ought to used + cautiously, and we encourage origin servers to provide explicit + expiration times as much as possible. + +13.2.3 Age Calculations + + In order to know if a cached entry is fresh, a cache needs to know if + its age exceeds its freshness lifetime. We discuss how to calculate + the latter in section 13.2.4; this section describes how to calculate + the age of a response or cache entry. + + In this discussion, we use the term "now" to mean "the current value + of the clock at the host performing the calculation." Hosts that use + HTTP, but especially hosts running origin servers and caches, SHOULD + use NTP [28] or some similar protocol to synchronize their clocks to + a globally accurate time standard. + + + +Fielding, et al. Standards Track [Page 80] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 requires origin servers to send a Date header, if possible, + with every response, giving the time at which the response was + generated (see section 14.18). We use the term "date_value" to denote + the value of the Date header, in a form appropriate for arithmetic + operations. + + HTTP/1.1 uses the Age response-header to convey the estimated age of + the response message when obtained from a cache. The Age field value + is the cache's estimate of the amount of time since the response was + generated or revalidated by the origin server. + + In essence, the Age value is the sum of the time that the response + has been resident in each of the caches along the path from the + origin server, plus the amount of time it has been in transit along + network paths. + + We use the term "age_value" to denote the value of the Age header, in + a form appropriate for arithmetic operations. + + A response's age can be calculated in two entirely independent ways: + + 1. now minus date_value, if the local clock is reasonably well + synchronized to the origin server's clock. If the result is + negative, the result is replaced by zero. + + 2. age_value, if all of the caches along the response path + implement HTTP/1.1. + + Given that we have two independent ways to compute the age of a + response when it is received, we can combine these as + + corrected_received_age = max(now - date_value, age_value) + + and as long as we have either nearly synchronized clocks or all- + HTTP/1.1 paths, one gets a reliable (conservative) result. + + Because of network-imposed delays, some significant interval might + pass between the time that a server generates a response and the time + it is received at the next outbound cache or client. If uncorrected, + this delay could result in improperly low ages. + + Because the request that resulted in the returned Age value must have + been initiated prior to that Age value's generation, we can correct + for delays imposed by the network by recording the time at which the + request was initiated. Then, when an Age value is received, it MUST + be interpreted relative to the time the request was initiated, not + + + + + +Fielding, et al. Standards Track [Page 81] + +RFC 2616 HTTP/1.1 June 1999 + + + the time that the response was received. This algorithm results in + conservative behavior no matter how much delay is experienced. So, we + compute: + + corrected_initial_age = corrected_received_age + + (now - request_time) + + where "request_time" is the time (according to the local clock) when + the request that elicited this response was sent. + + Summary of age calculation algorithm, when a cache receives a + response: + + /* + * age_value + * is the value of Age: header received by the cache with + * this response. + * date_value + * is the value of the origin server's Date: header + * request_time + * is the (local) time when the cache made the request + * that resulted in this cached response + * response_time + * is the (local) time when the cache received the + * response + * now + * is the current (local) time + */ + + apparent_age = max(0, response_time - date_value); + corrected_received_age = max(apparent_age, age_value); + response_delay = response_time - request_time; + corrected_initial_age = corrected_received_age + response_delay; + resident_time = now - response_time; + current_age = corrected_initial_age + resident_time; + + The current_age of a cache entry is calculated by adding the amount + of time (in seconds) since the cache entry was last validated by the + origin server to the corrected_initial_age. When a response is + generated from a cache entry, the cache MUST include a single Age + header field in the response with a value equal to the cache entry's + current_age. + + The presence of an Age header field in a response implies that a + response is not first-hand. However, the converse is not true, since + the lack of an Age header field in a response does not imply that the + + + + + +Fielding, et al. Standards Track [Page 82] + +RFC 2616 HTTP/1.1 June 1999 + + + response is first-hand unless all caches along the request path are + compliant with HTTP/1.1 (i.e., older HTTP caches did not implement + the Age header field). + +13.2.4 Expiration Calculations + + In order to decide whether a response is fresh or stale, we need to + compare its freshness lifetime to its age. The age is calculated as + described in section 13.2.3; this section describes how to calculate + the freshness lifetime, and to determine if a response has expired. + In the discussion below, the values can be represented in any form + appropriate for arithmetic operations. + + We use the term "expires_value" to denote the value of the Expires + header. We use the term "max_age_value" to denote an appropriate + value of the number of seconds carried by the "max-age" directive of + the Cache-Control header in a response (see section 14.9.3). + + The max-age directive takes priority over Expires, so if max-age is + present in a response, the calculation is simply: + + freshness_lifetime = max_age_value + + Otherwise, if Expires is present in the response, the calculation is: + + freshness_lifetime = expires_value - date_value + + Note that neither of these calculations is vulnerable to clock skew, + since all of the information comes from the origin server. + + If none of Expires, Cache-Control: max-age, or Cache-Control: s- + maxage (see section 14.9.3) appears in the response, and the response + does not include other restrictions on caching, the cache MAY compute + a freshness lifetime using a heuristic. The cache MUST attach Warning + 113 to any response whose age is more than 24 hours if such warning + has not already been added. + + Also, if the response does have a Last-Modified time, the heuristic + expiration value SHOULD be no more than some fraction of the interval + since that time. A typical setting of this fraction might be 10%. + + The calculation to determine if a response has expired is quite + simple: + + response_is_fresh = (freshness_lifetime > current_age) + + + + + + +Fielding, et al. Standards Track [Page 83] + +RFC 2616 HTTP/1.1 June 1999 + + +13.2.5 Disambiguating Expiration Values + + Because expiration values are assigned optimistically, it is possible + for two caches to contain fresh values for the same resource that are + different. + + If a client performing a retrieval receives a non-first-hand response + for a request that was already fresh in its own cache, and the Date + header in its existing cache entry is newer than the Date on the new + response, then the client MAY ignore the response. If so, it MAY + retry the request with a "Cache-Control: max-age=0" directive (see + section 14.9), to force a check with the origin server. + + If a cache has two fresh responses for the same representation with + different validators, it MUST use the one with the more recent Date + header. This situation might arise because the cache is pooling + responses from other caches, or because a client has asked for a + reload or a revalidation of an apparently fresh cache entry. + +13.2.6 Disambiguating Multiple Responses + + Because a client might be receiving responses via multiple paths, so + that some responses flow through one set of caches and other + responses flow through a different set of caches, a client might + receive responses in an order different from that in which the origin + server sent them. We would like the client to use the most recently + generated response, even if older responses are still apparently + fresh. + + Neither the entity tag nor the expiration value can impose an + ordering on responses, since it is possible that a later response + intentionally carries an earlier expiration time. The Date values are + ordered to a granularity of one second. + + When a client tries to revalidate a cache entry, and the response it + receives contains a Date header that appears to be older than the one + for the existing entry, then the client SHOULD repeat the request + unconditionally, and include + + Cache-Control: max-age=0 + + to force any intermediate caches to validate their copies directly + with the origin server, or + + Cache-Control: no-cache + + to force any intermediate caches to obtain a new copy from the origin + server. + + + +Fielding, et al. Standards Track [Page 84] + +RFC 2616 HTTP/1.1 June 1999 + + + If the Date values are equal, then the client MAY use either response + (or MAY, if it is being extremely prudent, request a new response). + Servers MUST NOT depend on clients being able to choose + deterministically between responses generated during the same second, + if their expiration times overlap. + +13.3 Validation Model + + When a cache has a stale entry that it would like to use as a + response to a client's request, it first has to check with the origin + server (or possibly an intermediate cache with a fresh response) to + see if its cached entry is still usable. We call this "validating" + the cache entry. Since we do not want to have to pay the overhead of + retransmitting the full response if the cached entry is good, and we + do not want to pay the overhead of an extra round trip if the cached + entry is invalid, the HTTP/1.1 protocol supports the use of + conditional methods. + + The key protocol features for supporting conditional methods are + those concerned with "cache validators." When an origin server + generates a full response, it attaches some sort of validator to it, + which is kept with the cache entry. When a client (user agent or + proxy cache) makes a conditional request for a resource for which it + has a cache entry, it includes the associated validator in the + request. + + The server then checks that validator against the current validator + for the entity, and, if they match (see section 13.3.3), it responds + with a special status code (usually, 304 (Not Modified)) and no + entity-body. Otherwise, it returns a full response (including + entity-body). Thus, we avoid transmitting the full response if the + validator matches, and we avoid an extra round trip if it does not + match. + + In HTTP/1.1, a conditional request looks exactly the same as a normal + request for the same resource, except that it carries a special + header (which includes the validator) that implicitly turns the + method (usually, GET) into a conditional. + + The protocol includes both positive and negative senses of cache- + validating conditions. That is, it is possible to request either that + a method be performed if and only if a validator matches or if and + only if no validators match. + + + + + + + + +Fielding, et al. Standards Track [Page 85] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: a response that lacks a validator may still be cached, and + served from cache until it expires, unless this is explicitly + prohibited by a cache-control directive. However, a cache cannot + do a conditional retrieval if it does not have a validator for the + entity, which means it will not be refreshable after it expires. + +13.3.1 Last-Modified Dates + + The Last-Modified entity-header field value is often used as a cache + validator. In simple terms, a cache entry is considered to be valid + if the entity has not been modified since the Last-Modified value. + +13.3.2 Entity Tag Cache Validators + + The ETag response-header field value, an entity tag, provides for an + "opaque" cache validator. This might allow more reliable validation + in situations where it is inconvenient to store modification dates, + where the one-second resolution of HTTP date values is not + sufficient, or where the origin server wishes to avoid certain + paradoxes that might arise from the use of modification dates. + + Entity Tags are described in section 3.11. The headers used with + entity tags are described in sections 14.19, 14.24, 14.26 and 14.44. + +13.3.3 Weak and Strong Validators + + Since both origin servers and caches will compare two validators to + decide if they represent the same or different entities, one normally + would expect that if the entity (the entity-body or any entity- + headers) changes in any way, then the associated validator would + change as well. If this is true, then we call this validator a + "strong validator." + + However, there might be cases when a server prefers to change the + validator only on semantically significant changes, and not when + insignificant aspects of the entity change. A validator that does not + always change when the resource changes is a "weak validator." + + Entity tags are normally "strong validators," but the protocol + provides a mechanism to tag an entity tag as "weak." One can think of + a strong validator as one that changes whenever the bits of an entity + changes, while a weak value changes whenever the meaning of an entity + changes. Alternatively, one can think of a strong validator as part + of an identifier for a specific entity, while a weak validator is + part of an identifier for a set of semantically equivalent entities. + + Note: One example of a strong validator is an integer that is + incremented in stable storage every time an entity is changed. + + + +Fielding, et al. Standards Track [Page 86] + +RFC 2616 HTTP/1.1 June 1999 + + + An entity's modification time, if represented with one-second + resolution, could be a weak validator, since it is possible that + the resource might be modified twice during a single second. + + Support for weak validators is optional. However, weak validators + allow for more efficient caching of equivalent objects; for + example, a hit counter on a site is probably good enough if it is + updated every few days or weeks, and any value during that period + is likely "good enough" to be equivalent. + + A "use" of a validator is either when a client generates a request + and includes the validator in a validating header field, or when a + server compares two validators. + + Strong validators are usable in any context. Weak validators are only + usable in contexts that do not depend on exact equality of an entity. + For example, either kind is usable for a conditional GET of a full + entity. However, only a strong validator is usable for a sub-range + retrieval, since otherwise the client might end up with an internally + inconsistent entity. + + Clients MAY issue simple (non-subrange) GET requests with either weak + validators or strong validators. Clients MUST NOT use weak validators + in other forms of request. + + The only function that the HTTP/1.1 protocol defines on validators is + comparison. There are two validator comparison functions, depending + on whether the comparison context allows the use of weak validators + or not: + + - The strong comparison function: in order to be considered equal, + both validators MUST be identical in every way, and both MUST + NOT be weak. + + - The weak comparison function: in order to be considered equal, + both validators MUST be identical in every way, but either or + both of them MAY be tagged as "weak" without affecting the + result. + + An entity tag is strong unless it is explicitly tagged as weak. + Section 3.11 gives the syntax for entity tags. + + A Last-Modified time, when used as a validator in a request, is + implicitly weak unless it is possible to deduce that it is strong, + using the following rules: + + - The validator is being compared by an origin server to the + actual current validator for the entity and, + + + +Fielding, et al. Standards Track [Page 87] + +RFC 2616 HTTP/1.1 June 1999 + + + - That origin server reliably knows that the associated entity did + not change twice during the second covered by the presented + validator. + + or + + - The validator is about to be used by a client in an If- + Modified-Since or If-Unmodified-Since header, because the client + has a cache entry for the associated entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + or + + - The validator is being compared by an intermediate cache to the + validator stored in its cache entry for the entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + This method relies on the fact that if two different responses were + sent by the origin server during the same second, but both had the + same Last-Modified time, then at least one of those responses would + have a Date value equal to its Last-Modified time. The arbitrary 60- + second limit guards against the possibility that the Date and Last- + Modified values are generated from different clocks, or at somewhat + different times during the preparation of the response. An + implementation MAY use a value larger than 60 seconds, if it is + believed that 60 seconds is too short. + + If a client wishes to perform a sub-range retrieval on a value for + which it has only a Last-Modified time and no opaque validator, it + MAY do this only if the Last-Modified time is strong in the sense + described here. + + A cache or origin server receiving a conditional request, other than + a full-body GET request, MUST use the strong comparison function to + evaluate the condition. + + These rules allow HTTP/1.1 caches and clients to safely perform sub- + range retrievals on values that have been obtained from HTTP/1.0 + + + +Fielding, et al. Standards Track [Page 88] + +RFC 2616 HTTP/1.1 June 1999 + + + servers. + +13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates + + We adopt a set of rules and recommendations for origin servers, + clients, and caches regarding when various validator types ought to + be used, and for what purposes. + + HTTP/1.1 origin servers: + + - SHOULD send an entity tag validator unless it is not feasible to + generate one. + + - MAY send a weak entity tag instead of a strong entity tag, if + performance considerations support the use of weak entity tags, + or if it is unfeasible to send a strong entity tag. + + - SHOULD send a Last-Modified value if it is feasible to send one, + unless the risk of a breakdown in semantic transparency that + could result from using this date in an If-Modified-Since header + would lead to serious problems. + + In other words, the preferred behavior for an HTTP/1.1 origin server + is to send both a strong entity tag and a Last-Modified value. + + In order to be legal, a strong entity tag MUST change whenever the + associated entity value changes in any way. A weak entity tag SHOULD + change whenever the associated entity changes in a semantically + significant way. + + Note: in order to provide semantically transparent caching, an + origin server must avoid reusing a specific strong entity tag + value for two different entities, or reusing a specific weak + entity tag value for two semantically different entities. Cache + entries might persist for arbitrarily long periods, regardless of + expiration times, so it might be inappropriate to expect that a + cache will never again attempt to validate an entry using a + validator that it obtained at some point in the past. + + HTTP/1.1 clients: + + - If an entity tag has been provided by the origin server, MUST + use that entity tag in any cache-conditional request (using If- + Match or If-None-Match). + + - If only a Last-Modified value has been provided by the origin + server, SHOULD use that value in non-subrange cache-conditional + requests (using If-Modified-Since). + + + +Fielding, et al. Standards Track [Page 89] + +RFC 2616 HTTP/1.1 June 1999 + + + - If only a Last-Modified value has been provided by an HTTP/1.0 + origin server, MAY use that value in subrange cache-conditional + requests (using If-Unmodified-Since:). The user agent SHOULD + provide a way to disable this, in case of difficulty. + + - If both an entity tag and a Last-Modified value have been + provided by the origin server, SHOULD use both validators in + cache-conditional requests. This allows both HTTP/1.0 and + HTTP/1.1 caches to respond appropriately. + + An HTTP/1.1 origin server, upon receiving a conditional request that + includes both a Last-Modified date (e.g., in an If-Modified-Since or + If-Unmodified-Since header field) and one or more entity tags (e.g., + in an If-Match, If-None-Match, or If-Range header field) as cache + validators, MUST NOT return a response status of 304 (Not Modified) + unless doing so is consistent with all of the conditional header + fields in the request. + + An HTTP/1.1 caching proxy, upon receiving a conditional request that + includes both a Last-Modified date and one or more entity tags as + cache validators, MUST NOT return a locally cached response to the + client unless that cached response is consistent with all of the + conditional header fields in the request. + + Note: The general principle behind these rules is that HTTP/1.1 + servers and clients should transmit as much non-redundant + information as is available in their responses and requests. + HTTP/1.1 systems receiving this information will make the most + conservative assumptions about the validators they receive. + + HTTP/1.0 clients and caches will ignore entity tags. Generally, + last-modified values received or used by these systems will + support transparent and efficient caching, and so HTTP/1.1 origin + servers should provide Last-Modified values. In those rare cases + where the use of a Last-Modified value as a validator by an + HTTP/1.0 system could result in a serious problem, then HTTP/1.1 + origin servers should not provide one. + +13.3.5 Non-validating Conditionals + + The principle behind entity tags is that only the service author + knows the semantics of a resource well enough to select an + appropriate cache validation mechanism, and the specification of any + validator comparison function more complex than byte-equality would + open up a can of worms. Thus, comparisons of any other headers + (except Last-Modified, for compatibility with HTTP/1.0) are never + used for purposes of validating a cache entry. + + + + +Fielding, et al. Standards Track [Page 90] + +RFC 2616 HTTP/1.1 June 1999 + + +13.4 Response Cacheability + + Unless specifically constrained by a cache-control (section 14.9) + directive, a caching system MAY always store a successful response + (see section 13.8) as a cache entry, MAY return it without validation + if it is fresh, and MAY return it after successful validation. If + there is neither a cache validator nor an explicit expiration time + associated with a response, we do not expect it to be cached, but + certain caches MAY violate this expectation (for example, when little + or no network connectivity is available). A client can usually detect + that such a response was taken from a cache by comparing the Date + header to the current time. + + Note: some HTTP/1.0 caches are known to violate this expectation + without providing any Warning. + + However, in some cases it might be inappropriate for a cache to + retain an entity, or to return it in response to a subsequent + request. This might be because absolute semantic transparency is + deemed necessary by the service author, or because of security or + privacy considerations. Certain cache-control directives are + therefore provided so that the server can indicate that certain + resource entities, or portions thereof, are not to be cached + regardless of other considerations. + + Note that section 14.8 normally prevents a shared cache from saving + and returning a response to a previous request if that request + included an Authorization header. + + A response received with a status code of 200, 203, 206, 300, 301 or + 410 MAY be stored by a cache and used in reply to a subsequent + request, subject to the expiration mechanism, unless a cache-control + directive prohibits caching. However, a cache that does not support + the Range and Content-Range headers MUST NOT cache 206 (Partial + Content) responses. + + A response received with any other status code (e.g. status codes 302 + and 307) MUST NOT be returned in a reply to a subsequent request + unless there are cache-control directives or another header(s) that + explicitly allow it. For example, these include the following: an + Expires header (section 14.21); a "max-age", "s-maxage", "must- + revalidate", "proxy-revalidate", "public" or "private" cache-control + directive (section 14.9). + + + + + + + + +Fielding, et al. Standards Track [Page 91] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5 Constructing Responses From Caches + + The purpose of an HTTP cache is to store information received in + response to requests for use in responding to future requests. In + many cases, a cache simply returns the appropriate parts of a + response to the requester. However, if the cache holds a cache entry + based on a previous response, it might have to combine parts of a new + response with what is held in the cache entry. + +13.5.1 End-to-end and Hop-by-hop Headers + + For the purpose of defining the behavior of caches and non-caching + proxies, we divide HTTP headers into two categories: + + - End-to-end headers, which are transmitted to the ultimate + recipient of a request or response. End-to-end headers in + responses MUST be stored as part of a cache entry and MUST be + transmitted in any response formed from a cache entry. + + - Hop-by-hop headers, which are meaningful only for a single + transport-level connection, and are not stored by caches or + forwarded by proxies. + + The following HTTP/1.1 headers are hop-by-hop headers: + + - Connection + - Keep-Alive + - Proxy-Authenticate + - Proxy-Authorization + - TE + - Trailers + - Transfer-Encoding + - Upgrade + + All other headers defined by HTTP/1.1 are end-to-end headers. + + Other hop-by-hop headers MUST be listed in a Connection header, + (section 14.10) to be introduced into HTTP/1.1 (or later). + +13.5.2 Non-modifiable Headers + + Some features of the HTTP/1.1 protocol, such as Digest + Authentication, depend on the value of certain end-to-end headers. A + transparent proxy SHOULD NOT modify an end-to-end header unless the + definition of that header requires or specifically allows that. + + + + + + +Fielding, et al. Standards Track [Page 92] + +RFC 2616 HTTP/1.1 June 1999 + + + A transparent proxy MUST NOT modify any of the following fields in a + request or response, and it MUST NOT add any of these fields if not + already present: + + - Content-Location + + - Content-MD5 + + - ETag + + - Last-Modified + + A transparent proxy MUST NOT modify any of the following fields in a + response: + + - Expires + + but it MAY add any of these fields if not already present. If an + Expires header is added, it MUST be given a field-value identical to + that of the Date header in that response. + + A proxy MUST NOT modify or add any of the following fields in a + message that contains the no-transform cache-control directive, or in + any request: + + - Content-Encoding + + - Content-Range + + - Content-Type + + A non-transparent proxy MAY modify or add these fields to a message + that does not include no-transform, but if it does so, it MUST add a + Warning 214 (Transformation applied) if one does not already appear + in the message (see section 14.46). + + Warning: unnecessary modification of end-to-end headers might + cause authentication failures if stronger authentication + mechanisms are introduced in later versions of HTTP. Such + authentication mechanisms MAY rely on the values of header fields + not listed here. + + The Content-Length field of a request or response is added or deleted + according to the rules in section 4.4. A transparent proxy MUST + preserve the entity-length (section 7.2.2) of the entity-body, + although it MAY change the transfer-length (section 4.4). + + + + + +Fielding, et al. Standards Track [Page 93] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.3 Combining Headers + + When a cache makes a validating request to a server, and the server + provides a 304 (Not Modified) response or a 206 (Partial Content) + response, the cache then constructs a response to send to the + requesting client. + + If the status code is 304 (Not Modified), the cache uses the entity- + body stored in the cache entry as the entity-body of this outgoing + response. If the status code is 206 (Partial Content) and the ETag or + Last-Modified headers match exactly, the cache MAY combine the + contents stored in the cache entry with the new contents received in + the response and use the result as the entity-body of this outgoing + response, (see 13.5.4). + + The end-to-end headers stored in the cache entry are used for the + constructed response, except that + + - any stored Warning headers with warn-code 1xx (see section + 14.46) MUST be deleted from the cache entry and the forwarded + response. + + - any stored Warning headers with warn-code 2xx MUST be retained + in the cache entry and the forwarded response. + + - any end-to-end headers provided in the 304 or 206 response MUST + replace the corresponding headers from the cache entry. + + Unless the cache decides to remove the cache entry, it MUST also + replace the end-to-end headers stored with the cache entry with + corresponding headers received in the incoming response, except for + Warning headers as described immediately above. If a header field- + name in the incoming response matches more than one header in the + cache entry, all such old headers MUST be replaced. + + In other words, the set of end-to-end headers received in the + incoming response overrides all corresponding end-to-end headers + stored with the cache entry (except for stored Warning headers with + warn-code 1xx, which are deleted even if not overridden). + + Note: this rule allows an origin server to use a 304 (Not + Modified) or a 206 (Partial Content) response to update any header + associated with a previous response for the same entity or sub- + ranges thereof, although it might not always be meaningful or + correct to do so. This rule does not allow an origin server to use + a 304 (Not Modified) or a 206 (Partial Content) response to + entirely delete a header that it had provided with a previous + response. + + + +Fielding, et al. Standards Track [Page 94] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.4 Combining Byte Ranges + + A response might transfer only a subrange of the bytes of an entity- + body, either because the request included one or more Range + specifications, or because a connection was broken prematurely. After + several such transfers, a cache might have received several ranges of + the same entity-body. + + If a cache has a stored non-empty set of subranges for an entity, and + an incoming response transfers another subrange, the cache MAY + combine the new subrange with the existing set if both the following + conditions are met: + + - Both the incoming response and the cache entry have a cache + validator. + + - The two cache validators match using the strong comparison + function (see section 13.3.3). + + If either requirement is not met, the cache MUST use only the most + recent partial response (based on the Date values transmitted with + every response, and using the incoming response if these values are + equal or missing), and MUST discard the other partial information. + +13.6 Caching Negotiated Responses + + Use of server-driven content negotiation (section 12.1), as indicated + by the presence of a Vary header field in a response, alters the + conditions and procedure by which a cache can use the response for + subsequent requests. See section 14.44 for use of the Vary header + field by servers. + + A server SHOULD use the Vary header field to inform a cache of what + request-header fields were used to select among multiple + representations of a cacheable response subject to server-driven + negotiation. The set of header fields named by the Vary field value + is known as the "selecting" request-headers. + + When the cache receives a subsequent request whose Request-URI + specifies one or more cache entries including a Vary header field, + the cache MUST NOT use such a cache entry to construct a response to + the new request unless all of the selecting request-headers present + in the new request match the corresponding stored request-headers in + the original request. + + The selecting request-headers from two requests are defined to match + if and only if the selecting request-headers in the first request can + be transformed to the selecting request-headers in the second request + + + +Fielding, et al. Standards Track [Page 95] + +RFC 2616 HTTP/1.1 June 1999 + + + by adding or removing linear white space (LWS) at places where this + is allowed by the corresponding BNF, and/or combining multiple + message-header fields with the same field name following the rules + about message headers in section 4.2. + + A Vary header field-value of "*" always fails to match and subsequent + requests on that resource can only be properly interpreted by the + origin server. + + If the selecting request header fields for the cached entry do not + match the selecting request header fields of the new request, then + the cache MUST NOT use a cached entry to satisfy the request unless + it first relays the new request to the origin server in a conditional + request and the server responds with 304 (Not Modified), including an + entity tag or Content-Location that indicates the entity to be used. + + If an entity tag was assigned to a cached representation, the + forwarded request SHOULD be conditional and include the entity tags + in an If-None-Match header field from all its cache entries for the + resource. This conveys to the server the set of entities currently + held by the cache, so that if any one of these entities matches the + requested entity, the server can use the ETag header field in its 304 + (Not Modified) response to tell the cache which entry is appropriate. + If the entity-tag of the new response matches that of an existing + entry, the new response SHOULD be used to update the header fields of + the existing entry, and the result MUST be returned to the client. + + If any of the existing cache entries contains only partial content + for the associated entity, its entity-tag SHOULD NOT be included in + the If-None-Match header field unless the request is for a range that + would be fully satisfied by that entry. + + If a cache receives a successful response whose Content-Location + field matches that of an existing cache entry for the same Request- + ]URI, whose entity-tag differs from that of the existing entry, and + whose Date is more recent than that of the existing entry, the + existing entry SHOULD NOT be returned in response to future requests + and SHOULD be deleted from the cache. + +13.7 Shared and Non-Shared Caches + + For reasons of security and privacy, it is necessary to make a + distinction between "shared" and "non-shared" caches. A non-shared + cache is one that is accessible only to a single user. Accessibility + in this case SHOULD be enforced by appropriate security mechanisms. + All other caches are considered to be "shared." Other sections of + + + + + +Fielding, et al. Standards Track [Page 96] + +RFC 2616 HTTP/1.1 June 1999 + + + this specification place certain constraints on the operation of + shared caches in order to prevent loss of privacy or failure of + access controls. + +13.8 Errors or Incomplete Response Cache Behavior + + A cache that receives an incomplete response (for example, with fewer + bytes of data than specified in a Content-Length header) MAY store + the response. However, the cache MUST treat this as a partial + response. Partial responses MAY be combined as described in section + 13.5.4; the result might be a full response or might still be + partial. A cache MUST NOT return a partial response to a client + without explicitly marking it as such, using the 206 (Partial + Content) status code. A cache MUST NOT return a partial response + using a status code of 200 (OK). + + If a cache receives a 5xx response while attempting to revalidate an + entry, it MAY either forward this response to the requesting client, + or act as if the server failed to respond. In the latter case, it MAY + return a previously received response unless the cached entry + includes the "must-revalidate" cache-control directive (see section + 14.9). + +13.9 Side Effects of GET and HEAD + + Unless the origin server explicitly prohibits the caching of their + responses, the application of GET and HEAD methods to any resources + SHOULD NOT have side effects that would lead to erroneous behavior if + these responses are taken from a cache. They MAY still have side + effects, but a cache is not required to consider such side effects in + its caching decisions. Caches are always expected to observe an + origin server's explicit restrictions on caching. + + We note one exception to this rule: since some applications have + traditionally used GETs and HEADs with query URLs (those containing a + "?" in the rel_path part) to perform operations with significant side + effects, caches MUST NOT treat responses to such URIs as fresh unless + the server provides an explicit expiration time. This specifically + means that responses from HTTP/1.0 servers for such URIs SHOULD NOT + be taken from a cache. See section 9.1.1 for related information. + +13.10 Invalidation After Updates or Deletions + + The effect of certain methods performed on a resource at the origin + server might cause one or more existing cache entries to become non- + transparently invalid. That is, although they might continue to be + "fresh," they do not accurately reflect what the origin server would + return for a new request on that resource. + + + +Fielding, et al. Standards Track [Page 97] + +RFC 2616 HTTP/1.1 June 1999 + + + There is no way for the HTTP protocol to guarantee that all such + cache entries are marked invalid. For example, the request that + caused the change at the origin server might not have gone through + the proxy where a cache entry is stored. However, several rules help + reduce the likelihood of erroneous behavior. + + In this section, the phrase "invalidate an entity" means that the + cache will either remove all instances of that entity from its + storage, or will mark these as "invalid" and in need of a mandatory + revalidation before they can be returned in response to a subsequent + request. + + Some HTTP methods MUST cause a cache to invalidate an entity. This is + either the entity referred to by the Request-URI, or by the Location + or Content-Location headers (if present). These methods are: + + - PUT + + - DELETE + + - POST + + In order to prevent denial of service attacks, an invalidation based + on the URI in a Location or Content-Location header MUST only be + performed if the host part is the same as in the Request-URI. + + A cache that passes through requests for methods it does not + understand SHOULD invalidate any entities referred to by the + Request-URI. + +13.11 Write-Through Mandatory + + All methods that might be expected to cause modifications to the + origin server's resources MUST be written through to the origin + server. This currently includes all methods except for GET and HEAD. + A cache MUST NOT reply to such a request from a client before having + transmitted the request to the inbound server, and having received a + corresponding response from the inbound server. This does not prevent + a proxy cache from sending a 100 (Continue) response before the + inbound server has sent its final reply. + + The alternative (known as "write-back" or "copy-back" caching) is not + allowed in HTTP/1.1, due to the difficulty of providing consistent + updates and the problems arising from server, cache, or network + failure prior to write-back. + + + + + + +Fielding, et al. Standards Track [Page 98] + +RFC 2616 HTTP/1.1 June 1999 + + +13.12 Cache Replacement + + If a new cacheable (see sections 14.9.2, 13.2.5, 13.2.6 and 13.8) + response is received from a resource while any existing responses for + the same resource are cached, the cache SHOULD use the new response + to reply to the current request. It MAY insert it into cache storage + and MAY, if it meets all other requirements, use it to respond to any + future requests that would previously have caused the old response to + be returned. If it inserts the new response into cache storage the + rules in section 13.5.3 apply. + + Note: a new response that has an older Date header value than + existing cached responses is not cacheable. + +13.13 History Lists + + User agents often have history mechanisms, such as "Back" buttons and + history lists, which can be used to redisplay an entity retrieved + earlier in a session. + + History mechanisms and caches are different. In particular history + mechanisms SHOULD NOT try to show a semantically transparent view of + the current state of a resource. Rather, a history mechanism is meant + to show exactly what the user saw at the time when the resource was + retrieved. + + By default, an expiration time does not apply to history mechanisms. + If the entity is still in storage, a history mechanism SHOULD display + it even if the entity has expired, unless the user has specifically + configured the agent to refresh expired history documents. + + This is not to be construed to prohibit the history mechanism from + telling the user that a view might be stale. + + Note: if history list mechanisms unnecessarily prevent users from + viewing stale resources, this will tend to force service authors + to avoid using HTTP expiration controls and cache controls when + they would otherwise like to. Service authors may consider it + important that users not be presented with error messages or + warning messages when they use navigation controls (such as BACK) + to view previously fetched resources. Even though sometimes such + resources ought not to cached, or ought to expire quickly, user + interface considerations may force service authors to resort to + other means of preventing caching (e.g. "once-only" URLs) in order + not to suffer the effects of improperly functioning history + mechanisms. + + + + + +Fielding, et al. Standards Track [Page 99] + +RFC 2616 HTTP/1.1 June 1999 + + +14 Header Field Definitions + + This section defines the syntax and semantics of all standard + HTTP/1.1 header fields. For entity-header fields, both sender and + recipient refer to either the client or the server, depending on who + sends and who receives the entity. + +14.1 Accept + + The Accept request-header field can be used to specify certain media + types which are acceptable for the response. Accept headers can be + used to indicate that the request is specifically limited to a small + set of desired types, as in the case of a request for an in-line + image. + + Accept = "Accept" ":" + #( media-range [ accept-params ] ) + + media-range = ( "*/*" + | ( type "/" "*" ) + | ( type "/" subtype ) + ) *( ";" parameter ) + accept-params = ";" "q" "=" qvalue *( accept-extension ) + accept-extension = ";" token [ "=" ( token | quoted-string ) ] + + The asterisk "*" character is used to group media types into ranges, + with "*/*" indicating all media types and "type/*" indicating all + subtypes of that type. The media-range MAY include media type + parameters that are applicable to that range. + + Each media-range MAY be followed by one or more accept-params, + beginning with the "q" parameter for indicating a relative quality + factor. The first "q" parameter (if any) separates the media-range + parameter(s) from the accept-params. Quality factors allow the user + or user agent to indicate the relative degree of preference for that + media-range, using the qvalue scale from 0 to 1 (section 3.9). The + default value is q=1. + + Note: Use of the "q" parameter name to separate media type + parameters from Accept extension parameters is due to historical + practice. Although this prevents any media type parameter named + "q" from being used with a media range, such an event is believed + to be unlikely given the lack of any "q" parameters in the IANA + media type registry and the rare usage of any media type + parameters in Accept. Future media types are discouraged from + registering any parameter named "q". + + + + + +Fielding, et al. Standards Track [Page 100] + +RFC 2616 HTTP/1.1 June 1999 + + + The example + + Accept: audio/*; q=0.2, audio/basic + + SHOULD be interpreted as "I prefer audio/basic, but send me any audio + type if it is the best available after an 80% mark-down in quality." + + If no Accept header field is present, then it is assumed that the + client accepts all media types. If an Accept header field is present, + and if the server cannot send a response which is acceptable + according to the combined Accept field value, then the server SHOULD + send a 406 (not acceptable) response. + + A more elaborate example is + + Accept: text/plain; q=0.5, text/html, + text/x-dvi; q=0.8, text/x-c + + Verbally, this would be interpreted as "text/html and text/x-c are + the preferred media types, but if they do not exist, then send the + text/x-dvi entity, and if that does not exist, send the text/plain + entity." + + Media ranges can be overridden by more specific media ranges or + specific media types. If more than one media range applies to a given + type, the most specific reference has precedence. For example, + + Accept: text/*, text/html, text/html;level=1, */* + + have the following precedence: + + 1) text/html;level=1 + 2) text/html + 3) text/* + 4) */* + + The media type quality factor associated with a given type is + determined by finding the media range with the highest precedence + which matches that type. For example, + + Accept: text/*;q=0.3, text/html;q=0.7, text/html;level=1, + text/html;level=2;q=0.4, */*;q=0.5 + + would cause the following values to be associated: + + text/html;level=1 = 1 + text/html = 0.7 + text/plain = 0.3 + + + +Fielding, et al. Standards Track [Page 101] + +RFC 2616 HTTP/1.1 June 1999 + + + image/jpeg = 0.5 + text/html;level=2 = 0.4 + text/html;level=3 = 0.7 + + Note: A user agent might be provided with a default set of quality + values for certain media ranges. However, unless the user agent is + a closed system which cannot interact with other rendering agents, + this default set ought to be configurable by the user. + +14.2 Accept-Charset + + The Accept-Charset request-header field can be used to indicate what + character sets are acceptable for the response. This field allows + clients capable of understanding more comprehensive or special- + purpose character sets to signal that capability to a server which is + capable of representing documents in those character sets. + + Accept-Charset = "Accept-Charset" ":" + 1#( ( charset | "*" )[ ";" "q" "=" qvalue ] ) + + + Character set values are described in section 3.4. Each charset MAY + be given an associated quality value which represents the user's + preference for that charset. The default value is q=1. An example is + + Accept-Charset: iso-8859-5, unicode-1-1;q=0.8 + + The special value "*", if present in the Accept-Charset field, + matches every character set (including ISO-8859-1) which is not + mentioned elsewhere in the Accept-Charset field. If no "*" is present + in an Accept-Charset field, then all character sets not explicitly + mentioned get a quality value of 0, except for ISO-8859-1, which gets + a quality value of 1 if not explicitly mentioned. + + If no Accept-Charset header is present, the default is that any + character set is acceptable. If an Accept-Charset header is present, + and if the server cannot send a response which is acceptable + according to the Accept-Charset header, then the server SHOULD send + an error response with the 406 (not acceptable) status code, though + the sending of an unacceptable response is also allowed. + +14.3 Accept-Encoding + + The Accept-Encoding request-header field is similar to Accept, but + restricts the content-codings (section 3.5) that are acceptable in + the response. + + Accept-Encoding = "Accept-Encoding" ":" + + + +Fielding, et al. Standards Track [Page 102] + +RFC 2616 HTTP/1.1 June 1999 + + + 1#( codings [ ";" "q" "=" qvalue ] ) + codings = ( content-coding | "*" ) + + Examples of its use are: + + Accept-Encoding: compress, gzip + Accept-Encoding: + Accept-Encoding: * + Accept-Encoding: compress;q=0.5, gzip;q=1.0 + Accept-Encoding: gzip;q=1.0, identity; q=0.5, *;q=0 + + A server tests whether a content-coding is acceptable, according to + an Accept-Encoding field, using these rules: + + 1. If the content-coding is one of the content-codings listed in + the Accept-Encoding field, then it is acceptable, unless it is + accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + 2. The special "*" symbol in an Accept-Encoding field matches any + available content-coding not explicitly listed in the header + field. + + 3. If multiple content-codings are acceptable, then the acceptable + content-coding with the highest non-zero qvalue is preferred. + + 4. The "identity" content-coding is always acceptable, unless + specifically refused because the Accept-Encoding field includes + "identity;q=0", or because the field includes "*;q=0" and does + not explicitly include the "identity" content-coding. If the + Accept-Encoding field-value is empty, then only the "identity" + encoding is acceptable. + + If an Accept-Encoding field is present in a request, and if the + server cannot send a response which is acceptable according to the + Accept-Encoding header, then the server SHOULD send an error response + with the 406 (Not Acceptable) status code. + + If no Accept-Encoding field is present in a request, the server MAY + assume that the client will accept any content coding. In this case, + if "identity" is one of the available content-codings, then the + server SHOULD use the "identity" content-coding, unless it has + additional information that a different content-coding is meaningful + to the client. + + Note: If the request does not include an Accept-Encoding field, + and if the "identity" content-coding is unavailable, then + content-codings commonly understood by HTTP/1.0 clients (i.e., + + + +Fielding, et al. Standards Track [Page 103] + +RFC 2616 HTTP/1.1 June 1999 + + + "gzip" and "compress") are preferred; some older clients + improperly display messages sent with other content-codings. The + server might also make this decision based on information about + the particular user-agent or client. + + Note: Most HTTP/1.0 applications do not recognize or obey qvalues + associated with content-codings. This means that qvalues will not + work and are not permitted with x-gzip or x-compress. + +14.4 Accept-Language + + The Accept-Language request-header field is similar to Accept, but + restricts the set of natural languages that are preferred as a + response to the request. Language tags are defined in section 3.10. + + Accept-Language = "Accept-Language" ":" + 1#( language-range [ ";" "q" "=" qvalue ] ) + language-range = ( ( 1*8ALPHA *( "-" 1*8ALPHA ) ) | "*" ) + + Each language-range MAY be given an associated quality value which + represents an estimate of the user's preference for the languages + specified by that range. The quality value defaults to "q=1". For + example, + + Accept-Language: da, en-gb;q=0.8, en;q=0.7 + + would mean: "I prefer Danish, but will accept British English and + other types of English." A language-range matches a language-tag if + it exactly equals the tag, or if it exactly equals a prefix of the + tag such that the first tag character following the prefix is "-". + The special range "*", if present in the Accept-Language field, + matches every tag not matched by any other range present in the + Accept-Language field. + + Note: This use of a prefix matching rule does not imply that + language tags are assigned to languages in such a way that it is + always true that if a user understands a language with a certain + tag, then this user will also understand all languages with tags + for which this tag is a prefix. The prefix rule simply allows the + use of prefix tags if this is the case. + + The language quality factor assigned to a language-tag by the + Accept-Language field is the quality value of the longest language- + range in the field that matches the language-tag. If no language- + range in the field matches the tag, the language quality factor + assigned is 0. If no Accept-Language header is present in the + request, the server + + + + +Fielding, et al. Standards Track [Page 104] + +RFC 2616 HTTP/1.1 June 1999 + + + SHOULD assume that all languages are equally acceptable. If an + Accept-Language header is present, then all languages which are + assigned a quality factor greater than 0 are acceptable. + + It might be contrary to the privacy expectations of the user to send + an Accept-Language header with the complete linguistic preferences of + the user in every request. For a discussion of this issue, see + section 15.1.4. + + As intelligibility is highly dependent on the individual user, it is + recommended that client applications make the choice of linguistic + preference available to the user. If the choice is not made + available, then the Accept-Language header field MUST NOT be given in + the request. + + Note: When making the choice of linguistic preference available to + the user, we remind implementors of the fact that users are not + familiar with the details of language matching as described above, + and should provide appropriate guidance. As an example, users + might assume that on selecting "en-gb", they will be served any + kind of English document if British English is not available. A + user agent might suggest in such a case to add "en" to get the + best matching behavior. + +14.5 Accept-Ranges + + The Accept-Ranges response-header field allows the server to + indicate its acceptance of range requests for a resource: + + Accept-Ranges = "Accept-Ranges" ":" acceptable-ranges + acceptable-ranges = 1#range-unit | "none" + + Origin servers that accept byte-range requests MAY send + + Accept-Ranges: bytes + + but are not required to do so. Clients MAY generate byte-range + requests without having received this header for the resource + involved. Range units are defined in section 3.12. + + Servers that do not accept any kind of range request for a + resource MAY send + + Accept-Ranges: none + + to advise the client not to attempt a range request. + + + + + +Fielding, et al. Standards Track [Page 105] + +RFC 2616 HTTP/1.1 June 1999 + + +14.6 Age + + The Age response-header field conveys the sender's estimate of the + amount of time since the response (or its revalidation) was + generated at the origin server. A cached response is "fresh" if + its age does not exceed its freshness lifetime. Age values are + calculated as specified in section 13.2.3. + + Age = "Age" ":" age-value + age-value = delta-seconds + + Age values are non-negative decimal integers, representing time in + seconds. + + If a cache receives a value larger than the largest positive + integer it can represent, or if any of its age calculations + overflows, it MUST transmit an Age header with a value of + 2147483648 (2^31). An HTTP/1.1 server that includes a cache MUST + include an Age header field in every response generated from its + own cache. Caches SHOULD use an arithmetic type of at least 31 + bits of range. + +14.7 Allow + + The Allow entity-header field lists the set of methods supported + by the resource identified by the Request-URI. The purpose of this + field is strictly to inform the recipient of valid methods + associated with the resource. An Allow header field MUST be + present in a 405 (Method Not Allowed) response. + + Allow = "Allow" ":" #Method + + Example of use: + + Allow: GET, HEAD, PUT + + This field cannot prevent a client from trying other methods. + However, the indications given by the Allow header field value + SHOULD be followed. The actual set of allowed methods is defined + by the origin server at the time of each request. + + The Allow header field MAY be provided with a PUT request to + recommend the methods to be supported by the new or modified + resource. The server is not required to support these methods and + SHOULD include an Allow header in the response giving the actual + supported methods. + + + + + +Fielding, et al. Standards Track [Page 106] + +RFC 2616 HTTP/1.1 June 1999 + + + A proxy MUST NOT modify the Allow header field even if it does not + understand all the methods specified, since the user agent might + have other means of communicating with the origin server. + +14.8 Authorization + + A user agent that wishes to authenticate itself with a server-- + usually, but not necessarily, after receiving a 401 response--does + so by including an Authorization request-header field with the + request. The Authorization field value consists of credentials + containing the authentication information of the user agent for + the realm of the resource being requested. + + Authorization = "Authorization" ":" credentials + + HTTP access authentication is described in "HTTP Authentication: + Basic and Digest Access Authentication" [43]. If a request is + authenticated and a realm specified, the same credentials SHOULD + be valid for all other requests within this realm (assuming that + the authentication scheme itself does not require otherwise, such + as credentials that vary according to a challenge value or using + synchronized clocks). + + When a shared cache (see section 13.7) receives a request + containing an Authorization field, it MUST NOT return the + corresponding response as a reply to any other request, unless one + of the following specific exceptions holds: + + 1. If the response includes the "s-maxage" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But (if the specified maximum age has + passed) a proxy cache MUST first revalidate it with the origin + server, using the request-headers from the new request to allow + the origin server to authenticate the new request. (This is the + defined behavior for s-maxage.) If the response includes "s- + maxage=0", the proxy MUST always revalidate it before re-using + it. + + 2. If the response includes the "must-revalidate" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But if the response is stale, all caches + MUST first revalidate it with the origin server, using the + request-headers from the new request to allow the origin server + to authenticate the new request. + + 3. If the response includes the "public" cache-control directive, + it MAY be returned in reply to any subsequent request. + + + + +Fielding, et al. Standards Track [Page 107] + +RFC 2616 HTTP/1.1 June 1999 + + +14.9 Cache-Control + + The Cache-Control general-header field is used to specify directives + that MUST be obeyed by all caching mechanisms along the + request/response chain. The directives specify behavior intended to + prevent caches from adversely interfering with the request or + response. These directives typically override the default caching + algorithms. Cache directives are unidirectional in that the presence + of a directive in a request does not imply that the same directive is + to be given in the response. + + Note that HTTP/1.0 caches might not implement Cache-Control and + might only implement Pragma: no-cache (see section 14.32). + + Cache directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a cache- + directive for a specific cache. + + Cache-Control = "Cache-Control" ":" 1#cache-directive + + cache-directive = cache-request-directive + | cache-response-directive + + cache-request-directive = + "no-cache" ; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "max-age" "=" delta-seconds ; Section 14.9.3, 14.9.4 + | "max-stale" [ "=" delta-seconds ] ; Section 14.9.3 + | "min-fresh" "=" delta-seconds ; Section 14.9.3 + | "no-transform" ; Section 14.9.5 + | "only-if-cached" ; Section 14.9.4 + | cache-extension ; Section 14.9.6 + + cache-response-directive = + "public" ; Section 14.9.1 + | "private" [ "=" <"> 1#field-name <"> ] ; Section 14.9.1 + | "no-cache" [ "=" <"> 1#field-name <"> ]; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "no-transform" ; Section 14.9.5 + | "must-revalidate" ; Section 14.9.4 + | "proxy-revalidate" ; Section 14.9.4 + | "max-age" "=" delta-seconds ; Section 14.9.3 + | "s-maxage" "=" delta-seconds ; Section 14.9.3 + | cache-extension ; Section 14.9.6 + + cache-extension = token [ "=" ( token | quoted-string ) ] + + + +Fielding, et al. Standards Track [Page 108] + +RFC 2616 HTTP/1.1 June 1999 + + + When a directive appears without any 1#field-name parameter, the + directive applies to the entire request or response. When such a + directive appears with a 1#field-name parameter, it applies only to + the named field or fields, and not to the rest of the request or + response. This mechanism supports extensibility; implementations of + future versions of the HTTP protocol might apply these directives to + header fields not defined in HTTP/1.1. + + The cache-control directives can be broken down into these general + categories: + + - Restrictions on what are cacheable; these may only be imposed by + the origin server. + + - Restrictions on what may be stored by a cache; these may be + imposed by either the origin server or the user agent. + + - Modifications of the basic expiration mechanism; these may be + imposed by either the origin server or the user agent. + + - Controls over cache revalidation and reload; these may only be + imposed by a user agent. + + - Control over transformation of entities. + + - Extensions to the caching system. + +14.9.1 What is Cacheable + + By default, a response is cacheable if the requirements of the + request method, request header fields, and the response status + indicate that it is cacheable. Section 13.4 summarizes these defaults + for cacheability. The following Cache-Control response directives + allow an origin server to override the default cacheability of a + response: + + public + Indicates that the response MAY be cached by any cache, even if it + would normally be non-cacheable or cacheable only within a non- + shared cache. (See also Authorization, section 14.8, for + additional details.) + + private + Indicates that all or part of the response message is intended for + a single user and MUST NOT be cached by a shared cache. This + allows an origin server to state that the specified parts of the + + + + + +Fielding, et al. Standards Track [Page 109] + +RFC 2616 HTTP/1.1 June 1999 + + + response are intended for only one user and are not a valid + response for requests by other users. A private (non-shared) cache + MAY cache the response. + + Note: This usage of the word private only controls where the + response may be cached, and cannot ensure the privacy of the + message content. + + no-cache + If the no-cache directive does not specify a field-name, then a + cache MUST NOT use the response to satisfy a subsequent request + without successful revalidation with the origin server. This + allows an origin server to prevent caching even by caches that + have been configured to return stale responses to client requests. + + If the no-cache directive does specify one or more field-names, + then a cache MAY use the response to satisfy a subsequent request, + subject to any other restrictions on caching. However, the + specified field-name(s) MUST NOT be sent in the response to a + subsequent request without successful revalidation with the origin + server. This allows an origin server to prevent the re-use of + certain header fields in a response, while still allowing caching + of the rest of the response. + + Note: Most HTTP/1.0 caches will not recognize or obey this + directive. + +14.9.2 What May be Stored by Caches + + no-store + The purpose of the no-store directive is to prevent the + inadvertent release or retention of sensitive information (for + example, on backup tapes). The no-store directive applies to the + entire message, and MAY be sent either in a response or in a + request. If sent in a request, a cache MUST NOT store any part of + either this request or any response to it. If sent in a response, + a cache MUST NOT store any part of either this response or the + request that elicited it. This directive applies to both non- + shared and shared caches. "MUST NOT store" in this context means + that the cache MUST NOT intentionally store the information in + non-volatile storage, and MUST make a best-effort attempt to + remove the information from volatile storage as promptly as + possible after forwarding it. + + Even when this directive is associated with a response, users + might explicitly store such a response outside of the caching + system (e.g., with a "Save As" dialog). History buffers MAY store + such responses as part of their normal operation. + + + +Fielding, et al. Standards Track [Page 110] + +RFC 2616 HTTP/1.1 June 1999 + + + The purpose of this directive is to meet the stated requirements + of certain users and service authors who are concerned about + accidental releases of information via unanticipated accesses to + cache data structures. While the use of this directive might + improve privacy in some cases, we caution that it is NOT in any + way a reliable or sufficient mechanism for ensuring privacy. In + particular, malicious or compromised caches might not recognize or + obey this directive, and communications networks might be + vulnerable to eavesdropping. + +14.9.3 Modifications of the Basic Expiration Mechanism + + The expiration time of an entity MAY be specified by the origin + server using the Expires header (see section 14.21). Alternatively, + it MAY be specified using the max-age directive in a response. When + the max-age cache-control directive is present in a cached response, + the response is stale if its current age is greater than the age + value given (in seconds) at the time of a new request for that + resource. The max-age directive on a response implies that the + response is cacheable (i.e., "public") unless some other, more + restrictive cache directive is also present. + + If a response includes both an Expires header and a max-age + directive, the max-age directive overrides the Expires header, even + if the Expires header is more restrictive. This rule allows an origin + server to provide, for a given response, a longer expiration time to + an HTTP/1.1 (or later) cache than to an HTTP/1.0 cache. This might be + useful if certain HTTP/1.0 caches improperly calculate ages or + expiration times, perhaps due to desynchronized clocks. + + Many HTTP/1.0 cache implementations will treat an Expires value that + is less than or equal to the response Date value as being equivalent + to the Cache-Control response directive "no-cache". If an HTTP/1.1 + cache receives such a response, and the response does not include a + Cache-Control header field, it SHOULD consider the response to be + non-cacheable in order to retain compatibility with HTTP/1.0 servers. + + Note: An origin server might wish to use a relatively new HTTP + cache control feature, such as the "private" directive, on a + network including older caches that do not understand that + feature. The origin server will need to combine the new feature + with an Expires field whose value is less than or equal to the + Date value. This will prevent older caches from improperly + caching the response. + + + + + + + +Fielding, et al. Standards Track [Page 111] + +RFC 2616 HTTP/1.1 June 1999 + + + s-maxage + If a response includes an s-maxage directive, then for a shared + cache (but not for a private cache), the maximum age specified by + this directive overrides the maximum age specified by either the + max-age directive or the Expires header. The s-maxage directive + also implies the semantics of the proxy-revalidate directive (see + section 14.9.4), i.e., that the shared cache must not use the + entry after it becomes stale to respond to a subsequent request + without first revalidating it with the origin server. The s- + maxage directive is always ignored by a private cache. + + Note that most older caches, not compliant with this specification, + do not implement any cache-control directives. An origin server + wishing to use a cache-control directive that restricts, but does not + prevent, caching by an HTTP/1.1-compliant cache MAY exploit the + requirement that the max-age directive overrides the Expires header, + and the fact that pre-HTTP/1.1-compliant caches do not observe the + max-age directive. + + Other directives allow a user agent to modify the basic expiration + mechanism. These directives MAY be specified on a request: + + max-age + Indicates that the client is willing to accept a response whose + age is no greater than the specified time in seconds. Unless max- + stale directive is also included, the client is not willing to + accept a stale response. + + min-fresh + Indicates that the client is willing to accept a response whose + freshness lifetime is no less than its current age plus the + specified time in seconds. That is, the client wants a response + that will still be fresh for at least the specified number of + seconds. + + max-stale + Indicates that the client is willing to accept a response that has + exceeded its expiration time. If max-stale is assigned a value, + then the client is willing to accept a response that has exceeded + its expiration time by no more than the specified number of + seconds. If no value is assigned to max-stale, then the client is + willing to accept a stale response of any age. + + If a cache returns a stale response, either because of a max-stale + directive on a request, or because the cache is configured to + override the expiration time of a response, the cache MUST attach a + Warning header to the stale response, using Warning 110 (Response is + stale). + + + +Fielding, et al. Standards Track [Page 112] + +RFC 2616 HTTP/1.1 June 1999 + + + A cache MAY be configured to return stale responses without + validation, but only if this does not conflict with any "MUST"-level + requirements concerning cache validation (e.g., a "must-revalidate" + cache-control directive). + + If both the new request and the cached entry include "max-age" + directives, then the lesser of the two values is used for determining + the freshness of the cached entry for that request. + +14.9.4 Cache Revalidation and Reload Controls + + Sometimes a user agent might want or need to insist that a cache + revalidate its cache entry with the origin server (and not just with + the next cache along the path to the origin server), or to reload its + cache entry from the origin server. End-to-end revalidation might be + necessary if either the cache or the origin server has overestimated + the expiration time of the cached response. End-to-end reload may be + necessary if the cache entry has become corrupted for some reason. + + End-to-end revalidation may be requested either when the client does + not have its own local cached copy, in which case we call it + "unspecified end-to-end revalidation", or when the client does have a + local cached copy, in which case we call it "specific end-to-end + revalidation." + + The client can specify these three kinds of action using Cache- + Control request directives: + + End-to-end reload + The request includes a "no-cache" cache-control directive or, for + compatibility with HTTP/1.0 clients, "Pragma: no-cache". Field + names MUST NOT be included with the no-cache directive in a + request. The server MUST NOT use a cached copy when responding to + such a request. + + Specific end-to-end revalidation + The request includes a "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request includes a cache-validating conditional with + the client's current validator. + + Unspecified end-to-end revalidation + The request includes "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request does not include a cache-validating + + + + +Fielding, et al. Standards Track [Page 113] + +RFC 2616 HTTP/1.1 June 1999 + + + conditional; the first cache along the path (if any) that holds a + cache entry for this resource includes a cache-validating + conditional with its current validator. + + max-age + When an intermediate cache is forced, by means of a max-age=0 + directive, to revalidate its own cache entry, and the client has + supplied its own validator in the request, the supplied validator + might differ from the validator currently stored with the cache + entry. In this case, the cache MAY use either validator in making + its own request without affecting semantic transparency. + + However, the choice of validator might affect performance. The + best approach is for the intermediate cache to use its own + validator when making its request. If the server replies with 304 + (Not Modified), then the cache can return its now validated copy + to the client with a 200 (OK) response. If the server replies with + a new entity and cache validator, however, the intermediate cache + can compare the returned validator with the one provided in the + client's request, using the strong comparison function. If the + client's validator is equal to the origin server's, then the + intermediate cache simply returns 304 (Not Modified). Otherwise, + it returns the new entity with a 200 (OK) response. + + If a request includes the no-cache directive, it SHOULD NOT + include min-fresh, max-stale, or max-age. + + only-if-cached + In some cases, such as times of extremely poor network + connectivity, a client may want a cache to return only those + responses that it currently has stored, and not to reload or + revalidate with the origin server. To do this, the client may + include the only-if-cached directive in a request. If it receives + this directive, a cache SHOULD either respond using a cached entry + that is consistent with the other constraints of the request, or + respond with a 504 (Gateway Timeout) status. However, if a group + of caches is being operated as a unified system with good internal + connectivity, such a request MAY be forwarded within that group of + caches. + + must-revalidate + Because a cache MAY be configured to ignore a server's specified + expiration time, and because a client request MAY include a max- + stale directive (which has a similar effect), the protocol also + includes a mechanism for the origin server to require revalidation + of a cache entry on any subsequent use. When the must-revalidate + directive is present in a response received by a cache, that cache + MUST NOT use the entry after it becomes stale to respond to a + + + +Fielding, et al. Standards Track [Page 114] + +RFC 2616 HTTP/1.1 June 1999 + + + subsequent request without first revalidating it with the origin + server. (I.e., the cache MUST do an end-to-end revalidation every + time, if, based solely on the origin server's Expires or max-age + value, the cached response is stale.) + + The must-revalidate directive is necessary to support reliable + operation for certain protocol features. In all circumstances an + HTTP/1.1 cache MUST obey the must-revalidate directive; in + particular, if the cache cannot reach the origin server for any + reason, it MUST generate a 504 (Gateway Timeout) response. + + Servers SHOULD send the must-revalidate directive if and only if + failure to revalidate a request on the entity could result in + incorrect operation, such as a silently unexecuted financial + transaction. Recipients MUST NOT take any automated action that + violates this directive, and MUST NOT automatically provide an + unvalidated copy of the entity if revalidation fails. + + Although this is not recommended, user agents operating under + severe connectivity constraints MAY violate this directive but, if + so, MUST explicitly warn the user that an unvalidated response has + been provided. The warning MUST be provided on each unvalidated + access, and SHOULD require explicit user confirmation. + + proxy-revalidate + The proxy-revalidate directive has the same meaning as the must- + revalidate directive, except that it does not apply to non-shared + user agent caches. It can be used on a response to an + authenticated request to permit the user's cache to store and + later return the response without needing to revalidate it (since + it has already been authenticated once by that user), while still + requiring proxies that service many users to revalidate each time + (in order to make sure that each user has been authenticated). + Note that such authenticated responses also need the public cache + control directive in order to allow them to be cached at all. + +14.9.5 No-Transform Directive + + no-transform + Implementors of intermediate caches (proxies) have found it useful + to convert the media type of certain entity bodies. A non- + transparent proxy might, for example, convert between image + formats in order to save cache space or to reduce the amount of + traffic on a slow link. + + Serious operational problems occur, however, when these + transformations are applied to entity bodies intended for certain + kinds of applications. For example, applications for medical + + + +Fielding, et al. Standards Track [Page 115] + +RFC 2616 HTTP/1.1 June 1999 + + + imaging, scientific data analysis and those using end-to-end + authentication, all depend on receiving an entity body that is bit + for bit identical to the original entity-body. + + Therefore, if a message includes the no-transform directive, an + intermediate cache or proxy MUST NOT change those headers that are + listed in section 13.5.2 as being subject to the no-transform + directive. This implies that the cache or proxy MUST NOT change + any aspect of the entity-body that is specified by these headers, + including the value of the entity-body itself. + +14.9.6 Cache Control Extensions + + The Cache-Control header field can be extended through the use of one + or more cache-extension tokens, each with an optional assigned value. + Informational extensions (those which do not require a change in + cache behavior) MAY be added without changing the semantics of other + directives. Behavioral extensions are designed to work by acting as + modifiers to the existing base of cache directives. Both the new + directive and the standard directive are supplied, such that + applications which do not understand the new directive will default + to the behavior specified by the standard directive, and those that + understand the new directive will recognize it as modifying the + requirements associated with the standard directive. In this way, + extensions to the cache-control directives can be made without + requiring changes to the base protocol. + + This extension mechanism depends on an HTTP cache obeying all of the + cache-control directives defined for its native HTTP-version, obeying + certain extensions, and ignoring all directives that it does not + understand. + + For example, consider a hypothetical new response directive called + community which acts as a modifier to the private directive. We + define this new directive to mean that, in addition to any non-shared + cache, any cache which is shared only by members of the community + named within its value may cache the response. An origin server + wishing to allow the UCI community to use an otherwise private + response in their shared cache(s) could do so by including + + Cache-Control: private, community="UCI" + + A cache seeing this header field will act correctly even if the cache + does not understand the community cache-extension, since it will also + see and understand the private directive and thus default to the safe + behavior. + + + + + +Fielding, et al. Standards Track [Page 116] + +RFC 2616 HTTP/1.1 June 1999 + + + Unrecognized cache-directives MUST be ignored; it is assumed that any + cache-directive likely to be unrecognized by an HTTP/1.1 cache will + be combined with standard directives (or the response's default + cacheability) such that the cache behavior will remain minimally + correct even if the cache does not understand the extension(s). + +14.10 Connection + + The Connection general-header field allows the sender to specify + options that are desired for that particular connection and MUST NOT + be communicated by proxies over further connections. + + The Connection header has the following grammar: + + Connection = "Connection" ":" 1#(connection-token) + connection-token = token + + HTTP/1.1 proxies MUST parse the Connection header field before a + message is forwarded and, for each connection-token in this field, + remove any header field(s) from the message with the same name as the + connection-token. Connection options are signaled by the presence of + a connection-token in the Connection header field, not by any + corresponding additional header field(s), since the additional header + field may not be sent if there are no parameters associated with that + connection option. + + Message headers listed in the Connection header MUST NOT include + end-to-end headers, such as Cache-Control. + + HTTP/1.1 defines the "close" connection option for the sender to + signal that the connection will be closed after completion of the + response. For example, + + Connection: close + + in either the request or the response header fields indicates that + the connection SHOULD NOT be considered `persistent' (section 8.1) + after the current request/response is complete. + + HTTP/1.1 applications that do not support persistent connections MUST + include the "close" connection option in every message. + + A system receiving an HTTP/1.0 (or lower-version) message that + includes a Connection header MUST, for each connection-token in this + field, remove and ignore any header field(s) from the message with + the same name as the connection-token. This protects against mistaken + forwarding of such header fields by pre-HTTP/1.1 proxies. See section + 19.6.2. + + + +Fielding, et al. Standards Track [Page 117] + +RFC 2616 HTTP/1.1 June 1999 + + +14.11 Content-Encoding + + The Content-Encoding entity-header field is used as a modifier to the + media-type. When present, its value indicates what additional content + codings have been applied to the entity-body, and thus what decoding + mechanisms must be applied in order to obtain the media-type + referenced by the Content-Type header field. Content-Encoding is + primarily used to allow a document to be compressed without losing + the identity of its underlying media type. + + Content-Encoding = "Content-Encoding" ":" 1#content-coding + + Content codings are defined in section 3.5. An example of its use is + + Content-Encoding: gzip + + The content-coding is a characteristic of the entity identified by + the Request-URI. Typically, the entity-body is stored with this + encoding and is only decoded before rendering or analogous usage. + However, a non-transparent proxy MAY modify the content-coding if the + new coding is known to be acceptable to the recipient, unless the + "no-transform" cache-control directive is present in the message. + + If the content-coding of an entity is not "identity", then the + response MUST include a Content-Encoding entity-header (section + 14.11) that lists the non-identity content-coding(s) used. + + If the content-coding of an entity in a request message is not + acceptable to the origin server, the server SHOULD respond with a + status code of 415 (Unsupported Media Type). + + If multiple encodings have been applied to an entity, the content + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + +14.12 Content-Language + + The Content-Language entity-header field describes the natural + language(s) of the intended audience for the enclosed entity. Note + that this might not be equivalent to all the languages used within + the entity-body. + + Content-Language = "Content-Language" ":" 1#language-tag + + + + + + + +Fielding, et al. Standards Track [Page 118] + +RFC 2616 HTTP/1.1 June 1999 + + + Language tags are defined in section 3.10. The primary purpose of + Content-Language is to allow a user to identify and differentiate + entities according to the user's own preferred language. Thus, if the + body content is intended only for a Danish-literate audience, the + appropriate field is + + Content-Language: da + + If no Content-Language is specified, the default is that the content + is intended for all language audiences. This might mean that the + sender does not consider it to be specific to any natural language, + or that the sender does not know for which language it is intended. + + Multiple languages MAY be listed for content that is intended for + multiple audiences. For example, a rendition of the "Treaty of + Waitangi," presented simultaneously in the original Maori and English + versions, would call for + + Content-Language: mi, en + + However, just because multiple languages are present within an entity + does not mean that it is intended for multiple linguistic audiences. + An example would be a beginner's language primer, such as "A First + Lesson in Latin," which is clearly intended to be used by an + English-literate audience. In this case, the Content-Language would + properly only include "en". + + Content-Language MAY be applied to any media type -- it is not + limited to textual documents. + +14.13 Content-Length + + The Content-Length entity-header field indicates the size of the + entity-body, in decimal number of OCTETs, sent to the recipient or, + in the case of the HEAD method, the size of the entity-body that + would have been sent had the request been a GET. + + Content-Length = "Content-Length" ":" 1*DIGIT + + An example is + + Content-Length: 3495 + + Applications SHOULD use this field to indicate the transfer-length of + the message-body, unless this is prohibited by the rules in section + 4.4. + + + + + +Fielding, et al. Standards Track [Page 119] + +RFC 2616 HTTP/1.1 June 1999 + + + Any Content-Length greater than or equal to zero is a valid value. + Section 4.4 describes how to determine the length of a message-body + if a Content-Length is not given. + + Note that the meaning of this field is significantly different from + the corresponding definition in MIME, where it is an optional field + used within the "message/external-body" content-type. In HTTP, it + SHOULD be sent whenever the message's length can be determined prior + to being transferred, unless this is prohibited by the rules in + section 4.4. + +14.14 Content-Location + + The Content-Location entity-header field MAY be used to supply the + resource location for the entity enclosed in the message when that + entity is accessible from a location separate from the requested + resource's URI. A server SHOULD provide a Content-Location for the + variant corresponding to the response entity; especially in the case + where a resource has multiple entities associated with it, and those + entities actually have separate locations by which they might be + individually accessed, the server SHOULD provide a Content-Location + for the particular variant which is returned. + + Content-Location = "Content-Location" ":" + ( absoluteURI | relativeURI ) + + The value of Content-Location also defines the base URI for the + entity. + + The Content-Location value is not a replacement for the original + requested URI; it is only a statement of the location of the resource + corresponding to this particular entity at the time of the request. + Future requests MAY specify the Content-Location URI as the request- + URI if the desire is to identify the source of that particular + entity. + + A cache cannot assume that an entity with a Content-Location + different from the URI used to retrieve it can be used to respond to + later requests on that Content-Location URI. However, the Content- + Location can be used to differentiate between multiple entities + retrieved from a single requested resource, as described in section + 13.6. + + If the Content-Location is a relative URI, the relative URI is + interpreted relative to the Request-URI. + + The meaning of the Content-Location header in PUT or POST requests is + undefined; servers are free to ignore it in those cases. + + + +Fielding, et al. Standards Track [Page 120] + +RFC 2616 HTTP/1.1 June 1999 + + +14.15 Content-MD5 + + The Content-MD5 entity-header field, as defined in RFC 1864 [23], is + an MD5 digest of the entity-body for the purpose of providing an + end-to-end message integrity check (MIC) of the entity-body. (Note: a + MIC is good for detecting accidental modification of the entity-body + in transit, but is not proof against malicious attacks.) + + Content-MD5 = "Content-MD5" ":" md5-digest + md5-digest = + + The Content-MD5 header field MAY be generated by an origin server or + client to function as an integrity check of the entity-body. Only + origin servers or clients MAY generate the Content-MD5 header field; + proxies and gateways MUST NOT generate it, as this would defeat its + value as an end-to-end integrity check. Any recipient of the entity- + body, including gateways and proxies, MAY check that the digest value + in this header field matches that of the entity-body as received. + + The MD5 digest is computed based on the content of the entity-body, + including any content-coding that has been applied, but not including + any transfer-encoding applied to the message-body. If the message is + received with a transfer-encoding, that encoding MUST be removed + prior to checking the Content-MD5 value against the received entity. + + This has the result that the digest is computed on the octets of the + entity-body exactly as, and in the order that, they would be sent if + no transfer-encoding were being applied. + + HTTP extends RFC 1864 to permit the digest to be computed for MIME + composite media-types (e.g., multipart/* and message/rfc822), but + this does not change how the digest is computed as defined in the + preceding paragraph. + + There are several consequences of this. The entity-body for composite + types MAY contain many body-parts, each with its own MIME and HTTP + headers (including Content-MD5, Content-Transfer-Encoding, and + Content-Encoding headers). If a body-part has a Content-Transfer- + Encoding or Content-Encoding header, it is assumed that the content + of the body-part has had the encoding applied, and the body-part is + included in the Content-MD5 digest as is -- i.e., after the + application. The Transfer-Encoding header field is not allowed within + body-parts. + + Conversion of all line breaks to CRLF MUST NOT be done before + computing or checking the digest: the line break convention used in + the text actually transmitted MUST be left unaltered when computing + the digest. + + + +Fielding, et al. Standards Track [Page 121] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: while the definition of Content-MD5 is exactly the same for + HTTP as in RFC 1864 for MIME entity-bodies, there are several ways + in which the application of Content-MD5 to HTTP entity-bodies + differs from its application to MIME entity-bodies. One is that + HTTP, unlike MIME, does not use Content-Transfer-Encoding, and + does use Transfer-Encoding and Content-Encoding. Another is that + HTTP more frequently uses binary content types than MIME, so it is + worth noting that, in such cases, the byte order used to compute + the digest is the transmission byte order defined for the type. + Lastly, HTTP allows transmission of text types with any of several + line break conventions and not just the canonical form using CRLF. + +14.16 Content-Range + + The Content-Range entity-header is sent with a partial entity-body to + specify where in the full entity-body the partial body should be + applied. Range units are defined in section 3.12. + + Content-Range = "Content-Range" ":" content-range-spec + + content-range-spec = byte-content-range-spec + byte-content-range-spec = bytes-unit SP + byte-range-resp-spec "/" + ( instance-length | "*" ) + + byte-range-resp-spec = (first-byte-pos "-" last-byte-pos) + | "*" + instance-length = 1*DIGIT + + The header SHOULD indicate the total length of the full entity-body, + unless this length is unknown or difficult to determine. The asterisk + "*" character means that the instance-length is unknown at the time + when the response was generated. + + Unlike byte-ranges-specifier values (see section 14.35.1), a byte- + range-resp-spec MUST only specify one range, and MUST contain + absolute byte positions for both the first and last byte of the + range. + + A byte-content-range-spec with a byte-range-resp-spec whose last- + byte-pos value is less than its first-byte-pos value, or whose + instance-length value is less than or equal to its last-byte-pos + value, is invalid. The recipient of an invalid byte-content-range- + spec MUST ignore it and any content transferred along with it. + + A server sending a response with status code 416 (Requested range not + satisfiable) SHOULD include a Content-Range field with a byte-range- + resp-spec of "*". The instance-length specifies the current length of + + + +Fielding, et al. Standards Track [Page 122] + +RFC 2616 HTTP/1.1 June 1999 + + + the selected resource. A response with status code 206 (Partial + Content) MUST NOT include a Content-Range field with a byte-range- + resp-spec of "*". + + Examples of byte-content-range-spec values, assuming that the entity + contains a total of 1234 bytes: + + . The first 500 bytes: + bytes 0-499/1234 + + . The second 500 bytes: + bytes 500-999/1234 + + . All except for the first 500 bytes: + bytes 500-1233/1234 + + . The last 500 bytes: + bytes 734-1233/1234 + + When an HTTP message includes the content of a single range (for + example, a response to a request for a single range, or to a request + for a set of ranges that overlap without any holes), this content is + transmitted with a Content-Range header, and a Content-Length header + showing the number of bytes actually transferred. For example, + + HTTP/1.1 206 Partial content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-Range: bytes 21010-47021/47022 + Content-Length: 26012 + Content-Type: image/gif + + When an HTTP message includes the content of multiple ranges (for + example, a response to a request for multiple non-overlapping + ranges), these are transmitted as a multipart message. The multipart + media type used for this purpose is "multipart/byteranges" as defined + in appendix 19.2. See appendix 19.6.3 for a compatibility issue. + + A response to a request for a single range MUST NOT be sent using the + multipart/byteranges media type. A response to a request for + multiple ranges, whose result is a single range, MAY be sent as a + multipart/byteranges media type with one part. A client that cannot + decode a multipart/byteranges message MUST NOT ask for multiple + byte-ranges in a single request. + + When a client requests multiple byte-ranges in one request, the + server SHOULD return them in the order that they appeared in the + request. + + + +Fielding, et al. Standards Track [Page 123] + +RFC 2616 HTTP/1.1 June 1999 + + + If the server ignores a byte-range-spec because it is syntactically + invalid, the server SHOULD treat the request as if the invalid Range + header field did not exist. (Normally, this means return a 200 + response containing the full entity). + + If the server receives a request (other than one including an If- + Range request-header field) with an unsatisfiable Range request- + header field (that is, all of whose byte-range-spec values have a + first-byte-pos value greater than the current length of the selected + resource), it SHOULD return a response code of 416 (Requested range + not satisfiable) (section 10.4.17). + + Note: clients cannot depend on servers to send a 416 (Requested + range not satisfiable) response instead of a 200 (OK) response for + an unsatisfiable Range request-header, since not all servers + implement this request-header. + +14.17 Content-Type + + The Content-Type entity-header field indicates the media type of the + entity-body sent to the recipient or, in the case of the HEAD method, + the media type that would have been sent had the request been a GET. + + Content-Type = "Content-Type" ":" media-type + + Media types are defined in section 3.7. An example of the field is + + Content-Type: text/html; charset=ISO-8859-4 + + Further discussion of methods for identifying the media type of an + entity is provided in section 7.2.1. + +14.18 Date + + The Date general-header field represents the date and time at which + the message was originated, having the same semantics as orig-date in + RFC 822. The field value is an HTTP-date, as described in section + 3.3.1; it MUST be sent in RFC 1123 [8]-date format. + + Date = "Date" ":" HTTP-date + + An example is + + Date: Tue, 15 Nov 1994 08:12:31 GMT + + Origin servers MUST include a Date header field in all responses, + except in these cases: + + + + +Fielding, et al. Standards Track [Page 124] + +RFC 2616 HTTP/1.1 June 1999 + + + 1. If the response status code is 100 (Continue) or 101 (Switching + Protocols), the response MAY include a Date header field, at + the server's option. + + 2. If the response status code conveys a server error, e.g. 500 + (Internal Server Error) or 503 (Service Unavailable), and it is + inconvenient or impossible to generate a valid Date. + + 3. If the server does not have a clock that can provide a + reasonable approximation of the current time, its responses + MUST NOT include a Date header field. In this case, the rules + in section 14.18.1 MUST be followed. + + A received message that does not have a Date header field MUST be + assigned one by the recipient if the message will be cached by that + recipient or gatewayed via a protocol which requires a Date. An HTTP + implementation without a clock MUST NOT cache responses without + revalidating them on every use. An HTTP cache, especially a shared + cache, SHOULD use a mechanism, such as NTP [28], to synchronize its + clock with a reliable external standard. + + Clients SHOULD only send a Date header field in messages that include + an entity-body, as in the case of the PUT and POST requests, and even + then it is optional. A client without a clock MUST NOT send a Date + header field in a request. + + The HTTP-date sent in a Date header SHOULD NOT represent a date and + time subsequent to the generation of the message. It SHOULD represent + the best available approximation of the date and time of message + generation, unless the implementation has no means of generating a + reasonably accurate date and time. In theory, the date ought to + represent the moment just before the entity is generated. In + practice, the date can be generated at any time during the message + origination without affecting its semantic value. + +14.18.1 Clockless Origin Server Operation + + Some origin server implementations might not have a clock available. + An origin server without a clock MUST NOT assign Expires or Last- + Modified values to a response, unless these values were associated + with the resource by a system or user with a reliable clock. It MAY + assign an Expires value that is known, at or before server + configuration time, to be in the past (this allows "pre-expiration" + of responses without storing separate Expires values for each + resource). + + + + + + +Fielding, et al. Standards Track [Page 125] + +RFC 2616 HTTP/1.1 June 1999 + + +14.19 ETag + + The ETag response-header field provides the current value of the + entity tag for the requested variant. The headers used with entity + tags are described in sections 14.24, 14.26 and 14.44. The entity tag + MAY be used for comparison with other entities from the same resource + (see section 13.3.3). + + ETag = "ETag" ":" entity-tag + + Examples: + + ETag: "xyzzy" + ETag: W/"xyzzy" + ETag: "" + +14.20 Expect + + The Expect request-header field is used to indicate that particular + server behaviors are required by the client. + + Expect = "Expect" ":" 1#expectation + + expectation = "100-continue" | expectation-extension + expectation-extension = token [ "=" ( token | quoted-string ) + *expect-params ] + expect-params = ";" token [ "=" ( token | quoted-string ) ] + + + A server that does not understand or is unable to comply with any of + the expectation values in the Expect field of a request MUST respond + with appropriate error status. The server MUST respond with a 417 + (Expectation Failed) status if any of the expectations cannot be met + or, if there are other problems with the request, some other 4xx + status. + + This header field is defined with extensible syntax to allow for + future extensions. If a server receives a request containing an + Expect field that includes an expectation-extension that it does not + support, it MUST respond with a 417 (Expectation Failed) status. + + Comparison of expectation values is case-insensitive for unquoted + tokens (including the 100-continue token), and is case-sensitive for + quoted-string expectation-extensions. + + + + + + + +Fielding, et al. Standards Track [Page 126] + +RFC 2616 HTTP/1.1 June 1999 + + + The Expect mechanism is hop-by-hop: that is, an HTTP/1.1 proxy MUST + return a 417 (Expectation Failed) status if it receives a request + with an expectation that it cannot meet. However, the Expect + request-header itself is end-to-end; it MUST be forwarded if the + request is forwarded. + + Many older HTTP/1.0 and HTTP/1.1 applications do not understand the + Expect header. + + See section 8.2.3 for the use of the 100 (continue) status. + +14.21 Expires + + The Expires entity-header field gives the date/time after which the + response is considered stale. A stale cache entry may not normally be + returned by a cache (either a proxy cache or a user agent cache) + unless it is first validated with the origin server (or with an + intermediate cache that has a fresh copy of the entity). See section + 13.2 for further discussion of the expiration model. + + The presence of an Expires field does not imply that the original + resource will change or cease to exist at, before, or after that + time. + + The format is an absolute date and time as defined by HTTP-date in + section 3.3.1; it MUST be in RFC 1123 date format: + + Expires = "Expires" ":" HTTP-date + + An example of its use is + + Expires: Thu, 01 Dec 1994 16:00:00 GMT + + Note: if a response includes a Cache-Control field with the max- + age directive (see section 14.9.3), that directive overrides the + Expires field. + + HTTP/1.1 clients and caches MUST treat other invalid date formats, + especially including the value "0", as in the past (i.e., "already + expired"). + + To mark a response as "already expired," an origin server sends an + Expires date that is equal to the Date header value. (See the rules + for expiration calculations in section 13.2.4.) + + + + + + + +Fielding, et al. Standards Track [Page 127] + +RFC 2616 HTTP/1.1 June 1999 + + + To mark a response as "never expires," an origin server sends an + Expires date approximately one year from the time the response is + sent. HTTP/1.1 servers SHOULD NOT send Expires dates more than one + year in the future. + + The presence of an Expires header field with a date value of some + time in the future on a response that otherwise would by default be + non-cacheable indicates that the response is cacheable, unless + indicated otherwise by a Cache-Control header field (section 14.9). + +14.22 From + + The From request-header field, if given, SHOULD contain an Internet + e-mail address for the human user who controls the requesting user + agent. The address SHOULD be machine-usable, as defined by "mailbox" + in RFC 822 [9] as updated by RFC 1123 [8]: + + From = "From" ":" mailbox + + An example is: + + From: webmaster@w3.org + + This header field MAY be used for logging purposes and as a means for + identifying the source of invalid or unwanted requests. It SHOULD NOT + be used as an insecure form of access protection. The interpretation + of this field is that the request is being performed on behalf of the + person given, who accepts responsibility for the method performed. In + particular, robot agents SHOULD include this header so that the + person responsible for running the robot can be contacted if problems + occur on the receiving end. + + The Internet e-mail address in this field MAY be separate from the + Internet host which issued the request. For example, when a request + is passed through a proxy the original issuer's address SHOULD be + used. + + The client SHOULD NOT send the From header field without the user's + approval, as it might conflict with the user's privacy interests or + their site's security policy. It is strongly recommended that the + user be able to disable, enable, and modify the value of this field + at any time prior to a request. + +14.23 Host + + The Host request-header field specifies the Internet host and port + number of the resource being requested, as obtained from the original + URI given by the user or referring resource (generally an HTTP URL, + + + +Fielding, et al. Standards Track [Page 128] + +RFC 2616 HTTP/1.1 June 1999 + + + as described in section 3.2.2). The Host field value MUST represent + the naming authority of the origin server or gateway given by the + original URL. This allows the origin server or gateway to + differentiate between internally-ambiguous URLs, such as the root "/" + URL of a server for multiple host names on a single IP address. + + Host = "Host" ":" host [ ":" port ] ; Section 3.2.2 + + A "host" without any trailing port information implies the default + port for the service requested (e.g., "80" for an HTTP URL). For + example, a request on the origin server for + would properly include: + + GET /pub/WWW/ HTTP/1.1 + Host: www.w3.org + + A client MUST include a Host header field in all HTTP/1.1 request + messages . If the requested URI does not include an Internet host + name for the service being requested, then the Host header field MUST + be given with an empty value. An HTTP/1.1 proxy MUST ensure that any + request message it forwards does contain an appropriate Host header + field that identifies the service being requested by the proxy. All + Internet-based HTTP/1.1 servers MUST respond with a 400 (Bad Request) + status code to any HTTP/1.1 request message which lacks a Host header + field. + + See sections 5.2 and 19.6.1.1 for other requirements relating to + Host. + +14.24 If-Match + + The If-Match request-header field is used with a method to make it + conditional. A client that has one or more entities previously + obtained from the resource can verify that one of those entities is + current by including a list of their associated entity tags in the + If-Match header field. Entity tags are defined in section 3.11. The + purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. It is also + used, on updating requests, to prevent inadvertent modification of + the wrong version of a resource. As a special case, the value "*" + matches any current entity of the resource. + + If-Match = "If-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-Match header) on that resource, or if "*" is given + + + + +Fielding, et al. Standards Track [Page 129] + +RFC 2616 HTTP/1.1 June 1999 + + + and any current entity exists for that resource, then the server MAY + perform the requested method as if the If-Match header field did not + exist. + + A server MUST use the strong comparison function (see section 13.3.3) + to compare the entity tags in If-Match. + + If none of the entity tags match, or if "*" is given and no current + entity exists, the server MUST NOT perform the requested method, and + MUST return a 412 (Precondition Failed) response. This behavior is + most useful when the client wants to prevent an updating method, such + as PUT, from modifying a resource that has changed since the client + last retrieved it. + + If the request would, without the If-Match header field, result in + anything other than a 2xx or 412 status, then the If-Match header + MUST be ignored. + + The meaning of "If-Match: *" is that the method SHOULD be performed + if the representation selected by the origin server (or by a cache, + possibly using the Vary mechanism, see section 14.44) exists, and + MUST NOT be performed if the representation does not exist. + + A request intended to update a resource (e.g., a PUT) MAY include an + If-Match header field to signal that the request method MUST NOT be + applied if the entity corresponding to the If-Match value (a single + entity tag) is no longer a representation of that resource. This + allows the user to indicate that they do not wish the request to be + successful if the resource has been changed without their knowledge. + Examples: + + If-Match: "xyzzy" + If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-Match: * + + The result of a request having both an If-Match header field and + either an If-None-Match or an If-Modified-Since header fields is + undefined by this specification. + +14.25 If-Modified-Since + + The If-Modified-Since request-header field is used with a method to + make it conditional: if the requested variant has not been modified + since the time specified in this field, an entity will not be + returned from the server; instead, a 304 (not modified) response will + be returned without any message-body. + + If-Modified-Since = "If-Modified-Since" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 130] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of the field is: + + If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + A GET method with an If-Modified-Since header and no Range header + requests that the identified entity be transferred only if it has + been modified since the date given by the If-Modified-Since header. + The algorithm for determining this includes the following cases: + + a) If the request would normally result in anything other than a + 200 (OK) status, or if the passed If-Modified-Since date is + invalid, the response is exactly the same as for a normal GET. + A date which is later than the server's current time is + invalid. + + b) If the variant has been modified since the If-Modified-Since + date, the response is exactly the same as for a normal GET. + + c) If the variant has not been modified since a valid If- + Modified-Since date, the server SHOULD return a 304 (Not + Modified) response. + + The purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. + + Note: The Range request-header field modifies the meaning of If- + Modified-Since; see section 14.35 for full details. + + Note: If-Modified-Since times are interpreted by the server, whose + clock might not be synchronized with the client. + + Note: When handling an If-Modified-Since header field, some + servers will use an exact date comparison function, rather than a + less-than function, for deciding whether to send a 304 (Not + Modified) response. To get best results when sending an If- + Modified-Since header field for cache validation, clients are + advised to use the exact date string received in a previous Last- + Modified header field whenever possible. + + Note: If a client uses an arbitrary date in the If-Modified-Since + header instead of a date taken from the Last-Modified header for + the same request, the client should be aware of the fact that this + date is interpreted in the server's understanding of time. The + client should consider unsynchronized clocks and rounding problems + due to the different encodings of time between the client and + server. This includes the possibility of race conditions if the + document has changed between the time it was first requested and + the If-Modified-Since date of a subsequent request, and the + + + +Fielding, et al. Standards Track [Page 131] + +RFC 2616 HTTP/1.1 June 1999 + + + possibility of clock-skew-related problems if the If-Modified- + Since date is derived from the client's clock without correction + to the server's clock. Corrections for different time bases + between client and server are at best approximate due to network + latency. + + The result of a request having both an If-Modified-Since header field + and either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.26 If-None-Match + + The If-None-Match request-header field is used with a method to make + it conditional. A client that has one or more entities previously + obtained from the resource can verify that none of those entities is + current by including a list of their associated entity tags in the + If-None-Match header field. The purpose of this feature is to allow + efficient updates of cached information with a minimum amount of + transaction overhead. It is also used to prevent a method (e.g. PUT) + from inadvertently modifying an existing resource when the client + believes that the resource does not exist. + + As a special case, the value "*" matches any current entity of the + resource. + + If-None-Match = "If-None-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-None-Match header) on that resource, or if "*" is + given and any current entity exists for that resource, then the + server MUST NOT perform the requested method, unless required to do + so because the resource's modification date fails to match that + supplied in an If-Modified-Since header field in the request. + Instead, if the request method was GET or HEAD, the server SHOULD + respond with a 304 (Not Modified) response, including the cache- + related header fields (particularly ETag) of one of the entities that + matched. For all other request methods, the server MUST respond with + a status of 412 (Precondition Failed). + + See section 13.3.3 for rules on how to determine if two entities tags + match. The weak comparison function can only be used with GET or HEAD + requests. + + + + + + + + +Fielding, et al. Standards Track [Page 132] + +RFC 2616 HTTP/1.1 June 1999 + + + If none of the entity tags match, then the server MAY perform the + requested method as if the If-None-Match header field did not exist, + but MUST also ignore any If-Modified-Since header field(s) in the + request. That is, if no entity tags match, then the server MUST NOT + return a 304 (Not Modified) response. + + If the request would, without the If-None-Match header field, result + in anything other than a 2xx or 304 status, then the If-None-Match + header MUST be ignored. (See section 13.3.4 for a discussion of + server behavior when both If-Modified-Since and If-None-Match appear + in the same request.) + + The meaning of "If-None-Match: *" is that the method MUST NOT be + performed if the representation selected by the origin server (or by + a cache, possibly using the Vary mechanism, see section 14.44) + exists, and SHOULD be performed if the representation does not exist. + This feature is intended to be useful in preventing races between PUT + operations. + + Examples: + + If-None-Match: "xyzzy" + If-None-Match: W/"xyzzy" + If-None-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-None-Match: W/"xyzzy", W/"r2d2xxxx", W/"c3piozzzz" + If-None-Match: * + + The result of a request having both an If-None-Match header field and + either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.27 If-Range + + If a client has a partial copy of an entity in its cache, and wishes + to have an up-to-date copy of the entire entity in its cache, it + could use the Range request-header with a conditional GET (using + either or both of If-Unmodified-Since and If-Match.) However, if the + condition fails because the entity has been modified, the client + would then have to make a second request to obtain the entire current + entity-body. + + The If-Range header allows a client to "short-circuit" the second + request. Informally, its meaning is `if the entity is unchanged, send + me the part(s) that I am missing; otherwise, send me the entire new + entity'. + + If-Range = "If-Range" ":" ( entity-tag | HTTP-date ) + + + + +Fielding, et al. Standards Track [Page 133] + +RFC 2616 HTTP/1.1 June 1999 + + + If the client has no entity tag for an entity, but does have a Last- + Modified date, it MAY use that date in an If-Range header. (The + server can distinguish between a valid HTTP-date and any form of + entity-tag by examining no more than two characters.) The If-Range + header SHOULD only be used together with a Range header, and MUST be + ignored if the request does not include a Range header, or if the + server does not support the sub-range operation. + + If the entity tag given in the If-Range header matches the current + entity tag for the entity, then the server SHOULD provide the + specified sub-range of the entity using a 206 (Partial content) + response. If the entity tag does not match, then the server SHOULD + return the entire entity using a 200 (OK) response. + +14.28 If-Unmodified-Since + + The If-Unmodified-Since request-header field is used with a method to + make it conditional. If the requested resource has not been modified + since the time specified in this field, the server SHOULD perform the + requested operation as if the If-Unmodified-Since header were not + present. + + If the requested variant has been modified since the specified time, + the server MUST NOT perform the requested operation, and MUST return + a 412 (Precondition Failed). + + If-Unmodified-Since = "If-Unmodified-Since" ":" HTTP-date + + An example of the field is: + + If-Unmodified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + If the request normally (i.e., without the If-Unmodified-Since + header) would result in anything other than a 2xx or 412 status, the + If-Unmodified-Since header SHOULD be ignored. + + If the specified date is invalid, the header is ignored. + + The result of a request having both an If-Unmodified-Since header + field and either an If-None-Match or an If-Modified-Since header + fields is undefined by this specification. + +14.29 Last-Modified + + The Last-Modified entity-header field indicates the date and time at + which the origin server believes the variant was last modified. + + Last-Modified = "Last-Modified" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 134] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of its use is + + Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT + + The exact meaning of this header field depends on the implementation + of the origin server and the nature of the original resource. For + files, it may be just the file system last-modified time. For + entities with dynamically included parts, it may be the most recent + of the set of last-modify times for its component parts. For database + gateways, it may be the last-update time stamp of the record. For + virtual objects, it may be the last time the internal state changed. + + An origin server MUST NOT send a Last-Modified date which is later + than the server's time of message origination. In such cases, where + the resource's last modification would indicate some time in the + future, the server MUST replace that date with the message + origination date. + + An origin server SHOULD obtain the Last-Modified value of the entity + as close as possible to the time that it generates the Date value of + its response. This allows a recipient to make an accurate assessment + of the entity's modification time, especially if the entity changes + near the time that the response is generated. + + HTTP/1.1 servers SHOULD send Last-Modified whenever feasible. + +14.30 Location + + The Location response-header field is used to redirect the recipient + to a location other than the Request-URI for completion of the + request or identification of a new resource. For 201 (Created) + responses, the Location is that of the new resource which was created + by the request. For 3xx responses, the location SHOULD indicate the + server's preferred URI for automatic redirection to the resource. The + field value consists of a single absolute URI. + + Location = "Location" ":" absoluteURI + + An example is: + + Location: http://www.w3.org/pub/WWW/People.html + + Note: The Content-Location header field (section 14.14) differs + from Location in that the Content-Location identifies the original + location of the entity enclosed in the request. It is therefore + possible for a response to contain header fields for both Location + and Content-Location. Also see section 13.10 for cache + requirements of some methods. + + + +Fielding, et al. Standards Track [Page 135] + +RFC 2616 HTTP/1.1 June 1999 + + +14.31 Max-Forwards + + The Max-Forwards request-header field provides a mechanism with the + TRACE (section 9.8) and OPTIONS (section 9.2) methods to limit the + number of proxies or gateways that can forward the request to the + next inbound server. This can be useful when the client is attempting + to trace a request chain which appears to be failing or looping in + mid-chain. + + Max-Forwards = "Max-Forwards" ":" 1*DIGIT + + The Max-Forwards value is a decimal integer indicating the remaining + number of times this request message may be forwarded. + + Each proxy or gateway recipient of a TRACE or OPTIONS request + containing a Max-Forwards header field MUST check and update its + value prior to forwarding the request. If the received value is zero + (0), the recipient MUST NOT forward the request; instead, it MUST + respond as the final recipient. If the received Max-Forwards value is + greater than zero, then the forwarded message MUST contain an updated + Max-Forwards field with a value decremented by one (1). + + The Max-Forwards header field MAY be ignored for all other methods + defined by this specification and for any extension methods for which + it is not explicitly referred to as part of that method definition. + +14.32 Pragma + + The Pragma general-header field is used to include implementation- + specific directives that might apply to any recipient along the + request/response chain. All pragma directives specify optional + behavior from the viewpoint of the protocol; however, some systems + MAY require that behavior be consistent with the directives. + + Pragma = "Pragma" ":" 1#pragma-directive + pragma-directive = "no-cache" | extension-pragma + extension-pragma = token [ "=" ( token | quoted-string ) ] + + When the no-cache directive is present in a request message, an + application SHOULD forward the request toward the origin server even + if it has a cached copy of what is being requested. This pragma + directive has the same semantics as the no-cache cache-directive (see + section 14.9) and is defined here for backward compatibility with + HTTP/1.0. Clients SHOULD include both header fields when a no-cache + request is sent to a server not known to be HTTP/1.1 compliant. + + + + + + +Fielding, et al. Standards Track [Page 136] + +RFC 2616 HTTP/1.1 June 1999 + + + Pragma directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a pragma for a + specific recipient; however, any pragma directive not relevant to a + recipient SHOULD be ignored by that recipient. + + HTTP/1.1 caches SHOULD treat "Pragma: no-cache" as if the client had + sent "Cache-Control: no-cache". No new Pragma directives will be + defined in HTTP. + + Note: because the meaning of "Pragma: no-cache as a response + header field is not actually specified, it does not provide a + reliable replacement for "Cache-Control: no-cache" in a response + +14.33 Proxy-Authenticate + + The Proxy-Authenticate response-header field MUST be included as part + of a 407 (Proxy Authentication Required) response. The field value + consists of a challenge that indicates the authentication scheme and + parameters applicable to the proxy for this Request-URI. + + Proxy-Authenticate = "Proxy-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. Unlike + WWW-Authenticate, the Proxy-Authenticate header field applies only to + the current connection and SHOULD NOT be passed on to downstream + clients. However, an intermediate proxy might need to obtain its own + credentials by requesting them from the downstream client, which in + some circumstances will appear as if the proxy is forwarding the + Proxy-Authenticate header field. + +14.34 Proxy-Authorization + + The Proxy-Authorization request-header field allows the client to + identify itself (or its user) to a proxy which requires + authentication. The Proxy-Authorization field value consists of + credentials containing the authentication information of the user + agent for the proxy and/or realm of the resource being requested. + + Proxy-Authorization = "Proxy-Authorization" ":" credentials + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43] . Unlike + Authorization, the Proxy-Authorization header field applies only to + the next outbound proxy that demanded authentication using the Proxy- + Authenticate field. When multiple proxies are used in a chain, the + + + +Fielding, et al. Standards Track [Page 137] + +RFC 2616 HTTP/1.1 June 1999 + + + Proxy-Authorization header field is consumed by the first outbound + proxy that was expecting to receive credentials. A proxy MAY relay + the credentials from the client request to the next proxy if that is + the mechanism by which the proxies cooperatively authenticate a given + request. + +14.35 Range + +14.35.1 Byte Ranges + + Since all HTTP entities are represented in HTTP messages as sequences + of bytes, the concept of a byte range is meaningful for any HTTP + entity. (However, not all clients and servers need to support byte- + range operations.) + + Byte range specifications in HTTP apply to the sequence of bytes in + the entity-body (not necessarily the same as the message-body). + + A byte range operation MAY specify a single range of bytes, or a set + of ranges within a single entity. + + ranges-specifier = byte-ranges-specifier + byte-ranges-specifier = bytes-unit "=" byte-range-set + byte-range-set = 1#( byte-range-spec | suffix-byte-range-spec ) + byte-range-spec = first-byte-pos "-" [last-byte-pos] + first-byte-pos = 1*DIGIT + last-byte-pos = 1*DIGIT + + The first-byte-pos value in a byte-range-spec gives the byte-offset + of the first byte in a range. The last-byte-pos value gives the + byte-offset of the last byte in the range; that is, the byte + positions specified are inclusive. Byte offsets start at zero. + + If the last-byte-pos value is present, it MUST be greater than or + equal to the first-byte-pos in that byte-range-spec, or the byte- + range-spec is syntactically invalid. The recipient of a byte-range- + set that includes one or more syntactically invalid byte-range-spec + values MUST ignore the header field that includes that byte-range- + set. + + If the last-byte-pos value is absent, or if the value is greater than + or equal to the current length of the entity-body, last-byte-pos is + taken to be equal to one less than the current length of the entity- + body in bytes. + + By its choice of last-byte-pos, a client can limit the number of + bytes retrieved without knowing the size of the entity. + + + + +Fielding, et al. Standards Track [Page 138] + +RFC 2616 HTTP/1.1 June 1999 + + + suffix-byte-range-spec = "-" suffix-length + suffix-length = 1*DIGIT + + A suffix-byte-range-spec is used to specify the suffix of the + entity-body, of a length given by the suffix-length value. (That is, + this form specifies the last N bytes of an entity-body.) If the + entity is shorter than the specified suffix-length, the entire + entity-body is used. + + If a syntactically valid byte-range-set includes at least one byte- + range-spec whose first-byte-pos is less than the current length of + the entity-body, or at least one suffix-byte-range-spec with a non- + zero suffix-length, then the byte-range-set is satisfiable. + Otherwise, the byte-range-set is unsatisfiable. If the byte-range-set + is unsatisfiable, the server SHOULD return a response with a status + of 416 (Requested range not satisfiable). Otherwise, the server + SHOULD return a response with a status of 206 (Partial Content) + containing the satisfiable ranges of the entity-body. + + Examples of byte-ranges-specifier values (assuming an entity-body of + length 10000): + + - The first 500 bytes (byte offsets 0-499, inclusive): bytes=0- + 499 + + - The second 500 bytes (byte offsets 500-999, inclusive): + bytes=500-999 + + - The final 500 bytes (byte offsets 9500-9999, inclusive): + bytes=-500 + + - Or bytes=9500- + + - The first and last bytes only (bytes 0 and 9999): bytes=0-0,-1 + + - Several legal but not canonical specifications of the second 500 + bytes (byte offsets 500-999, inclusive): + bytes=500-600,601-999 + bytes=500-700,601-999 + +14.35.2 Range Retrieval Requests + + HTTP retrieval requests using conditional or unconditional GET + methods MAY request one or more sub-ranges of the entity, instead of + the entire entity, using the Range request header, which applies to + the entity returned as the result of the request: + + Range = "Range" ":" ranges-specifier + + + +Fielding, et al. Standards Track [Page 139] + +RFC 2616 HTTP/1.1 June 1999 + + + A server MAY ignore the Range header. However, HTTP/1.1 origin + servers and intermediate caches ought to support byte ranges when + possible, since Range supports efficient recovery from partially + failed transfers, and supports efficient partial retrieval of large + entities. + + If the server supports the Range header and the specified range or + ranges are appropriate for the entity: + + - The presence of a Range header in an unconditional GET modifies + what is returned if the GET is otherwise successful. In other + words, the response carries a status code of 206 (Partial + Content) instead of 200 (OK). + + - The presence of a Range header in a conditional GET (a request + using one or both of If-Modified-Since and If-None-Match, or + one or both of If-Unmodified-Since and If-Match) modifies what + is returned if the GET is otherwise successful and the + condition is true. It does not affect the 304 (Not Modified) + response returned if the conditional is false. + + In some cases, it might be more appropriate to use the If-Range + header (see section 14.27) in addition to the Range header. + + If a proxy that supports ranges receives a Range request, forwards + the request to an inbound server, and receives an entire entity in + reply, it SHOULD only return the requested range to its client. It + SHOULD store the entire received response in its cache if that is + consistent with its cache allocation policies. + +14.36 Referer + + The Referer[sic] request-header field allows the client to specify, + for the server's benefit, the address (URI) of the resource from + which the Request-URI was obtained (the "referrer", although the + header field is misspelled.) The Referer request-header allows a + server to generate lists of back-links to resources for interest, + logging, optimized caching, etc. It also allows obsolete or mistyped + links to be traced for maintenance. The Referer field MUST NOT be + sent if the Request-URI was obtained from a source that does not have + its own URI, such as input from the user keyboard. + + Referer = "Referer" ":" ( absoluteURI | relativeURI ) + + Example: + + Referer: http://www.w3.org/hypertext/DataSources/Overview.html + + + + +Fielding, et al. Standards Track [Page 140] + +RFC 2616 HTTP/1.1 June 1999 + + + If the field value is a relative URI, it SHOULD be interpreted + relative to the Request-URI. The URI MUST NOT include a fragment. See + section 15.1.3 for security considerations. + +14.37 Retry-After + + The Retry-After response-header field can be used with a 503 (Service + Unavailable) response to indicate how long the service is expected to + be unavailable to the requesting client. This field MAY also be used + with any 3xx (Redirection) response to indicate the minimum time the + user-agent is asked wait before issuing the redirected request. The + value of this field can be either an HTTP-date or an integer number + of seconds (in decimal) after the time of the response. + + Retry-After = "Retry-After" ":" ( HTTP-date | delta-seconds ) + + Two examples of its use are + + Retry-After: Fri, 31 Dec 1999 23:59:59 GMT + Retry-After: 120 + + In the latter example, the delay is 2 minutes. + +14.38 Server + + The Server response-header field contains information about the + software used by the origin server to handle the request. The field + can contain multiple product tokens (section 3.8) and comments + identifying the server and any significant subproducts. The product + tokens are listed in order of their significance for identifying the + application. + + Server = "Server" ":" 1*( product | comment ) + + Example: + + Server: CERN/3.0 libwww/2.17 + + If the response is being forwarded through a proxy, the proxy + application MUST NOT modify the Server response-header. Instead, it + SHOULD include a Via field (as described in section 14.45). + + Note: Revealing the specific software version of the server might + allow the server machine to become more vulnerable to attacks + against software that is known to contain security holes. Server + implementors are encouraged to make this field a configurable + option. + + + + +Fielding, et al. Standards Track [Page 141] + +RFC 2616 HTTP/1.1 June 1999 + + +14.39 TE + + The TE request-header field indicates what extension transfer-codings + it is willing to accept in the response and whether or not it is + willing to accept trailer fields in a chunked transfer-coding. Its + value may consist of the keyword "trailers" and/or a comma-separated + list of extension transfer-coding names with optional accept + parameters (as described in section 3.6). + + TE = "TE" ":" #( t-codings ) + t-codings = "trailers" | ( transfer-extension [ accept-params ] ) + + The presence of the keyword "trailers" indicates that the client is + willing to accept trailer fields in a chunked transfer-coding, as + defined in section 3.6.1. This keyword is reserved for use with + transfer-coding values even though it does not itself represent a + transfer-coding. + + Examples of its use are: + + TE: deflate + TE: + TE: trailers, deflate;q=0.5 + + The TE header field only applies to the immediate connection. + Therefore, the keyword MUST be supplied within a Connection header + field (section 14.10) whenever TE is present in an HTTP/1.1 message. + + A server tests whether a transfer-coding is acceptable, according to + a TE field, using these rules: + + 1. The "chunked" transfer-coding is always acceptable. If the + keyword "trailers" is listed, the client indicates that it is + willing to accept trailer fields in the chunked response on + behalf of itself and any downstream clients. The implication is + that, if given, the client is stating that either all + downstream clients are willing to accept trailer fields in the + forwarded response, or that it will attempt to buffer the + response on behalf of downstream recipients. + + Note: HTTP/1.1 does not define any means to limit the size of a + chunked response such that a client can be assured of buffering + the entire response. + + 2. If the transfer-coding being tested is one of the transfer- + codings listed in the TE field, then it is acceptable unless it + is accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + + +Fielding, et al. Standards Track [Page 142] + +RFC 2616 HTTP/1.1 June 1999 + + + 3. If multiple transfer-codings are acceptable, then the + acceptable transfer-coding with the highest non-zero qvalue is + preferred. The "chunked" transfer-coding always has a qvalue + of 1. + + If the TE field-value is empty or if no TE field is present, the only + transfer-coding is "chunked". A message with no transfer-coding is + always acceptable. + +14.40 Trailer + + The Trailer general field value indicates that the given set of + header fields is present in the trailer of a message encoded with + chunked transfer-coding. + + Trailer = "Trailer" ":" 1#field-name + + An HTTP/1.1 message SHOULD include a Trailer header field in a + message using chunked transfer-coding with a non-empty trailer. Doing + so allows the recipient to know which header fields to expect in the + trailer. + + If no Trailer header field is present, the trailer SHOULD NOT include + any header fields. See section 3.6.1 for restrictions on the use of + trailer fields in a "chunked" transfer-coding. + + Message header fields listed in the Trailer header field MUST NOT + include the following header fields: + + . Transfer-Encoding + + . Content-Length + + . Trailer + +14.41 Transfer-Encoding + + The Transfer-Encoding general-header field indicates what (if any) + type of transformation has been applied to the message body in order + to safely transfer it between the sender and the recipient. This + differs from the content-coding in that the transfer-coding is a + property of the message, not of the entity. + + Transfer-Encoding = "Transfer-Encoding" ":" 1#transfer-coding + + Transfer-codings are defined in section 3.6. An example is: + + Transfer-Encoding: chunked + + + +Fielding, et al. Standards Track [Page 143] + +RFC 2616 HTTP/1.1 June 1999 + + + If multiple encodings have been applied to an entity, the transfer- + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + + Many older HTTP/1.0 applications do not understand the Transfer- + Encoding header. + +14.42 Upgrade + + The Upgrade general-header allows the client to specify what + additional communication protocols it supports and would like to use + if the server finds it appropriate to switch protocols. The server + MUST use the Upgrade header field within a 101 (Switching Protocols) + response to indicate which protocol(s) are being switched. + + Upgrade = "Upgrade" ":" 1#product + + For example, + + Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11 + + The Upgrade header field is intended to provide a simple mechanism + for transition from HTTP/1.1 to some other, incompatible protocol. It + does so by allowing the client to advertise its desire to use another + protocol, such as a later version of HTTP with a higher major version + number, even though the current request has been made using HTTP/1.1. + This eases the difficult transition between incompatible protocols by + allowing the client to initiate a request in the more commonly + supported protocol while indicating to the server that it would like + to use a "better" protocol if available (where "better" is determined + by the server, possibly according to the nature of the method and/or + resource being requested). + + The Upgrade header field only applies to switching application-layer + protocols upon the existing transport-layer connection. Upgrade + cannot be used to insist on a protocol change; its acceptance and use + by the server is optional. The capabilities and nature of the + application-layer communication after the protocol change is entirely + dependent upon the new protocol chosen, although the first action + after changing the protocol MUST be a response to the initial HTTP + request containing the Upgrade header field. + + The Upgrade header field only applies to the immediate connection. + Therefore, the upgrade keyword MUST be supplied within a Connection + header field (section 14.10) whenever Upgrade is present in an + HTTP/1.1 message. + + + + +Fielding, et al. Standards Track [Page 144] + +RFC 2616 HTTP/1.1 June 1999 + + + The Upgrade header field cannot be used to indicate a switch to a + protocol on a different connection. For that purpose, it is more + appropriate to use a 301, 302, 303, or 305 redirection response. + + This specification only defines the protocol name "HTTP" for use by + the family of Hypertext Transfer Protocols, as defined by the HTTP + version rules of section 3.1 and future updates to this + specification. Any token can be used as a protocol name; however, it + will only be useful if both the client and server associate the name + with the same protocol. + +14.43 User-Agent + + The User-Agent request-header field contains information about the + user agent originating the request. This is for statistical purposes, + the tracing of protocol violations, and automated recognition of user + agents for the sake of tailoring responses to avoid particular user + agent limitations. User agents SHOULD include this field with + requests. The field can contain multiple product tokens (section 3.8) + and comments identifying the agent and any subproducts which form a + significant part of the user agent. By convention, the product tokens + are listed in order of their significance for identifying the + application. + + User-Agent = "User-Agent" ":" 1*( product | comment ) + + Example: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + +14.44 Vary + + The Vary field value indicates the set of request-header fields that + fully determines, while the response is fresh, whether a cache is + permitted to use the response to reply to a subsequent request + without revalidation. For uncacheable or stale responses, the Vary + field value advises the user agent about the criteria that were used + to select the representation. A Vary field value of "*" implies that + a cache cannot determine from the request headers of a subsequent + request whether this response is the appropriate representation. See + section 13.6 for use of the Vary header field by caches. + + Vary = "Vary" ":" ( "*" | 1#field-name ) + + An HTTP/1.1 server SHOULD include a Vary header field with any + cacheable response that is subject to server-driven negotiation. + Doing so allows a cache to properly interpret future requests on that + resource and informs the user agent about the presence of negotiation + + + +Fielding, et al. Standards Track [Page 145] + +RFC 2616 HTTP/1.1 June 1999 + + + on that resource. A server MAY include a Vary header field with a + non-cacheable response that is subject to server-driven negotiation, + since this might provide the user agent with useful information about + the dimensions over which the response varies at the time of the + response. + + A Vary field value consisting of a list of field-names signals that + the representation selected for the response is based on a selection + algorithm which considers ONLY the listed request-header field values + in selecting the most appropriate representation. A cache MAY assume + that the same selection will be made for future requests with the + same values for the listed field names, for the duration of time for + which the response is fresh. + + The field-names given are not limited to the set of standard + request-header fields defined by this specification. Field names are + case-insensitive. + + A Vary field value of "*" signals that unspecified parameters not + limited to the request-headers (e.g., the network address of the + client), play a role in the selection of the response representation. + The "*" value MUST NOT be generated by a proxy server; it may only be + generated by an origin server. + +14.45 Via + + The Via general-header field MUST be used by gateways and proxies to + indicate the intermediate protocols and recipients between the user + agent and the server on requests, and between the origin server and + the client on responses. It is analogous to the "Received" field of + RFC 822 [9] and is intended to be used for tracking message forwards, + avoiding request loops, and identifying the protocol capabilities of + all senders along the request/response chain. + + Via = "Via" ":" 1#( received-protocol received-by [ comment ] ) + received-protocol = [ protocol-name "/" ] protocol-version + protocol-name = token + protocol-version = token + received-by = ( host [ ":" port ] ) | pseudonym + pseudonym = token + + The received-protocol indicates the protocol version of the message + received by the server or client along each segment of the + request/response chain. The received-protocol version is appended to + the Via field value when the message is forwarded so that information + about the protocol capabilities of upstream applications remains + visible to all recipients. + + + + +Fielding, et al. Standards Track [Page 146] + +RFC 2616 HTTP/1.1 June 1999 + + + The protocol-name is optional if and only if it would be "HTTP". The + received-by field is normally the host and optional port number of a + recipient server or client that subsequently forwarded the message. + However, if the real host is considered to be sensitive information, + it MAY be replaced by a pseudonym. If the port is not given, it MAY + be assumed to be the default port of the received-protocol. + + Multiple Via field values represents each proxy or gateway that has + forwarded the message. Each recipient MUST append its information + such that the end result is ordered according to the sequence of + forwarding applications. + + Comments MAY be used in the Via header field to identify the software + of the recipient proxy or gateway, analogous to the User-Agent and + Server header fields. However, all comments in the Via field are + optional and MAY be removed by any recipient prior to forwarding the + message. + + For example, a request message could be sent from an HTTP/1.0 user + agent to an internal proxy code-named "fred", which uses HTTP/1.1 to + forward the request to a public proxy at nowhere.com, which completes + the request by forwarding it to the origin server at www.ics.uci.edu. + The request received by www.ics.uci.edu would then have the following + Via header field: + + Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1) + + Proxies and gateways used as a portal through a network firewall + SHOULD NOT, by default, forward the names and ports of hosts within + the firewall region. This information SHOULD only be propagated if + explicitly enabled. If not enabled, the received-by host of any host + behind the firewall SHOULD be replaced by an appropriate pseudonym + for that host. + + For organizations that have strong privacy requirements for hiding + internal structures, a proxy MAY combine an ordered subsequence of + Via header field entries with identical received-protocol values into + a single such entry. For example, + + Via: 1.0 ricky, 1.1 ethel, 1.1 fred, 1.0 lucy + + could be collapsed to + + Via: 1.0 ricky, 1.1 mertz, 1.0 lucy + + + + + + + +Fielding, et al. Standards Track [Page 147] + +RFC 2616 HTTP/1.1 June 1999 + + + Applications SHOULD NOT combine multiple entries unless they are all + under the same organizational control and the hosts have already been + replaced by pseudonyms. Applications MUST NOT combine entries which + have different received-protocol values. + +14.46 Warning + + The Warning general-header field is used to carry additional + information about the status or transformation of a message which + might not be reflected in the message. This information is typically + used to warn about a possible lack of semantic transparency from + caching operations or transformations applied to the entity body of + the message. + + Warning headers are sent with responses using: + + Warning = "Warning" ":" 1#warning-value + + warning-value = warn-code SP warn-agent SP warn-text + [SP warn-date] + + warn-code = 3DIGIT + warn-agent = ( host [ ":" port ] ) | pseudonym + ; the name or pseudonym of the server adding + ; the Warning header, for use in debugging + warn-text = quoted-string + warn-date = <"> HTTP-date <"> + + A response MAY carry more than one Warning header. + + The warn-text SHOULD be in a natural language and character set that + is most likely to be intelligible to the human user receiving the + response. This decision MAY be based on any available knowledge, such + as the location of the cache or user, the Accept-Language field in a + request, the Content-Language field in a response, etc. The default + language is English and the default character set is ISO-8859-1. + + If a character set other than ISO-8859-1 is used, it MUST be encoded + in the warn-text using the method described in RFC 2047 [14]. + + Warning headers can in general be applied to any message, however + some specific warn-codes are specific to caches and can only be + applied to response messages. New Warning headers SHOULD be added + after any existing Warning headers. A cache MUST NOT delete any + Warning header that it received with a message. However, if a cache + successfully validates a cache entry, it SHOULD remove any Warning + headers previously attached to that entry except as specified for + + + + +Fielding, et al. Standards Track [Page 148] + +RFC 2616 HTTP/1.1 June 1999 + + + specific Warning codes. It MUST then add any Warning headers received + in the validating response. In other words, Warning headers are those + that would be attached to the most recent relevant response. + + When multiple Warning headers are attached to a response, the user + agent ought to inform the user of as many of them as possible, in the + order that they appear in the response. If it is not possible to + inform the user of all of the warnings, the user agent SHOULD follow + these heuristics: + + - Warnings that appear early in the response take priority over + those appearing later in the response. + + - Warnings in the user's preferred character set take priority + over warnings in other character sets but with identical warn- + codes and warn-agents. + + Systems that generate multiple Warning headers SHOULD order them with + this user agent behavior in mind. + + Requirements for the behavior of caches with respect to Warnings are + stated in section 13.1.2. + + This is a list of the currently-defined warn-codes, each with a + recommended warn-text in English, and a description of its meaning. + + 110 Response is stale + MUST be included whenever the returned response is stale. + + 111 Revalidation failed + MUST be included if a cache returns a stale response because an + attempt to revalidate the response failed, due to an inability to + reach the server. + + 112 Disconnected operation + SHOULD be included if the cache is intentionally disconnected from + the rest of the network for a period of time. + + 113 Heuristic expiration + MUST be included if the cache heuristically chose a freshness + lifetime greater than 24 hours and the response's age is greater + than 24 hours. + + 199 Miscellaneous warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action, besides presenting the warning to + the user. + + + +Fielding, et al. Standards Track [Page 149] + +RFC 2616 HTTP/1.1 June 1999 + + + 214 Transformation applied + MUST be added by an intermediate cache or proxy if it applies any + transformation changing the content-coding (as specified in the + Content-Encoding header) or media-type (as specified in the + Content-Type header) of the response, or the entity-body of the + response, unless this Warning code already appears in the response. + + 299 Miscellaneous persistent warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action. + + If an implementation sends a message with one or more Warning headers + whose version is HTTP/1.0 or lower, then the sender MUST include in + each warning-value a warn-date that matches the date in the response. + + If an implementation receives a message with a warning-value that + includes a warn-date, and that warn-date is different from the Date + value in the response, then that warning-value MUST be deleted from + the message before storing, forwarding, or using it. (This prevents + bad consequences of naive caching of Warning header fields.) If all + of the warning-values are deleted for this reason, the Warning header + MUST be deleted as well. + +14.47 WWW-Authenticate + + The WWW-Authenticate response-header field MUST be included in 401 + (Unauthorized) response messages. The field value consists of at + least one challenge that indicates the authentication scheme(s) and + parameters applicable to the Request-URI. + + WWW-Authenticate = "WWW-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. User + agents are advised to take special care in parsing the WWW- + Authenticate field value as it might contain more than one challenge, + or if more than one WWW-Authenticate header field is provided, the + contents of a challenge itself can contain a comma-separated list of + authentication parameters. + +15 Security Considerations + + This section is meant to inform application developers, information + providers, and users of the security limitations in HTTP/1.1 as + described by this document. The discussion does not include + definitive solutions to the problems revealed, though it does make + some suggestions for reducing security risks. + + + +Fielding, et al. Standards Track [Page 150] + +RFC 2616 HTTP/1.1 June 1999 + + +15.1 Personal Information + + HTTP clients are often privy to large amounts of personal information + (e.g. the user's name, location, mail address, passwords, encryption + keys, etc.), and SHOULD be very careful to prevent unintentional + leakage of this information via the HTTP protocol to other sources. + We very strongly recommend that a convenient interface be provided + for the user to control dissemination of such information, and that + designers and implementors be particularly careful in this area. + History shows that errors in this area often create serious security + and/or privacy problems and generate highly adverse publicity for the + implementor's company. + +15.1.1 Abuse of Server Log Information + + A server is in the position to save personal data about a user's + requests which might identify their reading patterns or subjects of + interest. This information is clearly confidential in nature and its + handling can be constrained by law in certain countries. People using + the HTTP protocol to provide data are responsible for ensuring that + such material is not distributed without the permission of any + individuals that are identifiable by the published results. + +15.1.2 Transfer of Sensitive Information + + Like any generic data transfer protocol, HTTP cannot regulate the + content of the data that is transferred, nor is there any a priori + method of determining the sensitivity of any particular piece of + information within the context of any given request. Therefore, + applications SHOULD supply as much control over this information as + possible to the provider of that information. Four header fields are + worth special mention in this context: Server, Via, Referer and From. + + Revealing the specific software version of the server might allow the + server machine to become more vulnerable to attacks against software + that is known to contain security holes. Implementors SHOULD make the + Server header field a configurable option. + + Proxies which serve as a portal through a network firewall SHOULD + take special precautions regarding the transfer of header information + that identifies the hosts behind the firewall. In particular, they + SHOULD remove, or replace with sanitized versions, any Via fields + generated behind the firewall. + + The Referer header allows reading patterns to be studied and reverse + links drawn. Although it can be very useful, its power can be abused + if user details are not separated from the information contained in + + + + +Fielding, et al. Standards Track [Page 151] + +RFC 2616 HTTP/1.1 June 1999 + + + the Referer. Even when the personal information has been removed, the + Referer header might indicate a private document's URI whose + publication would be inappropriate. + + The information sent in the From field might conflict with the user's + privacy interests or their site's security policy, and hence it + SHOULD NOT be transmitted without the user being able to disable, + enable, and modify the contents of the field. The user MUST be able + to set the contents of this field within a user preference or + application defaults configuration. + + We suggest, though do not require, that a convenient toggle interface + be provided for the user to enable or disable the sending of From and + Referer information. + + The User-Agent (section 14.43) or Server (section 14.38) header + fields can sometimes be used to determine that a specific client or + server have a particular security hole which might be exploited. + Unfortunately, this same information is often used for other valuable + purposes for which HTTP currently has no better mechanism. + +15.1.3 Encoding Sensitive Information in URI's + + Because the source of a link might be private information or might + reveal an otherwise private information source, it is strongly + recommended that the user be able to select whether or not the + Referer field is sent. For example, a browser client could have a + toggle switch for browsing openly/anonymously, which would + respectively enable/disable the sending of Referer and From + information. + + Clients SHOULD NOT include a Referer header field in a (non-secure) + HTTP request if the referring page was transferred with a secure + protocol. + + Authors of services which use the HTTP protocol SHOULD NOT use GET + based forms for the submission of sensitive data, because this will + cause this data to be encoded in the Request-URI. Many existing + servers, proxies, and user agents will log the request URI in some + place where it might be visible to third parties. Servers can use + POST-based form submission instead + +15.1.4 Privacy Issues Connected to Accept Headers + + Accept request-headers can reveal information about the user to all + servers which are accessed. The Accept-Language header in particular + can reveal information the user would consider to be of a private + nature, because the understanding of particular languages is often + + + +Fielding, et al. Standards Track [Page 152] + +RFC 2616 HTTP/1.1 June 1999 + + + strongly correlated to the membership of a particular ethnic group. + User agents which offer the option to configure the contents of an + Accept-Language header to be sent in every request are strongly + encouraged to let the configuration process include a message which + makes the user aware of the loss of privacy involved. + + An approach that limits the loss of privacy would be for a user agent + to omit the sending of Accept-Language headers by default, and to ask + the user whether or not to start sending Accept-Language headers to a + server if it detects, by looking for any Vary response-header fields + generated by the server, that such sending could improve the quality + of service. + + Elaborate user-customized accept header fields sent in every request, + in particular if these include quality values, can be used by servers + as relatively reliable and long-lived user identifiers. Such user + identifiers would allow content providers to do click-trail tracking, + and would allow collaborating content providers to match cross-server + click-trails or form submissions of individual users. Note that for + many users not behind a proxy, the network address of the host + running the user agent will also serve as a long-lived user + identifier. In environments where proxies are used to enhance + privacy, user agents ought to be conservative in offering accept + header configuration options to end users. As an extreme privacy + measure, proxies could filter the accept headers in relayed requests. + General purpose user agents which provide a high degree of header + configurability SHOULD warn users about the loss of privacy which can + be involved. + +15.2 Attacks Based On File and Path Names + + Implementations of HTTP origin servers SHOULD be careful to restrict + the documents returned by HTTP requests to be only those that were + intended by the server administrators. If an HTTP server translates + HTTP URIs directly into file system calls, the server MUST take + special care not to serve files that were not intended to be + delivered to HTTP clients. For example, UNIX, Microsoft Windows, and + other operating systems use ".." as a path component to indicate a + directory level above the current one. On such a system, an HTTP + server MUST disallow any such construct in the Request-URI if it + would otherwise allow access to a resource outside those intended to + be accessible via the HTTP server. Similarly, files intended for + reference only internally to the server (such as access control + files, configuration files, and script code) MUST be protected from + inappropriate retrieval, since they might contain sensitive + information. Experience has shown that minor bugs in such HTTP server + implementations have turned into security risks. + + + + +Fielding, et al. Standards Track [Page 153] + +RFC 2616 HTTP/1.1 June 1999 + + +15.3 DNS Spoofing + + Clients using HTTP rely heavily on the Domain Name Service, and are + thus generally prone to security attacks based on the deliberate + mis-association of IP addresses and DNS names. Clients need to be + cautious in assuming the continuing validity of an IP number/DNS name + association. + + In particular, HTTP clients SHOULD rely on their name resolver for + confirmation of an IP number/DNS name association, rather than + caching the result of previous host name lookups. Many platforms + already can cache host name lookups locally when appropriate, and + they SHOULD be configured to do so. It is proper for these lookups to + be cached, however, only when the TTL (Time To Live) information + reported by the name server makes it likely that the cached + information will remain useful. + + If HTTP clients cache the results of host name lookups in order to + achieve a performance improvement, they MUST observe the TTL + information reported by DNS. + + If HTTP clients do not observe this rule, they could be spoofed when + a previously-accessed server's IP address changes. As network + renumbering is expected to become increasingly common [24], the + possibility of this form of attack will grow. Observing this + requirement thus reduces this potential security vulnerability. + + This requirement also improves the load-balancing behavior of clients + for replicated servers using the same DNS name and reduces the + likelihood of a user's experiencing failure in accessing sites which + use that strategy. + +15.4 Location Headers and Spoofing + + If a single server supports multiple organizations that do not trust + one another, then it MUST check the values of Location and Content- + Location headers in responses that are generated under control of + said organizations to make sure that they do not attempt to + invalidate resources over which they have no authority. + +15.5 Content-Disposition Issues + + RFC 1806 [35], from which the often implemented Content-Disposition + (see section 19.5.1) header in HTTP is derived, has a number of very + serious security considerations. Content-Disposition is not part of + the HTTP standard, but since it is widely implemented, we are + documenting its use and risks for implementors. See RFC 2183 [49] + (which updates RFC 1806) for details. + + + +Fielding, et al. Standards Track [Page 154] + +RFC 2616 HTTP/1.1 June 1999 + + +15.6 Authentication Credentials and Idle Clients + + Existing HTTP clients and user agents typically retain authentication + information indefinitely. HTTP/1.1. does not provide a method for a + server to direct clients to discard these cached credentials. This is + a significant defect that requires further extensions to HTTP. + Circumstances under which credential caching can interfere with the + application's security model include but are not limited to: + + - Clients which have been idle for an extended period following + which the server might wish to cause the client to reprompt the + user for credentials. + + - Applications which include a session termination indication + (such as a `logout' or `commit' button on a page) after which + the server side of the application `knows' that there is no + further reason for the client to retain the credentials. + + This is currently under separate study. There are a number of work- + arounds to parts of this problem, and we encourage the use of + password protection in screen savers, idle time-outs, and other + methods which mitigate the security problems inherent in this + problem. In particular, user agents which cache credentials are + encouraged to provide a readily accessible mechanism for discarding + cached credentials under user control. + +15.7 Proxies and Caching + + By their very nature, HTTP proxies are men-in-the-middle, and + represent an opportunity for man-in-the-middle attacks. Compromise of + the systems on which the proxies run can result in serious security + and privacy problems. Proxies have access to security-related + information, personal information about individual users and + organizations, and proprietary information belonging to users and + content providers. A compromised proxy, or a proxy implemented or + configured without regard to security and privacy considerations, + might be used in the commission of a wide range of potential attacks. + + Proxy operators should protect the systems on which proxies run as + they would protect any system that contains or transports sensitive + information. In particular, log information gathered at proxies often + contains highly sensitive personal information, and/or information + about organizations. Log information should be carefully guarded, and + appropriate guidelines for use developed and followed. (Section + 15.1.1). + + + + + + +Fielding, et al. Standards Track [Page 155] + +RFC 2616 HTTP/1.1 June 1999 + + + Caching proxies provide additional potential vulnerabilities, since + the contents of the cache represent an attractive target for + malicious exploitation. Because cache contents persist after an HTTP + request is complete, an attack on the cache can reveal information + long after a user believes that the information has been removed from + the network. Therefore, cache contents should be protected as + sensitive information. + + Proxy implementors should consider the privacy and security + implications of their design and coding decisions, and of the + configuration options they provide to proxy operators (especially the + default configuration). + + Users of a proxy need to be aware that they are no trustworthier than + the people who run the proxy; HTTP itself cannot solve this problem. + + The judicious use of cryptography, when appropriate, may suffice to + protect against a broad range of security and privacy attacks. Such + cryptography is beyond the scope of the HTTP/1.1 specification. + +15.7.1 Denial of Service Attacks on Proxies + + They exist. They are hard to defend against. Research continues. + Beware. + +16 Acknowledgments + + This specification makes heavy use of the augmented BNF and generic + constructs defined by David H. Crocker for RFC 822 [9]. Similarly, it + reuses many of the definitions provided by Nathaniel Borenstein and + Ned Freed for MIME [7]. We hope that their inclusion in this + specification will help reduce past confusion over the relationship + between HTTP and Internet mail message formats. + + The HTTP protocol has evolved considerably over the years. It has + benefited from a large and active developer community--the many + people who have participated on the www-talk mailing list--and it is + that community which has been most responsible for the success of + HTTP and of the World-Wide Web in general. Marc Andreessen, Robert + Cailliau, Daniel W. Connolly, Bob Denny, John Franks, Jean-Francois + Groff, Phillip M. Hallam-Baker, Hakon W. Lie, Ari Luotonen, Rob + McCool, Lou Montulli, Dave Raggett, Tony Sanders, and Marc + VanHeyningen deserve special recognition for their efforts in + defining early aspects of the protocol. + + This document has benefited greatly from the comments of all those + participating in the HTTP-WG. In addition to those already mentioned, + the following individuals have contributed to this specification: + + + +Fielding, et al. Standards Track [Page 156] + +RFC 2616 HTTP/1.1 June 1999 + + + Gary Adams Ross Patterson + Harald Tveit Alvestrand Albert Lunde + Keith Ball John C. Mallery + Brian Behlendorf Jean-Philippe Martin-Flatin + Paul Burchard Mitra + Maurizio Codogno David Morris + Mike Cowlishaw Gavin Nicol + Roman Czyborra Bill Perry + Michael A. Dolan Jeffrey Perry + David J. Fiander Scott Powers + Alan Freier Owen Rees + Marc Hedlund Luigi Rizzo + Greg Herlihy David Robinson + Koen Holtman Marc Salomon + Alex Hopmann Rich Salz + Bob Jernigan Allan M. Schiffman + Shel Kaphan Jim Seidman + Rohit Khare Chuck Shotton + John Klensin Eric W. Sink + Martijn Koster Simon E. Spero + Alexei Kosut Richard N. Taylor + David M. Kristol Robert S. Thau + Daniel LaLiberte Bill (BearHeart) Weinman + Ben Laurie Francois Yergeau + Paul J. Leach Mary Ellen Zurko + Daniel DuBois Josh Cohen + + + Much of the content and presentation of the caching design is due to + suggestions and comments from individuals including: Shel Kaphan, + Paul Leach, Koen Holtman, David Morris, and Larry Masinter. + + Most of the specification of ranges is based on work originally done + by Ari Luotonen and John Franks, with additional input from Steve + Zilles. + + Thanks to the "cave men" of Palo Alto. You know who you are. + + Jim Gettys (the current editor of this document) wishes particularly + to thank Roy Fielding, the previous editor of this document, along + with John Klensin, Jeff Mogul, Paul Leach, Dave Kristol, Koen + Holtman, John Franks, Josh Cohen, Alex Hopmann, Scott Lawrence, and + Larry Masinter for their help. And thanks go particularly to Jeff + Mogul and Scott Lawrence for performing the "MUST/MAY/SHOULD" audit. + + + + + + + +Fielding, et al. Standards Track [Page 157] + +RFC 2616 HTTP/1.1 June 1999 + + + The Apache Group, Anselm Baird-Smith, author of Jigsaw, and Henrik + Frystyk implemented RFC 2068 early, and we wish to thank them for the + discovery of many of the problems that this document attempts to + rectify. + +17 References + + [1] Alvestrand, H., "Tags for the Identification of Languages", RFC + 1766, March 1995. + + [2] Anklesaria, F., McCahill, M., Lindner, P., Johnson, D., Torrey, + D. and B. Alberti, "The Internet Gopher Protocol (a distributed + document search and retrieval protocol)", RFC 1436, March 1993. + + [3] Berners-Lee, T., "Universal Resource Identifiers in WWW", RFC + 1630, June 1994. + + [4] Berners-Lee, T., Masinter, L. and M. McCahill, "Uniform Resource + Locators (URL)", RFC 1738, December 1994. + + [5] Berners-Lee, T. and D. Connolly, "Hypertext Markup Language - + 2.0", RFC 1866, November 1995. + + [6] Berners-Lee, T., Fielding, R. and H. Frystyk, "Hypertext Transfer + Protocol -- HTTP/1.0", RFC 1945, May 1996. + + [7] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part One: Format of Internet Message Bodies", + RFC 2045, November 1996. + + [8] Braden, R., "Requirements for Internet Hosts -- Communication + Layers", STD 3, RFC 1123, October 1989. + + [9] Crocker, D., "Standard for The Format of ARPA Internet Text + Messages", STD 11, RFC 822, August 1982. + + [10] Davis, F., Kahle, B., Morris, H., Salem, J., Shen, T., Wang, R., + Sui, J., and M. Grinbaum, "WAIS Interface Protocol Prototype + Functional Specification," (v1.5), Thinking Machines + Corporation, April 1990. + + [11] Fielding, R., "Relative Uniform Resource Locators", RFC 1808, + June 1995. + + [12] Horton, M. and R. Adams, "Standard for Interchange of USENET + Messages", RFC 1036, December 1987. + + + + + +Fielding, et al. Standards Track [Page 158] + +RFC 2616 HTTP/1.1 June 1999 + + + [13] Kantor, B. and P. Lapsley, "Network News Transfer Protocol", RFC + 977, February 1986. + + [14] Moore, K., "MIME (Multipurpose Internet Mail Extensions) Part + Three: Message Header Extensions for Non-ASCII Text", RFC 2047, + November 1996. + + [15] Nebel, E. and L. Masinter, "Form-based File Upload in HTML", RFC + 1867, November 1995. + + [16] Postel, J., "Simple Mail Transfer Protocol", STD 10, RFC 821, + August 1982. + + [17] Postel, J., "Media Type Registration Procedure", RFC 1590, + November 1996. + + [18] Postel, J. and J. Reynolds, "File Transfer Protocol", STD 9, RFC + 959, October 1985. + + [19] Reynolds, J. and J. Postel, "Assigned Numbers", STD 2, RFC 1700, + October 1994. + + [20] Sollins, K. and L. Masinter, "Functional Requirements for + Uniform Resource Names", RFC 1737, December 1994. + + [21] US-ASCII. Coded Character Set - 7-Bit American Standard Code for + Information Interchange. Standard ANSI X3.4-1986, ANSI, 1986. + + [22] ISO-8859. International Standard -- Information Processing -- + 8-bit Single-Byte Coded Graphic Character Sets -- + Part 1: Latin alphabet No. 1, ISO-8859-1:1987. + Part 2: Latin alphabet No. 2, ISO-8859-2, 1987. + Part 3: Latin alphabet No. 3, ISO-8859-3, 1988. + Part 4: Latin alphabet No. 4, ISO-8859-4, 1988. + Part 5: Latin/Cyrillic alphabet, ISO-8859-5, 1988. + Part 6: Latin/Arabic alphabet, ISO-8859-6, 1987. + Part 7: Latin/Greek alphabet, ISO-8859-7, 1987. + Part 8: Latin/Hebrew alphabet, ISO-8859-8, 1988. + Part 9: Latin alphabet No. 5, ISO-8859-9, 1990. + + [23] Meyers, J. and M. Rose, "The Content-MD5 Header Field", RFC + 1864, October 1995. + + [24] Carpenter, B. and Y. Rekhter, "Renumbering Needs Work", RFC + 1900, February 1996. + + [25] Deutsch, P., "GZIP file format specification version 4.3", RFC + 1952, May 1996. + + + +Fielding, et al. Standards Track [Page 159] + +RFC 2616 HTTP/1.1 June 1999 + + + [26] Venkata N. Padmanabhan, and Jeffrey C. Mogul. "Improving HTTP + Latency", Computer Networks and ISDN Systems, v. 28, pp. 25-35, + Dec. 1995. Slightly revised version of paper in Proc. 2nd + International WWW Conference '94: Mosaic and the Web, Oct. 1994, + which is available at + http://www.ncsa.uiuc.edu/SDG/IT94/Proceedings/DDay/mogul/HTTPLat + ency.html. + + [27] Joe Touch, John Heidemann, and Katia Obraczka. "Analysis of HTTP + Performance", , + ISI Research Report ISI/RR-98-463, (original report dated Aug. + 1996), USC/Information Sciences Institute, August 1998. + + [28] Mills, D., "Network Time Protocol (Version 3) Specification, + Implementation and Analysis", RFC 1305, March 1992. + + [29] Deutsch, P., "DEFLATE Compressed Data Format Specification + version 1.3", RFC 1951, May 1996. + + [30] S. Spero, "Analysis of HTTP Performance Problems," + http://sunsite.unc.edu/mdma-release/http-prob.html. + + [31] Deutsch, P. and J. Gailly, "ZLIB Compressed Data Format + Specification version 3.3", RFC 1950, May 1996. + + [32] Franks, J., Hallam-Baker, P., Hostetler, J., Leach, P., + Luotonen, A., Sink, E. and L. Stewart, "An Extension to HTTP: + Digest Access Authentication", RFC 2069, January 1997. + + [33] Fielding, R., Gettys, J., Mogul, J., Frystyk, H. and T. + Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1", RFC + 2068, January 1997. + + [34] Bradner, S., "Key words for use in RFCs to Indicate Requirement + Levels", BCP 14, RFC 2119, March 1997. + + [35] Troost, R. and Dorner, S., "Communicating Presentation + Information in Internet Messages: The Content-Disposition + Header", RFC 1806, June 1995. + + [36] Mogul, J., Fielding, R., Gettys, J. and H. Frystyk, "Use and + Interpretation of HTTP Version Numbers", RFC 2145, May 1997. + [jg639] + + [37] Palme, J., "Common Internet Message Headers", RFC 2076, February + 1997. [jg640] + + + + + +Fielding, et al. Standards Track [Page 160] + +RFC 2616 HTTP/1.1 June 1999 + + + [38] Yergeau, F., "UTF-8, a transformation format of Unicode and + ISO-10646", RFC 2279, January 1998. [jg641] + + [39] Nielsen, H.F., Gettys, J., Baird-Smith, A., Prud'hommeaux, E., + Lie, H., and C. Lilley. "Network Performance Effects of + HTTP/1.1, CSS1, and PNG," Proceedings of ACM SIGCOMM '97, Cannes + France, September 1997.[jg642] + + [40] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Two: Media Types", RFC 2046, November + 1996. [jg643] + + [41] Alvestrand, H., "IETF Policy on Character Sets and Languages", + BCP 18, RFC 2277, January 1998. [jg644] + + [42] Berners-Lee, T., Fielding, R. and L. Masinter, "Uniform Resource + Identifiers (URI): Generic Syntax and Semantics", RFC 2396, + August 1998. [jg645] + + [43] Franks, J., Hallam-Baker, P., Hostetler, J., Lawrence, S., + Leach, P., Luotonen, A., Sink, E. and L. Stewart, "HTTP + Authentication: Basic and Digest Access Authentication", RFC + 2617, June 1999. [jg646] + + [44] Luotonen, A., "Tunneling TCP based protocols through Web proxy + servers," Work in Progress. [jg647] + + [45] Palme, J. and A. Hopmann, "MIME E-mail Encapsulation of + Aggregate Documents, such as HTML (MHTML)", RFC 2110, March + 1997. + + [46] Bradner, S., "The Internet Standards Process -- Revision 3", BCP + 9, RFC 2026, October 1996. + + [47] Masinter, L., "Hyper Text Coffee Pot Control Protocol + (HTCPCP/1.0)", RFC 2324, 1 April 1998. + + [48] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Five: Conformance Criteria and Examples", + RFC 2049, November 1996. + + [49] Troost, R., Dorner, S. and K. Moore, "Communicating Presentation + Information in Internet Messages: The Content-Disposition Header + Field", RFC 2183, August 1997. + + + + + + + +Fielding, et al. Standards Track [Page 161] + +RFC 2616 HTTP/1.1 June 1999 + + +18 Authors' Addresses + + Roy T. Fielding + Information and Computer Science + University of California, Irvine + Irvine, CA 92697-3425, USA + + Fax: +1 (949) 824-1715 + EMail: fielding@ics.uci.edu + + + James Gettys + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: jg@w3.org + + + Jeffrey C. Mogul + Western Research Laboratory + Compaq Computer Corporation + 250 University Avenue + Palo Alto, California, 94305, USA + + EMail: mogul@wrl.dec.com + + + Henrik Frystyk Nielsen + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: frystyk@w3.org + + + Larry Masinter + Xerox Corporation + 3333 Coyote Hill Road + Palo Alto, CA 94034, USA + + EMail: masinter@parc.xerox.com + + + + + +Fielding, et al. Standards Track [Page 162] + +RFC 2616 HTTP/1.1 June 1999 + + + Paul J. Leach + Microsoft Corporation + 1 Microsoft Way + Redmond, WA 98052, USA + + EMail: paulle@microsoft.com + + + Tim Berners-Lee + Director, World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: timbl@w3.org + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 163] + +RFC 2616 HTTP/1.1 June 1999 + + +19 Appendices + +19.1 Internet Media Type message/http and application/http + + In addition to defining the HTTP/1.1 protocol, this document serves + as the specification for the Internet media type "message/http" and + "application/http". The message/http type can be used to enclose a + single HTTP request or response message, provided that it obeys the + MIME restrictions for all "message" types regarding line length and + encodings. The application/http type can be used to enclose a + pipeline of one or more HTTP request or response messages (not + intermixed). The following is to be registered with IANA [17]. + + Media Type name: message + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed message + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + Media Type name: application + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed messages + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: HTTP messages enclosed by this type + are in "binary" format; use of an appropriate + Content-Transfer-Encoding is required when + transmitted via E-mail. + Security considerations: none + + + + + + + + + +Fielding, et al. Standards Track [Page 164] + +RFC 2616 HTTP/1.1 June 1999 + + +19.2 Internet Media Type multipart/byteranges + + When an HTTP 206 (Partial Content) response message includes the + content of multiple ranges (a response to a request for multiple + non-overlapping ranges), these are transmitted as a multipart + message-body. The media type for this purpose is called + "multipart/byteranges". + + The multipart/byteranges media type includes two or more parts, each + with its own Content-Type and Content-Range fields. The required + boundary parameter specifies the boundary string used to separate + each body-part. + + Media Type name: multipart + Media subtype name: byteranges + Required parameters: boundary + Optional parameters: none + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + + For example: + + HTTP/1.1 206 Partial Content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-type: multipart/byteranges; boundary=THIS_STRING_SEPARATES + + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 500-999/8000 + + ...the first range... + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 7000-7999/8000 + + ...the second range + --THIS_STRING_SEPARATES-- + + Notes: + + 1) Additional CRLFs may precede the first boundary string in the + entity. + + + + + + +Fielding, et al. Standards Track [Page 165] + +RFC 2616 HTTP/1.1 June 1999 + + + 2) Although RFC 2046 [40] permits the boundary string to be + quoted, some existing implementations handle a quoted boundary + string incorrectly. + + 3) A number of browsers and servers were coded to an early draft + of the byteranges specification to use a media type of + multipart/x-byteranges, which is almost, but not quite + compatible with the version documented in HTTP/1.1. + +19.3 Tolerant Applications + + Although this document specifies the requirements for the generation + of HTTP/1.1 messages, not all applications will be correct in their + implementation. We therefore recommend that operational applications + be tolerant of deviations whenever those deviations can be + interpreted unambiguously. + + Clients SHOULD be tolerant in parsing the Status-Line and servers + tolerant when parsing the Request-Line. In particular, they SHOULD + accept any amount of SP or HT characters between fields, even though + only a single SP is required. + + The line terminator for message-header fields is the sequence CRLF. + However, we recommend that applications, when parsing such headers, + recognize a single LF as a line terminator and ignore the leading CR. + + The character set of an entity-body SHOULD be labeled as the lowest + common denominator of the character codes used within that body, with + the exception that not labeling the entity is preferred over labeling + the entity with the labels US-ASCII or ISO-8859-1. See section 3.7.1 + and 3.4.1. + + Additional rules for requirements on parsing and encoding of dates + and other potential problems with date encodings include: + + - HTTP/1.1 clients and caches SHOULD assume that an RFC-850 date + which appears to be more than 50 years in the future is in fact + in the past (this helps solve the "year 2000" problem). + + - An HTTP/1.1 implementation MAY internally represent a parsed + Expires date as earlier than the proper value, but MUST NOT + internally represent a parsed Expires date as later than the + proper value. + + - All expiration-related calculations MUST be done in GMT. The + local time zone MUST NOT influence the calculation or comparison + of an age or expiration time. + + + + +Fielding, et al. Standards Track [Page 166] + +RFC 2616 HTTP/1.1 June 1999 + + + - If an HTTP header incorrectly carries a date value with a time + zone other than GMT, it MUST be converted into GMT using the + most conservative possible conversion. + +19.4 Differences Between HTTP Entities and RFC 2045 Entities + + HTTP/1.1 uses many of the constructs defined for Internet Mail (RFC + 822 [9]) and the Multipurpose Internet Mail Extensions (MIME [7]) to + allow entities to be transmitted in an open variety of + representations and with extensible mechanisms. However, RFC 2045 + discusses mail, and HTTP has a few features that are different from + those described in RFC 2045. These differences were carefully chosen + to optimize performance over binary connections, to allow greater + freedom in the use of new media types, to make date comparisons + easier, and to acknowledge the practice of some early HTTP servers + and clients. + + This appendix describes specific areas where HTTP differs from RFC + 2045. Proxies and gateways to strict MIME environments SHOULD be + aware of these differences and provide the appropriate conversions + where necessary. Proxies and gateways from MIME environments to HTTP + also need to be aware of the differences because some conversions + might be required. + +19.4.1 MIME-Version + + HTTP is not a MIME-compliant protocol. However, HTTP/1.1 messages MAY + include a single MIME-Version general-header field to indicate what + version of the MIME protocol was used to construct the message. Use + of the MIME-Version header field indicates that the message is in + full compliance with the MIME protocol (as defined in RFC 2045[7]). + Proxies/gateways are responsible for ensuring full compliance (where + possible) when exporting HTTP messages to strict MIME environments. + + MIME-Version = "MIME-Version" ":" 1*DIGIT "." 1*DIGIT + + MIME version "1.0" is the default for use in HTTP/1.1. However, + HTTP/1.1 message parsing and semantics are defined by this document + and not the MIME specification. + +19.4.2 Conversion to Canonical Form + + RFC 2045 [7] requires that an Internet mail entity be converted to + canonical form prior to being transferred, as described in section 4 + of RFC 2049 [48]. Section 3.7.1 of this document describes the forms + allowed for subtypes of the "text" media type when transmitted over + HTTP. RFC 2046 requires that content with a type of "text" represent + line breaks as CRLF and forbids the use of CR or LF outside of line + + + +Fielding, et al. Standards Track [Page 167] + +RFC 2616 HTTP/1.1 June 1999 + + + break sequences. HTTP allows CRLF, bare CR, and bare LF to indicate a + line break within text content when a message is transmitted over + HTTP. + + Where it is possible, a proxy or gateway from HTTP to a strict MIME + environment SHOULD translate all line breaks within the text media + types described in section 3.7.1 of this document to the RFC 2049 + canonical form of CRLF. Note, however, that this might be complicated + by the presence of a Content-Encoding and by the fact that HTTP + allows the use of some character sets which do not use octets 13 and + 10 to represent CR and LF, as is the case for some multi-byte + character sets. + + Implementors should note that conversion will break any cryptographic + checksums applied to the original content unless the original content + is already in canonical form. Therefore, the canonical form is + recommended for any content that uses such checksums in HTTP. + +19.4.3 Conversion of Date Formats + + HTTP/1.1 uses a restricted set of date formats (section 3.3.1) to + simplify the process of date comparison. Proxies and gateways from + other protocols SHOULD ensure that any Date header field present in a + message conforms to one of the HTTP/1.1 formats and rewrite the date + if necessary. + +19.4.4 Introduction of Content-Encoding + + RFC 2045 does not include any concept equivalent to HTTP/1.1's + Content-Encoding header field. Since this acts as a modifier on the + media type, proxies and gateways from HTTP to MIME-compliant + protocols MUST either change the value of the Content-Type header + field or decode the entity-body before forwarding the message. (Some + experimental applications of Content-Type for Internet mail have used + a media-type parameter of ";conversions=" to perform + a function equivalent to Content-Encoding. However, this parameter is + not part of RFC 2045.) + +19.4.5 No Content-Transfer-Encoding + + HTTP does not use the Content-Transfer-Encoding (CTE) field of RFC + 2045. Proxies and gateways from MIME-compliant protocols to HTTP MUST + remove any non-identity CTE ("quoted-printable" or "base64") encoding + prior to delivering the response message to an HTTP client. + + Proxies and gateways from HTTP to MIME-compliant protocols are + responsible for ensuring that the message is in the correct format + and encoding for safe transport on that protocol, where "safe + + + +Fielding, et al. Standards Track [Page 168] + +RFC 2616 HTTP/1.1 June 1999 + + + transport" is defined by the limitations of the protocol being used. + Such a proxy or gateway SHOULD label the data with an appropriate + Content-Transfer-Encoding if doing so will improve the likelihood of + safe transport over the destination protocol. + +19.4.6 Introduction of Transfer-Encoding + + HTTP/1.1 introduces the Transfer-Encoding header field (section + 14.41). Proxies/gateways MUST remove any transfer-coding prior to + forwarding a message via a MIME-compliant protocol. + + A process for decoding the "chunked" transfer-coding (section 3.6) + can be represented in pseudo-code as: + + length := 0 + read chunk-size, chunk-extension (if any) and CRLF + while (chunk-size > 0) { + read chunk-data and CRLF + append chunk-data to entity-body + length := length + chunk-size + read chunk-size and CRLF + } + read entity-header + while (entity-header not empty) { + append entity-header to existing header fields + read entity-header + } + Content-Length := length + Remove "chunked" from Transfer-Encoding + +19.4.7 MHTML and Line Length Limitations + + HTTP implementations which share code with MHTML [45] implementations + need to be aware of MIME line length limitations. Since HTTP does not + have this limitation, HTTP does not fold long lines. MHTML messages + being transported by HTTP follow all conventions of MHTML, including + line length limitations and folding, canonicalization, etc., since + HTTP transports all message-bodies as payload (see section 3.7.2) and + does not interpret the content or any MIME header lines that might be + contained therein. + +19.5 Additional Features + + RFC 1945 and RFC 2068 document protocol elements used by some + existing HTTP implementations, but not consistently and correctly + across most HTTP/1.1 applications. Implementors are advised to be + aware of these features, but cannot rely upon their presence in, or + interoperability with, other HTTP/1.1 applications. Some of these + + + +Fielding, et al. Standards Track [Page 169] + +RFC 2616 HTTP/1.1 June 1999 + + + describe proposed experimental features, and some describe features + that experimental deployment found lacking that are now addressed in + the base HTTP/1.1 specification. + + A number of other headers, such as Content-Disposition and Title, + from SMTP and MIME are also often implemented (see RFC 2076 [37]). + +19.5.1 Content-Disposition + + The Content-Disposition response-header field has been proposed as a + means for the origin server to suggest a default filename if the user + requests that the content is saved to a file. This usage is derived + from the definition of Content-Disposition in RFC 1806 [35]. + + content-disposition = "Content-Disposition" ":" + disposition-type *( ";" disposition-parm ) + disposition-type = "attachment" | disp-extension-token + disposition-parm = filename-parm | disp-extension-parm + filename-parm = "filename" "=" quoted-string + disp-extension-token = token + disp-extension-parm = token "=" ( token | quoted-string ) + + An example is + + Content-Disposition: attachment; filename="fname.ext" + + The receiving user agent SHOULD NOT respect any directory path + information present in the filename-parm parameter, which is the only + parameter believed to apply to HTTP implementations at this time. The + filename SHOULD be treated as a terminal component only. + + If this header is used in a response with the application/octet- + stream content-type, the implied suggestion is that the user agent + should not display the response, but directly enter a `save response + as...' dialog. + + See section 15.5 for Content-Disposition security issues. + +19.6 Compatibility with Previous Versions + + It is beyond the scope of a protocol specification to mandate + compliance with previous versions. HTTP/1.1 was deliberately + designed, however, to make supporting previous versions easy. It is + worth noting that, at the time of composing this specification + (1996), we would expect commercial HTTP/1.1 servers to: + + - recognize the format of the Request-Line for HTTP/0.9, 1.0, and + 1.1 requests; + + + +Fielding, et al. Standards Track [Page 170] + +RFC 2616 HTTP/1.1 June 1999 + + + - understand any valid request in the format of HTTP/0.9, 1.0, or + 1.1; + + - respond appropriately with a message in the same major version + used by the client. + + And we would expect HTTP/1.1 clients to: + + - recognize the format of the Status-Line for HTTP/1.0 and 1.1 + responses; + + - understand any valid response in the format of HTTP/0.9, 1.0, or + 1.1. + + For most implementations of HTTP/1.0, each connection is established + by the client prior to the request and closed by the server after + sending the response. Some implementations implement the Keep-Alive + version of persistent connections described in section 19.7.1 of RFC + 2068 [33]. + +19.6.1 Changes from HTTP/1.0 + + This section summarizes major differences between versions HTTP/1.0 + and HTTP/1.1. + +19.6.1.1 Changes to Simplify Multi-homed Web Servers and Conserve IP + Addresses + + The requirements that clients and servers support the Host request- + header, report an error if the Host request-header (section 14.23) is + missing from an HTTP/1.1 request, and accept absolute URIs (section + 5.1.2) are among the most important changes defined by this + specification. + + Older HTTP/1.0 clients assumed a one-to-one relationship of IP + addresses and servers; there was no other established mechanism for + distinguishing the intended server of a request than the IP address + to which that request was directed. The changes outlined above will + allow the Internet, once older HTTP clients are no longer common, to + support multiple Web sites from a single IP address, greatly + simplifying large operational Web servers, where allocation of many + IP addresses to a single host has created serious problems. The + Internet will also be able to recover the IP addresses that have been + allocated for the sole purpose of allowing special-purpose domain + names to be used in root-level HTTP URLs. Given the rate of growth of + the Web, and the number of servers already deployed, it is extremely + + + + + +Fielding, et al. Standards Track [Page 171] + +RFC 2616 HTTP/1.1 June 1999 + + + important that all implementations of HTTP (including updates to + existing HTTP/1.0 applications) correctly implement these + requirements: + + - Both clients and servers MUST support the Host request-header. + + - A client that sends an HTTP/1.1 request MUST send a Host header. + + - Servers MUST report a 400 (Bad Request) error if an HTTP/1.1 + request does not include a Host request-header. + + - Servers MUST accept absolute URIs. + +19.6.2 Compatibility with HTTP/1.0 Persistent Connections + + Some clients and servers might wish to be compatible with some + previous implementations of persistent connections in HTTP/1.0 + clients and servers. Persistent connections in HTTP/1.0 are + explicitly negotiated as they are not the default behavior. HTTP/1.0 + experimental implementations of persistent connections are faulty, + and the new facilities in HTTP/1.1 are designed to rectify these + problems. The problem was that some existing 1.0 clients may be + sending Keep-Alive to a proxy server that doesn't understand + Connection, which would then erroneously forward it to the next + inbound server, which would establish the Keep-Alive connection and + result in a hung HTTP/1.0 proxy waiting for the close on the + response. The result is that HTTP/1.0 clients must be prevented from + using Keep-Alive when talking to proxies. + + However, talking to proxies is the most important use of persistent + connections, so that prohibition is clearly unacceptable. Therefore, + we need some other mechanism for indicating a persistent connection + is desired, which is safe to use even when talking to an old proxy + that ignores Connection. Persistent connections are the default for + HTTP/1.1 messages; we introduce a new keyword (Connection: close) for + declaring non-persistence. See section 14.10. + + The original HTTP/1.0 form of persistent connections (the Connection: + Keep-Alive and Keep-Alive header) is documented in RFC 2068. [33] + +19.6.3 Changes from RFC 2068 + + This specification has been carefully audited to correct and + disambiguate key word usage; RFC 2068 had many problems in respect to + the conventions laid out in RFC 2119 [34]. + + Clarified which error code should be used for inbound server failures + (e.g. DNS failures). (Section 10.5.5). + + + +Fielding, et al. Standards Track [Page 172] + +RFC 2616 HTTP/1.1 June 1999 + + + CREATE had a race that required an Etag be sent when a resource is + first created. (Section 10.2.2). + + Content-Base was deleted from the specification: it was not + implemented widely, and there is no simple, safe way to introduce it + without a robust extension mechanism. In addition, it is used in a + similar, but not identical fashion in MHTML [45]. + + Transfer-coding and message lengths all interact in ways that + required fixing exactly when chunked encoding is used (to allow for + transfer encoding that may not be self delimiting); it was important + to straighten out exactly how message lengths are computed. (Sections + 3.6, 4.4, 7.2.2, 13.5.2, 14.13, 14.16) + + A content-coding of "identity" was introduced, to solve problems + discovered in caching. (section 3.5) + + Quality Values of zero should indicate that "I don't want something" + to allow clients to refuse a representation. (Section 3.9) + + The use and interpretation of HTTP version numbers has been clarified + by RFC 2145. Require proxies to upgrade requests to highest protocol + version they support to deal with problems discovered in HTTP/1.0 + implementations (Section 3.1) + + Charset wildcarding is introduced to avoid explosion of character set + names in accept headers. (Section 14.2) + + A case was missed in the Cache-Control model of HTTP/1.1; s-maxage + was introduced to add this missing case. (Sections 13.4, 14.8, 14.9, + 14.9.3) + + The Cache-Control: max-age directive was not properly defined for + responses. (Section 14.9.3) + + There are situations where a server (especially a proxy) does not + know the full length of a response but is capable of serving a + byterange request. We therefore need a mechanism to allow byteranges + with a content-range not indicating the full length of the message. + (Section 14.16) + + Range request responses would become very verbose if all meta-data + were always returned; by allowing the server to only send needed + headers in a 206 response, this problem can be avoided. (Section + 10.2.7, 13.5.3, and 14.27) + + + + + + +Fielding, et al. Standards Track [Page 173] + +RFC 2616 HTTP/1.1 June 1999 + + + Fix problem with unsatisfiable range requests; there are two cases: + syntactic problems, and range doesn't exist in the document. The 416 + status code was needed to resolve this ambiguity needed to indicate + an error for a byte range request that falls outside of the actual + contents of a document. (Section 10.4.17, 14.16) + + Rewrite of message transmission requirements to make it much harder + for implementors to get it wrong, as the consequences of errors here + can have significant impact on the Internet, and to deal with the + following problems: + + 1. Changing "HTTP/1.1 or later" to "HTTP/1.1", in contexts where + this was incorrectly placing a requirement on the behavior of + an implementation of a future version of HTTP/1.x + + 2. Made it clear that user-agents should retry requests, not + "clients" in general. + + 3. Converted requirements for clients to ignore unexpected 100 + (Continue) responses, and for proxies to forward 100 responses, + into a general requirement for 1xx responses. + + 4. Modified some TCP-specific language, to make it clearer that + non-TCP transports are possible for HTTP. + + 5. Require that the origin server MUST NOT wait for the request + body before it sends a required 100 (Continue) response. + + 6. Allow, rather than require, a server to omit 100 (Continue) if + it has already seen some of the request body. + + 7. Allow servers to defend against denial-of-service attacks and + broken clients. + + This change adds the Expect header and 417 status code. The message + transmission requirements fixes are in sections 8.2, 10.4.18, + 8.1.2.2, 13.11, and 14.20. + + Proxies should be able to add Content-Length when appropriate. + (Section 13.5.2) + + Clean up confusion between 403 and 404 responses. (Section 10.4.4, + 10.4.5, and 10.4.11) + + Warnings could be cached incorrectly, or not updated appropriately. + (Section 13.1.2, 13.2.4, 13.5.2, 13.5.3, 14.9.3, and 14.46) Warning + also needed to be a general header, as PUT or other methods may have + need for it in requests. + + + +Fielding, et al. Standards Track [Page 174] + +RFC 2616 HTTP/1.1 June 1999 + + + Transfer-coding had significant problems, particularly with + interactions with chunked encoding. The solution is that transfer- + codings become as full fledged as content-codings. This involves + adding an IANA registry for transfer-codings (separate from content + codings), a new header field (TE) and enabling trailer headers in the + future. Transfer encoding is a major performance benefit, so it was + worth fixing [39]. TE also solves another, obscure, downward + interoperability problem that could have occurred due to interactions + between authentication trailers, chunked encoding and HTTP/1.0 + clients.(Section 3.6, 3.6.1, and 14.39) + + The PATCH, LINK, UNLINK methods were defined but not commonly + implemented in previous versions of this specification. See RFC 2068 + [33]. + + The Alternates, Content-Version, Derived-From, Link, URI, Public and + Content-Base header fields were defined in previous versions of this + specification, but not commonly implemented. See RFC 2068 [33]. + +20 Index + + Please see the PostScript version of this RFC for the INDEX. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 175] + +RFC 2616 HTTP/1.1 June 1999 + + +21. Full Copyright Statement + + Copyright (C) The Internet Society (1999). All Rights Reserved. + + This document and translations of it may be copied and furnished to + others, and derivative works that comment on or otherwise explain it + or assist in its implementation may be prepared, copied, published + and distributed, in whole or in part, without restriction of any + kind, provided that the above copyright notice and this paragraph are + included on all such copies and derivative works. However, this + document itself may not be modified in any way, such as by removing + the copyright notice or references to the Internet Society or other + Internet organizations, except as needed for the purpose of + developing Internet standards in which case the procedures for + copyrights defined in the Internet Standards process must be + followed, or as required to translate it into languages other than + English. + + The limited permissions granted above are perpetual and will not be + revoked by the Internet Society or its successors or assigns. + + This document and the information contained herein is provided on an + "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING + TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING + BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION + HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF + MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + +Acknowledgement + + Funding for the RFC Editor function is currently provided by the + Internet Society. + + Network Working Group R. Fielding +Request for Comments: 2616 UC Irvine +Obsoletes: 2068 J. Gettys +Category: Standards Track Compaq/W3C + J. Mogul + Compaq + H. Frystyk + W3C/MIT + L. Masinter + Xerox + P. Leach + Microsoft + T. Berners-Lee + W3C/MIT + June 1999 + + + Hypertext Transfer Protocol -- HTTP/1.1 + +Status of this Memo + + This document specifies an Internet standards track protocol for the + Internet community, and requests discussion and suggestions for + improvements. Please refer to the current edition of the "Internet + Official Protocol Standards" (STD 1) for the standardization state + and status of this protocol. Distribution of this memo is unlimited. + +Copyright Notice + + Copyright (C) The Internet Society (1999). All Rights Reserved. + +Abstract + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. It is a generic, stateless, protocol which can be used for + many tasks beyond its use for hypertext, such as name servers and + distributed object management systems, through extension of its + request methods, error codes and headers [47]. A feature of HTTP is + the typing and negotiation of data representation, allowing systems + to be built independently of the data being transferred. + + HTTP has been in use by the World-Wide Web global information + initiative since 1990. This specification defines the protocol + referred to as "HTTP/1.1", and is an update to RFC 2068 [33]. + + + + + + +Fielding, et al. Standards Track [Page 1] + +RFC 2616 HTTP/1.1 June 1999 + + +Table of Contents + + 1 Introduction ...................................................7 + 1.1 Purpose......................................................7 + 1.2 Requirements .................................................8 + 1.3 Terminology ..................................................8 + 1.4 Overall Operation ...........................................12 + 2 Notational Conventions and Generic Grammar ....................14 + 2.1 Augmented BNF ...............................................14 + 2.2 Basic Rules .................................................15 + 3 Protocol Parameters ...........................................17 + 3.1 HTTP Version ................................................17 + 3.2 Uniform Resource Identifiers ................................18 + 3.2.1 General Syntax ...........................................19 + 3.2.2 http URL .................................................19 + 3.2.3 URI Comparison ...........................................20 + 3.3 Date/Time Formats ...........................................20 + 3.3.1 Full Date ................................................20 + 3.3.2 Delta Seconds ............................................21 + 3.4 Character Sets ..............................................21 + 3.4.1 Missing Charset ..........................................22 + 3.5 Content Codings .............................................23 + 3.6 Transfer Codings ............................................24 + 3.6.1 Chunked Transfer Coding ..................................25 + 3.7 Media Types .................................................26 + 3.7.1 Canonicalization and Text Defaults .......................27 + 3.7.2 Multipart Types ..........................................27 + 3.8 Product Tokens ..............................................28 + 3.9 Quality Values ..............................................29 + 3.10 Language Tags ...............................................29 + 3.11 Entity Tags .................................................30 + 3.12 Range Units .................................................30 + 4 HTTP Message ..................................................31 + 4.1 Message Types ...............................................31 + 4.2 Message Headers .............................................31 + 4.3 Message Body ................................................32 + 4.4 Message Length ..............................................33 + 4.5 General Header Fields .......................................34 + 5 Request .......................................................35 + 5.1 Request-Line ................................................35 + 5.1.1 Method ...................................................36 + 5.1.2 Request-URI ..............................................36 + 5.2 The Resource Identified by a Request ........................38 + 5.3 Request Header Fields .......................................38 + 6 Response ......................................................39 + 6.1 Status-Line .................................................39 + 6.1.1 Status Code and Reason Phrase ............................39 + 6.2 Response Header Fields ......................................41 + + + +Fielding, et al. Standards Track [Page 2] + +RFC 2616 HTTP/1.1 June 1999 + + + 7 Entity ........................................................42 + 7.1 Entity Header Fields ........................................42 + 7.2 Entity Body .................................................43 + 7.2.1 Type .....................................................43 + 7.2.2 Entity Length ............................................43 + 8 Connections ...................................................44 + 8.1 Persistent Connections ......................................44 + 8.1.1 Purpose ..................................................44 + 8.1.2 Overall Operation ........................................45 + 8.1.3 Proxy Servers ............................................46 + 8.1.4 Practical Considerations .................................46 + 8.2 Message Transmission Requirements ...........................47 + 8.2.1 Persistent Connections and Flow Control ..................47 + 8.2.2 Monitoring Connections for Error Status Messages .........48 + 8.2.3 Use of the 100 (Continue) Status .........................48 + 8.2.4 Client Behavior if Server Prematurely Closes Connection ..50 + 9 Method Definitions ............................................51 + 9.1 Safe and Idempotent Methods .................................51 + 9.1.1 Safe Methods .............................................51 + 9.1.2 Idempotent Methods .......................................51 + 9.2 OPTIONS .....................................................52 + 9.3 GET .........................................................53 + 9.4 HEAD ........................................................54 + 9.5 POST ........................................................54 + 9.6 PUT .........................................................55 + 9.7 DELETE ......................................................56 + 9.8 TRACE .......................................................56 + 9.9 CONNECT .....................................................57 + 10 Status Code Definitions ......................................57 + 10.1 Informational 1xx ...........................................57 + 10.1.1 100 Continue .............................................58 + 10.1.2 101 Switching Protocols ..................................58 + 10.2 Successful 2xx ..............................................58 + 10.2.1 200 OK ...................................................58 + 10.2.2 201 Created ..............................................59 + 10.2.3 202 Accepted .............................................59 + 10.2.4 203 Non-Authoritative Information ........................59 + 10.2.5 204 No Content ...........................................60 + 10.2.6 205 Reset Content ........................................60 + 10.2.7 206 Partial Content ......................................60 + 10.3 Redirection 3xx .............................................61 + 10.3.1 300 Multiple Choices .....................................61 + 10.3.2 301 Moved Permanently ....................................62 + 10.3.3 302 Found ................................................62 + 10.3.4 303 See Other ............................................63 + 10.3.5 304 Not Modified .........................................63 + 10.3.6 305 Use Proxy ............................................64 + 10.3.7 306 (Unused) .............................................64 + + + +Fielding, et al. Standards Track [Page 3] + +RFC 2616 HTTP/1.1 June 1999 + + + 10.3.8 307 Temporary Redirect ...................................65 + 10.4 Client Error 4xx ............................................65 + 10.4.1 400 Bad Request .........................................65 + 10.4.2 401 Unauthorized ........................................66 + 10.4.3 402 Payment Required ....................................66 + 10.4.4 403 Forbidden ...........................................66 + 10.4.5 404 Not Found ...........................................66 + 10.4.6 405 Method Not Allowed ..................................66 + 10.4.7 406 Not Acceptable ......................................67 + 10.4.8 407 Proxy Authentication Required .......................67 + 10.4.9 408 Request Timeout .....................................67 + 10.4.10 409 Conflict ............................................67 + 10.4.11 410 Gone ................................................68 + 10.4.12 411 Length Required .....................................68 + 10.4.13 412 Precondition Failed .................................68 + 10.4.14 413 Request Entity Too Large ............................69 + 10.4.15 414 Request-URI Too Long ................................69 + 10.4.16 415 Unsupported Media Type ..............................69 + 10.4.17 416 Requested Range Not Satisfiable .....................69 + 10.4.18 417 Expectation Failed ..................................70 + 10.5 Server Error 5xx ............................................70 + 10.5.1 500 Internal Server Error ................................70 + 10.5.2 501 Not Implemented ......................................70 + 10.5.3 502 Bad Gateway ..........................................70 + 10.5.4 503 Service Unavailable ..................................70 + 10.5.5 504 Gateway Timeout ......................................71 + 10.5.6 505 HTTP Version Not Supported ...........................71 + 11 Access Authentication ........................................71 + 12 Content Negotiation ..........................................71 + 12.1 Server-driven Negotiation ...................................72 + 12.2 Agent-driven Negotiation ....................................73 + 12.3 Transparent Negotiation .....................................74 + 13 Caching in HTTP ..............................................74 + 13.1.1 Cache Correctness ........................................75 + 13.1.2 Warnings .................................................76 + 13.1.3 Cache-control Mechanisms .................................77 + 13.1.4 Explicit User Agent Warnings .............................78 + 13.1.5 Exceptions to the Rules and Warnings .....................78 + 13.1.6 Client-controlled Behavior ...............................79 + 13.2 Expiration Model ............................................79 + 13.2.1 Server-Specified Expiration ..............................79 + 13.2.2 Heuristic Expiration .....................................80 + 13.2.3 Age Calculations .........................................80 + 13.2.4 Expiration Calculations ..................................83 + 13.2.5 Disambiguating Expiration Values .........................84 + 13.2.6 Disambiguating Multiple Responses ........................84 + 13.3 Validation Model ............................................85 + 13.3.1 Last-Modified Dates ......................................86 + + + +Fielding, et al. Standards Track [Page 4] + +RFC 2616 HTTP/1.1 June 1999 + + + 13.3.2 Entity Tag Cache Validators ..............................86 + 13.3.3 Weak and Strong Validators ...............................86 + 13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates.89 + 13.3.5 Non-validating Conditionals ..............................90 + 13.4 Response Cacheability .......................................91 + 13.5 Constructing Responses From Caches ..........................92 + 13.5.1 End-to-end and Hop-by-hop Headers ........................92 + 13.5.2 Non-modifiable Headers ...................................92 + 13.5.3 Combining Headers ........................................94 + 13.5.4 Combining Byte Ranges ....................................95 + 13.6 Caching Negotiated Responses ................................95 + 13.7 Shared and Non-Shared Caches ................................96 + 13.8 Errors or Incomplete Response Cache Behavior ................97 + 13.9 Side Effects of GET and HEAD ................................97 + 13.10 Invalidation After Updates or Deletions ...................97 + 13.11 Write-Through Mandatory ...................................98 + 13.12 Cache Replacement .........................................99 + 13.13 History Lists .............................................99 + 14 Header Field Definitions ....................................100 + 14.1 Accept .....................................................100 + 14.2 Accept-Charset .............................................102 + 14.3 Accept-Encoding ............................................102 + 14.4 Accept-Language ............................................104 + 14.5 Accept-Ranges ..............................................105 + 14.6 Age ........................................................106 + 14.7 Allow ......................................................106 + 14.8 Authorization ..............................................107 + 14.9 Cache-Control ..............................................108 + 14.9.1 What is Cacheable .......................................109 + 14.9.2 What May be Stored by Caches ............................110 + 14.9.3 Modifications of the Basic Expiration Mechanism .........111 + 14.9.4 Cache Revalidation and Reload Controls ..................113 + 14.9.5 No-Transform Directive ..................................115 + 14.9.6 Cache Control Extensions ................................116 + 14.10 Connection ...............................................117 + 14.11 Content-Encoding .........................................118 + 14.12 Content-Language .........................................118 + 14.13 Content-Length ...........................................119 + 14.14 Content-Location .........................................120 + 14.15 Content-MD5 ..............................................121 + 14.16 Content-Range ............................................122 + 14.17 Content-Type .............................................124 + 14.18 Date .....................................................124 + 14.18.1 Clockless Origin Server Operation ......................125 + 14.19 ETag .....................................................126 + 14.20 Expect ...................................................126 + 14.21 Expires ..................................................127 + 14.22 From .....................................................128 + + + +Fielding, et al. Standards Track [Page 5] + +RFC 2616 HTTP/1.1 June 1999 + + + 14.23 Host .....................................................128 + 14.24 If-Match .................................................129 + 14.25 If-Modified-Since ........................................130 + 14.26 If-None-Match ............................................132 + 14.27 If-Range .................................................133 + 14.28 If-Unmodified-Since ......................................134 + 14.29 Last-Modified ............................................134 + 14.30 Location .................................................135 + 14.31 Max-Forwards .............................................136 + 14.32 Pragma ...................................................136 + 14.33 Proxy-Authenticate .......................................137 + 14.34 Proxy-Authorization ......................................137 + 14.35 Range ....................................................138 + 14.35.1 Byte Ranges ...........................................138 + 14.35.2 Range Retrieval Requests ..............................139 + 14.36 Referer ..................................................140 + 14.37 Retry-After ..............................................141 + 14.38 Server ...................................................141 + 14.39 TE .......................................................142 + 14.40 Trailer ..................................................143 + 14.41 Transfer-Encoding..........................................143 + 14.42 Upgrade ..................................................144 + 14.43 User-Agent ...............................................145 + 14.44 Vary .....................................................145 + 14.45 Via ......................................................146 + 14.46 Warning ..................................................148 + 14.47 WWW-Authenticate .........................................150 + 15 Security Considerations .......................................150 + 15.1 Personal Information....................................151 + 15.1.1 Abuse of Server Log Information .........................151 + 15.1.2 Transfer of Sensitive Information .......................151 + 15.1.3 Encoding Sensitive Information in URI's .................152 + 15.1.4 Privacy Issues Connected to Accept Headers ..............152 + 15.2 Attacks Based On File and Path Names .......................153 + 15.3 DNS Spoofing ...............................................154 + 15.4 Location Headers and Spoofing ..............................154 + 15.5 Content-Disposition Issues .................................154 + 15.6 Authentication Credentials and Idle Clients ................155 + 15.7 Proxies and Caching ........................................155 + 15.7.1 Denial of Service Attacks on Proxies....................156 + 16 Acknowledgments .............................................156 + 17 References ..................................................158 + 18 Authors' Addresses ..........................................162 + 19 Appendices ..................................................164 + 19.1 Internet Media Type message/http and application/http ......164 + 19.2 Internet Media Type multipart/byteranges ...................165 + 19.3 Tolerant Applications ......................................166 + 19.4 Differences Between HTTP Entities and RFC 2045 Entities ....167 + + + +Fielding, et al. Standards Track [Page 6] + +RFC 2616 HTTP/1.1 June 1999 + + + 19.4.1 MIME-Version ............................................167 + 19.4.2 Conversion to Canonical Form ............................167 + 19.4.3 Conversion of Date Formats ..............................168 + 19.4.4 Introduction of Content-Encoding ........................168 + 19.4.5 No Content-Transfer-Encoding ............................168 + 19.4.6 Introduction of Transfer-Encoding .......................169 + 19.4.7 MHTML and Line Length Limitations .......................169 + 19.5 Additional Features ........................................169 + 19.5.1 Content-Disposition .....................................170 + 19.6 Compatibility with Previous Versions .......................170 + 19.6.1 Changes from HTTP/1.0 ...................................171 + 19.6.2 Compatibility with HTTP/1.0 Persistent Connections ......172 + 19.6.3 Changes from RFC 2068 ...................................172 + 20 Index .......................................................175 + 21 Full Copyright Statement ....................................176 + +1 Introduction + +1.1 Purpose + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. HTTP has been in use by the World-Wide Web global + information initiative since 1990. The first version of HTTP, + referred to as HTTP/0.9, was a simple protocol for raw data transfer + across the Internet. HTTP/1.0, as defined by RFC 1945 [6], improved + the protocol by allowing messages to be in the format of MIME-like + messages, containing metainformation about the data transferred and + modifiers on the request/response semantics. However, HTTP/1.0 does + not sufficiently take into consideration the effects of hierarchical + proxies, caching, the need for persistent connections, or virtual + hosts. In addition, the proliferation of incompletely-implemented + applications calling themselves "HTTP/1.0" has necessitated a + protocol version change in order for two communicating applications + to determine each other's true capabilities. + + This specification defines the protocol referred to as "HTTP/1.1". + This protocol includes more stringent requirements than HTTP/1.0 in + order to ensure reliable implementation of its features. + + Practical information systems require more functionality than simple + retrieval, including search, front-end update, and annotation. HTTP + allows an open-ended set of methods and headers that indicate the + purpose of a request [47]. It builds on the discipline of reference + provided by the Uniform Resource Identifier (URI) [3], as a location + (URL) [4] or name (URN) [20], for indicating the resource to which a + + + + + +Fielding, et al. Standards Track [Page 7] + +RFC 2616 HTTP/1.1 June 1999 + + + method is to be applied. Messages are passed in a format similar to + that used by Internet mail [9] as defined by the Multipurpose + Internet Mail Extensions (MIME) [7]. + + HTTP is also used as a generic protocol for communication between + user agents and proxies/gateways to other Internet systems, including + those supported by the SMTP [16], NNTP [13], FTP [18], Gopher [2], + and WAIS [10] protocols. In this way, HTTP allows basic hypermedia + access to resources available from diverse applications. + +1.2 Requirements + + The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", + "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this + document are to be interpreted as described in RFC 2119 [34]. + + An implementation is not compliant if it fails to satisfy one or more + of the MUST or REQUIRED level requirements for the protocols it + implements. An implementation that satisfies all the MUST or REQUIRED + level and all the SHOULD level requirements for its protocols is said + to be "unconditionally compliant"; one that satisfies all the MUST + level requirements but not all the SHOULD level requirements for its + protocols is said to be "conditionally compliant." + +1.3 Terminology + + This specification uses a number of terms to refer to the roles + played by participants in, and objects of, the HTTP communication. + + connection + A transport layer virtual circuit established between two programs + for the purpose of communication. + + message + The basic unit of HTTP communication, consisting of a structured + sequence of octets matching the syntax defined in section 4 and + transmitted via the connection. + + request + An HTTP request message, as defined in section 5. + + response + An HTTP response message, as defined in section 6. + + + + + + + + +Fielding, et al. Standards Track [Page 8] + +RFC 2616 HTTP/1.1 June 1999 + + + resource + A network data object or service that can be identified by a URI, + as defined in section 3.2. Resources may be available in multiple + representations (e.g. multiple languages, data formats, size, and + resolutions) or vary in other ways. + + entity + The information transferred as the payload of a request or + response. An entity consists of metainformation in the form of + entity-header fields and content in the form of an entity-body, as + described in section 7. + + representation + An entity included with a response that is subject to content + negotiation, as described in section 12. There may exist multiple + representations associated with a particular response status. + + content negotiation + The mechanism for selecting the appropriate representation when + servicing a request, as described in section 12. The + representation of entities in any response can be negotiated + (including error responses). + + variant + A resource may have one, or more than one, representation(s) + associated with it at any given instant. Each of these + representations is termed a `varriant'. Use of the term `variant' + does not necessarily imply that the resource is subject to content + negotiation. + + client + A program that establishes connections for the purpose of sending + requests. + + user agent + The client which initiates a request. These are often browsers, + editors, spiders (web-traversing robots), or other end user tools. + + server + An application program that accepts connections in order to + service requests by sending back responses. Any given program may + be capable of being both a client and a server; our use of these + terms refers only to the role being performed by the program for a + particular connection, rather than to the program's capabilities + in general. Likewise, any server may act as an origin server, + proxy, gateway, or tunnel, switching behavior based on the nature + of each request. + + + + +Fielding, et al. Standards Track [Page 9] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server + The server on which a given resource resides or is to be created. + + proxy + An intermediary program which acts as both a server and a client + for the purpose of making requests on behalf of other clients. + Requests are serviced internally or by passing them on, with + possible translation, to other servers. A proxy MUST implement + both the client and server requirements of this specification. A + "transparent proxy" is a proxy that does not modify the request or + response beyond what is required for proxy authentication and + identification. A "non-transparent proxy" is a proxy that modifies + the request or response in order to provide some added service to + the user agent, such as group annotation services, media type + transformation, protocol reduction, or anonymity filtering. Except + where either transparent or non-transparent behavior is explicitly + stated, the HTTP proxy requirements apply to both types of + proxies. + + gateway + A server which acts as an intermediary for some other server. + Unlike a proxy, a gateway receives requests as if it were the + origin server for the requested resource; the requesting client + may not be aware that it is communicating with a gateway. + + tunnel + An intermediary program which is acting as a blind relay between + two connections. Once active, a tunnel is not considered a party + to the HTTP communication, though the tunnel may have been + initiated by an HTTP request. The tunnel ceases to exist when both + ends of the relayed connections are closed. + + cache + A program's local store of response messages and the subsystem + that controls its message storage, retrieval, and deletion. A + cache stores cacheable responses in order to reduce the response + time and network bandwidth consumption on future, equivalent + requests. Any client or server may include a cache, though a cache + cannot be used by a server that is acting as a tunnel. + + cacheable + A response is cacheable if a cache is allowed to store a copy of + the response message for use in answering subsequent requests. The + rules for determining the cacheability of HTTP responses are + defined in section 13. Even if a resource is cacheable, there may + be additional constraints on whether a cache can use the cached + copy for a particular request. + + + + +Fielding, et al. Standards Track [Page 10] + +RFC 2616 HTTP/1.1 June 1999 + + + first-hand + A response is first-hand if it comes directly and without + unnecessary delay from the origin server, perhaps via one or more + proxies. A response is also first-hand if its validity has just + been checked directly with the origin server. + + explicit expiration time + The time at which the origin server intends that an entity should + no longer be returned by a cache without further validation. + + heuristic expiration time + An expiration time assigned by a cache when no explicit expiration + time is available. + + age + The age of a response is the time since it was sent by, or + successfully validated with, the origin server. + + freshness lifetime + The length of time between the generation of a response and its + expiration time. + + fresh + A response is fresh if its age has not yet exceeded its freshness + lifetime. + + stale + A response is stale if its age has passed its freshness lifetime. + + semantically transparent + A cache behaves in a "semantically transparent" manner, with + respect to a particular response, when its use affects neither the + requesting client nor the origin server, except to improve + performance. When a cache is semantically transparent, the client + receives exactly the same response (except for hop-by-hop headers) + that it would have received had its request been handled directly + by the origin server. + + validator + A protocol element (e.g., an entity tag or a Last-Modified time) + that is used to find out whether a cache entry is an equivalent + copy of an entity. + + upstream/downstream + Upstream and downstream describe the flow of a message: all + messages flow from upstream to downstream. + + + + + +Fielding, et al. Standards Track [Page 11] + +RFC 2616 HTTP/1.1 June 1999 + + + inbound/outbound + Inbound and outbound refer to the request and response paths for + messages: "inbound" means "traveling toward the origin server", + and "outbound" means "traveling toward the user agent" + +1.4 Overall Operation + + The HTTP protocol is a request/response protocol. A client sends a + request to the server in the form of a request method, URI, and + protocol version, followed by a MIME-like message containing request + modifiers, client information, and possible body content over a + connection with a server. The server responds with a status line, + including the message's protocol version and a success or error code, + followed by a MIME-like message containing server information, entity + metainformation, and possible entity-body content. The relationship + between HTTP and MIME is described in appendix 19.4. + + Most HTTP communication is initiated by a user agent and consists of + a request to be applied to a resource on some origin server. In the + simplest case, this may be accomplished via a single connection (v) + between the user agent (UA) and the origin server (O). + + request chain ------------------------> + UA -------------------v------------------- O + <----------------------- response chain + + A more complicated situation occurs when one or more intermediaries + are present in the request/response chain. There are three common + forms of intermediary: proxy, gateway, and tunnel. A proxy is a + forwarding agent, receiving requests for a URI in its absolute form, + rewriting all or part of the message, and forwarding the reformatted + request toward the server identified by the URI. A gateway is a + receiving agent, acting as a layer above some other server(s) and, if + necessary, translating the requests to the underlying server's + protocol. A tunnel acts as a relay point between two connections + without changing the messages; tunnels are used when the + communication needs to pass through an intermediary (such as a + firewall) even when the intermediary cannot understand the contents + of the messages. + + request chain --------------------------------------> + UA -----v----- A -----v----- B -----v----- C -----v----- O + <------------------------------------- response chain + + The figure above shows three intermediaries (A, B, and C) between the + user agent and origin server. A request or response message that + travels the whole chain will pass through four separate connections. + This distinction is important because some HTTP communication options + + + +Fielding, et al. Standards Track [Page 12] + +RFC 2616 HTTP/1.1 June 1999 + + + may apply only to the connection with the nearest, non-tunnel + neighbor, only to the end-points of the chain, or to all connections + along the chain. Although the diagram is linear, each participant may + be engaged in multiple, simultaneous communications. For example, B + may be receiving requests from many clients other than A, and/or + forwarding requests to servers other than C, at the same time that it + is handling A's request. + + Any party to the communication which is not acting as a tunnel may + employ an internal cache for handling requests. The effect of a cache + is that the request/response chain is shortened if one of the + participants along the chain has a cached response applicable to that + request. The following illustrates the resulting chain if B has a + cached copy of an earlier response from O (via C) for a request which + has not been cached by UA or A. + + request chain ----------> + UA -----v----- A -----v----- B - - - - - - C - - - - - - O + <--------- response chain + + Not all responses are usefully cacheable, and some requests may + contain modifiers which place special requirements on cache behavior. + HTTP requirements for cache behavior and cacheable responses are + defined in section 13. + + In fact, there are a wide variety of architectures and configurations + of caches and proxies currently being experimented with or deployed + across the World Wide Web. These systems include national hierarchies + of proxy caches to save transoceanic bandwidth, systems that + broadcast or multicast cache entries, organizations that distribute + subsets of cached data via CD-ROM, and so on. HTTP systems are used + in corporate intranets over high-bandwidth links, and for access via + PDAs with low-power radio links and intermittent connectivity. The + goal of HTTP/1.1 is to support the wide diversity of configurations + already deployed while introducing protocol constructs that meet the + needs of those who build web applications that require high + reliability and, failing that, at least reliable indications of + failure. + + HTTP communication usually takes place over TCP/IP connections. The + default port is TCP 80 [19], but other ports can be used. This does + not preclude HTTP from being implemented on top of any other protocol + on the Internet, or on other networks. HTTP only presumes a reliable + transport; any protocol that provides such guarantees can be used; + the mapping of the HTTP/1.1 request and response structures onto the + transport data units of the protocol in question is outside the scope + of this specification. + + + + +Fielding, et al. Standards Track [Page 13] + +RFC 2616 HTTP/1.1 June 1999 + + + In HTTP/1.0, most implementations used a new connection for each + request/response exchange. In HTTP/1.1, a connection may be used for + one or more request/response exchanges, although connections may be + closed for a variety of reasons (see section 8.1). + +2 Notational Conventions and Generic Grammar + +2.1 Augmented BNF + + All of the mechanisms specified in this document are described in + both prose and an augmented Backus-Naur Form (BNF) similar to that + used by RFC 822 [9]. Implementors will need to be familiar with the + notation in order to understand this specification. The augmented BNF + includes the following constructs: + + name = definition + The name of a rule is simply the name itself (without any + enclosing "<" and ">") and is separated from its definition by the + equal "=" character. White space is only significant in that + indentation of continuation lines is used to indicate a rule + definition that spans more than one line. Certain basic rules are + in uppercase, such as SP, LWS, HT, CRLF, DIGIT, ALPHA, etc. Angle + brackets are used within definitions whenever their presence will + facilitate discerning the use of rule names. + + "literal" + Quotation marks surround literal text. Unless stated otherwise, + the text is case-insensitive. + + rule1 | rule2 + Elements separated by a bar ("|") are alternatives, e.g., "yes | + no" will accept yes or no. + + (rule1 rule2) + Elements enclosed in parentheses are treated as a single element. + Thus, "(elem (foo | bar) elem)" allows the token sequences "elem + foo elem" and "elem bar elem". + + *rule + The character "*" preceding an element indicates repetition. The + full form is "*element" indicating at least and at most + occurrences of element. Default values are 0 and infinity so + that "*(element)" allows any number, including zero; "1*element" + requires at least one; and "1*2element" allows one or two. + + [rule] + Square brackets enclose optional elements; "[foo bar]" is + equivalent to "*1(foo bar)". + + + +Fielding, et al. Standards Track [Page 14] + +RFC 2616 HTTP/1.1 June 1999 + + + N rule + Specific repetition: "(element)" is equivalent to + "*(element)"; that is, exactly occurrences of (element). + Thus 2DIGIT is a 2-digit number, and 3ALPHA is a string of three + alphabetic characters. + + #rule + A construct "#" is defined, similar to "*", for defining lists of + elements. The full form is "#element" indicating at least + and at most elements, each separated by one or more commas + (",") and OPTIONAL linear white space (LWS). This makes the usual + form of lists very easy; a rule such as + ( *LWS element *( *LWS "," *LWS element )) + can be shown as + 1#element + Wherever this construct is used, null elements are allowed, but do + not contribute to the count of elements present. That is, + "(element), , (element) " is permitted, but counts as only two + elements. Therefore, where at least one element is required, at + least one non-null element MUST be present. Default values are 0 + and infinity so that "#element" allows any number, including zero; + "1#element" requires at least one; and "1#2element" allows one or + two. + + ; comment + A semi-colon, set off some distance to the right of rule text, + starts a comment that continues to the end of line. This is a + simple way of including useful notes in parallel with the + specifications. + + implied *LWS + The grammar described by this specification is word-based. Except + where noted otherwise, linear white space (LWS) can be included + between any two adjacent words (token or quoted-string), and + between adjacent words and separators, without changing the + interpretation of a field. At least one delimiter (LWS and/or + + separators) MUST exist between any two tokens (for the definition + of "token" below), since they would otherwise be interpreted as a + single token. + +2.2 Basic Rules + + The following rules are used throughout this specification to + describe basic parsing constructs. The US-ASCII coded character set + is defined by ANSI X3.4-1986 [21]. + + + + + +Fielding, et al. Standards Track [Page 15] + +RFC 2616 HTTP/1.1 June 1999 + + + OCTET = + CHAR = + UPALPHA = + LOALPHA = + ALPHA = UPALPHA | LOALPHA + DIGIT = + CTL = + CR = + LF = + SP = + HT = + <"> = + + HTTP/1.1 defines the sequence CR LF as the end-of-line marker for all + protocol elements except the entity-body (see appendix 19.3 for + tolerant applications). The end-of-line marker within an entity-body + is defined by its associated media type, as described in section 3.7. + + CRLF = CR LF + + HTTP/1.1 header field values can be folded onto multiple lines if the + continuation line begins with a space or horizontal tab. All linear + white space, including folding, has the same semantics as SP. A + recipient MAY replace any linear white space with a single SP before + interpreting the field value or forwarding the message downstream. + + LWS = [CRLF] 1*( SP | HT ) + + The TEXT rule is only used for descriptive field contents and values + that are not intended to be interpreted by the message parser. Words + of *TEXT MAY contain characters from character sets other than ISO- + 8859-1 [22] only when encoded according to the rules of RFC 2047 + [14]. + + TEXT = + + A CRLF is allowed in the definition of TEXT only as part of a header + field continuation. It is expected that the folding LWS will be + replaced with a single SP before interpretation of the TEXT value. + + Hexadecimal numeric characters are used in several protocol elements. + + HEX = "A" | "B" | "C" | "D" | "E" | "F" + | "a" | "b" | "c" | "d" | "e" | "f" | DIGIT + + + + + +Fielding, et al. Standards Track [Page 16] + +RFC 2616 HTTP/1.1 June 1999 + + + Many HTTP/1.1 header field values consist of words separated by LWS + or special characters. These special characters MUST be in a quoted + string to be used within a parameter value (as defined in section + 3.6). + + token = 1* + separators = "(" | ")" | "<" | ">" | "@" + | "," | ";" | ":" | "\" | <"> + | "/" | "[" | "]" | "?" | "=" + | "{" | "}" | SP | HT + + Comments can be included in some HTTP header fields by surrounding + the comment text with parentheses. Comments are only allowed in + fields containing "comment" as part of their field value definition. + In all other fields, parentheses are considered part of the field + value. + + comment = "(" *( ctext | quoted-pair | comment ) ")" + ctext = + + A string of text is parsed as a single word if it is quoted using + double-quote marks. + + quoted-string = ( <"> *(qdtext | quoted-pair ) <"> ) + qdtext = > + + The backslash character ("\") MAY be used as a single-character + quoting mechanism only within quoted-string and comment constructs. + + quoted-pair = "\" CHAR + +3 Protocol Parameters + +3.1 HTTP Version + + HTTP uses a "." numbering scheme to indicate versions + of the protocol. The protocol versioning policy is intended to allow + the sender to indicate the format of a message and its capacity for + understanding further HTTP communication, rather than the features + obtained via that communication. No change is made to the version + number for the addition of message components which do not affect + communication behavior or which only add to extensible field values. + The number is incremented when the changes made to the + protocol add features which do not change the general message parsing + algorithm, but which may add to the message semantics and imply + additional capabilities of the sender. The number is + incremented when the format of a message within the protocol is + changed. See RFC 2145 [36] for a fuller explanation. + + + +Fielding, et al. Standards Track [Page 17] + +RFC 2616 HTTP/1.1 June 1999 + + + The version of an HTTP message is indicated by an HTTP-Version field + in the first line of the message. + + HTTP-Version = "HTTP" "/" 1*DIGIT "." 1*DIGIT + + Note that the major and minor numbers MUST be treated as separate + integers and that each MAY be incremented higher than a single digit. + Thus, HTTP/2.4 is a lower version than HTTP/2.13, which in turn is + lower than HTTP/12.3. Leading zeros MUST be ignored by recipients and + MUST NOT be sent. + + An application that sends a request or response message that includes + HTTP-Version of "HTTP/1.1" MUST be at least conditionally compliant + with this specification. Applications that are at least conditionally + compliant with this specification SHOULD use an HTTP-Version of + "HTTP/1.1" in their messages, and MUST do so for any message that is + not compatible with HTTP/1.0. For more details on when to send + specific HTTP-Version values, see RFC 2145 [36]. + + The HTTP version of an application is the highest HTTP version for + which the application is at least conditionally compliant. + + Proxy and gateway applications need to be careful when forwarding + messages in protocol versions different from that of the application. + Since the protocol version indicates the protocol capability of the + sender, a proxy/gateway MUST NOT send a message with a version + indicator which is greater than its actual version. If a higher + version request is received, the proxy/gateway MUST either downgrade + the request version, or respond with an error, or switch to tunnel + behavior. + + Due to interoperability problems with HTTP/1.0 proxies discovered + since the publication of RFC 2068[33], caching proxies MUST, gateways + MAY, and tunnels MUST NOT upgrade the request to the highest version + they support. The proxy/gateway's response to that request MUST be in + the same major version as the request. + + Note: Converting between versions of HTTP may involve modification + of header fields required or forbidden by the versions involved. + +3.2 Uniform Resource Identifiers + + URIs have been known by many names: WWW addresses, Universal Document + Identifiers, Universal Resource Identifiers [3], and finally the + combination of Uniform Resource Locators (URL) [4] and Names (URN) + [20]. As far as HTTP is concerned, Uniform Resource Identifiers are + simply formatted strings which identify--via name, location, or any + other characteristic--a resource. + + + +Fielding, et al. Standards Track [Page 18] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.1 General Syntax + + URIs in HTTP can be represented in absolute form or relative to some + known base URI [11], depending upon the context of their use. The two + forms are differentiated by the fact that absolute URIs always begin + with a scheme name followed by a colon. For definitive information on + URL syntax and semantics, see "Uniform Resource Identifiers (URI): + Generic Syntax and Semantics," RFC 2396 [42] (which replaces RFCs + 1738 [4] and RFC 1808 [11]). This specification adopts the + definitions of "URI-reference", "absoluteURI", "relativeURI", "port", + "host","abs_path", "rel_path", and "authority" from that + specification. + + The HTTP protocol does not place any a priori limit on the length of + a URI. Servers MUST be able to handle the URI of any resource they + serve, and SHOULD be able to handle URIs of unbounded length if they + provide GET-based forms that could generate such URIs. A server + SHOULD return 414 (Request-URI Too Long) status if a URI is longer + than the server can handle (see section 10.4.15). + + Note: Servers ought to be cautious about depending on URI lengths + above 255 bytes, because some older client or proxy + implementations might not properly support these lengths. + +3.2.2 http URL + + The "http" scheme is used to locate network resources via the HTTP + protocol. This section defines the scheme-specific syntax and + semantics for http URLs. + + http_URL = "http:" "//" host [ ":" port ] [ abs_path [ "?" query ]] + + If the port is empty or not given, port 80 is assumed. The semantics + are that the identified resource is located at the server listening + for TCP connections on that port of that host, and the Request-URI + for the resource is abs_path (section 5.1.2). The use of IP addresses + in URLs SHOULD be avoided whenever possible (see RFC 1900 [24]). If + the abs_path is not present in the URL, it MUST be given as "/" when + used as a Request-URI for a resource (section 5.1.2). If a proxy + receives a host name which is not a fully qualified domain name, it + MAY add its domain to the host name it received. If a proxy receives + a fully qualified domain name, the proxy MUST NOT change the host + name. + + + + + + + + +Fielding, et al. Standards Track [Page 19] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.3 URI Comparison + + When comparing two URIs to decide if they match or not, a client + SHOULD use a case-sensitive octet-by-octet comparison of the entire + URIs, with these exceptions: + + - A port that is empty or not given is equivalent to the default + port for that URI-reference; + + - Comparisons of host names MUST be case-insensitive; + + - Comparisons of scheme names MUST be case-insensitive; + + - An empty abs_path is equivalent to an abs_path of "/". + + Characters other than those in the "reserved" and "unsafe" sets (see + RFC 2396 [42]) are equivalent to their ""%" HEX HEX" encoding. + + For example, the following three URIs are equivalent: + + http://abc.com:80/~smith/home.html + http://ABC.com/%7Esmith/home.html + http://ABC.com:/%7esmith/home.html + +3.3 Date/Time Formats + +3.3.1 Full Date + + HTTP applications have historically allowed three different formats + for the representation of date/time stamps: + + Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123 + Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036 + Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format + + The first format is preferred as an Internet standard and represents + a fixed-length subset of that defined by RFC 1123 [8] (an update to + RFC 822 [9]). The second format is in common use, but is based on the + obsolete RFC 850 [12] date format and lacks a four-digit year. + HTTP/1.1 clients and servers that parse the date value MUST accept + all three formats (for compatibility with HTTP/1.0), though they MUST + only generate the RFC 1123 format for representing HTTP-date values + in header fields. See section 19.3 for further information. + + Note: Recipients of date values are encouraged to be robust in + accepting date values that may have been sent by non-HTTP + applications, as is sometimes the case when retrieving or posting + messages via proxies/gateways to SMTP or NNTP. + + + +Fielding, et al. Standards Track [Page 20] + +RFC 2616 HTTP/1.1 June 1999 + + + All HTTP date/time stamps MUST be represented in Greenwich Mean Time + (GMT), without exception. For the purposes of HTTP, GMT is exactly + equal to UTC (Coordinated Universal Time). This is indicated in the + first two formats by the inclusion of "GMT" as the three-letter + abbreviation for time zone, and MUST be assumed when reading the + asctime format. HTTP-date is case sensitive and MUST NOT include + additional LWS beyond that specifically included as SP in the + grammar. + + HTTP-date = rfc1123-date | rfc850-date | asctime-date + rfc1123-date = wkday "," SP date1 SP time SP "GMT" + rfc850-date = weekday "," SP date2 SP time SP "GMT" + asctime-date = wkday SP date3 SP time SP 4DIGIT + date1 = 2DIGIT SP month SP 4DIGIT + ; day month year (e.g., 02 Jun 1982) + date2 = 2DIGIT "-" month "-" 2DIGIT + ; day-month-year (e.g., 02-Jun-82) + date3 = month SP ( 2DIGIT | ( SP 1DIGIT )) + ; month day (e.g., Jun 2) + time = 2DIGIT ":" 2DIGIT ":" 2DIGIT + ; 00:00:00 - 23:59:59 + wkday = "Mon" | "Tue" | "Wed" + | "Thu" | "Fri" | "Sat" | "Sun" + weekday = "Monday" | "Tuesday" | "Wednesday" + | "Thursday" | "Friday" | "Saturday" | "Sunday" + month = "Jan" | "Feb" | "Mar" | "Apr" + | "May" | "Jun" | "Jul" | "Aug" + | "Sep" | "Oct" | "Nov" | "Dec" + + Note: HTTP requirements for the date/time stamp format apply only + to their usage within the protocol stream. Clients and servers are + not required to use these formats for user presentation, request + logging, etc. + +3.3.2 Delta Seconds + + Some HTTP header fields allow a time value to be specified as an + integer number of seconds, represented in decimal, after the time + that the message was received. + + delta-seconds = 1*DIGIT + +3.4 Character Sets + + HTTP uses the same definition of the term "character set" as that + described for MIME: + + + + + +Fielding, et al. Standards Track [Page 21] + +RFC 2616 HTTP/1.1 June 1999 + + + The term "character set" is used in this document to refer to a + method used with one or more tables to convert a sequence of octets + into a sequence of characters. Note that unconditional conversion in + the other direction is not required, in that not all characters may + be available in a given character set and a character set may provide + more than one sequence of octets to represent a particular character. + This definition is intended to allow various kinds of character + encoding, from simple single-table mappings such as US-ASCII to + complex table switching methods such as those that use ISO-2022's + techniques. However, the definition associated with a MIME character + set name MUST fully specify the mapping to be performed from octets + to characters. In particular, use of external profiling information + to determine the exact mapping is not permitted. + + Note: This use of the term "character set" is more commonly + referred to as a "character encoding." However, since HTTP and + MIME share the same registry, it is important that the terminology + also be shared. + + HTTP character sets are identified by case-insensitive tokens. The + complete set of tokens is defined by the IANA Character Set registry + [19]. + + charset = token + + Although HTTP allows an arbitrary token to be used as a charset + value, any token that has a predefined value within the IANA + Character Set registry [19] MUST represent the character set defined + by that registry. Applications SHOULD limit their use of character + sets to those defined by the IANA registry. + + Implementors should be aware of IETF character set requirements [38] + [41]. + +3.4.1 Missing Charset + + Some HTTP/1.0 software has interpreted a Content-Type header without + charset parameter incorrectly to mean "recipient should guess." + Senders wishing to defeat this behavior MAY include a charset + parameter even when the charset is ISO-8859-1 and SHOULD do so when + it is known that it will not confuse the recipient. + + Unfortunately, some older HTTP/1.0 clients did not deal properly with + an explicit charset parameter. HTTP/1.1 recipients MUST respect the + charset label provided by the sender; and those user agents that have + a provision to "guess" a charset MUST use the charset from the + + + + + +Fielding, et al. Standards Track [Page 22] + +RFC 2616 HTTP/1.1 June 1999 + + + content-type field if they support that charset, rather than the + recipient's preference, when initially displaying a document. See + section 3.7.1. + +3.5 Content Codings + + Content coding values indicate an encoding transformation that has + been or can be applied to an entity. Content codings are primarily + used to allow a document to be compressed or otherwise usefully + transformed without losing the identity of its underlying media type + and without loss of information. Frequently, the entity is stored in + coded form, transmitted directly, and only decoded by the recipient. + + content-coding = token + + All content-coding values are case-insensitive. HTTP/1.1 uses + content-coding values in the Accept-Encoding (section 14.3) and + Content-Encoding (section 14.11) header fields. Although the value + describes the content-coding, what is more important is that it + indicates what decoding mechanism will be required to remove the + encoding. + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + content-coding value tokens. Initially, the registry contains the + following tokens: + + gzip An encoding format produced by the file compression program + "gzip" (GNU zip) as described in RFC 1952 [25]. This format is a + Lempel-Ziv coding (LZ77) with a 32 bit CRC. + + compress + The encoding format produced by the common UNIX file compression + program "compress". This format is an adaptive Lempel-Ziv-Welch + coding (LZW). + + Use of program names for the identification of encoding formats + is not desirable and is discouraged for future encodings. Their + use here is representative of historical practice, not good + design. For compatibility with previous implementations of HTTP, + applications SHOULD consider "x-gzip" and "x-compress" to be + equivalent to "gzip" and "compress" respectively. + + deflate + The "zlib" format defined in RFC 1950 [31] in combination with + the "deflate" compression mechanism described in RFC 1951 [29]. + + + + + + +Fielding, et al. Standards Track [Page 23] + +RFC 2616 HTTP/1.1 June 1999 + + + identity + The default (identity) encoding; the use of no transformation + whatsoever. This content-coding is used only in the Accept- + Encoding header, and SHOULD NOT be used in the Content-Encoding + header. + + New content-coding value tokens SHOULD be registered; to allow + interoperability between clients and servers, specifications of the + content coding algorithms needed to implement a new value SHOULD be + publicly available and adequate for independent implementation, and + conform to the purpose of content coding defined in this section. + +3.6 Transfer Codings + + Transfer-coding values are used to indicate an encoding + transformation that has been, can be, or may need to be applied to an + entity-body in order to ensure "safe transport" through the network. + This differs from a content coding in that the transfer-coding is a + property of the message, not of the original entity. + + transfer-coding = "chunked" | transfer-extension + transfer-extension = token *( ";" parameter ) + + Parameters are in the form of attribute/value pairs. + + parameter = attribute "=" value + attribute = token + value = token | quoted-string + + All transfer-coding values are case-insensitive. HTTP/1.1 uses + transfer-coding values in the TE header field (section 14.39) and in + the Transfer-Encoding header field (section 14.41). + + Whenever a transfer-coding is applied to a message-body, the set of + transfer-codings MUST include "chunked", unless the message is + terminated by closing the connection. When the "chunked" transfer- + coding is used, it MUST be the last transfer-coding applied to the + message-body. The "chunked" transfer-coding MUST NOT be applied more + than once to a message-body. These rules allow the recipient to + determine the transfer-length of the message (section 4.4). + + Transfer-codings are analogous to the Content-Transfer-Encoding + values of MIME [7], which were designed to enable safe transport of + binary data over a 7-bit transport service. However, safe transport + has a different focus for an 8bit-clean transfer protocol. In HTTP, + the only unsafe characteristic of message-bodies is the difficulty in + determining the exact body length (section 7.2.2), or the desire to + encrypt data over a shared transport. + + + +Fielding, et al. Standards Track [Page 24] + +RFC 2616 HTTP/1.1 June 1999 + + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + transfer-coding value tokens. Initially, the registry contains the + following tokens: "chunked" (section 3.6.1), "identity" (section + 3.6.2), "gzip" (section 3.5), "compress" (section 3.5), and "deflate" + (section 3.5). + + New transfer-coding value tokens SHOULD be registered in the same way + as new content-coding value tokens (section 3.5). + + A server which receives an entity-body with a transfer-coding it does + not understand SHOULD return 501 (Unimplemented), and close the + connection. A server MUST NOT send transfer-codings to an HTTP/1.0 + client. + +3.6.1 Chunked Transfer Coding + + The chunked encoding modifies the body of a message in order to + transfer it as a series of chunks, each with its own size indicator, + followed by an OPTIONAL trailer containing entity-header fields. This + allows dynamically produced content to be transferred along with the + information necessary for the recipient to verify that it has + received the full message. + + Chunked-Body = *chunk + last-chunk + trailer + CRLF + + chunk = chunk-size [ chunk-extension ] CRLF + chunk-data CRLF + chunk-size = 1*HEX + last-chunk = 1*("0") [ chunk-extension ] CRLF + + chunk-extension= *( ";" chunk-ext-name [ "=" chunk-ext-val ] ) + chunk-ext-name = token + chunk-ext-val = token | quoted-string + chunk-data = chunk-size(OCTET) + trailer = *(entity-header CRLF) + + The chunk-size field is a string of hex digits indicating the size of + the chunk. The chunked encoding is ended by any chunk whose size is + zero, followed by the trailer, which is terminated by an empty line. + + The trailer allows the sender to include additional HTTP header + fields at the end of the message. The Trailer header field can be + used to indicate which header fields are included in a trailer (see + section 14.40). + + + + +Fielding, et al. Standards Track [Page 25] + +RFC 2616 HTTP/1.1 June 1999 + + + A server using chunked transfer-coding in a response MUST NOT use the + trailer for any header fields unless at least one of the following is + true: + + a)the request included a TE header field that indicates "trailers" is + acceptable in the transfer-coding of the response, as described in + section 14.39; or, + + b)the server is the origin server for the response, the trailer + fields consist entirely of optional metadata, and the recipient + could use the message (in a manner acceptable to the origin server) + without receiving this metadata. In other words, the origin server + is willing to accept the possibility that the trailer fields might + be silently discarded along the path to the client. + + This requirement prevents an interoperability failure when the + message is being received by an HTTP/1.1 (or later) proxy and + forwarded to an HTTP/1.0 recipient. It avoids a situation where + compliance with the protocol would have necessitated a possibly + infinite buffer on the proxy. + + An example process for decoding a Chunked-Body is presented in + appendix 19.4.6. + + All HTTP/1.1 applications MUST be able to receive and decode the + "chunked" transfer-coding, and MUST ignore chunk-extension extensions + they do not understand. + +3.7 Media Types + + HTTP uses Internet Media Types [17] in the Content-Type (section + 14.17) and Accept (section 14.1) header fields in order to provide + open and extensible data typing and type negotiation. + + media-type = type "/" subtype *( ";" parameter ) + type = token + subtype = token + + Parameters MAY follow the type/subtype in the form of attribute/value + pairs (as defined in section 3.6). + + The type, subtype, and parameter attribute names are case- + insensitive. Parameter values might or might not be case-sensitive, + depending on the semantics of the parameter name. Linear white space + (LWS) MUST NOT be used between the type and subtype, nor between an + attribute and its value. The presence or absence of a parameter might + be significant to the processing of a media-type, depending on its + definition within the media type registry. + + + +Fielding, et al. Standards Track [Page 26] + +RFC 2616 HTTP/1.1 June 1999 + + + Note that some older HTTP applications do not recognize media type + parameters. When sending data to older HTTP applications, + implementations SHOULD only use media type parameters when they are + required by that type/subtype definition. + + Media-type values are registered with the Internet Assigned Number + Authority (IANA [19]). The media type registration process is + outlined in RFC 1590 [17]. Use of non-registered media types is + discouraged. + +3.7.1 Canonicalization and Text Defaults + + Internet media types are registered with a canonical form. An + entity-body transferred via HTTP messages MUST be represented in the + appropriate canonical form prior to its transmission except for + "text" types, as defined in the next paragraph. + + When in canonical form, media subtypes of the "text" type use CRLF as + the text line break. HTTP relaxes this requirement and allows the + transport of text media with plain CR or LF alone representing a line + break when it is done consistently for an entire entity-body. HTTP + applications MUST accept CRLF, bare CR, and bare LF as being + representative of a line break in text media received via HTTP. In + addition, if the text is represented in a character set that does not + use octets 13 and 10 for CR and LF respectively, as is the case for + some multi-byte character sets, HTTP allows the use of whatever octet + sequences are defined by that character set to represent the + equivalent of CR and LF for line breaks. This flexibility regarding + line breaks applies only to text media in the entity-body; a bare CR + or LF MUST NOT be substituted for CRLF within any of the HTTP control + structures (such as header fields and multipart boundaries). + + If an entity-body is encoded with a content-coding, the underlying + data MUST be in a form defined above prior to being encoded. + + The "charset" parameter is used with some media types to define the + character set (section 3.4) of the data. When no explicit charset + parameter is provided by the sender, media subtypes of the "text" + type are defined to have a default charset value of "ISO-8859-1" when + received via HTTP. Data in character sets other than "ISO-8859-1" or + its subsets MUST be labeled with an appropriate charset value. See + section 3.4.1 for compatibility problems. + +3.7.2 Multipart Types + + MIME provides for a number of "multipart" types -- encapsulations of + one or more entities within a single message-body. All multipart + types share a common syntax, as defined in section 5.1.1 of RFC 2046 + + + +Fielding, et al. Standards Track [Page 27] + +RFC 2616 HTTP/1.1 June 1999 + + + [40], and MUST include a boundary parameter as part of the media type + value. The message body is itself a protocol element and MUST + therefore use only CRLF to represent line breaks between body-parts. + Unlike in RFC 2046, the epilogue of any multipart message MUST be + empty; HTTP applications MUST NOT transmit the epilogue (even if the + original multipart contains an epilogue). These restrictions exist in + order to preserve the self-delimiting nature of a multipart message- + body, wherein the "end" of the message-body is indicated by the + ending multipart boundary. + + In general, HTTP treats a multipart message-body no differently than + any other media type: strictly as payload. The one exception is the + "multipart/byteranges" type (appendix 19.2) when it appears in a 206 + (Partial Content) response, which will be interpreted by some HTTP + caching mechanisms as described in sections 13.5.4 and 14.16. In all + other cases, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + The MIME header fields within each body-part of a multipart message- + body do not have any significance to HTTP beyond that defined by + their MIME semantics. + + In general, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + If an application receives an unrecognized multipart subtype, the + application MUST treat it as being equivalent to "multipart/mixed". + + Note: The "multipart/form-data" type has been specifically defined + for carrying form data suitable for processing via the POST + request method, as described in RFC 1867 [15]. + +3.8 Product Tokens + + Product tokens are used to allow communicating applications to + identify themselves by software name and version. Most fields using + product tokens also allow sub-products which form a significant part + of the application to be listed, separated by white space. By + convention, the products are listed in order of their significance + for identifying the application. + + product = token ["/" product-version] + product-version = token + + Examples: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + Server: Apache/0.8.4 + + + + + +Fielding, et al. Standards Track [Page 28] + +RFC 2616 HTTP/1.1 June 1999 + + + Product tokens SHOULD be short and to the point. They MUST NOT be + used for advertising or other non-essential information. Although any + token character MAY appear in a product-version, this token SHOULD + only be used for a version identifier (i.e., successive versions of + the same product SHOULD only differ in the product-version portion of + the product value). + +3.9 Quality Values + + HTTP content negotiation (section 12) uses short "floating point" + numbers to indicate the relative importance ("weight") of various + negotiable parameters. A weight is normalized to a real number in + the range 0 through 1, where 0 is the minimum and 1 the maximum + value. If a parameter has a quality value of 0, then content with + this parameter is `not acceptable' for the client. HTTP/1.1 + applications MUST NOT generate more than three digits after the + decimal point. User configuration of these values SHOULD also be + limited in this fashion. + + qvalue = ( "0" [ "." 0*3DIGIT ] ) + | ( "1" [ "." 0*3("0") ] ) + + "Quality values" is a misnomer, since these values merely represent + relative degradation in desired quality. + +3.10 Language Tags + + A language tag identifies a natural language spoken, written, or + otherwise conveyed by human beings for communication of information + to other human beings. Computer languages are explicitly excluded. + HTTP uses language tags within the Accept-Language and Content- + Language fields. + + The syntax and registry of HTTP language tags is the same as that + defined by RFC 1766 [1]. In summary, a language tag is composed of 1 + or more parts: A primary language tag and a possibly empty series of + subtags: + + language-tag = primary-tag *( "-" subtag ) + primary-tag = 1*8ALPHA + subtag = 1*8ALPHA + + White space is not allowed within the tag and all tags are case- + insensitive. The name space of language tags is administered by the + IANA. Example tags include: + + en, en-US, en-cockney, i-cherokee, x-pig-latin + + + + +Fielding, et al. Standards Track [Page 29] + +RFC 2616 HTTP/1.1 June 1999 + + + where any two-letter primary-tag is an ISO-639 language abbreviation + and any two-letter initial subtag is an ISO-3166 country code. (The + last three tags above are not registered tags; all but the last are + examples of tags which could be registered in future.) + +3.11 Entity Tags + + Entity tags are used for comparing two or more entities from the same + requested resource. HTTP/1.1 uses entity tags in the ETag (section + 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and + If-Range (section 14.27) header fields. The definition of how they + are used and compared as cache validators is in section 13.3.3. An + entity tag consists of an opaque quoted string, possibly prefixed by + a weakness indicator. + + entity-tag = [ weak ] opaque-tag + weak = "W/" + opaque-tag = quoted-string + + A "strong entity tag" MAY be shared by two entities of a resource + only if they are equivalent by octet equality. + + A "weak entity tag," indicated by the "W/" prefix, MAY be shared by + two entities of a resource only if the entities are equivalent and + could be substituted for each other with no significant change in + semantics. A weak entity tag can only be used for weak comparison. + + An entity tag MUST be unique across all versions of all entities + associated with a particular resource. A given entity tag value MAY + be used for entities obtained by requests on different URIs. The use + of the same entity tag value in conjunction with entities obtained by + requests on different URIs does not imply the equivalence of those + entities. + +3.12 Range Units + + HTTP/1.1 allows a client to request that only part (a range of) the + response entity be included within the response. HTTP/1.1 uses range + units in the Range (section 14.35) and Content-Range (section 14.16) + header fields. An entity can be broken down into subranges according + to various structural units. + + range-unit = bytes-unit | other-range-unit + bytes-unit = "bytes" + other-range-unit = token + + The only range unit defined by HTTP/1.1 is "bytes". HTTP/1.1 + implementations MAY ignore ranges specified using other units. + + + +Fielding, et al. Standards Track [Page 30] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 has been designed to allow implementations of applications + that do not depend on knowledge of ranges. + +4 HTTP Message + +4.1 Message Types + + HTTP messages consist of requests from client to server and responses + from server to client. + + HTTP-message = Request | Response ; HTTP/1.1 messages + + Request (section 5) and Response (section 6) messages use the generic + message format of RFC 822 [9] for transferring entities (the payload + of the message). Both types of message consist of a start-line, zero + or more header fields (also known as "headers"), an empty line (i.e., + a line with nothing preceding the CRLF) indicating the end of the + header fields, and possibly a message-body. + + generic-message = start-line + *(message-header CRLF) + CRLF + [ message-body ] + start-line = Request-Line | Status-Line + + In the interest of robustness, servers SHOULD ignore any empty + line(s) received where a Request-Line is expected. In other words, if + the server is reading the protocol stream at the beginning of a + message and receives a CRLF first, it should ignore the CRLF. + + Certain buggy HTTP/1.0 client implementations generate extra CRLF's + after a POST request. To restate what is explicitly forbidden by the + BNF, an HTTP/1.1 client MUST NOT preface or follow a request with an + extra CRLF. + +4.2 Message Headers + + HTTP header fields, which include general-header (section 4.5), + request-header (section 5.3), response-header (section 6.2), and + entity-header (section 7.1) fields, follow the same generic format as + that given in Section 3.1 of RFC 822 [9]. Each header field consists + of a name followed by a colon (":") and the field value. Field names + are case-insensitive. The field value MAY be preceded by any amount + of LWS, though a single SP is preferred. Header fields can be + extended over multiple lines by preceding each extra line with at + least one SP or HT. Applications ought to follow "common form", where + one is known or indicated, when generating HTTP constructs, since + there might exist some implementations that fail to accept anything + + + +Fielding, et al. Standards Track [Page 31] + +RFC 2616 HTTP/1.1 June 1999 + + + beyond the common forms. + + message-header = field-name ":" [ field-value ] + field-name = token + field-value = *( field-content | LWS ) + field-content = + + The field-content does not include any leading or trailing LWS: + linear white space occurring before the first non-whitespace + character of the field-value or after the last non-whitespace + character of the field-value. Such leading or trailing LWS MAY be + removed without changing the semantics of the field value. Any LWS + that occurs between field-content MAY be replaced with a single SP + before interpreting the field value or forwarding the message + downstream. + + The order in which header fields with differing field names are + received is not significant. However, it is "good practice" to send + general-header fields first, followed by request-header or response- + header fields, and ending with the entity-header fields. + + Multiple message-header fields with the same field-name MAY be + present in a message if and only if the entire field-value for that + header field is defined as a comma-separated list [i.e., #(values)]. + It MUST be possible to combine the multiple header fields into one + "field-name: field-value" pair, without changing the semantics of the + message, by appending each subsequent field-value to the first, each + separated by a comma. The order in which header fields with the same + field-name are received is therefore significant to the + interpretation of the combined field value, and thus a proxy MUST NOT + change the order of these field values when a message is forwarded. + +4.3 Message Body + + The message-body (if any) of an HTTP message is used to carry the + entity-body associated with the request or response. The message-body + differs from the entity-body only when a transfer-coding has been + applied, as indicated by the Transfer-Encoding header field (section + 14.41). + + message-body = entity-body + | + + Transfer-Encoding MUST be used to indicate any transfer-codings + applied by an application to ensure safe and proper transfer of the + message. Transfer-Encoding is a property of the message, not of the + + + +Fielding, et al. Standards Track [Page 32] + +RFC 2616 HTTP/1.1 June 1999 + + + entity, and thus MAY be added or removed by any application along the + request/response chain. (However, section 3.6 places restrictions on + when certain transfer-codings may be used.) + + The rules for when a message-body is allowed in a message differ for + requests and responses. + + The presence of a message-body in a request is signaled by the + inclusion of a Content-Length or Transfer-Encoding header field in + the request's message-headers. A message-body MUST NOT be included in + a request if the specification of the request method (section 5.1.1) + does not allow sending an entity-body in requests. A server SHOULD + read and forward a message-body on any request; if the request method + does not include defined semantics for an entity-body, then the + message-body SHOULD be ignored when handling the request. + + For response messages, whether or not a message-body is included with + a message is dependent on both the request method and the response + status code (section 6.1.1). All responses to the HEAD request method + MUST NOT include a message-body, even though the presence of entity- + header fields might lead one to believe they do. All 1xx + (informational), 204 (no content), and 304 (not modified) responses + MUST NOT include a message-body. All other responses do include a + message-body, although it MAY be of zero length. + +4.4 Message Length + + The transfer-length of a message is the length of the message-body as + it appears in the message; that is, after any transfer-codings have + been applied. When a message-body is included with a message, the + transfer-length of that body is determined by one of the following + (in order of precedence): + + 1.Any response message which "MUST NOT" include a message-body (such + as the 1xx, 204, and 304 responses and any response to a HEAD + request) is always terminated by the first empty line after the + header fields, regardless of the entity-header fields present in + the message. + + 2.If a Transfer-Encoding header field (section 14.41) is present and + has any value other than "identity", then the transfer-length is + defined by use of the "chunked" transfer-coding (section 3.6), + unless the message is terminated by closing the connection. + + 3.If a Content-Length header field (section 14.13) is present, its + decimal value in OCTETs represents both the entity-length and the + transfer-length. The Content-Length header field MUST NOT be sent + if these two lengths are different (i.e., if a Transfer-Encoding + + + +Fielding, et al. Standards Track [Page 33] + +RFC 2616 HTTP/1.1 June 1999 + + + header field is present). If a message is received with both a + Transfer-Encoding header field and a Content-Length header field, + the latter MUST be ignored. + + 4.If the message uses the media type "multipart/byteranges", and the + ransfer-length is not otherwise specified, then this self- + elimiting media type defines the transfer-length. This media type + UST NOT be used unless the sender knows that the recipient can arse + it; the presence in a request of a Range header with ultiple byte- + range specifiers from a 1.1 client implies that the lient can parse + multipart/byteranges responses. + + A range header might be forwarded by a 1.0 proxy that does not + understand multipart/byteranges; in this case the server MUST + delimit the message using methods defined in items 1,3 or 5 of + this section. + + 5.By the server closing the connection. (Closing the connection + cannot be used to indicate the end of a request body, since that + would leave no possibility for the server to send back a response.) + + For compatibility with HTTP/1.0 applications, HTTP/1.1 requests + containing a message-body MUST include a valid Content-Length header + field unless the server is known to be HTTP/1.1 compliant. If a + request contains a message-body and a Content-Length is not given, + the server SHOULD respond with 400 (bad request) if it cannot + determine the length of the message, or with 411 (length required) if + it wishes to insist on receiving a valid Content-Length. + + All HTTP/1.1 applications that receive entities MUST accept the + "chunked" transfer-coding (section 3.6), thus allowing this mechanism + to be used for messages when the message length cannot be determined + in advance. + + Messages MUST NOT include both a Content-Length header field and a + non-identity transfer-coding. If the message does include a non- + identity transfer-coding, the Content-Length MUST be ignored. + + When a Content-Length is given in a message where a message-body is + allowed, its field value MUST exactly match the number of OCTETs in + the message-body. HTTP/1.1 user agents MUST notify the user when an + invalid length is received and detected. + +4.5 General Header Fields + + There are a few header fields which have general applicability for + both request and response messages, but which do not apply to the + entity being transferred. These header fields apply only to the + + + +Fielding, et al. Standards Track [Page 34] + +RFC 2616 HTTP/1.1 June 1999 + + + message being transmitted. + + general-header = Cache-Control ; Section 14.9 + | Connection ; Section 14.10 + | Date ; Section 14.18 + | Pragma ; Section 14.32 + | Trailer ; Section 14.40 + | Transfer-Encoding ; Section 14.41 + | Upgrade ; Section 14.42 + | Via ; Section 14.45 + | Warning ; Section 14.46 + + General-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields may be given the semantics of general + header fields if all parties in the communication recognize them to + be general-header fields. Unrecognized header fields are treated as + entity-header fields. + +5 Request + + A request message from a client to a server includes, within the + first line of that message, the method to be applied to the resource, + the identifier of the resource, and the protocol version in use. + + Request = Request-Line ; Section 5.1 + *(( general-header ; Section 4.5 + | request-header ; Section 5.3 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 4.3 + +5.1 Request-Line + + The Request-Line begins with a method token, followed by the + Request-URI and the protocol version, and ending with CRLF. The + elements are separated by SP characters. No CR or LF is allowed + except in the final CRLF sequence. + + Request-Line = Method SP Request-URI SP HTTP-Version CRLF + + + + + + + + + + + +Fielding, et al. Standards Track [Page 35] + +RFC 2616 HTTP/1.1 June 1999 + + +5.1.1 Method + + The Method token indicates the method to be performed on the + resource identified by the Request-URI. The method is case-sensitive. + + Method = "OPTIONS" ; Section 9.2 + | "GET" ; Section 9.3 + | "HEAD" ; Section 9.4 + | "POST" ; Section 9.5 + | "PUT" ; Section 9.6 + | "DELETE" ; Section 9.7 + | "TRACE" ; Section 9.8 + | "CONNECT" ; Section 9.9 + | extension-method + extension-method = token + + The list of methods allowed by a resource can be specified in an + Allow header field (section 14.7). The return code of the response + always notifies the client whether a method is currently allowed on a + resource, since the set of allowed methods can change dynamically. An + origin server SHOULD return the status code 405 (Method Not Allowed) + if the method is known by the origin server but not allowed for the + requested resource, and 501 (Not Implemented) if the method is + unrecognized or not implemented by the origin server. The methods GET + and HEAD MUST be supported by all general-purpose servers. All other + methods are OPTIONAL; however, if the above methods are implemented, + they MUST be implemented with the same semantics as those specified + in section 9. + +5.1.2 Request-URI + + The Request-URI is a Uniform Resource Identifier (section 3.2) and + identifies the resource upon which to apply the request. + + Request-URI = "*" | absoluteURI | abs_path | authority + + The four options for Request-URI are dependent on the nature of the + request. The asterisk "*" means that the request does not apply to a + particular resource, but to the server itself, and is only allowed + when the method used does not necessarily apply to a resource. One + example would be + + OPTIONS * HTTP/1.1 + + The absoluteURI form is REQUIRED when the request is being made to a + proxy. The proxy is requested to forward the request or service it + from a valid cache, and return the response. Note that the proxy MAY + forward the request on to another proxy or directly to the server + + + +Fielding, et al. Standards Track [Page 36] + +RFC 2616 HTTP/1.1 June 1999 + + + specified by the absoluteURI. In order to avoid request loops, a + proxy MUST be able to recognize all of its server names, including + any aliases, local variations, and the numeric IP address. An example + Request-Line would be: + + GET http://www.w3.org/pub/WWW/TheProject.html HTTP/1.1 + + To allow for transition to absoluteURIs in all requests in future + versions of HTTP, all HTTP/1.1 servers MUST accept the absoluteURI + form in requests, even though HTTP/1.1 clients will only generate + them in requests to proxies. + + The authority form is only used by the CONNECT method (section 9.9). + + The most common form of Request-URI is that used to identify a + resource on an origin server or gateway. In this case the absolute + path of the URI MUST be transmitted (see section 3.2.1, abs_path) as + the Request-URI, and the network location of the URI (authority) MUST + be transmitted in a Host header field. For example, a client wishing + to retrieve the resource above directly from the origin server would + create a TCP connection to port 80 of the host "www.w3.org" and send + the lines: + + GET /pub/WWW/TheProject.html HTTP/1.1 + Host: www.w3.org + + followed by the remainder of the Request. Note that the absolute path + cannot be empty; if none is present in the original URI, it MUST be + given as "/" (the server root). + + The Request-URI is transmitted in the format specified in section + 3.2.1. If the Request-URI is encoded using the "% HEX HEX" encoding + [42], the origin server MUST decode the Request-URI in order to + properly interpret the request. Servers SHOULD respond to invalid + Request-URIs with an appropriate status code. + + A transparent proxy MUST NOT rewrite the "abs_path" part of the + received Request-URI when forwarding it to the next inbound server, + except as noted above to replace a null abs_path with "/". + + Note: The "no rewrite" rule prevents the proxy from changing the + meaning of the request when the origin server is improperly using + a non-reserved URI character for a reserved purpose. Implementors + should be aware that some pre-HTTP/1.1 proxies have been known to + rewrite the Request-URI. + + + + + + +Fielding, et al. Standards Track [Page 37] + +RFC 2616 HTTP/1.1 June 1999 + + +5.2 The Resource Identified by a Request + + The exact resource identified by an Internet request is determined by + examining both the Request-URI and the Host header field. + + An origin server that does not allow resources to differ by the + requested host MAY ignore the Host header field value when + determining the resource identified by an HTTP/1.1 request. (But see + section 19.6.1.1 for other requirements on Host support in HTTP/1.1.) + + An origin server that does differentiate resources based on the host + requested (sometimes referred to as virtual hosts or vanity host + names) MUST use the following rules for determining the requested + resource on an HTTP/1.1 request: + + 1. If Request-URI is an absoluteURI, the host is part of the + Request-URI. Any Host header field value in the request MUST be + ignored. + + 2. If the Request-URI is not an absoluteURI, and the request includes + a Host header field, the host is determined by the Host header + field value. + + 3. If the host as determined by rule 1 or 2 is not a valid host on + the server, the response MUST be a 400 (Bad Request) error message. + + Recipients of an HTTP/1.0 request that lacks a Host header field MAY + attempt to use heuristics (e.g., examination of the URI path for + something unique to a particular host) in order to determine what + exact resource is being requested. + +5.3 Request Header Fields + + The request-header fields allow the client to pass additional + information about the request, and about the client itself, to the + server. These fields act as request modifiers, with semantics + equivalent to the parameters on a programming language method + invocation. + + request-header = Accept ; Section 14.1 + | Accept-Charset ; Section 14.2 + | Accept-Encoding ; Section 14.3 + | Accept-Language ; Section 14.4 + | Authorization ; Section 14.8 + | Expect ; Section 14.20 + | From ; Section 14.22 + | Host ; Section 14.23 + | If-Match ; Section 14.24 + + + +Fielding, et al. Standards Track [Page 38] + +RFC 2616 HTTP/1.1 June 1999 + + + | If-Modified-Since ; Section 14.25 + | If-None-Match ; Section 14.26 + | If-Range ; Section 14.27 + | If-Unmodified-Since ; Section 14.28 + | Max-Forwards ; Section 14.31 + | Proxy-Authorization ; Section 14.34 + | Range ; Section 14.35 + | Referer ; Section 14.36 + | TE ; Section 14.39 + | User-Agent ; Section 14.43 + + Request-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of request- + header fields if all parties in the communication recognize them to + be request-header fields. Unrecognized header fields are treated as + entity-header fields. + +6 Response + + After receiving and interpreting a request message, a server responds + with an HTTP response message. + + Response = Status-Line ; Section 6.1 + *(( general-header ; Section 4.5 + | response-header ; Section 6.2 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 7.2 + +6.1 Status-Line + + The first line of a Response message is the Status-Line, consisting + of the protocol version followed by a numeric status code and its + associated textual phrase, with each element separated by SP + characters. No CR or LF is allowed except in the final CRLF sequence. + + Status-Line = HTTP-Version SP Status-Code SP Reason-Phrase CRLF + +6.1.1 Status Code and Reason Phrase + + The Status-Code element is a 3-digit integer result code of the + attempt to understand and satisfy the request. These codes are fully + defined in section 10. The Reason-Phrase is intended to give a short + textual description of the Status-Code. The Status-Code is intended + for use by automata and the Reason-Phrase is intended for the human + user. The client is not required to examine or display the Reason- + Phrase. + + + +Fielding, et al. Standards Track [Page 39] + +RFC 2616 HTTP/1.1 June 1999 + + + The first digit of the Status-Code defines the class of response. The + last two digits do not have any categorization role. There are 5 + values for the first digit: + + - 1xx: Informational - Request received, continuing process + + - 2xx: Success - The action was successfully received, + understood, and accepted + + - 3xx: Redirection - Further action must be taken in order to + complete the request + + - 4xx: Client Error - The request contains bad syntax or cannot + be fulfilled + + - 5xx: Server Error - The server failed to fulfill an apparently + valid request + + The individual values of the numeric status codes defined for + HTTP/1.1, and an example set of corresponding Reason-Phrase's, are + presented below. The reason phrases listed here are only + recommendations -- they MAY be replaced by local equivalents without + affecting the protocol. + + Status-Code = + "100" ; Section 10.1.1: Continue + | "101" ; Section 10.1.2: Switching Protocols + | "200" ; Section 10.2.1: OK + | "201" ; Section 10.2.2: Created + | "202" ; Section 10.2.3: Accepted + | "203" ; Section 10.2.4: Non-Authoritative Information + | "204" ; Section 10.2.5: No Content + | "205" ; Section 10.2.6: Reset Content + | "206" ; Section 10.2.7: Partial Content + | "300" ; Section 10.3.1: Multiple Choices + | "301" ; Section 10.3.2: Moved Permanently + | "302" ; Section 10.3.3: Found + | "303" ; Section 10.3.4: See Other + | "304" ; Section 10.3.5: Not Modified + | "305" ; Section 10.3.6: Use Proxy + | "307" ; Section 10.3.8: Temporary Redirect + | "400" ; Section 10.4.1: Bad Request + | "401" ; Section 10.4.2: Unauthorized + | "402" ; Section 10.4.3: Payment Required + | "403" ; Section 10.4.4: Forbidden + | "404" ; Section 10.4.5: Not Found + | "405" ; Section 10.4.6: Method Not Allowed + | "406" ; Section 10.4.7: Not Acceptable + + + +Fielding, et al. Standards Track [Page 40] + +RFC 2616 HTTP/1.1 June 1999 + + + | "407" ; Section 10.4.8: Proxy Authentication Required + | "408" ; Section 10.4.9: Request Time-out + | "409" ; Section 10.4.10: Conflict + | "410" ; Section 10.4.11: Gone + | "411" ; Section 10.4.12: Length Required + | "412" ; Section 10.4.13: Precondition Failed + | "413" ; Section 10.4.14: Request Entity Too Large + | "414" ; Section 10.4.15: Request-URI Too Large + | "415" ; Section 10.4.16: Unsupported Media Type + | "416" ; Section 10.4.17: Requested range not satisfiable + | "417" ; Section 10.4.18: Expectation Failed + | "500" ; Section 10.5.1: Internal Server Error + | "501" ; Section 10.5.2: Not Implemented + | "502" ; Section 10.5.3: Bad Gateway + | "503" ; Section 10.5.4: Service Unavailable + | "504" ; Section 10.5.5: Gateway Time-out + | "505" ; Section 10.5.6: HTTP Version not supported + | extension-code + + extension-code = 3DIGIT + Reason-Phrase = * + + HTTP status codes are extensible. HTTP applications are not required + to understand the meaning of all registered status codes, though such + understanding is obviously desirable. However, applications MUST + understand the class of any status code, as indicated by the first + digit, and treat any unrecognized response as being equivalent to the + x00 status code of that class, with the exception that an + unrecognized response MUST NOT be cached. For example, if an + unrecognized status code of 431 is received by the client, it can + safely assume that there was something wrong with its request and + treat the response as if it had received a 400 status code. In such + cases, user agents SHOULD present to the user the entity returned + with the response, since that entity is likely to include human- + readable information which will explain the unusual status. + +6.2 Response Header Fields + + The response-header fields allow the server to pass additional + information about the response which cannot be placed in the Status- + Line. These header fields give information about the server and about + further access to the resource identified by the Request-URI. + + response-header = Accept-Ranges ; Section 14.5 + | Age ; Section 14.6 + | ETag ; Section 14.19 + | Location ; Section 14.30 + | Proxy-Authenticate ; Section 14.33 + + + +Fielding, et al. Standards Track [Page 41] + +RFC 2616 HTTP/1.1 June 1999 + + + | Retry-After ; Section 14.37 + | Server ; Section 14.38 + | Vary ; Section 14.44 + | WWW-Authenticate ; Section 14.47 + + Response-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of response- + header fields if all parties in the communication recognize them to + be response-header fields. Unrecognized header fields are treated as + entity-header fields. + +7 Entity + + Request and Response messages MAY transfer an entity if not otherwise + restricted by the request method or response status code. An entity + consists of entity-header fields and an entity-body, although some + responses will only include the entity-headers. + + In this section, both sender and recipient refer to either the client + or the server, depending on who sends and who receives the entity. + +7.1 Entity Header Fields + + Entity-header fields define metainformation about the entity-body or, + if no body is present, about the resource identified by the request. + Some of this metainformation is OPTIONAL; some might be REQUIRED by + portions of this specification. + + entity-header = Allow ; Section 14.7 + | Content-Encoding ; Section 14.11 + | Content-Language ; Section 14.12 + | Content-Length ; Section 14.13 + | Content-Location ; Section 14.14 + | Content-MD5 ; Section 14.15 + | Content-Range ; Section 14.16 + | Content-Type ; Section 14.17 + | Expires ; Section 14.21 + | Last-Modified ; Section 14.29 + | extension-header + + extension-header = message-header + + The extension-header mechanism allows additional entity-header fields + to be defined without changing the protocol, but these fields cannot + be assumed to be recognizable by the recipient. Unrecognized header + fields SHOULD be ignored by the recipient and MUST be forwarded by + transparent proxies. + + + +Fielding, et al. Standards Track [Page 42] + +RFC 2616 HTTP/1.1 June 1999 + + +7.2 Entity Body + + The entity-body (if any) sent with an HTTP request or response is in + a format and encoding defined by the entity-header fields. + + entity-body = *OCTET + + An entity-body is only present in a message when a message-body is + present, as described in section 4.3. The entity-body is obtained + from the message-body by decoding any Transfer-Encoding that might + have been applied to ensure safe and proper transfer of the message. + +7.2.1 Type + + When an entity-body is included with a message, the data type of that + body is determined via the header fields Content-Type and Content- + Encoding. These define a two-layer, ordered encoding model: + + entity-body := Content-Encoding( Content-Type( data ) ) + + Content-Type specifies the media type of the underlying data. + Content-Encoding may be used to indicate any additional content + codings applied to the data, usually for the purpose of data + compression, that are a property of the requested resource. There is + no default encoding. + + Any HTTP/1.1 message containing an entity-body SHOULD include a + Content-Type header field defining the media type of that body. If + and only if the media type is not given by a Content-Type field, the + recipient MAY attempt to guess the media type via inspection of its + content and/or the name extension(s) of the URI used to identify the + resource. If the media type remains unknown, the recipient SHOULD + treat it as type "application/octet-stream". + +7.2.2 Entity Length + + The entity-length of a message is the length of the message-body + before any transfer-codings have been applied. Section 4.4 defines + how the transfer-length of a message-body is determined. + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 43] + +RFC 2616 HTTP/1.1 June 1999 + + +8 Connections + +8.1 Persistent Connections + +8.1.1 Purpose + + Prior to persistent connections, a separate TCP connection was + established to fetch each URL, increasing the load on HTTP servers + and causing congestion on the Internet. The use of inline images and + other associated data often require a client to make multiple + requests of the same server in a short amount of time. Analysis of + these performance problems and results from a prototype + implementation are available [26] [30]. Implementation experience and + measurements of actual HTTP/1.1 (RFC 2068) implementations show good + results [39]. Alternatives have also been explored, for example, + T/TCP [27]. + + Persistent HTTP connections have a number of advantages: + + - By opening and closing fewer TCP connections, CPU time is saved + in routers and hosts (clients, servers, proxies, gateways, + tunnels, or caches), and memory used for TCP protocol control + blocks can be saved in hosts. + + - HTTP requests and responses can be pipelined on a connection. + Pipelining allows a client to make multiple requests without + waiting for each response, allowing a single TCP connection to + be used much more efficiently, with much lower elapsed time. + + - Network congestion is reduced by reducing the number of packets + caused by TCP opens, and by allowing TCP sufficient time to + determine the congestion state of the network. + + - Latency on subsequent requests is reduced since there is no time + spent in TCP's connection opening handshake. + + - HTTP can evolve more gracefully, since errors can be reported + without the penalty of closing the TCP connection. Clients using + future versions of HTTP might optimistically try a new feature, + but if communicating with an older server, retry with old + semantics after an error is reported. + + HTTP implementations SHOULD implement persistent connections. + + + + + + + + +Fielding, et al. Standards Track [Page 44] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2 Overall Operation + + A significant difference between HTTP/1.1 and earlier versions of + HTTP is that persistent connections are the default behavior of any + HTTP connection. That is, unless otherwise indicated, the client + SHOULD assume that the server will maintain a persistent connection, + even after error responses from the server. + + Persistent connections provide a mechanism by which a client and a + server can signal the close of a TCP connection. This signaling takes + place using the Connection header field (section 14.10). Once a close + has been signaled, the client MUST NOT send any more requests on that + connection. + +8.1.2.1 Negotiation + + An HTTP/1.1 server MAY assume that a HTTP/1.1 client intends to + maintain a persistent connection unless a Connection header including + the connection-token "close" was sent in the request. If the server + chooses to close the connection immediately after sending the + response, it SHOULD send a Connection header including the + connection-token close. + + An HTTP/1.1 client MAY expect a connection to remain open, but would + decide to keep it open based on whether the response from a server + contains a Connection header with the connection-token close. In case + the client does not want to maintain a connection for more than that + request, it SHOULD send a Connection header including the + connection-token close. + + If either the client or the server sends the close token in the + Connection header, that request becomes the last one for the + connection. + + Clients and servers SHOULD NOT assume that a persistent connection is + maintained for HTTP versions less than 1.1 unless it is explicitly + signaled. See section 19.6.2 for more information on backward + compatibility with HTTP/1.0 clients. + + In order to remain persistent, all messages on the connection MUST + have a self-defined message length (i.e., one not defined by closure + of the connection), as described in section 4.4. + + + + + + + + + +Fielding, et al. Standards Track [Page 45] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2.2 Pipelining + + A client that supports persistent connections MAY "pipeline" its + requests (i.e., send multiple requests without waiting for each + response). A server MUST send its responses to those requests in the + same order that the requests were received. + + Clients which assume persistent connections and pipeline immediately + after connection establishment SHOULD be prepared to retry their + connection if the first pipelined attempt fails. If a client does + such a retry, it MUST NOT pipeline before it knows the connection is + persistent. Clients MUST also be prepared to resend their requests if + the server closes the connection before sending all of the + corresponding responses. + + Clients SHOULD NOT pipeline requests using non-idempotent methods or + non-idempotent sequences of methods (see section 9.1.2). Otherwise, a + premature termination of the transport connection could lead to + indeterminate results. A client wishing to send a non-idempotent + request SHOULD wait to send that request until it has received the + response status for the previous request. + +8.1.3 Proxy Servers + + It is especially important that proxies correctly implement the + properties of the Connection header field as specified in section + 14.10. + + The proxy server MUST signal persistent connections separately with + its clients and the origin servers (or other proxy servers) that it + connects to. Each persistent connection applies to only one transport + link. + + A proxy server MUST NOT establish a HTTP/1.1 persistent connection + with an HTTP/1.0 client (but see RFC 2068 [33] for information and + discussion of the problems with the Keep-Alive header implemented by + many HTTP/1.0 clients). + +8.1.4 Practical Considerations + + Servers will usually have some time-out value beyond which they will + no longer maintain an inactive connection. Proxy servers might make + this a higher value since it is likely that the client will be making + more connections through the same server. The use of persistent + connections places no requirements on the length (or existence) of + this time-out for either the client or the server. + + + + + +Fielding, et al. Standards Track [Page 46] + +RFC 2616 HTTP/1.1 June 1999 + + + When a client or server wishes to time-out it SHOULD issue a graceful + close on the transport connection. Clients and servers SHOULD both + constantly watch for the other side of the transport close, and + respond to it as appropriate. If a client or server does not detect + the other side's close promptly it could cause unnecessary resource + drain on the network. + + A client, server, or proxy MAY close the transport connection at any + time. For example, a client might have started to send a new request + at the same time that the server has decided to close the "idle" + connection. From the server's point of view, the connection is being + closed while it was idle, but from the client's point of view, a + request is in progress. + + This means that clients, servers, and proxies MUST be able to recover + from asynchronous close events. Client software SHOULD reopen the + transport connection and retransmit the aborted sequence of requests + without user interaction so long as the request sequence is + idempotent (see section 9.1.2). Non-idempotent methods or sequences + MUST NOT be automatically retried, although user agents MAY offer a + human operator the choice of retrying the request(s). Confirmation by + user-agent software with semantic understanding of the application + MAY substitute for user confirmation. The automatic retry SHOULD NOT + be repeated if the second sequence of requests fails. + + Servers SHOULD always respond to at least one request per connection, + if at all possible. Servers SHOULD NOT close a connection in the + middle of transmitting a response, unless a network or client failure + is suspected. + + Clients that use persistent connections SHOULD limit the number of + simultaneous connections that they maintain to a given server. A + single-user client SHOULD NOT maintain more than 2 connections with + any server or proxy. A proxy SHOULD use up to 2*N connections to + another server or proxy, where N is the number of simultaneously + active users. These guidelines are intended to improve HTTP response + times and avoid congestion. + +8.2 Message Transmission Requirements + +8.2.1 Persistent Connections and Flow Control + + HTTP/1.1 servers SHOULD maintain persistent connections and use TCP's + flow control mechanisms to resolve temporary overloads, rather than + terminating connections with the expectation that clients will retry. + The latter technique can exacerbate network congestion. + + + + + +Fielding, et al. Standards Track [Page 47] + +RFC 2616 HTTP/1.1 June 1999 + + +8.2.2 Monitoring Connections for Error Status Messages + + An HTTP/1.1 (or later) client sending a message-body SHOULD monitor + the network connection for an error status while it is transmitting + the request. If the client sees an error status, it SHOULD + immediately cease transmitting the body. If the body is being sent + using a "chunked" encoding (section 3.6), a zero length chunk and + empty trailer MAY be used to prematurely mark the end of the message. + If the body was preceded by a Content-Length header, the client MUST + close the connection. + +8.2.3 Use of the 100 (Continue) Status + + The purpose of the 100 (Continue) status (see section 10.1.1) is to + allow a client that is sending a request message with a request body + to determine if the origin server is willing to accept the request + (based on the request headers) before the client sends the request + body. In some cases, it might either be inappropriate or highly + inefficient for the client to send the body if the server will reject + the message without looking at the body. + + Requirements for HTTP/1.1 clients: + + - If a client will wait for a 100 (Continue) response before + sending the request body, it MUST send an Expect request-header + field (section 14.20) with the "100-continue" expectation. + + - A client MUST NOT send an Expect request-header field (section + 14.20) with the "100-continue" expectation if it does not intend + to send a request body. + + Because of the presence of older implementations, the protocol allows + ambiguous situations in which a client may send "Expect: 100- + continue" without receiving either a 417 (Expectation Failed) status + or a 100 (Continue) status. Therefore, when a client sends this + header field to an origin server (possibly via a proxy) from which it + has never seen a 100 (Continue) status, the client SHOULD NOT wait + for an indefinite period before sending the request body. + + Requirements for HTTP/1.1 origin servers: + + - Upon receiving a request which includes an Expect request-header + field with the "100-continue" expectation, an origin server MUST + either respond with 100 (Continue) status and continue to read + from the input stream, or respond with a final status code. The + origin server MUST NOT wait for the request body before sending + the 100 (Continue) response. If it responds with a final status + code, it MAY close the transport connection or it MAY continue + + + +Fielding, et al. Standards Track [Page 48] + +RFC 2616 HTTP/1.1 June 1999 + + + to read and discard the rest of the request. It MUST NOT + perform the requested method if it returns a final status code. + + - An origin server SHOULD NOT send a 100 (Continue) response if + the request message does not include an Expect request-header + field with the "100-continue" expectation, and MUST NOT send a + 100 (Continue) response if such a request comes from an HTTP/1.0 + (or earlier) client. There is an exception to this rule: for + compatibility with RFC 2068, a server MAY send a 100 (Continue) + status in response to an HTTP/1.1 PUT or POST request that does + not include an Expect request-header field with the "100- + continue" expectation. This exception, the purpose of which is + to minimize any client processing delays associated with an + undeclared wait for 100 (Continue) status, applies only to + HTTP/1.1 requests, and not to requests with any other HTTP- + version value. + + - An origin server MAY omit a 100 (Continue) response if it has + already received some or all of the request body for the + corresponding request. + + - An origin server that sends a 100 (Continue) response MUST + ultimately send a final status code, once the request body is + received and processed, unless it terminates the transport + connection prematurely. + + - If an origin server receives a request that does not include an + Expect request-header field with the "100-continue" expectation, + the request includes a request body, and the server responds + with a final status code before reading the entire request body + from the transport connection, then the server SHOULD NOT close + the transport connection until it has read the entire request, + or until the client closes the connection. Otherwise, the client + might not reliably receive the response message. However, this + requirement is not be construed as preventing a server from + defending itself against denial-of-service attacks, or from + badly broken client implementations. + + Requirements for HTTP/1.1 proxies: + + - If a proxy receives a request that includes an Expect request- + header field with the "100-continue" expectation, and the proxy + either knows that the next-hop server complies with HTTP/1.1 or + higher, or does not know the HTTP version of the next-hop + server, it MUST forward the request, including the Expect header + field. + + + + + +Fielding, et al. Standards Track [Page 49] + +RFC 2616 HTTP/1.1 June 1999 + + + - If the proxy knows that the version of the next-hop server is + HTTP/1.0 or lower, it MUST NOT forward the request, and it MUST + respond with a 417 (Expectation Failed) status. + + - Proxies SHOULD maintain a cache recording the HTTP version + numbers received from recently-referenced next-hop servers. + + - A proxy MUST NOT forward a 100 (Continue) response if the + request message was received from an HTTP/1.0 (or earlier) + client and did not include an Expect request-header field with + the "100-continue" expectation. This requirement overrides the + general rule for forwarding of 1xx responses (see section 10.1). + +8.2.4 Client Behavior if Server Prematurely Closes Connection + + If an HTTP/1.1 client sends a request which includes a request body, + but which does not include an Expect request-header field with the + "100-continue" expectation, and if the client is not directly + connected to an HTTP/1.1 origin server, and if the client sees the + connection close before receiving any status from the server, the + client SHOULD retry the request. If the client does retry this + request, it MAY use the following "binary exponential backoff" + algorithm to be assured of obtaining a reliable response: + + 1. Initiate a new connection to the server + + 2. Transmit the request-headers + + 3. Initialize a variable R to the estimated round-trip time to the + server (e.g., based on the time it took to establish the + connection), or to a constant value of 5 seconds if the round- + trip time is not available. + + 4. Compute T = R * (2**N), where N is the number of previous + retries of this request. + + 5. Wait either for an error response from the server, or for T + seconds (whichever comes first) + + 6. If no error response is received, after T seconds transmit the + body of the request. + + 7. If client sees that the connection is closed prematurely, + repeat from step 1 until the request is accepted, an error + response is received, or the user becomes impatient and + terminates the retry process. + + + + + +Fielding, et al. Standards Track [Page 50] + +RFC 2616 HTTP/1.1 June 1999 + + + If at any point an error status is received, the client + + - SHOULD NOT continue and + + - SHOULD close the connection if it has not completed sending the + request message. + +9 Method Definitions + + The set of common methods for HTTP/1.1 is defined below. Although + this set can be expanded, additional methods cannot be assumed to + share the same semantics for separately extended clients and servers. + + The Host request-header field (section 14.23) MUST accompany all + HTTP/1.1 requests. + +9.1 Safe and Idempotent Methods + +9.1.1 Safe Methods + + Implementors should be aware that the software represents the user in + their interactions over the Internet, and should be careful to allow + the user to be aware of any actions they might take which may have an + unexpected significance to themselves or others. + + In particular, the convention has been established that the GET and + HEAD methods SHOULD NOT have the significance of taking an action + other than retrieval. These methods ought to be considered "safe". + This allows user agents to represent other methods, such as POST, PUT + and DELETE, in a special way, so that the user is made aware of the + fact that a possibly unsafe action is being requested. + + Naturally, it is not possible to ensure that the server does not + generate side-effects as a result of performing a GET request; in + fact, some dynamic resources consider that a feature. The important + distinction here is that the user did not request the side-effects, + so therefore cannot be held accountable for them. + +9.1.2 Idempotent Methods + + Methods can also have the property of "idempotence" in that (aside + from error or expiration issues) the side-effects of N > 0 identical + requests is the same as for a single request. The methods GET, HEAD, + PUT and DELETE share this property. Also, the methods OPTIONS and + TRACE SHOULD NOT have side effects, and so are inherently idempotent. + + + + + + +Fielding, et al. Standards Track [Page 51] + +RFC 2616 HTTP/1.1 June 1999 + + + However, it is possible that a sequence of several requests is non- + idempotent, even if all of the methods executed in that sequence are + idempotent. (A sequence is idempotent if a single execution of the + entire sequence always yields a result that is not changed by a + reexecution of all, or part, of that sequence.) For example, a + sequence is non-idempotent if its result depends on a value that is + later modified in the same sequence. + + A sequence that never has side effects is idempotent, by definition + (provided that no concurrent operations are being executed on the + same set of resources). + +9.2 OPTIONS + + The OPTIONS method represents a request for information about the + communication options available on the request/response chain + identified by the Request-URI. This method allows the client to + determine the options and/or requirements associated with a resource, + or the capabilities of a server, without implying a resource action + or initiating a resource retrieval. + + Responses to this method are not cacheable. + + If the OPTIONS request includes an entity-body (as indicated by the + presence of Content-Length or Transfer-Encoding), then the media type + MUST be indicated by a Content-Type field. Although this + specification does not define any use for such a body, future + extensions to HTTP might use the OPTIONS body to make more detailed + queries on the server. A server that does not support such an + extension MAY discard the request body. + + If the Request-URI is an asterisk ("*"), the OPTIONS request is + intended to apply to the server in general rather than to a specific + resource. Since a server's communication options typically depend on + the resource, the "*" request is only useful as a "ping" or "no-op" + type of method; it does nothing beyond allowing the client to test + the capabilities of the server. For example, this can be used to test + a proxy for HTTP/1.1 compliance (or lack thereof). + + If the Request-URI is not an asterisk, the OPTIONS request applies + only to the options that are available when communicating with that + resource. + + A 200 response SHOULD include any header fields that indicate + optional features implemented by the server and applicable to that + resource (e.g., Allow), possibly including extensions not defined by + this specification. The response body, if any, SHOULD also include + information about the communication options. The format for such a + + + +Fielding, et al. Standards Track [Page 52] + +RFC 2616 HTTP/1.1 June 1999 + + + body is not defined by this specification, but might be defined by + future extensions to HTTP. Content negotiation MAY be used to select + the appropriate response format. If no response body is included, the + response MUST include a Content-Length field with a field-value of + "0". + + The Max-Forwards request-header field MAY be used to target a + specific proxy in the request chain. When a proxy receives an OPTIONS + request on an absoluteURI for which request forwarding is permitted, + the proxy MUST check for a Max-Forwards field. If the Max-Forwards + field-value is zero ("0"), the proxy MUST NOT forward the message; + instead, the proxy SHOULD respond with its own communication options. + If the Max-Forwards field-value is an integer greater than zero, the + proxy MUST decrement the field-value when it forwards the request. If + no Max-Forwards field is present in the request, then the forwarded + request MUST NOT include a Max-Forwards field. + +9.3 GET + + The GET method means retrieve whatever information (in the form of an + entity) is identified by the Request-URI. If the Request-URI refers + to a data-producing process, it is the produced data which shall be + returned as the entity in the response and not the source text of the + process, unless that text happens to be the output of the process. + + The semantics of the GET method change to a "conditional GET" if the + request message includes an If-Modified-Since, If-Unmodified-Since, + If-Match, If-None-Match, or If-Range header field. A conditional GET + method requests that the entity be transferred only under the + circumstances described by the conditional header field(s). The + conditional GET method is intended to reduce unnecessary network + usage by allowing cached entities to be refreshed without requiring + multiple requests or transferring data already held by the client. + + The semantics of the GET method change to a "partial GET" if the + request message includes a Range header field. A partial GET requests + that only part of the entity be transferred, as described in section + 14.35. The partial GET method is intended to reduce unnecessary + network usage by allowing partially-retrieved entities to be + completed without transferring data already held by the client. + + The response to a GET request is cacheable if and only if it meets + the requirements for HTTP caching described in section 13. + + See section 15.1.3 for security considerations when used for forms. + + + + + + +Fielding, et al. Standards Track [Page 53] + +RFC 2616 HTTP/1.1 June 1999 + + +9.4 HEAD + + The HEAD method is identical to GET except that the server MUST NOT + return a message-body in the response. The metainformation contained + in the HTTP headers in response to a HEAD request SHOULD be identical + to the information sent in response to a GET request. This method can + be used for obtaining metainformation about the entity implied by the + request without transferring the entity-body itself. This method is + often used for testing hypertext links for validity, accessibility, + and recent modification. + + The response to a HEAD request MAY be cacheable in the sense that the + information contained in the response MAY be used to update a + previously cached entity from that resource. If the new field values + indicate that the cached entity differs from the current entity (as + would be indicated by a change in Content-Length, Content-MD5, ETag + or Last-Modified), then the cache MUST treat the cache entry as + stale. + +9.5 POST + + The POST method is used to request that the origin server accept the + entity enclosed in the request as a new subordinate of the resource + identified by the Request-URI in the Request-Line. POST is designed + to allow a uniform method to cover the following functions: + + - Annotation of existing resources; + + - Posting a message to a bulletin board, newsgroup, mailing list, + or similar group of articles; + + - Providing a block of data, such as the result of submitting a + form, to a data-handling process; + + - Extending a database through an append operation. + + The actual function performed by the POST method is determined by the + server and is usually dependent on the Request-URI. The posted entity + is subordinate to that URI in the same way that a file is subordinate + to a directory containing it, a news article is subordinate to a + newsgroup to which it is posted, or a record is subordinate to a + database. + + The action performed by the POST method might not result in a + resource that can be identified by a URI. In this case, either 200 + (OK) or 204 (No Content) is the appropriate response status, + depending on whether or not the response includes an entity that + describes the result. + + + +Fielding, et al. Standards Track [Page 54] + +RFC 2616 HTTP/1.1 June 1999 + + + If a resource has been created on the origin server, the response + SHOULD be 201 (Created) and contain an entity which describes the + status of the request and refers to the new resource, and a Location + header (see section 14.30). + + Responses to this method are not cacheable, unless the response + includes appropriate Cache-Control or Expires header fields. However, + the 303 (See Other) response can be used to direct the user agent to + retrieve a cacheable resource. + + POST requests MUST obey the message transmission requirements set out + in section 8.2. + + See section 15.1.3 for security considerations. + +9.6 PUT + + The PUT method requests that the enclosed entity be stored under the + supplied Request-URI. If the Request-URI refers to an already + existing resource, the enclosed entity SHOULD be considered as a + modified version of the one residing on the origin server. If the + Request-URI does not point to an existing resource, and that URI is + capable of being defined as a new resource by the requesting user + agent, the origin server can create the resource with that URI. If a + new resource is created, the origin server MUST inform the user agent + via the 201 (Created) response. If an existing resource is modified, + either the 200 (OK) or 204 (No Content) response codes SHOULD be sent + to indicate successful completion of the request. If the resource + could not be created or modified with the Request-URI, an appropriate + error response SHOULD be given that reflects the nature of the + problem. The recipient of the entity MUST NOT ignore any Content-* + (e.g. Content-Range) headers that it does not understand or implement + and MUST return a 501 (Not Implemented) response in such cases. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + + The fundamental difference between the POST and PUT requests is + reflected in the different meaning of the Request-URI. The URI in a + POST request identifies the resource that will handle the enclosed + entity. That resource might be a data-accepting process, a gateway to + some other protocol, or a separate entity that accepts annotations. + In contrast, the URI in a PUT request identifies the entity enclosed + with the request -- the user agent knows what URI is intended and the + server MUST NOT attempt to apply the request to some other resource. + If the server desires that the request be applied to a different URI, + + + + +Fielding, et al. Standards Track [Page 55] + +RFC 2616 HTTP/1.1 June 1999 + + + it MUST send a 301 (Moved Permanently) response; the user agent MAY + then make its own decision regarding whether or not to redirect the + request. + + A single resource MAY be identified by many different URIs. For + example, an article might have a URI for identifying "the current + version" which is separate from the URI identifying each particular + version. In this case, a PUT request on a general URI might result in + several other URIs being defined by the origin server. + + HTTP/1.1 does not define how a PUT method affects the state of an + origin server. + + PUT requests MUST obey the message transmission requirements set out + in section 8.2. + + Unless otherwise specified for a particular entity-header, the + entity-headers in the PUT request SHOULD be applied to the resource + created or modified by the PUT. + +9.7 DELETE + + The DELETE method requests that the origin server delete the resource + identified by the Request-URI. This method MAY be overridden by human + intervention (or other means) on the origin server. The client cannot + be guaranteed that the operation has been carried out, even if the + status code returned from the origin server indicates that the action + has been completed successfully. However, the server SHOULD NOT + indicate success unless, at the time the response is given, it + intends to delete the resource or move it to an inaccessible + location. + + A successful response SHOULD be 200 (OK) if the response includes an + entity describing the status, 202 (Accepted) if the action has not + yet been enacted, or 204 (No Content) if the action has been enacted + but the response does not include an entity. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + +9.8 TRACE + + The TRACE method is used to invoke a remote, application-layer loop- + back of the request message. The final recipient of the request + SHOULD reflect the message received back to the client as the + entity-body of a 200 (OK) response. The final recipient is either the + + + + +Fielding, et al. Standards Track [Page 56] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server or the first proxy or gateway to receive a Max-Forwards + value of zero (0) in the request (see section 14.31). A TRACE request + MUST NOT include an entity. + + TRACE allows the client to see what is being received at the other + end of the request chain and use that data for testing or diagnostic + information. The value of the Via header field (section 14.45) is of + particular interest, since it acts as a trace of the request chain. + Use of the Max-Forwards header field allows the client to limit the + length of the request chain, which is useful for testing a chain of + proxies forwarding messages in an infinite loop. + + If the request is valid, the response SHOULD contain the entire + request message in the entity-body, with a Content-Type of + "message/http". Responses to this method MUST NOT be cached. + +9.9 CONNECT + + This specification reserves the method name CONNECT for use with a + proxy that can dynamically switch to being a tunnel (e.g. SSL + tunneling [44]). + +10 Status Code Definitions + + Each Status-Code is described below, including a description of which + method(s) it can follow and any metainformation required in the + response. + +10.1 Informational 1xx + + This class of status code indicates a provisional response, + consisting only of the Status-Line and optional headers, and is + terminated by an empty line. There are no required headers for this + class of status code. Since HTTP/1.0 did not define any 1xx status + codes, servers MUST NOT send a 1xx response to an HTTP/1.0 client + except under experimental conditions. + + A client MUST be prepared to accept one or more 1xx status responses + prior to a regular response, even if the client does not expect a 100 + (Continue) status message. Unexpected 1xx status responses MAY be + ignored by a user agent. + + Proxies MUST forward 1xx responses, unless the connection between the + proxy and its client has been closed, or unless the proxy itself + requested the generation of the 1xx response. (For example, if a + + + + + + +Fielding, et al. Standards Track [Page 57] + +RFC 2616 HTTP/1.1 June 1999 + + + proxy adds a "Expect: 100-continue" field when it forwards a request, + then it need not forward the corresponding 100 (Continue) + response(s).) + +10.1.1 100 Continue + + The client SHOULD continue with its request. This interim response is + used to inform the client that the initial part of the request has + been received and has not yet been rejected by the server. The client + SHOULD continue by sending the remainder of the request or, if the + request has already been completed, ignore this response. The server + MUST send a final response after the request has been completed. See + section 8.2.3 for detailed discussion of the use and handling of this + status code. + +10.1.2 101 Switching Protocols + + The server understands and is willing to comply with the client's + request, via the Upgrade message header field (section 14.42), for a + change in the application protocol being used on this connection. The + server will switch protocols to those defined by the response's + Upgrade header field immediately after the empty line which + terminates the 101 response. + + The protocol SHOULD be switched only when it is advantageous to do + so. For example, switching to a newer version of HTTP is advantageous + over older versions, and switching to a real-time, synchronous + protocol might be advantageous when delivering resources that use + such features. + +10.2 Successful 2xx + + This class of status code indicates that the client's request was + successfully received, understood, and accepted. + +10.2.1 200 OK + + The request has succeeded. The information returned with the response + is dependent on the method used in the request, for example: + + GET an entity corresponding to the requested resource is sent in + the response; + + HEAD the entity-header fields corresponding to the requested + resource are sent in the response without any message-body; + + POST an entity describing or containing the result of the action; + + + + +Fielding, et al. Standards Track [Page 58] + +RFC 2616 HTTP/1.1 June 1999 + + + TRACE an entity containing the request message as received by the + end server. + +10.2.2 201 Created + + The request has been fulfilled and resulted in a new resource being + created. The newly created resource can be referenced by the URI(s) + returned in the entity of the response, with the most specific URI + for the resource given by a Location header field. The response + SHOULD include an entity containing a list of resource + characteristics and location(s) from which the user or user agent can + choose the one most appropriate. The entity format is specified by + the media type given in the Content-Type header field. The origin + server MUST create the resource before returning the 201 status code. + If the action cannot be carried out immediately, the server SHOULD + respond with 202 (Accepted) response instead. + + A 201 response MAY contain an ETag response header field indicating + the current value of the entity tag for the requested variant just + created, see section 14.19. + +10.2.3 202 Accepted + + The request has been accepted for processing, but the processing has + not been completed. The request might or might not eventually be + acted upon, as it might be disallowed when processing actually takes + place. There is no facility for re-sending a status code from an + asynchronous operation such as this. + + The 202 response is intentionally non-committal. Its purpose is to + allow a server to accept a request for some other process (perhaps a + batch-oriented process that is only run once per day) without + requiring that the user agent's connection to the server persist + until the process is completed. The entity returned with this + response SHOULD include an indication of the request's current status + and either a pointer to a status monitor or some estimate of when the + user can expect the request to be fulfilled. + +10.2.4 203 Non-Authoritative Information + + The returned metainformation in the entity-header is not the + definitive set as available from the origin server, but is gathered + from a local or a third-party copy. The set presented MAY be a subset + or superset of the original version. For example, including local + annotation information about the resource might result in a superset + of the metainformation known by the origin server. Use of this + response code is not required and is only appropriate when the + response would otherwise be 200 (OK). + + + +Fielding, et al. Standards Track [Page 59] + +RFC 2616 HTTP/1.1 June 1999 + + +10.2.5 204 No Content + + The server has fulfilled the request but does not need to return an + entity-body, and might want to return updated metainformation. The + response MAY include new or updated metainformation in the form of + entity-headers, which if present SHOULD be associated with the + requested variant. + + If the client is a user agent, it SHOULD NOT change its document view + from that which caused the request to be sent. This response is + primarily intended to allow input for actions to take place without + causing a change to the user agent's active document view, although + any new or updated metainformation SHOULD be applied to the document + currently in the user agent's active view. + + The 204 response MUST NOT include a message-body, and thus is always + terminated by the first empty line after the header fields. + +10.2.6 205 Reset Content + + The server has fulfilled the request and the user agent SHOULD reset + the document view which caused the request to be sent. This response + is primarily intended to allow input for actions to take place via + user input, followed by a clearing of the form in which the input is + given so that the user can easily initiate another input action. The + response MUST NOT include an entity. + +10.2.7 206 Partial Content + + The server has fulfilled the partial GET request for the resource. + The request MUST have included a Range header field (section 14.35) + indicating the desired range, and MAY have included an If-Range + header field (section 14.27) to make the request conditional. + + The response MUST include the following header fields: + + - Either a Content-Range header field (section 14.16) indicating + the range included with this response, or a multipart/byteranges + Content-Type including Content-Range fields for each part. If a + Content-Length header field is present in the response, its + value MUST match the actual number of OCTETs transmitted in the + message-body. + + - Date + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + + + +Fielding, et al. Standards Track [Page 60] + +RFC 2616 HTTP/1.1 June 1999 + + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the 206 response is the result of an If-Range request that used a + strong cache validator (see section 13.3.3), the response SHOULD NOT + include other entity-headers. If the response is the result of an + If-Range request that used a weak validator, the response MUST NOT + include other entity-headers; this prevents inconsistencies between + cached entity-bodies and updated headers. Otherwise, the response + MUST include all of the entity-headers that would have been returned + with a 200 (OK) response to the same request. + + A cache MUST NOT combine a 206 response with other previously cached + content if the ETag or Last-Modified headers do not match exactly, + see 13.5.4. + + A cache that does not support the Range and Content-Range headers + MUST NOT cache 206 (Partial) responses. + +10.3 Redirection 3xx + + This class of status code indicates that further action needs to be + taken by the user agent in order to fulfill the request. The action + required MAY be carried out by the user agent without interaction + with the user if and only if the method used in the second request is + GET or HEAD. A client SHOULD detect infinite redirection loops, since + such loops generate network traffic for each redirection. + + Note: previous versions of this specification recommended a + maximum of five redirections. Content developers should be aware + that there might be clients that implement such a fixed + limitation. + +10.3.1 300 Multiple Choices + + The requested resource corresponds to any one of a set of + representations, each with its own specific location, and agent- + driven negotiation information (section 12) is being provided so that + the user (or user agent) can select a preferred representation and + redirect its request to that location. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of resource characteristics and location(s) from + which the user or user agent can choose the one most appropriate. The + entity format is specified by the media type given in the Content- + Type header field. Depending upon the format and the capabilities of + + + + +Fielding, et al. Standards Track [Page 61] + +RFC 2616 HTTP/1.1 June 1999 + + + the user agent, selection of the most appropriate choice MAY be + performed automatically. However, this specification does not define + any standard for such automatic selection. + + If the server has a preferred choice of representation, it SHOULD + include the specific URI for that representation in the Location + field; user agents MAY use the Location field value for automatic + redirection. This response is cacheable unless indicated otherwise. + +10.3.2 301 Moved Permanently + + The requested resource has been assigned a new permanent URI and any + future references to this resource SHOULD use one of the returned + URIs. Clients with link editing capabilities ought to automatically + re-link references to the Request-URI to one or more of the new + references returned by the server, where possible. This response is + cacheable unless indicated otherwise. + + The new permanent URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + If the 301 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: When automatically redirecting a POST request after + receiving a 301 status code, some existing HTTP/1.0 user agents + will erroneously change it into a GET request. + +10.3.3 302 Found + + The requested resource resides temporarily under a different URI. + Since the redirection might be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + + + + + + +Fielding, et al. Standards Track [Page 62] + +RFC 2616 HTTP/1.1 June 1999 + + + If the 302 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: RFC 1945 and RFC 2068 specify that the client is not allowed + to change the method on the redirected request. However, most + existing user agent implementations treat 302 as if it were a 303 + response, performing a GET on the Location field-value regardless + of the original request method. The status codes 303 and 307 have + been added for servers that wish to make unambiguously clear which + kind of reaction is expected of the client. + +10.3.4 303 See Other + + The response to the request can be found under a different URI and + SHOULD be retrieved using a GET method on that resource. This method + exists primarily to allow the output of a POST-activated script to + redirect the user agent to a selected resource. The new URI is not a + substitute reference for the originally requested resource. The 303 + response MUST NOT be cached, but the response to the second + (redirected) request might be cacheable. + + The different URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + Note: Many pre-HTTP/1.1 user agents do not understand the 303 + status. When interoperability with such clients is a concern, the + 302 status code may be used instead, since most user agents react + to a 302 response as described here for 303. + +10.3.5 304 Not Modified + + If the client has performed a conditional GET request and access is + allowed, but the document has not been modified, the server SHOULD + respond with this status code. The 304 response MUST NOT contain a + message-body, and thus is always terminated by the first empty line + after the header fields. + + The response MUST include the following header fields: + + - Date, unless its omission is required by section 14.18.1 + + + + + + + +Fielding, et al. Standards Track [Page 63] + +RFC 2616 HTTP/1.1 June 1999 + + + If a clockless origin server obeys these rules, and proxies and + clients add their own Date to any response received without one (as + already specified by [RFC 2068], section 14.19), caches will operate + correctly. + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the conditional GET used a strong cache validator (see section + 13.3.3), the response SHOULD NOT include other entity-headers. + Otherwise (i.e., the conditional GET used a weak validator), the + response MUST NOT include other entity-headers; this prevents + inconsistencies between cached entity-bodies and updated headers. + + If a 304 response indicates an entity not currently cached, then the + cache MUST disregard the response and repeat the request without the + conditional. + + If a cache uses a received 304 response to update a cache entry, the + cache MUST update the entry to reflect any new field values given in + the response. + +10.3.6 305 Use Proxy + + The requested resource MUST be accessed through the proxy given by + the Location field. The Location field gives the URI of the proxy. + The recipient is expected to repeat this single request via the + proxy. 305 responses MUST only be generated by origin servers. + + Note: RFC 2068 was not clear that 305 was intended to redirect a + single request, and to be generated by origin servers only. Not + observing these limitations has significant security consequences. + +10.3.7 306 (Unused) + + The 306 status code was used in a previous version of the + specification, is no longer used, and the code is reserved. + + + + + + + + + + +Fielding, et al. Standards Track [Page 64] + +RFC 2616 HTTP/1.1 June 1999 + + +10.3.8 307 Temporary Redirect + + The requested resource resides temporarily under a different URI. + Since the redirection MAY be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s) , since many pre-HTTP/1.1 user agents do not + understand the 307 status. Therefore, the note SHOULD contain the + information necessary for a user to repeat the original request on + the new URI. + + If the 307 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + +10.4 Client Error 4xx + + The 4xx class of status code is intended for cases in which the + client seems to have erred. Except when responding to a HEAD request, + the server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. These status codes are applicable to any request method. + User agents SHOULD display any included entity to the user. + + If the client is sending data, a server implementation using TCP + SHOULD be careful to ensure that the client acknowledges receipt of + the packet(s) containing the response, before the server closes the + input connection. If the client continues sending data to the server + after the close, the server's TCP stack will send a reset packet to + the client, which may erase the client's unacknowledged input buffers + before they can be read and interpreted by the HTTP application. + +10.4.1 400 Bad Request + + The request could not be understood by the server due to malformed + syntax. The client SHOULD NOT repeat the request without + modifications. + + + + + + + + +Fielding, et al. Standards Track [Page 65] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.2 401 Unauthorized + + The request requires user authentication. The response MUST include a + WWW-Authenticate header field (section 14.47) containing a challenge + applicable to the requested resource. The client MAY repeat the + request with a suitable Authorization header field (section 14.8). If + the request already included Authorization credentials, then the 401 + response indicates that authorization has been refused for those + credentials. If the 401 response contains the same challenge as the + prior response, and the user agent has already attempted + authentication at least once, then the user SHOULD be presented the + entity that was given in the response, since that entity might + include relevant diagnostic information. HTTP access authentication + is explained in "HTTP Authentication: Basic and Digest Access + Authentication" [43]. + +10.4.3 402 Payment Required + + This code is reserved for future use. + +10.4.4 403 Forbidden + + The server understood the request, but is refusing to fulfill it. + Authorization will not help and the request SHOULD NOT be repeated. + If the request method was not HEAD and the server wishes to make + public why the request has not been fulfilled, it SHOULD describe the + reason for the refusal in the entity. If the server does not wish to + make this information available to the client, the status code 404 + (Not Found) can be used instead. + +10.4.5 404 Not Found + + The server has not found anything matching the Request-URI. No + indication is given of whether the condition is temporary or + permanent. The 410 (Gone) status code SHOULD be used if the server + knows, through some internally configurable mechanism, that an old + resource is permanently unavailable and has no forwarding address. + This status code is commonly used when the server does not wish to + reveal exactly why the request has been refused, or when no other + response is applicable. + +10.4.6 405 Method Not Allowed + + The method specified in the Request-Line is not allowed for the + resource identified by the Request-URI. The response MUST include an + Allow header containing a list of valid methods for the requested + resource. + + + + +Fielding, et al. Standards Track [Page 66] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.7 406 Not Acceptable + + The resource identified by the request is only capable of generating + response entities which have content characteristics not acceptable + according to the accept headers sent in the request. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of available entity characteristics and location(s) + from which the user or user agent can choose the one most + appropriate. The entity format is specified by the media type given + in the Content-Type header field. Depending upon the format and the + capabilities of the user agent, selection of the most appropriate + choice MAY be performed automatically. However, this specification + does not define any standard for such automatic selection. + + Note: HTTP/1.1 servers are allowed to return responses which are + not acceptable according to the accept headers sent in the + request. In some cases, this may even be preferable to sending a + 406 response. User agents are encouraged to inspect the headers of + an incoming response to determine if it is acceptable. + + If the response could be unacceptable, a user agent SHOULD + temporarily stop receipt of more data and query the user for a + decision on further actions. + +10.4.8 407 Proxy Authentication Required + + This code is similar to 401 (Unauthorized), but indicates that the + client must first authenticate itself with the proxy. The proxy MUST + return a Proxy-Authenticate header field (section 14.33) containing a + challenge applicable to the proxy for the requested resource. The + client MAY repeat the request with a suitable Proxy-Authorization + header field (section 14.34). HTTP access authentication is explained + in "HTTP Authentication: Basic and Digest Access Authentication" + [43]. + +10.4.9 408 Request Timeout + + The client did not produce a request within the time that the server + was prepared to wait. The client MAY repeat the request without + modifications at any later time. + +10.4.10 409 Conflict + + The request could not be completed due to a conflict with the current + state of the resource. This code is only allowed in situations where + it is expected that the user might be able to resolve the conflict + and resubmit the request. The response body SHOULD include enough + + + +Fielding, et al. Standards Track [Page 67] + +RFC 2616 HTTP/1.1 June 1999 + + + information for the user to recognize the source of the conflict. + Ideally, the response entity would include enough information for the + user or user agent to fix the problem; however, that might not be + possible and is not required. + + Conflicts are most likely to occur in response to a PUT request. For + example, if versioning were being used and the entity being PUT + included changes to a resource which conflict with those made by an + earlier (third-party) request, the server might use the 409 response + to indicate that it can't complete the request. In this case, the + response entity would likely contain a list of the differences + between the two versions in a format defined by the response + Content-Type. + +10.4.11 410 Gone + + The requested resource is no longer available at the server and no + forwarding address is known. This condition is expected to be + considered permanent. Clients with link editing capabilities SHOULD + delete references to the Request-URI after user approval. If the + server does not know, or has no facility to determine, whether or not + the condition is permanent, the status code 404 (Not Found) SHOULD be + used instead. This response is cacheable unless indicated otherwise. + + The 410 response is primarily intended to assist the task of web + maintenance by notifying the recipient that the resource is + intentionally unavailable and that the server owners desire that + remote links to that resource be removed. Such an event is common for + limited-time, promotional services and for resources belonging to + individuals no longer working at the server's site. It is not + necessary to mark all permanently unavailable resources as "gone" or + to keep the mark for any length of time -- that is left to the + discretion of the server owner. + +10.4.12 411 Length Required + + The server refuses to accept the request without a defined Content- + Length. The client MAY repeat the request if it adds a valid + Content-Length header field containing the length of the message-body + in the request message. + +10.4.13 412 Precondition Failed + + The precondition given in one or more of the request-header fields + evaluated to false when it was tested on the server. This response + code allows the client to place preconditions on the current resource + metainformation (header field data) and thus prevent the requested + method from being applied to a resource other than the one intended. + + + +Fielding, et al. Standards Track [Page 68] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.14 413 Request Entity Too Large + + The server is refusing to process a request because the request + entity is larger than the server is willing or able to process. The + server MAY close the connection to prevent the client from continuing + the request. + + If the condition is temporary, the server SHOULD include a Retry- + After header field to indicate that it is temporary and after what + time the client MAY try again. + +10.4.15 414 Request-URI Too Long + + The server is refusing to service the request because the Request-URI + is longer than the server is willing to interpret. This rare + condition is only likely to occur when a client has improperly + converted a POST request to a GET request with long query + information, when the client has descended into a URI "black hole" of + redirection (e.g., a redirected URI prefix that points to a suffix of + itself), or when the server is under attack by a client attempting to + exploit security holes present in some servers using fixed-length + buffers for reading or manipulating the Request-URI. + +10.4.16 415 Unsupported Media Type + + The server is refusing to service the request because the entity of + the request is in a format not supported by the requested resource + for the requested method. + +10.4.17 416 Requested Range Not Satisfiable + + A server SHOULD return a response with this status code if a request + included a Range request-header field (section 14.35), and none of + the range-specifier values in this field overlap the current extent + of the selected resource, and the request did not include an If-Range + request-header field. (For byte-ranges, this means that the first- + byte-pos of all of the byte-range-spec values were greater than the + current length of the selected resource.) + + When this status code is returned for a byte-range request, the + response SHOULD include a Content-Range entity-header field + specifying the current length of the selected resource (see section + 14.16). This response MUST NOT use the multipart/byteranges content- + type. + + + + + + + +Fielding, et al. Standards Track [Page 69] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.18 417 Expectation Failed + + The expectation given in an Expect request-header field (see section + 14.20) could not be met by this server, or, if the server is a proxy, + the server has unambiguous evidence that the request could not be met + by the next-hop server. + +10.5 Server Error 5xx + + Response status codes beginning with the digit "5" indicate cases in + which the server is aware that it has erred or is incapable of + performing the request. Except when responding to a HEAD request, the + server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. User agents SHOULD display any included entity to the + user. These response codes are applicable to any request method. + +10.5.1 500 Internal Server Error + + The server encountered an unexpected condition which prevented it + from fulfilling the request. + +10.5.2 501 Not Implemented + + The server does not support the functionality required to fulfill the + request. This is the appropriate response when the server does not + recognize the request method and is not capable of supporting it for + any resource. + +10.5.3 502 Bad Gateway + + The server, while acting as a gateway or proxy, received an invalid + response from the upstream server it accessed in attempting to + fulfill the request. + +10.5.4 503 Service Unavailable + + The server is currently unable to handle the request due to a + temporary overloading or maintenance of the server. The implication + is that this is a temporary condition which will be alleviated after + some delay. If known, the length of the delay MAY be indicated in a + Retry-After header. If no Retry-After is given, the client SHOULD + handle the response as it would for a 500 response. + + Note: The existence of the 503 status code does not imply that a + server must use it when becoming overloaded. Some servers may wish + to simply refuse the connection. + + + + +Fielding, et al. Standards Track [Page 70] + +RFC 2616 HTTP/1.1 June 1999 + + +10.5.5 504 Gateway Timeout + + The server, while acting as a gateway or proxy, did not receive a + timely response from the upstream server specified by the URI (e.g. + HTTP, FTP, LDAP) or some other auxiliary server (e.g. DNS) it needed + to access in attempting to complete the request. + + Note: Note to implementors: some deployed proxies are known to + return 400 or 500 when DNS lookups time out. + +10.5.6 505 HTTP Version Not Supported + + The server does not support, or refuses to support, the HTTP protocol + version that was used in the request message. The server is + indicating that it is unable or unwilling to complete the request + using the same major version as the client, as described in section + 3.1, other than with this error message. The response SHOULD contain + an entity describing why that version is not supported and what other + protocols are supported by that server. + +11 Access Authentication + + HTTP provides several OPTIONAL challenge-response authentication + mechanisms which can be used by a server to challenge a client + request and by a client to provide authentication information. The + general framework for access authentication, and the specification of + "basic" and "digest" authentication, are specified in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. This + specification adopts the definitions of "challenge" and "credentials" + from that specification. + +12 Content Negotiation + + Most HTTP responses include an entity which contains information for + interpretation by a human user. Naturally, it is desirable to supply + the user with the "best available" entity corresponding to the + request. Unfortunately for servers and caches, not all users have the + same preferences for what is "best," and not all user agents are + equally capable of rendering all entity types. For that reason, HTTP + has provisions for several mechanisms for "content negotiation" -- + the process of selecting the best representation for a given response + when there are multiple representations available. + + Note: This is not called "format negotiation" because the + alternate representations may be of the same media type, but use + different capabilities of that type, be in different languages, + etc. + + + + +Fielding, et al. Standards Track [Page 71] + +RFC 2616 HTTP/1.1 June 1999 + + + Any response containing an entity-body MAY be subject to negotiation, + including error responses. + + There are two kinds of content negotiation which are possible in + HTTP: server-driven and agent-driven negotiation. These two kinds of + negotiation are orthogonal and thus may be used separately or in + combination. One method of combination, referred to as transparent + negotiation, occurs when a cache uses the agent-driven negotiation + information provided by the origin server in order to provide + server-driven negotiation for subsequent requests. + +12.1 Server-driven Negotiation + + If the selection of the best representation for a response is made by + an algorithm located at the server, it is called server-driven + negotiation. Selection is based on the available representations of + the response (the dimensions over which it can vary; e.g. language, + content-coding, etc.) and the contents of particular header fields in + the request message or on other information pertaining to the request + (such as the network address of the client). + + Server-driven negotiation is advantageous when the algorithm for + selecting from among the available representations is difficult to + describe to the user agent, or when the server desires to send its + "best guess" to the client along with the first response (hoping to + avoid the round-trip delay of a subsequent request if the "best + guess" is good enough for the user). In order to improve the server's + guess, the user agent MAY include request header fields (Accept, + Accept-Language, Accept-Encoding, etc.) which describe its + preferences for such a response. + + Server-driven negotiation has disadvantages: + + 1. It is impossible for the server to accurately determine what + might be "best" for any given user, since that would require + complete knowledge of both the capabilities of the user agent + and the intended use for the response (e.g., does the user want + to view it on screen or print it on paper?). + + 2. Having the user agent describe its capabilities in every + request can be both very inefficient (given that only a small + percentage of responses have multiple representations) and a + potential violation of the user's privacy. + + 3. It complicates the implementation of an origin server and the + algorithms for generating responses to a request. + + + + + +Fielding, et al. Standards Track [Page 72] + +RFC 2616 HTTP/1.1 June 1999 + + + 4. It may limit a public cache's ability to use the same response + for multiple user's requests. + + HTTP/1.1 includes the following request-header fields for enabling + server-driven negotiation through description of user agent + capabilities and user preferences: Accept (section 14.1), Accept- + Charset (section 14.2), Accept-Encoding (section 14.3), Accept- + Language (section 14.4), and User-Agent (section 14.43). However, an + origin server is not limited to these dimensions and MAY vary the + response based on any aspect of the request, including information + outside the request-header fields or within extension header fields + not defined by this specification. + + The Vary header field can be used to express the parameters the + server uses to select a representation that is subject to server- + driven negotiation. See section 13.6 for use of the Vary header field + by caches and section 14.44 for use of the Vary header field by + servers. + +12.2 Agent-driven Negotiation + + With agent-driven negotiation, selection of the best representation + for a response is performed by the user agent after receiving an + initial response from the origin server. Selection is based on a list + of the available representations of the response included within the + header fields or entity-body of the initial response, with each + representation identified by its own URI. Selection from among the + representations may be performed automatically (if the user agent is + capable of doing so) or manually by the user selecting from a + generated (possibly hypertext) menu. + + Agent-driven negotiation is advantageous when the response would vary + over commonly-used dimensions (such as type, language, or encoding), + when the origin server is unable to determine a user agent's + capabilities from examining the request, and generally when public + caches are used to distribute server load and reduce network usage. + + Agent-driven negotiation suffers from the disadvantage of needing a + second request to obtain the best alternate representation. This + second request is only efficient when caching is used. In addition, + this specification does not define any mechanism for supporting + automatic selection, though it also does not prevent any such + mechanism from being developed as an extension and used within + HTTP/1.1. + + + + + + + +Fielding, et al. Standards Track [Page 73] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 defines the 300 (Multiple Choices) and 406 (Not Acceptable) + status codes for enabling agent-driven negotiation when the server is + unwilling or unable to provide a varying response using server-driven + negotiation. + +12.3 Transparent Negotiation + + Transparent negotiation is a combination of both server-driven and + agent-driven negotiation. When a cache is supplied with a form of the + list of available representations of the response (as in agent-driven + negotiation) and the dimensions of variance are completely understood + by the cache, then the cache becomes capable of performing server- + driven negotiation on behalf of the origin server for subsequent + requests on that resource. + + Transparent negotiation has the advantage of distributing the + negotiation work that would otherwise be required of the origin + server and also removing the second request delay of agent-driven + negotiation when the cache is able to correctly guess the right + response. + + This specification does not define any mechanism for transparent + negotiation, though it also does not prevent any such mechanism from + being developed as an extension that could be used within HTTP/1.1. + +13 Caching in HTTP + + HTTP is typically used for distributed information systems, where + performance can be improved by the use of response caches. The + HTTP/1.1 protocol includes a number of elements intended to make + caching work as well as possible. Because these elements are + inextricable from other aspects of the protocol, and because they + interact with each other, it is useful to describe the basic caching + design of HTTP separately from the detailed descriptions of methods, + headers, response codes, etc. + + Caching would be useless if it did not significantly improve + performance. The goal of caching in HTTP/1.1 is to eliminate the need + to send requests in many cases, and to eliminate the need to send + full responses in many other cases. The former reduces the number of + network round-trips required for many operations; we use an + "expiration" mechanism for this purpose (see section 13.2). The + latter reduces network bandwidth requirements; we use a "validation" + mechanism for this purpose (see section 13.3). + + Requirements for performance, availability, and disconnected + operation require us to be able to relax the goal of semantic + transparency. The HTTP/1.1 protocol allows origin servers, caches, + + + +Fielding, et al. Standards Track [Page 74] + +RFC 2616 HTTP/1.1 June 1999 + + + and clients to explicitly reduce transparency when necessary. + However, because non-transparent operation may confuse non-expert + users, and might be incompatible with certain server applications + (such as those for ordering merchandise), the protocol requires that + transparency be relaxed + + - only by an explicit protocol-level request when relaxed by + client or origin server + + - only with an explicit warning to the end user when relaxed by + cache or client + + Therefore, the HTTP/1.1 protocol provides these important elements: + + 1. Protocol features that provide full semantic transparency when + this is required by all parties. + + 2. Protocol features that allow an origin server or user agent to + explicitly request and control non-transparent operation. + + 3. Protocol features that allow a cache to attach warnings to + responses that do not preserve the requested approximation of + semantic transparency. + + A basic principle is that it must be possible for the clients to + detect any potential relaxation of semantic transparency. + + Note: The server, cache, or client implementor might be faced with + design decisions not explicitly discussed in this specification. + If a decision might affect semantic transparency, the implementor + ought to err on the side of maintaining transparency unless a + careful and complete analysis shows significant benefits in + breaking transparency. + +13.1.1 Cache Correctness + + A correct cache MUST respond to a request with the most up-to-date + response held by the cache that is appropriate to the request (see + sections 13.2.5, 13.2.6, and 13.12) which meets one of the following + conditions: + + 1. It has been checked for equivalence with what the origin server + would have returned by revalidating the response with the + origin server (section 13.3); + + + + + + + +Fielding, et al. Standards Track [Page 75] + +RFC 2616 HTTP/1.1 June 1999 + + + 2. It is "fresh enough" (see section 13.2). In the default case, + this means it meets the least restrictive freshness requirement + of the client, origin server, and cache (see section 14.9); if + the origin server so specifies, it is the freshness requirement + of the origin server alone. + + If a stored response is not "fresh enough" by the most + restrictive freshness requirement of both the client and the + origin server, in carefully considered circumstances the cache + MAY still return the response with the appropriate Warning + header (see section 13.1.5 and 14.46), unless such a response + is prohibited (e.g., by a "no-store" cache-directive, or by a + "no-cache" cache-request-directive; see section 14.9). + + 3. It is an appropriate 304 (Not Modified), 305 (Proxy Redirect), + or error (4xx or 5xx) response message. + + If the cache can not communicate with the origin server, then a + correct cache SHOULD respond as above if the response can be + correctly served from the cache; if not it MUST return an error or + warning indicating that there was a communication failure. + + If a cache receives a response (either an entire response, or a 304 + (Not Modified) response) that it would normally forward to the + requesting client, and the received response is no longer fresh, the + cache SHOULD forward it to the requesting client without adding a new + Warning (but without removing any existing Warning headers). A cache + SHOULD NOT attempt to revalidate a response simply because that + response became stale in transit; this might lead to an infinite + loop. A user agent that receives a stale response without a Warning + MAY display a warning indication to the user. + +13.1.2 Warnings + + Whenever a cache returns a response that is neither first-hand nor + "fresh enough" (in the sense of condition 2 in section 13.1.1), it + MUST attach a warning to that effect, using a Warning general-header. + The Warning header and the currently defined warnings are described + in section 14.46. The warning allows clients to take appropriate + action. + + Warnings MAY be used for other purposes, both cache-related and + otherwise. The use of a warning, rather than an error status code, + distinguish these responses from true failures. + + Warnings are assigned three digit warn-codes. The first digit + indicates whether the Warning MUST or MUST NOT be deleted from a + stored cache entry after a successful revalidation: + + + +Fielding, et al. Standards Track [Page 76] + +RFC 2616 HTTP/1.1 June 1999 + + + 1xx Warnings that describe the freshness or revalidation status of + the response, and so MUST be deleted after a successful + revalidation. 1XX warn-codes MAY be generated by a cache only when + validating a cached entry. It MUST NOT be generated by clients. + + 2xx Warnings that describe some aspect of the entity body or entity + headers that is not rectified by a revalidation (for example, a + lossy compression of the entity bodies) and which MUST NOT be + deleted after a successful revalidation. + + See section 14.46 for the definitions of the codes themselves. + + HTTP/1.0 caches will cache all Warnings in responses, without + deleting the ones in the first category. Warnings in responses that + are passed to HTTP/1.0 caches carry an extra warning-date field, + which prevents a future HTTP/1.1 recipient from believing an + erroneously cached Warning. + + Warnings also carry a warning text. The text MAY be in any + appropriate natural language (perhaps based on the client's Accept + headers), and include an OPTIONAL indication of what character set is + used. + + Multiple warnings MAY be attached to a response (either by the origin + server or by a cache), including multiple warnings with the same code + number. For example, a server might provide the same warning with + texts in both English and Basque. + + When multiple warnings are attached to a response, it might not be + practical or reasonable to display all of them to the user. This + version of HTTP does not specify strict priority rules for deciding + which warnings to display and in what order, but does suggest some + heuristics. + +13.1.3 Cache-control Mechanisms + + The basic cache mechanisms in HTTP/1.1 (server-specified expiration + times and validators) are implicit directives to caches. In some + cases, a server or client might need to provide explicit directives + to the HTTP caches. We use the Cache-Control header for this purpose. + + The Cache-Control header allows a client or server to transmit a + variety of directives in either requests or responses. These + directives typically override the default caching algorithms. As a + general rule, if there is any apparent conflict between header + values, the most restrictive interpretation is applied (that is, the + one that is most likely to preserve semantic transparency). However, + + + + +Fielding, et al. Standards Track [Page 77] + +RFC 2616 HTTP/1.1 June 1999 + + + in some cases, cache-control directives are explicitly specified as + weakening the approximation of semantic transparency (for example, + "max-stale" or "public"). + + The cache-control directives are described in detail in section 14.9. + +13.1.4 Explicit User Agent Warnings + + Many user agents make it possible for users to override the basic + caching mechanisms. For example, the user agent might allow the user + to specify that cached entities (even explicitly stale ones) are + never validated. Or the user agent might habitually add "Cache- + Control: max-stale=3600" to every request. The user agent SHOULD NOT + default to either non-transparent behavior, or behavior that results + in abnormally ineffective caching, but MAY be explicitly configured + to do so by an explicit action of the user. + + If the user has overridden the basic caching mechanisms, the user + agent SHOULD explicitly indicate to the user whenever this results in + the display of information that might not meet the server's + transparency requirements (in particular, if the displayed entity is + known to be stale). Since the protocol normally allows the user agent + to determine if responses are stale or not, this indication need only + be displayed when this actually happens. The indication need not be a + dialog box; it could be an icon (for example, a picture of a rotting + fish) or some other indicator. + + If the user has overridden the caching mechanisms in a way that would + abnormally reduce the effectiveness of caches, the user agent SHOULD + continually indicate this state to the user (for example, by a + display of a picture of currency in flames) so that the user does not + inadvertently consume excess resources or suffer from excessive + latency. + +13.1.5 Exceptions to the Rules and Warnings + + In some cases, the operator of a cache MAY choose to configure it to + return stale responses even when not requested by clients. This + decision ought not be made lightly, but may be necessary for reasons + of availability or performance, especially when the cache is poorly + connected to the origin server. Whenever a cache returns a stale + response, it MUST mark it as such (using a Warning header) enabling + the client software to alert the user that there might be a potential + problem. + + + + + + + +Fielding, et al. Standards Track [Page 78] + +RFC 2616 HTTP/1.1 June 1999 + + + It also allows the user agent to take steps to obtain a first-hand or + fresh response. For this reason, a cache SHOULD NOT return a stale + response if the client explicitly requests a first-hand or fresh one, + unless it is impossible to comply for technical or policy reasons. + +13.1.6 Client-controlled Behavior + + While the origin server (and to a lesser extent, intermediate caches, + by their contribution to the age of a response) are the primary + source of expiration information, in some cases the client might need + to control a cache's decision about whether to return a cached + response without validating it. Clients do this using several + directives of the Cache-Control header. + + A client's request MAY specify the maximum age it is willing to + accept of an unvalidated response; specifying a value of zero forces + the cache(s) to revalidate all responses. A client MAY also specify + the minimum time remaining before a response expires. Both of these + options increase constraints on the behavior of caches, and so cannot + further relax the cache's approximation of semantic transparency. + + A client MAY also specify that it will accept stale responses, up to + some maximum amount of staleness. This loosens the constraints on the + caches, and so might violate the origin server's specified + constraints on semantic transparency, but might be necessary to + support disconnected operation, or high availability in the face of + poor connectivity. + +13.2 Expiration Model + +13.2.1 Server-Specified Expiration + + HTTP caching works best when caches can entirely avoid making + requests to the origin server. The primary mechanism for avoiding + requests is for an origin server to provide an explicit expiration + time in the future, indicating that a response MAY be used to satisfy + subsequent requests. In other words, a cache can return a fresh + response without first contacting the server. + + Our expectation is that servers will assign future explicit + expiration times to responses in the belief that the entity is not + likely to change, in a semantically significant way, before the + expiration time is reached. This normally preserves semantic + transparency, as long as the server's expiration times are carefully + chosen. + + + + + + +Fielding, et al. Standards Track [Page 79] + +RFC 2616 HTTP/1.1 June 1999 + + + The expiration mechanism applies only to responses taken from a cache + and not to first-hand responses forwarded immediately to the + requesting client. + + If an origin server wishes to force a semantically transparent cache + to validate every request, it MAY assign an explicit expiration time + in the past. This means that the response is always stale, and so the + cache SHOULD validate it before using it for subsequent requests. See + section 14.9.4 for a more restrictive way to force revalidation. + + If an origin server wishes to force any HTTP/1.1 cache, no matter how + it is configured, to validate every request, it SHOULD use the "must- + revalidate" cache-control directive (see section 14.9). + + Servers specify explicit expiration times using either the Expires + header, or the max-age directive of the Cache-Control header. + + An expiration time cannot be used to force a user agent to refresh + its display or reload a resource; its semantics apply only to caching + mechanisms, and such mechanisms need only check a resource's + expiration status when a new request for that resource is initiated. + See section 13.13 for an explanation of the difference between caches + and history mechanisms. + +13.2.2 Heuristic Expiration + + Since origin servers do not always provide explicit expiration times, + HTTP caches typically assign heuristic expiration times, employing + algorithms that use other header values (such as the Last-Modified + time) to estimate a plausible expiration time. The HTTP/1.1 + specification does not provide specific algorithms, but does impose + worst-case constraints on their results. Since heuristic expiration + times might compromise semantic transparency, they ought to used + cautiously, and we encourage origin servers to provide explicit + expiration times as much as possible. + +13.2.3 Age Calculations + + In order to know if a cached entry is fresh, a cache needs to know if + its age exceeds its freshness lifetime. We discuss how to calculate + the latter in section 13.2.4; this section describes how to calculate + the age of a response or cache entry. + + In this discussion, we use the term "now" to mean "the current value + of the clock at the host performing the calculation." Hosts that use + HTTP, but especially hosts running origin servers and caches, SHOULD + use NTP [28] or some similar protocol to synchronize their clocks to + a globally accurate time standard. + + + +Fielding, et al. Standards Track [Page 80] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 requires origin servers to send a Date header, if possible, + with every response, giving the time at which the response was + generated (see section 14.18). We use the term "date_value" to denote + the value of the Date header, in a form appropriate for arithmetic + operations. + + HTTP/1.1 uses the Age response-header to convey the estimated age of + the response message when obtained from a cache. The Age field value + is the cache's estimate of the amount of time since the response was + generated or revalidated by the origin server. + + In essence, the Age value is the sum of the time that the response + has been resident in each of the caches along the path from the + origin server, plus the amount of time it has been in transit along + network paths. + + We use the term "age_value" to denote the value of the Age header, in + a form appropriate for arithmetic operations. + + A response's age can be calculated in two entirely independent ways: + + 1. now minus date_value, if the local clock is reasonably well + synchronized to the origin server's clock. If the result is + negative, the result is replaced by zero. + + 2. age_value, if all of the caches along the response path + implement HTTP/1.1. + + Given that we have two independent ways to compute the age of a + response when it is received, we can combine these as + + corrected_received_age = max(now - date_value, age_value) + + and as long as we have either nearly synchronized clocks or all- + HTTP/1.1 paths, one gets a reliable (conservative) result. + + Because of network-imposed delays, some significant interval might + pass between the time that a server generates a response and the time + it is received at the next outbound cache or client. If uncorrected, + this delay could result in improperly low ages. + + Because the request that resulted in the returned Age value must have + been initiated prior to that Age value's generation, we can correct + for delays imposed by the network by recording the time at which the + request was initiated. Then, when an Age value is received, it MUST + be interpreted relative to the time the request was initiated, not + + + + + +Fielding, et al. Standards Track [Page 81] + +RFC 2616 HTTP/1.1 June 1999 + + + the time that the response was received. This algorithm results in + conservative behavior no matter how much delay is experienced. So, we + compute: + + corrected_initial_age = corrected_received_age + + (now - request_time) + + where "request_time" is the time (according to the local clock) when + the request that elicited this response was sent. + + Summary of age calculation algorithm, when a cache receives a + response: + + /* + * age_value + * is the value of Age: header received by the cache with + * this response. + * date_value + * is the value of the origin server's Date: header + * request_time + * is the (local) time when the cache made the request + * that resulted in this cached response + * response_time + * is the (local) time when the cache received the + * response + * now + * is the current (local) time + */ + + apparent_age = max(0, response_time - date_value); + corrected_received_age = max(apparent_age, age_value); + response_delay = response_time - request_time; + corrected_initial_age = corrected_received_age + response_delay; + resident_time = now - response_time; + current_age = corrected_initial_age + resident_time; + + The current_age of a cache entry is calculated by adding the amount + of time (in seconds) since the cache entry was last validated by the + origin server to the corrected_initial_age. When a response is + generated from a cache entry, the cache MUST include a single Age + header field in the response with a value equal to the cache entry's + current_age. + + The presence of an Age header field in a response implies that a + response is not first-hand. However, the converse is not true, since + the lack of an Age header field in a response does not imply that the + + + + + +Fielding, et al. Standards Track [Page 82] + +RFC 2616 HTTP/1.1 June 1999 + + + response is first-hand unless all caches along the request path are + compliant with HTTP/1.1 (i.e., older HTTP caches did not implement + the Age header field). + +13.2.4 Expiration Calculations + + In order to decide whether a response is fresh or stale, we need to + compare its freshness lifetime to its age. The age is calculated as + described in section 13.2.3; this section describes how to calculate + the freshness lifetime, and to determine if a response has expired. + In the discussion below, the values can be represented in any form + appropriate for arithmetic operations. + + We use the term "expires_value" to denote the value of the Expires + header. We use the term "max_age_value" to denote an appropriate + value of the number of seconds carried by the "max-age" directive of + the Cache-Control header in a response (see section 14.9.3). + + The max-age directive takes priority over Expires, so if max-age is + present in a response, the calculation is simply: + + freshness_lifetime = max_age_value + + Otherwise, if Expires is present in the response, the calculation is: + + freshness_lifetime = expires_value - date_value + + Note that neither of these calculations is vulnerable to clock skew, + since all of the information comes from the origin server. + + If none of Expires, Cache-Control: max-age, or Cache-Control: s- + maxage (see section 14.9.3) appears in the response, and the response + does not include other restrictions on caching, the cache MAY compute + a freshness lifetime using a heuristic. The cache MUST attach Warning + 113 to any response whose age is more than 24 hours if such warning + has not already been added. + + Also, if the response does have a Last-Modified time, the heuristic + expiration value SHOULD be no more than some fraction of the interval + since that time. A typical setting of this fraction might be 10%. + + The calculation to determine if a response has expired is quite + simple: + + response_is_fresh = (freshness_lifetime > current_age) + + + + + + +Fielding, et al. Standards Track [Page 83] + +RFC 2616 HTTP/1.1 June 1999 + + +13.2.5 Disambiguating Expiration Values + + Because expiration values are assigned optimistically, it is possible + for two caches to contain fresh values for the same resource that are + different. + + If a client performing a retrieval receives a non-first-hand response + for a request that was already fresh in its own cache, and the Date + header in its existing cache entry is newer than the Date on the new + response, then the client MAY ignore the response. If so, it MAY + retry the request with a "Cache-Control: max-age=0" directive (see + section 14.9), to force a check with the origin server. + + If a cache has two fresh responses for the same representation with + different validators, it MUST use the one with the more recent Date + header. This situation might arise because the cache is pooling + responses from other caches, or because a client has asked for a + reload or a revalidation of an apparently fresh cache entry. + +13.2.6 Disambiguating Multiple Responses + + Because a client might be receiving responses via multiple paths, so + that some responses flow through one set of caches and other + responses flow through a different set of caches, a client might + receive responses in an order different from that in which the origin + server sent them. We would like the client to use the most recently + generated response, even if older responses are still apparently + fresh. + + Neither the entity tag nor the expiration value can impose an + ordering on responses, since it is possible that a later response + intentionally carries an earlier expiration time. The Date values are + ordered to a granularity of one second. + + When a client tries to revalidate a cache entry, and the response it + receives contains a Date header that appears to be older than the one + for the existing entry, then the client SHOULD repeat the request + unconditionally, and include + + Cache-Control: max-age=0 + + to force any intermediate caches to validate their copies directly + with the origin server, or + + Cache-Control: no-cache + + to force any intermediate caches to obtain a new copy from the origin + server. + + + +Fielding, et al. Standards Track [Page 84] + +RFC 2616 HTTP/1.1 June 1999 + + + If the Date values are equal, then the client MAY use either response + (or MAY, if it is being extremely prudent, request a new response). + Servers MUST NOT depend on clients being able to choose + deterministically between responses generated during the same second, + if their expiration times overlap. + +13.3 Validation Model + + When a cache has a stale entry that it would like to use as a + response to a client's request, it first has to check with the origin + server (or possibly an intermediate cache with a fresh response) to + see if its cached entry is still usable. We call this "validating" + the cache entry. Since we do not want to have to pay the overhead of + retransmitting the full response if the cached entry is good, and we + do not want to pay the overhead of an extra round trip if the cached + entry is invalid, the HTTP/1.1 protocol supports the use of + conditional methods. + + The key protocol features for supporting conditional methods are + those concerned with "cache validators." When an origin server + generates a full response, it attaches some sort of validator to it, + which is kept with the cache entry. When a client (user agent or + proxy cache) makes a conditional request for a resource for which it + has a cache entry, it includes the associated validator in the + request. + + The server then checks that validator against the current validator + for the entity, and, if they match (see section 13.3.3), it responds + with a special status code (usually, 304 (Not Modified)) and no + entity-body. Otherwise, it returns a full response (including + entity-body). Thus, we avoid transmitting the full response if the + validator matches, and we avoid an extra round trip if it does not + match. + + In HTTP/1.1, a conditional request looks exactly the same as a normal + request for the same resource, except that it carries a special + header (which includes the validator) that implicitly turns the + method (usually, GET) into a conditional. + + The protocol includes both positive and negative senses of cache- + validating conditions. That is, it is possible to request either that + a method be performed if and only if a validator matches or if and + only if no validators match. + + + + + + + + +Fielding, et al. Standards Track [Page 85] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: a response that lacks a validator may still be cached, and + served from cache until it expires, unless this is explicitly + prohibited by a cache-control directive. However, a cache cannot + do a conditional retrieval if it does not have a validator for the + entity, which means it will not be refreshable after it expires. + +13.3.1 Last-Modified Dates + + The Last-Modified entity-header field value is often used as a cache + validator. In simple terms, a cache entry is considered to be valid + if the entity has not been modified since the Last-Modified value. + +13.3.2 Entity Tag Cache Validators + + The ETag response-header field value, an entity tag, provides for an + "opaque" cache validator. This might allow more reliable validation + in situations where it is inconvenient to store modification dates, + where the one-second resolution of HTTP date values is not + sufficient, or where the origin server wishes to avoid certain + paradoxes that might arise from the use of modification dates. + + Entity Tags are described in section 3.11. The headers used with + entity tags are described in sections 14.19, 14.24, 14.26 and 14.44. + +13.3.3 Weak and Strong Validators + + Since both origin servers and caches will compare two validators to + decide if they represent the same or different entities, one normally + would expect that if the entity (the entity-body or any entity- + headers) changes in any way, then the associated validator would + change as well. If this is true, then we call this validator a + "strong validator." + + However, there might be cases when a server prefers to change the + validator only on semantically significant changes, and not when + insignificant aspects of the entity change. A validator that does not + always change when the resource changes is a "weak validator." + + Entity tags are normally "strong validators," but the protocol + provides a mechanism to tag an entity tag as "weak." One can think of + a strong validator as one that changes whenever the bits of an entity + changes, while a weak value changes whenever the meaning of an entity + changes. Alternatively, one can think of a strong validator as part + of an identifier for a specific entity, while a weak validator is + part of an identifier for a set of semantically equivalent entities. + + Note: One example of a strong validator is an integer that is + incremented in stable storage every time an entity is changed. + + + +Fielding, et al. Standards Track [Page 86] + +RFC 2616 HTTP/1.1 June 1999 + + + An entity's modification time, if represented with one-second + resolution, could be a weak validator, since it is possible that + the resource might be modified twice during a single second. + + Support for weak validators is optional. However, weak validators + allow for more efficient caching of equivalent objects; for + example, a hit counter on a site is probably good enough if it is + updated every few days or weeks, and any value during that period + is likely "good enough" to be equivalent. + + A "use" of a validator is either when a client generates a request + and includes the validator in a validating header field, or when a + server compares two validators. + + Strong validators are usable in any context. Weak validators are only + usable in contexts that do not depend on exact equality of an entity. + For example, either kind is usable for a conditional GET of a full + entity. However, only a strong validator is usable for a sub-range + retrieval, since otherwise the client might end up with an internally + inconsistent entity. + + Clients MAY issue simple (non-subrange) GET requests with either weak + validators or strong validators. Clients MUST NOT use weak validators + in other forms of request. + + The only function that the HTTP/1.1 protocol defines on validators is + comparison. There are two validator comparison functions, depending + on whether the comparison context allows the use of weak validators + or not: + + - The strong comparison function: in order to be considered equal, + both validators MUST be identical in every way, and both MUST + NOT be weak. + + - The weak comparison function: in order to be considered equal, + both validators MUST be identical in every way, but either or + both of them MAY be tagged as "weak" without affecting the + result. + + An entity tag is strong unless it is explicitly tagged as weak. + Section 3.11 gives the syntax for entity tags. + + A Last-Modified time, when used as a validator in a request, is + implicitly weak unless it is possible to deduce that it is strong, + using the following rules: + + - The validator is being compared by an origin server to the + actual current validator for the entity and, + + + +Fielding, et al. Standards Track [Page 87] + +RFC 2616 HTTP/1.1 June 1999 + + + - That origin server reliably knows that the associated entity did + not change twice during the second covered by the presented + validator. + + or + + - The validator is about to be used by a client in an If- + Modified-Since or If-Unmodified-Since header, because the client + has a cache entry for the associated entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + or + + - The validator is being compared by an intermediate cache to the + validator stored in its cache entry for the entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + This method relies on the fact that if two different responses were + sent by the origin server during the same second, but both had the + same Last-Modified time, then at least one of those responses would + have a Date value equal to its Last-Modified time. The arbitrary 60- + second limit guards against the possibility that the Date and Last- + Modified values are generated from different clocks, or at somewhat + different times during the preparation of the response. An + implementation MAY use a value larger than 60 seconds, if it is + believed that 60 seconds is too short. + + If a client wishes to perform a sub-range retrieval on a value for + which it has only a Last-Modified time and no opaque validator, it + MAY do this only if the Last-Modified time is strong in the sense + described here. + + A cache or origin server receiving a conditional request, other than + a full-body GET request, MUST use the strong comparison function to + evaluate the condition. + + These rules allow HTTP/1.1 caches and clients to safely perform sub- + range retrievals on values that have been obtained from HTTP/1.0 + + + +Fielding, et al. Standards Track [Page 88] + +RFC 2616 HTTP/1.1 June 1999 + + + servers. + +13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates + + We adopt a set of rules and recommendations for origin servers, + clients, and caches regarding when various validator types ought to + be used, and for what purposes. + + HTTP/1.1 origin servers: + + - SHOULD send an entity tag validator unless it is not feasible to + generate one. + + - MAY send a weak entity tag instead of a strong entity tag, if + performance considerations support the use of weak entity tags, + or if it is unfeasible to send a strong entity tag. + + - SHOULD send a Last-Modified value if it is feasible to send one, + unless the risk of a breakdown in semantic transparency that + could result from using this date in an If-Modified-Since header + would lead to serious problems. + + In other words, the preferred behavior for an HTTP/1.1 origin server + is to send both a strong entity tag and a Last-Modified value. + + In order to be legal, a strong entity tag MUST change whenever the + associated entity value changes in any way. A weak entity tag SHOULD + change whenever the associated entity changes in a semantically + significant way. + + Note: in order to provide semantically transparent caching, an + origin server must avoid reusing a specific strong entity tag + value for two different entities, or reusing a specific weak + entity tag value for two semantically different entities. Cache + entries might persist for arbitrarily long periods, regardless of + expiration times, so it might be inappropriate to expect that a + cache will never again attempt to validate an entry using a + validator that it obtained at some point in the past. + + HTTP/1.1 clients: + + - If an entity tag has been provided by the origin server, MUST + use that entity tag in any cache-conditional request (using If- + Match or If-None-Match). + + - If only a Last-Modified value has been provided by the origin + server, SHOULD use that value in non-subrange cache-conditional + requests (using If-Modified-Since). + + + +Fielding, et al. Standards Track [Page 89] + +RFC 2616 HTTP/1.1 June 1999 + + + - If only a Last-Modified value has been provided by an HTTP/1.0 + origin server, MAY use that value in subrange cache-conditional + requests (using If-Unmodified-Since:). The user agent SHOULD + provide a way to disable this, in case of difficulty. + + - If both an entity tag and a Last-Modified value have been + provided by the origin server, SHOULD use both validators in + cache-conditional requests. This allows both HTTP/1.0 and + HTTP/1.1 caches to respond appropriately. + + An HTTP/1.1 origin server, upon receiving a conditional request that + includes both a Last-Modified date (e.g., in an If-Modified-Since or + If-Unmodified-Since header field) and one or more entity tags (e.g., + in an If-Match, If-None-Match, or If-Range header field) as cache + validators, MUST NOT return a response status of 304 (Not Modified) + unless doing so is consistent with all of the conditional header + fields in the request. + + An HTTP/1.1 caching proxy, upon receiving a conditional request that + includes both a Last-Modified date and one or more entity tags as + cache validators, MUST NOT return a locally cached response to the + client unless that cached response is consistent with all of the + conditional header fields in the request. + + Note: The general principle behind these rules is that HTTP/1.1 + servers and clients should transmit as much non-redundant + information as is available in their responses and requests. + HTTP/1.1 systems receiving this information will make the most + conservative assumptions about the validators they receive. + + HTTP/1.0 clients and caches will ignore entity tags. Generally, + last-modified values received or used by these systems will + support transparent and efficient caching, and so HTTP/1.1 origin + servers should provide Last-Modified values. In those rare cases + where the use of a Last-Modified value as a validator by an + HTTP/1.0 system could result in a serious problem, then HTTP/1.1 + origin servers should not provide one. + +13.3.5 Non-validating Conditionals + + The principle behind entity tags is that only the service author + knows the semantics of a resource well enough to select an + appropriate cache validation mechanism, and the specification of any + validator comparison function more complex than byte-equality would + open up a can of worms. Thus, comparisons of any other headers + (except Last-Modified, for compatibility with HTTP/1.0) are never + used for purposes of validating a cache entry. + + + + +Fielding, et al. Standards Track [Page 90] + +RFC 2616 HTTP/1.1 June 1999 + + +13.4 Response Cacheability + + Unless specifically constrained by a cache-control (section 14.9) + directive, a caching system MAY always store a successful response + (see section 13.8) as a cache entry, MAY return it without validation + if it is fresh, and MAY return it after successful validation. If + there is neither a cache validator nor an explicit expiration time + associated with a response, we do not expect it to be cached, but + certain caches MAY violate this expectation (for example, when little + or no network connectivity is available). A client can usually detect + that such a response was taken from a cache by comparing the Date + header to the current time. + + Note: some HTTP/1.0 caches are known to violate this expectation + without providing any Warning. + + However, in some cases it might be inappropriate for a cache to + retain an entity, or to return it in response to a subsequent + request. This might be because absolute semantic transparency is + deemed necessary by the service author, or because of security or + privacy considerations. Certain cache-control directives are + therefore provided so that the server can indicate that certain + resource entities, or portions thereof, are not to be cached + regardless of other considerations. + + Note that section 14.8 normally prevents a shared cache from saving + and returning a response to a previous request if that request + included an Authorization header. + + A response received with a status code of 200, 203, 206, 300, 301 or + 410 MAY be stored by a cache and used in reply to a subsequent + request, subject to the expiration mechanism, unless a cache-control + directive prohibits caching. However, a cache that does not support + the Range and Content-Range headers MUST NOT cache 206 (Partial + Content) responses. + + A response received with any other status code (e.g. status codes 302 + and 307) MUST NOT be returned in a reply to a subsequent request + unless there are cache-control directives or another header(s) that + explicitly allow it. For example, these include the following: an + Expires header (section 14.21); a "max-age", "s-maxage", "must- + revalidate", "proxy-revalidate", "public" or "private" cache-control + directive (section 14.9). + + + + + + + + +Fielding, et al. Standards Track [Page 91] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5 Constructing Responses From Caches + + The purpose of an HTTP cache is to store information received in + response to requests for use in responding to future requests. In + many cases, a cache simply returns the appropriate parts of a + response to the requester. However, if the cache holds a cache entry + based on a previous response, it might have to combine parts of a new + response with what is held in the cache entry. + +13.5.1 End-to-end and Hop-by-hop Headers + + For the purpose of defining the behavior of caches and non-caching + proxies, we divide HTTP headers into two categories: + + - End-to-end headers, which are transmitted to the ultimate + recipient of a request or response. End-to-end headers in + responses MUST be stored as part of a cache entry and MUST be + transmitted in any response formed from a cache entry. + + - Hop-by-hop headers, which are meaningful only for a single + transport-level connection, and are not stored by caches or + forwarded by proxies. + + The following HTTP/1.1 headers are hop-by-hop headers: + + - Connection + - Keep-Alive + - Proxy-Authenticate + - Proxy-Authorization + - TE + - Trailers + - Transfer-Encoding + - Upgrade + + All other headers defined by HTTP/1.1 are end-to-end headers. + + Other hop-by-hop headers MUST be listed in a Connection header, + (section 14.10) to be introduced into HTTP/1.1 (or later). + +13.5.2 Non-modifiable Headers + + Some features of the HTTP/1.1 protocol, such as Digest + Authentication, depend on the value of certain end-to-end headers. A + transparent proxy SHOULD NOT modify an end-to-end header unless the + definition of that header requires or specifically allows that. + + + + + + +Fielding, et al. Standards Track [Page 92] + +RFC 2616 HTTP/1.1 June 1999 + + + A transparent proxy MUST NOT modify any of the following fields in a + request or response, and it MUST NOT add any of these fields if not + already present: + + - Content-Location + + - Content-MD5 + + - ETag + + - Last-Modified + + A transparent proxy MUST NOT modify any of the following fields in a + response: + + - Expires + + but it MAY add any of these fields if not already present. If an + Expires header is added, it MUST be given a field-value identical to + that of the Date header in that response. + + A proxy MUST NOT modify or add any of the following fields in a + message that contains the no-transform cache-control directive, or in + any request: + + - Content-Encoding + + - Content-Range + + - Content-Type + + A non-transparent proxy MAY modify or add these fields to a message + that does not include no-transform, but if it does so, it MUST add a + Warning 214 (Transformation applied) if one does not already appear + in the message (see section 14.46). + + Warning: unnecessary modification of end-to-end headers might + cause authentication failures if stronger authentication + mechanisms are introduced in later versions of HTTP. Such + authentication mechanisms MAY rely on the values of header fields + not listed here. + + The Content-Length field of a request or response is added or deleted + according to the rules in section 4.4. A transparent proxy MUST + preserve the entity-length (section 7.2.2) of the entity-body, + although it MAY change the transfer-length (section 4.4). + + + + + +Fielding, et al. Standards Track [Page 93] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.3 Combining Headers + + When a cache makes a validating request to a server, and the server + provides a 304 (Not Modified) response or a 206 (Partial Content) + response, the cache then constructs a response to send to the + requesting client. + + If the status code is 304 (Not Modified), the cache uses the entity- + body stored in the cache entry as the entity-body of this outgoing + response. If the status code is 206 (Partial Content) and the ETag or + Last-Modified headers match exactly, the cache MAY combine the + contents stored in the cache entry with the new contents received in + the response and use the result as the entity-body of this outgoing + response, (see 13.5.4). + + The end-to-end headers stored in the cache entry are used for the + constructed response, except that + + - any stored Warning headers with warn-code 1xx (see section + 14.46) MUST be deleted from the cache entry and the forwarded + response. + + - any stored Warning headers with warn-code 2xx MUST be retained + in the cache entry and the forwarded response. + + - any end-to-end headers provided in the 304 or 206 response MUST + replace the corresponding headers from the cache entry. + + Unless the cache decides to remove the cache entry, it MUST also + replace the end-to-end headers stored with the cache entry with + corresponding headers received in the incoming response, except for + Warning headers as described immediately above. If a header field- + name in the incoming response matches more than one header in the + cache entry, all such old headers MUST be replaced. + + In other words, the set of end-to-end headers received in the + incoming response overrides all corresponding end-to-end headers + stored with the cache entry (except for stored Warning headers with + warn-code 1xx, which are deleted even if not overridden). + + Note: this rule allows an origin server to use a 304 (Not + Modified) or a 206 (Partial Content) response to update any header + associated with a previous response for the same entity or sub- + ranges thereof, although it might not always be meaningful or + correct to do so. This rule does not allow an origin server to use + a 304 (Not Modified) or a 206 (Partial Content) response to + entirely delete a header that it had provided with a previous + response. + + + +Fielding, et al. Standards Track [Page 94] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.4 Combining Byte Ranges + + A response might transfer only a subrange of the bytes of an entity- + body, either because the request included one or more Range + specifications, or because a connection was broken prematurely. After + several such transfers, a cache might have received several ranges of + the same entity-body. + + If a cache has a stored non-empty set of subranges for an entity, and + an incoming response transfers another subrange, the cache MAY + combine the new subrange with the existing set if both the following + conditions are met: + + - Both the incoming response and the cache entry have a cache + validator. + + - The two cache validators match using the strong comparison + function (see section 13.3.3). + + If either requirement is not met, the cache MUST use only the most + recent partial response (based on the Date values transmitted with + every response, and using the incoming response if these values are + equal or missing), and MUST discard the other partial information. + +13.6 Caching Negotiated Responses + + Use of server-driven content negotiation (section 12.1), as indicated + by the presence of a Vary header field in a response, alters the + conditions and procedure by which a cache can use the response for + subsequent requests. See section 14.44 for use of the Vary header + field by servers. + + A server SHOULD use the Vary header field to inform a cache of what + request-header fields were used to select among multiple + representations of a cacheable response subject to server-driven + negotiation. The set of header fields named by the Vary field value + is known as the "selecting" request-headers. + + When the cache receives a subsequent request whose Request-URI + specifies one or more cache entries including a Vary header field, + the cache MUST NOT use such a cache entry to construct a response to + the new request unless all of the selecting request-headers present + in the new request match the corresponding stored request-headers in + the original request. + + The selecting request-headers from two requests are defined to match + if and only if the selecting request-headers in the first request can + be transformed to the selecting request-headers in the second request + + + +Fielding, et al. Standards Track [Page 95] + +RFC 2616 HTTP/1.1 June 1999 + + + by adding or removing linear white space (LWS) at places where this + is allowed by the corresponding BNF, and/or combining multiple + message-header fields with the same field name following the rules + about message headers in section 4.2. + + A Vary header field-value of "*" always fails to match and subsequent + requests on that resource can only be properly interpreted by the + origin server. + + If the selecting request header fields for the cached entry do not + match the selecting request header fields of the new request, then + the cache MUST NOT use a cached entry to satisfy the request unless + it first relays the new request to the origin server in a conditional + request and the server responds with 304 (Not Modified), including an + entity tag or Content-Location that indicates the entity to be used. + + If an entity tag was assigned to a cached representation, the + forwarded request SHOULD be conditional and include the entity tags + in an If-None-Match header field from all its cache entries for the + resource. This conveys to the server the set of entities currently + held by the cache, so that if any one of these entities matches the + requested entity, the server can use the ETag header field in its 304 + (Not Modified) response to tell the cache which entry is appropriate. + If the entity-tag of the new response matches that of an existing + entry, the new response SHOULD be used to update the header fields of + the existing entry, and the result MUST be returned to the client. + + If any of the existing cache entries contains only partial content + for the associated entity, its entity-tag SHOULD NOT be included in + the If-None-Match header field unless the request is for a range that + would be fully satisfied by that entry. + + If a cache receives a successful response whose Content-Location + field matches that of an existing cache entry for the same Request- + ]URI, whose entity-tag differs from that of the existing entry, and + whose Date is more recent than that of the existing entry, the + existing entry SHOULD NOT be returned in response to future requests + and SHOULD be deleted from the cache. + +13.7 Shared and Non-Shared Caches + + For reasons of security and privacy, it is necessary to make a + distinction between "shared" and "non-shared" caches. A non-shared + cache is one that is accessible only to a single user. Accessibility + in this case SHOULD be enforced by appropriate security mechanisms. + All other caches are considered to be "shared." Other sections of + + + + + +Fielding, et al. Standards Track [Page 96] + +RFC 2616 HTTP/1.1 June 1999 + + + this specification place certain constraints on the operation of + shared caches in order to prevent loss of privacy or failure of + access controls. + +13.8 Errors or Incomplete Response Cache Behavior + + A cache that receives an incomplete response (for example, with fewer + bytes of data than specified in a Content-Length header) MAY store + the response. However, the cache MUST treat this as a partial + response. Partial responses MAY be combined as described in section + 13.5.4; the result might be a full response or might still be + partial. A cache MUST NOT return a partial response to a client + without explicitly marking it as such, using the 206 (Partial + Content) status code. A cache MUST NOT return a partial response + using a status code of 200 (OK). + + If a cache receives a 5xx response while attempting to revalidate an + entry, it MAY either forward this response to the requesting client, + or act as if the server failed to respond. In the latter case, it MAY + return a previously received response unless the cached entry + includes the "must-revalidate" cache-control directive (see section + 14.9). + +13.9 Side Effects of GET and HEAD + + Unless the origin server explicitly prohibits the caching of their + responses, the application of GET and HEAD methods to any resources + SHOULD NOT have side effects that would lead to erroneous behavior if + these responses are taken from a cache. They MAY still have side + effects, but a cache is not required to consider such side effects in + its caching decisions. Caches are always expected to observe an + origin server's explicit restrictions on caching. + + We note one exception to this rule: since some applications have + traditionally used GETs and HEADs with query URLs (those containing a + "?" in the rel_path part) to perform operations with significant side + effects, caches MUST NOT treat responses to such URIs as fresh unless + the server provides an explicit expiration time. This specifically + means that responses from HTTP/1.0 servers for such URIs SHOULD NOT + be taken from a cache. See section 9.1.1 for related information. + +13.10 Invalidation After Updates or Deletions + + The effect of certain methods performed on a resource at the origin + server might cause one or more existing cache entries to become non- + transparently invalid. That is, although they might continue to be + "fresh," they do not accurately reflect what the origin server would + return for a new request on that resource. + + + +Fielding, et al. Standards Track [Page 97] + +RFC 2616 HTTP/1.1 June 1999 + + + There is no way for the HTTP protocol to guarantee that all such + cache entries are marked invalid. For example, the request that + caused the change at the origin server might not have gone through + the proxy where a cache entry is stored. However, several rules help + reduce the likelihood of erroneous behavior. + + In this section, the phrase "invalidate an entity" means that the + cache will either remove all instances of that entity from its + storage, or will mark these as "invalid" and in need of a mandatory + revalidation before they can be returned in response to a subsequent + request. + + Some HTTP methods MUST cause a cache to invalidate an entity. This is + either the entity referred to by the Request-URI, or by the Location + or Content-Location headers (if present). These methods are: + + - PUT + + - DELETE + + - POST + + In order to prevent denial of service attacks, an invalidation based + on the URI in a Location or Content-Location header MUST only be + performed if the host part is the same as in the Request-URI. + + A cache that passes through requests for methods it does not + understand SHOULD invalidate any entities referred to by the + Request-URI. + +13.11 Write-Through Mandatory + + All methods that might be expected to cause modifications to the + origin server's resources MUST be written through to the origin + server. This currently includes all methods except for GET and HEAD. + A cache MUST NOT reply to such a request from a client before having + transmitted the request to the inbound server, and having received a + corresponding response from the inbound server. This does not prevent + a proxy cache from sending a 100 (Continue) response before the + inbound server has sent its final reply. + + The alternative (known as "write-back" or "copy-back" caching) is not + allowed in HTTP/1.1, due to the difficulty of providing consistent + updates and the problems arising from server, cache, or network + failure prior to write-back. + + + + + + +Fielding, et al. Standards Track [Page 98] + +RFC 2616 HTTP/1.1 June 1999 + + +13.12 Cache Replacement + + If a new cacheable (see sections 14.9.2, 13.2.5, 13.2.6 and 13.8) + response is received from a resource while any existing responses for + the same resource are cached, the cache SHOULD use the new response + to reply to the current request. It MAY insert it into cache storage + and MAY, if it meets all other requirements, use it to respond to any + future requests that would previously have caused the old response to + be returned. If it inserts the new response into cache storage the + rules in section 13.5.3 apply. + + Note: a new response that has an older Date header value than + existing cached responses is not cacheable. + +13.13 History Lists + + User agents often have history mechanisms, such as "Back" buttons and + history lists, which can be used to redisplay an entity retrieved + earlier in a session. + + History mechanisms and caches are different. In particular history + mechanisms SHOULD NOT try to show a semantically transparent view of + the current state of a resource. Rather, a history mechanism is meant + to show exactly what the user saw at the time when the resource was + retrieved. + + By default, an expiration time does not apply to history mechanisms. + If the entity is still in storage, a history mechanism SHOULD display + it even if the entity has expired, unless the user has specifically + configured the agent to refresh expired history documents. + + This is not to be construed to prohibit the history mechanism from + telling the user that a view might be stale. + + Note: if history list mechanisms unnecessarily prevent users from + viewing stale resources, this will tend to force service authors + to avoid using HTTP expiration controls and cache controls when + they would otherwise like to. Service authors may consider it + important that users not be presented with error messages or + warning messages when they use navigation controls (such as BACK) + to view previously fetched resources. Even though sometimes such + resources ought not to cached, or ought to expire quickly, user + interface considerations may force service authors to resort to + other means of preventing caching (e.g. "once-only" URLs) in order + not to suffer the effects of improperly functioning history + mechanisms. + + + + + +Fielding, et al. Standards Track [Page 99] + +RFC 2616 HTTP/1.1 June 1999 + + +14 Header Field Definitions + + This section defines the syntax and semantics of all standard + HTTP/1.1 header fields. For entity-header fields, both sender and + recipient refer to either the client or the server, depending on who + sends and who receives the entity. + +14.1 Accept + + The Accept request-header field can be used to specify certain media + types which are acceptable for the response. Accept headers can be + used to indicate that the request is specifically limited to a small + set of desired types, as in the case of a request for an in-line + image. + + Accept = "Accept" ":" + #( media-range [ accept-params ] ) + + media-range = ( "*/*" + | ( type "/" "*" ) + | ( type "/" subtype ) + ) *( ";" parameter ) + accept-params = ";" "q" "=" qvalue *( accept-extension ) + accept-extension = ";" token [ "=" ( token | quoted-string ) ] + + The asterisk "*" character is used to group media types into ranges, + with "*/*" indicating all media types and "type/*" indicating all + subtypes of that type. The media-range MAY include media type + parameters that are applicable to that range. + + Each media-range MAY be followed by one or more accept-params, + beginning with the "q" parameter for indicating a relative quality + factor. The first "q" parameter (if any) separates the media-range + parameter(s) from the accept-params. Quality factors allow the user + or user agent to indicate the relative degree of preference for that + media-range, using the qvalue scale from 0 to 1 (section 3.9). The + default value is q=1. + + Note: Use of the "q" parameter name to separate media type + parameters from Accept extension parameters is due to historical + practice. Although this prevents any media type parameter named + "q" from being used with a media range, such an event is believed + to be unlikely given the lack of any "q" parameters in the IANA + media type registry and the rare usage of any media type + parameters in Accept. Future media types are discouraged from + registering any parameter named "q". + + + + + +Fielding, et al. Standards Track [Page 100] + +RFC 2616 HTTP/1.1 June 1999 + + + The example + + Accept: audio/*; q=0.2, audio/basic + + SHOULD be interpreted as "I prefer audio/basic, but send me any audio + type if it is the best available after an 80% mark-down in quality." + + If no Accept header field is present, then it is assumed that the + client accepts all media types. If an Accept header field is present, + and if the server cannot send a response which is acceptable + according to the combined Accept field value, then the server SHOULD + send a 406 (not acceptable) response. + + A more elaborate example is + + Accept: text/plain; q=0.5, text/html, + text/x-dvi; q=0.8, text/x-c + + Verbally, this would be interpreted as "text/html and text/x-c are + the preferred media types, but if they do not exist, then send the + text/x-dvi entity, and if that does not exist, send the text/plain + entity." + + Media ranges can be overridden by more specific media ranges or + specific media types. If more than one media range applies to a given + type, the most specific reference has precedence. For example, + + Accept: text/*, text/html, text/html;level=1, */* + + have the following precedence: + + 1) text/html;level=1 + 2) text/html + 3) text/* + 4) */* + + The media type quality factor associated with a given type is + determined by finding the media range with the highest precedence + which matches that type. For example, + + Accept: text/*;q=0.3, text/html;q=0.7, text/html;level=1, + text/html;level=2;q=0.4, */*;q=0.5 + + would cause the following values to be associated: + + text/html;level=1 = 1 + text/html = 0.7 + text/plain = 0.3 + + + +Fielding, et al. Standards Track [Page 101] + +RFC 2616 HTTP/1.1 June 1999 + + + image/jpeg = 0.5 + text/html;level=2 = 0.4 + text/html;level=3 = 0.7 + + Note: A user agent might be provided with a default set of quality + values for certain media ranges. However, unless the user agent is + a closed system which cannot interact with other rendering agents, + this default set ought to be configurable by the user. + +14.2 Accept-Charset + + The Accept-Charset request-header field can be used to indicate what + character sets are acceptable for the response. This field allows + clients capable of understanding more comprehensive or special- + purpose character sets to signal that capability to a server which is + capable of representing documents in those character sets. + + Accept-Charset = "Accept-Charset" ":" + 1#( ( charset | "*" )[ ";" "q" "=" qvalue ] ) + + + Character set values are described in section 3.4. Each charset MAY + be given an associated quality value which represents the user's + preference for that charset. The default value is q=1. An example is + + Accept-Charset: iso-8859-5, unicode-1-1;q=0.8 + + The special value "*", if present in the Accept-Charset field, + matches every character set (including ISO-8859-1) which is not + mentioned elsewhere in the Accept-Charset field. If no "*" is present + in an Accept-Charset field, then all character sets not explicitly + mentioned get a quality value of 0, except for ISO-8859-1, which gets + a quality value of 1 if not explicitly mentioned. + + If no Accept-Charset header is present, the default is that any + character set is acceptable. If an Accept-Charset header is present, + and if the server cannot send a response which is acceptable + according to the Accept-Charset header, then the server SHOULD send + an error response with the 406 (not acceptable) status code, though + the sending of an unacceptable response is also allowed. + +14.3 Accept-Encoding + + The Accept-Encoding request-header field is similar to Accept, but + restricts the content-codings (section 3.5) that are acceptable in + the response. + + Accept-Encoding = "Accept-Encoding" ":" + + + +Fielding, et al. Standards Track [Page 102] + +RFC 2616 HTTP/1.1 June 1999 + + + 1#( codings [ ";" "q" "=" qvalue ] ) + codings = ( content-coding | "*" ) + + Examples of its use are: + + Accept-Encoding: compress, gzip + Accept-Encoding: + Accept-Encoding: * + Accept-Encoding: compress;q=0.5, gzip;q=1.0 + Accept-Encoding: gzip;q=1.0, identity; q=0.5, *;q=0 + + A server tests whether a content-coding is acceptable, according to + an Accept-Encoding field, using these rules: + + 1. If the content-coding is one of the content-codings listed in + the Accept-Encoding field, then it is acceptable, unless it is + accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + 2. The special "*" symbol in an Accept-Encoding field matches any + available content-coding not explicitly listed in the header + field. + + 3. If multiple content-codings are acceptable, then the acceptable + content-coding with the highest non-zero qvalue is preferred. + + 4. The "identity" content-coding is always acceptable, unless + specifically refused because the Accept-Encoding field includes + "identity;q=0", or because the field includes "*;q=0" and does + not explicitly include the "identity" content-coding. If the + Accept-Encoding field-value is empty, then only the "identity" + encoding is acceptable. + + If an Accept-Encoding field is present in a request, and if the + server cannot send a response which is acceptable according to the + Accept-Encoding header, then the server SHOULD send an error response + with the 406 (Not Acceptable) status code. + + If no Accept-Encoding field is present in a request, the server MAY + assume that the client will accept any content coding. In this case, + if "identity" is one of the available content-codings, then the + server SHOULD use the "identity" content-coding, unless it has + additional information that a different content-coding is meaningful + to the client. + + Note: If the request does not include an Accept-Encoding field, + and if the "identity" content-coding is unavailable, then + content-codings commonly understood by HTTP/1.0 clients (i.e., + + + +Fielding, et al. Standards Track [Page 103] + +RFC 2616 HTTP/1.1 June 1999 + + + "gzip" and "compress") are preferred; some older clients + improperly display messages sent with other content-codings. The + server might also make this decision based on information about + the particular user-agent or client. + + Note: Most HTTP/1.0 applications do not recognize or obey qvalues + associated with content-codings. This means that qvalues will not + work and are not permitted with x-gzip or x-compress. + +14.4 Accept-Language + + The Accept-Language request-header field is similar to Accept, but + restricts the set of natural languages that are preferred as a + response to the request. Language tags are defined in section 3.10. + + Accept-Language = "Accept-Language" ":" + 1#( language-range [ ";" "q" "=" qvalue ] ) + language-range = ( ( 1*8ALPHA *( "-" 1*8ALPHA ) ) | "*" ) + + Each language-range MAY be given an associated quality value which + represents an estimate of the user's preference for the languages + specified by that range. The quality value defaults to "q=1". For + example, + + Accept-Language: da, en-gb;q=0.8, en;q=0.7 + + would mean: "I prefer Danish, but will accept British English and + other types of English." A language-range matches a language-tag if + it exactly equals the tag, or if it exactly equals a prefix of the + tag such that the first tag character following the prefix is "-". + The special range "*", if present in the Accept-Language field, + matches every tag not matched by any other range present in the + Accept-Language field. + + Note: This use of a prefix matching rule does not imply that + language tags are assigned to languages in such a way that it is + always true that if a user understands a language with a certain + tag, then this user will also understand all languages with tags + for which this tag is a prefix. The prefix rule simply allows the + use of prefix tags if this is the case. + + The language quality factor assigned to a language-tag by the + Accept-Language field is the quality value of the longest language- + range in the field that matches the language-tag. If no language- + range in the field matches the tag, the language quality factor + assigned is 0. If no Accept-Language header is present in the + request, the server + + + + +Fielding, et al. Standards Track [Page 104] + +RFC 2616 HTTP/1.1 June 1999 + + + SHOULD assume that all languages are equally acceptable. If an + Accept-Language header is present, then all languages which are + assigned a quality factor greater than 0 are acceptable. + + It might be contrary to the privacy expectations of the user to send + an Accept-Language header with the complete linguistic preferences of + the user in every request. For a discussion of this issue, see + section 15.1.4. + + As intelligibility is highly dependent on the individual user, it is + recommended that client applications make the choice of linguistic + preference available to the user. If the choice is not made + available, then the Accept-Language header field MUST NOT be given in + the request. + + Note: When making the choice of linguistic preference available to + the user, we remind implementors of the fact that users are not + familiar with the details of language matching as described above, + and should provide appropriate guidance. As an example, users + might assume that on selecting "en-gb", they will be served any + kind of English document if British English is not available. A + user agent might suggest in such a case to add "en" to get the + best matching behavior. + +14.5 Accept-Ranges + + The Accept-Ranges response-header field allows the server to + indicate its acceptance of range requests for a resource: + + Accept-Ranges = "Accept-Ranges" ":" acceptable-ranges + acceptable-ranges = 1#range-unit | "none" + + Origin servers that accept byte-range requests MAY send + + Accept-Ranges: bytes + + but are not required to do so. Clients MAY generate byte-range + requests without having received this header for the resource + involved. Range units are defined in section 3.12. + + Servers that do not accept any kind of range request for a + resource MAY send + + Accept-Ranges: none + + to advise the client not to attempt a range request. + + + + + +Fielding, et al. Standards Track [Page 105] + +RFC 2616 HTTP/1.1 June 1999 + + +14.6 Age + + The Age response-header field conveys the sender's estimate of the + amount of time since the response (or its revalidation) was + generated at the origin server. A cached response is "fresh" if + its age does not exceed its freshness lifetime. Age values are + calculated as specified in section 13.2.3. + + Age = "Age" ":" age-value + age-value = delta-seconds + + Age values are non-negative decimal integers, representing time in + seconds. + + If a cache receives a value larger than the largest positive + integer it can represent, or if any of its age calculations + overflows, it MUST transmit an Age header with a value of + 2147483648 (2^31). An HTTP/1.1 server that includes a cache MUST + include an Age header field in every response generated from its + own cache. Caches SHOULD use an arithmetic type of at least 31 + bits of range. + +14.7 Allow + + The Allow entity-header field lists the set of methods supported + by the resource identified by the Request-URI. The purpose of this + field is strictly to inform the recipient of valid methods + associated with the resource. An Allow header field MUST be + present in a 405 (Method Not Allowed) response. + + Allow = "Allow" ":" #Method + + Example of use: + + Allow: GET, HEAD, PUT + + This field cannot prevent a client from trying other methods. + However, the indications given by the Allow header field value + SHOULD be followed. The actual set of allowed methods is defined + by the origin server at the time of each request. + + The Allow header field MAY be provided with a PUT request to + recommend the methods to be supported by the new or modified + resource. The server is not required to support these methods and + SHOULD include an Allow header in the response giving the actual + supported methods. + + + + + +Fielding, et al. Standards Track [Page 106] + +RFC 2616 HTTP/1.1 June 1999 + + + A proxy MUST NOT modify the Allow header field even if it does not + understand all the methods specified, since the user agent might + have other means of communicating with the origin server. + +14.8 Authorization + + A user agent that wishes to authenticate itself with a server-- + usually, but not necessarily, after receiving a 401 response--does + so by including an Authorization request-header field with the + request. The Authorization field value consists of credentials + containing the authentication information of the user agent for + the realm of the resource being requested. + + Authorization = "Authorization" ":" credentials + + HTTP access authentication is described in "HTTP Authentication: + Basic and Digest Access Authentication" [43]. If a request is + authenticated and a realm specified, the same credentials SHOULD + be valid for all other requests within this realm (assuming that + the authentication scheme itself does not require otherwise, such + as credentials that vary according to a challenge value or using + synchronized clocks). + + When a shared cache (see section 13.7) receives a request + containing an Authorization field, it MUST NOT return the + corresponding response as a reply to any other request, unless one + of the following specific exceptions holds: + + 1. If the response includes the "s-maxage" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But (if the specified maximum age has + passed) a proxy cache MUST first revalidate it with the origin + server, using the request-headers from the new request to allow + the origin server to authenticate the new request. (This is the + defined behavior for s-maxage.) If the response includes "s- + maxage=0", the proxy MUST always revalidate it before re-using + it. + + 2. If the response includes the "must-revalidate" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But if the response is stale, all caches + MUST first revalidate it with the origin server, using the + request-headers from the new request to allow the origin server + to authenticate the new request. + + 3. If the response includes the "public" cache-control directive, + it MAY be returned in reply to any subsequent request. + + + + +Fielding, et al. Standards Track [Page 107] + +RFC 2616 HTTP/1.1 June 1999 + + +14.9 Cache-Control + + The Cache-Control general-header field is used to specify directives + that MUST be obeyed by all caching mechanisms along the + request/response chain. The directives specify behavior intended to + prevent caches from adversely interfering with the request or + response. These directives typically override the default caching + algorithms. Cache directives are unidirectional in that the presence + of a directive in a request does not imply that the same directive is + to be given in the response. + + Note that HTTP/1.0 caches might not implement Cache-Control and + might only implement Pragma: no-cache (see section 14.32). + + Cache directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a cache- + directive for a specific cache. + + Cache-Control = "Cache-Control" ":" 1#cache-directive + + cache-directive = cache-request-directive + | cache-response-directive + + cache-request-directive = + "no-cache" ; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "max-age" "=" delta-seconds ; Section 14.9.3, 14.9.4 + | "max-stale" [ "=" delta-seconds ] ; Section 14.9.3 + | "min-fresh" "=" delta-seconds ; Section 14.9.3 + | "no-transform" ; Section 14.9.5 + | "only-if-cached" ; Section 14.9.4 + | cache-extension ; Section 14.9.6 + + cache-response-directive = + "public" ; Section 14.9.1 + | "private" [ "=" <"> 1#field-name <"> ] ; Section 14.9.1 + | "no-cache" [ "=" <"> 1#field-name <"> ]; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "no-transform" ; Section 14.9.5 + | "must-revalidate" ; Section 14.9.4 + | "proxy-revalidate" ; Section 14.9.4 + | "max-age" "=" delta-seconds ; Section 14.9.3 + | "s-maxage" "=" delta-seconds ; Section 14.9.3 + | cache-extension ; Section 14.9.6 + + cache-extension = token [ "=" ( token | quoted-string ) ] + + + +Fielding, et al. Standards Track [Page 108] + +RFC 2616 HTTP/1.1 June 1999 + + + When a directive appears without any 1#field-name parameter, the + directive applies to the entire request or response. When such a + directive appears with a 1#field-name parameter, it applies only to + the named field or fields, and not to the rest of the request or + response. This mechanism supports extensibility; implementations of + future versions of the HTTP protocol might apply these directives to + header fields not defined in HTTP/1.1. + + The cache-control directives can be broken down into these general + categories: + + - Restrictions on what are cacheable; these may only be imposed by + the origin server. + + - Restrictions on what may be stored by a cache; these may be + imposed by either the origin server or the user agent. + + - Modifications of the basic expiration mechanism; these may be + imposed by either the origin server or the user agent. + + - Controls over cache revalidation and reload; these may only be + imposed by a user agent. + + - Control over transformation of entities. + + - Extensions to the caching system. + +14.9.1 What is Cacheable + + By default, a response is cacheable if the requirements of the + request method, request header fields, and the response status + indicate that it is cacheable. Section 13.4 summarizes these defaults + for cacheability. The following Cache-Control response directives + allow an origin server to override the default cacheability of a + response: + + public + Indicates that the response MAY be cached by any cache, even if it + would normally be non-cacheable or cacheable only within a non- + shared cache. (See also Authorization, section 14.8, for + additional details.) + + private + Indicates that all or part of the response message is intended for + a single user and MUST NOT be cached by a shared cache. This + allows an origin server to state that the specified parts of the + + + + + +Fielding, et al. Standards Track [Page 109] + +RFC 2616 HTTP/1.1 June 1999 + + + response are intended for only one user and are not a valid + response for requests by other users. A private (non-shared) cache + MAY cache the response. + + Note: This usage of the word private only controls where the + response may be cached, and cannot ensure the privacy of the + message content. + + no-cache + If the no-cache directive does not specify a field-name, then a + cache MUST NOT use the response to satisfy a subsequent request + without successful revalidation with the origin server. This + allows an origin server to prevent caching even by caches that + have been configured to return stale responses to client requests. + + If the no-cache directive does specify one or more field-names, + then a cache MAY use the response to satisfy a subsequent request, + subject to any other restrictions on caching. However, the + specified field-name(s) MUST NOT be sent in the response to a + subsequent request without successful revalidation with the origin + server. This allows an origin server to prevent the re-use of + certain header fields in a response, while still allowing caching + of the rest of the response. + + Note: Most HTTP/1.0 caches will not recognize or obey this + directive. + +14.9.2 What May be Stored by Caches + + no-store + The purpose of the no-store directive is to prevent the + inadvertent release or retention of sensitive information (for + example, on backup tapes). The no-store directive applies to the + entire message, and MAY be sent either in a response or in a + request. If sent in a request, a cache MUST NOT store any part of + either this request or any response to it. If sent in a response, + a cache MUST NOT store any part of either this response or the + request that elicited it. This directive applies to both non- + shared and shared caches. "MUST NOT store" in this context means + that the cache MUST NOT intentionally store the information in + non-volatile storage, and MUST make a best-effort attempt to + remove the information from volatile storage as promptly as + possible after forwarding it. + + Even when this directive is associated with a response, users + might explicitly store such a response outside of the caching + system (e.g., with a "Save As" dialog). History buffers MAY store + such responses as part of their normal operation. + + + +Fielding, et al. Standards Track [Page 110] + +RFC 2616 HTTP/1.1 June 1999 + + + The purpose of this directive is to meet the stated requirements + of certain users and service authors who are concerned about + accidental releases of information via unanticipated accesses to + cache data structures. While the use of this directive might + improve privacy in some cases, we caution that it is NOT in any + way a reliable or sufficient mechanism for ensuring privacy. In + particular, malicious or compromised caches might not recognize or + obey this directive, and communications networks might be + vulnerable to eavesdropping. + +14.9.3 Modifications of the Basic Expiration Mechanism + + The expiration time of an entity MAY be specified by the origin + server using the Expires header (see section 14.21). Alternatively, + it MAY be specified using the max-age directive in a response. When + the max-age cache-control directive is present in a cached response, + the response is stale if its current age is greater than the age + value given (in seconds) at the time of a new request for that + resource. The max-age directive on a response implies that the + response is cacheable (i.e., "public") unless some other, more + restrictive cache directive is also present. + + If a response includes both an Expires header and a max-age + directive, the max-age directive overrides the Expires header, even + if the Expires header is more restrictive. This rule allows an origin + server to provide, for a given response, a longer expiration time to + an HTTP/1.1 (or later) cache than to an HTTP/1.0 cache. This might be + useful if certain HTTP/1.0 caches improperly calculate ages or + expiration times, perhaps due to desynchronized clocks. + + Many HTTP/1.0 cache implementations will treat an Expires value that + is less than or equal to the response Date value as being equivalent + to the Cache-Control response directive "no-cache". If an HTTP/1.1 + cache receives such a response, and the response does not include a + Cache-Control header field, it SHOULD consider the response to be + non-cacheable in order to retain compatibility with HTTP/1.0 servers. + + Note: An origin server might wish to use a relatively new HTTP + cache control feature, such as the "private" directive, on a + network including older caches that do not understand that + feature. The origin server will need to combine the new feature + with an Expires field whose value is less than or equal to the + Date value. This will prevent older caches from improperly + caching the response. + + + + + + + +Fielding, et al. Standards Track [Page 111] + +RFC 2616 HTTP/1.1 June 1999 + + + s-maxage + If a response includes an s-maxage directive, then for a shared + cache (but not for a private cache), the maximum age specified by + this directive overrides the maximum age specified by either the + max-age directive or the Expires header. The s-maxage directive + also implies the semantics of the proxy-revalidate directive (see + section 14.9.4), i.e., that the shared cache must not use the + entry after it becomes stale to respond to a subsequent request + without first revalidating it with the origin server. The s- + maxage directive is always ignored by a private cache. + + Note that most older caches, not compliant with this specification, + do not implement any cache-control directives. An origin server + wishing to use a cache-control directive that restricts, but does not + prevent, caching by an HTTP/1.1-compliant cache MAY exploit the + requirement that the max-age directive overrides the Expires header, + and the fact that pre-HTTP/1.1-compliant caches do not observe the + max-age directive. + + Other directives allow a user agent to modify the basic expiration + mechanism. These directives MAY be specified on a request: + + max-age + Indicates that the client is willing to accept a response whose + age is no greater than the specified time in seconds. Unless max- + stale directive is also included, the client is not willing to + accept a stale response. + + min-fresh + Indicates that the client is willing to accept a response whose + freshness lifetime is no less than its current age plus the + specified time in seconds. That is, the client wants a response + that will still be fresh for at least the specified number of + seconds. + + max-stale + Indicates that the client is willing to accept a response that has + exceeded its expiration time. If max-stale is assigned a value, + then the client is willing to accept a response that has exceeded + its expiration time by no more than the specified number of + seconds. If no value is assigned to max-stale, then the client is + willing to accept a stale response of any age. + + If a cache returns a stale response, either because of a max-stale + directive on a request, or because the cache is configured to + override the expiration time of a response, the cache MUST attach a + Warning header to the stale response, using Warning 110 (Response is + stale). + + + +Fielding, et al. Standards Track [Page 112] + +RFC 2616 HTTP/1.1 June 1999 + + + A cache MAY be configured to return stale responses without + validation, but only if this does not conflict with any "MUST"-level + requirements concerning cache validation (e.g., a "must-revalidate" + cache-control directive). + + If both the new request and the cached entry include "max-age" + directives, then the lesser of the two values is used for determining + the freshness of the cached entry for that request. + +14.9.4 Cache Revalidation and Reload Controls + + Sometimes a user agent might want or need to insist that a cache + revalidate its cache entry with the origin server (and not just with + the next cache along the path to the origin server), or to reload its + cache entry from the origin server. End-to-end revalidation might be + necessary if either the cache or the origin server has overestimated + the expiration time of the cached response. End-to-end reload may be + necessary if the cache entry has become corrupted for some reason. + + End-to-end revalidation may be requested either when the client does + not have its own local cached copy, in which case we call it + "unspecified end-to-end revalidation", or when the client does have a + local cached copy, in which case we call it "specific end-to-end + revalidation." + + The client can specify these three kinds of action using Cache- + Control request directives: + + End-to-end reload + The request includes a "no-cache" cache-control directive or, for + compatibility with HTTP/1.0 clients, "Pragma: no-cache". Field + names MUST NOT be included with the no-cache directive in a + request. The server MUST NOT use a cached copy when responding to + such a request. + + Specific end-to-end revalidation + The request includes a "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request includes a cache-validating conditional with + the client's current validator. + + Unspecified end-to-end revalidation + The request includes "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request does not include a cache-validating + + + + +Fielding, et al. Standards Track [Page 113] + +RFC 2616 HTTP/1.1 June 1999 + + + conditional; the first cache along the path (if any) that holds a + cache entry for this resource includes a cache-validating + conditional with its current validator. + + max-age + When an intermediate cache is forced, by means of a max-age=0 + directive, to revalidate its own cache entry, and the client has + supplied its own validator in the request, the supplied validator + might differ from the validator currently stored with the cache + entry. In this case, the cache MAY use either validator in making + its own request without affecting semantic transparency. + + However, the choice of validator might affect performance. The + best approach is for the intermediate cache to use its own + validator when making its request. If the server replies with 304 + (Not Modified), then the cache can return its now validated copy + to the client with a 200 (OK) response. If the server replies with + a new entity and cache validator, however, the intermediate cache + can compare the returned validator with the one provided in the + client's request, using the strong comparison function. If the + client's validator is equal to the origin server's, then the + intermediate cache simply returns 304 (Not Modified). Otherwise, + it returns the new entity with a 200 (OK) response. + + If a request includes the no-cache directive, it SHOULD NOT + include min-fresh, max-stale, or max-age. + + only-if-cached + In some cases, such as times of extremely poor network + connectivity, a client may want a cache to return only those + responses that it currently has stored, and not to reload or + revalidate with the origin server. To do this, the client may + include the only-if-cached directive in a request. If it receives + this directive, a cache SHOULD either respond using a cached entry + that is consistent with the other constraints of the request, or + respond with a 504 (Gateway Timeout) status. However, if a group + of caches is being operated as a unified system with good internal + connectivity, such a request MAY be forwarded within that group of + caches. + + must-revalidate + Because a cache MAY be configured to ignore a server's specified + expiration time, and because a client request MAY include a max- + stale directive (which has a similar effect), the protocol also + includes a mechanism for the origin server to require revalidation + of a cache entry on any subsequent use. When the must-revalidate + directive is present in a response received by a cache, that cache + MUST NOT use the entry after it becomes stale to respond to a + + + +Fielding, et al. Standards Track [Page 114] + +RFC 2616 HTTP/1.1 June 1999 + + + subsequent request without first revalidating it with the origin + server. (I.e., the cache MUST do an end-to-end revalidation every + time, if, based solely on the origin server's Expires or max-age + value, the cached response is stale.) + + The must-revalidate directive is necessary to support reliable + operation for certain protocol features. In all circumstances an + HTTP/1.1 cache MUST obey the must-revalidate directive; in + particular, if the cache cannot reach the origin server for any + reason, it MUST generate a 504 (Gateway Timeout) response. + + Servers SHOULD send the must-revalidate directive if and only if + failure to revalidate a request on the entity could result in + incorrect operation, such as a silently unexecuted financial + transaction. Recipients MUST NOT take any automated action that + violates this directive, and MUST NOT automatically provide an + unvalidated copy of the entity if revalidation fails. + + Although this is not recommended, user agents operating under + severe connectivity constraints MAY violate this directive but, if + so, MUST explicitly warn the user that an unvalidated response has + been provided. The warning MUST be provided on each unvalidated + access, and SHOULD require explicit user confirmation. + + proxy-revalidate + The proxy-revalidate directive has the same meaning as the must- + revalidate directive, except that it does not apply to non-shared + user agent caches. It can be used on a response to an + authenticated request to permit the user's cache to store and + later return the response without needing to revalidate it (since + it has already been authenticated once by that user), while still + requiring proxies that service many users to revalidate each time + (in order to make sure that each user has been authenticated). + Note that such authenticated responses also need the public cache + control directive in order to allow them to be cached at all. + +14.9.5 No-Transform Directive + + no-transform + Implementors of intermediate caches (proxies) have found it useful + to convert the media type of certain entity bodies. A non- + transparent proxy might, for example, convert between image + formats in order to save cache space or to reduce the amount of + traffic on a slow link. + + Serious operational problems occur, however, when these + transformations are applied to entity bodies intended for certain + kinds of applications. For example, applications for medical + + + +Fielding, et al. Standards Track [Page 115] + +RFC 2616 HTTP/1.1 June 1999 + + + imaging, scientific data analysis and those using end-to-end + authentication, all depend on receiving an entity body that is bit + for bit identical to the original entity-body. + + Therefore, if a message includes the no-transform directive, an + intermediate cache or proxy MUST NOT change those headers that are + listed in section 13.5.2 as being subject to the no-transform + directive. This implies that the cache or proxy MUST NOT change + any aspect of the entity-body that is specified by these headers, + including the value of the entity-body itself. + +14.9.6 Cache Control Extensions + + The Cache-Control header field can be extended through the use of one + or more cache-extension tokens, each with an optional assigned value. + Informational extensions (those which do not require a change in + cache behavior) MAY be added without changing the semantics of other + directives. Behavioral extensions are designed to work by acting as + modifiers to the existing base of cache directives. Both the new + directive and the standard directive are supplied, such that + applications which do not understand the new directive will default + to the behavior specified by the standard directive, and those that + understand the new directive will recognize it as modifying the + requirements associated with the standard directive. In this way, + extensions to the cache-control directives can be made without + requiring changes to the base protocol. + + This extension mechanism depends on an HTTP cache obeying all of the + cache-control directives defined for its native HTTP-version, obeying + certain extensions, and ignoring all directives that it does not + understand. + + For example, consider a hypothetical new response directive called + community which acts as a modifier to the private directive. We + define this new directive to mean that, in addition to any non-shared + cache, any cache which is shared only by members of the community + named within its value may cache the response. An origin server + wishing to allow the UCI community to use an otherwise private + response in their shared cache(s) could do so by including + + Cache-Control: private, community="UCI" + + A cache seeing this header field will act correctly even if the cache + does not understand the community cache-extension, since it will also + see and understand the private directive and thus default to the safe + behavior. + + + + + +Fielding, et al. Standards Track [Page 116] + +RFC 2616 HTTP/1.1 June 1999 + + + Unrecognized cache-directives MUST be ignored; it is assumed that any + cache-directive likely to be unrecognized by an HTTP/1.1 cache will + be combined with standard directives (or the response's default + cacheability) such that the cache behavior will remain minimally + correct even if the cache does not understand the extension(s). + +14.10 Connection + + The Connection general-header field allows the sender to specify + options that are desired for that particular connection and MUST NOT + be communicated by proxies over further connections. + + The Connection header has the following grammar: + + Connection = "Connection" ":" 1#(connection-token) + connection-token = token + + HTTP/1.1 proxies MUST parse the Connection header field before a + message is forwarded and, for each connection-token in this field, + remove any header field(s) from the message with the same name as the + connection-token. Connection options are signaled by the presence of + a connection-token in the Connection header field, not by any + corresponding additional header field(s), since the additional header + field may not be sent if there are no parameters associated with that + connection option. + + Message headers listed in the Connection header MUST NOT include + end-to-end headers, such as Cache-Control. + + HTTP/1.1 defines the "close" connection option for the sender to + signal that the connection will be closed after completion of the + response. For example, + + Connection: close + + in either the request or the response header fields indicates that + the connection SHOULD NOT be considered `persistent' (section 8.1) + after the current request/response is complete. + + HTTP/1.1 applications that do not support persistent connections MUST + include the "close" connection option in every message. + + A system receiving an HTTP/1.0 (or lower-version) message that + includes a Connection header MUST, for each connection-token in this + field, remove and ignore any header field(s) from the message with + the same name as the connection-token. This protects against mistaken + forwarding of such header fields by pre-HTTP/1.1 proxies. See section + 19.6.2. + + + +Fielding, et al. Standards Track [Page 117] + +RFC 2616 HTTP/1.1 June 1999 + + +14.11 Content-Encoding + + The Content-Encoding entity-header field is used as a modifier to the + media-type. When present, its value indicates what additional content + codings have been applied to the entity-body, and thus what decoding + mechanisms must be applied in order to obtain the media-type + referenced by the Content-Type header field. Content-Encoding is + primarily used to allow a document to be compressed without losing + the identity of its underlying media type. + + Content-Encoding = "Content-Encoding" ":" 1#content-coding + + Content codings are defined in section 3.5. An example of its use is + + Content-Encoding: gzip + + The content-coding is a characteristic of the entity identified by + the Request-URI. Typically, the entity-body is stored with this + encoding and is only decoded before rendering or analogous usage. + However, a non-transparent proxy MAY modify the content-coding if the + new coding is known to be acceptable to the recipient, unless the + "no-transform" cache-control directive is present in the message. + + If the content-coding of an entity is not "identity", then the + response MUST include a Content-Encoding entity-header (section + 14.11) that lists the non-identity content-coding(s) used. + + If the content-coding of an entity in a request message is not + acceptable to the origin server, the server SHOULD respond with a + status code of 415 (Unsupported Media Type). + + If multiple encodings have been applied to an entity, the content + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + +14.12 Content-Language + + The Content-Language entity-header field describes the natural + language(s) of the intended audience for the enclosed entity. Note + that this might not be equivalent to all the languages used within + the entity-body. + + Content-Language = "Content-Language" ":" 1#language-tag + + + + + + + +Fielding, et al. Standards Track [Page 118] + +RFC 2616 HTTP/1.1 June 1999 + + + Language tags are defined in section 3.10. The primary purpose of + Content-Language is to allow a user to identify and differentiate + entities according to the user's own preferred language. Thus, if the + body content is intended only for a Danish-literate audience, the + appropriate field is + + Content-Language: da + + If no Content-Language is specified, the default is that the content + is intended for all language audiences. This might mean that the + sender does not consider it to be specific to any natural language, + or that the sender does not know for which language it is intended. + + Multiple languages MAY be listed for content that is intended for + multiple audiences. For example, a rendition of the "Treaty of + Waitangi," presented simultaneously in the original Maori and English + versions, would call for + + Content-Language: mi, en + + However, just because multiple languages are present within an entity + does not mean that it is intended for multiple linguistic audiences. + An example would be a beginner's language primer, such as "A First + Lesson in Latin," which is clearly intended to be used by an + English-literate audience. In this case, the Content-Language would + properly only include "en". + + Content-Language MAY be applied to any media type -- it is not + limited to textual documents. + +14.13 Content-Length + + The Content-Length entity-header field indicates the size of the + entity-body, in decimal number of OCTETs, sent to the recipient or, + in the case of the HEAD method, the size of the entity-body that + would have been sent had the request been a GET. + + Content-Length = "Content-Length" ":" 1*DIGIT + + An example is + + Content-Length: 3495 + + Applications SHOULD use this field to indicate the transfer-length of + the message-body, unless this is prohibited by the rules in section + 4.4. + + + + + +Fielding, et al. Standards Track [Page 119] + +RFC 2616 HTTP/1.1 June 1999 + + + Any Content-Length greater than or equal to zero is a valid value. + Section 4.4 describes how to determine the length of a message-body + if a Content-Length is not given. + + Note that the meaning of this field is significantly different from + the corresponding definition in MIME, where it is an optional field + used within the "message/external-body" content-type. In HTTP, it + SHOULD be sent whenever the message's length can be determined prior + to being transferred, unless this is prohibited by the rules in + section 4.4. + +14.14 Content-Location + + The Content-Location entity-header field MAY be used to supply the + resource location for the entity enclosed in the message when that + entity is accessible from a location separate from the requested + resource's URI. A server SHOULD provide a Content-Location for the + variant corresponding to the response entity; especially in the case + where a resource has multiple entities associated with it, and those + entities actually have separate locations by which they might be + individually accessed, the server SHOULD provide a Content-Location + for the particular variant which is returned. + + Content-Location = "Content-Location" ":" + ( absoluteURI | relativeURI ) + + The value of Content-Location also defines the base URI for the + entity. + + The Content-Location value is not a replacement for the original + requested URI; it is only a statement of the location of the resource + corresponding to this particular entity at the time of the request. + Future requests MAY specify the Content-Location URI as the request- + URI if the desire is to identify the source of that particular + entity. + + A cache cannot assume that an entity with a Content-Location + different from the URI used to retrieve it can be used to respond to + later requests on that Content-Location URI. However, the Content- + Location can be used to differentiate between multiple entities + retrieved from a single requested resource, as described in section + 13.6. + + If the Content-Location is a relative URI, the relative URI is + interpreted relative to the Request-URI. + + The meaning of the Content-Location header in PUT or POST requests is + undefined; servers are free to ignore it in those cases. + + + +Fielding, et al. Standards Track [Page 120] + +RFC 2616 HTTP/1.1 June 1999 + + +14.15 Content-MD5 + + The Content-MD5 entity-header field, as defined in RFC 1864 [23], is + an MD5 digest of the entity-body for the purpose of providing an + end-to-end message integrity check (MIC) of the entity-body. (Note: a + MIC is good for detecting accidental modification of the entity-body + in transit, but is not proof against malicious attacks.) + + Content-MD5 = "Content-MD5" ":" md5-digest + md5-digest = + + The Content-MD5 header field MAY be generated by an origin server or + client to function as an integrity check of the entity-body. Only + origin servers or clients MAY generate the Content-MD5 header field; + proxies and gateways MUST NOT generate it, as this would defeat its + value as an end-to-end integrity check. Any recipient of the entity- + body, including gateways and proxies, MAY check that the digest value + in this header field matches that of the entity-body as received. + + The MD5 digest is computed based on the content of the entity-body, + including any content-coding that has been applied, but not including + any transfer-encoding applied to the message-body. If the message is + received with a transfer-encoding, that encoding MUST be removed + prior to checking the Content-MD5 value against the received entity. + + This has the result that the digest is computed on the octets of the + entity-body exactly as, and in the order that, they would be sent if + no transfer-encoding were being applied. + + HTTP extends RFC 1864 to permit the digest to be computed for MIME + composite media-types (e.g., multipart/* and message/rfc822), but + this does not change how the digest is computed as defined in the + preceding paragraph. + + There are several consequences of this. The entity-body for composite + types MAY contain many body-parts, each with its own MIME and HTTP + headers (including Content-MD5, Content-Transfer-Encoding, and + Content-Encoding headers). If a body-part has a Content-Transfer- + Encoding or Content-Encoding header, it is assumed that the content + of the body-part has had the encoding applied, and the body-part is + included in the Content-MD5 digest as is -- i.e., after the + application. The Transfer-Encoding header field is not allowed within + body-parts. + + Conversion of all line breaks to CRLF MUST NOT be done before + computing or checking the digest: the line break convention used in + the text actually transmitted MUST be left unaltered when computing + the digest. + + + +Fielding, et al. Standards Track [Page 121] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: while the definition of Content-MD5 is exactly the same for + HTTP as in RFC 1864 for MIME entity-bodies, there are several ways + in which the application of Content-MD5 to HTTP entity-bodies + differs from its application to MIME entity-bodies. One is that + HTTP, unlike MIME, does not use Content-Transfer-Encoding, and + does use Transfer-Encoding and Content-Encoding. Another is that + HTTP more frequently uses binary content types than MIME, so it is + worth noting that, in such cases, the byte order used to compute + the digest is the transmission byte order defined for the type. + Lastly, HTTP allows transmission of text types with any of several + line break conventions and not just the canonical form using CRLF. + +14.16 Content-Range + + The Content-Range entity-header is sent with a partial entity-body to + specify where in the full entity-body the partial body should be + applied. Range units are defined in section 3.12. + + Content-Range = "Content-Range" ":" content-range-spec + + content-range-spec = byte-content-range-spec + byte-content-range-spec = bytes-unit SP + byte-range-resp-spec "/" + ( instance-length | "*" ) + + byte-range-resp-spec = (first-byte-pos "-" last-byte-pos) + | "*" + instance-length = 1*DIGIT + + The header SHOULD indicate the total length of the full entity-body, + unless this length is unknown or difficult to determine. The asterisk + "*" character means that the instance-length is unknown at the time + when the response was generated. + + Unlike byte-ranges-specifier values (see section 14.35.1), a byte- + range-resp-spec MUST only specify one range, and MUST contain + absolute byte positions for both the first and last byte of the + range. + + A byte-content-range-spec with a byte-range-resp-spec whose last- + byte-pos value is less than its first-byte-pos value, or whose + instance-length value is less than or equal to its last-byte-pos + value, is invalid. The recipient of an invalid byte-content-range- + spec MUST ignore it and any content transferred along with it. + + A server sending a response with status code 416 (Requested range not + satisfiable) SHOULD include a Content-Range field with a byte-range- + resp-spec of "*". The instance-length specifies the current length of + + + +Fielding, et al. Standards Track [Page 122] + +RFC 2616 HTTP/1.1 June 1999 + + + the selected resource. A response with status code 206 (Partial + Content) MUST NOT include a Content-Range field with a byte-range- + resp-spec of "*". + + Examples of byte-content-range-spec values, assuming that the entity + contains a total of 1234 bytes: + + . The first 500 bytes: + bytes 0-499/1234 + + . The second 500 bytes: + bytes 500-999/1234 + + . All except for the first 500 bytes: + bytes 500-1233/1234 + + . The last 500 bytes: + bytes 734-1233/1234 + + When an HTTP message includes the content of a single range (for + example, a response to a request for a single range, or to a request + for a set of ranges that overlap without any holes), this content is + transmitted with a Content-Range header, and a Content-Length header + showing the number of bytes actually transferred. For example, + + HTTP/1.1 206 Partial content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-Range: bytes 21010-47021/47022 + Content-Length: 26012 + Content-Type: image/gif + + When an HTTP message includes the content of multiple ranges (for + example, a response to a request for multiple non-overlapping + ranges), these are transmitted as a multipart message. The multipart + media type used for this purpose is "multipart/byteranges" as defined + in appendix 19.2. See appendix 19.6.3 for a compatibility issue. + + A response to a request for a single range MUST NOT be sent using the + multipart/byteranges media type. A response to a request for + multiple ranges, whose result is a single range, MAY be sent as a + multipart/byteranges media type with one part. A client that cannot + decode a multipart/byteranges message MUST NOT ask for multiple + byte-ranges in a single request. + + When a client requests multiple byte-ranges in one request, the + server SHOULD return them in the order that they appeared in the + request. + + + +Fielding, et al. Standards Track [Page 123] + +RFC 2616 HTTP/1.1 June 1999 + + + If the server ignores a byte-range-spec because it is syntactically + invalid, the server SHOULD treat the request as if the invalid Range + header field did not exist. (Normally, this means return a 200 + response containing the full entity). + + If the server receives a request (other than one including an If- + Range request-header field) with an unsatisfiable Range request- + header field (that is, all of whose byte-range-spec values have a + first-byte-pos value greater than the current length of the selected + resource), it SHOULD return a response code of 416 (Requested range + not satisfiable) (section 10.4.17). + + Note: clients cannot depend on servers to send a 416 (Requested + range not satisfiable) response instead of a 200 (OK) response for + an unsatisfiable Range request-header, since not all servers + implement this request-header. + +14.17 Content-Type + + The Content-Type entity-header field indicates the media type of the + entity-body sent to the recipient or, in the case of the HEAD method, + the media type that would have been sent had the request been a GET. + + Content-Type = "Content-Type" ":" media-type + + Media types are defined in section 3.7. An example of the field is + + Content-Type: text/html; charset=ISO-8859-4 + + Further discussion of methods for identifying the media type of an + entity is provided in section 7.2.1. + +14.18 Date + + The Date general-header field represents the date and time at which + the message was originated, having the same semantics as orig-date in + RFC 822. The field value is an HTTP-date, as described in section + 3.3.1; it MUST be sent in RFC 1123 [8]-date format. + + Date = "Date" ":" HTTP-date + + An example is + + Date: Tue, 15 Nov 1994 08:12:31 GMT + + Origin servers MUST include a Date header field in all responses, + except in these cases: + + + + +Fielding, et al. Standards Track [Page 124] + +RFC 2616 HTTP/1.1 June 1999 + + + 1. If the response status code is 100 (Continue) or 101 (Switching + Protocols), the response MAY include a Date header field, at + the server's option. + + 2. If the response status code conveys a server error, e.g. 500 + (Internal Server Error) or 503 (Service Unavailable), and it is + inconvenient or impossible to generate a valid Date. + + 3. If the server does not have a clock that can provide a + reasonable approximation of the current time, its responses + MUST NOT include a Date header field. In this case, the rules + in section 14.18.1 MUST be followed. + + A received message that does not have a Date header field MUST be + assigned one by the recipient if the message will be cached by that + recipient or gatewayed via a protocol which requires a Date. An HTTP + implementation without a clock MUST NOT cache responses without + revalidating them on every use. An HTTP cache, especially a shared + cache, SHOULD use a mechanism, such as NTP [28], to synchronize its + clock with a reliable external standard. + + Clients SHOULD only send a Date header field in messages that include + an entity-body, as in the case of the PUT and POST requests, and even + then it is optional. A client without a clock MUST NOT send a Date + header field in a request. + + The HTTP-date sent in a Date header SHOULD NOT represent a date and + time subsequent to the generation of the message. It SHOULD represent + the best available approximation of the date and time of message + generation, unless the implementation has no means of generating a + reasonably accurate date and time. In theory, the date ought to + represent the moment just before the entity is generated. In + practice, the date can be generated at any time during the message + origination without affecting its semantic value. + +14.18.1 Clockless Origin Server Operation + + Some origin server implementations might not have a clock available. + An origin server without a clock MUST NOT assign Expires or Last- + Modified values to a response, unless these values were associated + with the resource by a system or user with a reliable clock. It MAY + assign an Expires value that is known, at or before server + configuration time, to be in the past (this allows "pre-expiration" + of responses without storing separate Expires values for each + resource). + + + + + + +Fielding, et al. Standards Track [Page 125] + +RFC 2616 HTTP/1.1 June 1999 + + +14.19 ETag + + The ETag response-header field provides the current value of the + entity tag for the requested variant. The headers used with entity + tags are described in sections 14.24, 14.26 and 14.44. The entity tag + MAY be used for comparison with other entities from the same resource + (see section 13.3.3). + + ETag = "ETag" ":" entity-tag + + Examples: + + ETag: "xyzzy" + ETag: W/"xyzzy" + ETag: "" + +14.20 Expect + + The Expect request-header field is used to indicate that particular + server behaviors are required by the client. + + Expect = "Expect" ":" 1#expectation + + expectation = "100-continue" | expectation-extension + expectation-extension = token [ "=" ( token | quoted-string ) + *expect-params ] + expect-params = ";" token [ "=" ( token | quoted-string ) ] + + + A server that does not understand or is unable to comply with any of + the expectation values in the Expect field of a request MUST respond + with appropriate error status. The server MUST respond with a 417 + (Expectation Failed) status if any of the expectations cannot be met + or, if there are other problems with the request, some other 4xx + status. + + This header field is defined with extensible syntax to allow for + future extensions. If a server receives a request containing an + Expect field that includes an expectation-extension that it does not + support, it MUST respond with a 417 (Expectation Failed) status. + + Comparison of expectation values is case-insensitive for unquoted + tokens (including the 100-continue token), and is case-sensitive for + quoted-string expectation-extensions. + + + + + + + +Fielding, et al. Standards Track [Page 126] + +RFC 2616 HTTP/1.1 June 1999 + + + The Expect mechanism is hop-by-hop: that is, an HTTP/1.1 proxy MUST + return a 417 (Expectation Failed) status if it receives a request + with an expectation that it cannot meet. However, the Expect + request-header itself is end-to-end; it MUST be forwarded if the + request is forwarded. + + Many older HTTP/1.0 and HTTP/1.1 applications do not understand the + Expect header. + + See section 8.2.3 for the use of the 100 (continue) status. + +14.21 Expires + + The Expires entity-header field gives the date/time after which the + response is considered stale. A stale cache entry may not normally be + returned by a cache (either a proxy cache or a user agent cache) + unless it is first validated with the origin server (or with an + intermediate cache that has a fresh copy of the entity). See section + 13.2 for further discussion of the expiration model. + + The presence of an Expires field does not imply that the original + resource will change or cease to exist at, before, or after that + time. + + The format is an absolute date and time as defined by HTTP-date in + section 3.3.1; it MUST be in RFC 1123 date format: + + Expires = "Expires" ":" HTTP-date + + An example of its use is + + Expires: Thu, 01 Dec 1994 16:00:00 GMT + + Note: if a response includes a Cache-Control field with the max- + age directive (see section 14.9.3), that directive overrides the + Expires field. + + HTTP/1.1 clients and caches MUST treat other invalid date formats, + especially including the value "0", as in the past (i.e., "already + expired"). + + To mark a response as "already expired," an origin server sends an + Expires date that is equal to the Date header value. (See the rules + for expiration calculations in section 13.2.4.) + + + + + + + +Fielding, et al. Standards Track [Page 127] + +RFC 2616 HTTP/1.1 June 1999 + + + To mark a response as "never expires," an origin server sends an + Expires date approximately one year from the time the response is + sent. HTTP/1.1 servers SHOULD NOT send Expires dates more than one + year in the future. + + The presence of an Expires header field with a date value of some + time in the future on a response that otherwise would by default be + non-cacheable indicates that the response is cacheable, unless + indicated otherwise by a Cache-Control header field (section 14.9). + +14.22 From + + The From request-header field, if given, SHOULD contain an Internet + e-mail address for the human user who controls the requesting user + agent. The address SHOULD be machine-usable, as defined by "mailbox" + in RFC 822 [9] as updated by RFC 1123 [8]: + + From = "From" ":" mailbox + + An example is: + + From: webmaster@w3.org + + This header field MAY be used for logging purposes and as a means for + identifying the source of invalid or unwanted requests. It SHOULD NOT + be used as an insecure form of access protection. The interpretation + of this field is that the request is being performed on behalf of the + person given, who accepts responsibility for the method performed. In + particular, robot agents SHOULD include this header so that the + person responsible for running the robot can be contacted if problems + occur on the receiving end. + + The Internet e-mail address in this field MAY be separate from the + Internet host which issued the request. For example, when a request + is passed through a proxy the original issuer's address SHOULD be + used. + + The client SHOULD NOT send the From header field without the user's + approval, as it might conflict with the user's privacy interests or + their site's security policy. It is strongly recommended that the + user be able to disable, enable, and modify the value of this field + at any time prior to a request. + +14.23 Host + + The Host request-header field specifies the Internet host and port + number of the resource being requested, as obtained from the original + URI given by the user or referring resource (generally an HTTP URL, + + + +Fielding, et al. Standards Track [Page 128] + +RFC 2616 HTTP/1.1 June 1999 + + + as described in section 3.2.2). The Host field value MUST represent + the naming authority of the origin server or gateway given by the + original URL. This allows the origin server or gateway to + differentiate between internally-ambiguous URLs, such as the root "/" + URL of a server for multiple host names on a single IP address. + + Host = "Host" ":" host [ ":" port ] ; Section 3.2.2 + + A "host" without any trailing port information implies the default + port for the service requested (e.g., "80" for an HTTP URL). For + example, a request on the origin server for + would properly include: + + GET /pub/WWW/ HTTP/1.1 + Host: www.w3.org + + A client MUST include a Host header field in all HTTP/1.1 request + messages . If the requested URI does not include an Internet host + name for the service being requested, then the Host header field MUST + be given with an empty value. An HTTP/1.1 proxy MUST ensure that any + request message it forwards does contain an appropriate Host header + field that identifies the service being requested by the proxy. All + Internet-based HTTP/1.1 servers MUST respond with a 400 (Bad Request) + status code to any HTTP/1.1 request message which lacks a Host header + field. + + See sections 5.2 and 19.6.1.1 for other requirements relating to + Host. + +14.24 If-Match + + The If-Match request-header field is used with a method to make it + conditional. A client that has one or more entities previously + obtained from the resource can verify that one of those entities is + current by including a list of their associated entity tags in the + If-Match header field. Entity tags are defined in section 3.11. The + purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. It is also + used, on updating requests, to prevent inadvertent modification of + the wrong version of a resource. As a special case, the value "*" + matches any current entity of the resource. + + If-Match = "If-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-Match header) on that resource, or if "*" is given + + + + +Fielding, et al. Standards Track [Page 129] + +RFC 2616 HTTP/1.1 June 1999 + + + and any current entity exists for that resource, then the server MAY + perform the requested method as if the If-Match header field did not + exist. + + A server MUST use the strong comparison function (see section 13.3.3) + to compare the entity tags in If-Match. + + If none of the entity tags match, or if "*" is given and no current + entity exists, the server MUST NOT perform the requested method, and + MUST return a 412 (Precondition Failed) response. This behavior is + most useful when the client wants to prevent an updating method, such + as PUT, from modifying a resource that has changed since the client + last retrieved it. + + If the request would, without the If-Match header field, result in + anything other than a 2xx or 412 status, then the If-Match header + MUST be ignored. + + The meaning of "If-Match: *" is that the method SHOULD be performed + if the representation selected by the origin server (or by a cache, + possibly using the Vary mechanism, see section 14.44) exists, and + MUST NOT be performed if the representation does not exist. + + A request intended to update a resource (e.g., a PUT) MAY include an + If-Match header field to signal that the request method MUST NOT be + applied if the entity corresponding to the If-Match value (a single + entity tag) is no longer a representation of that resource. This + allows the user to indicate that they do not wish the request to be + successful if the resource has been changed without their knowledge. + Examples: + + If-Match: "xyzzy" + If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-Match: * + + The result of a request having both an If-Match header field and + either an If-None-Match or an If-Modified-Since header fields is + undefined by this specification. + +14.25 If-Modified-Since + + The If-Modified-Since request-header field is used with a method to + make it conditional: if the requested variant has not been modified + since the time specified in this field, an entity will not be + returned from the server; instead, a 304 (not modified) response will + be returned without any message-body. + + If-Modified-Since = "If-Modified-Since" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 130] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of the field is: + + If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + A GET method with an If-Modified-Since header and no Range header + requests that the identified entity be transferred only if it has + been modified since the date given by the If-Modified-Since header. + The algorithm for determining this includes the following cases: + + a) If the request would normally result in anything other than a + 200 (OK) status, or if the passed If-Modified-Since date is + invalid, the response is exactly the same as for a normal GET. + A date which is later than the server's current time is + invalid. + + b) If the variant has been modified since the If-Modified-Since + date, the response is exactly the same as for a normal GET. + + c) If the variant has not been modified since a valid If- + Modified-Since date, the server SHOULD return a 304 (Not + Modified) response. + + The purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. + + Note: The Range request-header field modifies the meaning of If- + Modified-Since; see section 14.35 for full details. + + Note: If-Modified-Since times are interpreted by the server, whose + clock might not be synchronized with the client. + + Note: When handling an If-Modified-Since header field, some + servers will use an exact date comparison function, rather than a + less-than function, for deciding whether to send a 304 (Not + Modified) response. To get best results when sending an If- + Modified-Since header field for cache validation, clients are + advised to use the exact date string received in a previous Last- + Modified header field whenever possible. + + Note: If a client uses an arbitrary date in the If-Modified-Since + header instead of a date taken from the Last-Modified header for + the same request, the client should be aware of the fact that this + date is interpreted in the server's understanding of time. The + client should consider unsynchronized clocks and rounding problems + due to the different encodings of time between the client and + server. This includes the possibility of race conditions if the + document has changed between the time it was first requested and + the If-Modified-Since date of a subsequent request, and the + + + +Fielding, et al. Standards Track [Page 131] + +RFC 2616 HTTP/1.1 June 1999 + + + possibility of clock-skew-related problems if the If-Modified- + Since date is derived from the client's clock without correction + to the server's clock. Corrections for different time bases + between client and server are at best approximate due to network + latency. + + The result of a request having both an If-Modified-Since header field + and either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.26 If-None-Match + + The If-None-Match request-header field is used with a method to make + it conditional. A client that has one or more entities previously + obtained from the resource can verify that none of those entities is + current by including a list of their associated entity tags in the + If-None-Match header field. The purpose of this feature is to allow + efficient updates of cached information with a minimum amount of + transaction overhead. It is also used to prevent a method (e.g. PUT) + from inadvertently modifying an existing resource when the client + believes that the resource does not exist. + + As a special case, the value "*" matches any current entity of the + resource. + + If-None-Match = "If-None-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-None-Match header) on that resource, or if "*" is + given and any current entity exists for that resource, then the + server MUST NOT perform the requested method, unless required to do + so because the resource's modification date fails to match that + supplied in an If-Modified-Since header field in the request. + Instead, if the request method was GET or HEAD, the server SHOULD + respond with a 304 (Not Modified) response, including the cache- + related header fields (particularly ETag) of one of the entities that + matched. For all other request methods, the server MUST respond with + a status of 412 (Precondition Failed). + + See section 13.3.3 for rules on how to determine if two entities tags + match. The weak comparison function can only be used with GET or HEAD + requests. + + + + + + + + +Fielding, et al. Standards Track [Page 132] + +RFC 2616 HTTP/1.1 June 1999 + + + If none of the entity tags match, then the server MAY perform the + requested method as if the If-None-Match header field did not exist, + but MUST also ignore any If-Modified-Since header field(s) in the + request. That is, if no entity tags match, then the server MUST NOT + return a 304 (Not Modified) response. + + If the request would, without the If-None-Match header field, result + in anything other than a 2xx or 304 status, then the If-None-Match + header MUST be ignored. (See section 13.3.4 for a discussion of + server behavior when both If-Modified-Since and If-None-Match appear + in the same request.) + + The meaning of "If-None-Match: *" is that the method MUST NOT be + performed if the representation selected by the origin server (or by + a cache, possibly using the Vary mechanism, see section 14.44) + exists, and SHOULD be performed if the representation does not exist. + This feature is intended to be useful in preventing races between PUT + operations. + + Examples: + + If-None-Match: "xyzzy" + If-None-Match: W/"xyzzy" + If-None-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-None-Match: W/"xyzzy", W/"r2d2xxxx", W/"c3piozzzz" + If-None-Match: * + + The result of a request having both an If-None-Match header field and + either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.27 If-Range + + If a client has a partial copy of an entity in its cache, and wishes + to have an up-to-date copy of the entire entity in its cache, it + could use the Range request-header with a conditional GET (using + either or both of If-Unmodified-Since and If-Match.) However, if the + condition fails because the entity has been modified, the client + would then have to make a second request to obtain the entire current + entity-body. + + The If-Range header allows a client to "short-circuit" the second + request. Informally, its meaning is `if the entity is unchanged, send + me the part(s) that I am missing; otherwise, send me the entire new + entity'. + + If-Range = "If-Range" ":" ( entity-tag | HTTP-date ) + + + + +Fielding, et al. Standards Track [Page 133] + +RFC 2616 HTTP/1.1 June 1999 + + + If the client has no entity tag for an entity, but does have a Last- + Modified date, it MAY use that date in an If-Range header. (The + server can distinguish between a valid HTTP-date and any form of + entity-tag by examining no more than two characters.) The If-Range + header SHOULD only be used together with a Range header, and MUST be + ignored if the request does not include a Range header, or if the + server does not support the sub-range operation. + + If the entity tag given in the If-Range header matches the current + entity tag for the entity, then the server SHOULD provide the + specified sub-range of the entity using a 206 (Partial content) + response. If the entity tag does not match, then the server SHOULD + return the entire entity using a 200 (OK) response. + +14.28 If-Unmodified-Since + + The If-Unmodified-Since request-header field is used with a method to + make it conditional. If the requested resource has not been modified + since the time specified in this field, the server SHOULD perform the + requested operation as if the If-Unmodified-Since header were not + present. + + If the requested variant has been modified since the specified time, + the server MUST NOT perform the requested operation, and MUST return + a 412 (Precondition Failed). + + If-Unmodified-Since = "If-Unmodified-Since" ":" HTTP-date + + An example of the field is: + + If-Unmodified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + If the request normally (i.e., without the If-Unmodified-Since + header) would result in anything other than a 2xx or 412 status, the + If-Unmodified-Since header SHOULD be ignored. + + If the specified date is invalid, the header is ignored. + + The result of a request having both an If-Unmodified-Since header + field and either an If-None-Match or an If-Modified-Since header + fields is undefined by this specification. + +14.29 Last-Modified + + The Last-Modified entity-header field indicates the date and time at + which the origin server believes the variant was last modified. + + Last-Modified = "Last-Modified" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 134] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of its use is + + Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT + + The exact meaning of this header field depends on the implementation + of the origin server and the nature of the original resource. For + files, it may be just the file system last-modified time. For + entities with dynamically included parts, it may be the most recent + of the set of last-modify times for its component parts. For database + gateways, it may be the last-update time stamp of the record. For + virtual objects, it may be the last time the internal state changed. + + An origin server MUST NOT send a Last-Modified date which is later + than the server's time of message origination. In such cases, where + the resource's last modification would indicate some time in the + future, the server MUST replace that date with the message + origination date. + + An origin server SHOULD obtain the Last-Modified value of the entity + as close as possible to the time that it generates the Date value of + its response. This allows a recipient to make an accurate assessment + of the entity's modification time, especially if the entity changes + near the time that the response is generated. + + HTTP/1.1 servers SHOULD send Last-Modified whenever feasible. + +14.30 Location + + The Location response-header field is used to redirect the recipient + to a location other than the Request-URI for completion of the + request or identification of a new resource. For 201 (Created) + responses, the Location is that of the new resource which was created + by the request. For 3xx responses, the location SHOULD indicate the + server's preferred URI for automatic redirection to the resource. The + field value consists of a single absolute URI. + + Location = "Location" ":" absoluteURI + + An example is: + + Location: http://www.w3.org/pub/WWW/People.html + + Note: The Content-Location header field (section 14.14) differs + from Location in that the Content-Location identifies the original + location of the entity enclosed in the request. It is therefore + possible for a response to contain header fields for both Location + and Content-Location. Also see section 13.10 for cache + requirements of some methods. + + + +Fielding, et al. Standards Track [Page 135] + +RFC 2616 HTTP/1.1 June 1999 + + +14.31 Max-Forwards + + The Max-Forwards request-header field provides a mechanism with the + TRACE (section 9.8) and OPTIONS (section 9.2) methods to limit the + number of proxies or gateways that can forward the request to the + next inbound server. This can be useful when the client is attempting + to trace a request chain which appears to be failing or looping in + mid-chain. + + Max-Forwards = "Max-Forwards" ":" 1*DIGIT + + The Max-Forwards value is a decimal integer indicating the remaining + number of times this request message may be forwarded. + + Each proxy or gateway recipient of a TRACE or OPTIONS request + containing a Max-Forwards header field MUST check and update its + value prior to forwarding the request. If the received value is zero + (0), the recipient MUST NOT forward the request; instead, it MUST + respond as the final recipient. If the received Max-Forwards value is + greater than zero, then the forwarded message MUST contain an updated + Max-Forwards field with a value decremented by one (1). + + The Max-Forwards header field MAY be ignored for all other methods + defined by this specification and for any extension methods for which + it is not explicitly referred to as part of that method definition. + +14.32 Pragma + + The Pragma general-header field is used to include implementation- + specific directives that might apply to any recipient along the + request/response chain. All pragma directives specify optional + behavior from the viewpoint of the protocol; however, some systems + MAY require that behavior be consistent with the directives. + + Pragma = "Pragma" ":" 1#pragma-directive + pragma-directive = "no-cache" | extension-pragma + extension-pragma = token [ "=" ( token | quoted-string ) ] + + When the no-cache directive is present in a request message, an + application SHOULD forward the request toward the origin server even + if it has a cached copy of what is being requested. This pragma + directive has the same semantics as the no-cache cache-directive (see + section 14.9) and is defined here for backward compatibility with + HTTP/1.0. Clients SHOULD include both header fields when a no-cache + request is sent to a server not known to be HTTP/1.1 compliant. + + + + + + +Fielding, et al. Standards Track [Page 136] + +RFC 2616 HTTP/1.1 June 1999 + + + Pragma directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a pragma for a + specific recipient; however, any pragma directive not relevant to a + recipient SHOULD be ignored by that recipient. + + HTTP/1.1 caches SHOULD treat "Pragma: no-cache" as if the client had + sent "Cache-Control: no-cache". No new Pragma directives will be + defined in HTTP. + + Note: because the meaning of "Pragma: no-cache as a response + header field is not actually specified, it does not provide a + reliable replacement for "Cache-Control: no-cache" in a response + +14.33 Proxy-Authenticate + + The Proxy-Authenticate response-header field MUST be included as part + of a 407 (Proxy Authentication Required) response. The field value + consists of a challenge that indicates the authentication scheme and + parameters applicable to the proxy for this Request-URI. + + Proxy-Authenticate = "Proxy-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. Unlike + WWW-Authenticate, the Proxy-Authenticate header field applies only to + the current connection and SHOULD NOT be passed on to downstream + clients. However, an intermediate proxy might need to obtain its own + credentials by requesting them from the downstream client, which in + some circumstances will appear as if the proxy is forwarding the + Proxy-Authenticate header field. + +14.34 Proxy-Authorization + + The Proxy-Authorization request-header field allows the client to + identify itself (or its user) to a proxy which requires + authentication. The Proxy-Authorization field value consists of + credentials containing the authentication information of the user + agent for the proxy and/or realm of the resource being requested. + + Proxy-Authorization = "Proxy-Authorization" ":" credentials + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43] . Unlike + Authorization, the Proxy-Authorization header field applies only to + the next outbound proxy that demanded authentication using the Proxy- + Authenticate field. When multiple proxies are used in a chain, the + + + +Fielding, et al. Standards Track [Page 137] + +RFC 2616 HTTP/1.1 June 1999 + + + Proxy-Authorization header field is consumed by the first outbound + proxy that was expecting to receive credentials. A proxy MAY relay + the credentials from the client request to the next proxy if that is + the mechanism by which the proxies cooperatively authenticate a given + request. + +14.35 Range + +14.35.1 Byte Ranges + + Since all HTTP entities are represented in HTTP messages as sequences + of bytes, the concept of a byte range is meaningful for any HTTP + entity. (However, not all clients and servers need to support byte- + range operations.) + + Byte range specifications in HTTP apply to the sequence of bytes in + the entity-body (not necessarily the same as the message-body). + + A byte range operation MAY specify a single range of bytes, or a set + of ranges within a single entity. + + ranges-specifier = byte-ranges-specifier + byte-ranges-specifier = bytes-unit "=" byte-range-set + byte-range-set = 1#( byte-range-spec | suffix-byte-range-spec ) + byte-range-spec = first-byte-pos "-" [last-byte-pos] + first-byte-pos = 1*DIGIT + last-byte-pos = 1*DIGIT + + The first-byte-pos value in a byte-range-spec gives the byte-offset + of the first byte in a range. The last-byte-pos value gives the + byte-offset of the last byte in the range; that is, the byte + positions specified are inclusive. Byte offsets start at zero. + + If the last-byte-pos value is present, it MUST be greater than or + equal to the first-byte-pos in that byte-range-spec, or the byte- + range-spec is syntactically invalid. The recipient of a byte-range- + set that includes one or more syntactically invalid byte-range-spec + values MUST ignore the header field that includes that byte-range- + set. + + If the last-byte-pos value is absent, or if the value is greater than + or equal to the current length of the entity-body, last-byte-pos is + taken to be equal to one less than the current length of the entity- + body in bytes. + + By its choice of last-byte-pos, a client can limit the number of + bytes retrieved without knowing the size of the entity. + + + + +Fielding, et al. Standards Track [Page 138] + +RFC 2616 HTTP/1.1 June 1999 + + + suffix-byte-range-spec = "-" suffix-length + suffix-length = 1*DIGIT + + A suffix-byte-range-spec is used to specify the suffix of the + entity-body, of a length given by the suffix-length value. (That is, + this form specifies the last N bytes of an entity-body.) If the + entity is shorter than the specified suffix-length, the entire + entity-body is used. + + If a syntactically valid byte-range-set includes at least one byte- + range-spec whose first-byte-pos is less than the current length of + the entity-body, or at least one suffix-byte-range-spec with a non- + zero suffix-length, then the byte-range-set is satisfiable. + Otherwise, the byte-range-set is unsatisfiable. If the byte-range-set + is unsatisfiable, the server SHOULD return a response with a status + of 416 (Requested range not satisfiable). Otherwise, the server + SHOULD return a response with a status of 206 (Partial Content) + containing the satisfiable ranges of the entity-body. + + Examples of byte-ranges-specifier values (assuming an entity-body of + length 10000): + + - The first 500 bytes (byte offsets 0-499, inclusive): bytes=0- + 499 + + - The second 500 bytes (byte offsets 500-999, inclusive): + bytes=500-999 + + - The final 500 bytes (byte offsets 9500-9999, inclusive): + bytes=-500 + + - Or bytes=9500- + + - The first and last bytes only (bytes 0 and 9999): bytes=0-0,-1 + + - Several legal but not canonical specifications of the second 500 + bytes (byte offsets 500-999, inclusive): + bytes=500-600,601-999 + bytes=500-700,601-999 + +14.35.2 Range Retrieval Requests + + HTTP retrieval requests using conditional or unconditional GET + methods MAY request one or more sub-ranges of the entity, instead of + the entire entity, using the Range request header, which applies to + the entity returned as the result of the request: + + Range = "Range" ":" ranges-specifier + + + +Fielding, et al. Standards Track [Page 139] + +RFC 2616 HTTP/1.1 June 1999 + + + A server MAY ignore the Range header. However, HTTP/1.1 origin + servers and intermediate caches ought to support byte ranges when + possible, since Range supports efficient recovery from partially + failed transfers, and supports efficient partial retrieval of large + entities. + + If the server supports the Range header and the specified range or + ranges are appropriate for the entity: + + - The presence of a Range header in an unconditional GET modifies + what is returned if the GET is otherwise successful. In other + words, the response carries a status code of 206 (Partial + Content) instead of 200 (OK). + + - The presence of a Range header in a conditional GET (a request + using one or both of If-Modified-Since and If-None-Match, or + one or both of If-Unmodified-Since and If-Match) modifies what + is returned if the GET is otherwise successful and the + condition is true. It does not affect the 304 (Not Modified) + response returned if the conditional is false. + + In some cases, it might be more appropriate to use the If-Range + header (see section 14.27) in addition to the Range header. + + If a proxy that supports ranges receives a Range request, forwards + the request to an inbound server, and receives an entire entity in + reply, it SHOULD only return the requested range to its client. It + SHOULD store the entire received response in its cache if that is + consistent with its cache allocation policies. + +14.36 Referer + + The Referer[sic] request-header field allows the client to specify, + for the server's benefit, the address (URI) of the resource from + which the Request-URI was obtained (the "referrer", although the + header field is misspelled.) The Referer request-header allows a + server to generate lists of back-links to resources for interest, + logging, optimized caching, etc. It also allows obsolete or mistyped + links to be traced for maintenance. The Referer field MUST NOT be + sent if the Request-URI was obtained from a source that does not have + its own URI, such as input from the user keyboard. + + Referer = "Referer" ":" ( absoluteURI | relativeURI ) + + Example: + + Referer: http://www.w3.org/hypertext/DataSources/Overview.html + + + + +Fielding, et al. Standards Track [Page 140] + +RFC 2616 HTTP/1.1 June 1999 + + + If the field value is a relative URI, it SHOULD be interpreted + relative to the Request-URI. The URI MUST NOT include a fragment. See + section 15.1.3 for security considerations. + +14.37 Retry-After + + The Retry-After response-header field can be used with a 503 (Service + Unavailable) response to indicate how long the service is expected to + be unavailable to the requesting client. This field MAY also be used + with any 3xx (Redirection) response to indicate the minimum time the + user-agent is asked wait before issuing the redirected request. The + value of this field can be either an HTTP-date or an integer number + of seconds (in decimal) after the time of the response. + + Retry-After = "Retry-After" ":" ( HTTP-date | delta-seconds ) + + Two examples of its use are + + Retry-After: Fri, 31 Dec 1999 23:59:59 GMT + Retry-After: 120 + + In the latter example, the delay is 2 minutes. + +14.38 Server + + The Server response-header field contains information about the + software used by the origin server to handle the request. The field + can contain multiple product tokens (section 3.8) and comments + identifying the server and any significant subproducts. The product + tokens are listed in order of their significance for identifying the + application. + + Server = "Server" ":" 1*( product | comment ) + + Example: + + Server: CERN/3.0 libwww/2.17 + + If the response is being forwarded through a proxy, the proxy + application MUST NOT modify the Server response-header. Instead, it + SHOULD include a Via field (as described in section 14.45). + + Note: Revealing the specific software version of the server might + allow the server machine to become more vulnerable to attacks + against software that is known to contain security holes. Server + implementors are encouraged to make this field a configurable + option. + + + + +Fielding, et al. Standards Track [Page 141] + +RFC 2616 HTTP/1.1 June 1999 + + +14.39 TE + + The TE request-header field indicates what extension transfer-codings + it is willing to accept in the response and whether or not it is + willing to accept trailer fields in a chunked transfer-coding. Its + value may consist of the keyword "trailers" and/or a comma-separated + list of extension transfer-coding names with optional accept + parameters (as described in section 3.6). + + TE = "TE" ":" #( t-codings ) + t-codings = "trailers" | ( transfer-extension [ accept-params ] ) + + The presence of the keyword "trailers" indicates that the client is + willing to accept trailer fields in a chunked transfer-coding, as + defined in section 3.6.1. This keyword is reserved for use with + transfer-coding values even though it does not itself represent a + transfer-coding. + + Examples of its use are: + + TE: deflate + TE: + TE: trailers, deflate;q=0.5 + + The TE header field only applies to the immediate connection. + Therefore, the keyword MUST be supplied within a Connection header + field (section 14.10) whenever TE is present in an HTTP/1.1 message. + + A server tests whether a transfer-coding is acceptable, according to + a TE field, using these rules: + + 1. The "chunked" transfer-coding is always acceptable. If the + keyword "trailers" is listed, the client indicates that it is + willing to accept trailer fields in the chunked response on + behalf of itself and any downstream clients. The implication is + that, if given, the client is stating that either all + downstream clients are willing to accept trailer fields in the + forwarded response, or that it will attempt to buffer the + response on behalf of downstream recipients. + + Note: HTTP/1.1 does not define any means to limit the size of a + chunked response such that a client can be assured of buffering + the entire response. + + 2. If the transfer-coding being tested is one of the transfer- + codings listed in the TE field, then it is acceptable unless it + is accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + + +Fielding, et al. Standards Track [Page 142] + +RFC 2616 HTTP/1.1 June 1999 + + + 3. If multiple transfer-codings are acceptable, then the + acceptable transfer-coding with the highest non-zero qvalue is + preferred. The "chunked" transfer-coding always has a qvalue + of 1. + + If the TE field-value is empty or if no TE field is present, the only + transfer-coding is "chunked". A message with no transfer-coding is + always acceptable. + +14.40 Trailer + + The Trailer general field value indicates that the given set of + header fields is present in the trailer of a message encoded with + chunked transfer-coding. + + Trailer = "Trailer" ":" 1#field-name + + An HTTP/1.1 message SHOULD include a Trailer header field in a + message using chunked transfer-coding with a non-empty trailer. Doing + so allows the recipient to know which header fields to expect in the + trailer. + + If no Trailer header field is present, the trailer SHOULD NOT include + any header fields. See section 3.6.1 for restrictions on the use of + trailer fields in a "chunked" transfer-coding. + + Message header fields listed in the Trailer header field MUST NOT + include the following header fields: + + . Transfer-Encoding + + . Content-Length + + . Trailer + +14.41 Transfer-Encoding + + The Transfer-Encoding general-header field indicates what (if any) + type of transformation has been applied to the message body in order + to safely transfer it between the sender and the recipient. This + differs from the content-coding in that the transfer-coding is a + property of the message, not of the entity. + + Transfer-Encoding = "Transfer-Encoding" ":" 1#transfer-coding + + Transfer-codings are defined in section 3.6. An example is: + + Transfer-Encoding: chunked + + + +Fielding, et al. Standards Track [Page 143] + +RFC 2616 HTTP/1.1 June 1999 + + + If multiple encodings have been applied to an entity, the transfer- + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + + Many older HTTP/1.0 applications do not understand the Transfer- + Encoding header. + +14.42 Upgrade + + The Upgrade general-header allows the client to specify what + additional communication protocols it supports and would like to use + if the server finds it appropriate to switch protocols. The server + MUST use the Upgrade header field within a 101 (Switching Protocols) + response to indicate which protocol(s) are being switched. + + Upgrade = "Upgrade" ":" 1#product + + For example, + + Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11 + + The Upgrade header field is intended to provide a simple mechanism + for transition from HTTP/1.1 to some other, incompatible protocol. It + does so by allowing the client to advertise its desire to use another + protocol, such as a later version of HTTP with a higher major version + number, even though the current request has been made using HTTP/1.1. + This eases the difficult transition between incompatible protocols by + allowing the client to initiate a request in the more commonly + supported protocol while indicating to the server that it would like + to use a "better" protocol if available (where "better" is determined + by the server, possibly according to the nature of the method and/or + resource being requested). + + The Upgrade header field only applies to switching application-layer + protocols upon the existing transport-layer connection. Upgrade + cannot be used to insist on a protocol change; its acceptance and use + by the server is optional. The capabilities and nature of the + application-layer communication after the protocol change is entirely + dependent upon the new protocol chosen, although the first action + after changing the protocol MUST be a response to the initial HTTP + request containing the Upgrade header field. + + The Upgrade header field only applies to the immediate connection. + Therefore, the upgrade keyword MUST be supplied within a Connection + header field (section 14.10) whenever Upgrade is present in an + HTTP/1.1 message. + + + + +Fielding, et al. Standards Track [Page 144] + +RFC 2616 HTTP/1.1 June 1999 + + + The Upgrade header field cannot be used to indicate a switch to a + protocol on a different connection. For that purpose, it is more + appropriate to use a 301, 302, 303, or 305 redirection response. + + This specification only defines the protocol name "HTTP" for use by + the family of Hypertext Transfer Protocols, as defined by the HTTP + version rules of section 3.1 and future updates to this + specification. Any token can be used as a protocol name; however, it + will only be useful if both the client and server associate the name + with the same protocol. + +14.43 User-Agent + + The User-Agent request-header field contains information about the + user agent originating the request. This is for statistical purposes, + the tracing of protocol violations, and automated recognition of user + agents for the sake of tailoring responses to avoid particular user + agent limitations. User agents SHOULD include this field with + requests. The field can contain multiple product tokens (section 3.8) + and comments identifying the agent and any subproducts which form a + significant part of the user agent. By convention, the product tokens + are listed in order of their significance for identifying the + application. + + User-Agent = "User-Agent" ":" 1*( product | comment ) + + Example: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + +14.44 Vary + + The Vary field value indicates the set of request-header fields that + fully determines, while the response is fresh, whether a cache is + permitted to use the response to reply to a subsequent request + without revalidation. For uncacheable or stale responses, the Vary + field value advises the user agent about the criteria that were used + to select the representation. A Vary field value of "*" implies that + a cache cannot determine from the request headers of a subsequent + request whether this response is the appropriate representation. See + section 13.6 for use of the Vary header field by caches. + + Vary = "Vary" ":" ( "*" | 1#field-name ) + + An HTTP/1.1 server SHOULD include a Vary header field with any + cacheable response that is subject to server-driven negotiation. + Doing so allows a cache to properly interpret future requests on that + resource and informs the user agent about the presence of negotiation + + + +Fielding, et al. Standards Track [Page 145] + +RFC 2616 HTTP/1.1 June 1999 + + + on that resource. A server MAY include a Vary header field with a + non-cacheable response that is subject to server-driven negotiation, + since this might provide the user agent with useful information about + the dimensions over which the response varies at the time of the + response. + + A Vary field value consisting of a list of field-names signals that + the representation selected for the response is based on a selection + algorithm which considers ONLY the listed request-header field values + in selecting the most appropriate representation. A cache MAY assume + that the same selection will be made for future requests with the + same values for the listed field names, for the duration of time for + which the response is fresh. + + The field-names given are not limited to the set of standard + request-header fields defined by this specification. Field names are + case-insensitive. + + A Vary field value of "*" signals that unspecified parameters not + limited to the request-headers (e.g., the network address of the + client), play a role in the selection of the response representation. + The "*" value MUST NOT be generated by a proxy server; it may only be + generated by an origin server. + +14.45 Via + + The Via general-header field MUST be used by gateways and proxies to + indicate the intermediate protocols and recipients between the user + agent and the server on requests, and between the origin server and + the client on responses. It is analogous to the "Received" field of + RFC 822 [9] and is intended to be used for tracking message forwards, + avoiding request loops, and identifying the protocol capabilities of + all senders along the request/response chain. + + Via = "Via" ":" 1#( received-protocol received-by [ comment ] ) + received-protocol = [ protocol-name "/" ] protocol-version + protocol-name = token + protocol-version = token + received-by = ( host [ ":" port ] ) | pseudonym + pseudonym = token + + The received-protocol indicates the protocol version of the message + received by the server or client along each segment of the + request/response chain. The received-protocol version is appended to + the Via field value when the message is forwarded so that information + about the protocol capabilities of upstream applications remains + visible to all recipients. + + + + +Fielding, et al. Standards Track [Page 146] + +RFC 2616 HTTP/1.1 June 1999 + + + The protocol-name is optional if and only if it would be "HTTP". The + received-by field is normally the host and optional port number of a + recipient server or client that subsequently forwarded the message. + However, if the real host is considered to be sensitive information, + it MAY be replaced by a pseudonym. If the port is not given, it MAY + be assumed to be the default port of the received-protocol. + + Multiple Via field values represents each proxy or gateway that has + forwarded the message. Each recipient MUST append its information + such that the end result is ordered according to the sequence of + forwarding applications. + + Comments MAY be used in the Via header field to identify the software + of the recipient proxy or gateway, analogous to the User-Agent and + Server header fields. However, all comments in the Via field are + optional and MAY be removed by any recipient prior to forwarding the + message. + + For example, a request message could be sent from an HTTP/1.0 user + agent to an internal proxy code-named "fred", which uses HTTP/1.1 to + forward the request to a public proxy at nowhere.com, which completes + the request by forwarding it to the origin server at www.ics.uci.edu. + The request received by www.ics.uci.edu would then have the following + Via header field: + + Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1) + + Proxies and gateways used as a portal through a network firewall + SHOULD NOT, by default, forward the names and ports of hosts within + the firewall region. This information SHOULD only be propagated if + explicitly enabled. If not enabled, the received-by host of any host + behind the firewall SHOULD be replaced by an appropriate pseudonym + for that host. + + For organizations that have strong privacy requirements for hiding + internal structures, a proxy MAY combine an ordered subsequence of + Via header field entries with identical received-protocol values into + a single such entry. For example, + + Via: 1.0 ricky, 1.1 ethel, 1.1 fred, 1.0 lucy + + could be collapsed to + + Via: 1.0 ricky, 1.1 mertz, 1.0 lucy + + + + + + + +Fielding, et al. Standards Track [Page 147] + +RFC 2616 HTTP/1.1 June 1999 + + + Applications SHOULD NOT combine multiple entries unless they are all + under the same organizational control and the hosts have already been + replaced by pseudonyms. Applications MUST NOT combine entries which + have different received-protocol values. + +14.46 Warning + + The Warning general-header field is used to carry additional + information about the status or transformation of a message which + might not be reflected in the message. This information is typically + used to warn about a possible lack of semantic transparency from + caching operations or transformations applied to the entity body of + the message. + + Warning headers are sent with responses using: + + Warning = "Warning" ":" 1#warning-value + + warning-value = warn-code SP warn-agent SP warn-text + [SP warn-date] + + warn-code = 3DIGIT + warn-agent = ( host [ ":" port ] ) | pseudonym + ; the name or pseudonym of the server adding + ; the Warning header, for use in debugging + warn-text = quoted-string + warn-date = <"> HTTP-date <"> + + A response MAY carry more than one Warning header. + + The warn-text SHOULD be in a natural language and character set that + is most likely to be intelligible to the human user receiving the + response. This decision MAY be based on any available knowledge, such + as the location of the cache or user, the Accept-Language field in a + request, the Content-Language field in a response, etc. The default + language is English and the default character set is ISO-8859-1. + + If a character set other than ISO-8859-1 is used, it MUST be encoded + in the warn-text using the method described in RFC 2047 [14]. + + Warning headers can in general be applied to any message, however + some specific warn-codes are specific to caches and can only be + applied to response messages. New Warning headers SHOULD be added + after any existing Warning headers. A cache MUST NOT delete any + Warning header that it received with a message. However, if a cache + successfully validates a cache entry, it SHOULD remove any Warning + headers previously attached to that entry except as specified for + + + + +Fielding, et al. Standards Track [Page 148] + +RFC 2616 HTTP/1.1 June 1999 + + + specific Warning codes. It MUST then add any Warning headers received + in the validating response. In other words, Warning headers are those + that would be attached to the most recent relevant response. + + When multiple Warning headers are attached to a response, the user + agent ought to inform the user of as many of them as possible, in the + order that they appear in the response. If it is not possible to + inform the user of all of the warnings, the user agent SHOULD follow + these heuristics: + + - Warnings that appear early in the response take priority over + those appearing later in the response. + + - Warnings in the user's preferred character set take priority + over warnings in other character sets but with identical warn- + codes and warn-agents. + + Systems that generate multiple Warning headers SHOULD order them with + this user agent behavior in mind. + + Requirements for the behavior of caches with respect to Warnings are + stated in section 13.1.2. + + This is a list of the currently-defined warn-codes, each with a + recommended warn-text in English, and a description of its meaning. + + 110 Response is stale + MUST be included whenever the returned response is stale. + + 111 Revalidation failed + MUST be included if a cache returns a stale response because an + attempt to revalidate the response failed, due to an inability to + reach the server. + + 112 Disconnected operation + SHOULD be included if the cache is intentionally disconnected from + the rest of the network for a period of time. + + 113 Heuristic expiration + MUST be included if the cache heuristically chose a freshness + lifetime greater than 24 hours and the response's age is greater + than 24 hours. + + 199 Miscellaneous warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action, besides presenting the warning to + the user. + + + +Fielding, et al. Standards Track [Page 149] + +RFC 2616 HTTP/1.1 June 1999 + + + 214 Transformation applied + MUST be added by an intermediate cache or proxy if it applies any + transformation changing the content-coding (as specified in the + Content-Encoding header) or media-type (as specified in the + Content-Type header) of the response, or the entity-body of the + response, unless this Warning code already appears in the response. + + 299 Miscellaneous persistent warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action. + + If an implementation sends a message with one or more Warning headers + whose version is HTTP/1.0 or lower, then the sender MUST include in + each warning-value a warn-date that matches the date in the response. + + If an implementation receives a message with a warning-value that + includes a warn-date, and that warn-date is different from the Date + value in the response, then that warning-value MUST be deleted from + the message before storing, forwarding, or using it. (This prevents + bad consequences of naive caching of Warning header fields.) If all + of the warning-values are deleted for this reason, the Warning header + MUST be deleted as well. + +14.47 WWW-Authenticate + + The WWW-Authenticate response-header field MUST be included in 401 + (Unauthorized) response messages. The field value consists of at + least one challenge that indicates the authentication scheme(s) and + parameters applicable to the Request-URI. + + WWW-Authenticate = "WWW-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. User + agents are advised to take special care in parsing the WWW- + Authenticate field value as it might contain more than one challenge, + or if more than one WWW-Authenticate header field is provided, the + contents of a challenge itself can contain a comma-separated list of + authentication parameters. + +15 Security Considerations + + This section is meant to inform application developers, information + providers, and users of the security limitations in HTTP/1.1 as + described by this document. The discussion does not include + definitive solutions to the problems revealed, though it does make + some suggestions for reducing security risks. + + + +Fielding, et al. Standards Track [Page 150] + +RFC 2616 HTTP/1.1 June 1999 + + +15.1 Personal Information + + HTTP clients are often privy to large amounts of personal information + (e.g. the user's name, location, mail address, passwords, encryption + keys, etc.), and SHOULD be very careful to prevent unintentional + leakage of this information via the HTTP protocol to other sources. + We very strongly recommend that a convenient interface be provided + for the user to control dissemination of such information, and that + designers and implementors be particularly careful in this area. + History shows that errors in this area often create serious security + and/or privacy problems and generate highly adverse publicity for the + implementor's company. + +15.1.1 Abuse of Server Log Information + + A server is in the position to save personal data about a user's + requests which might identify their reading patterns or subjects of + interest. This information is clearly confidential in nature and its + handling can be constrained by law in certain countries. People using + the HTTP protocol to provide data are responsible for ensuring that + such material is not distributed without the permission of any + individuals that are identifiable by the published results. + +15.1.2 Transfer of Sensitive Information + + Like any generic data transfer protocol, HTTP cannot regulate the + content of the data that is transferred, nor is there any a priori + method of determining the sensitivity of any particular piece of + information within the context of any given request. Therefore, + applications SHOULD supply as much control over this information as + possible to the provider of that information. Four header fields are + worth special mention in this context: Server, Via, Referer and From. + + Revealing the specific software version of the server might allow the + server machine to become more vulnerable to attacks against software + that is known to contain security holes. Implementors SHOULD make the + Server header field a configurable option. + + Proxies which serve as a portal through a network firewall SHOULD + take special precautions regarding the transfer of header information + that identifies the hosts behind the firewall. In particular, they + SHOULD remove, or replace with sanitized versions, any Via fields + generated behind the firewall. + + The Referer header allows reading patterns to be studied and reverse + links drawn. Although it can be very useful, its power can be abused + if user details are not separated from the information contained in + + + + +Fielding, et al. Standards Track [Page 151] + +RFC 2616 HTTP/1.1 June 1999 + + + the Referer. Even when the personal information has been removed, the + Referer header might indicate a private document's URI whose + publication would be inappropriate. + + The information sent in the From field might conflict with the user's + privacy interests or their site's security policy, and hence it + SHOULD NOT be transmitted without the user being able to disable, + enable, and modify the contents of the field. The user MUST be able + to set the contents of this field within a user preference or + application defaults configuration. + + We suggest, though do not require, that a convenient toggle interface + be provided for the user to enable or disable the sending of From and + Referer information. + + The User-Agent (section 14.43) or Server (section 14.38) header + fields can sometimes be used to determine that a specific client or + server have a particular security hole which might be exploited. + Unfortunately, this same information is often used for other valuable + purposes for which HTTP currently has no better mechanism. + +15.1.3 Encoding Sensitive Information in URI's + + Because the source of a link might be private information or might + reveal an otherwise private information source, it is strongly + recommended that the user be able to select whether or not the + Referer field is sent. For example, a browser client could have a + toggle switch for browsing openly/anonymously, which would + respectively enable/disable the sending of Referer and From + information. + + Clients SHOULD NOT include a Referer header field in a (non-secure) + HTTP request if the referring page was transferred with a secure + protocol. + + Authors of services which use the HTTP protocol SHOULD NOT use GET + based forms for the submission of sensitive data, because this will + cause this data to be encoded in the Request-URI. Many existing + servers, proxies, and user agents will log the request URI in some + place where it might be visible to third parties. Servers can use + POST-based form submission instead + +15.1.4 Privacy Issues Connected to Accept Headers + + Accept request-headers can reveal information about the user to all + servers which are accessed. The Accept-Language header in particular + can reveal information the user would consider to be of a private + nature, because the understanding of particular languages is often + + + +Fielding, et al. Standards Track [Page 152] + +RFC 2616 HTTP/1.1 June 1999 + + + strongly correlated to the membership of a particular ethnic group. + User agents which offer the option to configure the contents of an + Accept-Language header to be sent in every request are strongly + encouraged to let the configuration process include a message which + makes the user aware of the loss of privacy involved. + + An approach that limits the loss of privacy would be for a user agent + to omit the sending of Accept-Language headers by default, and to ask + the user whether or not to start sending Accept-Language headers to a + server if it detects, by looking for any Vary response-header fields + generated by the server, that such sending could improve the quality + of service. + + Elaborate user-customized accept header fields sent in every request, + in particular if these include quality values, can be used by servers + as relatively reliable and long-lived user identifiers. Such user + identifiers would allow content providers to do click-trail tracking, + and would allow collaborating content providers to match cross-server + click-trails or form submissions of individual users. Note that for + many users not behind a proxy, the network address of the host + running the user agent will also serve as a long-lived user + identifier. In environments where proxies are used to enhance + privacy, user agents ought to be conservative in offering accept + header configuration options to end users. As an extreme privacy + measure, proxies could filter the accept headers in relayed requests. + General purpose user agents which provide a high degree of header + configurability SHOULD warn users about the loss of privacy which can + be involved. + +15.2 Attacks Based On File and Path Names + + Implementations of HTTP origin servers SHOULD be careful to restrict + the documents returned by HTTP requests to be only those that were + intended by the server administrators. If an HTTP server translates + HTTP URIs directly into file system calls, the server MUST take + special care not to serve files that were not intended to be + delivered to HTTP clients. For example, UNIX, Microsoft Windows, and + other operating systems use ".." as a path component to indicate a + directory level above the current one. On such a system, an HTTP + server MUST disallow any such construct in the Request-URI if it + would otherwise allow access to a resource outside those intended to + be accessible via the HTTP server. Similarly, files intended for + reference only internally to the server (such as access control + files, configuration files, and script code) MUST be protected from + inappropriate retrieval, since they might contain sensitive + information. Experience has shown that minor bugs in such HTTP server + implementations have turned into security risks. + + + + +Fielding, et al. Standards Track [Page 153] + +RFC 2616 HTTP/1.1 June 1999 + + +15.3 DNS Spoofing + + Clients using HTTP rely heavily on the Domain Name Service, and are + thus generally prone to security attacks based on the deliberate + mis-association of IP addresses and DNS names. Clients need to be + cautious in assuming the continuing validity of an IP number/DNS name + association. + + In particular, HTTP clients SHOULD rely on their name resolver for + confirmation of an IP number/DNS name association, rather than + caching the result of previous host name lookups. Many platforms + already can cache host name lookups locally when appropriate, and + they SHOULD be configured to do so. It is proper for these lookups to + be cached, however, only when the TTL (Time To Live) information + reported by the name server makes it likely that the cached + information will remain useful. + + If HTTP clients cache the results of host name lookups in order to + achieve a performance improvement, they MUST observe the TTL + information reported by DNS. + + If HTTP clients do not observe this rule, they could be spoofed when + a previously-accessed server's IP address changes. As network + renumbering is expected to become increasingly common [24], the + possibility of this form of attack will grow. Observing this + requirement thus reduces this potential security vulnerability. + + This requirement also improves the load-balancing behavior of clients + for replicated servers using the same DNS name and reduces the + likelihood of a user's experiencing failure in accessing sites which + use that strategy. + +15.4 Location Headers and Spoofing + + If a single server supports multiple organizations that do not trust + one another, then it MUST check the values of Location and Content- + Location headers in responses that are generated under control of + said organizations to make sure that they do not attempt to + invalidate resources over which they have no authority. + +15.5 Content-Disposition Issues + + RFC 1806 [35], from which the often implemented Content-Disposition + (see section 19.5.1) header in HTTP is derived, has a number of very + serious security considerations. Content-Disposition is not part of + the HTTP standard, but since it is widely implemented, we are + documenting its use and risks for implementors. See RFC 2183 [49] + (which updates RFC 1806) for details. + + + +Fielding, et al. Standards Track [Page 154] + +RFC 2616 HTTP/1.1 June 1999 + + +15.6 Authentication Credentials and Idle Clients + + Existing HTTP clients and user agents typically retain authentication + information indefinitely. HTTP/1.1. does not provide a method for a + server to direct clients to discard these cached credentials. This is + a significant defect that requires further extensions to HTTP. + Circumstances under which credential caching can interfere with the + application's security model include but are not limited to: + + - Clients which have been idle for an extended period following + which the server might wish to cause the client to reprompt the + user for credentials. + + - Applications which include a session termination indication + (such as a `logout' or `commit' button on a page) after which + the server side of the application `knows' that there is no + further reason for the client to retain the credentials. + + This is currently under separate study. There are a number of work- + arounds to parts of this problem, and we encourage the use of + password protection in screen savers, idle time-outs, and other + methods which mitigate the security problems inherent in this + problem. In particular, user agents which cache credentials are + encouraged to provide a readily accessible mechanism for discarding + cached credentials under user control. + +15.7 Proxies and Caching + + By their very nature, HTTP proxies are men-in-the-middle, and + represent an opportunity for man-in-the-middle attacks. Compromise of + the systems on which the proxies run can result in serious security + and privacy problems. Proxies have access to security-related + information, personal information about individual users and + organizations, and proprietary information belonging to users and + content providers. A compromised proxy, or a proxy implemented or + configured without regard to security and privacy considerations, + might be used in the commission of a wide range of potential attacks. + + Proxy operators should protect the systems on which proxies run as + they would protect any system that contains or transports sensitive + information. In particular, log information gathered at proxies often + contains highly sensitive personal information, and/or information + about organizations. Log information should be carefully guarded, and + appropriate guidelines for use developed and followed. (Section + 15.1.1). + + + + + + +Fielding, et al. Standards Track [Page 155] + +RFC 2616 HTTP/1.1 June 1999 + + + Caching proxies provide additional potential vulnerabilities, since + the contents of the cache represent an attractive target for + malicious exploitation. Because cache contents persist after an HTTP + request is complete, an attack on the cache can reveal information + long after a user believes that the information has been removed from + the network. Therefore, cache contents should be protected as + sensitive information. + + Proxy implementors should consider the privacy and security + implications of their design and coding decisions, and of the + configuration options they provide to proxy operators (especially the + default configuration). + + Users of a proxy need to be aware that they are no trustworthier than + the people who run the proxy; HTTP itself cannot solve this problem. + + The judicious use of cryptography, when appropriate, may suffice to + protect against a broad range of security and privacy attacks. Such + cryptography is beyond the scope of the HTTP/1.1 specification. + +15.7.1 Denial of Service Attacks on Proxies + + They exist. They are hard to defend against. Research continues. + Beware. + +16 Acknowledgments + + This specification makes heavy use of the augmented BNF and generic + constructs defined by David H. Crocker for RFC 822 [9]. Similarly, it + reuses many of the definitions provided by Nathaniel Borenstein and + Ned Freed for MIME [7]. We hope that their inclusion in this + specification will help reduce past confusion over the relationship + between HTTP and Internet mail message formats. + + The HTTP protocol has evolved considerably over the years. It has + benefited from a large and active developer community--the many + people who have participated on the www-talk mailing list--and it is + that community which has been most responsible for the success of + HTTP and of the World-Wide Web in general. Marc Andreessen, Robert + Cailliau, Daniel W. Connolly, Bob Denny, John Franks, Jean-Francois + Groff, Phillip M. Hallam-Baker, Hakon W. Lie, Ari Luotonen, Rob + McCool, Lou Montulli, Dave Raggett, Tony Sanders, and Marc + VanHeyningen deserve special recognition for their efforts in + defining early aspects of the protocol. + + This document has benefited greatly from the comments of all those + participating in the HTTP-WG. In addition to those already mentioned, + the following individuals have contributed to this specification: + + + +Fielding, et al. Standards Track [Page 156] + +RFC 2616 HTTP/1.1 June 1999 + + + Gary Adams Ross Patterson + Harald Tveit Alvestrand Albert Lunde + Keith Ball John C. Mallery + Brian Behlendorf Jean-Philippe Martin-Flatin + Paul Burchard Mitra + Maurizio Codogno David Morris + Mike Cowlishaw Gavin Nicol + Roman Czyborra Bill Perry + Michael A. Dolan Jeffrey Perry + David J. Fiander Scott Powers + Alan Freier Owen Rees + Marc Hedlund Luigi Rizzo + Greg Herlihy David Robinson + Koen Holtman Marc Salomon + Alex Hopmann Rich Salz + Bob Jernigan Allan M. Schiffman + Shel Kaphan Jim Seidman + Rohit Khare Chuck Shotton + John Klensin Eric W. Sink + Martijn Koster Simon E. Spero + Alexei Kosut Richard N. Taylor + David M. Kristol Robert S. Thau + Daniel LaLiberte Bill (BearHeart) Weinman + Ben Laurie Francois Yergeau + Paul J. Leach Mary Ellen Zurko + Daniel DuBois Josh Cohen + + + Much of the content and presentation of the caching design is due to + suggestions and comments from individuals including: Shel Kaphan, + Paul Leach, Koen Holtman, David Morris, and Larry Masinter. + + Most of the specification of ranges is based on work originally done + by Ari Luotonen and John Franks, with additional input from Steve + Zilles. + + Thanks to the "cave men" of Palo Alto. You know who you are. + + Jim Gettys (the current editor of this document) wishes particularly + to thank Roy Fielding, the previous editor of this document, along + with John Klensin, Jeff Mogul, Paul Leach, Dave Kristol, Koen + Holtman, John Franks, Josh Cohen, Alex Hopmann, Scott Lawrence, and + Larry Masinter for their help. And thanks go particularly to Jeff + Mogul and Scott Lawrence for performing the "MUST/MAY/SHOULD" audit. + + + + + + + +Fielding, et al. Standards Track [Page 157] + +RFC 2616 HTTP/1.1 June 1999 + + + The Apache Group, Anselm Baird-Smith, author of Jigsaw, and Henrik + Frystyk implemented RFC 2068 early, and we wish to thank them for the + discovery of many of the problems that this document attempts to + rectify. + +17 References + + [1] Alvestrand, H., "Tags for the Identification of Languages", RFC + 1766, March 1995. + + [2] Anklesaria, F., McCahill, M., Lindner, P., Johnson, D., Torrey, + D. and B. Alberti, "The Internet Gopher Protocol (a distributed + document search and retrieval protocol)", RFC 1436, March 1993. + + [3] Berners-Lee, T., "Universal Resource Identifiers in WWW", RFC + 1630, June 1994. + + [4] Berners-Lee, T., Masinter, L. and M. McCahill, "Uniform Resource + Locators (URL)", RFC 1738, December 1994. + + [5] Berners-Lee, T. and D. Connolly, "Hypertext Markup Language - + 2.0", RFC 1866, November 1995. + + [6] Berners-Lee, T., Fielding, R. and H. Frystyk, "Hypertext Transfer + Protocol -- HTTP/1.0", RFC 1945, May 1996. + + [7] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part One: Format of Internet Message Bodies", + RFC 2045, November 1996. + + [8] Braden, R., "Requirements for Internet Hosts -- Communication + Layers", STD 3, RFC 1123, October 1989. + + [9] Crocker, D., "Standard for The Format of ARPA Internet Text + Messages", STD 11, RFC 822, August 1982. + + [10] Davis, F., Kahle, B., Morris, H., Salem, J., Shen, T., Wang, R., + Sui, J., and M. Grinbaum, "WAIS Interface Protocol Prototype + Functional Specification," (v1.5), Thinking Machines + Corporation, April 1990. + + [11] Fielding, R., "Relative Uniform Resource Locators", RFC 1808, + June 1995. + + [12] Horton, M. and R. Adams, "Standard for Interchange of USENET + Messages", RFC 1036, December 1987. + + + + + +Fielding, et al. Standards Track [Page 158] + +RFC 2616 HTTP/1.1 June 1999 + + + [13] Kantor, B. and P. Lapsley, "Network News Transfer Protocol", RFC + 977, February 1986. + + [14] Moore, K., "MIME (Multipurpose Internet Mail Extensions) Part + Three: Message Header Extensions for Non-ASCII Text", RFC 2047, + November 1996. + + [15] Nebel, E. and L. Masinter, "Form-based File Upload in HTML", RFC + 1867, November 1995. + + [16] Postel, J., "Simple Mail Transfer Protocol", STD 10, RFC 821, + August 1982. + + [17] Postel, J., "Media Type Registration Procedure", RFC 1590, + November 1996. + + [18] Postel, J. and J. Reynolds, "File Transfer Protocol", STD 9, RFC + 959, October 1985. + + [19] Reynolds, J. and J. Postel, "Assigned Numbers", STD 2, RFC 1700, + October 1994. + + [20] Sollins, K. and L. Masinter, "Functional Requirements for + Uniform Resource Names", RFC 1737, December 1994. + + [21] US-ASCII. Coded Character Set - 7-Bit American Standard Code for + Information Interchange. Standard ANSI X3.4-1986, ANSI, 1986. + + [22] ISO-8859. International Standard -- Information Processing -- + 8-bit Single-Byte Coded Graphic Character Sets -- + Part 1: Latin alphabet No. 1, ISO-8859-1:1987. + Part 2: Latin alphabet No. 2, ISO-8859-2, 1987. + Part 3: Latin alphabet No. 3, ISO-8859-3, 1988. + Part 4: Latin alphabet No. 4, ISO-8859-4, 1988. + Part 5: Latin/Cyrillic alphabet, ISO-8859-5, 1988. + Part 6: Latin/Arabic alphabet, ISO-8859-6, 1987. + Part 7: Latin/Greek alphabet, ISO-8859-7, 1987. + Part 8: Latin/Hebrew alphabet, ISO-8859-8, 1988. + Part 9: Latin alphabet No. 5, ISO-8859-9, 1990. + + [23] Meyers, J. and M. Rose, "The Content-MD5 Header Field", RFC + 1864, October 1995. + + [24] Carpenter, B. and Y. Rekhter, "Renumbering Needs Work", RFC + 1900, February 1996. + + [25] Deutsch, P., "GZIP file format specification version 4.3", RFC + 1952, May 1996. + + + +Fielding, et al. Standards Track [Page 159] + +RFC 2616 HTTP/1.1 June 1999 + + + [26] Venkata N. Padmanabhan, and Jeffrey C. Mogul. "Improving HTTP + Latency", Computer Networks and ISDN Systems, v. 28, pp. 25-35, + Dec. 1995. Slightly revised version of paper in Proc. 2nd + International WWW Conference '94: Mosaic and the Web, Oct. 1994, + which is available at + http://www.ncsa.uiuc.edu/SDG/IT94/Proceedings/DDay/mogul/HTTPLat + ency.html. + + [27] Joe Touch, John Heidemann, and Katia Obraczka. "Analysis of HTTP + Performance", , + ISI Research Report ISI/RR-98-463, (original report dated Aug. + 1996), USC/Information Sciences Institute, August 1998. + + [28] Mills, D., "Network Time Protocol (Version 3) Specification, + Implementation and Analysis", RFC 1305, March 1992. + + [29] Deutsch, P., "DEFLATE Compressed Data Format Specification + version 1.3", RFC 1951, May 1996. + + [30] S. Spero, "Analysis of HTTP Performance Problems," + http://sunsite.unc.edu/mdma-release/http-prob.html. + + [31] Deutsch, P. and J. Gailly, "ZLIB Compressed Data Format + Specification version 3.3", RFC 1950, May 1996. + + [32] Franks, J., Hallam-Baker, P., Hostetler, J., Leach, P., + Luotonen, A., Sink, E. and L. Stewart, "An Extension to HTTP: + Digest Access Authentication", RFC 2069, January 1997. + + [33] Fielding, R., Gettys, J., Mogul, J., Frystyk, H. and T. + Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1", RFC + 2068, January 1997. + + [34] Bradner, S., "Key words for use in RFCs to Indicate Requirement + Levels", BCP 14, RFC 2119, March 1997. + + [35] Troost, R. and Dorner, S., "Communicating Presentation + Information in Internet Messages: The Content-Disposition + Header", RFC 1806, June 1995. + + [36] Mogul, J., Fielding, R., Gettys, J. and H. Frystyk, "Use and + Interpretation of HTTP Version Numbers", RFC 2145, May 1997. + [jg639] + + [37] Palme, J., "Common Internet Message Headers", RFC 2076, February + 1997. [jg640] + + + + + +Fielding, et al. Standards Track [Page 160] + +RFC 2616 HTTP/1.1 June 1999 + + + [38] Yergeau, F., "UTF-8, a transformation format of Unicode and + ISO-10646", RFC 2279, January 1998. [jg641] + + [39] Nielsen, H.F., Gettys, J., Baird-Smith, A., Prud'hommeaux, E., + Lie, H., and C. Lilley. "Network Performance Effects of + HTTP/1.1, CSS1, and PNG," Proceedings of ACM SIGCOMM '97, Cannes + France, September 1997.[jg642] + + [40] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Two: Media Types", RFC 2046, November + 1996. [jg643] + + [41] Alvestrand, H., "IETF Policy on Character Sets and Languages", + BCP 18, RFC 2277, January 1998. [jg644] + + [42] Berners-Lee, T., Fielding, R. and L. Masinter, "Uniform Resource + Identifiers (URI): Generic Syntax and Semantics", RFC 2396, + August 1998. [jg645] + + [43] Franks, J., Hallam-Baker, P., Hostetler, J., Lawrence, S., + Leach, P., Luotonen, A., Sink, E. and L. Stewart, "HTTP + Authentication: Basic and Digest Access Authentication", RFC + 2617, June 1999. [jg646] + + [44] Luotonen, A., "Tunneling TCP based protocols through Web proxy + servers," Work in Progress. [jg647] + + [45] Palme, J. and A. Hopmann, "MIME E-mail Encapsulation of + Aggregate Documents, such as HTML (MHTML)", RFC 2110, March + 1997. + + [46] Bradner, S., "The Internet Standards Process -- Revision 3", BCP + 9, RFC 2026, October 1996. + + [47] Masinter, L., "Hyper Text Coffee Pot Control Protocol + (HTCPCP/1.0)", RFC 2324, 1 April 1998. + + [48] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Five: Conformance Criteria and Examples", + RFC 2049, November 1996. + + [49] Troost, R., Dorner, S. and K. Moore, "Communicating Presentation + Information in Internet Messages: The Content-Disposition Header + Field", RFC 2183, August 1997. + + + + + + + +Fielding, et al. Standards Track [Page 161] + +RFC 2616 HTTP/1.1 June 1999 + + +18 Authors' Addresses + + Roy T. Fielding + Information and Computer Science + University of California, Irvine + Irvine, CA 92697-3425, USA + + Fax: +1 (949) 824-1715 + EMail: fielding@ics.uci.edu + + + James Gettys + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: jg@w3.org + + + Jeffrey C. Mogul + Western Research Laboratory + Compaq Computer Corporation + 250 University Avenue + Palo Alto, California, 94305, USA + + EMail: mogul@wrl.dec.com + + + Henrik Frystyk Nielsen + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: frystyk@w3.org + + + Larry Masinter + Xerox Corporation + 3333 Coyote Hill Road + Palo Alto, CA 94034, USA + + EMail: masinter@parc.xerox.com + + + + + +Fielding, et al. Standards Track [Page 162] + +RFC 2616 HTTP/1.1 June 1999 + + + Paul J. Leach + Microsoft Corporation + 1 Microsoft Way + Redmond, WA 98052, USA + + EMail: paulle@microsoft.com + + + Tim Berners-Lee + Director, World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: timbl@w3.org + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 163] + +RFC 2616 HTTP/1.1 June 1999 + + +19 Appendices + +19.1 Internet Media Type message/http and application/http + + In addition to defining the HTTP/1.1 protocol, this document serves + as the specification for the Internet media type "message/http" and + "application/http". The message/http type can be used to enclose a + single HTTP request or response message, provided that it obeys the + MIME restrictions for all "message" types regarding line length and + encodings. The application/http type can be used to enclose a + pipeline of one or more HTTP request or response messages (not + intermixed). The following is to be registered with IANA [17]. + + Media Type name: message + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed message + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + Media Type name: application + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed messages + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: HTTP messages enclosed by this type + are in "binary" format; use of an appropriate + Content-Transfer-Encoding is required when + transmitted via E-mail. + Security considerations: none + + + + + + + + + +Fielding, et al. Standards Track [Page 164] + +RFC 2616 HTTP/1.1 June 1999 + + +19.2 Internet Media Type multipart/byteranges + + When an HTTP 206 (Partial Content) response message includes the + content of multiple ranges (a response to a request for multiple + non-overlapping ranges), these are transmitted as a multipart + message-body. The media type for this purpose is called + "multipart/byteranges". + + The multipart/byteranges media type includes two or more parts, each + with its own Content-Type and Content-Range fields. The required + boundary parameter specifies the boundary string used to separate + each body-part. + + Media Type name: multipart + Media subtype name: byteranges + Required parameters: boundary + Optional parameters: none + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + + For example: + + HTTP/1.1 206 Partial Content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-type: multipart/byteranges; boundary=THIS_STRING_SEPARATES + + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 500-999/8000 + + ...the first range... + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 7000-7999/8000 + + ...the second range + --THIS_STRING_SEPARATES-- + + Notes: + + 1) Additional CRLFs may precede the first boundary string in the + entity. + + + + + + +Fielding, et al. Standards Track [Page 165] + +RFC 2616 HTTP/1.1 June 1999 + + + 2) Although RFC 2046 [40] permits the boundary string to be + quoted, some existing implementations handle a quoted boundary + string incorrectly. + + 3) A number of browsers and servers were coded to an early draft + of the byteranges specification to use a media type of + multipart/x-byteranges, which is almost, but not quite + compatible with the version documented in HTTP/1.1. + +19.3 Tolerant Applications + + Although this document specifies the requirements for the generation + of HTTP/1.1 messages, not all applications will be correct in their + implementation. We therefore recommend that operational applications + be tolerant of deviations whenever those deviations can be + interpreted unambiguously. + + Clients SHOULD be tolerant in parsing the Status-Line and servers + tolerant when parsing the Request-Line. In particular, they SHOULD + accept any amount of SP or HT characters between fields, even though + only a single SP is required. + + The line terminator for message-header fields is the sequence CRLF. + However, we recommend that applications, when parsing such headers, + recognize a single LF as a line terminator and ignore the leading CR. + + The character set of an entity-body SHOULD be labeled as the lowest + common denominator of the character codes used within that body, with + the exception that not labeling the entity is preferred over labeling + the entity with the labels US-ASCII or ISO-8859-1. See section 3.7.1 + and 3.4.1. + + Additional rules for requirements on parsing and encoding of dates + and other potential problems with date encodings include: + + - HTTP/1.1 clients and caches SHOULD assume that an RFC-850 date + which appears to be more than 50 years in the future is in fact + in the past (this helps solve the "year 2000" problem). + + - An HTTP/1.1 implementation MAY internally represent a parsed + Expires date as earlier than the proper value, but MUST NOT + internally represent a parsed Expires date as later than the + proper value. + + - All expiration-related calculations MUST be done in GMT. The + local time zone MUST NOT influence the calculation or comparison + of an age or expiration time. + + + + +Fielding, et al. Standards Track [Page 166] + +RFC 2616 HTTP/1.1 June 1999 + + + - If an HTTP header incorrectly carries a date value with a time + zone other than GMT, it MUST be converted into GMT using the + most conservative possible conversion. + +19.4 Differences Between HTTP Entities and RFC 2045 Entities + + HTTP/1.1 uses many of the constructs defined for Internet Mail (RFC + 822 [9]) and the Multipurpose Internet Mail Extensions (MIME [7]) to + allow entities to be transmitted in an open variety of + representations and with extensible mechanisms. However, RFC 2045 + discusses mail, and HTTP has a few features that are different from + those described in RFC 2045. These differences were carefully chosen + to optimize performance over binary connections, to allow greater + freedom in the use of new media types, to make date comparisons + easier, and to acknowledge the practice of some early HTTP servers + and clients. + + This appendix describes specific areas where HTTP differs from RFC + 2045. Proxies and gateways to strict MIME environments SHOULD be + aware of these differences and provide the appropriate conversions + where necessary. Proxies and gateways from MIME environments to HTTP + also need to be aware of the differences because some conversions + might be required. + +19.4.1 MIME-Version + + HTTP is not a MIME-compliant protocol. However, HTTP/1.1 messages MAY + include a single MIME-Version general-header field to indicate what + version of the MIME protocol was used to construct the message. Use + of the MIME-Version header field indicates that the message is in + full compliance with the MIME protocol (as defined in RFC 2045[7]). + Proxies/gateways are responsible for ensuring full compliance (where + possible) when exporting HTTP messages to strict MIME environments. + + MIME-Version = "MIME-Version" ":" 1*DIGIT "." 1*DIGIT + + MIME version "1.0" is the default for use in HTTP/1.1. However, + HTTP/1.1 message parsing and semantics are defined by this document + and not the MIME specification. + +19.4.2 Conversion to Canonical Form + + RFC 2045 [7] requires that an Internet mail entity be converted to + canonical form prior to being transferred, as described in section 4 + of RFC 2049 [48]. Section 3.7.1 of this document describes the forms + allowed for subtypes of the "text" media type when transmitted over + HTTP. RFC 2046 requires that content with a type of "text" represent + line breaks as CRLF and forbids the use of CR or LF outside of line + + + +Fielding, et al. Standards Track [Page 167] + +RFC 2616 HTTP/1.1 June 1999 + + + break sequences. HTTP allows CRLF, bare CR, and bare LF to indicate a + line break within text content when a message is transmitted over + HTTP. + + Where it is possible, a proxy or gateway from HTTP to a strict MIME + environment SHOULD translate all line breaks within the text media + types described in section 3.7.1 of this document to the RFC 2049 + canonical form of CRLF. Note, however, that this might be complicated + by the presence of a Content-Encoding and by the fact that HTTP + allows the use of some character sets which do not use octets 13 and + 10 to represent CR and LF, as is the case for some multi-byte + character sets. + + Implementors should note that conversion will break any cryptographic + checksums applied to the original content unless the original content + is already in canonical form. Therefore, the canonical form is + recommended for any content that uses such checksums in HTTP. + +19.4.3 Conversion of Date Formats + + HTTP/1.1 uses a restricted set of date formats (section 3.3.1) to + simplify the process of date comparison. Proxies and gateways from + other protocols SHOULD ensure that any Date header field present in a + message conforms to one of the HTTP/1.1 formats and rewrite the date + if necessary. + +19.4.4 Introduction of Content-Encoding + + RFC 2045 does not include any concept equivalent to HTTP/1.1's + Content-Encoding header field. Since this acts as a modifier on the + media type, proxies and gateways from HTTP to MIME-compliant + protocols MUST either change the value of the Content-Type header + field or decode the entity-body before forwarding the message. (Some + experimental applications of Content-Type for Internet mail have used + a media-type parameter of ";conversions=" to perform + a function equivalent to Content-Encoding. However, this parameter is + not part of RFC 2045.) + +19.4.5 No Content-Transfer-Encoding + + HTTP does not use the Content-Transfer-Encoding (CTE) field of RFC + 2045. Proxies and gateways from MIME-compliant protocols to HTTP MUST + remove any non-identity CTE ("quoted-printable" or "base64") encoding + prior to delivering the response message to an HTTP client. + + Proxies and gateways from HTTP to MIME-compliant protocols are + responsible for ensuring that the message is in the correct format + and encoding for safe transport on that protocol, where "safe + + + +Fielding, et al. Standards Track [Page 168] + +RFC 2616 HTTP/1.1 June 1999 + + + transport" is defined by the limitations of the protocol being used. + Such a proxy or gateway SHOULD label the data with an appropriate + Content-Transfer-Encoding if doing so will improve the likelihood of + safe transport over the destination protocol. + +19.4.6 Introduction of Transfer-Encoding + + HTTP/1.1 introduces the Transfer-Encoding header field (section + 14.41). Proxies/gateways MUST remove any transfer-coding prior to + forwarding a message via a MIME-compliant protocol. + + A process for decoding the "chunked" transfer-coding (section 3.6) + can be represented in pseudo-code as: + + length := 0 + read chunk-size, chunk-extension (if any) and CRLF + while (chunk-size > 0) { + read chunk-data and CRLF + append chunk-data to entity-body + length := length + chunk-size + read chunk-size and CRLF + } + read entity-header + while (entity-header not empty) { + append entity-header to existing header fields + read entity-header + } + Content-Length := length + Remove "chunked" from Transfer-Encoding + +19.4.7 MHTML and Line Length Limitations + + HTTP implementations which share code with MHTML [45] implementations + need to be aware of MIME line length limitations. Since HTTP does not + have this limitation, HTTP does not fold long lines. MHTML messages + being transported by HTTP follow all conventions of MHTML, including + line length limitations and folding, canonicalization, etc., since + HTTP transports all message-bodies as payload (see section 3.7.2) and + does not interpret the content or any MIME header lines that might be + contained therein. + +19.5 Additional Features + + RFC 1945 and RFC 2068 document protocol elements used by some + existing HTTP implementations, but not consistently and correctly + across most HTTP/1.1 applications. Implementors are advised to be + aware of these features, but cannot rely upon their presence in, or + interoperability with, other HTTP/1.1 applications. Some of these + + + +Fielding, et al. Standards Track [Page 169] + +RFC 2616 HTTP/1.1 June 1999 + + + describe proposed experimental features, and some describe features + that experimental deployment found lacking that are now addressed in + the base HTTP/1.1 specification. + + A number of other headers, such as Content-Disposition and Title, + from SMTP and MIME are also often implemented (see RFC 2076 [37]). + +19.5.1 Content-Disposition + + The Content-Disposition response-header field has been proposed as a + means for the origin server to suggest a default filename if the user + requests that the content is saved to a file. This usage is derived + from the definition of Content-Disposition in RFC 1806 [35]. + + content-disposition = "Content-Disposition" ":" + disposition-type *( ";" disposition-parm ) + disposition-type = "attachment" | disp-extension-token + disposition-parm = filename-parm | disp-extension-parm + filename-parm = "filename" "=" quoted-string + disp-extension-token = token + disp-extension-parm = token "=" ( token | quoted-string ) + + An example is + + Content-Disposition: attachment; filename="fname.ext" + + The receiving user agent SHOULD NOT respect any directory path + information present in the filename-parm parameter, which is the only + parameter believed to apply to HTTP implementations at this time. The + filename SHOULD be treated as a terminal component only. + + If this header is used in a response with the application/octet- + stream content-type, the implied suggestion is that the user agent + should not display the response, but directly enter a `save response + as...' dialog. + + See section 15.5 for Content-Disposition security issues. + +19.6 Compatibility with Previous Versions + + It is beyond the scope of a protocol specification to mandate + compliance with previous versions. HTTP/1.1 was deliberately + designed, however, to make supporting previous versions easy. It is + worth noting that, at the time of composing this specification + (1996), we would expect commercial HTTP/1.1 servers to: + + - recognize the format of the Request-Line for HTTP/0.9, 1.0, and + 1.1 requests; + + + +Fielding, et al. Standards Track [Page 170] + +RFC 2616 HTTP/1.1 June 1999 + + + - understand any valid request in the format of HTTP/0.9, 1.0, or + 1.1; + + - respond appropriately with a message in the same major version + used by the client. + + And we would expect HTTP/1.1 clients to: + + - recognize the format of the Status-Line for HTTP/1.0 and 1.1 + responses; + + - understand any valid response in the format of HTTP/0.9, 1.0, or + 1.1. + + For most implementations of HTTP/1.0, each connection is established + by the client prior to the request and closed by the server after + sending the response. Some implementations implement the Keep-Alive + version of persistent connections described in section 19.7.1 of RFC + 2068 [33]. + +19.6.1 Changes from HTTP/1.0 + + This section summarizes major differences between versions HTTP/1.0 + and HTTP/1.1. + +19.6.1.1 Changes to Simplify Multi-homed Web Servers and Conserve IP + Addresses + + The requirements that clients and servers support the Host request- + header, report an error if the Host request-header (section 14.23) is + missing from an HTTP/1.1 request, and accept absolute URIs (section + 5.1.2) are among the most important changes defined by this + specification. + + Older HTTP/1.0 clients assumed a one-to-one relationship of IP + addresses and servers; there was no other established mechanism for + distinguishing the intended server of a request than the IP address + to which that request was directed. The changes outlined above will + allow the Internet, once older HTTP clients are no longer common, to + support multiple Web sites from a single IP address, greatly + simplifying large operational Web servers, where allocation of many + IP addresses to a single host has created serious problems. The + Internet will also be able to recover the IP addresses that have been + allocated for the sole purpose of allowing special-purpose domain + names to be used in root-level HTTP URLs. Given the rate of growth of + the Web, and the number of servers already deployed, it is extremely + + + + + +Fielding, et al. Standards Track [Page 171] + +RFC 2616 HTTP/1.1 June 1999 + + + important that all implementations of HTTP (including updates to + existing HTTP/1.0 applications) correctly implement these + requirements: + + - Both clients and servers MUST support the Host request-header. + + - A client that sends an HTTP/1.1 request MUST send a Host header. + + - Servers MUST report a 400 (Bad Request) error if an HTTP/1.1 + request does not include a Host request-header. + + - Servers MUST accept absolute URIs. + +19.6.2 Compatibility with HTTP/1.0 Persistent Connections + + Some clients and servers might wish to be compatible with some + previous implementations of persistent connections in HTTP/1.0 + clients and servers. Persistent connections in HTTP/1.0 are + explicitly negotiated as they are not the default behavior. HTTP/1.0 + experimental implementations of persistent connections are faulty, + and the new facilities in HTTP/1.1 are designed to rectify these + problems. The problem was that some existing 1.0 clients may be + sending Keep-Alive to a proxy server that doesn't understand + Connection, which would then erroneously forward it to the next + inbound server, which would establish the Keep-Alive connection and + result in a hung HTTP/1.0 proxy waiting for the close on the + response. The result is that HTTP/1.0 clients must be prevented from + using Keep-Alive when talking to proxies. + + However, talking to proxies is the most important use of persistent + connections, so that prohibition is clearly unacceptable. Therefore, + we need some other mechanism for indicating a persistent connection + is desired, which is safe to use even when talking to an old proxy + that ignores Connection. Persistent connections are the default for + HTTP/1.1 messages; we introduce a new keyword (Connection: close) for + declaring non-persistence. See section 14.10. + + The original HTTP/1.0 form of persistent connections (the Connection: + Keep-Alive and Keep-Alive header) is documented in RFC 2068. [33] + +19.6.3 Changes from RFC 2068 + + This specification has been carefully audited to correct and + disambiguate key word usage; RFC 2068 had many problems in respect to + the conventions laid out in RFC 2119 [34]. + + Clarified which error code should be used for inbound server failures + (e.g. DNS failures). (Section 10.5.5). + + + +Fielding, et al. Standards Track [Page 172] + +RFC 2616 HTTP/1.1 June 1999 + + + CREATE had a race that required an Etag be sent when a resource is + first created. (Section 10.2.2). + + Content-Base was deleted from the specification: it was not + implemented widely, and there is no simple, safe way to introduce it + without a robust extension mechanism. In addition, it is used in a + similar, but not identical fashion in MHTML [45]. + + Transfer-coding and message lengths all interact in ways that + required fixing exactly when chunked encoding is used (to allow for + transfer encoding that may not be self delimiting); it was important + to straighten out exactly how message lengths are computed. (Sections + 3.6, 4.4, 7.2.2, 13.5.2, 14.13, 14.16) + + A content-coding of "identity" was introduced, to solve problems + discovered in caching. (section 3.5) + + Quality Values of zero should indicate that "I don't want something" + to allow clients to refuse a representation. (Section 3.9) + + The use and interpretation of HTTP version numbers has been clarified + by RFC 2145. Require proxies to upgrade requests to highest protocol + version they support to deal with problems discovered in HTTP/1.0 + implementations (Section 3.1) + + Charset wildcarding is introduced to avoid explosion of character set + names in accept headers. (Section 14.2) + + A case was missed in the Cache-Control model of HTTP/1.1; s-maxage + was introduced to add this missing case. (Sections 13.4, 14.8, 14.9, + 14.9.3) + + The Cache-Control: max-age directive was not properly defined for + responses. (Section 14.9.3) + + There are situations where a server (especially a proxy) does not + know the full length of a response but is capable of serving a + byterange request. We therefore need a mechanism to allow byteranges + with a content-range not indicating the full length of the message. + (Section 14.16) + + Range request responses would become very verbose if all meta-data + were always returned; by allowing the server to only send needed + headers in a 206 response, this problem can be avoided. (Section + 10.2.7, 13.5.3, and 14.27) + + + + + + +Fielding, et al. Standards Track [Page 173] + +RFC 2616 HTTP/1.1 June 1999 + + + Fix problem with unsatisfiable range requests; there are two cases: + syntactic problems, and range doesn't exist in the document. The 416 + status code was needed to resolve this ambiguity needed to indicate + an error for a byte range request that falls outside of the actual + contents of a document. (Section 10.4.17, 14.16) + + Rewrite of message transmission requirements to make it much harder + for implementors to get it wrong, as the consequences of errors here + can have significant impact on the Internet, and to deal with the + following problems: + + 1. Changing "HTTP/1.1 or later" to "HTTP/1.1", in contexts where + this was incorrectly placing a requirement on the behavior of + an implementation of a future version of HTTP/1.x + + 2. Made it clear that user-agents should retry requests, not + "clients" in general. + + 3. Converted requirements for clients to ignore unexpected 100 + (Continue) responses, and for proxies to forward 100 responses, + into a general requirement for 1xx responses. + + 4. Modified some TCP-specific language, to make it clearer that + non-TCP transports are possible for HTTP. + + 5. Require that the origin server MUST NOT wait for the request + body before it sends a required 100 (Continue) response. + + 6. Allow, rather than require, a server to omit 100 (Continue) if + it has already seen some of the request body. + + 7. Allow servers to defend against denial-of-service attacks and + broken clients. + + This change adds the Expect header and 417 status code. The message + transmission requirements fixes are in sections 8.2, 10.4.18, + 8.1.2.2, 13.11, and 14.20. + + Proxies should be able to add Content-Length when appropriate. + (Section 13.5.2) + + Clean up confusion between 403 and 404 responses. (Section 10.4.4, + 10.4.5, and 10.4.11) + + Warnings could be cached incorrectly, or not updated appropriately. + (Section 13.1.2, 13.2.4, 13.5.2, 13.5.3, 14.9.3, and 14.46) Warning + also needed to be a general header, as PUT or other methods may have + need for it in requests. + + + +Fielding, et al. Standards Track [Page 174] + +RFC 2616 HTTP/1.1 June 1999 + + + Transfer-coding had significant problems, particularly with + interactions with chunked encoding. The solution is that transfer- + codings become as full fledged as content-codings. This involves + adding an IANA registry for transfer-codings (separate from content + codings), a new header field (TE) and enabling trailer headers in the + future. Transfer encoding is a major performance benefit, so it was + worth fixing [39]. TE also solves another, obscure, downward + interoperability problem that could have occurred due to interactions + between authentication trailers, chunked encoding and HTTP/1.0 + clients.(Section 3.6, 3.6.1, and 14.39) + + The PATCH, LINK, UNLINK methods were defined but not commonly + implemented in previous versions of this specification. See RFC 2068 + [33]. + + The Alternates, Content-Version, Derived-From, Link, URI, Public and + Content-Base header fields were defined in previous versions of this + specification, but not commonly implemented. See RFC 2068 [33]. + +20 Index + + Please see the PostScript version of this RFC for the INDEX. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 175] + +RFC 2616 HTTP/1.1 June 1999 + + +21. Full Copyright Statement + + Copyright (C) The Internet Society (1999). All Rights Reserved. + + This document and translations of it may be copied and furnished to + others, and derivative works that comment on or otherwise explain it + or assist in its implementation may be prepared, copied, published + and distributed, in whole or in part, without restriction of any + kind, provided that the above copyright notice and this paragraph are + included on all such copies and derivative works. However, this + document itself may not be modified in any way, such as by removing + the copyright notice or references to the Internet Society or other + Internet organizations, except as needed for the purpose of + developing Internet standards in which case the procedures for + copyrights defined in the Internet Standards process must be + followed, or as required to translate it into languages other than + English. + + The limited permissions granted above are perpetual and will not be + revoked by the Internet Society or its successors or assigns. + + This document and the information contained herein is provided on an + "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING + TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING + BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION + HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF + MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + +Acknowledgement + + Funding for the RFC Editor function is currently provided by the + Internet Society. + + Network Working Group R. Fielding +Request for Comments: 2616 UC Irvine +Obsoletes: 2068 J. Gettys +Category: Standards Track Compaq/W3C + J. Mogul + Compaq + H. Frystyk + W3C/MIT + L. Masinter + Xerox + P. Leach + Microsoft + T. Berners-Lee + W3C/MIT + June 1999 + + + Hypertext Transfer Protocol -- HTTP/1.1 + +Status of this Memo + + This document specifies an Internet standards track protocol for the + Internet community, and requests discussion and suggestions for + improvements. Please refer to the current edition of the "Internet + Official Protocol Standards" (STD 1) for the standardization state + and status of this protocol. Distribution of this memo is unlimited. + +Copyright Notice + + Copyright (C) The Internet Society (1999). All Rights Reserved. + +Abstract + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. It is a generic, stateless, protocol which can be used for + many tasks beyond its use for hypertext, such as name servers and + distributed object management systems, through extension of its + request methods, error codes and headers [47]. A feature of HTTP is + the typing and negotiation of data representation, allowing systems + to be built independently of the data being transferred. + + HTTP has been in use by the World-Wide Web global information + initiative since 1990. This specification defines the protocol + referred to as "HTTP/1.1", and is an update to RFC 2068 [33]. + + + + + + +Fielding, et al. Standards Track [Page 1] + +RFC 2616 HTTP/1.1 June 1999 + + +Table of Contents + + 1 Introduction ...................................................7 + 1.1 Purpose......................................................7 + 1.2 Requirements .................................................8 + 1.3 Terminology ..................................................8 + 1.4 Overall Operation ...........................................12 + 2 Notational Conventions and Generic Grammar ....................14 + 2.1 Augmented BNF ...............................................14 + 2.2 Basic Rules .................................................15 + 3 Protocol Parameters ...........................................17 + 3.1 HTTP Version ................................................17 + 3.2 Uniform Resource Identifiers ................................18 + 3.2.1 General Syntax ...........................................19 + 3.2.2 http URL .................................................19 + 3.2.3 URI Comparison ...........................................20 + 3.3 Date/Time Formats ...........................................20 + 3.3.1 Full Date ................................................20 + 3.3.2 Delta Seconds ............................................21 + 3.4 Character Sets ..............................................21 + 3.4.1 Missing Charset ..........................................22 + 3.5 Content Codings .............................................23 + 3.6 Transfer Codings ............................................24 + 3.6.1 Chunked Transfer Coding ..................................25 + 3.7 Media Types .................................................26 + 3.7.1 Canonicalization and Text Defaults .......................27 + 3.7.2 Multipart Types ..........................................27 + 3.8 Product Tokens ..............................................28 + 3.9 Quality Values ..............................................29 + 3.10 Language Tags ...............................................29 + 3.11 Entity Tags .................................................30 + 3.12 Range Units .................................................30 + 4 HTTP Message ..................................................31 + 4.1 Message Types ...............................................31 + 4.2 Message Headers .............................................31 + 4.3 Message Body ................................................32 + 4.4 Message Length ..............................................33 + 4.5 General Header Fields .......................................34 + 5 Request .......................................................35 + 5.1 Request-Line ................................................35 + 5.1.1 Method ...................................................36 + 5.1.2 Request-URI ..............................................36 + 5.2 The Resource Identified by a Request ........................38 + 5.3 Request Header Fields .......................................38 + 6 Response ......................................................39 + 6.1 Status-Line .................................................39 + 6.1.1 Status Code and Reason Phrase ............................39 + 6.2 Response Header Fields ......................................41 + + + +Fielding, et al. Standards Track [Page 2] + +RFC 2616 HTTP/1.1 June 1999 + + + 7 Entity ........................................................42 + 7.1 Entity Header Fields ........................................42 + 7.2 Entity Body .................................................43 + 7.2.1 Type .....................................................43 + 7.2.2 Entity Length ............................................43 + 8 Connections ...................................................44 + 8.1 Persistent Connections ......................................44 + 8.1.1 Purpose ..................................................44 + 8.1.2 Overall Operation ........................................45 + 8.1.3 Proxy Servers ............................................46 + 8.1.4 Practical Considerations .................................46 + 8.2 Message Transmission Requirements ...........................47 + 8.2.1 Persistent Connections and Flow Control ..................47 + 8.2.2 Monitoring Connections for Error Status Messages .........48 + 8.2.3 Use of the 100 (Continue) Status .........................48 + 8.2.4 Client Behavior if Server Prematurely Closes Connection ..50 + 9 Method Definitions ............................................51 + 9.1 Safe and Idempotent Methods .................................51 + 9.1.1 Safe Methods .............................................51 + 9.1.2 Idempotent Methods .......................................51 + 9.2 OPTIONS .....................................................52 + 9.3 GET .........................................................53 + 9.4 HEAD ........................................................54 + 9.5 POST ........................................................54 + 9.6 PUT .........................................................55 + 9.7 DELETE ......................................................56 + 9.8 TRACE .......................................................56 + 9.9 CONNECT .....................................................57 + 10 Status Code Definitions ......................................57 + 10.1 Informational 1xx ...........................................57 + 10.1.1 100 Continue .............................................58 + 10.1.2 101 Switching Protocols ..................................58 + 10.2 Successful 2xx ..............................................58 + 10.2.1 200 OK ...................................................58 + 10.2.2 201 Created ..............................................59 + 10.2.3 202 Accepted .............................................59 + 10.2.4 203 Non-Authoritative Information ........................59 + 10.2.5 204 No Content ...........................................60 + 10.2.6 205 Reset Content ........................................60 + 10.2.7 206 Partial Content ......................................60 + 10.3 Redirection 3xx .............................................61 + 10.3.1 300 Multiple Choices .....................................61 + 10.3.2 301 Moved Permanently ....................................62 + 10.3.3 302 Found ................................................62 + 10.3.4 303 See Other ............................................63 + 10.3.5 304 Not Modified .........................................63 + 10.3.6 305 Use Proxy ............................................64 + 10.3.7 306 (Unused) .............................................64 + + + +Fielding, et al. Standards Track [Page 3] + +RFC 2616 HTTP/1.1 June 1999 + + + 10.3.8 307 Temporary Redirect ...................................65 + 10.4 Client Error 4xx ............................................65 + 10.4.1 400 Bad Request .........................................65 + 10.4.2 401 Unauthorized ........................................66 + 10.4.3 402 Payment Required ....................................66 + 10.4.4 403 Forbidden ...........................................66 + 10.4.5 404 Not Found ...........................................66 + 10.4.6 405 Method Not Allowed ..................................66 + 10.4.7 406 Not Acceptable ......................................67 + 10.4.8 407 Proxy Authentication Required .......................67 + 10.4.9 408 Request Timeout .....................................67 + 10.4.10 409 Conflict ............................................67 + 10.4.11 410 Gone ................................................68 + 10.4.12 411 Length Required .....................................68 + 10.4.13 412 Precondition Failed .................................68 + 10.4.14 413 Request Entity Too Large ............................69 + 10.4.15 414 Request-URI Too Long ................................69 + 10.4.16 415 Unsupported Media Type ..............................69 + 10.4.17 416 Requested Range Not Satisfiable .....................69 + 10.4.18 417 Expectation Failed ..................................70 + 10.5 Server Error 5xx ............................................70 + 10.5.1 500 Internal Server Error ................................70 + 10.5.2 501 Not Implemented ......................................70 + 10.5.3 502 Bad Gateway ..........................................70 + 10.5.4 503 Service Unavailable ..................................70 + 10.5.5 504 Gateway Timeout ......................................71 + 10.5.6 505 HTTP Version Not Supported ...........................71 + 11 Access Authentication ........................................71 + 12 Content Negotiation ..........................................71 + 12.1 Server-driven Negotiation ...................................72 + 12.2 Agent-driven Negotiation ....................................73 + 12.3 Transparent Negotiation .....................................74 + 13 Caching in HTTP ..............................................74 + 13.1.1 Cache Correctness ........................................75 + 13.1.2 Warnings .................................................76 + 13.1.3 Cache-control Mechanisms .................................77 + 13.1.4 Explicit User Agent Warnings .............................78 + 13.1.5 Exceptions to the Rules and Warnings .....................78 + 13.1.6 Client-controlled Behavior ...............................79 + 13.2 Expiration Model ............................................79 + 13.2.1 Server-Specified Expiration ..............................79 + 13.2.2 Heuristic Expiration .....................................80 + 13.2.3 Age Calculations .........................................80 + 13.2.4 Expiration Calculations ..................................83 + 13.2.5 Disambiguating Expiration Values .........................84 + 13.2.6 Disambiguating Multiple Responses ........................84 + 13.3 Validation Model ............................................85 + 13.3.1 Last-Modified Dates ......................................86 + + + +Fielding, et al. Standards Track [Page 4] + +RFC 2616 HTTP/1.1 June 1999 + + + 13.3.2 Entity Tag Cache Validators ..............................86 + 13.3.3 Weak and Strong Validators ...............................86 + 13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates.89 + 13.3.5 Non-validating Conditionals ..............................90 + 13.4 Response Cacheability .......................................91 + 13.5 Constructing Responses From Caches ..........................92 + 13.5.1 End-to-end and Hop-by-hop Headers ........................92 + 13.5.2 Non-modifiable Headers ...................................92 + 13.5.3 Combining Headers ........................................94 + 13.5.4 Combining Byte Ranges ....................................95 + 13.6 Caching Negotiated Responses ................................95 + 13.7 Shared and Non-Shared Caches ................................96 + 13.8 Errors or Incomplete Response Cache Behavior ................97 + 13.9 Side Effects of GET and HEAD ................................97 + 13.10 Invalidation After Updates or Deletions ...................97 + 13.11 Write-Through Mandatory ...................................98 + 13.12 Cache Replacement .........................................99 + 13.13 History Lists .............................................99 + 14 Header Field Definitions ....................................100 + 14.1 Accept .....................................................100 + 14.2 Accept-Charset .............................................102 + 14.3 Accept-Encoding ............................................102 + 14.4 Accept-Language ............................................104 + 14.5 Accept-Ranges ..............................................105 + 14.6 Age ........................................................106 + 14.7 Allow ......................................................106 + 14.8 Authorization ..............................................107 + 14.9 Cache-Control ..............................................108 + 14.9.1 What is Cacheable .......................................109 + 14.9.2 What May be Stored by Caches ............................110 + 14.9.3 Modifications of the Basic Expiration Mechanism .........111 + 14.9.4 Cache Revalidation and Reload Controls ..................113 + 14.9.5 No-Transform Directive ..................................115 + 14.9.6 Cache Control Extensions ................................116 + 14.10 Connection ...............................................117 + 14.11 Content-Encoding .........................................118 + 14.12 Content-Language .........................................118 + 14.13 Content-Length ...........................................119 + 14.14 Content-Location .........................................120 + 14.15 Content-MD5 ..............................................121 + 14.16 Content-Range ............................................122 + 14.17 Content-Type .............................................124 + 14.18 Date .....................................................124 + 14.18.1 Clockless Origin Server Operation ......................125 + 14.19 ETag .....................................................126 + 14.20 Expect ...................................................126 + 14.21 Expires ..................................................127 + 14.22 From .....................................................128 + + + +Fielding, et al. Standards Track [Page 5] + +RFC 2616 HTTP/1.1 June 1999 + + + 14.23 Host .....................................................128 + 14.24 If-Match .................................................129 + 14.25 If-Modified-Since ........................................130 + 14.26 If-None-Match ............................................132 + 14.27 If-Range .................................................133 + 14.28 If-Unmodified-Since ......................................134 + 14.29 Last-Modified ............................................134 + 14.30 Location .................................................135 + 14.31 Max-Forwards .............................................136 + 14.32 Pragma ...................................................136 + 14.33 Proxy-Authenticate .......................................137 + 14.34 Proxy-Authorization ......................................137 + 14.35 Range ....................................................138 + 14.35.1 Byte Ranges ...........................................138 + 14.35.2 Range Retrieval Requests ..............................139 + 14.36 Referer ..................................................140 + 14.37 Retry-After ..............................................141 + 14.38 Server ...................................................141 + 14.39 TE .......................................................142 + 14.40 Trailer ..................................................143 + 14.41 Transfer-Encoding..........................................143 + 14.42 Upgrade ..................................................144 + 14.43 User-Agent ...............................................145 + 14.44 Vary .....................................................145 + 14.45 Via ......................................................146 + 14.46 Warning ..................................................148 + 14.47 WWW-Authenticate .........................................150 + 15 Security Considerations .......................................150 + 15.1 Personal Information....................................151 + 15.1.1 Abuse of Server Log Information .........................151 + 15.1.2 Transfer of Sensitive Information .......................151 + 15.1.3 Encoding Sensitive Information in URI's .................152 + 15.1.4 Privacy Issues Connected to Accept Headers ..............152 + 15.2 Attacks Based On File and Path Names .......................153 + 15.3 DNS Spoofing ...............................................154 + 15.4 Location Headers and Spoofing ..............................154 + 15.5 Content-Disposition Issues .................................154 + 15.6 Authentication Credentials and Idle Clients ................155 + 15.7 Proxies and Caching ........................................155 + 15.7.1 Denial of Service Attacks on Proxies....................156 + 16 Acknowledgments .............................................156 + 17 References ..................................................158 + 18 Authors' Addresses ..........................................162 + 19 Appendices ..................................................164 + 19.1 Internet Media Type message/http and application/http ......164 + 19.2 Internet Media Type multipart/byteranges ...................165 + 19.3 Tolerant Applications ......................................166 + 19.4 Differences Between HTTP Entities and RFC 2045 Entities ....167 + + + +Fielding, et al. Standards Track [Page 6] + +RFC 2616 HTTP/1.1 June 1999 + + + 19.4.1 MIME-Version ............................................167 + 19.4.2 Conversion to Canonical Form ............................167 + 19.4.3 Conversion of Date Formats ..............................168 + 19.4.4 Introduction of Content-Encoding ........................168 + 19.4.5 No Content-Transfer-Encoding ............................168 + 19.4.6 Introduction of Transfer-Encoding .......................169 + 19.4.7 MHTML and Line Length Limitations .......................169 + 19.5 Additional Features ........................................169 + 19.5.1 Content-Disposition .....................................170 + 19.6 Compatibility with Previous Versions .......................170 + 19.6.1 Changes from HTTP/1.0 ...................................171 + 19.6.2 Compatibility with HTTP/1.0 Persistent Connections ......172 + 19.6.3 Changes from RFC 2068 ...................................172 + 20 Index .......................................................175 + 21 Full Copyright Statement ....................................176 + +1 Introduction + +1.1 Purpose + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. HTTP has been in use by the World-Wide Web global + information initiative since 1990. The first version of HTTP, + referred to as HTTP/0.9, was a simple protocol for raw data transfer + across the Internet. HTTP/1.0, as defined by RFC 1945 [6], improved + the protocol by allowing messages to be in the format of MIME-like + messages, containing metainformation about the data transferred and + modifiers on the request/response semantics. However, HTTP/1.0 does + not sufficiently take into consideration the effects of hierarchical + proxies, caching, the need for persistent connections, or virtual + hosts. In addition, the proliferation of incompletely-implemented + applications calling themselves "HTTP/1.0" has necessitated a + protocol version change in order for two communicating applications + to determine each other's true capabilities. + + This specification defines the protocol referred to as "HTTP/1.1". + This protocol includes more stringent requirements than HTTP/1.0 in + order to ensure reliable implementation of its features. + + Practical information systems require more functionality than simple + retrieval, including search, front-end update, and annotation. HTTP + allows an open-ended set of methods and headers that indicate the + purpose of a request [47]. It builds on the discipline of reference + provided by the Uniform Resource Identifier (URI) [3], as a location + (URL) [4] or name (URN) [20], for indicating the resource to which a + + + + + +Fielding, et al. Standards Track [Page 7] + +RFC 2616 HTTP/1.1 June 1999 + + + method is to be applied. Messages are passed in a format similar to + that used by Internet mail [9] as defined by the Multipurpose + Internet Mail Extensions (MIME) [7]. + + HTTP is also used as a generic protocol for communication between + user agents and proxies/gateways to other Internet systems, including + those supported by the SMTP [16], NNTP [13], FTP [18], Gopher [2], + and WAIS [10] protocols. In this way, HTTP allows basic hypermedia + access to resources available from diverse applications. + +1.2 Requirements + + The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", + "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this + document are to be interpreted as described in RFC 2119 [34]. + + An implementation is not compliant if it fails to satisfy one or more + of the MUST or REQUIRED level requirements for the protocols it + implements. An implementation that satisfies all the MUST or REQUIRED + level and all the SHOULD level requirements for its protocols is said + to be "unconditionally compliant"; one that satisfies all the MUST + level requirements but not all the SHOULD level requirements for its + protocols is said to be "conditionally compliant." + +1.3 Terminology + + This specification uses a number of terms to refer to the roles + played by participants in, and objects of, the HTTP communication. + + connection + A transport layer virtual circuit established between two programs + for the purpose of communication. + + message + The basic unit of HTTP communication, consisting of a structured + sequence of octets matching the syntax defined in section 4 and + transmitted via the connection. + + request + An HTTP request message, as defined in section 5. + + response + An HTTP response message, as defined in section 6. + + + + + + + + +Fielding, et al. Standards Track [Page 8] + +RFC 2616 HTTP/1.1 June 1999 + + + resource + A network data object or service that can be identified by a URI, + as defined in section 3.2. Resources may be available in multiple + representations (e.g. multiple languages, data formats, size, and + resolutions) or vary in other ways. + + entity + The information transferred as the payload of a request or + response. An entity consists of metainformation in the form of + entity-header fields and content in the form of an entity-body, as + described in section 7. + + representation + An entity included with a response that is subject to content + negotiation, as described in section 12. There may exist multiple + representations associated with a particular response status. + + content negotiation + The mechanism for selecting the appropriate representation when + servicing a request, as described in section 12. The + representation of entities in any response can be negotiated + (including error responses). + + variant + A resource may have one, or more than one, representation(s) + associated with it at any given instant. Each of these + representations is termed a `varriant'. Use of the term `variant' + does not necessarily imply that the resource is subject to content + negotiation. + + client + A program that establishes connections for the purpose of sending + requests. + + user agent + The client which initiates a request. These are often browsers, + editors, spiders (web-traversing robots), or other end user tools. + + server + An application program that accepts connections in order to + service requests by sending back responses. Any given program may + be capable of being both a client and a server; our use of these + terms refers only to the role being performed by the program for a + particular connection, rather than to the program's capabilities + in general. Likewise, any server may act as an origin server, + proxy, gateway, or tunnel, switching behavior based on the nature + of each request. + + + + +Fielding, et al. Standards Track [Page 9] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server + The server on which a given resource resides or is to be created. + + proxy + An intermediary program which acts as both a server and a client + for the purpose of making requests on behalf of other clients. + Requests are serviced internally or by passing them on, with + possible translation, to other servers. A proxy MUST implement + both the client and server requirements of this specification. A + "transparent proxy" is a proxy that does not modify the request or + response beyond what is required for proxy authentication and + identification. A "non-transparent proxy" is a proxy that modifies + the request or response in order to provide some added service to + the user agent, such as group annotation services, media type + transformation, protocol reduction, or anonymity filtering. Except + where either transparent or non-transparent behavior is explicitly + stated, the HTTP proxy requirements apply to both types of + proxies. + + gateway + A server which acts as an intermediary for some other server. + Unlike a proxy, a gateway receives requests as if it were the + origin server for the requested resource; the requesting client + may not be aware that it is communicating with a gateway. + + tunnel + An intermediary program which is acting as a blind relay between + two connections. Once active, a tunnel is not considered a party + to the HTTP communication, though the tunnel may have been + initiated by an HTTP request. The tunnel ceases to exist when both + ends of the relayed connections are closed. + + cache + A program's local store of response messages and the subsystem + that controls its message storage, retrieval, and deletion. A + cache stores cacheable responses in order to reduce the response + time and network bandwidth consumption on future, equivalent + requests. Any client or server may include a cache, though a cache + cannot be used by a server that is acting as a tunnel. + + cacheable + A response is cacheable if a cache is allowed to store a copy of + the response message for use in answering subsequent requests. The + rules for determining the cacheability of HTTP responses are + defined in section 13. Even if a resource is cacheable, there may + be additional constraints on whether a cache can use the cached + copy for a particular request. + + + + +Fielding, et al. Standards Track [Page 10] + +RFC 2616 HTTP/1.1 June 1999 + + + first-hand + A response is first-hand if it comes directly and without + unnecessary delay from the origin server, perhaps via one or more + proxies. A response is also first-hand if its validity has just + been checked directly with the origin server. + + explicit expiration time + The time at which the origin server intends that an entity should + no longer be returned by a cache without further validation. + + heuristic expiration time + An expiration time assigned by a cache when no explicit expiration + time is available. + + age + The age of a response is the time since it was sent by, or + successfully validated with, the origin server. + + freshness lifetime + The length of time between the generation of a response and its + expiration time. + + fresh + A response is fresh if its age has not yet exceeded its freshness + lifetime. + + stale + A response is stale if its age has passed its freshness lifetime. + + semantically transparent + A cache behaves in a "semantically transparent" manner, with + respect to a particular response, when its use affects neither the + requesting client nor the origin server, except to improve + performance. When a cache is semantically transparent, the client + receives exactly the same response (except for hop-by-hop headers) + that it would have received had its request been handled directly + by the origin server. + + validator + A protocol element (e.g., an entity tag or a Last-Modified time) + that is used to find out whether a cache entry is an equivalent + copy of an entity. + + upstream/downstream + Upstream and downstream describe the flow of a message: all + messages flow from upstream to downstream. + + + + + +Fielding, et al. Standards Track [Page 11] + +RFC 2616 HTTP/1.1 June 1999 + + + inbound/outbound + Inbound and outbound refer to the request and response paths for + messages: "inbound" means "traveling toward the origin server", + and "outbound" means "traveling toward the user agent" + +1.4 Overall Operation + + The HTTP protocol is a request/response protocol. A client sends a + request to the server in the form of a request method, URI, and + protocol version, followed by a MIME-like message containing request + modifiers, client information, and possible body content over a + connection with a server. The server responds with a status line, + including the message's protocol version and a success or error code, + followed by a MIME-like message containing server information, entity + metainformation, and possible entity-body content. The relationship + between HTTP and MIME is described in appendix 19.4. + + Most HTTP communication is initiated by a user agent and consists of + a request to be applied to a resource on some origin server. In the + simplest case, this may be accomplished via a single connection (v) + between the user agent (UA) and the origin server (O). + + request chain ------------------------> + UA -------------------v------------------- O + <----------------------- response chain + + A more complicated situation occurs when one or more intermediaries + are present in the request/response chain. There are three common + forms of intermediary: proxy, gateway, and tunnel. A proxy is a + forwarding agent, receiving requests for a URI in its absolute form, + rewriting all or part of the message, and forwarding the reformatted + request toward the server identified by the URI. A gateway is a + receiving agent, acting as a layer above some other server(s) and, if + necessary, translating the requests to the underlying server's + protocol. A tunnel acts as a relay point between two connections + without changing the messages; tunnels are used when the + communication needs to pass through an intermediary (such as a + firewall) even when the intermediary cannot understand the contents + of the messages. + + request chain --------------------------------------> + UA -----v----- A -----v----- B -----v----- C -----v----- O + <------------------------------------- response chain + + The figure above shows three intermediaries (A, B, and C) between the + user agent and origin server. A request or response message that + travels the whole chain will pass through four separate connections. + This distinction is important because some HTTP communication options + + + +Fielding, et al. Standards Track [Page 12] + +RFC 2616 HTTP/1.1 June 1999 + + + may apply only to the connection with the nearest, non-tunnel + neighbor, only to the end-points of the chain, or to all connections + along the chain. Although the diagram is linear, each participant may + be engaged in multiple, simultaneous communications. For example, B + may be receiving requests from many clients other than A, and/or + forwarding requests to servers other than C, at the same time that it + is handling A's request. + + Any party to the communication which is not acting as a tunnel may + employ an internal cache for handling requests. The effect of a cache + is that the request/response chain is shortened if one of the + participants along the chain has a cached response applicable to that + request. The following illustrates the resulting chain if B has a + cached copy of an earlier response from O (via C) for a request which + has not been cached by UA or A. + + request chain ----------> + UA -----v----- A -----v----- B - - - - - - C - - - - - - O + <--------- response chain + + Not all responses are usefully cacheable, and some requests may + contain modifiers which place special requirements on cache behavior. + HTTP requirements for cache behavior and cacheable responses are + defined in section 13. + + In fact, there are a wide variety of architectures and configurations + of caches and proxies currently being experimented with or deployed + across the World Wide Web. These systems include national hierarchies + of proxy caches to save transoceanic bandwidth, systems that + broadcast or multicast cache entries, organizations that distribute + subsets of cached data via CD-ROM, and so on. HTTP systems are used + in corporate intranets over high-bandwidth links, and for access via + PDAs with low-power radio links and intermittent connectivity. The + goal of HTTP/1.1 is to support the wide diversity of configurations + already deployed while introducing protocol constructs that meet the + needs of those who build web applications that require high + reliability and, failing that, at least reliable indications of + failure. + + HTTP communication usually takes place over TCP/IP connections. The + default port is TCP 80 [19], but other ports can be used. This does + not preclude HTTP from being implemented on top of any other protocol + on the Internet, or on other networks. HTTP only presumes a reliable + transport; any protocol that provides such guarantees can be used; + the mapping of the HTTP/1.1 request and response structures onto the + transport data units of the protocol in question is outside the scope + of this specification. + + + + +Fielding, et al. Standards Track [Page 13] + +RFC 2616 HTTP/1.1 June 1999 + + + In HTTP/1.0, most implementations used a new connection for each + request/response exchange. In HTTP/1.1, a connection may be used for + one or more request/response exchanges, although connections may be + closed for a variety of reasons (see section 8.1). + +2 Notational Conventions and Generic Grammar + +2.1 Augmented BNF + + All of the mechanisms specified in this document are described in + both prose and an augmented Backus-Naur Form (BNF) similar to that + used by RFC 822 [9]. Implementors will need to be familiar with the + notation in order to understand this specification. The augmented BNF + includes the following constructs: + + name = definition + The name of a rule is simply the name itself (without any + enclosing "<" and ">") and is separated from its definition by the + equal "=" character. White space is only significant in that + indentation of continuation lines is used to indicate a rule + definition that spans more than one line. Certain basic rules are + in uppercase, such as SP, LWS, HT, CRLF, DIGIT, ALPHA, etc. Angle + brackets are used within definitions whenever their presence will + facilitate discerning the use of rule names. + + "literal" + Quotation marks surround literal text. Unless stated otherwise, + the text is case-insensitive. + + rule1 | rule2 + Elements separated by a bar ("|") are alternatives, e.g., "yes | + no" will accept yes or no. + + (rule1 rule2) + Elements enclosed in parentheses are treated as a single element. + Thus, "(elem (foo | bar) elem)" allows the token sequences "elem + foo elem" and "elem bar elem". + + *rule + The character "*" preceding an element indicates repetition. The + full form is "*element" indicating at least and at most + occurrences of element. Default values are 0 and infinity so + that "*(element)" allows any number, including zero; "1*element" + requires at least one; and "1*2element" allows one or two. + + [rule] + Square brackets enclose optional elements; "[foo bar]" is + equivalent to "*1(foo bar)". + + + +Fielding, et al. Standards Track [Page 14] + +RFC 2616 HTTP/1.1 June 1999 + + + N rule + Specific repetition: "(element)" is equivalent to + "*(element)"; that is, exactly occurrences of (element). + Thus 2DIGIT is a 2-digit number, and 3ALPHA is a string of three + alphabetic characters. + + #rule + A construct "#" is defined, similar to "*", for defining lists of + elements. The full form is "#element" indicating at least + and at most elements, each separated by one or more commas + (",") and OPTIONAL linear white space (LWS). This makes the usual + form of lists very easy; a rule such as + ( *LWS element *( *LWS "," *LWS element )) + can be shown as + 1#element + Wherever this construct is used, null elements are allowed, but do + not contribute to the count of elements present. That is, + "(element), , (element) " is permitted, but counts as only two + elements. Therefore, where at least one element is required, at + least one non-null element MUST be present. Default values are 0 + and infinity so that "#element" allows any number, including zero; + "1#element" requires at least one; and "1#2element" allows one or + two. + + ; comment + A semi-colon, set off some distance to the right of rule text, + starts a comment that continues to the end of line. This is a + simple way of including useful notes in parallel with the + specifications. + + implied *LWS + The grammar described by this specification is word-based. Except + where noted otherwise, linear white space (LWS) can be included + between any two adjacent words (token or quoted-string), and + between adjacent words and separators, without changing the + interpretation of a field. At least one delimiter (LWS and/or + + separators) MUST exist between any two tokens (for the definition + of "token" below), since they would otherwise be interpreted as a + single token. + +2.2 Basic Rules + + The following rules are used throughout this specification to + describe basic parsing constructs. The US-ASCII coded character set + is defined by ANSI X3.4-1986 [21]. + + + + + +Fielding, et al. Standards Track [Page 15] + +RFC 2616 HTTP/1.1 June 1999 + + + OCTET = + CHAR = + UPALPHA = + LOALPHA = + ALPHA = UPALPHA | LOALPHA + DIGIT = + CTL = + CR = + LF = + SP = + HT = + <"> = + + HTTP/1.1 defines the sequence CR LF as the end-of-line marker for all + protocol elements except the entity-body (see appendix 19.3 for + tolerant applications). The end-of-line marker within an entity-body + is defined by its associated media type, as described in section 3.7. + + CRLF = CR LF + + HTTP/1.1 header field values can be folded onto multiple lines if the + continuation line begins with a space or horizontal tab. All linear + white space, including folding, has the same semantics as SP. A + recipient MAY replace any linear white space with a single SP before + interpreting the field value or forwarding the message downstream. + + LWS = [CRLF] 1*( SP | HT ) + + The TEXT rule is only used for descriptive field contents and values + that are not intended to be interpreted by the message parser. Words + of *TEXT MAY contain characters from character sets other than ISO- + 8859-1 [22] only when encoded according to the rules of RFC 2047 + [14]. + + TEXT = + + A CRLF is allowed in the definition of TEXT only as part of a header + field continuation. It is expected that the folding LWS will be + replaced with a single SP before interpretation of the TEXT value. + + Hexadecimal numeric characters are used in several protocol elements. + + HEX = "A" | "B" | "C" | "D" | "E" | "F" + | "a" | "b" | "c" | "d" | "e" | "f" | DIGIT + + + + + +Fielding, et al. Standards Track [Page 16] + +RFC 2616 HTTP/1.1 June 1999 + + + Many HTTP/1.1 header field values consist of words separated by LWS + or special characters. These special characters MUST be in a quoted + string to be used within a parameter value (as defined in section + 3.6). + + token = 1* + separators = "(" | ")" | "<" | ">" | "@" + | "," | ";" | ":" | "\" | <"> + | "/" | "[" | "]" | "?" | "=" + | "{" | "}" | SP | HT + + Comments can be included in some HTTP header fields by surrounding + the comment text with parentheses. Comments are only allowed in + fields containing "comment" as part of their field value definition. + In all other fields, parentheses are considered part of the field + value. + + comment = "(" *( ctext | quoted-pair | comment ) ")" + ctext = + + A string of text is parsed as a single word if it is quoted using + double-quote marks. + + quoted-string = ( <"> *(qdtext | quoted-pair ) <"> ) + qdtext = > + + The backslash character ("\") MAY be used as a single-character + quoting mechanism only within quoted-string and comment constructs. + + quoted-pair = "\" CHAR + +3 Protocol Parameters + +3.1 HTTP Version + + HTTP uses a "." numbering scheme to indicate versions + of the protocol. The protocol versioning policy is intended to allow + the sender to indicate the format of a message and its capacity for + understanding further HTTP communication, rather than the features + obtained via that communication. No change is made to the version + number for the addition of message components which do not affect + communication behavior or which only add to extensible field values. + The number is incremented when the changes made to the + protocol add features which do not change the general message parsing + algorithm, but which may add to the message semantics and imply + additional capabilities of the sender. The number is + incremented when the format of a message within the protocol is + changed. See RFC 2145 [36] for a fuller explanation. + + + +Fielding, et al. Standards Track [Page 17] + +RFC 2616 HTTP/1.1 June 1999 + + + The version of an HTTP message is indicated by an HTTP-Version field + in the first line of the message. + + HTTP-Version = "HTTP" "/" 1*DIGIT "." 1*DIGIT + + Note that the major and minor numbers MUST be treated as separate + integers and that each MAY be incremented higher than a single digit. + Thus, HTTP/2.4 is a lower version than HTTP/2.13, which in turn is + lower than HTTP/12.3. Leading zeros MUST be ignored by recipients and + MUST NOT be sent. + + An application that sends a request or response message that includes + HTTP-Version of "HTTP/1.1" MUST be at least conditionally compliant + with this specification. Applications that are at least conditionally + compliant with this specification SHOULD use an HTTP-Version of + "HTTP/1.1" in their messages, and MUST do so for any message that is + not compatible with HTTP/1.0. For more details on when to send + specific HTTP-Version values, see RFC 2145 [36]. + + The HTTP version of an application is the highest HTTP version for + which the application is at least conditionally compliant. + + Proxy and gateway applications need to be careful when forwarding + messages in protocol versions different from that of the application. + Since the protocol version indicates the protocol capability of the + sender, a proxy/gateway MUST NOT send a message with a version + indicator which is greater than its actual version. If a higher + version request is received, the proxy/gateway MUST either downgrade + the request version, or respond with an error, or switch to tunnel + behavior. + + Due to interoperability problems with HTTP/1.0 proxies discovered + since the publication of RFC 2068[33], caching proxies MUST, gateways + MAY, and tunnels MUST NOT upgrade the request to the highest version + they support. The proxy/gateway's response to that request MUST be in + the same major version as the request. + + Note: Converting between versions of HTTP may involve modification + of header fields required or forbidden by the versions involved. + +3.2 Uniform Resource Identifiers + + URIs have been known by many names: WWW addresses, Universal Document + Identifiers, Universal Resource Identifiers [3], and finally the + combination of Uniform Resource Locators (URL) [4] and Names (URN) + [20]. As far as HTTP is concerned, Uniform Resource Identifiers are + simply formatted strings which identify--via name, location, or any + other characteristic--a resource. + + + +Fielding, et al. Standards Track [Page 18] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.1 General Syntax + + URIs in HTTP can be represented in absolute form or relative to some + known base URI [11], depending upon the context of their use. The two + forms are differentiated by the fact that absolute URIs always begin + with a scheme name followed by a colon. For definitive information on + URL syntax and semantics, see "Uniform Resource Identifiers (URI): + Generic Syntax and Semantics," RFC 2396 [42] (which replaces RFCs + 1738 [4] and RFC 1808 [11]). This specification adopts the + definitions of "URI-reference", "absoluteURI", "relativeURI", "port", + "host","abs_path", "rel_path", and "authority" from that + specification. + + The HTTP protocol does not place any a priori limit on the length of + a URI. Servers MUST be able to handle the URI of any resource they + serve, and SHOULD be able to handle URIs of unbounded length if they + provide GET-based forms that could generate such URIs. A server + SHOULD return 414 (Request-URI Too Long) status if a URI is longer + than the server can handle (see section 10.4.15). + + Note: Servers ought to be cautious about depending on URI lengths + above 255 bytes, because some older client or proxy + implementations might not properly support these lengths. + +3.2.2 http URL + + The "http" scheme is used to locate network resources via the HTTP + protocol. This section defines the scheme-specific syntax and + semantics for http URLs. + + http_URL = "http:" "//" host [ ":" port ] [ abs_path [ "?" query ]] + + If the port is empty or not given, port 80 is assumed. The semantics + are that the identified resource is located at the server listening + for TCP connections on that port of that host, and the Request-URI + for the resource is abs_path (section 5.1.2). The use of IP addresses + in URLs SHOULD be avoided whenever possible (see RFC 1900 [24]). If + the abs_path is not present in the URL, it MUST be given as "/" when + used as a Request-URI for a resource (section 5.1.2). If a proxy + receives a host name which is not a fully qualified domain name, it + MAY add its domain to the host name it received. If a proxy receives + a fully qualified domain name, the proxy MUST NOT change the host + name. + + + + + + + + +Fielding, et al. Standards Track [Page 19] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.3 URI Comparison + + When comparing two URIs to decide if they match or not, a client + SHOULD use a case-sensitive octet-by-octet comparison of the entire + URIs, with these exceptions: + + - A port that is empty or not given is equivalent to the default + port for that URI-reference; + + - Comparisons of host names MUST be case-insensitive; + + - Comparisons of scheme names MUST be case-insensitive; + + - An empty abs_path is equivalent to an abs_path of "/". + + Characters other than those in the "reserved" and "unsafe" sets (see + RFC 2396 [42]) are equivalent to their ""%" HEX HEX" encoding. + + For example, the following three URIs are equivalent: + + http://abc.com:80/~smith/home.html + http://ABC.com/%7Esmith/home.html + http://ABC.com:/%7esmith/home.html + +3.3 Date/Time Formats + +3.3.1 Full Date + + HTTP applications have historically allowed three different formats + for the representation of date/time stamps: + + Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123 + Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036 + Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format + + The first format is preferred as an Internet standard and represents + a fixed-length subset of that defined by RFC 1123 [8] (an update to + RFC 822 [9]). The second format is in common use, but is based on the + obsolete RFC 850 [12] date format and lacks a four-digit year. + HTTP/1.1 clients and servers that parse the date value MUST accept + all three formats (for compatibility with HTTP/1.0), though they MUST + only generate the RFC 1123 format for representing HTTP-date values + in header fields. See section 19.3 for further information. + + Note: Recipients of date values are encouraged to be robust in + accepting date values that may have been sent by non-HTTP + applications, as is sometimes the case when retrieving or posting + messages via proxies/gateways to SMTP or NNTP. + + + +Fielding, et al. Standards Track [Page 20] + +RFC 2616 HTTP/1.1 June 1999 + + + All HTTP date/time stamps MUST be represented in Greenwich Mean Time + (GMT), without exception. For the purposes of HTTP, GMT is exactly + equal to UTC (Coordinated Universal Time). This is indicated in the + first two formats by the inclusion of "GMT" as the three-letter + abbreviation for time zone, and MUST be assumed when reading the + asctime format. HTTP-date is case sensitive and MUST NOT include + additional LWS beyond that specifically included as SP in the + grammar. + + HTTP-date = rfc1123-date | rfc850-date | asctime-date + rfc1123-date = wkday "," SP date1 SP time SP "GMT" + rfc850-date = weekday "," SP date2 SP time SP "GMT" + asctime-date = wkday SP date3 SP time SP 4DIGIT + date1 = 2DIGIT SP month SP 4DIGIT + ; day month year (e.g., 02 Jun 1982) + date2 = 2DIGIT "-" month "-" 2DIGIT + ; day-month-year (e.g., 02-Jun-82) + date3 = month SP ( 2DIGIT | ( SP 1DIGIT )) + ; month day (e.g., Jun 2) + time = 2DIGIT ":" 2DIGIT ":" 2DIGIT + ; 00:00:00 - 23:59:59 + wkday = "Mon" | "Tue" | "Wed" + | "Thu" | "Fri" | "Sat" | "Sun" + weekday = "Monday" | "Tuesday" | "Wednesday" + | "Thursday" | "Friday" | "Saturday" | "Sunday" + month = "Jan" | "Feb" | "Mar" | "Apr" + | "May" | "Jun" | "Jul" | "Aug" + | "Sep" | "Oct" | "Nov" | "Dec" + + Note: HTTP requirements for the date/time stamp format apply only + to their usage within the protocol stream. Clients and servers are + not required to use these formats for user presentation, request + logging, etc. + +3.3.2 Delta Seconds + + Some HTTP header fields allow a time value to be specified as an + integer number of seconds, represented in decimal, after the time + that the message was received. + + delta-seconds = 1*DIGIT + +3.4 Character Sets + + HTTP uses the same definition of the term "character set" as that + described for MIME: + + + + + +Fielding, et al. Standards Track [Page 21] + +RFC 2616 HTTP/1.1 June 1999 + + + The term "character set" is used in this document to refer to a + method used with one or more tables to convert a sequence of octets + into a sequence of characters. Note that unconditional conversion in + the other direction is not required, in that not all characters may + be available in a given character set and a character set may provide + more than one sequence of octets to represent a particular character. + This definition is intended to allow various kinds of character + encoding, from simple single-table mappings such as US-ASCII to + complex table switching methods such as those that use ISO-2022's + techniques. However, the definition associated with a MIME character + set name MUST fully specify the mapping to be performed from octets + to characters. In particular, use of external profiling information + to determine the exact mapping is not permitted. + + Note: This use of the term "character set" is more commonly + referred to as a "character encoding." However, since HTTP and + MIME share the same registry, it is important that the terminology + also be shared. + + HTTP character sets are identified by case-insensitive tokens. The + complete set of tokens is defined by the IANA Character Set registry + [19]. + + charset = token + + Although HTTP allows an arbitrary token to be used as a charset + value, any token that has a predefined value within the IANA + Character Set registry [19] MUST represent the character set defined + by that registry. Applications SHOULD limit their use of character + sets to those defined by the IANA registry. + + Implementors should be aware of IETF character set requirements [38] + [41]. + +3.4.1 Missing Charset + + Some HTTP/1.0 software has interpreted a Content-Type header without + charset parameter incorrectly to mean "recipient should guess." + Senders wishing to defeat this behavior MAY include a charset + parameter even when the charset is ISO-8859-1 and SHOULD do so when + it is known that it will not confuse the recipient. + + Unfortunately, some older HTTP/1.0 clients did not deal properly with + an explicit charset parameter. HTTP/1.1 recipients MUST respect the + charset label provided by the sender; and those user agents that have + a provision to "guess" a charset MUST use the charset from the + + + + + +Fielding, et al. Standards Track [Page 22] + +RFC 2616 HTTP/1.1 June 1999 + + + content-type field if they support that charset, rather than the + recipient's preference, when initially displaying a document. See + section 3.7.1. + +3.5 Content Codings + + Content coding values indicate an encoding transformation that has + been or can be applied to an entity. Content codings are primarily + used to allow a document to be compressed or otherwise usefully + transformed without losing the identity of its underlying media type + and without loss of information. Frequently, the entity is stored in + coded form, transmitted directly, and only decoded by the recipient. + + content-coding = token + + All content-coding values are case-insensitive. HTTP/1.1 uses + content-coding values in the Accept-Encoding (section 14.3) and + Content-Encoding (section 14.11) header fields. Although the value + describes the content-coding, what is more important is that it + indicates what decoding mechanism will be required to remove the + encoding. + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + content-coding value tokens. Initially, the registry contains the + following tokens: + + gzip An encoding format produced by the file compression program + "gzip" (GNU zip) as described in RFC 1952 [25]. This format is a + Lempel-Ziv coding (LZ77) with a 32 bit CRC. + + compress + The encoding format produced by the common UNIX file compression + program "compress". This format is an adaptive Lempel-Ziv-Welch + coding (LZW). + + Use of program names for the identification of encoding formats + is not desirable and is discouraged for future encodings. Their + use here is representative of historical practice, not good + design. For compatibility with previous implementations of HTTP, + applications SHOULD consider "x-gzip" and "x-compress" to be + equivalent to "gzip" and "compress" respectively. + + deflate + The "zlib" format defined in RFC 1950 [31] in combination with + the "deflate" compression mechanism described in RFC 1951 [29]. + + + + + + +Fielding, et al. Standards Track [Page 23] + +RFC 2616 HTTP/1.1 June 1999 + + + identity + The default (identity) encoding; the use of no transformation + whatsoever. This content-coding is used only in the Accept- + Encoding header, and SHOULD NOT be used in the Content-Encoding + header. + + New content-coding value tokens SHOULD be registered; to allow + interoperability between clients and servers, specifications of the + content coding algorithms needed to implement a new value SHOULD be + publicly available and adequate for independent implementation, and + conform to the purpose of content coding defined in this section. + +3.6 Transfer Codings + + Transfer-coding values are used to indicate an encoding + transformation that has been, can be, or may need to be applied to an + entity-body in order to ensure "safe transport" through the network. + This differs from a content coding in that the transfer-coding is a + property of the message, not of the original entity. + + transfer-coding = "chunked" | transfer-extension + transfer-extension = token *( ";" parameter ) + + Parameters are in the form of attribute/value pairs. + + parameter = attribute "=" value + attribute = token + value = token | quoted-string + + All transfer-coding values are case-insensitive. HTTP/1.1 uses + transfer-coding values in the TE header field (section 14.39) and in + the Transfer-Encoding header field (section 14.41). + + Whenever a transfer-coding is applied to a message-body, the set of + transfer-codings MUST include "chunked", unless the message is + terminated by closing the connection. When the "chunked" transfer- + coding is used, it MUST be the last transfer-coding applied to the + message-body. The "chunked" transfer-coding MUST NOT be applied more + than once to a message-body. These rules allow the recipient to + determine the transfer-length of the message (section 4.4). + + Transfer-codings are analogous to the Content-Transfer-Encoding + values of MIME [7], which were designed to enable safe transport of + binary data over a 7-bit transport service. However, safe transport + has a different focus for an 8bit-clean transfer protocol. In HTTP, + the only unsafe characteristic of message-bodies is the difficulty in + determining the exact body length (section 7.2.2), or the desire to + encrypt data over a shared transport. + + + +Fielding, et al. Standards Track [Page 24] + +RFC 2616 HTTP/1.1 June 1999 + + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + transfer-coding value tokens. Initially, the registry contains the + following tokens: "chunked" (section 3.6.1), "identity" (section + 3.6.2), "gzip" (section 3.5), "compress" (section 3.5), and "deflate" + (section 3.5). + + New transfer-coding value tokens SHOULD be registered in the same way + as new content-coding value tokens (section 3.5). + + A server which receives an entity-body with a transfer-coding it does + not understand SHOULD return 501 (Unimplemented), and close the + connection. A server MUST NOT send transfer-codings to an HTTP/1.0 + client. + +3.6.1 Chunked Transfer Coding + + The chunked encoding modifies the body of a message in order to + transfer it as a series of chunks, each with its own size indicator, + followed by an OPTIONAL trailer containing entity-header fields. This + allows dynamically produced content to be transferred along with the + information necessary for the recipient to verify that it has + received the full message. + + Chunked-Body = *chunk + last-chunk + trailer + CRLF + + chunk = chunk-size [ chunk-extension ] CRLF + chunk-data CRLF + chunk-size = 1*HEX + last-chunk = 1*("0") [ chunk-extension ] CRLF + + chunk-extension= *( ";" chunk-ext-name [ "=" chunk-ext-val ] ) + chunk-ext-name = token + chunk-ext-val = token | quoted-string + chunk-data = chunk-size(OCTET) + trailer = *(entity-header CRLF) + + The chunk-size field is a string of hex digits indicating the size of + the chunk. The chunked encoding is ended by any chunk whose size is + zero, followed by the trailer, which is terminated by an empty line. + + The trailer allows the sender to include additional HTTP header + fields at the end of the message. The Trailer header field can be + used to indicate which header fields are included in a trailer (see + section 14.40). + + + + +Fielding, et al. Standards Track [Page 25] + +RFC 2616 HTTP/1.1 June 1999 + + + A server using chunked transfer-coding in a response MUST NOT use the + trailer for any header fields unless at least one of the following is + true: + + a)the request included a TE header field that indicates "trailers" is + acceptable in the transfer-coding of the response, as described in + section 14.39; or, + + b)the server is the origin server for the response, the trailer + fields consist entirely of optional metadata, and the recipient + could use the message (in a manner acceptable to the origin server) + without receiving this metadata. In other words, the origin server + is willing to accept the possibility that the trailer fields might + be silently discarded along the path to the client. + + This requirement prevents an interoperability failure when the + message is being received by an HTTP/1.1 (or later) proxy and + forwarded to an HTTP/1.0 recipient. It avoids a situation where + compliance with the protocol would have necessitated a possibly + infinite buffer on the proxy. + + An example process for decoding a Chunked-Body is presented in + appendix 19.4.6. + + All HTTP/1.1 applications MUST be able to receive and decode the + "chunked" transfer-coding, and MUST ignore chunk-extension extensions + they do not understand. + +3.7 Media Types + + HTTP uses Internet Media Types [17] in the Content-Type (section + 14.17) and Accept (section 14.1) header fields in order to provide + open and extensible data typing and type negotiation. + + media-type = type "/" subtype *( ";" parameter ) + type = token + subtype = token + + Parameters MAY follow the type/subtype in the form of attribute/value + pairs (as defined in section 3.6). + + The type, subtype, and parameter attribute names are case- + insensitive. Parameter values might or might not be case-sensitive, + depending on the semantics of the parameter name. Linear white space + (LWS) MUST NOT be used between the type and subtype, nor between an + attribute and its value. The presence or absence of a parameter might + be significant to the processing of a media-type, depending on its + definition within the media type registry. + + + +Fielding, et al. Standards Track [Page 26] + +RFC 2616 HTTP/1.1 June 1999 + + + Note that some older HTTP applications do not recognize media type + parameters. When sending data to older HTTP applications, + implementations SHOULD only use media type parameters when they are + required by that type/subtype definition. + + Media-type values are registered with the Internet Assigned Number + Authority (IANA [19]). The media type registration process is + outlined in RFC 1590 [17]. Use of non-registered media types is + discouraged. + +3.7.1 Canonicalization and Text Defaults + + Internet media types are registered with a canonical form. An + entity-body transferred via HTTP messages MUST be represented in the + appropriate canonical form prior to its transmission except for + "text" types, as defined in the next paragraph. + + When in canonical form, media subtypes of the "text" type use CRLF as + the text line break. HTTP relaxes this requirement and allows the + transport of text media with plain CR or LF alone representing a line + break when it is done consistently for an entire entity-body. HTTP + applications MUST accept CRLF, bare CR, and bare LF as being + representative of a line break in text media received via HTTP. In + addition, if the text is represented in a character set that does not + use octets 13 and 10 for CR and LF respectively, as is the case for + some multi-byte character sets, HTTP allows the use of whatever octet + sequences are defined by that character set to represent the + equivalent of CR and LF for line breaks. This flexibility regarding + line breaks applies only to text media in the entity-body; a bare CR + or LF MUST NOT be substituted for CRLF within any of the HTTP control + structures (such as header fields and multipart boundaries). + + If an entity-body is encoded with a content-coding, the underlying + data MUST be in a form defined above prior to being encoded. + + The "charset" parameter is used with some media types to define the + character set (section 3.4) of the data. When no explicit charset + parameter is provided by the sender, media subtypes of the "text" + type are defined to have a default charset value of "ISO-8859-1" when + received via HTTP. Data in character sets other than "ISO-8859-1" or + its subsets MUST be labeled with an appropriate charset value. See + section 3.4.1 for compatibility problems. + +3.7.2 Multipart Types + + MIME provides for a number of "multipart" types -- encapsulations of + one or more entities within a single message-body. All multipart + types share a common syntax, as defined in section 5.1.1 of RFC 2046 + + + +Fielding, et al. Standards Track [Page 27] + +RFC 2616 HTTP/1.1 June 1999 + + + [40], and MUST include a boundary parameter as part of the media type + value. The message body is itself a protocol element and MUST + therefore use only CRLF to represent line breaks between body-parts. + Unlike in RFC 2046, the epilogue of any multipart message MUST be + empty; HTTP applications MUST NOT transmit the epilogue (even if the + original multipart contains an epilogue). These restrictions exist in + order to preserve the self-delimiting nature of a multipart message- + body, wherein the "end" of the message-body is indicated by the + ending multipart boundary. + + In general, HTTP treats a multipart message-body no differently than + any other media type: strictly as payload. The one exception is the + "multipart/byteranges" type (appendix 19.2) when it appears in a 206 + (Partial Content) response, which will be interpreted by some HTTP + caching mechanisms as described in sections 13.5.4 and 14.16. In all + other cases, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + The MIME header fields within each body-part of a multipart message- + body do not have any significance to HTTP beyond that defined by + their MIME semantics. + + In general, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + If an application receives an unrecognized multipart subtype, the + application MUST treat it as being equivalent to "multipart/mixed". + + Note: The "multipart/form-data" type has been specifically defined + for carrying form data suitable for processing via the POST + request method, as described in RFC 1867 [15]. + +3.8 Product Tokens + + Product tokens are used to allow communicating applications to + identify themselves by software name and version. Most fields using + product tokens also allow sub-products which form a significant part + of the application to be listed, separated by white space. By + convention, the products are listed in order of their significance + for identifying the application. + + product = token ["/" product-version] + product-version = token + + Examples: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + Server: Apache/0.8.4 + + + + + +Fielding, et al. Standards Track [Page 28] + +RFC 2616 HTTP/1.1 June 1999 + + + Product tokens SHOULD be short and to the point. They MUST NOT be + used for advertising or other non-essential information. Although any + token character MAY appear in a product-version, this token SHOULD + only be used for a version identifier (i.e., successive versions of + the same product SHOULD only differ in the product-version portion of + the product value). + +3.9 Quality Values + + HTTP content negotiation (section 12) uses short "floating point" + numbers to indicate the relative importance ("weight") of various + negotiable parameters. A weight is normalized to a real number in + the range 0 through 1, where 0 is the minimum and 1 the maximum + value. If a parameter has a quality value of 0, then content with + this parameter is `not acceptable' for the client. HTTP/1.1 + applications MUST NOT generate more than three digits after the + decimal point. User configuration of these values SHOULD also be + limited in this fashion. + + qvalue = ( "0" [ "." 0*3DIGIT ] ) + | ( "1" [ "." 0*3("0") ] ) + + "Quality values" is a misnomer, since these values merely represent + relative degradation in desired quality. + +3.10 Language Tags + + A language tag identifies a natural language spoken, written, or + otherwise conveyed by human beings for communication of information + to other human beings. Computer languages are explicitly excluded. + HTTP uses language tags within the Accept-Language and Content- + Language fields. + + The syntax and registry of HTTP language tags is the same as that + defined by RFC 1766 [1]. In summary, a language tag is composed of 1 + or more parts: A primary language tag and a possibly empty series of + subtags: + + language-tag = primary-tag *( "-" subtag ) + primary-tag = 1*8ALPHA + subtag = 1*8ALPHA + + White space is not allowed within the tag and all tags are case- + insensitive. The name space of language tags is administered by the + IANA. Example tags include: + + en, en-US, en-cockney, i-cherokee, x-pig-latin + + + + +Fielding, et al. Standards Track [Page 29] + +RFC 2616 HTTP/1.1 June 1999 + + + where any two-letter primary-tag is an ISO-639 language abbreviation + and any two-letter initial subtag is an ISO-3166 country code. (The + last three tags above are not registered tags; all but the last are + examples of tags which could be registered in future.) + +3.11 Entity Tags + + Entity tags are used for comparing two or more entities from the same + requested resource. HTTP/1.1 uses entity tags in the ETag (section + 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and + If-Range (section 14.27) header fields. The definition of how they + are used and compared as cache validators is in section 13.3.3. An + entity tag consists of an opaque quoted string, possibly prefixed by + a weakness indicator. + + entity-tag = [ weak ] opaque-tag + weak = "W/" + opaque-tag = quoted-string + + A "strong entity tag" MAY be shared by two entities of a resource + only if they are equivalent by octet equality. + + A "weak entity tag," indicated by the "W/" prefix, MAY be shared by + two entities of a resource only if the entities are equivalent and + could be substituted for each other with no significant change in + semantics. A weak entity tag can only be used for weak comparison. + + An entity tag MUST be unique across all versions of all entities + associated with a particular resource. A given entity tag value MAY + be used for entities obtained by requests on different URIs. The use + of the same entity tag value in conjunction with entities obtained by + requests on different URIs does not imply the equivalence of those + entities. + +3.12 Range Units + + HTTP/1.1 allows a client to request that only part (a range of) the + response entity be included within the response. HTTP/1.1 uses range + units in the Range (section 14.35) and Content-Range (section 14.16) + header fields. An entity can be broken down into subranges according + to various structural units. + + range-unit = bytes-unit | other-range-unit + bytes-unit = "bytes" + other-range-unit = token + + The only range unit defined by HTTP/1.1 is "bytes". HTTP/1.1 + implementations MAY ignore ranges specified using other units. + + + +Fielding, et al. Standards Track [Page 30] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 has been designed to allow implementations of applications + that do not depend on knowledge of ranges. + +4 HTTP Message + +4.1 Message Types + + HTTP messages consist of requests from client to server and responses + from server to client. + + HTTP-message = Request | Response ; HTTP/1.1 messages + + Request (section 5) and Response (section 6) messages use the generic + message format of RFC 822 [9] for transferring entities (the payload + of the message). Both types of message consist of a start-line, zero + or more header fields (also known as "headers"), an empty line (i.e., + a line with nothing preceding the CRLF) indicating the end of the + header fields, and possibly a message-body. + + generic-message = start-line + *(message-header CRLF) + CRLF + [ message-body ] + start-line = Request-Line | Status-Line + + In the interest of robustness, servers SHOULD ignore any empty + line(s) received where a Request-Line is expected. In other words, if + the server is reading the protocol stream at the beginning of a + message and receives a CRLF first, it should ignore the CRLF. + + Certain buggy HTTP/1.0 client implementations generate extra CRLF's + after a POST request. To restate what is explicitly forbidden by the + BNF, an HTTP/1.1 client MUST NOT preface or follow a request with an + extra CRLF. + +4.2 Message Headers + + HTTP header fields, which include general-header (section 4.5), + request-header (section 5.3), response-header (section 6.2), and + entity-header (section 7.1) fields, follow the same generic format as + that given in Section 3.1 of RFC 822 [9]. Each header field consists + of a name followed by a colon (":") and the field value. Field names + are case-insensitive. The field value MAY be preceded by any amount + of LWS, though a single SP is preferred. Header fields can be + extended over multiple lines by preceding each extra line with at + least one SP or HT. Applications ought to follow "common form", where + one is known or indicated, when generating HTTP constructs, since + there might exist some implementations that fail to accept anything + + + +Fielding, et al. Standards Track [Page 31] + +RFC 2616 HTTP/1.1 June 1999 + + + beyond the common forms. + + message-header = field-name ":" [ field-value ] + field-name = token + field-value = *( field-content | LWS ) + field-content = + + The field-content does not include any leading or trailing LWS: + linear white space occurring before the first non-whitespace + character of the field-value or after the last non-whitespace + character of the field-value. Such leading or trailing LWS MAY be + removed without changing the semantics of the field value. Any LWS + that occurs between field-content MAY be replaced with a single SP + before interpreting the field value or forwarding the message + downstream. + + The order in which header fields with differing field names are + received is not significant. However, it is "good practice" to send + general-header fields first, followed by request-header or response- + header fields, and ending with the entity-header fields. + + Multiple message-header fields with the same field-name MAY be + present in a message if and only if the entire field-value for that + header field is defined as a comma-separated list [i.e., #(values)]. + It MUST be possible to combine the multiple header fields into one + "field-name: field-value" pair, without changing the semantics of the + message, by appending each subsequent field-value to the first, each + separated by a comma. The order in which header fields with the same + field-name are received is therefore significant to the + interpretation of the combined field value, and thus a proxy MUST NOT + change the order of these field values when a message is forwarded. + +4.3 Message Body + + The message-body (if any) of an HTTP message is used to carry the + entity-body associated with the request or response. The message-body + differs from the entity-body only when a transfer-coding has been + applied, as indicated by the Transfer-Encoding header field (section + 14.41). + + message-body = entity-body + | + + Transfer-Encoding MUST be used to indicate any transfer-codings + applied by an application to ensure safe and proper transfer of the + message. Transfer-Encoding is a property of the message, not of the + + + +Fielding, et al. Standards Track [Page 32] + +RFC 2616 HTTP/1.1 June 1999 + + + entity, and thus MAY be added or removed by any application along the + request/response chain. (However, section 3.6 places restrictions on + when certain transfer-codings may be used.) + + The rules for when a message-body is allowed in a message differ for + requests and responses. + + The presence of a message-body in a request is signaled by the + inclusion of a Content-Length or Transfer-Encoding header field in + the request's message-headers. A message-body MUST NOT be included in + a request if the specification of the request method (section 5.1.1) + does not allow sending an entity-body in requests. A server SHOULD + read and forward a message-body on any request; if the request method + does not include defined semantics for an entity-body, then the + message-body SHOULD be ignored when handling the request. + + For response messages, whether or not a message-body is included with + a message is dependent on both the request method and the response + status code (section 6.1.1). All responses to the HEAD request method + MUST NOT include a message-body, even though the presence of entity- + header fields might lead one to believe they do. All 1xx + (informational), 204 (no content), and 304 (not modified) responses + MUST NOT include a message-body. All other responses do include a + message-body, although it MAY be of zero length. + +4.4 Message Length + + The transfer-length of a message is the length of the message-body as + it appears in the message; that is, after any transfer-codings have + been applied. When a message-body is included with a message, the + transfer-length of that body is determined by one of the following + (in order of precedence): + + 1.Any response message which "MUST NOT" include a message-body (such + as the 1xx, 204, and 304 responses and any response to a HEAD + request) is always terminated by the first empty line after the + header fields, regardless of the entity-header fields present in + the message. + + 2.If a Transfer-Encoding header field (section 14.41) is present and + has any value other than "identity", then the transfer-length is + defined by use of the "chunked" transfer-coding (section 3.6), + unless the message is terminated by closing the connection. + + 3.If a Content-Length header field (section 14.13) is present, its + decimal value in OCTETs represents both the entity-length and the + transfer-length. The Content-Length header field MUST NOT be sent + if these two lengths are different (i.e., if a Transfer-Encoding + + + +Fielding, et al. Standards Track [Page 33] + +RFC 2616 HTTP/1.1 June 1999 + + + header field is present). If a message is received with both a + Transfer-Encoding header field and a Content-Length header field, + the latter MUST be ignored. + + 4.If the message uses the media type "multipart/byteranges", and the + ransfer-length is not otherwise specified, then this self- + elimiting media type defines the transfer-length. This media type + UST NOT be used unless the sender knows that the recipient can arse + it; the presence in a request of a Range header with ultiple byte- + range specifiers from a 1.1 client implies that the lient can parse + multipart/byteranges responses. + + A range header might be forwarded by a 1.0 proxy that does not + understand multipart/byteranges; in this case the server MUST + delimit the message using methods defined in items 1,3 or 5 of + this section. + + 5.By the server closing the connection. (Closing the connection + cannot be used to indicate the end of a request body, since that + would leave no possibility for the server to send back a response.) + + For compatibility with HTTP/1.0 applications, HTTP/1.1 requests + containing a message-body MUST include a valid Content-Length header + field unless the server is known to be HTTP/1.1 compliant. If a + request contains a message-body and a Content-Length is not given, + the server SHOULD respond with 400 (bad request) if it cannot + determine the length of the message, or with 411 (length required) if + it wishes to insist on receiving a valid Content-Length. + + All HTTP/1.1 applications that receive entities MUST accept the + "chunked" transfer-coding (section 3.6), thus allowing this mechanism + to be used for messages when the message length cannot be determined + in advance. + + Messages MUST NOT include both a Content-Length header field and a + non-identity transfer-coding. If the message does include a non- + identity transfer-coding, the Content-Length MUST be ignored. + + When a Content-Length is given in a message where a message-body is + allowed, its field value MUST exactly match the number of OCTETs in + the message-body. HTTP/1.1 user agents MUST notify the user when an + invalid length is received and detected. + +4.5 General Header Fields + + There are a few header fields which have general applicability for + both request and response messages, but which do not apply to the + entity being transferred. These header fields apply only to the + + + +Fielding, et al. Standards Track [Page 34] + +RFC 2616 HTTP/1.1 June 1999 + + + message being transmitted. + + general-header = Cache-Control ; Section 14.9 + | Connection ; Section 14.10 + | Date ; Section 14.18 + | Pragma ; Section 14.32 + | Trailer ; Section 14.40 + | Transfer-Encoding ; Section 14.41 + | Upgrade ; Section 14.42 + | Via ; Section 14.45 + | Warning ; Section 14.46 + + General-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields may be given the semantics of general + header fields if all parties in the communication recognize them to + be general-header fields. Unrecognized header fields are treated as + entity-header fields. + +5 Request + + A request message from a client to a server includes, within the + first line of that message, the method to be applied to the resource, + the identifier of the resource, and the protocol version in use. + + Request = Request-Line ; Section 5.1 + *(( general-header ; Section 4.5 + | request-header ; Section 5.3 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 4.3 + +5.1 Request-Line + + The Request-Line begins with a method token, followed by the + Request-URI and the protocol version, and ending with CRLF. The + elements are separated by SP characters. No CR or LF is allowed + except in the final CRLF sequence. + + Request-Line = Method SP Request-URI SP HTTP-Version CRLF + + + + + + + + + + + +Fielding, et al. Standards Track [Page 35] + +RFC 2616 HTTP/1.1 June 1999 + + +5.1.1 Method + + The Method token indicates the method to be performed on the + resource identified by the Request-URI. The method is case-sensitive. + + Method = "OPTIONS" ; Section 9.2 + | "GET" ; Section 9.3 + | "HEAD" ; Section 9.4 + | "POST" ; Section 9.5 + | "PUT" ; Section 9.6 + | "DELETE" ; Section 9.7 + | "TRACE" ; Section 9.8 + | "CONNECT" ; Section 9.9 + | extension-method + extension-method = token + + The list of methods allowed by a resource can be specified in an + Allow header field (section 14.7). The return code of the response + always notifies the client whether a method is currently allowed on a + resource, since the set of allowed methods can change dynamically. An + origin server SHOULD return the status code 405 (Method Not Allowed) + if the method is known by the origin server but not allowed for the + requested resource, and 501 (Not Implemented) if the method is + unrecognized or not implemented by the origin server. The methods GET + and HEAD MUST be supported by all general-purpose servers. All other + methods are OPTIONAL; however, if the above methods are implemented, + they MUST be implemented with the same semantics as those specified + in section 9. + +5.1.2 Request-URI + + The Request-URI is a Uniform Resource Identifier (section 3.2) and + identifies the resource upon which to apply the request. + + Request-URI = "*" | absoluteURI | abs_path | authority + + The four options for Request-URI are dependent on the nature of the + request. The asterisk "*" means that the request does not apply to a + particular resource, but to the server itself, and is only allowed + when the method used does not necessarily apply to a resource. One + example would be + + OPTIONS * HTTP/1.1 + + The absoluteURI form is REQUIRED when the request is being made to a + proxy. The proxy is requested to forward the request or service it + from a valid cache, and return the response. Note that the proxy MAY + forward the request on to another proxy or directly to the server + + + +Fielding, et al. Standards Track [Page 36] + +RFC 2616 HTTP/1.1 June 1999 + + + specified by the absoluteURI. In order to avoid request loops, a + proxy MUST be able to recognize all of its server names, including + any aliases, local variations, and the numeric IP address. An example + Request-Line would be: + + GET http://www.w3.org/pub/WWW/TheProject.html HTTP/1.1 + + To allow for transition to absoluteURIs in all requests in future + versions of HTTP, all HTTP/1.1 servers MUST accept the absoluteURI + form in requests, even though HTTP/1.1 clients will only generate + them in requests to proxies. + + The authority form is only used by the CONNECT method (section 9.9). + + The most common form of Request-URI is that used to identify a + resource on an origin server or gateway. In this case the absolute + path of the URI MUST be transmitted (see section 3.2.1, abs_path) as + the Request-URI, and the network location of the URI (authority) MUST + be transmitted in a Host header field. For example, a client wishing + to retrieve the resource above directly from the origin server would + create a TCP connection to port 80 of the host "www.w3.org" and send + the lines: + + GET /pub/WWW/TheProject.html HTTP/1.1 + Host: www.w3.org + + followed by the remainder of the Request. Note that the absolute path + cannot be empty; if none is present in the original URI, it MUST be + given as "/" (the server root). + + The Request-URI is transmitted in the format specified in section + 3.2.1. If the Request-URI is encoded using the "% HEX HEX" encoding + [42], the origin server MUST decode the Request-URI in order to + properly interpret the request. Servers SHOULD respond to invalid + Request-URIs with an appropriate status code. + + A transparent proxy MUST NOT rewrite the "abs_path" part of the + received Request-URI when forwarding it to the next inbound server, + except as noted above to replace a null abs_path with "/". + + Note: The "no rewrite" rule prevents the proxy from changing the + meaning of the request when the origin server is improperly using + a non-reserved URI character for a reserved purpose. Implementors + should be aware that some pre-HTTP/1.1 proxies have been known to + rewrite the Request-URI. + + + + + + +Fielding, et al. Standards Track [Page 37] + +RFC 2616 HTTP/1.1 June 1999 + + +5.2 The Resource Identified by a Request + + The exact resource identified by an Internet request is determined by + examining both the Request-URI and the Host header field. + + An origin server that does not allow resources to differ by the + requested host MAY ignore the Host header field value when + determining the resource identified by an HTTP/1.1 request. (But see + section 19.6.1.1 for other requirements on Host support in HTTP/1.1.) + + An origin server that does differentiate resources based on the host + requested (sometimes referred to as virtual hosts or vanity host + names) MUST use the following rules for determining the requested + resource on an HTTP/1.1 request: + + 1. If Request-URI is an absoluteURI, the host is part of the + Request-URI. Any Host header field value in the request MUST be + ignored. + + 2. If the Request-URI is not an absoluteURI, and the request includes + a Host header field, the host is determined by the Host header + field value. + + 3. If the host as determined by rule 1 or 2 is not a valid host on + the server, the response MUST be a 400 (Bad Request) error message. + + Recipients of an HTTP/1.0 request that lacks a Host header field MAY + attempt to use heuristics (e.g., examination of the URI path for + something unique to a particular host) in order to determine what + exact resource is being requested. + +5.3 Request Header Fields + + The request-header fields allow the client to pass additional + information about the request, and about the client itself, to the + server. These fields act as request modifiers, with semantics + equivalent to the parameters on a programming language method + invocation. + + request-header = Accept ; Section 14.1 + | Accept-Charset ; Section 14.2 + | Accept-Encoding ; Section 14.3 + | Accept-Language ; Section 14.4 + | Authorization ; Section 14.8 + | Expect ; Section 14.20 + | From ; Section 14.22 + | Host ; Section 14.23 + | If-Match ; Section 14.24 + + + +Fielding, et al. Standards Track [Page 38] + +RFC 2616 HTTP/1.1 June 1999 + + + | If-Modified-Since ; Section 14.25 + | If-None-Match ; Section 14.26 + | If-Range ; Section 14.27 + | If-Unmodified-Since ; Section 14.28 + | Max-Forwards ; Section 14.31 + | Proxy-Authorization ; Section 14.34 + | Range ; Section 14.35 + | Referer ; Section 14.36 + | TE ; Section 14.39 + | User-Agent ; Section 14.43 + + Request-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of request- + header fields if all parties in the communication recognize them to + be request-header fields. Unrecognized header fields are treated as + entity-header fields. + +6 Response + + After receiving and interpreting a request message, a server responds + with an HTTP response message. + + Response = Status-Line ; Section 6.1 + *(( general-header ; Section 4.5 + | response-header ; Section 6.2 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 7.2 + +6.1 Status-Line + + The first line of a Response message is the Status-Line, consisting + of the protocol version followed by a numeric status code and its + associated textual phrase, with each element separated by SP + characters. No CR or LF is allowed except in the final CRLF sequence. + + Status-Line = HTTP-Version SP Status-Code SP Reason-Phrase CRLF + +6.1.1 Status Code and Reason Phrase + + The Status-Code element is a 3-digit integer result code of the + attempt to understand and satisfy the request. These codes are fully + defined in section 10. The Reason-Phrase is intended to give a short + textual description of the Status-Code. The Status-Code is intended + for use by automata and the Reason-Phrase is intended for the human + user. The client is not required to examine or display the Reason- + Phrase. + + + +Fielding, et al. Standards Track [Page 39] + +RFC 2616 HTTP/1.1 June 1999 + + + The first digit of the Status-Code defines the class of response. The + last two digits do not have any categorization role. There are 5 + values for the first digit: + + - 1xx: Informational - Request received, continuing process + + - 2xx: Success - The action was successfully received, + understood, and accepted + + - 3xx: Redirection - Further action must be taken in order to + complete the request + + - 4xx: Client Error - The request contains bad syntax or cannot + be fulfilled + + - 5xx: Server Error - The server failed to fulfill an apparently + valid request + + The individual values of the numeric status codes defined for + HTTP/1.1, and an example set of corresponding Reason-Phrase's, are + presented below. The reason phrases listed here are only + recommendations -- they MAY be replaced by local equivalents without + affecting the protocol. + + Status-Code = + "100" ; Section 10.1.1: Continue + | "101" ; Section 10.1.2: Switching Protocols + | "200" ; Section 10.2.1: OK + | "201" ; Section 10.2.2: Created + | "202" ; Section 10.2.3: Accepted + | "203" ; Section 10.2.4: Non-Authoritative Information + | "204" ; Section 10.2.5: No Content + | "205" ; Section 10.2.6: Reset Content + | "206" ; Section 10.2.7: Partial Content + | "300" ; Section 10.3.1: Multiple Choices + | "301" ; Section 10.3.2: Moved Permanently + | "302" ; Section 10.3.3: Found + | "303" ; Section 10.3.4: See Other + | "304" ; Section 10.3.5: Not Modified + | "305" ; Section 10.3.6: Use Proxy + | "307" ; Section 10.3.8: Temporary Redirect + | "400" ; Section 10.4.1: Bad Request + | "401" ; Section 10.4.2: Unauthorized + | "402" ; Section 10.4.3: Payment Required + | "403" ; Section 10.4.4: Forbidden + | "404" ; Section 10.4.5: Not Found + | "405" ; Section 10.4.6: Method Not Allowed + | "406" ; Section 10.4.7: Not Acceptable + + + +Fielding, et al. Standards Track [Page 40] + +RFC 2616 HTTP/1.1 June 1999 + + + | "407" ; Section 10.4.8: Proxy Authentication Required + | "408" ; Section 10.4.9: Request Time-out + | "409" ; Section 10.4.10: Conflict + | "410" ; Section 10.4.11: Gone + | "411" ; Section 10.4.12: Length Required + | "412" ; Section 10.4.13: Precondition Failed + | "413" ; Section 10.4.14: Request Entity Too Large + | "414" ; Section 10.4.15: Request-URI Too Large + | "415" ; Section 10.4.16: Unsupported Media Type + | "416" ; Section 10.4.17: Requested range not satisfiable + | "417" ; Section 10.4.18: Expectation Failed + | "500" ; Section 10.5.1: Internal Server Error + | "501" ; Section 10.5.2: Not Implemented + | "502" ; Section 10.5.3: Bad Gateway + | "503" ; Section 10.5.4: Service Unavailable + | "504" ; Section 10.5.5: Gateway Time-out + | "505" ; Section 10.5.6: HTTP Version not supported + | extension-code + + extension-code = 3DIGIT + Reason-Phrase = * + + HTTP status codes are extensible. HTTP applications are not required + to understand the meaning of all registered status codes, though such + understanding is obviously desirable. However, applications MUST + understand the class of any status code, as indicated by the first + digit, and treat any unrecognized response as being equivalent to the + x00 status code of that class, with the exception that an + unrecognized response MUST NOT be cached. For example, if an + unrecognized status code of 431 is received by the client, it can + safely assume that there was something wrong with its request and + treat the response as if it had received a 400 status code. In such + cases, user agents SHOULD present to the user the entity returned + with the response, since that entity is likely to include human- + readable information which will explain the unusual status. + +6.2 Response Header Fields + + The response-header fields allow the server to pass additional + information about the response which cannot be placed in the Status- + Line. These header fields give information about the server and about + further access to the resource identified by the Request-URI. + + response-header = Accept-Ranges ; Section 14.5 + | Age ; Section 14.6 + | ETag ; Section 14.19 + | Location ; Section 14.30 + | Proxy-Authenticate ; Section 14.33 + + + +Fielding, et al. Standards Track [Page 41] + +RFC 2616 HTTP/1.1 June 1999 + + + | Retry-After ; Section 14.37 + | Server ; Section 14.38 + | Vary ; Section 14.44 + | WWW-Authenticate ; Section 14.47 + + Response-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of response- + header fields if all parties in the communication recognize them to + be response-header fields. Unrecognized header fields are treated as + entity-header fields. + +7 Entity + + Request and Response messages MAY transfer an entity if not otherwise + restricted by the request method or response status code. An entity + consists of entity-header fields and an entity-body, although some + responses will only include the entity-headers. + + In this section, both sender and recipient refer to either the client + or the server, depending on who sends and who receives the entity. + +7.1 Entity Header Fields + + Entity-header fields define metainformation about the entity-body or, + if no body is present, about the resource identified by the request. + Some of this metainformation is OPTIONAL; some might be REQUIRED by + portions of this specification. + + entity-header = Allow ; Section 14.7 + | Content-Encoding ; Section 14.11 + | Content-Language ; Section 14.12 + | Content-Length ; Section 14.13 + | Content-Location ; Section 14.14 + | Content-MD5 ; Section 14.15 + | Content-Range ; Section 14.16 + | Content-Type ; Section 14.17 + | Expires ; Section 14.21 + | Last-Modified ; Section 14.29 + | extension-header + + extension-header = message-header + + The extension-header mechanism allows additional entity-header fields + to be defined without changing the protocol, but these fields cannot + be assumed to be recognizable by the recipient. Unrecognized header + fields SHOULD be ignored by the recipient and MUST be forwarded by + transparent proxies. + + + +Fielding, et al. Standards Track [Page 42] + +RFC 2616 HTTP/1.1 June 1999 + + +7.2 Entity Body + + The entity-body (if any) sent with an HTTP request or response is in + a format and encoding defined by the entity-header fields. + + entity-body = *OCTET + + An entity-body is only present in a message when a message-body is + present, as described in section 4.3. The entity-body is obtained + from the message-body by decoding any Transfer-Encoding that might + have been applied to ensure safe and proper transfer of the message. + +7.2.1 Type + + When an entity-body is included with a message, the data type of that + body is determined via the header fields Content-Type and Content- + Encoding. These define a two-layer, ordered encoding model: + + entity-body := Content-Encoding( Content-Type( data ) ) + + Content-Type specifies the media type of the underlying data. + Content-Encoding may be used to indicate any additional content + codings applied to the data, usually for the purpose of data + compression, that are a property of the requested resource. There is + no default encoding. + + Any HTTP/1.1 message containing an entity-body SHOULD include a + Content-Type header field defining the media type of that body. If + and only if the media type is not given by a Content-Type field, the + recipient MAY attempt to guess the media type via inspection of its + content and/or the name extension(s) of the URI used to identify the + resource. If the media type remains unknown, the recipient SHOULD + treat it as type "application/octet-stream". + +7.2.2 Entity Length + + The entity-length of a message is the length of the message-body + before any transfer-codings have been applied. Section 4.4 defines + how the transfer-length of a message-body is determined. + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 43] + +RFC 2616 HTTP/1.1 June 1999 + + +8 Connections + +8.1 Persistent Connections + +8.1.1 Purpose + + Prior to persistent connections, a separate TCP connection was + established to fetch each URL, increasing the load on HTTP servers + and causing congestion on the Internet. The use of inline images and + other associated data often require a client to make multiple + requests of the same server in a short amount of time. Analysis of + these performance problems and results from a prototype + implementation are available [26] [30]. Implementation experience and + measurements of actual HTTP/1.1 (RFC 2068) implementations show good + results [39]. Alternatives have also been explored, for example, + T/TCP [27]. + + Persistent HTTP connections have a number of advantages: + + - By opening and closing fewer TCP connections, CPU time is saved + in routers and hosts (clients, servers, proxies, gateways, + tunnels, or caches), and memory used for TCP protocol control + blocks can be saved in hosts. + + - HTTP requests and responses can be pipelined on a connection. + Pipelining allows a client to make multiple requests without + waiting for each response, allowing a single TCP connection to + be used much more efficiently, with much lower elapsed time. + + - Network congestion is reduced by reducing the number of packets + caused by TCP opens, and by allowing TCP sufficient time to + determine the congestion state of the network. + + - Latency on subsequent requests is reduced since there is no time + spent in TCP's connection opening handshake. + + - HTTP can evolve more gracefully, since errors can be reported + without the penalty of closing the TCP connection. Clients using + future versions of HTTP might optimistically try a new feature, + but if communicating with an older server, retry with old + semantics after an error is reported. + + HTTP implementations SHOULD implement persistent connections. + + + + + + + + +Fielding, et al. Standards Track [Page 44] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2 Overall Operation + + A significant difference between HTTP/1.1 and earlier versions of + HTTP is that persistent connections are the default behavior of any + HTTP connection. That is, unless otherwise indicated, the client + SHOULD assume that the server will maintain a persistent connection, + even after error responses from the server. + + Persistent connections provide a mechanism by which a client and a + server can signal the close of a TCP connection. This signaling takes + place using the Connection header field (section 14.10). Once a close + has been signaled, the client MUST NOT send any more requests on that + connection. + +8.1.2.1 Negotiation + + An HTTP/1.1 server MAY assume that a HTTP/1.1 client intends to + maintain a persistent connection unless a Connection header including + the connection-token "close" was sent in the request. If the server + chooses to close the connection immediately after sending the + response, it SHOULD send a Connection header including the + connection-token close. + + An HTTP/1.1 client MAY expect a connection to remain open, but would + decide to keep it open based on whether the response from a server + contains a Connection header with the connection-token close. In case + the client does not want to maintain a connection for more than that + request, it SHOULD send a Connection header including the + connection-token close. + + If either the client or the server sends the close token in the + Connection header, that request becomes the last one for the + connection. + + Clients and servers SHOULD NOT assume that a persistent connection is + maintained for HTTP versions less than 1.1 unless it is explicitly + signaled. See section 19.6.2 for more information on backward + compatibility with HTTP/1.0 clients. + + In order to remain persistent, all messages on the connection MUST + have a self-defined message length (i.e., one not defined by closure + of the connection), as described in section 4.4. + + + + + + + + + +Fielding, et al. Standards Track [Page 45] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2.2 Pipelining + + A client that supports persistent connections MAY "pipeline" its + requests (i.e., send multiple requests without waiting for each + response). A server MUST send its responses to those requests in the + same order that the requests were received. + + Clients which assume persistent connections and pipeline immediately + after connection establishment SHOULD be prepared to retry their + connection if the first pipelined attempt fails. If a client does + such a retry, it MUST NOT pipeline before it knows the connection is + persistent. Clients MUST also be prepared to resend their requests if + the server closes the connection before sending all of the + corresponding responses. + + Clients SHOULD NOT pipeline requests using non-idempotent methods or + non-idempotent sequences of methods (see section 9.1.2). Otherwise, a + premature termination of the transport connection could lead to + indeterminate results. A client wishing to send a non-idempotent + request SHOULD wait to send that request until it has received the + response status for the previous request. + +8.1.3 Proxy Servers + + It is especially important that proxies correctly implement the + properties of the Connection header field as specified in section + 14.10. + + The proxy server MUST signal persistent connections separately with + its clients and the origin servers (or other proxy servers) that it + connects to. Each persistent connection applies to only one transport + link. + + A proxy server MUST NOT establish a HTTP/1.1 persistent connection + with an HTTP/1.0 client (but see RFC 2068 [33] for information and + discussion of the problems with the Keep-Alive header implemented by + many HTTP/1.0 clients). + +8.1.4 Practical Considerations + + Servers will usually have some time-out value beyond which they will + no longer maintain an inactive connection. Proxy servers might make + this a higher value since it is likely that the client will be making + more connections through the same server. The use of persistent + connections places no requirements on the length (or existence) of + this time-out for either the client or the server. + + + + + +Fielding, et al. Standards Track [Page 46] + +RFC 2616 HTTP/1.1 June 1999 + + + When a client or server wishes to time-out it SHOULD issue a graceful + close on the transport connection. Clients and servers SHOULD both + constantly watch for the other side of the transport close, and + respond to it as appropriate. If a client or server does not detect + the other side's close promptly it could cause unnecessary resource + drain on the network. + + A client, server, or proxy MAY close the transport connection at any + time. For example, a client might have started to send a new request + at the same time that the server has decided to close the "idle" + connection. From the server's point of view, the connection is being + closed while it was idle, but from the client's point of view, a + request is in progress. + + This means that clients, servers, and proxies MUST be able to recover + from asynchronous close events. Client software SHOULD reopen the + transport connection and retransmit the aborted sequence of requests + without user interaction so long as the request sequence is + idempotent (see section 9.1.2). Non-idempotent methods or sequences + MUST NOT be automatically retried, although user agents MAY offer a + human operator the choice of retrying the request(s). Confirmation by + user-agent software with semantic understanding of the application + MAY substitute for user confirmation. The automatic retry SHOULD NOT + be repeated if the second sequence of requests fails. + + Servers SHOULD always respond to at least one request per connection, + if at all possible. Servers SHOULD NOT close a connection in the + middle of transmitting a response, unless a network or client failure + is suspected. + + Clients that use persistent connections SHOULD limit the number of + simultaneous connections that they maintain to a given server. A + single-user client SHOULD NOT maintain more than 2 connections with + any server or proxy. A proxy SHOULD use up to 2*N connections to + another server or proxy, where N is the number of simultaneously + active users. These guidelines are intended to improve HTTP response + times and avoid congestion. + +8.2 Message Transmission Requirements + +8.2.1 Persistent Connections and Flow Control + + HTTP/1.1 servers SHOULD maintain persistent connections and use TCP's + flow control mechanisms to resolve temporary overloads, rather than + terminating connections with the expectation that clients will retry. + The latter technique can exacerbate network congestion. + + + + + +Fielding, et al. Standards Track [Page 47] + +RFC 2616 HTTP/1.1 June 1999 + + +8.2.2 Monitoring Connections for Error Status Messages + + An HTTP/1.1 (or later) client sending a message-body SHOULD monitor + the network connection for an error status while it is transmitting + the request. If the client sees an error status, it SHOULD + immediately cease transmitting the body. If the body is being sent + using a "chunked" encoding (section 3.6), a zero length chunk and + empty trailer MAY be used to prematurely mark the end of the message. + If the body was preceded by a Content-Length header, the client MUST + close the connection. + +8.2.3 Use of the 100 (Continue) Status + + The purpose of the 100 (Continue) status (see section 10.1.1) is to + allow a client that is sending a request message with a request body + to determine if the origin server is willing to accept the request + (based on the request headers) before the client sends the request + body. In some cases, it might either be inappropriate or highly + inefficient for the client to send the body if the server will reject + the message without looking at the body. + + Requirements for HTTP/1.1 clients: + + - If a client will wait for a 100 (Continue) response before + sending the request body, it MUST send an Expect request-header + field (section 14.20) with the "100-continue" expectation. + + - A client MUST NOT send an Expect request-header field (section + 14.20) with the "100-continue" expectation if it does not intend + to send a request body. + + Because of the presence of older implementations, the protocol allows + ambiguous situations in which a client may send "Expect: 100- + continue" without receiving either a 417 (Expectation Failed) status + or a 100 (Continue) status. Therefore, when a client sends this + header field to an origin server (possibly via a proxy) from which it + has never seen a 100 (Continue) status, the client SHOULD NOT wait + for an indefinite period before sending the request body. + + Requirements for HTTP/1.1 origin servers: + + - Upon receiving a request which includes an Expect request-header + field with the "100-continue" expectation, an origin server MUST + either respond with 100 (Continue) status and continue to read + from the input stream, or respond with a final status code. The + origin server MUST NOT wait for the request body before sending + the 100 (Continue) response. If it responds with a final status + code, it MAY close the transport connection or it MAY continue + + + +Fielding, et al. Standards Track [Page 48] + +RFC 2616 HTTP/1.1 June 1999 + + + to read and discard the rest of the request. It MUST NOT + perform the requested method if it returns a final status code. + + - An origin server SHOULD NOT send a 100 (Continue) response if + the request message does not include an Expect request-header + field with the "100-continue" expectation, and MUST NOT send a + 100 (Continue) response if such a request comes from an HTTP/1.0 + (or earlier) client. There is an exception to this rule: for + compatibility with RFC 2068, a server MAY send a 100 (Continue) + status in response to an HTTP/1.1 PUT or POST request that does + not include an Expect request-header field with the "100- + continue" expectation. This exception, the purpose of which is + to minimize any client processing delays associated with an + undeclared wait for 100 (Continue) status, applies only to + HTTP/1.1 requests, and not to requests with any other HTTP- + version value. + + - An origin server MAY omit a 100 (Continue) response if it has + already received some or all of the request body for the + corresponding request. + + - An origin server that sends a 100 (Continue) response MUST + ultimately send a final status code, once the request body is + received and processed, unless it terminates the transport + connection prematurely. + + - If an origin server receives a request that does not include an + Expect request-header field with the "100-continue" expectation, + the request includes a request body, and the server responds + with a final status code before reading the entire request body + from the transport connection, then the server SHOULD NOT close + the transport connection until it has read the entire request, + or until the client closes the connection. Otherwise, the client + might not reliably receive the response message. However, this + requirement is not be construed as preventing a server from + defending itself against denial-of-service attacks, or from + badly broken client implementations. + + Requirements for HTTP/1.1 proxies: + + - If a proxy receives a request that includes an Expect request- + header field with the "100-continue" expectation, and the proxy + either knows that the next-hop server complies with HTTP/1.1 or + higher, or does not know the HTTP version of the next-hop + server, it MUST forward the request, including the Expect header + field. + + + + + +Fielding, et al. Standards Track [Page 49] + +RFC 2616 HTTP/1.1 June 1999 + + + - If the proxy knows that the version of the next-hop server is + HTTP/1.0 or lower, it MUST NOT forward the request, and it MUST + respond with a 417 (Expectation Failed) status. + + - Proxies SHOULD maintain a cache recording the HTTP version + numbers received from recently-referenced next-hop servers. + + - A proxy MUST NOT forward a 100 (Continue) response if the + request message was received from an HTTP/1.0 (or earlier) + client and did not include an Expect request-header field with + the "100-continue" expectation. This requirement overrides the + general rule for forwarding of 1xx responses (see section 10.1). + +8.2.4 Client Behavior if Server Prematurely Closes Connection + + If an HTTP/1.1 client sends a request which includes a request body, + but which does not include an Expect request-header field with the + "100-continue" expectation, and if the client is not directly + connected to an HTTP/1.1 origin server, and if the client sees the + connection close before receiving any status from the server, the + client SHOULD retry the request. If the client does retry this + request, it MAY use the following "binary exponential backoff" + algorithm to be assured of obtaining a reliable response: + + 1. Initiate a new connection to the server + + 2. Transmit the request-headers + + 3. Initialize a variable R to the estimated round-trip time to the + server (e.g., based on the time it took to establish the + connection), or to a constant value of 5 seconds if the round- + trip time is not available. + + 4. Compute T = R * (2**N), where N is the number of previous + retries of this request. + + 5. Wait either for an error response from the server, or for T + seconds (whichever comes first) + + 6. If no error response is received, after T seconds transmit the + body of the request. + + 7. If client sees that the connection is closed prematurely, + repeat from step 1 until the request is accepted, an error + response is received, or the user becomes impatient and + terminates the retry process. + + + + + +Fielding, et al. Standards Track [Page 50] + +RFC 2616 HTTP/1.1 June 1999 + + + If at any point an error status is received, the client + + - SHOULD NOT continue and + + - SHOULD close the connection if it has not completed sending the + request message. + +9 Method Definitions + + The set of common methods for HTTP/1.1 is defined below. Although + this set can be expanded, additional methods cannot be assumed to + share the same semantics for separately extended clients and servers. + + The Host request-header field (section 14.23) MUST accompany all + HTTP/1.1 requests. + +9.1 Safe and Idempotent Methods + +9.1.1 Safe Methods + + Implementors should be aware that the software represents the user in + their interactions over the Internet, and should be careful to allow + the user to be aware of any actions they might take which may have an + unexpected significance to themselves or others. + + In particular, the convention has been established that the GET and + HEAD methods SHOULD NOT have the significance of taking an action + other than retrieval. These methods ought to be considered "safe". + This allows user agents to represent other methods, such as POST, PUT + and DELETE, in a special way, so that the user is made aware of the + fact that a possibly unsafe action is being requested. + + Naturally, it is not possible to ensure that the server does not + generate side-effects as a result of performing a GET request; in + fact, some dynamic resources consider that a feature. The important + distinction here is that the user did not request the side-effects, + so therefore cannot be held accountable for them. + +9.1.2 Idempotent Methods + + Methods can also have the property of "idempotence" in that (aside + from error or expiration issues) the side-effects of N > 0 identical + requests is the same as for a single request. The methods GET, HEAD, + PUT and DELETE share this property. Also, the methods OPTIONS and + TRACE SHOULD NOT have side effects, and so are inherently idempotent. + + + + + + +Fielding, et al. Standards Track [Page 51] + +RFC 2616 HTTP/1.1 June 1999 + + + However, it is possible that a sequence of several requests is non- + idempotent, even if all of the methods executed in that sequence are + idempotent. (A sequence is idempotent if a single execution of the + entire sequence always yields a result that is not changed by a + reexecution of all, or part, of that sequence.) For example, a + sequence is non-idempotent if its result depends on a value that is + later modified in the same sequence. + + A sequence that never has side effects is idempotent, by definition + (provided that no concurrent operations are being executed on the + same set of resources). + +9.2 OPTIONS + + The OPTIONS method represents a request for information about the + communication options available on the request/response chain + identified by the Request-URI. This method allows the client to + determine the options and/or requirements associated with a resource, + or the capabilities of a server, without implying a resource action + or initiating a resource retrieval. + + Responses to this method are not cacheable. + + If the OPTIONS request includes an entity-body (as indicated by the + presence of Content-Length or Transfer-Encoding), then the media type + MUST be indicated by a Content-Type field. Although this + specification does not define any use for such a body, future + extensions to HTTP might use the OPTIONS body to make more detailed + queries on the server. A server that does not support such an + extension MAY discard the request body. + + If the Request-URI is an asterisk ("*"), the OPTIONS request is + intended to apply to the server in general rather than to a specific + resource. Since a server's communication options typically depend on + the resource, the "*" request is only useful as a "ping" or "no-op" + type of method; it does nothing beyond allowing the client to test + the capabilities of the server. For example, this can be used to test + a proxy for HTTP/1.1 compliance (or lack thereof). + + If the Request-URI is not an asterisk, the OPTIONS request applies + only to the options that are available when communicating with that + resource. + + A 200 response SHOULD include any header fields that indicate + optional features implemented by the server and applicable to that + resource (e.g., Allow), possibly including extensions not defined by + this specification. The response body, if any, SHOULD also include + information about the communication options. The format for such a + + + +Fielding, et al. Standards Track [Page 52] + +RFC 2616 HTTP/1.1 June 1999 + + + body is not defined by this specification, but might be defined by + future extensions to HTTP. Content negotiation MAY be used to select + the appropriate response format. If no response body is included, the + response MUST include a Content-Length field with a field-value of + "0". + + The Max-Forwards request-header field MAY be used to target a + specific proxy in the request chain. When a proxy receives an OPTIONS + request on an absoluteURI for which request forwarding is permitted, + the proxy MUST check for a Max-Forwards field. If the Max-Forwards + field-value is zero ("0"), the proxy MUST NOT forward the message; + instead, the proxy SHOULD respond with its own communication options. + If the Max-Forwards field-value is an integer greater than zero, the + proxy MUST decrement the field-value when it forwards the request. If + no Max-Forwards field is present in the request, then the forwarded + request MUST NOT include a Max-Forwards field. + +9.3 GET + + The GET method means retrieve whatever information (in the form of an + entity) is identified by the Request-URI. If the Request-URI refers + to a data-producing process, it is the produced data which shall be + returned as the entity in the response and not the source text of the + process, unless that text happens to be the output of the process. + + The semantics of the GET method change to a "conditional GET" if the + request message includes an If-Modified-Since, If-Unmodified-Since, + If-Match, If-None-Match, or If-Range header field. A conditional GET + method requests that the entity be transferred only under the + circumstances described by the conditional header field(s). The + conditional GET method is intended to reduce unnecessary network + usage by allowing cached entities to be refreshed without requiring + multiple requests or transferring data already held by the client. + + The semantics of the GET method change to a "partial GET" if the + request message includes a Range header field. A partial GET requests + that only part of the entity be transferred, as described in section + 14.35. The partial GET method is intended to reduce unnecessary + network usage by allowing partially-retrieved entities to be + completed without transferring data already held by the client. + + The response to a GET request is cacheable if and only if it meets + the requirements for HTTP caching described in section 13. + + See section 15.1.3 for security considerations when used for forms. + + + + + + +Fielding, et al. Standards Track [Page 53] + +RFC 2616 HTTP/1.1 June 1999 + + +9.4 HEAD + + The HEAD method is identical to GET except that the server MUST NOT + return a message-body in the response. The metainformation contained + in the HTTP headers in response to a HEAD request SHOULD be identical + to the information sent in response to a GET request. This method can + be used for obtaining metainformation about the entity implied by the + request without transferring the entity-body itself. This method is + often used for testing hypertext links for validity, accessibility, + and recent modification. + + The response to a HEAD request MAY be cacheable in the sense that the + information contained in the response MAY be used to update a + previously cached entity from that resource. If the new field values + indicate that the cached entity differs from the current entity (as + would be indicated by a change in Content-Length, Content-MD5, ETag + or Last-Modified), then the cache MUST treat the cache entry as + stale. + +9.5 POST + + The POST method is used to request that the origin server accept the + entity enclosed in the request as a new subordinate of the resource + identified by the Request-URI in the Request-Line. POST is designed + to allow a uniform method to cover the following functions: + + - Annotation of existing resources; + + - Posting a message to a bulletin board, newsgroup, mailing list, + or similar group of articles; + + - Providing a block of data, such as the result of submitting a + form, to a data-handling process; + + - Extending a database through an append operation. + + The actual function performed by the POST method is determined by the + server and is usually dependent on the Request-URI. The posted entity + is subordinate to that URI in the same way that a file is subordinate + to a directory containing it, a news article is subordinate to a + newsgroup to which it is posted, or a record is subordinate to a + database. + + The action performed by the POST method might not result in a + resource that can be identified by a URI. In this case, either 200 + (OK) or 204 (No Content) is the appropriate response status, + depending on whether or not the response includes an entity that + describes the result. + + + +Fielding, et al. Standards Track [Page 54] + +RFC 2616 HTTP/1.1 June 1999 + + + If a resource has been created on the origin server, the response + SHOULD be 201 (Created) and contain an entity which describes the + status of the request and refers to the new resource, and a Location + header (see section 14.30). + + Responses to this method are not cacheable, unless the response + includes appropriate Cache-Control or Expires header fields. However, + the 303 (See Other) response can be used to direct the user agent to + retrieve a cacheable resource. + + POST requests MUST obey the message transmission requirements set out + in section 8.2. + + See section 15.1.3 for security considerations. + +9.6 PUT + + The PUT method requests that the enclosed entity be stored under the + supplied Request-URI. If the Request-URI refers to an already + existing resource, the enclosed entity SHOULD be considered as a + modified version of the one residing on the origin server. If the + Request-URI does not point to an existing resource, and that URI is + capable of being defined as a new resource by the requesting user + agent, the origin server can create the resource with that URI. If a + new resource is created, the origin server MUST inform the user agent + via the 201 (Created) response. If an existing resource is modified, + either the 200 (OK) or 204 (No Content) response codes SHOULD be sent + to indicate successful completion of the request. If the resource + could not be created or modified with the Request-URI, an appropriate + error response SHOULD be given that reflects the nature of the + problem. The recipient of the entity MUST NOT ignore any Content-* + (e.g. Content-Range) headers that it does not understand or implement + and MUST return a 501 (Not Implemented) response in such cases. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + + The fundamental difference between the POST and PUT requests is + reflected in the different meaning of the Request-URI. The URI in a + POST request identifies the resource that will handle the enclosed + entity. That resource might be a data-accepting process, a gateway to + some other protocol, or a separate entity that accepts annotations. + In contrast, the URI in a PUT request identifies the entity enclosed + with the request -- the user agent knows what URI is intended and the + server MUST NOT attempt to apply the request to some other resource. + If the server desires that the request be applied to a different URI, + + + + +Fielding, et al. Standards Track [Page 55] + +RFC 2616 HTTP/1.1 June 1999 + + + it MUST send a 301 (Moved Permanently) response; the user agent MAY + then make its own decision regarding whether or not to redirect the + request. + + A single resource MAY be identified by many different URIs. For + example, an article might have a URI for identifying "the current + version" which is separate from the URI identifying each particular + version. In this case, a PUT request on a general URI might result in + several other URIs being defined by the origin server. + + HTTP/1.1 does not define how a PUT method affects the state of an + origin server. + + PUT requests MUST obey the message transmission requirements set out + in section 8.2. + + Unless otherwise specified for a particular entity-header, the + entity-headers in the PUT request SHOULD be applied to the resource + created or modified by the PUT. + +9.7 DELETE + + The DELETE method requests that the origin server delete the resource + identified by the Request-URI. This method MAY be overridden by human + intervention (or other means) on the origin server. The client cannot + be guaranteed that the operation has been carried out, even if the + status code returned from the origin server indicates that the action + has been completed successfully. However, the server SHOULD NOT + indicate success unless, at the time the response is given, it + intends to delete the resource or move it to an inaccessible + location. + + A successful response SHOULD be 200 (OK) if the response includes an + entity describing the status, 202 (Accepted) if the action has not + yet been enacted, or 204 (No Content) if the action has been enacted + but the response does not include an entity. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + +9.8 TRACE + + The TRACE method is used to invoke a remote, application-layer loop- + back of the request message. The final recipient of the request + SHOULD reflect the message received back to the client as the + entity-body of a 200 (OK) response. The final recipient is either the + + + + +Fielding, et al. Standards Track [Page 56] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server or the first proxy or gateway to receive a Max-Forwards + value of zero (0) in the request (see section 14.31). A TRACE request + MUST NOT include an entity. + + TRACE allows the client to see what is being received at the other + end of the request chain and use that data for testing or diagnostic + information. The value of the Via header field (section 14.45) is of + particular interest, since it acts as a trace of the request chain. + Use of the Max-Forwards header field allows the client to limit the + length of the request chain, which is useful for testing a chain of + proxies forwarding messages in an infinite loop. + + If the request is valid, the response SHOULD contain the entire + request message in the entity-body, with a Content-Type of + "message/http". Responses to this method MUST NOT be cached. + +9.9 CONNECT + + This specification reserves the method name CONNECT for use with a + proxy that can dynamically switch to being a tunnel (e.g. SSL + tunneling [44]). + +10 Status Code Definitions + + Each Status-Code is described below, including a description of which + method(s) it can follow and any metainformation required in the + response. + +10.1 Informational 1xx + + This class of status code indicates a provisional response, + consisting only of the Status-Line and optional headers, and is + terminated by an empty line. There are no required headers for this + class of status code. Since HTTP/1.0 did not define any 1xx status + codes, servers MUST NOT send a 1xx response to an HTTP/1.0 client + except under experimental conditions. + + A client MUST be prepared to accept one or more 1xx status responses + prior to a regular response, even if the client does not expect a 100 + (Continue) status message. Unexpected 1xx status responses MAY be + ignored by a user agent. + + Proxies MUST forward 1xx responses, unless the connection between the + proxy and its client has been closed, or unless the proxy itself + requested the generation of the 1xx response. (For example, if a + + + + + + +Fielding, et al. Standards Track [Page 57] + +RFC 2616 HTTP/1.1 June 1999 + + + proxy adds a "Expect: 100-continue" field when it forwards a request, + then it need not forward the corresponding 100 (Continue) + response(s).) + +10.1.1 100 Continue + + The client SHOULD continue with its request. This interim response is + used to inform the client that the initial part of the request has + been received and has not yet been rejected by the server. The client + SHOULD continue by sending the remainder of the request or, if the + request has already been completed, ignore this response. The server + MUST send a final response after the request has been completed. See + section 8.2.3 for detailed discussion of the use and handling of this + status code. + +10.1.2 101 Switching Protocols + + The server understands and is willing to comply with the client's + request, via the Upgrade message header field (section 14.42), for a + change in the application protocol being used on this connection. The + server will switch protocols to those defined by the response's + Upgrade header field immediately after the empty line which + terminates the 101 response. + + The protocol SHOULD be switched only when it is advantageous to do + so. For example, switching to a newer version of HTTP is advantageous + over older versions, and switching to a real-time, synchronous + protocol might be advantageous when delivering resources that use + such features. + +10.2 Successful 2xx + + This class of status code indicates that the client's request was + successfully received, understood, and accepted. + +10.2.1 200 OK + + The request has succeeded. The information returned with the response + is dependent on the method used in the request, for example: + + GET an entity corresponding to the requested resource is sent in + the response; + + HEAD the entity-header fields corresponding to the requested + resource are sent in the response without any message-body; + + POST an entity describing or containing the result of the action; + + + + +Fielding, et al. Standards Track [Page 58] + +RFC 2616 HTTP/1.1 June 1999 + + + TRACE an entity containing the request message as received by the + end server. + +10.2.2 201 Created + + The request has been fulfilled and resulted in a new resource being + created. The newly created resource can be referenced by the URI(s) + returned in the entity of the response, with the most specific URI + for the resource given by a Location header field. The response + SHOULD include an entity containing a list of resource + characteristics and location(s) from which the user or user agent can + choose the one most appropriate. The entity format is specified by + the media type given in the Content-Type header field. The origin + server MUST create the resource before returning the 201 status code. + If the action cannot be carried out immediately, the server SHOULD + respond with 202 (Accepted) response instead. + + A 201 response MAY contain an ETag response header field indicating + the current value of the entity tag for the requested variant just + created, see section 14.19. + +10.2.3 202 Accepted + + The request has been accepted for processing, but the processing has + not been completed. The request might or might not eventually be + acted upon, as it might be disallowed when processing actually takes + place. There is no facility for re-sending a status code from an + asynchronous operation such as this. + + The 202 response is intentionally non-committal. Its purpose is to + allow a server to accept a request for some other process (perhaps a + batch-oriented process that is only run once per day) without + requiring that the user agent's connection to the server persist + until the process is completed. The entity returned with this + response SHOULD include an indication of the request's current status + and either a pointer to a status monitor or some estimate of when the + user can expect the request to be fulfilled. + +10.2.4 203 Non-Authoritative Information + + The returned metainformation in the entity-header is not the + definitive set as available from the origin server, but is gathered + from a local or a third-party copy. The set presented MAY be a subset + or superset of the original version. For example, including local + annotation information about the resource might result in a superset + of the metainformation known by the origin server. Use of this + response code is not required and is only appropriate when the + response would otherwise be 200 (OK). + + + +Fielding, et al. Standards Track [Page 59] + +RFC 2616 HTTP/1.1 June 1999 + + +10.2.5 204 No Content + + The server has fulfilled the request but does not need to return an + entity-body, and might want to return updated metainformation. The + response MAY include new or updated metainformation in the form of + entity-headers, which if present SHOULD be associated with the + requested variant. + + If the client is a user agent, it SHOULD NOT change its document view + from that which caused the request to be sent. This response is + primarily intended to allow input for actions to take place without + causing a change to the user agent's active document view, although + any new or updated metainformation SHOULD be applied to the document + currently in the user agent's active view. + + The 204 response MUST NOT include a message-body, and thus is always + terminated by the first empty line after the header fields. + +10.2.6 205 Reset Content + + The server has fulfilled the request and the user agent SHOULD reset + the document view which caused the request to be sent. This response + is primarily intended to allow input for actions to take place via + user input, followed by a clearing of the form in which the input is + given so that the user can easily initiate another input action. The + response MUST NOT include an entity. + +10.2.7 206 Partial Content + + The server has fulfilled the partial GET request for the resource. + The request MUST have included a Range header field (section 14.35) + indicating the desired range, and MAY have included an If-Range + header field (section 14.27) to make the request conditional. + + The response MUST include the following header fields: + + - Either a Content-Range header field (section 14.16) indicating + the range included with this response, or a multipart/byteranges + Content-Type including Content-Range fields for each part. If a + Content-Length header field is present in the response, its + value MUST match the actual number of OCTETs transmitted in the + message-body. + + - Date + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + + + +Fielding, et al. Standards Track [Page 60] + +RFC 2616 HTTP/1.1 June 1999 + + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the 206 response is the result of an If-Range request that used a + strong cache validator (see section 13.3.3), the response SHOULD NOT + include other entity-headers. If the response is the result of an + If-Range request that used a weak validator, the response MUST NOT + include other entity-headers; this prevents inconsistencies between + cached entity-bodies and updated headers. Otherwise, the response + MUST include all of the entity-headers that would have been returned + with a 200 (OK) response to the same request. + + A cache MUST NOT combine a 206 response with other previously cached + content if the ETag or Last-Modified headers do not match exactly, + see 13.5.4. + + A cache that does not support the Range and Content-Range headers + MUST NOT cache 206 (Partial) responses. + +10.3 Redirection 3xx + + This class of status code indicates that further action needs to be + taken by the user agent in order to fulfill the request. The action + required MAY be carried out by the user agent without interaction + with the user if and only if the method used in the second request is + GET or HEAD. A client SHOULD detect infinite redirection loops, since + such loops generate network traffic for each redirection. + + Note: previous versions of this specification recommended a + maximum of five redirections. Content developers should be aware + that there might be clients that implement such a fixed + limitation. + +10.3.1 300 Multiple Choices + + The requested resource corresponds to any one of a set of + representations, each with its own specific location, and agent- + driven negotiation information (section 12) is being provided so that + the user (or user agent) can select a preferred representation and + redirect its request to that location. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of resource characteristics and location(s) from + which the user or user agent can choose the one most appropriate. The + entity format is specified by the media type given in the Content- + Type header field. Depending upon the format and the capabilities of + + + + +Fielding, et al. Standards Track [Page 61] + +RFC 2616 HTTP/1.1 June 1999 + + + the user agent, selection of the most appropriate choice MAY be + performed automatically. However, this specification does not define + any standard for such automatic selection. + + If the server has a preferred choice of representation, it SHOULD + include the specific URI for that representation in the Location + field; user agents MAY use the Location field value for automatic + redirection. This response is cacheable unless indicated otherwise. + +10.3.2 301 Moved Permanently + + The requested resource has been assigned a new permanent URI and any + future references to this resource SHOULD use one of the returned + URIs. Clients with link editing capabilities ought to automatically + re-link references to the Request-URI to one or more of the new + references returned by the server, where possible. This response is + cacheable unless indicated otherwise. + + The new permanent URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + If the 301 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: When automatically redirecting a POST request after + receiving a 301 status code, some existing HTTP/1.0 user agents + will erroneously change it into a GET request. + +10.3.3 302 Found + + The requested resource resides temporarily under a different URI. + Since the redirection might be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + + + + + + +Fielding, et al. Standards Track [Page 62] + +RFC 2616 HTTP/1.1 June 1999 + + + If the 302 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: RFC 1945 and RFC 2068 specify that the client is not allowed + to change the method on the redirected request. However, most + existing user agent implementations treat 302 as if it were a 303 + response, performing a GET on the Location field-value regardless + of the original request method. The status codes 303 and 307 have + been added for servers that wish to make unambiguously clear which + kind of reaction is expected of the client. + +10.3.4 303 See Other + + The response to the request can be found under a different URI and + SHOULD be retrieved using a GET method on that resource. This method + exists primarily to allow the output of a POST-activated script to + redirect the user agent to a selected resource. The new URI is not a + substitute reference for the originally requested resource. The 303 + response MUST NOT be cached, but the response to the second + (redirected) request might be cacheable. + + The different URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + Note: Many pre-HTTP/1.1 user agents do not understand the 303 + status. When interoperability with such clients is a concern, the + 302 status code may be used instead, since most user agents react + to a 302 response as described here for 303. + +10.3.5 304 Not Modified + + If the client has performed a conditional GET request and access is + allowed, but the document has not been modified, the server SHOULD + respond with this status code. The 304 response MUST NOT contain a + message-body, and thus is always terminated by the first empty line + after the header fields. + + The response MUST include the following header fields: + + - Date, unless its omission is required by section 14.18.1 + + + + + + + +Fielding, et al. Standards Track [Page 63] + +RFC 2616 HTTP/1.1 June 1999 + + + If a clockless origin server obeys these rules, and proxies and + clients add their own Date to any response received without one (as + already specified by [RFC 2068], section 14.19), caches will operate + correctly. + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the conditional GET used a strong cache validator (see section + 13.3.3), the response SHOULD NOT include other entity-headers. + Otherwise (i.e., the conditional GET used a weak validator), the + response MUST NOT include other entity-headers; this prevents + inconsistencies between cached entity-bodies and updated headers. + + If a 304 response indicates an entity not currently cached, then the + cache MUST disregard the response and repeat the request without the + conditional. + + If a cache uses a received 304 response to update a cache entry, the + cache MUST update the entry to reflect any new field values given in + the response. + +10.3.6 305 Use Proxy + + The requested resource MUST be accessed through the proxy given by + the Location field. The Location field gives the URI of the proxy. + The recipient is expected to repeat this single request via the + proxy. 305 responses MUST only be generated by origin servers. + + Note: RFC 2068 was not clear that 305 was intended to redirect a + single request, and to be generated by origin servers only. Not + observing these limitations has significant security consequences. + +10.3.7 306 (Unused) + + The 306 status code was used in a previous version of the + specification, is no longer used, and the code is reserved. + + + + + + + + + + +Fielding, et al. Standards Track [Page 64] + +RFC 2616 HTTP/1.1 June 1999 + + +10.3.8 307 Temporary Redirect + + The requested resource resides temporarily under a different URI. + Since the redirection MAY be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s) , since many pre-HTTP/1.1 user agents do not + understand the 307 status. Therefore, the note SHOULD contain the + information necessary for a user to repeat the original request on + the new URI. + + If the 307 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + +10.4 Client Error 4xx + + The 4xx class of status code is intended for cases in which the + client seems to have erred. Except when responding to a HEAD request, + the server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. These status codes are applicable to any request method. + User agents SHOULD display any included entity to the user. + + If the client is sending data, a server implementation using TCP + SHOULD be careful to ensure that the client acknowledges receipt of + the packet(s) containing the response, before the server closes the + input connection. If the client continues sending data to the server + after the close, the server's TCP stack will send a reset packet to + the client, which may erase the client's unacknowledged input buffers + before they can be read and interpreted by the HTTP application. + +10.4.1 400 Bad Request + + The request could not be understood by the server due to malformed + syntax. The client SHOULD NOT repeat the request without + modifications. + + + + + + + + +Fielding, et al. Standards Track [Page 65] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.2 401 Unauthorized + + The request requires user authentication. The response MUST include a + WWW-Authenticate header field (section 14.47) containing a challenge + applicable to the requested resource. The client MAY repeat the + request with a suitable Authorization header field (section 14.8). If + the request already included Authorization credentials, then the 401 + response indicates that authorization has been refused for those + credentials. If the 401 response contains the same challenge as the + prior response, and the user agent has already attempted + authentication at least once, then the user SHOULD be presented the + entity that was given in the response, since that entity might + include relevant diagnostic information. HTTP access authentication + is explained in "HTTP Authentication: Basic and Digest Access + Authentication" [43]. + +10.4.3 402 Payment Required + + This code is reserved for future use. + +10.4.4 403 Forbidden + + The server understood the request, but is refusing to fulfill it. + Authorization will not help and the request SHOULD NOT be repeated. + If the request method was not HEAD and the server wishes to make + public why the request has not been fulfilled, it SHOULD describe the + reason for the refusal in the entity. If the server does not wish to + make this information available to the client, the status code 404 + (Not Found) can be used instead. + +10.4.5 404 Not Found + + The server has not found anything matching the Request-URI. No + indication is given of whether the condition is temporary or + permanent. The 410 (Gone) status code SHOULD be used if the server + knows, through some internally configurable mechanism, that an old + resource is permanently unavailable and has no forwarding address. + This status code is commonly used when the server does not wish to + reveal exactly why the request has been refused, or when no other + response is applicable. + +10.4.6 405 Method Not Allowed + + The method specified in the Request-Line is not allowed for the + resource identified by the Request-URI. The response MUST include an + Allow header containing a list of valid methods for the requested + resource. + + + + +Fielding, et al. Standards Track [Page 66] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.7 406 Not Acceptable + + The resource identified by the request is only capable of generating + response entities which have content characteristics not acceptable + according to the accept headers sent in the request. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of available entity characteristics and location(s) + from which the user or user agent can choose the one most + appropriate. The entity format is specified by the media type given + in the Content-Type header field. Depending upon the format and the + capabilities of the user agent, selection of the most appropriate + choice MAY be performed automatically. However, this specification + does not define any standard for such automatic selection. + + Note: HTTP/1.1 servers are allowed to return responses which are + not acceptable according to the accept headers sent in the + request. In some cases, this may even be preferable to sending a + 406 response. User agents are encouraged to inspect the headers of + an incoming response to determine if it is acceptable. + + If the response could be unacceptable, a user agent SHOULD + temporarily stop receipt of more data and query the user for a + decision on further actions. + +10.4.8 407 Proxy Authentication Required + + This code is similar to 401 (Unauthorized), but indicates that the + client must first authenticate itself with the proxy. The proxy MUST + return a Proxy-Authenticate header field (section 14.33) containing a + challenge applicable to the proxy for the requested resource. The + client MAY repeat the request with a suitable Proxy-Authorization + header field (section 14.34). HTTP access authentication is explained + in "HTTP Authentication: Basic and Digest Access Authentication" + [43]. + +10.4.9 408 Request Timeout + + The client did not produce a request within the time that the server + was prepared to wait. The client MAY repeat the request without + modifications at any later time. + +10.4.10 409 Conflict + + The request could not be completed due to a conflict with the current + state of the resource. This code is only allowed in situations where + it is expected that the user might be able to resolve the conflict + and resubmit the request. The response body SHOULD include enough + + + +Fielding, et al. Standards Track [Page 67] + +RFC 2616 HTTP/1.1 June 1999 + + + information for the user to recognize the source of the conflict. + Ideally, the response entity would include enough information for the + user or user agent to fix the problem; however, that might not be + possible and is not required. + + Conflicts are most likely to occur in response to a PUT request. For + example, if versioning were being used and the entity being PUT + included changes to a resource which conflict with those made by an + earlier (third-party) request, the server might use the 409 response + to indicate that it can't complete the request. In this case, the + response entity would likely contain a list of the differences + between the two versions in a format defined by the response + Content-Type. + +10.4.11 410 Gone + + The requested resource is no longer available at the server and no + forwarding address is known. This condition is expected to be + considered permanent. Clients with link editing capabilities SHOULD + delete references to the Request-URI after user approval. If the + server does not know, or has no facility to determine, whether or not + the condition is permanent, the status code 404 (Not Found) SHOULD be + used instead. This response is cacheable unless indicated otherwise. + + The 410 response is primarily intended to assist the task of web + maintenance by notifying the recipient that the resource is + intentionally unavailable and that the server owners desire that + remote links to that resource be removed. Such an event is common for + limited-time, promotional services and for resources belonging to + individuals no longer working at the server's site. It is not + necessary to mark all permanently unavailable resources as "gone" or + to keep the mark for any length of time -- that is left to the + discretion of the server owner. + +10.4.12 411 Length Required + + The server refuses to accept the request without a defined Content- + Length. The client MAY repeat the request if it adds a valid + Content-Length header field containing the length of the message-body + in the request message. + +10.4.13 412 Precondition Failed + + The precondition given in one or more of the request-header fields + evaluated to false when it was tested on the server. This response + code allows the client to place preconditions on the current resource + metainformation (header field data) and thus prevent the requested + method from being applied to a resource other than the one intended. + + + +Fielding, et al. Standards Track [Page 68] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.14 413 Request Entity Too Large + + The server is refusing to process a request because the request + entity is larger than the server is willing or able to process. The + server MAY close the connection to prevent the client from continuing + the request. + + If the condition is temporary, the server SHOULD include a Retry- + After header field to indicate that it is temporary and after what + time the client MAY try again. + +10.4.15 414 Request-URI Too Long + + The server is refusing to service the request because the Request-URI + is longer than the server is willing to interpret. This rare + condition is only likely to occur when a client has improperly + converted a POST request to a GET request with long query + information, when the client has descended into a URI "black hole" of + redirection (e.g., a redirected URI prefix that points to a suffix of + itself), or when the server is under attack by a client attempting to + exploit security holes present in some servers using fixed-length + buffers for reading or manipulating the Request-URI. + +10.4.16 415 Unsupported Media Type + + The server is refusing to service the request because the entity of + the request is in a format not supported by the requested resource + for the requested method. + +10.4.17 416 Requested Range Not Satisfiable + + A server SHOULD return a response with this status code if a request + included a Range request-header field (section 14.35), and none of + the range-specifier values in this field overlap the current extent + of the selected resource, and the request did not include an If-Range + request-header field. (For byte-ranges, this means that the first- + byte-pos of all of the byte-range-spec values were greater than the + current length of the selected resource.) + + When this status code is returned for a byte-range request, the + response SHOULD include a Content-Range entity-header field + specifying the current length of the selected resource (see section + 14.16). This response MUST NOT use the multipart/byteranges content- + type. + + + + + + + +Fielding, et al. Standards Track [Page 69] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.18 417 Expectation Failed + + The expectation given in an Expect request-header field (see section + 14.20) could not be met by this server, or, if the server is a proxy, + the server has unambiguous evidence that the request could not be met + by the next-hop server. + +10.5 Server Error 5xx + + Response status codes beginning with the digit "5" indicate cases in + which the server is aware that it has erred or is incapable of + performing the request. Except when responding to a HEAD request, the + server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. User agents SHOULD display any included entity to the + user. These response codes are applicable to any request method. + +10.5.1 500 Internal Server Error + + The server encountered an unexpected condition which prevented it + from fulfilling the request. + +10.5.2 501 Not Implemented + + The server does not support the functionality required to fulfill the + request. This is the appropriate response when the server does not + recognize the request method and is not capable of supporting it for + any resource. + +10.5.3 502 Bad Gateway + + The server, while acting as a gateway or proxy, received an invalid + response from the upstream server it accessed in attempting to + fulfill the request. + +10.5.4 503 Service Unavailable + + The server is currently unable to handle the request due to a + temporary overloading or maintenance of the server. The implication + is that this is a temporary condition which will be alleviated after + some delay. If known, the length of the delay MAY be indicated in a + Retry-After header. If no Retry-After is given, the client SHOULD + handle the response as it would for a 500 response. + + Note: The existence of the 503 status code does not imply that a + server must use it when becoming overloaded. Some servers may wish + to simply refuse the connection. + + + + +Fielding, et al. Standards Track [Page 70] + +RFC 2616 HTTP/1.1 June 1999 + + +10.5.5 504 Gateway Timeout + + The server, while acting as a gateway or proxy, did not receive a + timely response from the upstream server specified by the URI (e.g. + HTTP, FTP, LDAP) or some other auxiliary server (e.g. DNS) it needed + to access in attempting to complete the request. + + Note: Note to implementors: some deployed proxies are known to + return 400 or 500 when DNS lookups time out. + +10.5.6 505 HTTP Version Not Supported + + The server does not support, or refuses to support, the HTTP protocol + version that was used in the request message. The server is + indicating that it is unable or unwilling to complete the request + using the same major version as the client, as described in section + 3.1, other than with this error message. The response SHOULD contain + an entity describing why that version is not supported and what other + protocols are supported by that server. + +11 Access Authentication + + HTTP provides several OPTIONAL challenge-response authentication + mechanisms which can be used by a server to challenge a client + request and by a client to provide authentication information. The + general framework for access authentication, and the specification of + "basic" and "digest" authentication, are specified in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. This + specification adopts the definitions of "challenge" and "credentials" + from that specification. + +12 Content Negotiation + + Most HTTP responses include an entity which contains information for + interpretation by a human user. Naturally, it is desirable to supply + the user with the "best available" entity corresponding to the + request. Unfortunately for servers and caches, not all users have the + same preferences for what is "best," and not all user agents are + equally capable of rendering all entity types. For that reason, HTTP + has provisions for several mechanisms for "content negotiation" -- + the process of selecting the best representation for a given response + when there are multiple representations available. + + Note: This is not called "format negotiation" because the + alternate representations may be of the same media type, but use + different capabilities of that type, be in different languages, + etc. + + + + +Fielding, et al. Standards Track [Page 71] + +RFC 2616 HTTP/1.1 June 1999 + + + Any response containing an entity-body MAY be subject to negotiation, + including error responses. + + There are two kinds of content negotiation which are possible in + HTTP: server-driven and agent-driven negotiation. These two kinds of + negotiation are orthogonal and thus may be used separately or in + combination. One method of combination, referred to as transparent + negotiation, occurs when a cache uses the agent-driven negotiation + information provided by the origin server in order to provide + server-driven negotiation for subsequent requests. + +12.1 Server-driven Negotiation + + If the selection of the best representation for a response is made by + an algorithm located at the server, it is called server-driven + negotiation. Selection is based on the available representations of + the response (the dimensions over which it can vary; e.g. language, + content-coding, etc.) and the contents of particular header fields in + the request message or on other information pertaining to the request + (such as the network address of the client). + + Server-driven negotiation is advantageous when the algorithm for + selecting from among the available representations is difficult to + describe to the user agent, or when the server desires to send its + "best guess" to the client along with the first response (hoping to + avoid the round-trip delay of a subsequent request if the "best + guess" is good enough for the user). In order to improve the server's + guess, the user agent MAY include request header fields (Accept, + Accept-Language, Accept-Encoding, etc.) which describe its + preferences for such a response. + + Server-driven negotiation has disadvantages: + + 1. It is impossible for the server to accurately determine what + might be "best" for any given user, since that would require + complete knowledge of both the capabilities of the user agent + and the intended use for the response (e.g., does the user want + to view it on screen or print it on paper?). + + 2. Having the user agent describe its capabilities in every + request can be both very inefficient (given that only a small + percentage of responses have multiple representations) and a + potential violation of the user's privacy. + + 3. It complicates the implementation of an origin server and the + algorithms for generating responses to a request. + + + + + +Fielding, et al. Standards Track [Page 72] + +RFC 2616 HTTP/1.1 June 1999 + + + 4. It may limit a public cache's ability to use the same response + for multiple user's requests. + + HTTP/1.1 includes the following request-header fields for enabling + server-driven negotiation through description of user agent + capabilities and user preferences: Accept (section 14.1), Accept- + Charset (section 14.2), Accept-Encoding (section 14.3), Accept- + Language (section 14.4), and User-Agent (section 14.43). However, an + origin server is not limited to these dimensions and MAY vary the + response based on any aspect of the request, including information + outside the request-header fields or within extension header fields + not defined by this specification. + + The Vary header field can be used to express the parameters the + server uses to select a representation that is subject to server- + driven negotiation. See section 13.6 for use of the Vary header field + by caches and section 14.44 for use of the Vary header field by + servers. + +12.2 Agent-driven Negotiation + + With agent-driven negotiation, selection of the best representation + for a response is performed by the user agent after receiving an + initial response from the origin server. Selection is based on a list + of the available representations of the response included within the + header fields or entity-body of the initial response, with each + representation identified by its own URI. Selection from among the + representations may be performed automatically (if the user agent is + capable of doing so) or manually by the user selecting from a + generated (possibly hypertext) menu. + + Agent-driven negotiation is advantageous when the response would vary + over commonly-used dimensions (such as type, language, or encoding), + when the origin server is unable to determine a user agent's + capabilities from examining the request, and generally when public + caches are used to distribute server load and reduce network usage. + + Agent-driven negotiation suffers from the disadvantage of needing a + second request to obtain the best alternate representation. This + second request is only efficient when caching is used. In addition, + this specification does not define any mechanism for supporting + automatic selection, though it also does not prevent any such + mechanism from being developed as an extension and used within + HTTP/1.1. + + + + + + + +Fielding, et al. Standards Track [Page 73] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 defines the 300 (Multiple Choices) and 406 (Not Acceptable) + status codes for enabling agent-driven negotiation when the server is + unwilling or unable to provide a varying response using server-driven + negotiation. + +12.3 Transparent Negotiation + + Transparent negotiation is a combination of both server-driven and + agent-driven negotiation. When a cache is supplied with a form of the + list of available representations of the response (as in agent-driven + negotiation) and the dimensions of variance are completely understood + by the cache, then the cache becomes capable of performing server- + driven negotiation on behalf of the origin server for subsequent + requests on that resource. + + Transparent negotiation has the advantage of distributing the + negotiation work that would otherwise be required of the origin + server and also removing the second request delay of agent-driven + negotiation when the cache is able to correctly guess the right + response. + + This specification does not define any mechanism for transparent + negotiation, though it also does not prevent any such mechanism from + being developed as an extension that could be used within HTTP/1.1. + +13 Caching in HTTP + + HTTP is typically used for distributed information systems, where + performance can be improved by the use of response caches. The + HTTP/1.1 protocol includes a number of elements intended to make + caching work as well as possible. Because these elements are + inextricable from other aspects of the protocol, and because they + interact with each other, it is useful to describe the basic caching + design of HTTP separately from the detailed descriptions of methods, + headers, response codes, etc. + + Caching would be useless if it did not significantly improve + performance. The goal of caching in HTTP/1.1 is to eliminate the need + to send requests in many cases, and to eliminate the need to send + full responses in many other cases. The former reduces the number of + network round-trips required for many operations; we use an + "expiration" mechanism for this purpose (see section 13.2). The + latter reduces network bandwidth requirements; we use a "validation" + mechanism for this purpose (see section 13.3). + + Requirements for performance, availability, and disconnected + operation require us to be able to relax the goal of semantic + transparency. The HTTP/1.1 protocol allows origin servers, caches, + + + +Fielding, et al. Standards Track [Page 74] + +RFC 2616 HTTP/1.1 June 1999 + + + and clients to explicitly reduce transparency when necessary. + However, because non-transparent operation may confuse non-expert + users, and might be incompatible with certain server applications + (such as those for ordering merchandise), the protocol requires that + transparency be relaxed + + - only by an explicit protocol-level request when relaxed by + client or origin server + + - only with an explicit warning to the end user when relaxed by + cache or client + + Therefore, the HTTP/1.1 protocol provides these important elements: + + 1. Protocol features that provide full semantic transparency when + this is required by all parties. + + 2. Protocol features that allow an origin server or user agent to + explicitly request and control non-transparent operation. + + 3. Protocol features that allow a cache to attach warnings to + responses that do not preserve the requested approximation of + semantic transparency. + + A basic principle is that it must be possible for the clients to + detect any potential relaxation of semantic transparency. + + Note: The server, cache, or client implementor might be faced with + design decisions not explicitly discussed in this specification. + If a decision might affect semantic transparency, the implementor + ought to err on the side of maintaining transparency unless a + careful and complete analysis shows significant benefits in + breaking transparency. + +13.1.1 Cache Correctness + + A correct cache MUST respond to a request with the most up-to-date + response held by the cache that is appropriate to the request (see + sections 13.2.5, 13.2.6, and 13.12) which meets one of the following + conditions: + + 1. It has been checked for equivalence with what the origin server + would have returned by revalidating the response with the + origin server (section 13.3); + + + + + + + +Fielding, et al. Standards Track [Page 75] + +RFC 2616 HTTP/1.1 June 1999 + + + 2. It is "fresh enough" (see section 13.2). In the default case, + this means it meets the least restrictive freshness requirement + of the client, origin server, and cache (see section 14.9); if + the origin server so specifies, it is the freshness requirement + of the origin server alone. + + If a stored response is not "fresh enough" by the most + restrictive freshness requirement of both the client and the + origin server, in carefully considered circumstances the cache + MAY still return the response with the appropriate Warning + header (see section 13.1.5 and 14.46), unless such a response + is prohibited (e.g., by a "no-store" cache-directive, or by a + "no-cache" cache-request-directive; see section 14.9). + + 3. It is an appropriate 304 (Not Modified), 305 (Proxy Redirect), + or error (4xx or 5xx) response message. + + If the cache can not communicate with the origin server, then a + correct cache SHOULD respond as above if the response can be + correctly served from the cache; if not it MUST return an error or + warning indicating that there was a communication failure. + + If a cache receives a response (either an entire response, or a 304 + (Not Modified) response) that it would normally forward to the + requesting client, and the received response is no longer fresh, the + cache SHOULD forward it to the requesting client without adding a new + Warning (but without removing any existing Warning headers). A cache + SHOULD NOT attempt to revalidate a response simply because that + response became stale in transit; this might lead to an infinite + loop. A user agent that receives a stale response without a Warning + MAY display a warning indication to the user. + +13.1.2 Warnings + + Whenever a cache returns a response that is neither first-hand nor + "fresh enough" (in the sense of condition 2 in section 13.1.1), it + MUST attach a warning to that effect, using a Warning general-header. + The Warning header and the currently defined warnings are described + in section 14.46. The warning allows clients to take appropriate + action. + + Warnings MAY be used for other purposes, both cache-related and + otherwise. The use of a warning, rather than an error status code, + distinguish these responses from true failures. + + Warnings are assigned three digit warn-codes. The first digit + indicates whether the Warning MUST or MUST NOT be deleted from a + stored cache entry after a successful revalidation: + + + +Fielding, et al. Standards Track [Page 76] + +RFC 2616 HTTP/1.1 June 1999 + + + 1xx Warnings that describe the freshness or revalidation status of + the response, and so MUST be deleted after a successful + revalidation. 1XX warn-codes MAY be generated by a cache only when + validating a cached entry. It MUST NOT be generated by clients. + + 2xx Warnings that describe some aspect of the entity body or entity + headers that is not rectified by a revalidation (for example, a + lossy compression of the entity bodies) and which MUST NOT be + deleted after a successful revalidation. + + See section 14.46 for the definitions of the codes themselves. + + HTTP/1.0 caches will cache all Warnings in responses, without + deleting the ones in the first category. Warnings in responses that + are passed to HTTP/1.0 caches carry an extra warning-date field, + which prevents a future HTTP/1.1 recipient from believing an + erroneously cached Warning. + + Warnings also carry a warning text. The text MAY be in any + appropriate natural language (perhaps based on the client's Accept + headers), and include an OPTIONAL indication of what character set is + used. + + Multiple warnings MAY be attached to a response (either by the origin + server or by a cache), including multiple warnings with the same code + number. For example, a server might provide the same warning with + texts in both English and Basque. + + When multiple warnings are attached to a response, it might not be + practical or reasonable to display all of them to the user. This + version of HTTP does not specify strict priority rules for deciding + which warnings to display and in what order, but does suggest some + heuristics. + +13.1.3 Cache-control Mechanisms + + The basic cache mechanisms in HTTP/1.1 (server-specified expiration + times and validators) are implicit directives to caches. In some + cases, a server or client might need to provide explicit directives + to the HTTP caches. We use the Cache-Control header for this purpose. + + The Cache-Control header allows a client or server to transmit a + variety of directives in either requests or responses. These + directives typically override the default caching algorithms. As a + general rule, if there is any apparent conflict between header + values, the most restrictive interpretation is applied (that is, the + one that is most likely to preserve semantic transparency). However, + + + + +Fielding, et al. Standards Track [Page 77] + +RFC 2616 HTTP/1.1 June 1999 + + + in some cases, cache-control directives are explicitly specified as + weakening the approximation of semantic transparency (for example, + "max-stale" or "public"). + + The cache-control directives are described in detail in section 14.9. + +13.1.4 Explicit User Agent Warnings + + Many user agents make it possible for users to override the basic + caching mechanisms. For example, the user agent might allow the user + to specify that cached entities (even explicitly stale ones) are + never validated. Or the user agent might habitually add "Cache- + Control: max-stale=3600" to every request. The user agent SHOULD NOT + default to either non-transparent behavior, or behavior that results + in abnormally ineffective caching, but MAY be explicitly configured + to do so by an explicit action of the user. + + If the user has overridden the basic caching mechanisms, the user + agent SHOULD explicitly indicate to the user whenever this results in + the display of information that might not meet the server's + transparency requirements (in particular, if the displayed entity is + known to be stale). Since the protocol normally allows the user agent + to determine if responses are stale or not, this indication need only + be displayed when this actually happens. The indication need not be a + dialog box; it could be an icon (for example, a picture of a rotting + fish) or some other indicator. + + If the user has overridden the caching mechanisms in a way that would + abnormally reduce the effectiveness of caches, the user agent SHOULD + continually indicate this state to the user (for example, by a + display of a picture of currency in flames) so that the user does not + inadvertently consume excess resources or suffer from excessive + latency. + +13.1.5 Exceptions to the Rules and Warnings + + In some cases, the operator of a cache MAY choose to configure it to + return stale responses even when not requested by clients. This + decision ought not be made lightly, but may be necessary for reasons + of availability or performance, especially when the cache is poorly + connected to the origin server. Whenever a cache returns a stale + response, it MUST mark it as such (using a Warning header) enabling + the client software to alert the user that there might be a potential + problem. + + + + + + + +Fielding, et al. Standards Track [Page 78] + +RFC 2616 HTTP/1.1 June 1999 + + + It also allows the user agent to take steps to obtain a first-hand or + fresh response. For this reason, a cache SHOULD NOT return a stale + response if the client explicitly requests a first-hand or fresh one, + unless it is impossible to comply for technical or policy reasons. + +13.1.6 Client-controlled Behavior + + While the origin server (and to a lesser extent, intermediate caches, + by their contribution to the age of a response) are the primary + source of expiration information, in some cases the client might need + to control a cache's decision about whether to return a cached + response without validating it. Clients do this using several + directives of the Cache-Control header. + + A client's request MAY specify the maximum age it is willing to + accept of an unvalidated response; specifying a value of zero forces + the cache(s) to revalidate all responses. A client MAY also specify + the minimum time remaining before a response expires. Both of these + options increase constraints on the behavior of caches, and so cannot + further relax the cache's approximation of semantic transparency. + + A client MAY also specify that it will accept stale responses, up to + some maximum amount of staleness. This loosens the constraints on the + caches, and so might violate the origin server's specified + constraints on semantic transparency, but might be necessary to + support disconnected operation, or high availability in the face of + poor connectivity. + +13.2 Expiration Model + +13.2.1 Server-Specified Expiration + + HTTP caching works best when caches can entirely avoid making + requests to the origin server. The primary mechanism for avoiding + requests is for an origin server to provide an explicit expiration + time in the future, indicating that a response MAY be used to satisfy + subsequent requests. In other words, a cache can return a fresh + response without first contacting the server. + + Our expectation is that servers will assign future explicit + expiration times to responses in the belief that the entity is not + likely to change, in a semantically significant way, before the + expiration time is reached. This normally preserves semantic + transparency, as long as the server's expiration times are carefully + chosen. + + + + + + +Fielding, et al. Standards Track [Page 79] + +RFC 2616 HTTP/1.1 June 1999 + + + The expiration mechanism applies only to responses taken from a cache + and not to first-hand responses forwarded immediately to the + requesting client. + + If an origin server wishes to force a semantically transparent cache + to validate every request, it MAY assign an explicit expiration time + in the past. This means that the response is always stale, and so the + cache SHOULD validate it before using it for subsequent requests. See + section 14.9.4 for a more restrictive way to force revalidation. + + If an origin server wishes to force any HTTP/1.1 cache, no matter how + it is configured, to validate every request, it SHOULD use the "must- + revalidate" cache-control directive (see section 14.9). + + Servers specify explicit expiration times using either the Expires + header, or the max-age directive of the Cache-Control header. + + An expiration time cannot be used to force a user agent to refresh + its display or reload a resource; its semantics apply only to caching + mechanisms, and such mechanisms need only check a resource's + expiration status when a new request for that resource is initiated. + See section 13.13 for an explanation of the difference between caches + and history mechanisms. + +13.2.2 Heuristic Expiration + + Since origin servers do not always provide explicit expiration times, + HTTP caches typically assign heuristic expiration times, employing + algorithms that use other header values (such as the Last-Modified + time) to estimate a plausible expiration time. The HTTP/1.1 + specification does not provide specific algorithms, but does impose + worst-case constraints on their results. Since heuristic expiration + times might compromise semantic transparency, they ought to used + cautiously, and we encourage origin servers to provide explicit + expiration times as much as possible. + +13.2.3 Age Calculations + + In order to know if a cached entry is fresh, a cache needs to know if + its age exceeds its freshness lifetime. We discuss how to calculate + the latter in section 13.2.4; this section describes how to calculate + the age of a response or cache entry. + + In this discussion, we use the term "now" to mean "the current value + of the clock at the host performing the calculation." Hosts that use + HTTP, but especially hosts running origin servers and caches, SHOULD + use NTP [28] or some similar protocol to synchronize their clocks to + a globally accurate time standard. + + + +Fielding, et al. Standards Track [Page 80] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 requires origin servers to send a Date header, if possible, + with every response, giving the time at which the response was + generated (see section 14.18). We use the term "date_value" to denote + the value of the Date header, in a form appropriate for arithmetic + operations. + + HTTP/1.1 uses the Age response-header to convey the estimated age of + the response message when obtained from a cache. The Age field value + is the cache's estimate of the amount of time since the response was + generated or revalidated by the origin server. + + In essence, the Age value is the sum of the time that the response + has been resident in each of the caches along the path from the + origin server, plus the amount of time it has been in transit along + network paths. + + We use the term "age_value" to denote the value of the Age header, in + a form appropriate for arithmetic operations. + + A response's age can be calculated in two entirely independent ways: + + 1. now minus date_value, if the local clock is reasonably well + synchronized to the origin server's clock. If the result is + negative, the result is replaced by zero. + + 2. age_value, if all of the caches along the response path + implement HTTP/1.1. + + Given that we have two independent ways to compute the age of a + response when it is received, we can combine these as + + corrected_received_age = max(now - date_value, age_value) + + and as long as we have either nearly synchronized clocks or all- + HTTP/1.1 paths, one gets a reliable (conservative) result. + + Because of network-imposed delays, some significant interval might + pass between the time that a server generates a response and the time + it is received at the next outbound cache or client. If uncorrected, + this delay could result in improperly low ages. + + Because the request that resulted in the returned Age value must have + been initiated prior to that Age value's generation, we can correct + for delays imposed by the network by recording the time at which the + request was initiated. Then, when an Age value is received, it MUST + be interpreted relative to the time the request was initiated, not + + + + + +Fielding, et al. Standards Track [Page 81] + +RFC 2616 HTTP/1.1 June 1999 + + + the time that the response was received. This algorithm results in + conservative behavior no matter how much delay is experienced. So, we + compute: + + corrected_initial_age = corrected_received_age + + (now - request_time) + + where "request_time" is the time (according to the local clock) when + the request that elicited this response was sent. + + Summary of age calculation algorithm, when a cache receives a + response: + + /* + * age_value + * is the value of Age: header received by the cache with + * this response. + * date_value + * is the value of the origin server's Date: header + * request_time + * is the (local) time when the cache made the request + * that resulted in this cached response + * response_time + * is the (local) time when the cache received the + * response + * now + * is the current (local) time + */ + + apparent_age = max(0, response_time - date_value); + corrected_received_age = max(apparent_age, age_value); + response_delay = response_time - request_time; + corrected_initial_age = corrected_received_age + response_delay; + resident_time = now - response_time; + current_age = corrected_initial_age + resident_time; + + The current_age of a cache entry is calculated by adding the amount + of time (in seconds) since the cache entry was last validated by the + origin server to the corrected_initial_age. When a response is + generated from a cache entry, the cache MUST include a single Age + header field in the response with a value equal to the cache entry's + current_age. + + The presence of an Age header field in a response implies that a + response is not first-hand. However, the converse is not true, since + the lack of an Age header field in a response does not imply that the + + + + + +Fielding, et al. Standards Track [Page 82] + +RFC 2616 HTTP/1.1 June 1999 + + + response is first-hand unless all caches along the request path are + compliant with HTTP/1.1 (i.e., older HTTP caches did not implement + the Age header field). + +13.2.4 Expiration Calculations + + In order to decide whether a response is fresh or stale, we need to + compare its freshness lifetime to its age. The age is calculated as + described in section 13.2.3; this section describes how to calculate + the freshness lifetime, and to determine if a response has expired. + In the discussion below, the values can be represented in any form + appropriate for arithmetic operations. + + We use the term "expires_value" to denote the value of the Expires + header. We use the term "max_age_value" to denote an appropriate + value of the number of seconds carried by the "max-age" directive of + the Cache-Control header in a response (see section 14.9.3). + + The max-age directive takes priority over Expires, so if max-age is + present in a response, the calculation is simply: + + freshness_lifetime = max_age_value + + Otherwise, if Expires is present in the response, the calculation is: + + freshness_lifetime = expires_value - date_value + + Note that neither of these calculations is vulnerable to clock skew, + since all of the information comes from the origin server. + + If none of Expires, Cache-Control: max-age, or Cache-Control: s- + maxage (see section 14.9.3) appears in the response, and the response + does not include other restrictions on caching, the cache MAY compute + a freshness lifetime using a heuristic. The cache MUST attach Warning + 113 to any response whose age is more than 24 hours if such warning + has not already been added. + + Also, if the response does have a Last-Modified time, the heuristic + expiration value SHOULD be no more than some fraction of the interval + since that time. A typical setting of this fraction might be 10%. + + The calculation to determine if a response has expired is quite + simple: + + response_is_fresh = (freshness_lifetime > current_age) + + + + + + +Fielding, et al. Standards Track [Page 83] + +RFC 2616 HTTP/1.1 June 1999 + + +13.2.5 Disambiguating Expiration Values + + Because expiration values are assigned optimistically, it is possible + for two caches to contain fresh values for the same resource that are + different. + + If a client performing a retrieval receives a non-first-hand response + for a request that was already fresh in its own cache, and the Date + header in its existing cache entry is newer than the Date on the new + response, then the client MAY ignore the response. If so, it MAY + retry the request with a "Cache-Control: max-age=0" directive (see + section 14.9), to force a check with the origin server. + + If a cache has two fresh responses for the same representation with + different validators, it MUST use the one with the more recent Date + header. This situation might arise because the cache is pooling + responses from other caches, or because a client has asked for a + reload or a revalidation of an apparently fresh cache entry. + +13.2.6 Disambiguating Multiple Responses + + Because a client might be receiving responses via multiple paths, so + that some responses flow through one set of caches and other + responses flow through a different set of caches, a client might + receive responses in an order different from that in which the origin + server sent them. We would like the client to use the most recently + generated response, even if older responses are still apparently + fresh. + + Neither the entity tag nor the expiration value can impose an + ordering on responses, since it is possible that a later response + intentionally carries an earlier expiration time. The Date values are + ordered to a granularity of one second. + + When a client tries to revalidate a cache entry, and the response it + receives contains a Date header that appears to be older than the one + for the existing entry, then the client SHOULD repeat the request + unconditionally, and include + + Cache-Control: max-age=0 + + to force any intermediate caches to validate their copies directly + with the origin server, or + + Cache-Control: no-cache + + to force any intermediate caches to obtain a new copy from the origin + server. + + + +Fielding, et al. Standards Track [Page 84] + +RFC 2616 HTTP/1.1 June 1999 + + + If the Date values are equal, then the client MAY use either response + (or MAY, if it is being extremely prudent, request a new response). + Servers MUST NOT depend on clients being able to choose + deterministically between responses generated during the same second, + if their expiration times overlap. + +13.3 Validation Model + + When a cache has a stale entry that it would like to use as a + response to a client's request, it first has to check with the origin + server (or possibly an intermediate cache with a fresh response) to + see if its cached entry is still usable. We call this "validating" + the cache entry. Since we do not want to have to pay the overhead of + retransmitting the full response if the cached entry is good, and we + do not want to pay the overhead of an extra round trip if the cached + entry is invalid, the HTTP/1.1 protocol supports the use of + conditional methods. + + The key protocol features for supporting conditional methods are + those concerned with "cache validators." When an origin server + generates a full response, it attaches some sort of validator to it, + which is kept with the cache entry. When a client (user agent or + proxy cache) makes a conditional request for a resource for which it + has a cache entry, it includes the associated validator in the + request. + + The server then checks that validator against the current validator + for the entity, and, if they match (see section 13.3.3), it responds + with a special status code (usually, 304 (Not Modified)) and no + entity-body. Otherwise, it returns a full response (including + entity-body). Thus, we avoid transmitting the full response if the + validator matches, and we avoid an extra round trip if it does not + match. + + In HTTP/1.1, a conditional request looks exactly the same as a normal + request for the same resource, except that it carries a special + header (which includes the validator) that implicitly turns the + method (usually, GET) into a conditional. + + The protocol includes both positive and negative senses of cache- + validating conditions. That is, it is possible to request either that + a method be performed if and only if a validator matches or if and + only if no validators match. + + + + + + + + +Fielding, et al. Standards Track [Page 85] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: a response that lacks a validator may still be cached, and + served from cache until it expires, unless this is explicitly + prohibited by a cache-control directive. However, a cache cannot + do a conditional retrieval if it does not have a validator for the + entity, which means it will not be refreshable after it expires. + +13.3.1 Last-Modified Dates + + The Last-Modified entity-header field value is often used as a cache + validator. In simple terms, a cache entry is considered to be valid + if the entity has not been modified since the Last-Modified value. + +13.3.2 Entity Tag Cache Validators + + The ETag response-header field value, an entity tag, provides for an + "opaque" cache validator. This might allow more reliable validation + in situations where it is inconvenient to store modification dates, + where the one-second resolution of HTTP date values is not + sufficient, or where the origin server wishes to avoid certain + paradoxes that might arise from the use of modification dates. + + Entity Tags are described in section 3.11. The headers used with + entity tags are described in sections 14.19, 14.24, 14.26 and 14.44. + +13.3.3 Weak and Strong Validators + + Since both origin servers and caches will compare two validators to + decide if they represent the same or different entities, one normally + would expect that if the entity (the entity-body or any entity- + headers) changes in any way, then the associated validator would + change as well. If this is true, then we call this validator a + "strong validator." + + However, there might be cases when a server prefers to change the + validator only on semantically significant changes, and not when + insignificant aspects of the entity change. A validator that does not + always change when the resource changes is a "weak validator." + + Entity tags are normally "strong validators," but the protocol + provides a mechanism to tag an entity tag as "weak." One can think of + a strong validator as one that changes whenever the bits of an entity + changes, while a weak value changes whenever the meaning of an entity + changes. Alternatively, one can think of a strong validator as part + of an identifier for a specific entity, while a weak validator is + part of an identifier for a set of semantically equivalent entities. + + Note: One example of a strong validator is an integer that is + incremented in stable storage every time an entity is changed. + + + +Fielding, et al. Standards Track [Page 86] + +RFC 2616 HTTP/1.1 June 1999 + + + An entity's modification time, if represented with one-second + resolution, could be a weak validator, since it is possible that + the resource might be modified twice during a single second. + + Support for weak validators is optional. However, weak validators + allow for more efficient caching of equivalent objects; for + example, a hit counter on a site is probably good enough if it is + updated every few days or weeks, and any value during that period + is likely "good enough" to be equivalent. + + A "use" of a validator is either when a client generates a request + and includes the validator in a validating header field, or when a + server compares two validators. + + Strong validators are usable in any context. Weak validators are only + usable in contexts that do not depend on exact equality of an entity. + For example, either kind is usable for a conditional GET of a full + entity. However, only a strong validator is usable for a sub-range + retrieval, since otherwise the client might end up with an internally + inconsistent entity. + + Clients MAY issue simple (non-subrange) GET requests with either weak + validators or strong validators. Clients MUST NOT use weak validators + in other forms of request. + + The only function that the HTTP/1.1 protocol defines on validators is + comparison. There are two validator comparison functions, depending + on whether the comparison context allows the use of weak validators + or not: + + - The strong comparison function: in order to be considered equal, + both validators MUST be identical in every way, and both MUST + NOT be weak. + + - The weak comparison function: in order to be considered equal, + both validators MUST be identical in every way, but either or + both of them MAY be tagged as "weak" without affecting the + result. + + An entity tag is strong unless it is explicitly tagged as weak. + Section 3.11 gives the syntax for entity tags. + + A Last-Modified time, when used as a validator in a request, is + implicitly weak unless it is possible to deduce that it is strong, + using the following rules: + + - The validator is being compared by an origin server to the + actual current validator for the entity and, + + + +Fielding, et al. Standards Track [Page 87] + +RFC 2616 HTTP/1.1 June 1999 + + + - That origin server reliably knows that the associated entity did + not change twice during the second covered by the presented + validator. + + or + + - The validator is about to be used by a client in an If- + Modified-Since or If-Unmodified-Since header, because the client + has a cache entry for the associated entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + or + + - The validator is being compared by an intermediate cache to the + validator stored in its cache entry for the entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + This method relies on the fact that if two different responses were + sent by the origin server during the same second, but both had the + same Last-Modified time, then at least one of those responses would + have a Date value equal to its Last-Modified time. The arbitrary 60- + second limit guards against the possibility that the Date and Last- + Modified values are generated from different clocks, or at somewhat + different times during the preparation of the response. An + implementation MAY use a value larger than 60 seconds, if it is + believed that 60 seconds is too short. + + If a client wishes to perform a sub-range retrieval on a value for + which it has only a Last-Modified time and no opaque validator, it + MAY do this only if the Last-Modified time is strong in the sense + described here. + + A cache or origin server receiving a conditional request, other than + a full-body GET request, MUST use the strong comparison function to + evaluate the condition. + + These rules allow HTTP/1.1 caches and clients to safely perform sub- + range retrievals on values that have been obtained from HTTP/1.0 + + + +Fielding, et al. Standards Track [Page 88] + +RFC 2616 HTTP/1.1 June 1999 + + + servers. + +13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates + + We adopt a set of rules and recommendations for origin servers, + clients, and caches regarding when various validator types ought to + be used, and for what purposes. + + HTTP/1.1 origin servers: + + - SHOULD send an entity tag validator unless it is not feasible to + generate one. + + - MAY send a weak entity tag instead of a strong entity tag, if + performance considerations support the use of weak entity tags, + or if it is unfeasible to send a strong entity tag. + + - SHOULD send a Last-Modified value if it is feasible to send one, + unless the risk of a breakdown in semantic transparency that + could result from using this date in an If-Modified-Since header + would lead to serious problems. + + In other words, the preferred behavior for an HTTP/1.1 origin server + is to send both a strong entity tag and a Last-Modified value. + + In order to be legal, a strong entity tag MUST change whenever the + associated entity value changes in any way. A weak entity tag SHOULD + change whenever the associated entity changes in a semantically + significant way. + + Note: in order to provide semantically transparent caching, an + origin server must avoid reusing a specific strong entity tag + value for two different entities, or reusing a specific weak + entity tag value for two semantically different entities. Cache + entries might persist for arbitrarily long periods, regardless of + expiration times, so it might be inappropriate to expect that a + cache will never again attempt to validate an entry using a + validator that it obtained at some point in the past. + + HTTP/1.1 clients: + + - If an entity tag has been provided by the origin server, MUST + use that entity tag in any cache-conditional request (using If- + Match or If-None-Match). + + - If only a Last-Modified value has been provided by the origin + server, SHOULD use that value in non-subrange cache-conditional + requests (using If-Modified-Since). + + + +Fielding, et al. Standards Track [Page 89] + +RFC 2616 HTTP/1.1 June 1999 + + + - If only a Last-Modified value has been provided by an HTTP/1.0 + origin server, MAY use that value in subrange cache-conditional + requests (using If-Unmodified-Since:). The user agent SHOULD + provide a way to disable this, in case of difficulty. + + - If both an entity tag and a Last-Modified value have been + provided by the origin server, SHOULD use both validators in + cache-conditional requests. This allows both HTTP/1.0 and + HTTP/1.1 caches to respond appropriately. + + An HTTP/1.1 origin server, upon receiving a conditional request that + includes both a Last-Modified date (e.g., in an If-Modified-Since or + If-Unmodified-Since header field) and one or more entity tags (e.g., + in an If-Match, If-None-Match, or If-Range header field) as cache + validators, MUST NOT return a response status of 304 (Not Modified) + unless doing so is consistent with all of the conditional header + fields in the request. + + An HTTP/1.1 caching proxy, upon receiving a conditional request that + includes both a Last-Modified date and one or more entity tags as + cache validators, MUST NOT return a locally cached response to the + client unless that cached response is consistent with all of the + conditional header fields in the request. + + Note: The general principle behind these rules is that HTTP/1.1 + servers and clients should transmit as much non-redundant + information as is available in their responses and requests. + HTTP/1.1 systems receiving this information will make the most + conservative assumptions about the validators they receive. + + HTTP/1.0 clients and caches will ignore entity tags. Generally, + last-modified values received or used by these systems will + support transparent and efficient caching, and so HTTP/1.1 origin + servers should provide Last-Modified values. In those rare cases + where the use of a Last-Modified value as a validator by an + HTTP/1.0 system could result in a serious problem, then HTTP/1.1 + origin servers should not provide one. + +13.3.5 Non-validating Conditionals + + The principle behind entity tags is that only the service author + knows the semantics of a resource well enough to select an + appropriate cache validation mechanism, and the specification of any + validator comparison function more complex than byte-equality would + open up a can of worms. Thus, comparisons of any other headers + (except Last-Modified, for compatibility with HTTP/1.0) are never + used for purposes of validating a cache entry. + + + + +Fielding, et al. Standards Track [Page 90] + +RFC 2616 HTTP/1.1 June 1999 + + +13.4 Response Cacheability + + Unless specifically constrained by a cache-control (section 14.9) + directive, a caching system MAY always store a successful response + (see section 13.8) as a cache entry, MAY return it without validation + if it is fresh, and MAY return it after successful validation. If + there is neither a cache validator nor an explicit expiration time + associated with a response, we do not expect it to be cached, but + certain caches MAY violate this expectation (for example, when little + or no network connectivity is available). A client can usually detect + that such a response was taken from a cache by comparing the Date + header to the current time. + + Note: some HTTP/1.0 caches are known to violate this expectation + without providing any Warning. + + However, in some cases it might be inappropriate for a cache to + retain an entity, or to return it in response to a subsequent + request. This might be because absolute semantic transparency is + deemed necessary by the service author, or because of security or + privacy considerations. Certain cache-control directives are + therefore provided so that the server can indicate that certain + resource entities, or portions thereof, are not to be cached + regardless of other considerations. + + Note that section 14.8 normally prevents a shared cache from saving + and returning a response to a previous request if that request + included an Authorization header. + + A response received with a status code of 200, 203, 206, 300, 301 or + 410 MAY be stored by a cache and used in reply to a subsequent + request, subject to the expiration mechanism, unless a cache-control + directive prohibits caching. However, a cache that does not support + the Range and Content-Range headers MUST NOT cache 206 (Partial + Content) responses. + + A response received with any other status code (e.g. status codes 302 + and 307) MUST NOT be returned in a reply to a subsequent request + unless there are cache-control directives or another header(s) that + explicitly allow it. For example, these include the following: an + Expires header (section 14.21); a "max-age", "s-maxage", "must- + revalidate", "proxy-revalidate", "public" or "private" cache-control + directive (section 14.9). + + + + + + + + +Fielding, et al. Standards Track [Page 91] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5 Constructing Responses From Caches + + The purpose of an HTTP cache is to store information received in + response to requests for use in responding to future requests. In + many cases, a cache simply returns the appropriate parts of a + response to the requester. However, if the cache holds a cache entry + based on a previous response, it might have to combine parts of a new + response with what is held in the cache entry. + +13.5.1 End-to-end and Hop-by-hop Headers + + For the purpose of defining the behavior of caches and non-caching + proxies, we divide HTTP headers into two categories: + + - End-to-end headers, which are transmitted to the ultimate + recipient of a request or response. End-to-end headers in + responses MUST be stored as part of a cache entry and MUST be + transmitted in any response formed from a cache entry. + + - Hop-by-hop headers, which are meaningful only for a single + transport-level connection, and are not stored by caches or + forwarded by proxies. + + The following HTTP/1.1 headers are hop-by-hop headers: + + - Connection + - Keep-Alive + - Proxy-Authenticate + - Proxy-Authorization + - TE + - Trailers + - Transfer-Encoding + - Upgrade + + All other headers defined by HTTP/1.1 are end-to-end headers. + + Other hop-by-hop headers MUST be listed in a Connection header, + (section 14.10) to be introduced into HTTP/1.1 (or later). + +13.5.2 Non-modifiable Headers + + Some features of the HTTP/1.1 protocol, such as Digest + Authentication, depend on the value of certain end-to-end headers. A + transparent proxy SHOULD NOT modify an end-to-end header unless the + definition of that header requires or specifically allows that. + + + + + + +Fielding, et al. Standards Track [Page 92] + +RFC 2616 HTTP/1.1 June 1999 + + + A transparent proxy MUST NOT modify any of the following fields in a + request or response, and it MUST NOT add any of these fields if not + already present: + + - Content-Location + + - Content-MD5 + + - ETag + + - Last-Modified + + A transparent proxy MUST NOT modify any of the following fields in a + response: + + - Expires + + but it MAY add any of these fields if not already present. If an + Expires header is added, it MUST be given a field-value identical to + that of the Date header in that response. + + A proxy MUST NOT modify or add any of the following fields in a + message that contains the no-transform cache-control directive, or in + any request: + + - Content-Encoding + + - Content-Range + + - Content-Type + + A non-transparent proxy MAY modify or add these fields to a message + that does not include no-transform, but if it does so, it MUST add a + Warning 214 (Transformation applied) if one does not already appear + in the message (see section 14.46). + + Warning: unnecessary modification of end-to-end headers might + cause authentication failures if stronger authentication + mechanisms are introduced in later versions of HTTP. Such + authentication mechanisms MAY rely on the values of header fields + not listed here. + + The Content-Length field of a request or response is added or deleted + according to the rules in section 4.4. A transparent proxy MUST + preserve the entity-length (section 7.2.2) of the entity-body, + although it MAY change the transfer-length (section 4.4). + + + + + +Fielding, et al. Standards Track [Page 93] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.3 Combining Headers + + When a cache makes a validating request to a server, and the server + provides a 304 (Not Modified) response or a 206 (Partial Content) + response, the cache then constructs a response to send to the + requesting client. + + If the status code is 304 (Not Modified), the cache uses the entity- + body stored in the cache entry as the entity-body of this outgoing + response. If the status code is 206 (Partial Content) and the ETag or + Last-Modified headers match exactly, the cache MAY combine the + contents stored in the cache entry with the new contents received in + the response and use the result as the entity-body of this outgoing + response, (see 13.5.4). + + The end-to-end headers stored in the cache entry are used for the + constructed response, except that + + - any stored Warning headers with warn-code 1xx (see section + 14.46) MUST be deleted from the cache entry and the forwarded + response. + + - any stored Warning headers with warn-code 2xx MUST be retained + in the cache entry and the forwarded response. + + - any end-to-end headers provided in the 304 or 206 response MUST + replace the corresponding headers from the cache entry. + + Unless the cache decides to remove the cache entry, it MUST also + replace the end-to-end headers stored with the cache entry with + corresponding headers received in the incoming response, except for + Warning headers as described immediately above. If a header field- + name in the incoming response matches more than one header in the + cache entry, all such old headers MUST be replaced. + + In other words, the set of end-to-end headers received in the + incoming response overrides all corresponding end-to-end headers + stored with the cache entry (except for stored Warning headers with + warn-code 1xx, which are deleted even if not overridden). + + Note: this rule allows an origin server to use a 304 (Not + Modified) or a 206 (Partial Content) response to update any header + associated with a previous response for the same entity or sub- + ranges thereof, although it might not always be meaningful or + correct to do so. This rule does not allow an origin server to use + a 304 (Not Modified) or a 206 (Partial Content) response to + entirely delete a header that it had provided with a previous + response. + + + +Fielding, et al. Standards Track [Page 94] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.4 Combining Byte Ranges + + A response might transfer only a subrange of the bytes of an entity- + body, either because the request included one or more Range + specifications, or because a connection was broken prematurely. After + several such transfers, a cache might have received several ranges of + the same entity-body. + + If a cache has a stored non-empty set of subranges for an entity, and + an incoming response transfers another subrange, the cache MAY + combine the new subrange with the existing set if both the following + conditions are met: + + - Both the incoming response and the cache entry have a cache + validator. + + - The two cache validators match using the strong comparison + function (see section 13.3.3). + + If either requirement is not met, the cache MUST use only the most + recent partial response (based on the Date values transmitted with + every response, and using the incoming response if these values are + equal or missing), and MUST discard the other partial information. + +13.6 Caching Negotiated Responses + + Use of server-driven content negotiation (section 12.1), as indicated + by the presence of a Vary header field in a response, alters the + conditions and procedure by which a cache can use the response for + subsequent requests. See section 14.44 for use of the Vary header + field by servers. + + A server SHOULD use the Vary header field to inform a cache of what + request-header fields were used to select among multiple + representations of a cacheable response subject to server-driven + negotiation. The set of header fields named by the Vary field value + is known as the "selecting" request-headers. + + When the cache receives a subsequent request whose Request-URI + specifies one or more cache entries including a Vary header field, + the cache MUST NOT use such a cache entry to construct a response to + the new request unless all of the selecting request-headers present + in the new request match the corresponding stored request-headers in + the original request. + + The selecting request-headers from two requests are defined to match + if and only if the selecting request-headers in the first request can + be transformed to the selecting request-headers in the second request + + + +Fielding, et al. Standards Track [Page 95] + +RFC 2616 HTTP/1.1 June 1999 + + + by adding or removing linear white space (LWS) at places where this + is allowed by the corresponding BNF, and/or combining multiple + message-header fields with the same field name following the rules + about message headers in section 4.2. + + A Vary header field-value of "*" always fails to match and subsequent + requests on that resource can only be properly interpreted by the + origin server. + + If the selecting request header fields for the cached entry do not + match the selecting request header fields of the new request, then + the cache MUST NOT use a cached entry to satisfy the request unless + it first relays the new request to the origin server in a conditional + request and the server responds with 304 (Not Modified), including an + entity tag or Content-Location that indicates the entity to be used. + + If an entity tag was assigned to a cached representation, the + forwarded request SHOULD be conditional and include the entity tags + in an If-None-Match header field from all its cache entries for the + resource. This conveys to the server the set of entities currently + held by the cache, so that if any one of these entities matches the + requested entity, the server can use the ETag header field in its 304 + (Not Modified) response to tell the cache which entry is appropriate. + If the entity-tag of the new response matches that of an existing + entry, the new response SHOULD be used to update the header fields of + the existing entry, and the result MUST be returned to the client. + + If any of the existing cache entries contains only partial content + for the associated entity, its entity-tag SHOULD NOT be included in + the If-None-Match header field unless the request is for a range that + would be fully satisfied by that entry. + + If a cache receives a successful response whose Content-Location + field matches that of an existing cache entry for the same Request- + ]URI, whose entity-tag differs from that of the existing entry, and + whose Date is more recent than that of the existing entry, the + existing entry SHOULD NOT be returned in response to future requests + and SHOULD be deleted from the cache. + +13.7 Shared and Non-Shared Caches + + For reasons of security and privacy, it is necessary to make a + distinction between "shared" and "non-shared" caches. A non-shared + cache is one that is accessible only to a single user. Accessibility + in this case SHOULD be enforced by appropriate security mechanisms. + All other caches are considered to be "shared." Other sections of + + + + + +Fielding, et al. Standards Track [Page 96] + +RFC 2616 HTTP/1.1 June 1999 + + + this specification place certain constraints on the operation of + shared caches in order to prevent loss of privacy or failure of + access controls. + +13.8 Errors or Incomplete Response Cache Behavior + + A cache that receives an incomplete response (for example, with fewer + bytes of data than specified in a Content-Length header) MAY store + the response. However, the cache MUST treat this as a partial + response. Partial responses MAY be combined as described in section + 13.5.4; the result might be a full response or might still be + partial. A cache MUST NOT return a partial response to a client + without explicitly marking it as such, using the 206 (Partial + Content) status code. A cache MUST NOT return a partial response + using a status code of 200 (OK). + + If a cache receives a 5xx response while attempting to revalidate an + entry, it MAY either forward this response to the requesting client, + or act as if the server failed to respond. In the latter case, it MAY + return a previously received response unless the cached entry + includes the "must-revalidate" cache-control directive (see section + 14.9). + +13.9 Side Effects of GET and HEAD + + Unless the origin server explicitly prohibits the caching of their + responses, the application of GET and HEAD methods to any resources + SHOULD NOT have side effects that would lead to erroneous behavior if + these responses are taken from a cache. They MAY still have side + effects, but a cache is not required to consider such side effects in + its caching decisions. Caches are always expected to observe an + origin server's explicit restrictions on caching. + + We note one exception to this rule: since some applications have + traditionally used GETs and HEADs with query URLs (those containing a + "?" in the rel_path part) to perform operations with significant side + effects, caches MUST NOT treat responses to such URIs as fresh unless + the server provides an explicit expiration time. This specifically + means that responses from HTTP/1.0 servers for such URIs SHOULD NOT + be taken from a cache. See section 9.1.1 for related information. + +13.10 Invalidation After Updates or Deletions + + The effect of certain methods performed on a resource at the origin + server might cause one or more existing cache entries to become non- + transparently invalid. That is, although they might continue to be + "fresh," they do not accurately reflect what the origin server would + return for a new request on that resource. + + + +Fielding, et al. Standards Track [Page 97] + +RFC 2616 HTTP/1.1 June 1999 + + + There is no way for the HTTP protocol to guarantee that all such + cache entries are marked invalid. For example, the request that + caused the change at the origin server might not have gone through + the proxy where a cache entry is stored. However, several rules help + reduce the likelihood of erroneous behavior. + + In this section, the phrase "invalidate an entity" means that the + cache will either remove all instances of that entity from its + storage, or will mark these as "invalid" and in need of a mandatory + revalidation before they can be returned in response to a subsequent + request. + + Some HTTP methods MUST cause a cache to invalidate an entity. This is + either the entity referred to by the Request-URI, or by the Location + or Content-Location headers (if present). These methods are: + + - PUT + + - DELETE + + - POST + + In order to prevent denial of service attacks, an invalidation based + on the URI in a Location or Content-Location header MUST only be + performed if the host part is the same as in the Request-URI. + + A cache that passes through requests for methods it does not + understand SHOULD invalidate any entities referred to by the + Request-URI. + +13.11 Write-Through Mandatory + + All methods that might be expected to cause modifications to the + origin server's resources MUST be written through to the origin + server. This currently includes all methods except for GET and HEAD. + A cache MUST NOT reply to such a request from a client before having + transmitted the request to the inbound server, and having received a + corresponding response from the inbound server. This does not prevent + a proxy cache from sending a 100 (Continue) response before the + inbound server has sent its final reply. + + The alternative (known as "write-back" or "copy-back" caching) is not + allowed in HTTP/1.1, due to the difficulty of providing consistent + updates and the problems arising from server, cache, or network + failure prior to write-back. + + + + + + +Fielding, et al. Standards Track [Page 98] + +RFC 2616 HTTP/1.1 June 1999 + + +13.12 Cache Replacement + + If a new cacheable (see sections 14.9.2, 13.2.5, 13.2.6 and 13.8) + response is received from a resource while any existing responses for + the same resource are cached, the cache SHOULD use the new response + to reply to the current request. It MAY insert it into cache storage + and MAY, if it meets all other requirements, use it to respond to any + future requests that would previously have caused the old response to + be returned. If it inserts the new response into cache storage the + rules in section 13.5.3 apply. + + Note: a new response that has an older Date header value than + existing cached responses is not cacheable. + +13.13 History Lists + + User agents often have history mechanisms, such as "Back" buttons and + history lists, which can be used to redisplay an entity retrieved + earlier in a session. + + History mechanisms and caches are different. In particular history + mechanisms SHOULD NOT try to show a semantically transparent view of + the current state of a resource. Rather, a history mechanism is meant + to show exactly what the user saw at the time when the resource was + retrieved. + + By default, an expiration time does not apply to history mechanisms. + If the entity is still in storage, a history mechanism SHOULD display + it even if the entity has expired, unless the user has specifically + configured the agent to refresh expired history documents. + + This is not to be construed to prohibit the history mechanism from + telling the user that a view might be stale. + + Note: if history list mechanisms unnecessarily prevent users from + viewing stale resources, this will tend to force service authors + to avoid using HTTP expiration controls and cache controls when + they would otherwise like to. Service authors may consider it + important that users not be presented with error messages or + warning messages when they use navigation controls (such as BACK) + to view previously fetched resources. Even though sometimes such + resources ought not to cached, or ought to expire quickly, user + interface considerations may force service authors to resort to + other means of preventing caching (e.g. "once-only" URLs) in order + not to suffer the effects of improperly functioning history + mechanisms. + + + + + +Fielding, et al. Standards Track [Page 99] + +RFC 2616 HTTP/1.1 June 1999 + + +14 Header Field Definitions + + This section defines the syntax and semantics of all standard + HTTP/1.1 header fields. For entity-header fields, both sender and + recipient refer to either the client or the server, depending on who + sends and who receives the entity. + +14.1 Accept + + The Accept request-header field can be used to specify certain media + types which are acceptable for the response. Accept headers can be + used to indicate that the request is specifically limited to a small + set of desired types, as in the case of a request for an in-line + image. + + Accept = "Accept" ":" + #( media-range [ accept-params ] ) + + media-range = ( "*/*" + | ( type "/" "*" ) + | ( type "/" subtype ) + ) *( ";" parameter ) + accept-params = ";" "q" "=" qvalue *( accept-extension ) + accept-extension = ";" token [ "=" ( token | quoted-string ) ] + + The asterisk "*" character is used to group media types into ranges, + with "*/*" indicating all media types and "type/*" indicating all + subtypes of that type. The media-range MAY include media type + parameters that are applicable to that range. + + Each media-range MAY be followed by one or more accept-params, + beginning with the "q" parameter for indicating a relative quality + factor. The first "q" parameter (if any) separates the media-range + parameter(s) from the accept-params. Quality factors allow the user + or user agent to indicate the relative degree of preference for that + media-range, using the qvalue scale from 0 to 1 (section 3.9). The + default value is q=1. + + Note: Use of the "q" parameter name to separate media type + parameters from Accept extension parameters is due to historical + practice. Although this prevents any media type parameter named + "q" from being used with a media range, such an event is believed + to be unlikely given the lack of any "q" parameters in the IANA + media type registry and the rare usage of any media type + parameters in Accept. Future media types are discouraged from + registering any parameter named "q". + + + + + +Fielding, et al. Standards Track [Page 100] + +RFC 2616 HTTP/1.1 June 1999 + + + The example + + Accept: audio/*; q=0.2, audio/basic + + SHOULD be interpreted as "I prefer audio/basic, but send me any audio + type if it is the best available after an 80% mark-down in quality." + + If no Accept header field is present, then it is assumed that the + client accepts all media types. If an Accept header field is present, + and if the server cannot send a response which is acceptable + according to the combined Accept field value, then the server SHOULD + send a 406 (not acceptable) response. + + A more elaborate example is + + Accept: text/plain; q=0.5, text/html, + text/x-dvi; q=0.8, text/x-c + + Verbally, this would be interpreted as "text/html and text/x-c are + the preferred media types, but if they do not exist, then send the + text/x-dvi entity, and if that does not exist, send the text/plain + entity." + + Media ranges can be overridden by more specific media ranges or + specific media types. If more than one media range applies to a given + type, the most specific reference has precedence. For example, + + Accept: text/*, text/html, text/html;level=1, */* + + have the following precedence: + + 1) text/html;level=1 + 2) text/html + 3) text/* + 4) */* + + The media type quality factor associated with a given type is + determined by finding the media range with the highest precedence + which matches that type. For example, + + Accept: text/*;q=0.3, text/html;q=0.7, text/html;level=1, + text/html;level=2;q=0.4, */*;q=0.5 + + would cause the following values to be associated: + + text/html;level=1 = 1 + text/html = 0.7 + text/plain = 0.3 + + + +Fielding, et al. Standards Track [Page 101] + +RFC 2616 HTTP/1.1 June 1999 + + + image/jpeg = 0.5 + text/html;level=2 = 0.4 + text/html;level=3 = 0.7 + + Note: A user agent might be provided with a default set of quality + values for certain media ranges. However, unless the user agent is + a closed system which cannot interact with other rendering agents, + this default set ought to be configurable by the user. + +14.2 Accept-Charset + + The Accept-Charset request-header field can be used to indicate what + character sets are acceptable for the response. This field allows + clients capable of understanding more comprehensive or special- + purpose character sets to signal that capability to a server which is + capable of representing documents in those character sets. + + Accept-Charset = "Accept-Charset" ":" + 1#( ( charset | "*" )[ ";" "q" "=" qvalue ] ) + + + Character set values are described in section 3.4. Each charset MAY + be given an associated quality value which represents the user's + preference for that charset. The default value is q=1. An example is + + Accept-Charset: iso-8859-5, unicode-1-1;q=0.8 + + The special value "*", if present in the Accept-Charset field, + matches every character set (including ISO-8859-1) which is not + mentioned elsewhere in the Accept-Charset field. If no "*" is present + in an Accept-Charset field, then all character sets not explicitly + mentioned get a quality value of 0, except for ISO-8859-1, which gets + a quality value of 1 if not explicitly mentioned. + + If no Accept-Charset header is present, the default is that any + character set is acceptable. If an Accept-Charset header is present, + and if the server cannot send a response which is acceptable + according to the Accept-Charset header, then the server SHOULD send + an error response with the 406 (not acceptable) status code, though + the sending of an unacceptable response is also allowed. + +14.3 Accept-Encoding + + The Accept-Encoding request-header field is similar to Accept, but + restricts the content-codings (section 3.5) that are acceptable in + the response. + + Accept-Encoding = "Accept-Encoding" ":" + + + +Fielding, et al. Standards Track [Page 102] + +RFC 2616 HTTP/1.1 June 1999 + + + 1#( codings [ ";" "q" "=" qvalue ] ) + codings = ( content-coding | "*" ) + + Examples of its use are: + + Accept-Encoding: compress, gzip + Accept-Encoding: + Accept-Encoding: * + Accept-Encoding: compress;q=0.5, gzip;q=1.0 + Accept-Encoding: gzip;q=1.0, identity; q=0.5, *;q=0 + + A server tests whether a content-coding is acceptable, according to + an Accept-Encoding field, using these rules: + + 1. If the content-coding is one of the content-codings listed in + the Accept-Encoding field, then it is acceptable, unless it is + accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + 2. The special "*" symbol in an Accept-Encoding field matches any + available content-coding not explicitly listed in the header + field. + + 3. If multiple content-codings are acceptable, then the acceptable + content-coding with the highest non-zero qvalue is preferred. + + 4. The "identity" content-coding is always acceptable, unless + specifically refused because the Accept-Encoding field includes + "identity;q=0", or because the field includes "*;q=0" and does + not explicitly include the "identity" content-coding. If the + Accept-Encoding field-value is empty, then only the "identity" + encoding is acceptable. + + If an Accept-Encoding field is present in a request, and if the + server cannot send a response which is acceptable according to the + Accept-Encoding header, then the server SHOULD send an error response + with the 406 (Not Acceptable) status code. + + If no Accept-Encoding field is present in a request, the server MAY + assume that the client will accept any content coding. In this case, + if "identity" is one of the available content-codings, then the + server SHOULD use the "identity" content-coding, unless it has + additional information that a different content-coding is meaningful + to the client. + + Note: If the request does not include an Accept-Encoding field, + and if the "identity" content-coding is unavailable, then + content-codings commonly understood by HTTP/1.0 clients (i.e., + + + +Fielding, et al. Standards Track [Page 103] + +RFC 2616 HTTP/1.1 June 1999 + + + "gzip" and "compress") are preferred; some older clients + improperly display messages sent with other content-codings. The + server might also make this decision based on information about + the particular user-agent or client. + + Note: Most HTTP/1.0 applications do not recognize or obey qvalues + associated with content-codings. This means that qvalues will not + work and are not permitted with x-gzip or x-compress. + +14.4 Accept-Language + + The Accept-Language request-header field is similar to Accept, but + restricts the set of natural languages that are preferred as a + response to the request. Language tags are defined in section 3.10. + + Accept-Language = "Accept-Language" ":" + 1#( language-range [ ";" "q" "=" qvalue ] ) + language-range = ( ( 1*8ALPHA *( "-" 1*8ALPHA ) ) | "*" ) + + Each language-range MAY be given an associated quality value which + represents an estimate of the user's preference for the languages + specified by that range. The quality value defaults to "q=1". For + example, + + Accept-Language: da, en-gb;q=0.8, en;q=0.7 + + would mean: "I prefer Danish, but will accept British English and + other types of English." A language-range matches a language-tag if + it exactly equals the tag, or if it exactly equals a prefix of the + tag such that the first tag character following the prefix is "-". + The special range "*", if present in the Accept-Language field, + matches every tag not matched by any other range present in the + Accept-Language field. + + Note: This use of a prefix matching rule does not imply that + language tags are assigned to languages in such a way that it is + always true that if a user understands a language with a certain + tag, then this user will also understand all languages with tags + for which this tag is a prefix. The prefix rule simply allows the + use of prefix tags if this is the case. + + The language quality factor assigned to a language-tag by the + Accept-Language field is the quality value of the longest language- + range in the field that matches the language-tag. If no language- + range in the field matches the tag, the language quality factor + assigned is 0. If no Accept-Language header is present in the + request, the server + + + + +Fielding, et al. Standards Track [Page 104] + +RFC 2616 HTTP/1.1 June 1999 + + + SHOULD assume that all languages are equally acceptable. If an + Accept-Language header is present, then all languages which are + assigned a quality factor greater than 0 are acceptable. + + It might be contrary to the privacy expectations of the user to send + an Accept-Language header with the complete linguistic preferences of + the user in every request. For a discussion of this issue, see + section 15.1.4. + + As intelligibility is highly dependent on the individual user, it is + recommended that client applications make the choice of linguistic + preference available to the user. If the choice is not made + available, then the Accept-Language header field MUST NOT be given in + the request. + + Note: When making the choice of linguistic preference available to + the user, we remind implementors of the fact that users are not + familiar with the details of language matching as described above, + and should provide appropriate guidance. As an example, users + might assume that on selecting "en-gb", they will be served any + kind of English document if British English is not available. A + user agent might suggest in such a case to add "en" to get the + best matching behavior. + +14.5 Accept-Ranges + + The Accept-Ranges response-header field allows the server to + indicate its acceptance of range requests for a resource: + + Accept-Ranges = "Accept-Ranges" ":" acceptable-ranges + acceptable-ranges = 1#range-unit | "none" + + Origin servers that accept byte-range requests MAY send + + Accept-Ranges: bytes + + but are not required to do so. Clients MAY generate byte-range + requests without having received this header for the resource + involved. Range units are defined in section 3.12. + + Servers that do not accept any kind of range request for a + resource MAY send + + Accept-Ranges: none + + to advise the client not to attempt a range request. + + + + + +Fielding, et al. Standards Track [Page 105] + +RFC 2616 HTTP/1.1 June 1999 + + +14.6 Age + + The Age response-header field conveys the sender's estimate of the + amount of time since the response (or its revalidation) was + generated at the origin server. A cached response is "fresh" if + its age does not exceed its freshness lifetime. Age values are + calculated as specified in section 13.2.3. + + Age = "Age" ":" age-value + age-value = delta-seconds + + Age values are non-negative decimal integers, representing time in + seconds. + + If a cache receives a value larger than the largest positive + integer it can represent, or if any of its age calculations + overflows, it MUST transmit an Age header with a value of + 2147483648 (2^31). An HTTP/1.1 server that includes a cache MUST + include an Age header field in every response generated from its + own cache. Caches SHOULD use an arithmetic type of at least 31 + bits of range. + +14.7 Allow + + The Allow entity-header field lists the set of methods supported + by the resource identified by the Request-URI. The purpose of this + field is strictly to inform the recipient of valid methods + associated with the resource. An Allow header field MUST be + present in a 405 (Method Not Allowed) response. + + Allow = "Allow" ":" #Method + + Example of use: + + Allow: GET, HEAD, PUT + + This field cannot prevent a client from trying other methods. + However, the indications given by the Allow header field value + SHOULD be followed. The actual set of allowed methods is defined + by the origin server at the time of each request. + + The Allow header field MAY be provided with a PUT request to + recommend the methods to be supported by the new or modified + resource. The server is not required to support these methods and + SHOULD include an Allow header in the response giving the actual + supported methods. + + + + + +Fielding, et al. Standards Track [Page 106] + +RFC 2616 HTTP/1.1 June 1999 + + + A proxy MUST NOT modify the Allow header field even if it does not + understand all the methods specified, since the user agent might + have other means of communicating with the origin server. + +14.8 Authorization + + A user agent that wishes to authenticate itself with a server-- + usually, but not necessarily, after receiving a 401 response--does + so by including an Authorization request-header field with the + request. The Authorization field value consists of credentials + containing the authentication information of the user agent for + the realm of the resource being requested. + + Authorization = "Authorization" ":" credentials + + HTTP access authentication is described in "HTTP Authentication: + Basic and Digest Access Authentication" [43]. If a request is + authenticated and a realm specified, the same credentials SHOULD + be valid for all other requests within this realm (assuming that + the authentication scheme itself does not require otherwise, such + as credentials that vary according to a challenge value or using + synchronized clocks). + + When a shared cache (see section 13.7) receives a request + containing an Authorization field, it MUST NOT return the + corresponding response as a reply to any other request, unless one + of the following specific exceptions holds: + + 1. If the response includes the "s-maxage" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But (if the specified maximum age has + passed) a proxy cache MUST first revalidate it with the origin + server, using the request-headers from the new request to allow + the origin server to authenticate the new request. (This is the + defined behavior for s-maxage.) If the response includes "s- + maxage=0", the proxy MUST always revalidate it before re-using + it. + + 2. If the response includes the "must-revalidate" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But if the response is stale, all caches + MUST first revalidate it with the origin server, using the + request-headers from the new request to allow the origin server + to authenticate the new request. + + 3. If the response includes the "public" cache-control directive, + it MAY be returned in reply to any subsequent request. + + + + +Fielding, et al. Standards Track [Page 107] + +RFC 2616 HTTP/1.1 June 1999 + + +14.9 Cache-Control + + The Cache-Control general-header field is used to specify directives + that MUST be obeyed by all caching mechanisms along the + request/response chain. The directives specify behavior intended to + prevent caches from adversely interfering with the request or + response. These directives typically override the default caching + algorithms. Cache directives are unidirectional in that the presence + of a directive in a request does not imply that the same directive is + to be given in the response. + + Note that HTTP/1.0 caches might not implement Cache-Control and + might only implement Pragma: no-cache (see section 14.32). + + Cache directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a cache- + directive for a specific cache. + + Cache-Control = "Cache-Control" ":" 1#cache-directive + + cache-directive = cache-request-directive + | cache-response-directive + + cache-request-directive = + "no-cache" ; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "max-age" "=" delta-seconds ; Section 14.9.3, 14.9.4 + | "max-stale" [ "=" delta-seconds ] ; Section 14.9.3 + | "min-fresh" "=" delta-seconds ; Section 14.9.3 + | "no-transform" ; Section 14.9.5 + | "only-if-cached" ; Section 14.9.4 + | cache-extension ; Section 14.9.6 + + cache-response-directive = + "public" ; Section 14.9.1 + | "private" [ "=" <"> 1#field-name <"> ] ; Section 14.9.1 + | "no-cache" [ "=" <"> 1#field-name <"> ]; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "no-transform" ; Section 14.9.5 + | "must-revalidate" ; Section 14.9.4 + | "proxy-revalidate" ; Section 14.9.4 + | "max-age" "=" delta-seconds ; Section 14.9.3 + | "s-maxage" "=" delta-seconds ; Section 14.9.3 + | cache-extension ; Section 14.9.6 + + cache-extension = token [ "=" ( token | quoted-string ) ] + + + +Fielding, et al. Standards Track [Page 108] + +RFC 2616 HTTP/1.1 June 1999 + + + When a directive appears without any 1#field-name parameter, the + directive applies to the entire request or response. When such a + directive appears with a 1#field-name parameter, it applies only to + the named field or fields, and not to the rest of the request or + response. This mechanism supports extensibility; implementations of + future versions of the HTTP protocol might apply these directives to + header fields not defined in HTTP/1.1. + + The cache-control directives can be broken down into these general + categories: + + - Restrictions on what are cacheable; these may only be imposed by + the origin server. + + - Restrictions on what may be stored by a cache; these may be + imposed by either the origin server or the user agent. + + - Modifications of the basic expiration mechanism; these may be + imposed by either the origin server or the user agent. + + - Controls over cache revalidation and reload; these may only be + imposed by a user agent. + + - Control over transformation of entities. + + - Extensions to the caching system. + +14.9.1 What is Cacheable + + By default, a response is cacheable if the requirements of the + request method, request header fields, and the response status + indicate that it is cacheable. Section 13.4 summarizes these defaults + for cacheability. The following Cache-Control response directives + allow an origin server to override the default cacheability of a + response: + + public + Indicates that the response MAY be cached by any cache, even if it + would normally be non-cacheable or cacheable only within a non- + shared cache. (See also Authorization, section 14.8, for + additional details.) + + private + Indicates that all or part of the response message is intended for + a single user and MUST NOT be cached by a shared cache. This + allows an origin server to state that the specified parts of the + + + + + +Fielding, et al. Standards Track [Page 109] + +RFC 2616 HTTP/1.1 June 1999 + + + response are intended for only one user and are not a valid + response for requests by other users. A private (non-shared) cache + MAY cache the response. + + Note: This usage of the word private only controls where the + response may be cached, and cannot ensure the privacy of the + message content. + + no-cache + If the no-cache directive does not specify a field-name, then a + cache MUST NOT use the response to satisfy a subsequent request + without successful revalidation with the origin server. This + allows an origin server to prevent caching even by caches that + have been configured to return stale responses to client requests. + + If the no-cache directive does specify one or more field-names, + then a cache MAY use the response to satisfy a subsequent request, + subject to any other restrictions on caching. However, the + specified field-name(s) MUST NOT be sent in the response to a + subsequent request without successful revalidation with the origin + server. This allows an origin server to prevent the re-use of + certain header fields in a response, while still allowing caching + of the rest of the response. + + Note: Most HTTP/1.0 caches will not recognize or obey this + directive. + +14.9.2 What May be Stored by Caches + + no-store + The purpose of the no-store directive is to prevent the + inadvertent release or retention of sensitive information (for + example, on backup tapes). The no-store directive applies to the + entire message, and MAY be sent either in a response or in a + request. If sent in a request, a cache MUST NOT store any part of + either this request or any response to it. If sent in a response, + a cache MUST NOT store any part of either this response or the + request that elicited it. This directive applies to both non- + shared and shared caches. "MUST NOT store" in this context means + that the cache MUST NOT intentionally store the information in + non-volatile storage, and MUST make a best-effort attempt to + remove the information from volatile storage as promptly as + possible after forwarding it. + + Even when this directive is associated with a response, users + might explicitly store such a response outside of the caching + system (e.g., with a "Save As" dialog). History buffers MAY store + such responses as part of their normal operation. + + + +Fielding, et al. Standards Track [Page 110] + +RFC 2616 HTTP/1.1 June 1999 + + + The purpose of this directive is to meet the stated requirements + of certain users and service authors who are concerned about + accidental releases of information via unanticipated accesses to + cache data structures. While the use of this directive might + improve privacy in some cases, we caution that it is NOT in any + way a reliable or sufficient mechanism for ensuring privacy. In + particular, malicious or compromised caches might not recognize or + obey this directive, and communications networks might be + vulnerable to eavesdropping. + +14.9.3 Modifications of the Basic Expiration Mechanism + + The expiration time of an entity MAY be specified by the origin + server using the Expires header (see section 14.21). Alternatively, + it MAY be specified using the max-age directive in a response. When + the max-age cache-control directive is present in a cached response, + the response is stale if its current age is greater than the age + value given (in seconds) at the time of a new request for that + resource. The max-age directive on a response implies that the + response is cacheable (i.e., "public") unless some other, more + restrictive cache directive is also present. + + If a response includes both an Expires header and a max-age + directive, the max-age directive overrides the Expires header, even + if the Expires header is more restrictive. This rule allows an origin + server to provide, for a given response, a longer expiration time to + an HTTP/1.1 (or later) cache than to an HTTP/1.0 cache. This might be + useful if certain HTTP/1.0 caches improperly calculate ages or + expiration times, perhaps due to desynchronized clocks. + + Many HTTP/1.0 cache implementations will treat an Expires value that + is less than or equal to the response Date value as being equivalent + to the Cache-Control response directive "no-cache". If an HTTP/1.1 + cache receives such a response, and the response does not include a + Cache-Control header field, it SHOULD consider the response to be + non-cacheable in order to retain compatibility with HTTP/1.0 servers. + + Note: An origin server might wish to use a relatively new HTTP + cache control feature, such as the "private" directive, on a + network including older caches that do not understand that + feature. The origin server will need to combine the new feature + with an Expires field whose value is less than or equal to the + Date value. This will prevent older caches from improperly + caching the response. + + + + + + + +Fielding, et al. Standards Track [Page 111] + +RFC 2616 HTTP/1.1 June 1999 + + + s-maxage + If a response includes an s-maxage directive, then for a shared + cache (but not for a private cache), the maximum age specified by + this directive overrides the maximum age specified by either the + max-age directive or the Expires header. The s-maxage directive + also implies the semantics of the proxy-revalidate directive (see + section 14.9.4), i.e., that the shared cache must not use the + entry after it becomes stale to respond to a subsequent request + without first revalidating it with the origin server. The s- + maxage directive is always ignored by a private cache. + + Note that most older caches, not compliant with this specification, + do not implement any cache-control directives. An origin server + wishing to use a cache-control directive that restricts, but does not + prevent, caching by an HTTP/1.1-compliant cache MAY exploit the + requirement that the max-age directive overrides the Expires header, + and the fact that pre-HTTP/1.1-compliant caches do not observe the + max-age directive. + + Other directives allow a user agent to modify the basic expiration + mechanism. These directives MAY be specified on a request: + + max-age + Indicates that the client is willing to accept a response whose + age is no greater than the specified time in seconds. Unless max- + stale directive is also included, the client is not willing to + accept a stale response. + + min-fresh + Indicates that the client is willing to accept a response whose + freshness lifetime is no less than its current age plus the + specified time in seconds. That is, the client wants a response + that will still be fresh for at least the specified number of + seconds. + + max-stale + Indicates that the client is willing to accept a response that has + exceeded its expiration time. If max-stale is assigned a value, + then the client is willing to accept a response that has exceeded + its expiration time by no more than the specified number of + seconds. If no value is assigned to max-stale, then the client is + willing to accept a stale response of any age. + + If a cache returns a stale response, either because of a max-stale + directive on a request, or because the cache is configured to + override the expiration time of a response, the cache MUST attach a + Warning header to the stale response, using Warning 110 (Response is + stale). + + + +Fielding, et al. Standards Track [Page 112] + +RFC 2616 HTTP/1.1 June 1999 + + + A cache MAY be configured to return stale responses without + validation, but only if this does not conflict with any "MUST"-level + requirements concerning cache validation (e.g., a "must-revalidate" + cache-control directive). + + If both the new request and the cached entry include "max-age" + directives, then the lesser of the two values is used for determining + the freshness of the cached entry for that request. + +14.9.4 Cache Revalidation and Reload Controls + + Sometimes a user agent might want or need to insist that a cache + revalidate its cache entry with the origin server (and not just with + the next cache along the path to the origin server), or to reload its + cache entry from the origin server. End-to-end revalidation might be + necessary if either the cache or the origin server has overestimated + the expiration time of the cached response. End-to-end reload may be + necessary if the cache entry has become corrupted for some reason. + + End-to-end revalidation may be requested either when the client does + not have its own local cached copy, in which case we call it + "unspecified end-to-end revalidation", or when the client does have a + local cached copy, in which case we call it "specific end-to-end + revalidation." + + The client can specify these three kinds of action using Cache- + Control request directives: + + End-to-end reload + The request includes a "no-cache" cache-control directive or, for + compatibility with HTTP/1.0 clients, "Pragma: no-cache". Field + names MUST NOT be included with the no-cache directive in a + request. The server MUST NOT use a cached copy when responding to + such a request. + + Specific end-to-end revalidation + The request includes a "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request includes a cache-validating conditional with + the client's current validator. + + Unspecified end-to-end revalidation + The request includes "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request does not include a cache-validating + + + + +Fielding, et al. Standards Track [Page 113] + +RFC 2616 HTTP/1.1 June 1999 + + + conditional; the first cache along the path (if any) that holds a + cache entry for this resource includes a cache-validating + conditional with its current validator. + + max-age + When an intermediate cache is forced, by means of a max-age=0 + directive, to revalidate its own cache entry, and the client has + supplied its own validator in the request, the supplied validator + might differ from the validator currently stored with the cache + entry. In this case, the cache MAY use either validator in making + its own request without affecting semantic transparency. + + However, the choice of validator might affect performance. The + best approach is for the intermediate cache to use its own + validator when making its request. If the server replies with 304 + (Not Modified), then the cache can return its now validated copy + to the client with a 200 (OK) response. If the server replies with + a new entity and cache validator, however, the intermediate cache + can compare the returned validator with the one provided in the + client's request, using the strong comparison function. If the + client's validator is equal to the origin server's, then the + intermediate cache simply returns 304 (Not Modified). Otherwise, + it returns the new entity with a 200 (OK) response. + + If a request includes the no-cache directive, it SHOULD NOT + include min-fresh, max-stale, or max-age. + + only-if-cached + In some cases, such as times of extremely poor network + connectivity, a client may want a cache to return only those + responses that it currently has stored, and not to reload or + revalidate with the origin server. To do this, the client may + include the only-if-cached directive in a request. If it receives + this directive, a cache SHOULD either respond using a cached entry + that is consistent with the other constraints of the request, or + respond with a 504 (Gateway Timeout) status. However, if a group + of caches is being operated as a unified system with good internal + connectivity, such a request MAY be forwarded within that group of + caches. + + must-revalidate + Because a cache MAY be configured to ignore a server's specified + expiration time, and because a client request MAY include a max- + stale directive (which has a similar effect), the protocol also + includes a mechanism for the origin server to require revalidation + of a cache entry on any subsequent use. When the must-revalidate + directive is present in a response received by a cache, that cache + MUST NOT use the entry after it becomes stale to respond to a + + + +Fielding, et al. Standards Track [Page 114] + +RFC 2616 HTTP/1.1 June 1999 + + + subsequent request without first revalidating it with the origin + server. (I.e., the cache MUST do an end-to-end revalidation every + time, if, based solely on the origin server's Expires or max-age + value, the cached response is stale.) + + The must-revalidate directive is necessary to support reliable + operation for certain protocol features. In all circumstances an + HTTP/1.1 cache MUST obey the must-revalidate directive; in + particular, if the cache cannot reach the origin server for any + reason, it MUST generate a 504 (Gateway Timeout) response. + + Servers SHOULD send the must-revalidate directive if and only if + failure to revalidate a request on the entity could result in + incorrect operation, such as a silently unexecuted financial + transaction. Recipients MUST NOT take any automated action that + violates this directive, and MUST NOT automatically provide an + unvalidated copy of the entity if revalidation fails. + + Although this is not recommended, user agents operating under + severe connectivity constraints MAY violate this directive but, if + so, MUST explicitly warn the user that an unvalidated response has + been provided. The warning MUST be provided on each unvalidated + access, and SHOULD require explicit user confirmation. + + proxy-revalidate + The proxy-revalidate directive has the same meaning as the must- + revalidate directive, except that it does not apply to non-shared + user agent caches. It can be used on a response to an + authenticated request to permit the user's cache to store and + later return the response without needing to revalidate it (since + it has already been authenticated once by that user), while still + requiring proxies that service many users to revalidate each time + (in order to make sure that each user has been authenticated). + Note that such authenticated responses also need the public cache + control directive in order to allow them to be cached at all. + +14.9.5 No-Transform Directive + + no-transform + Implementors of intermediate caches (proxies) have found it useful + to convert the media type of certain entity bodies. A non- + transparent proxy might, for example, convert between image + formats in order to save cache space or to reduce the amount of + traffic on a slow link. + + Serious operational problems occur, however, when these + transformations are applied to entity bodies intended for certain + kinds of applications. For example, applications for medical + + + +Fielding, et al. Standards Track [Page 115] + +RFC 2616 HTTP/1.1 June 1999 + + + imaging, scientific data analysis and those using end-to-end + authentication, all depend on receiving an entity body that is bit + for bit identical to the original entity-body. + + Therefore, if a message includes the no-transform directive, an + intermediate cache or proxy MUST NOT change those headers that are + listed in section 13.5.2 as being subject to the no-transform + directive. This implies that the cache or proxy MUST NOT change + any aspect of the entity-body that is specified by these headers, + including the value of the entity-body itself. + +14.9.6 Cache Control Extensions + + The Cache-Control header field can be extended through the use of one + or more cache-extension tokens, each with an optional assigned value. + Informational extensions (those which do not require a change in + cache behavior) MAY be added without changing the semantics of other + directives. Behavioral extensions are designed to work by acting as + modifiers to the existing base of cache directives. Both the new + directive and the standard directive are supplied, such that + applications which do not understand the new directive will default + to the behavior specified by the standard directive, and those that + understand the new directive will recognize it as modifying the + requirements associated with the standard directive. In this way, + extensions to the cache-control directives can be made without + requiring changes to the base protocol. + + This extension mechanism depends on an HTTP cache obeying all of the + cache-control directives defined for its native HTTP-version, obeying + certain extensions, and ignoring all directives that it does not + understand. + + For example, consider a hypothetical new response directive called + community which acts as a modifier to the private directive. We + define this new directive to mean that, in addition to any non-shared + cache, any cache which is shared only by members of the community + named within its value may cache the response. An origin server + wishing to allow the UCI community to use an otherwise private + response in their shared cache(s) could do so by including + + Cache-Control: private, community="UCI" + + A cache seeing this header field will act correctly even if the cache + does not understand the community cache-extension, since it will also + see and understand the private directive and thus default to the safe + behavior. + + + + + +Fielding, et al. Standards Track [Page 116] + +RFC 2616 HTTP/1.1 June 1999 + + + Unrecognized cache-directives MUST be ignored; it is assumed that any + cache-directive likely to be unrecognized by an HTTP/1.1 cache will + be combined with standard directives (or the response's default + cacheability) such that the cache behavior will remain minimally + correct even if the cache does not understand the extension(s). + +14.10 Connection + + The Connection general-header field allows the sender to specify + options that are desired for that particular connection and MUST NOT + be communicated by proxies over further connections. + + The Connection header has the following grammar: + + Connection = "Connection" ":" 1#(connection-token) + connection-token = token + + HTTP/1.1 proxies MUST parse the Connection header field before a + message is forwarded and, for each connection-token in this field, + remove any header field(s) from the message with the same name as the + connection-token. Connection options are signaled by the presence of + a connection-token in the Connection header field, not by any + corresponding additional header field(s), since the additional header + field may not be sent if there are no parameters associated with that + connection option. + + Message headers listed in the Connection header MUST NOT include + end-to-end headers, such as Cache-Control. + + HTTP/1.1 defines the "close" connection option for the sender to + signal that the connection will be closed after completion of the + response. For example, + + Connection: close + + in either the request or the response header fields indicates that + the connection SHOULD NOT be considered `persistent' (section 8.1) + after the current request/response is complete. + + HTTP/1.1 applications that do not support persistent connections MUST + include the "close" connection option in every message. + + A system receiving an HTTP/1.0 (or lower-version) message that + includes a Connection header MUST, for each connection-token in this + field, remove and ignore any header field(s) from the message with + the same name as the connection-token. This protects against mistaken + forwarding of such header fields by pre-HTTP/1.1 proxies. See section + 19.6.2. + + + +Fielding, et al. Standards Track [Page 117] + +RFC 2616 HTTP/1.1 June 1999 + + +14.11 Content-Encoding + + The Content-Encoding entity-header field is used as a modifier to the + media-type. When present, its value indicates what additional content + codings have been applied to the entity-body, and thus what decoding + mechanisms must be applied in order to obtain the media-type + referenced by the Content-Type header field. Content-Encoding is + primarily used to allow a document to be compressed without losing + the identity of its underlying media type. + + Content-Encoding = "Content-Encoding" ":" 1#content-coding + + Content codings are defined in section 3.5. An example of its use is + + Content-Encoding: gzip + + The content-coding is a characteristic of the entity identified by + the Request-URI. Typically, the entity-body is stored with this + encoding and is only decoded before rendering or analogous usage. + However, a non-transparent proxy MAY modify the content-coding if the + new coding is known to be acceptable to the recipient, unless the + "no-transform" cache-control directive is present in the message. + + If the content-coding of an entity is not "identity", then the + response MUST include a Content-Encoding entity-header (section + 14.11) that lists the non-identity content-coding(s) used. + + If the content-coding of an entity in a request message is not + acceptable to the origin server, the server SHOULD respond with a + status code of 415 (Unsupported Media Type). + + If multiple encodings have been applied to an entity, the content + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + +14.12 Content-Language + + The Content-Language entity-header field describes the natural + language(s) of the intended audience for the enclosed entity. Note + that this might not be equivalent to all the languages used within + the entity-body. + + Content-Language = "Content-Language" ":" 1#language-tag + + + + + + + +Fielding, et al. Standards Track [Page 118] + +RFC 2616 HTTP/1.1 June 1999 + + + Language tags are defined in section 3.10. The primary purpose of + Content-Language is to allow a user to identify and differentiate + entities according to the user's own preferred language. Thus, if the + body content is intended only for a Danish-literate audience, the + appropriate field is + + Content-Language: da + + If no Content-Language is specified, the default is that the content + is intended for all language audiences. This might mean that the + sender does not consider it to be specific to any natural language, + or that the sender does not know for which language it is intended. + + Multiple languages MAY be listed for content that is intended for + multiple audiences. For example, a rendition of the "Treaty of + Waitangi," presented simultaneously in the original Maori and English + versions, would call for + + Content-Language: mi, en + + However, just because multiple languages are present within an entity + does not mean that it is intended for multiple linguistic audiences. + An example would be a beginner's language primer, such as "A First + Lesson in Latin," which is clearly intended to be used by an + English-literate audience. In this case, the Content-Language would + properly only include "en". + + Content-Language MAY be applied to any media type -- it is not + limited to textual documents. + +14.13 Content-Length + + The Content-Length entity-header field indicates the size of the + entity-body, in decimal number of OCTETs, sent to the recipient or, + in the case of the HEAD method, the size of the entity-body that + would have been sent had the request been a GET. + + Content-Length = "Content-Length" ":" 1*DIGIT + + An example is + + Content-Length: 3495 + + Applications SHOULD use this field to indicate the transfer-length of + the message-body, unless this is prohibited by the rules in section + 4.4. + + + + + +Fielding, et al. Standards Track [Page 119] + +RFC 2616 HTTP/1.1 June 1999 + + + Any Content-Length greater than or equal to zero is a valid value. + Section 4.4 describes how to determine the length of a message-body + if a Content-Length is not given. + + Note that the meaning of this field is significantly different from + the corresponding definition in MIME, where it is an optional field + used within the "message/external-body" content-type. In HTTP, it + SHOULD be sent whenever the message's length can be determined prior + to being transferred, unless this is prohibited by the rules in + section 4.4. + +14.14 Content-Location + + The Content-Location entity-header field MAY be used to supply the + resource location for the entity enclosed in the message when that + entity is accessible from a location separate from the requested + resource's URI. A server SHOULD provide a Content-Location for the + variant corresponding to the response entity; especially in the case + where a resource has multiple entities associated with it, and those + entities actually have separate locations by which they might be + individually accessed, the server SHOULD provide a Content-Location + for the particular variant which is returned. + + Content-Location = "Content-Location" ":" + ( absoluteURI | relativeURI ) + + The value of Content-Location also defines the base URI for the + entity. + + The Content-Location value is not a replacement for the original + requested URI; it is only a statement of the location of the resource + corresponding to this particular entity at the time of the request. + Future requests MAY specify the Content-Location URI as the request- + URI if the desire is to identify the source of that particular + entity. + + A cache cannot assume that an entity with a Content-Location + different from the URI used to retrieve it can be used to respond to + later requests on that Content-Location URI. However, the Content- + Location can be used to differentiate between multiple entities + retrieved from a single requested resource, as described in section + 13.6. + + If the Content-Location is a relative URI, the relative URI is + interpreted relative to the Request-URI. + + The meaning of the Content-Location header in PUT or POST requests is + undefined; servers are free to ignore it in those cases. + + + +Fielding, et al. Standards Track [Page 120] + +RFC 2616 HTTP/1.1 June 1999 + + +14.15 Content-MD5 + + The Content-MD5 entity-header field, as defined in RFC 1864 [23], is + an MD5 digest of the entity-body for the purpose of providing an + end-to-end message integrity check (MIC) of the entity-body. (Note: a + MIC is good for detecting accidental modification of the entity-body + in transit, but is not proof against malicious attacks.) + + Content-MD5 = "Content-MD5" ":" md5-digest + md5-digest = + + The Content-MD5 header field MAY be generated by an origin server or + client to function as an integrity check of the entity-body. Only + origin servers or clients MAY generate the Content-MD5 header field; + proxies and gateways MUST NOT generate it, as this would defeat its + value as an end-to-end integrity check. Any recipient of the entity- + body, including gateways and proxies, MAY check that the digest value + in this header field matches that of the entity-body as received. + + The MD5 digest is computed based on the content of the entity-body, + including any content-coding that has been applied, but not including + any transfer-encoding applied to the message-body. If the message is + received with a transfer-encoding, that encoding MUST be removed + prior to checking the Content-MD5 value against the received entity. + + This has the result that the digest is computed on the octets of the + entity-body exactly as, and in the order that, they would be sent if + no transfer-encoding were being applied. + + HTTP extends RFC 1864 to permit the digest to be computed for MIME + composite media-types (e.g., multipart/* and message/rfc822), but + this does not change how the digest is computed as defined in the + preceding paragraph. + + There are several consequences of this. The entity-body for composite + types MAY contain many body-parts, each with its own MIME and HTTP + headers (including Content-MD5, Content-Transfer-Encoding, and + Content-Encoding headers). If a body-part has a Content-Transfer- + Encoding or Content-Encoding header, it is assumed that the content + of the body-part has had the encoding applied, and the body-part is + included in the Content-MD5 digest as is -- i.e., after the + application. The Transfer-Encoding header field is not allowed within + body-parts. + + Conversion of all line breaks to CRLF MUST NOT be done before + computing or checking the digest: the line break convention used in + the text actually transmitted MUST be left unaltered when computing + the digest. + + + +Fielding, et al. Standards Track [Page 121] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: while the definition of Content-MD5 is exactly the same for + HTTP as in RFC 1864 for MIME entity-bodies, there are several ways + in which the application of Content-MD5 to HTTP entity-bodies + differs from its application to MIME entity-bodies. One is that + HTTP, unlike MIME, does not use Content-Transfer-Encoding, and + does use Transfer-Encoding and Content-Encoding. Another is that + HTTP more frequently uses binary content types than MIME, so it is + worth noting that, in such cases, the byte order used to compute + the digest is the transmission byte order defined for the type. + Lastly, HTTP allows transmission of text types with any of several + line break conventions and not just the canonical form using CRLF. + +14.16 Content-Range + + The Content-Range entity-header is sent with a partial entity-body to + specify where in the full entity-body the partial body should be + applied. Range units are defined in section 3.12. + + Content-Range = "Content-Range" ":" content-range-spec + + content-range-spec = byte-content-range-spec + byte-content-range-spec = bytes-unit SP + byte-range-resp-spec "/" + ( instance-length | "*" ) + + byte-range-resp-spec = (first-byte-pos "-" last-byte-pos) + | "*" + instance-length = 1*DIGIT + + The header SHOULD indicate the total length of the full entity-body, + unless this length is unknown or difficult to determine. The asterisk + "*" character means that the instance-length is unknown at the time + when the response was generated. + + Unlike byte-ranges-specifier values (see section 14.35.1), a byte- + range-resp-spec MUST only specify one range, and MUST contain + absolute byte positions for both the first and last byte of the + range. + + A byte-content-range-spec with a byte-range-resp-spec whose last- + byte-pos value is less than its first-byte-pos value, or whose + instance-length value is less than or equal to its last-byte-pos + value, is invalid. The recipient of an invalid byte-content-range- + spec MUST ignore it and any content transferred along with it. + + A server sending a response with status code 416 (Requested range not + satisfiable) SHOULD include a Content-Range field with a byte-range- + resp-spec of "*". The instance-length specifies the current length of + + + +Fielding, et al. Standards Track [Page 122] + +RFC 2616 HTTP/1.1 June 1999 + + + the selected resource. A response with status code 206 (Partial + Content) MUST NOT include a Content-Range field with a byte-range- + resp-spec of "*". + + Examples of byte-content-range-spec values, assuming that the entity + contains a total of 1234 bytes: + + . The first 500 bytes: + bytes 0-499/1234 + + . The second 500 bytes: + bytes 500-999/1234 + + . All except for the first 500 bytes: + bytes 500-1233/1234 + + . The last 500 bytes: + bytes 734-1233/1234 + + When an HTTP message includes the content of a single range (for + example, a response to a request for a single range, or to a request + for a set of ranges that overlap without any holes), this content is + transmitted with a Content-Range header, and a Content-Length header + showing the number of bytes actually transferred. For example, + + HTTP/1.1 206 Partial content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-Range: bytes 21010-47021/47022 + Content-Length: 26012 + Content-Type: image/gif + + When an HTTP message includes the content of multiple ranges (for + example, a response to a request for multiple non-overlapping + ranges), these are transmitted as a multipart message. The multipart + media type used for this purpose is "multipart/byteranges" as defined + in appendix 19.2. See appendix 19.6.3 for a compatibility issue. + + A response to a request for a single range MUST NOT be sent using the + multipart/byteranges media type. A response to a request for + multiple ranges, whose result is a single range, MAY be sent as a + multipart/byteranges media type with one part. A client that cannot + decode a multipart/byteranges message MUST NOT ask for multiple + byte-ranges in a single request. + + When a client requests multiple byte-ranges in one request, the + server SHOULD return them in the order that they appeared in the + request. + + + +Fielding, et al. Standards Track [Page 123] + +RFC 2616 HTTP/1.1 June 1999 + + + If the server ignores a byte-range-spec because it is syntactically + invalid, the server SHOULD treat the request as if the invalid Range + header field did not exist. (Normally, this means return a 200 + response containing the full entity). + + If the server receives a request (other than one including an If- + Range request-header field) with an unsatisfiable Range request- + header field (that is, all of whose byte-range-spec values have a + first-byte-pos value greater than the current length of the selected + resource), it SHOULD return a response code of 416 (Requested range + not satisfiable) (section 10.4.17). + + Note: clients cannot depend on servers to send a 416 (Requested + range not satisfiable) response instead of a 200 (OK) response for + an unsatisfiable Range request-header, since not all servers + implement this request-header. + +14.17 Content-Type + + The Content-Type entity-header field indicates the media type of the + entity-body sent to the recipient or, in the case of the HEAD method, + the media type that would have been sent had the request been a GET. + + Content-Type = "Content-Type" ":" media-type + + Media types are defined in section 3.7. An example of the field is + + Content-Type: text/html; charset=ISO-8859-4 + + Further discussion of methods for identifying the media type of an + entity is provided in section 7.2.1. + +14.18 Date + + The Date general-header field represents the date and time at which + the message was originated, having the same semantics as orig-date in + RFC 822. The field value is an HTTP-date, as described in section + 3.3.1; it MUST be sent in RFC 1123 [8]-date format. + + Date = "Date" ":" HTTP-date + + An example is + + Date: Tue, 15 Nov 1994 08:12:31 GMT + + Origin servers MUST include a Date header field in all responses, + except in these cases: + + + + +Fielding, et al. Standards Track [Page 124] + +RFC 2616 HTTP/1.1 June 1999 + + + 1. If the response status code is 100 (Continue) or 101 (Switching + Protocols), the response MAY include a Date header field, at + the server's option. + + 2. If the response status code conveys a server error, e.g. 500 + (Internal Server Error) or 503 (Service Unavailable), and it is + inconvenient or impossible to generate a valid Date. + + 3. If the server does not have a clock that can provide a + reasonable approximation of the current time, its responses + MUST NOT include a Date header field. In this case, the rules + in section 14.18.1 MUST be followed. + + A received message that does not have a Date header field MUST be + assigned one by the recipient if the message will be cached by that + recipient or gatewayed via a protocol which requires a Date. An HTTP + implementation without a clock MUST NOT cache responses without + revalidating them on every use. An HTTP cache, especially a shared + cache, SHOULD use a mechanism, such as NTP [28], to synchronize its + clock with a reliable external standard. + + Clients SHOULD only send a Date header field in messages that include + an entity-body, as in the case of the PUT and POST requests, and even + then it is optional. A client without a clock MUST NOT send a Date + header field in a request. + + The HTTP-date sent in a Date header SHOULD NOT represent a date and + time subsequent to the generation of the message. It SHOULD represent + the best available approximation of the date and time of message + generation, unless the implementation has no means of generating a + reasonably accurate date and time. In theory, the date ought to + represent the moment just before the entity is generated. In + practice, the date can be generated at any time during the message + origination without affecting its semantic value. + +14.18.1 Clockless Origin Server Operation + + Some origin server implementations might not have a clock available. + An origin server without a clock MUST NOT assign Expires or Last- + Modified values to a response, unless these values were associated + with the resource by a system or user with a reliable clock. It MAY + assign an Expires value that is known, at or before server + configuration time, to be in the past (this allows "pre-expiration" + of responses without storing separate Expires values for each + resource). + + + + + + +Fielding, et al. Standards Track [Page 125] + +RFC 2616 HTTP/1.1 June 1999 + + +14.19 ETag + + The ETag response-header field provides the current value of the + entity tag for the requested variant. The headers used with entity + tags are described in sections 14.24, 14.26 and 14.44. The entity tag + MAY be used for comparison with other entities from the same resource + (see section 13.3.3). + + ETag = "ETag" ":" entity-tag + + Examples: + + ETag: "xyzzy" + ETag: W/"xyzzy" + ETag: "" + +14.20 Expect + + The Expect request-header field is used to indicate that particular + server behaviors are required by the client. + + Expect = "Expect" ":" 1#expectation + + expectation = "100-continue" | expectation-extension + expectation-extension = token [ "=" ( token | quoted-string ) + *expect-params ] + expect-params = ";" token [ "=" ( token | quoted-string ) ] + + + A server that does not understand or is unable to comply with any of + the expectation values in the Expect field of a request MUST respond + with appropriate error status. The server MUST respond with a 417 + (Expectation Failed) status if any of the expectations cannot be met + or, if there are other problems with the request, some other 4xx + status. + + This header field is defined with extensible syntax to allow for + future extensions. If a server receives a request containing an + Expect field that includes an expectation-extension that it does not + support, it MUST respond with a 417 (Expectation Failed) status. + + Comparison of expectation values is case-insensitive for unquoted + tokens (including the 100-continue token), and is case-sensitive for + quoted-string expectation-extensions. + + + + + + + +Fielding, et al. Standards Track [Page 126] + +RFC 2616 HTTP/1.1 June 1999 + + + The Expect mechanism is hop-by-hop: that is, an HTTP/1.1 proxy MUST + return a 417 (Expectation Failed) status if it receives a request + with an expectation that it cannot meet. However, the Expect + request-header itself is end-to-end; it MUST be forwarded if the + request is forwarded. + + Many older HTTP/1.0 and HTTP/1.1 applications do not understand the + Expect header. + + See section 8.2.3 for the use of the 100 (continue) status. + +14.21 Expires + + The Expires entity-header field gives the date/time after which the + response is considered stale. A stale cache entry may not normally be + returned by a cache (either a proxy cache or a user agent cache) + unless it is first validated with the origin server (or with an + intermediate cache that has a fresh copy of the entity). See section + 13.2 for further discussion of the expiration model. + + The presence of an Expires field does not imply that the original + resource will change or cease to exist at, before, or after that + time. + + The format is an absolute date and time as defined by HTTP-date in + section 3.3.1; it MUST be in RFC 1123 date format: + + Expires = "Expires" ":" HTTP-date + + An example of its use is + + Expires: Thu, 01 Dec 1994 16:00:00 GMT + + Note: if a response includes a Cache-Control field with the max- + age directive (see section 14.9.3), that directive overrides the + Expires field. + + HTTP/1.1 clients and caches MUST treat other invalid date formats, + especially including the value "0", as in the past (i.e., "already + expired"). + + To mark a response as "already expired," an origin server sends an + Expires date that is equal to the Date header value. (See the rules + for expiration calculations in section 13.2.4.) + + + + + + + +Fielding, et al. Standards Track [Page 127] + +RFC 2616 HTTP/1.1 June 1999 + + + To mark a response as "never expires," an origin server sends an + Expires date approximately one year from the time the response is + sent. HTTP/1.1 servers SHOULD NOT send Expires dates more than one + year in the future. + + The presence of an Expires header field with a date value of some + time in the future on a response that otherwise would by default be + non-cacheable indicates that the response is cacheable, unless + indicated otherwise by a Cache-Control header field (section 14.9). + +14.22 From + + The From request-header field, if given, SHOULD contain an Internet + e-mail address for the human user who controls the requesting user + agent. The address SHOULD be machine-usable, as defined by "mailbox" + in RFC 822 [9] as updated by RFC 1123 [8]: + + From = "From" ":" mailbox + + An example is: + + From: webmaster@w3.org + + This header field MAY be used for logging purposes and as a means for + identifying the source of invalid or unwanted requests. It SHOULD NOT + be used as an insecure form of access protection. The interpretation + of this field is that the request is being performed on behalf of the + person given, who accepts responsibility for the method performed. In + particular, robot agents SHOULD include this header so that the + person responsible for running the robot can be contacted if problems + occur on the receiving end. + + The Internet e-mail address in this field MAY be separate from the + Internet host which issued the request. For example, when a request + is passed through a proxy the original issuer's address SHOULD be + used. + + The client SHOULD NOT send the From header field without the user's + approval, as it might conflict with the user's privacy interests or + their site's security policy. It is strongly recommended that the + user be able to disable, enable, and modify the value of this field + at any time prior to a request. + +14.23 Host + + The Host request-header field specifies the Internet host and port + number of the resource being requested, as obtained from the original + URI given by the user or referring resource (generally an HTTP URL, + + + +Fielding, et al. Standards Track [Page 128] + +RFC 2616 HTTP/1.1 June 1999 + + + as described in section 3.2.2). The Host field value MUST represent + the naming authority of the origin server or gateway given by the + original URL. This allows the origin server or gateway to + differentiate between internally-ambiguous URLs, such as the root "/" + URL of a server for multiple host names on a single IP address. + + Host = "Host" ":" host [ ":" port ] ; Section 3.2.2 + + A "host" without any trailing port information implies the default + port for the service requested (e.g., "80" for an HTTP URL). For + example, a request on the origin server for + would properly include: + + GET /pub/WWW/ HTTP/1.1 + Host: www.w3.org + + A client MUST include a Host header field in all HTTP/1.1 request + messages . If the requested URI does not include an Internet host + name for the service being requested, then the Host header field MUST + be given with an empty value. An HTTP/1.1 proxy MUST ensure that any + request message it forwards does contain an appropriate Host header + field that identifies the service being requested by the proxy. All + Internet-based HTTP/1.1 servers MUST respond with a 400 (Bad Request) + status code to any HTTP/1.1 request message which lacks a Host header + field. + + See sections 5.2 and 19.6.1.1 for other requirements relating to + Host. + +14.24 If-Match + + The If-Match request-header field is used with a method to make it + conditional. A client that has one or more entities previously + obtained from the resource can verify that one of those entities is + current by including a list of their associated entity tags in the + If-Match header field. Entity tags are defined in section 3.11. The + purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. It is also + used, on updating requests, to prevent inadvertent modification of + the wrong version of a resource. As a special case, the value "*" + matches any current entity of the resource. + + If-Match = "If-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-Match header) on that resource, or if "*" is given + + + + +Fielding, et al. Standards Track [Page 129] + +RFC 2616 HTTP/1.1 June 1999 + + + and any current entity exists for that resource, then the server MAY + perform the requested method as if the If-Match header field did not + exist. + + A server MUST use the strong comparison function (see section 13.3.3) + to compare the entity tags in If-Match. + + If none of the entity tags match, or if "*" is given and no current + entity exists, the server MUST NOT perform the requested method, and + MUST return a 412 (Precondition Failed) response. This behavior is + most useful when the client wants to prevent an updating method, such + as PUT, from modifying a resource that has changed since the client + last retrieved it. + + If the request would, without the If-Match header field, result in + anything other than a 2xx or 412 status, then the If-Match header + MUST be ignored. + + The meaning of "If-Match: *" is that the method SHOULD be performed + if the representation selected by the origin server (or by a cache, + possibly using the Vary mechanism, see section 14.44) exists, and + MUST NOT be performed if the representation does not exist. + + A request intended to update a resource (e.g., a PUT) MAY include an + If-Match header field to signal that the request method MUST NOT be + applied if the entity corresponding to the If-Match value (a single + entity tag) is no longer a representation of that resource. This + allows the user to indicate that they do not wish the request to be + successful if the resource has been changed without their knowledge. + Examples: + + If-Match: "xyzzy" + If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-Match: * + + The result of a request having both an If-Match header field and + either an If-None-Match or an If-Modified-Since header fields is + undefined by this specification. + +14.25 If-Modified-Since + + The If-Modified-Since request-header field is used with a method to + make it conditional: if the requested variant has not been modified + since the time specified in this field, an entity will not be + returned from the server; instead, a 304 (not modified) response will + be returned without any message-body. + + If-Modified-Since = "If-Modified-Since" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 130] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of the field is: + + If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + A GET method with an If-Modified-Since header and no Range header + requests that the identified entity be transferred only if it has + been modified since the date given by the If-Modified-Since header. + The algorithm for determining this includes the following cases: + + a) If the request would normally result in anything other than a + 200 (OK) status, or if the passed If-Modified-Since date is + invalid, the response is exactly the same as for a normal GET. + A date which is later than the server's current time is + invalid. + + b) If the variant has been modified since the If-Modified-Since + date, the response is exactly the same as for a normal GET. + + c) If the variant has not been modified since a valid If- + Modified-Since date, the server SHOULD return a 304 (Not + Modified) response. + + The purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. + + Note: The Range request-header field modifies the meaning of If- + Modified-Since; see section 14.35 for full details. + + Note: If-Modified-Since times are interpreted by the server, whose + clock might not be synchronized with the client. + + Note: When handling an If-Modified-Since header field, some + servers will use an exact date comparison function, rather than a + less-than function, for deciding whether to send a 304 (Not + Modified) response. To get best results when sending an If- + Modified-Since header field for cache validation, clients are + advised to use the exact date string received in a previous Last- + Modified header field whenever possible. + + Note: If a client uses an arbitrary date in the If-Modified-Since + header instead of a date taken from the Last-Modified header for + the same request, the client should be aware of the fact that this + date is interpreted in the server's understanding of time. The + client should consider unsynchronized clocks and rounding problems + due to the different encodings of time between the client and + server. This includes the possibility of race conditions if the + document has changed between the time it was first requested and + the If-Modified-Since date of a subsequent request, and the + + + +Fielding, et al. Standards Track [Page 131] + +RFC 2616 HTTP/1.1 June 1999 + + + possibility of clock-skew-related problems if the If-Modified- + Since date is derived from the client's clock without correction + to the server's clock. Corrections for different time bases + between client and server are at best approximate due to network + latency. + + The result of a request having both an If-Modified-Since header field + and either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.26 If-None-Match + + The If-None-Match request-header field is used with a method to make + it conditional. A client that has one or more entities previously + obtained from the resource can verify that none of those entities is + current by including a list of their associated entity tags in the + If-None-Match header field. The purpose of this feature is to allow + efficient updates of cached information with a minimum amount of + transaction overhead. It is also used to prevent a method (e.g. PUT) + from inadvertently modifying an existing resource when the client + believes that the resource does not exist. + + As a special case, the value "*" matches any current entity of the + resource. + + If-None-Match = "If-None-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-None-Match header) on that resource, or if "*" is + given and any current entity exists for that resource, then the + server MUST NOT perform the requested method, unless required to do + so because the resource's modification date fails to match that + supplied in an If-Modified-Since header field in the request. + Instead, if the request method was GET or HEAD, the server SHOULD + respond with a 304 (Not Modified) response, including the cache- + related header fields (particularly ETag) of one of the entities that + matched. For all other request methods, the server MUST respond with + a status of 412 (Precondition Failed). + + See section 13.3.3 for rules on how to determine if two entities tags + match. The weak comparison function can only be used with GET or HEAD + requests. + + + + + + + + +Fielding, et al. Standards Track [Page 132] + +RFC 2616 HTTP/1.1 June 1999 + + + If none of the entity tags match, then the server MAY perform the + requested method as if the If-None-Match header field did not exist, + but MUST also ignore any If-Modified-Since header field(s) in the + request. That is, if no entity tags match, then the server MUST NOT + return a 304 (Not Modified) response. + + If the request would, without the If-None-Match header field, result + in anything other than a 2xx or 304 status, then the If-None-Match + header MUST be ignored. (See section 13.3.4 for a discussion of + server behavior when both If-Modified-Since and If-None-Match appear + in the same request.) + + The meaning of "If-None-Match: *" is that the method MUST NOT be + performed if the representation selected by the origin server (or by + a cache, possibly using the Vary mechanism, see section 14.44) + exists, and SHOULD be performed if the representation does not exist. + This feature is intended to be useful in preventing races between PUT + operations. + + Examples: + + If-None-Match: "xyzzy" + If-None-Match: W/"xyzzy" + If-None-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-None-Match: W/"xyzzy", W/"r2d2xxxx", W/"c3piozzzz" + If-None-Match: * + + The result of a request having both an If-None-Match header field and + either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.27 If-Range + + If a client has a partial copy of an entity in its cache, and wishes + to have an up-to-date copy of the entire entity in its cache, it + could use the Range request-header with a conditional GET (using + either or both of If-Unmodified-Since and If-Match.) However, if the + condition fails because the entity has been modified, the client + would then have to make a second request to obtain the entire current + entity-body. + + The If-Range header allows a client to "short-circuit" the second + request. Informally, its meaning is `if the entity is unchanged, send + me the part(s) that I am missing; otherwise, send me the entire new + entity'. + + If-Range = "If-Range" ":" ( entity-tag | HTTP-date ) + + + + +Fielding, et al. Standards Track [Page 133] + +RFC 2616 HTTP/1.1 June 1999 + + + If the client has no entity tag for an entity, but does have a Last- + Modified date, it MAY use that date in an If-Range header. (The + server can distinguish between a valid HTTP-date and any form of + entity-tag by examining no more than two characters.) The If-Range + header SHOULD only be used together with a Range header, and MUST be + ignored if the request does not include a Range header, or if the + server does not support the sub-range operation. + + If the entity tag given in the If-Range header matches the current + entity tag for the entity, then the server SHOULD provide the + specified sub-range of the entity using a 206 (Partial content) + response. If the entity tag does not match, then the server SHOULD + return the entire entity using a 200 (OK) response. + +14.28 If-Unmodified-Since + + The If-Unmodified-Since request-header field is used with a method to + make it conditional. If the requested resource has not been modified + since the time specified in this field, the server SHOULD perform the + requested operation as if the If-Unmodified-Since header were not + present. + + If the requested variant has been modified since the specified time, + the server MUST NOT perform the requested operation, and MUST return + a 412 (Precondition Failed). + + If-Unmodified-Since = "If-Unmodified-Since" ":" HTTP-date + + An example of the field is: + + If-Unmodified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + If the request normally (i.e., without the If-Unmodified-Since + header) would result in anything other than a 2xx or 412 status, the + If-Unmodified-Since header SHOULD be ignored. + + If the specified date is invalid, the header is ignored. + + The result of a request having both an If-Unmodified-Since header + field and either an If-None-Match or an If-Modified-Since header + fields is undefined by this specification. + +14.29 Last-Modified + + The Last-Modified entity-header field indicates the date and time at + which the origin server believes the variant was last modified. + + Last-Modified = "Last-Modified" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 134] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of its use is + + Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT + + The exact meaning of this header field depends on the implementation + of the origin server and the nature of the original resource. For + files, it may be just the file system last-modified time. For + entities with dynamically included parts, it may be the most recent + of the set of last-modify times for its component parts. For database + gateways, it may be the last-update time stamp of the record. For + virtual objects, it may be the last time the internal state changed. + + An origin server MUST NOT send a Last-Modified date which is later + than the server's time of message origination. In such cases, where + the resource's last modification would indicate some time in the + future, the server MUST replace that date with the message + origination date. + + An origin server SHOULD obtain the Last-Modified value of the entity + as close as possible to the time that it generates the Date value of + its response. This allows a recipient to make an accurate assessment + of the entity's modification time, especially if the entity changes + near the time that the response is generated. + + HTTP/1.1 servers SHOULD send Last-Modified whenever feasible. + +14.30 Location + + The Location response-header field is used to redirect the recipient + to a location other than the Request-URI for completion of the + request or identification of a new resource. For 201 (Created) + responses, the Location is that of the new resource which was created + by the request. For 3xx responses, the location SHOULD indicate the + server's preferred URI for automatic redirection to the resource. The + field value consists of a single absolute URI. + + Location = "Location" ":" absoluteURI + + An example is: + + Location: http://www.w3.org/pub/WWW/People.html + + Note: The Content-Location header field (section 14.14) differs + from Location in that the Content-Location identifies the original + location of the entity enclosed in the request. It is therefore + possible for a response to contain header fields for both Location + and Content-Location. Also see section 13.10 for cache + requirements of some methods. + + + +Fielding, et al. Standards Track [Page 135] + +RFC 2616 HTTP/1.1 June 1999 + + +14.31 Max-Forwards + + The Max-Forwards request-header field provides a mechanism with the + TRACE (section 9.8) and OPTIONS (section 9.2) methods to limit the + number of proxies or gateways that can forward the request to the + next inbound server. This can be useful when the client is attempting + to trace a request chain which appears to be failing or looping in + mid-chain. + + Max-Forwards = "Max-Forwards" ":" 1*DIGIT + + The Max-Forwards value is a decimal integer indicating the remaining + number of times this request message may be forwarded. + + Each proxy or gateway recipient of a TRACE or OPTIONS request + containing a Max-Forwards header field MUST check and update its + value prior to forwarding the request. If the received value is zero + (0), the recipient MUST NOT forward the request; instead, it MUST + respond as the final recipient. If the received Max-Forwards value is + greater than zero, then the forwarded message MUST contain an updated + Max-Forwards field with a value decremented by one (1). + + The Max-Forwards header field MAY be ignored for all other methods + defined by this specification and for any extension methods for which + it is not explicitly referred to as part of that method definition. + +14.32 Pragma + + The Pragma general-header field is used to include implementation- + specific directives that might apply to any recipient along the + request/response chain. All pragma directives specify optional + behavior from the viewpoint of the protocol; however, some systems + MAY require that behavior be consistent with the directives. + + Pragma = "Pragma" ":" 1#pragma-directive + pragma-directive = "no-cache" | extension-pragma + extension-pragma = token [ "=" ( token | quoted-string ) ] + + When the no-cache directive is present in a request message, an + application SHOULD forward the request toward the origin server even + if it has a cached copy of what is being requested. This pragma + directive has the same semantics as the no-cache cache-directive (see + section 14.9) and is defined here for backward compatibility with + HTTP/1.0. Clients SHOULD include both header fields when a no-cache + request is sent to a server not known to be HTTP/1.1 compliant. + + + + + + +Fielding, et al. Standards Track [Page 136] + +RFC 2616 HTTP/1.1 June 1999 + + + Pragma directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a pragma for a + specific recipient; however, any pragma directive not relevant to a + recipient SHOULD be ignored by that recipient. + + HTTP/1.1 caches SHOULD treat "Pragma: no-cache" as if the client had + sent "Cache-Control: no-cache". No new Pragma directives will be + defined in HTTP. + + Note: because the meaning of "Pragma: no-cache as a response + header field is not actually specified, it does not provide a + reliable replacement for "Cache-Control: no-cache" in a response + +14.33 Proxy-Authenticate + + The Proxy-Authenticate response-header field MUST be included as part + of a 407 (Proxy Authentication Required) response. The field value + consists of a challenge that indicates the authentication scheme and + parameters applicable to the proxy for this Request-URI. + + Proxy-Authenticate = "Proxy-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. Unlike + WWW-Authenticate, the Proxy-Authenticate header field applies only to + the current connection and SHOULD NOT be passed on to downstream + clients. However, an intermediate proxy might need to obtain its own + credentials by requesting them from the downstream client, which in + some circumstances will appear as if the proxy is forwarding the + Proxy-Authenticate header field. + +14.34 Proxy-Authorization + + The Proxy-Authorization request-header field allows the client to + identify itself (or its user) to a proxy which requires + authentication. The Proxy-Authorization field value consists of + credentials containing the authentication information of the user + agent for the proxy and/or realm of the resource being requested. + + Proxy-Authorization = "Proxy-Authorization" ":" credentials + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43] . Unlike + Authorization, the Proxy-Authorization header field applies only to + the next outbound proxy that demanded authentication using the Proxy- + Authenticate field. When multiple proxies are used in a chain, the + + + +Fielding, et al. Standards Track [Page 137] + +RFC 2616 HTTP/1.1 June 1999 + + + Proxy-Authorization header field is consumed by the first outbound + proxy that was expecting to receive credentials. A proxy MAY relay + the credentials from the client request to the next proxy if that is + the mechanism by which the proxies cooperatively authenticate a given + request. + +14.35 Range + +14.35.1 Byte Ranges + + Since all HTTP entities are represented in HTTP messages as sequences + of bytes, the concept of a byte range is meaningful for any HTTP + entity. (However, not all clients and servers need to support byte- + range operations.) + + Byte range specifications in HTTP apply to the sequence of bytes in + the entity-body (not necessarily the same as the message-body). + + A byte range operation MAY specify a single range of bytes, or a set + of ranges within a single entity. + + ranges-specifier = byte-ranges-specifier + byte-ranges-specifier = bytes-unit "=" byte-range-set + byte-range-set = 1#( byte-range-spec | suffix-byte-range-spec ) + byte-range-spec = first-byte-pos "-" [last-byte-pos] + first-byte-pos = 1*DIGIT + last-byte-pos = 1*DIGIT + + The first-byte-pos value in a byte-range-spec gives the byte-offset + of the first byte in a range. The last-byte-pos value gives the + byte-offset of the last byte in the range; that is, the byte + positions specified are inclusive. Byte offsets start at zero. + + If the last-byte-pos value is present, it MUST be greater than or + equal to the first-byte-pos in that byte-range-spec, or the byte- + range-spec is syntactically invalid. The recipient of a byte-range- + set that includes one or more syntactically invalid byte-range-spec + values MUST ignore the header field that includes that byte-range- + set. + + If the last-byte-pos value is absent, or if the value is greater than + or equal to the current length of the entity-body, last-byte-pos is + taken to be equal to one less than the current length of the entity- + body in bytes. + + By its choice of last-byte-pos, a client can limit the number of + bytes retrieved without knowing the size of the entity. + + + + +Fielding, et al. Standards Track [Page 138] + +RFC 2616 HTTP/1.1 June 1999 + + + suffix-byte-range-spec = "-" suffix-length + suffix-length = 1*DIGIT + + A suffix-byte-range-spec is used to specify the suffix of the + entity-body, of a length given by the suffix-length value. (That is, + this form specifies the last N bytes of an entity-body.) If the + entity is shorter than the specified suffix-length, the entire + entity-body is used. + + If a syntactically valid byte-range-set includes at least one byte- + range-spec whose first-byte-pos is less than the current length of + the entity-body, or at least one suffix-byte-range-spec with a non- + zero suffix-length, then the byte-range-set is satisfiable. + Otherwise, the byte-range-set is unsatisfiable. If the byte-range-set + is unsatisfiable, the server SHOULD return a response with a status + of 416 (Requested range not satisfiable). Otherwise, the server + SHOULD return a response with a status of 206 (Partial Content) + containing the satisfiable ranges of the entity-body. + + Examples of byte-ranges-specifier values (assuming an entity-body of + length 10000): + + - The first 500 bytes (byte offsets 0-499, inclusive): bytes=0- + 499 + + - The second 500 bytes (byte offsets 500-999, inclusive): + bytes=500-999 + + - The final 500 bytes (byte offsets 9500-9999, inclusive): + bytes=-500 + + - Or bytes=9500- + + - The first and last bytes only (bytes 0 and 9999): bytes=0-0,-1 + + - Several legal but not canonical specifications of the second 500 + bytes (byte offsets 500-999, inclusive): + bytes=500-600,601-999 + bytes=500-700,601-999 + +14.35.2 Range Retrieval Requests + + HTTP retrieval requests using conditional or unconditional GET + methods MAY request one or more sub-ranges of the entity, instead of + the entire entity, using the Range request header, which applies to + the entity returned as the result of the request: + + Range = "Range" ":" ranges-specifier + + + +Fielding, et al. Standards Track [Page 139] + +RFC 2616 HTTP/1.1 June 1999 + + + A server MAY ignore the Range header. However, HTTP/1.1 origin + servers and intermediate caches ought to support byte ranges when + possible, since Range supports efficient recovery from partially + failed transfers, and supports efficient partial retrieval of large + entities. + + If the server supports the Range header and the specified range or + ranges are appropriate for the entity: + + - The presence of a Range header in an unconditional GET modifies + what is returned if the GET is otherwise successful. In other + words, the response carries a status code of 206 (Partial + Content) instead of 200 (OK). + + - The presence of a Range header in a conditional GET (a request + using one or both of If-Modified-Since and If-None-Match, or + one or both of If-Unmodified-Since and If-Match) modifies what + is returned if the GET is otherwise successful and the + condition is true. It does not affect the 304 (Not Modified) + response returned if the conditional is false. + + In some cases, it might be more appropriate to use the If-Range + header (see section 14.27) in addition to the Range header. + + If a proxy that supports ranges receives a Range request, forwards + the request to an inbound server, and receives an entire entity in + reply, it SHOULD only return the requested range to its client. It + SHOULD store the entire received response in its cache if that is + consistent with its cache allocation policies. + +14.36 Referer + + The Referer[sic] request-header field allows the client to specify, + for the server's benefit, the address (URI) of the resource from + which the Request-URI was obtained (the "referrer", although the + header field is misspelled.) The Referer request-header allows a + server to generate lists of back-links to resources for interest, + logging, optimized caching, etc. It also allows obsolete or mistyped + links to be traced for maintenance. The Referer field MUST NOT be + sent if the Request-URI was obtained from a source that does not have + its own URI, such as input from the user keyboard. + + Referer = "Referer" ":" ( absoluteURI | relativeURI ) + + Example: + + Referer: http://www.w3.org/hypertext/DataSources/Overview.html + + + + +Fielding, et al. Standards Track [Page 140] + +RFC 2616 HTTP/1.1 June 1999 + + + If the field value is a relative URI, it SHOULD be interpreted + relative to the Request-URI. The URI MUST NOT include a fragment. See + section 15.1.3 for security considerations. + +14.37 Retry-After + + The Retry-After response-header field can be used with a 503 (Service + Unavailable) response to indicate how long the service is expected to + be unavailable to the requesting client. This field MAY also be used + with any 3xx (Redirection) response to indicate the minimum time the + user-agent is asked wait before issuing the redirected request. The + value of this field can be either an HTTP-date or an integer number + of seconds (in decimal) after the time of the response. + + Retry-After = "Retry-After" ":" ( HTTP-date | delta-seconds ) + + Two examples of its use are + + Retry-After: Fri, 31 Dec 1999 23:59:59 GMT + Retry-After: 120 + + In the latter example, the delay is 2 minutes. + +14.38 Server + + The Server response-header field contains information about the + software used by the origin server to handle the request. The field + can contain multiple product tokens (section 3.8) and comments + identifying the server and any significant subproducts. The product + tokens are listed in order of their significance for identifying the + application. + + Server = "Server" ":" 1*( product | comment ) + + Example: + + Server: CERN/3.0 libwww/2.17 + + If the response is being forwarded through a proxy, the proxy + application MUST NOT modify the Server response-header. Instead, it + SHOULD include a Via field (as described in section 14.45). + + Note: Revealing the specific software version of the server might + allow the server machine to become more vulnerable to attacks + against software that is known to contain security holes. Server + implementors are encouraged to make this field a configurable + option. + + + + +Fielding, et al. Standards Track [Page 141] + +RFC 2616 HTTP/1.1 June 1999 + + +14.39 TE + + The TE request-header field indicates what extension transfer-codings + it is willing to accept in the response and whether or not it is + willing to accept trailer fields in a chunked transfer-coding. Its + value may consist of the keyword "trailers" and/or a comma-separated + list of extension transfer-coding names with optional accept + parameters (as described in section 3.6). + + TE = "TE" ":" #( t-codings ) + t-codings = "trailers" | ( transfer-extension [ accept-params ] ) + + The presence of the keyword "trailers" indicates that the client is + willing to accept trailer fields in a chunked transfer-coding, as + defined in section 3.6.1. This keyword is reserved for use with + transfer-coding values even though it does not itself represent a + transfer-coding. + + Examples of its use are: + + TE: deflate + TE: + TE: trailers, deflate;q=0.5 + + The TE header field only applies to the immediate connection. + Therefore, the keyword MUST be supplied within a Connection header + field (section 14.10) whenever TE is present in an HTTP/1.1 message. + + A server tests whether a transfer-coding is acceptable, according to + a TE field, using these rules: + + 1. The "chunked" transfer-coding is always acceptable. If the + keyword "trailers" is listed, the client indicates that it is + willing to accept trailer fields in the chunked response on + behalf of itself and any downstream clients. The implication is + that, if given, the client is stating that either all + downstream clients are willing to accept trailer fields in the + forwarded response, or that it will attempt to buffer the + response on behalf of downstream recipients. + + Note: HTTP/1.1 does not define any means to limit the size of a + chunked response such that a client can be assured of buffering + the entire response. + + 2. If the transfer-coding being tested is one of the transfer- + codings listed in the TE field, then it is acceptable unless it + is accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + + +Fielding, et al. Standards Track [Page 142] + +RFC 2616 HTTP/1.1 June 1999 + + + 3. If multiple transfer-codings are acceptable, then the + acceptable transfer-coding with the highest non-zero qvalue is + preferred. The "chunked" transfer-coding always has a qvalue + of 1. + + If the TE field-value is empty or if no TE field is present, the only + transfer-coding is "chunked". A message with no transfer-coding is + always acceptable. + +14.40 Trailer + + The Trailer general field value indicates that the given set of + header fields is present in the trailer of a message encoded with + chunked transfer-coding. + + Trailer = "Trailer" ":" 1#field-name + + An HTTP/1.1 message SHOULD include a Trailer header field in a + message using chunked transfer-coding with a non-empty trailer. Doing + so allows the recipient to know which header fields to expect in the + trailer. + + If no Trailer header field is present, the trailer SHOULD NOT include + any header fields. See section 3.6.1 for restrictions on the use of + trailer fields in a "chunked" transfer-coding. + + Message header fields listed in the Trailer header field MUST NOT + include the following header fields: + + . Transfer-Encoding + + . Content-Length + + . Trailer + +14.41 Transfer-Encoding + + The Transfer-Encoding general-header field indicates what (if any) + type of transformation has been applied to the message body in order + to safely transfer it between the sender and the recipient. This + differs from the content-coding in that the transfer-coding is a + property of the message, not of the entity. + + Transfer-Encoding = "Transfer-Encoding" ":" 1#transfer-coding + + Transfer-codings are defined in section 3.6. An example is: + + Transfer-Encoding: chunked + + + +Fielding, et al. Standards Track [Page 143] + +RFC 2616 HTTP/1.1 June 1999 + + + If multiple encodings have been applied to an entity, the transfer- + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + + Many older HTTP/1.0 applications do not understand the Transfer- + Encoding header. + +14.42 Upgrade + + The Upgrade general-header allows the client to specify what + additional communication protocols it supports and would like to use + if the server finds it appropriate to switch protocols. The server + MUST use the Upgrade header field within a 101 (Switching Protocols) + response to indicate which protocol(s) are being switched. + + Upgrade = "Upgrade" ":" 1#product + + For example, + + Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11 + + The Upgrade header field is intended to provide a simple mechanism + for transition from HTTP/1.1 to some other, incompatible protocol. It + does so by allowing the client to advertise its desire to use another + protocol, such as a later version of HTTP with a higher major version + number, even though the current request has been made using HTTP/1.1. + This eases the difficult transition between incompatible protocols by + allowing the client to initiate a request in the more commonly + supported protocol while indicating to the server that it would like + to use a "better" protocol if available (where "better" is determined + by the server, possibly according to the nature of the method and/or + resource being requested). + + The Upgrade header field only applies to switching application-layer + protocols upon the existing transport-layer connection. Upgrade + cannot be used to insist on a protocol change; its acceptance and use + by the server is optional. The capabilities and nature of the + application-layer communication after the protocol change is entirely + dependent upon the new protocol chosen, although the first action + after changing the protocol MUST be a response to the initial HTTP + request containing the Upgrade header field. + + The Upgrade header field only applies to the immediate connection. + Therefore, the upgrade keyword MUST be supplied within a Connection + header field (section 14.10) whenever Upgrade is present in an + HTTP/1.1 message. + + + + +Fielding, et al. Standards Track [Page 144] + +RFC 2616 HTTP/1.1 June 1999 + + + The Upgrade header field cannot be used to indicate a switch to a + protocol on a different connection. For that purpose, it is more + appropriate to use a 301, 302, 303, or 305 redirection response. + + This specification only defines the protocol name "HTTP" for use by + the family of Hypertext Transfer Protocols, as defined by the HTTP + version rules of section 3.1 and future updates to this + specification. Any token can be used as a protocol name; however, it + will only be useful if both the client and server associate the name + with the same protocol. + +14.43 User-Agent + + The User-Agent request-header field contains information about the + user agent originating the request. This is for statistical purposes, + the tracing of protocol violations, and automated recognition of user + agents for the sake of tailoring responses to avoid particular user + agent limitations. User agents SHOULD include this field with + requests. The field can contain multiple product tokens (section 3.8) + and comments identifying the agent and any subproducts which form a + significant part of the user agent. By convention, the product tokens + are listed in order of their significance for identifying the + application. + + User-Agent = "User-Agent" ":" 1*( product | comment ) + + Example: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + +14.44 Vary + + The Vary field value indicates the set of request-header fields that + fully determines, while the response is fresh, whether a cache is + permitted to use the response to reply to a subsequent request + without revalidation. For uncacheable or stale responses, the Vary + field value advises the user agent about the criteria that were used + to select the representation. A Vary field value of "*" implies that + a cache cannot determine from the request headers of a subsequent + request whether this response is the appropriate representation. See + section 13.6 for use of the Vary header field by caches. + + Vary = "Vary" ":" ( "*" | 1#field-name ) + + An HTTP/1.1 server SHOULD include a Vary header field with any + cacheable response that is subject to server-driven negotiation. + Doing so allows a cache to properly interpret future requests on that + resource and informs the user agent about the presence of negotiation + + + +Fielding, et al. Standards Track [Page 145] + +RFC 2616 HTTP/1.1 June 1999 + + + on that resource. A server MAY include a Vary header field with a + non-cacheable response that is subject to server-driven negotiation, + since this might provide the user agent with useful information about + the dimensions over which the response varies at the time of the + response. + + A Vary field value consisting of a list of field-names signals that + the representation selected for the response is based on a selection + algorithm which considers ONLY the listed request-header field values + in selecting the most appropriate representation. A cache MAY assume + that the same selection will be made for future requests with the + same values for the listed field names, for the duration of time for + which the response is fresh. + + The field-names given are not limited to the set of standard + request-header fields defined by this specification. Field names are + case-insensitive. + + A Vary field value of "*" signals that unspecified parameters not + limited to the request-headers (e.g., the network address of the + client), play a role in the selection of the response representation. + The "*" value MUST NOT be generated by a proxy server; it may only be + generated by an origin server. + +14.45 Via + + The Via general-header field MUST be used by gateways and proxies to + indicate the intermediate protocols and recipients between the user + agent and the server on requests, and between the origin server and + the client on responses. It is analogous to the "Received" field of + RFC 822 [9] and is intended to be used for tracking message forwards, + avoiding request loops, and identifying the protocol capabilities of + all senders along the request/response chain. + + Via = "Via" ":" 1#( received-protocol received-by [ comment ] ) + received-protocol = [ protocol-name "/" ] protocol-version + protocol-name = token + protocol-version = token + received-by = ( host [ ":" port ] ) | pseudonym + pseudonym = token + + The received-protocol indicates the protocol version of the message + received by the server or client along each segment of the + request/response chain. The received-protocol version is appended to + the Via field value when the message is forwarded so that information + about the protocol capabilities of upstream applications remains + visible to all recipients. + + + + +Fielding, et al. Standards Track [Page 146] + +RFC 2616 HTTP/1.1 June 1999 + + + The protocol-name is optional if and only if it would be "HTTP". The + received-by field is normally the host and optional port number of a + recipient server or client that subsequently forwarded the message. + However, if the real host is considered to be sensitive information, + it MAY be replaced by a pseudonym. If the port is not given, it MAY + be assumed to be the default port of the received-protocol. + + Multiple Via field values represents each proxy or gateway that has + forwarded the message. Each recipient MUST append its information + such that the end result is ordered according to the sequence of + forwarding applications. + + Comments MAY be used in the Via header field to identify the software + of the recipient proxy or gateway, analogous to the User-Agent and + Server header fields. However, all comments in the Via field are + optional and MAY be removed by any recipient prior to forwarding the + message. + + For example, a request message could be sent from an HTTP/1.0 user + agent to an internal proxy code-named "fred", which uses HTTP/1.1 to + forward the request to a public proxy at nowhere.com, which completes + the request by forwarding it to the origin server at www.ics.uci.edu. + The request received by www.ics.uci.edu would then have the following + Via header field: + + Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1) + + Proxies and gateways used as a portal through a network firewall + SHOULD NOT, by default, forward the names and ports of hosts within + the firewall region. This information SHOULD only be propagated if + explicitly enabled. If not enabled, the received-by host of any host + behind the firewall SHOULD be replaced by an appropriate pseudonym + for that host. + + For organizations that have strong privacy requirements for hiding + internal structures, a proxy MAY combine an ordered subsequence of + Via header field entries with identical received-protocol values into + a single such entry. For example, + + Via: 1.0 ricky, 1.1 ethel, 1.1 fred, 1.0 lucy + + could be collapsed to + + Via: 1.0 ricky, 1.1 mertz, 1.0 lucy + + + + + + + +Fielding, et al. Standards Track [Page 147] + +RFC 2616 HTTP/1.1 June 1999 + + + Applications SHOULD NOT combine multiple entries unless they are all + under the same organizational control and the hosts have already been + replaced by pseudonyms. Applications MUST NOT combine entries which + have different received-protocol values. + +14.46 Warning + + The Warning general-header field is used to carry additional + information about the status or transformation of a message which + might not be reflected in the message. This information is typically + used to warn about a possible lack of semantic transparency from + caching operations or transformations applied to the entity body of + the message. + + Warning headers are sent with responses using: + + Warning = "Warning" ":" 1#warning-value + + warning-value = warn-code SP warn-agent SP warn-text + [SP warn-date] + + warn-code = 3DIGIT + warn-agent = ( host [ ":" port ] ) | pseudonym + ; the name or pseudonym of the server adding + ; the Warning header, for use in debugging + warn-text = quoted-string + warn-date = <"> HTTP-date <"> + + A response MAY carry more than one Warning header. + + The warn-text SHOULD be in a natural language and character set that + is most likely to be intelligible to the human user receiving the + response. This decision MAY be based on any available knowledge, such + as the location of the cache or user, the Accept-Language field in a + request, the Content-Language field in a response, etc. The default + language is English and the default character set is ISO-8859-1. + + If a character set other than ISO-8859-1 is used, it MUST be encoded + in the warn-text using the method described in RFC 2047 [14]. + + Warning headers can in general be applied to any message, however + some specific warn-codes are specific to caches and can only be + applied to response messages. New Warning headers SHOULD be added + after any existing Warning headers. A cache MUST NOT delete any + Warning header that it received with a message. However, if a cache + successfully validates a cache entry, it SHOULD remove any Warning + headers previously attached to that entry except as specified for + + + + +Fielding, et al. Standards Track [Page 148] + +RFC 2616 HTTP/1.1 June 1999 + + + specific Warning codes. It MUST then add any Warning headers received + in the validating response. In other words, Warning headers are those + that would be attached to the most recent relevant response. + + When multiple Warning headers are attached to a response, the user + agent ought to inform the user of as many of them as possible, in the + order that they appear in the response. If it is not possible to + inform the user of all of the warnings, the user agent SHOULD follow + these heuristics: + + - Warnings that appear early in the response take priority over + those appearing later in the response. + + - Warnings in the user's preferred character set take priority + over warnings in other character sets but with identical warn- + codes and warn-agents. + + Systems that generate multiple Warning headers SHOULD order them with + this user agent behavior in mind. + + Requirements for the behavior of caches with respect to Warnings are + stated in section 13.1.2. + + This is a list of the currently-defined warn-codes, each with a + recommended warn-text in English, and a description of its meaning. + + 110 Response is stale + MUST be included whenever the returned response is stale. + + 111 Revalidation failed + MUST be included if a cache returns a stale response because an + attempt to revalidate the response failed, due to an inability to + reach the server. + + 112 Disconnected operation + SHOULD be included if the cache is intentionally disconnected from + the rest of the network for a period of time. + + 113 Heuristic expiration + MUST be included if the cache heuristically chose a freshness + lifetime greater than 24 hours and the response's age is greater + than 24 hours. + + 199 Miscellaneous warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action, besides presenting the warning to + the user. + + + +Fielding, et al. Standards Track [Page 149] + +RFC 2616 HTTP/1.1 June 1999 + + + 214 Transformation applied + MUST be added by an intermediate cache or proxy if it applies any + transformation changing the content-coding (as specified in the + Content-Encoding header) or media-type (as specified in the + Content-Type header) of the response, or the entity-body of the + response, unless this Warning code already appears in the response. + + 299 Miscellaneous persistent warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action. + + If an implementation sends a message with one or more Warning headers + whose version is HTTP/1.0 or lower, then the sender MUST include in + each warning-value a warn-date that matches the date in the response. + + If an implementation receives a message with a warning-value that + includes a warn-date, and that warn-date is different from the Date + value in the response, then that warning-value MUST be deleted from + the message before storing, forwarding, or using it. (This prevents + bad consequences of naive caching of Warning header fields.) If all + of the warning-values are deleted for this reason, the Warning header + MUST be deleted as well. + +14.47 WWW-Authenticate + + The WWW-Authenticate response-header field MUST be included in 401 + (Unauthorized) response messages. The field value consists of at + least one challenge that indicates the authentication scheme(s) and + parameters applicable to the Request-URI. + + WWW-Authenticate = "WWW-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. User + agents are advised to take special care in parsing the WWW- + Authenticate field value as it might contain more than one challenge, + or if more than one WWW-Authenticate header field is provided, the + contents of a challenge itself can contain a comma-separated list of + authentication parameters. + +15 Security Considerations + + This section is meant to inform application developers, information + providers, and users of the security limitations in HTTP/1.1 as + described by this document. The discussion does not include + definitive solutions to the problems revealed, though it does make + some suggestions for reducing security risks. + + + +Fielding, et al. Standards Track [Page 150] + +RFC 2616 HTTP/1.1 June 1999 + + +15.1 Personal Information + + HTTP clients are often privy to large amounts of personal information + (e.g. the user's name, location, mail address, passwords, encryption + keys, etc.), and SHOULD be very careful to prevent unintentional + leakage of this information via the HTTP protocol to other sources. + We very strongly recommend that a convenient interface be provided + for the user to control dissemination of such information, and that + designers and implementors be particularly careful in this area. + History shows that errors in this area often create serious security + and/or privacy problems and generate highly adverse publicity for the + implementor's company. + +15.1.1 Abuse of Server Log Information + + A server is in the position to save personal data about a user's + requests which might identify their reading patterns or subjects of + interest. This information is clearly confidential in nature and its + handling can be constrained by law in certain countries. People using + the HTTP protocol to provide data are responsible for ensuring that + such material is not distributed without the permission of any + individuals that are identifiable by the published results. + +15.1.2 Transfer of Sensitive Information + + Like any generic data transfer protocol, HTTP cannot regulate the + content of the data that is transferred, nor is there any a priori + method of determining the sensitivity of any particular piece of + information within the context of any given request. Therefore, + applications SHOULD supply as much control over this information as + possible to the provider of that information. Four header fields are + worth special mention in this context: Server, Via, Referer and From. + + Revealing the specific software version of the server might allow the + server machine to become more vulnerable to attacks against software + that is known to contain security holes. Implementors SHOULD make the + Server header field a configurable option. + + Proxies which serve as a portal through a network firewall SHOULD + take special precautions regarding the transfer of header information + that identifies the hosts behind the firewall. In particular, they + SHOULD remove, or replace with sanitized versions, any Via fields + generated behind the firewall. + + The Referer header allows reading patterns to be studied and reverse + links drawn. Although it can be very useful, its power can be abused + if user details are not separated from the information contained in + + + + +Fielding, et al. Standards Track [Page 151] + +RFC 2616 HTTP/1.1 June 1999 + + + the Referer. Even when the personal information has been removed, the + Referer header might indicate a private document's URI whose + publication would be inappropriate. + + The information sent in the From field might conflict with the user's + privacy interests or their site's security policy, and hence it + SHOULD NOT be transmitted without the user being able to disable, + enable, and modify the contents of the field. The user MUST be able + to set the contents of this field within a user preference or + application defaults configuration. + + We suggest, though do not require, that a convenient toggle interface + be provided for the user to enable or disable the sending of From and + Referer information. + + The User-Agent (section 14.43) or Server (section 14.38) header + fields can sometimes be used to determine that a specific client or + server have a particular security hole which might be exploited. + Unfortunately, this same information is often used for other valuable + purposes for which HTTP currently has no better mechanism. + +15.1.3 Encoding Sensitive Information in URI's + + Because the source of a link might be private information or might + reveal an otherwise private information source, it is strongly + recommended that the user be able to select whether or not the + Referer field is sent. For example, a browser client could have a + toggle switch for browsing openly/anonymously, which would + respectively enable/disable the sending of Referer and From + information. + + Clients SHOULD NOT include a Referer header field in a (non-secure) + HTTP request if the referring page was transferred with a secure + protocol. + + Authors of services which use the HTTP protocol SHOULD NOT use GET + based forms for the submission of sensitive data, because this will + cause this data to be encoded in the Request-URI. Many existing + servers, proxies, and user agents will log the request URI in some + place where it might be visible to third parties. Servers can use + POST-based form submission instead + +15.1.4 Privacy Issues Connected to Accept Headers + + Accept request-headers can reveal information about the user to all + servers which are accessed. The Accept-Language header in particular + can reveal information the user would consider to be of a private + nature, because the understanding of particular languages is often + + + +Fielding, et al. Standards Track [Page 152] + +RFC 2616 HTTP/1.1 June 1999 + + + strongly correlated to the membership of a particular ethnic group. + User agents which offer the option to configure the contents of an + Accept-Language header to be sent in every request are strongly + encouraged to let the configuration process include a message which + makes the user aware of the loss of privacy involved. + + An approach that limits the loss of privacy would be for a user agent + to omit the sending of Accept-Language headers by default, and to ask + the user whether or not to start sending Accept-Language headers to a + server if it detects, by looking for any Vary response-header fields + generated by the server, that such sending could improve the quality + of service. + + Elaborate user-customized accept header fields sent in every request, + in particular if these include quality values, can be used by servers + as relatively reliable and long-lived user identifiers. Such user + identifiers would allow content providers to do click-trail tracking, + and would allow collaborating content providers to match cross-server + click-trails or form submissions of individual users. Note that for + many users not behind a proxy, the network address of the host + running the user agent will also serve as a long-lived user + identifier. In environments where proxies are used to enhance + privacy, user agents ought to be conservative in offering accept + header configuration options to end users. As an extreme privacy + measure, proxies could filter the accept headers in relayed requests. + General purpose user agents which provide a high degree of header + configurability SHOULD warn users about the loss of privacy which can + be involved. + +15.2 Attacks Based On File and Path Names + + Implementations of HTTP origin servers SHOULD be careful to restrict + the documents returned by HTTP requests to be only those that were + intended by the server administrators. If an HTTP server translates + HTTP URIs directly into file system calls, the server MUST take + special care not to serve files that were not intended to be + delivered to HTTP clients. For example, UNIX, Microsoft Windows, and + other operating systems use ".." as a path component to indicate a + directory level above the current one. On such a system, an HTTP + server MUST disallow any such construct in the Request-URI if it + would otherwise allow access to a resource outside those intended to + be accessible via the HTTP server. Similarly, files intended for + reference only internally to the server (such as access control + files, configuration files, and script code) MUST be protected from + inappropriate retrieval, since they might contain sensitive + information. Experience has shown that minor bugs in such HTTP server + implementations have turned into security risks. + + + + +Fielding, et al. Standards Track [Page 153] + +RFC 2616 HTTP/1.1 June 1999 + + +15.3 DNS Spoofing + + Clients using HTTP rely heavily on the Domain Name Service, and are + thus generally prone to security attacks based on the deliberate + mis-association of IP addresses and DNS names. Clients need to be + cautious in assuming the continuing validity of an IP number/DNS name + association. + + In particular, HTTP clients SHOULD rely on their name resolver for + confirmation of an IP number/DNS name association, rather than + caching the result of previous host name lookups. Many platforms + already can cache host name lookups locally when appropriate, and + they SHOULD be configured to do so. It is proper for these lookups to + be cached, however, only when the TTL (Time To Live) information + reported by the name server makes it likely that the cached + information will remain useful. + + If HTTP clients cache the results of host name lookups in order to + achieve a performance improvement, they MUST observe the TTL + information reported by DNS. + + If HTTP clients do not observe this rule, they could be spoofed when + a previously-accessed server's IP address changes. As network + renumbering is expected to become increasingly common [24], the + possibility of this form of attack will grow. Observing this + requirement thus reduces this potential security vulnerability. + + This requirement also improves the load-balancing behavior of clients + for replicated servers using the same DNS name and reduces the + likelihood of a user's experiencing failure in accessing sites which + use that strategy. + +15.4 Location Headers and Spoofing + + If a single server supports multiple organizations that do not trust + one another, then it MUST check the values of Location and Content- + Location headers in responses that are generated under control of + said organizations to make sure that they do not attempt to + invalidate resources over which they have no authority. + +15.5 Content-Disposition Issues + + RFC 1806 [35], from which the often implemented Content-Disposition + (see section 19.5.1) header in HTTP is derived, has a number of very + serious security considerations. Content-Disposition is not part of + the HTTP standard, but since it is widely implemented, we are + documenting its use and risks for implementors. See RFC 2183 [49] + (which updates RFC 1806) for details. + + + +Fielding, et al. Standards Track [Page 154] + +RFC 2616 HTTP/1.1 June 1999 + + +15.6 Authentication Credentials and Idle Clients + + Existing HTTP clients and user agents typically retain authentication + information indefinitely. HTTP/1.1. does not provide a method for a + server to direct clients to discard these cached credentials. This is + a significant defect that requires further extensions to HTTP. + Circumstances under which credential caching can interfere with the + application's security model include but are not limited to: + + - Clients which have been idle for an extended period following + which the server might wish to cause the client to reprompt the + user for credentials. + + - Applications which include a session termination indication + (such as a `logout' or `commit' button on a page) after which + the server side of the application `knows' that there is no + further reason for the client to retain the credentials. + + This is currently under separate study. There are a number of work- + arounds to parts of this problem, and we encourage the use of + password protection in screen savers, idle time-outs, and other + methods which mitigate the security problems inherent in this + problem. In particular, user agents which cache credentials are + encouraged to provide a readily accessible mechanism for discarding + cached credentials under user control. + +15.7 Proxies and Caching + + By their very nature, HTTP proxies are men-in-the-middle, and + represent an opportunity for man-in-the-middle attacks. Compromise of + the systems on which the proxies run can result in serious security + and privacy problems. Proxies have access to security-related + information, personal information about individual users and + organizations, and proprietary information belonging to users and + content providers. A compromised proxy, or a proxy implemented or + configured without regard to security and privacy considerations, + might be used in the commission of a wide range of potential attacks. + + Proxy operators should protect the systems on which proxies run as + they would protect any system that contains or transports sensitive + information. In particular, log information gathered at proxies often + contains highly sensitive personal information, and/or information + about organizations. Log information should be carefully guarded, and + appropriate guidelines for use developed and followed. (Section + 15.1.1). + + + + + + +Fielding, et al. Standards Track [Page 155] + +RFC 2616 HTTP/1.1 June 1999 + + + Caching proxies provide additional potential vulnerabilities, since + the contents of the cache represent an attractive target for + malicious exploitation. Because cache contents persist after an HTTP + request is complete, an attack on the cache can reveal information + long after a user believes that the information has been removed from + the network. Therefore, cache contents should be protected as + sensitive information. + + Proxy implementors should consider the privacy and security + implications of their design and coding decisions, and of the + configuration options they provide to proxy operators (especially the + default configuration). + + Users of a proxy need to be aware that they are no trustworthier than + the people who run the proxy; HTTP itself cannot solve this problem. + + The judicious use of cryptography, when appropriate, may suffice to + protect against a broad range of security and privacy attacks. Such + cryptography is beyond the scope of the HTTP/1.1 specification. + +15.7.1 Denial of Service Attacks on Proxies + + They exist. They are hard to defend against. Research continues. + Beware. + +16 Acknowledgments + + This specification makes heavy use of the augmented BNF and generic + constructs defined by David H. Crocker for RFC 822 [9]. Similarly, it + reuses many of the definitions provided by Nathaniel Borenstein and + Ned Freed for MIME [7]. We hope that their inclusion in this + specification will help reduce past confusion over the relationship + between HTTP and Internet mail message formats. + + The HTTP protocol has evolved considerably over the years. It has + benefited from a large and active developer community--the many + people who have participated on the www-talk mailing list--and it is + that community which has been most responsible for the success of + HTTP and of the World-Wide Web in general. Marc Andreessen, Robert + Cailliau, Daniel W. Connolly, Bob Denny, John Franks, Jean-Francois + Groff, Phillip M. Hallam-Baker, Hakon W. Lie, Ari Luotonen, Rob + McCool, Lou Montulli, Dave Raggett, Tony Sanders, and Marc + VanHeyningen deserve special recognition for their efforts in + defining early aspects of the protocol. + + This document has benefited greatly from the comments of all those + participating in the HTTP-WG. In addition to those already mentioned, + the following individuals have contributed to this specification: + + + +Fielding, et al. Standards Track [Page 156] + +RFC 2616 HTTP/1.1 June 1999 + + + Gary Adams Ross Patterson + Harald Tveit Alvestrand Albert Lunde + Keith Ball John C. Mallery + Brian Behlendorf Jean-Philippe Martin-Flatin + Paul Burchard Mitra + Maurizio Codogno David Morris + Mike Cowlishaw Gavin Nicol + Roman Czyborra Bill Perry + Michael A. Dolan Jeffrey Perry + David J. Fiander Scott Powers + Alan Freier Owen Rees + Marc Hedlund Luigi Rizzo + Greg Herlihy David Robinson + Koen Holtman Marc Salomon + Alex Hopmann Rich Salz + Bob Jernigan Allan M. Schiffman + Shel Kaphan Jim Seidman + Rohit Khare Chuck Shotton + John Klensin Eric W. Sink + Martijn Koster Simon E. Spero + Alexei Kosut Richard N. Taylor + David M. Kristol Robert S. Thau + Daniel LaLiberte Bill (BearHeart) Weinman + Ben Laurie Francois Yergeau + Paul J. Leach Mary Ellen Zurko + Daniel DuBois Josh Cohen + + + Much of the content and presentation of the caching design is due to + suggestions and comments from individuals including: Shel Kaphan, + Paul Leach, Koen Holtman, David Morris, and Larry Masinter. + + Most of the specification of ranges is based on work originally done + by Ari Luotonen and John Franks, with additional input from Steve + Zilles. + + Thanks to the "cave men" of Palo Alto. You know who you are. + + Jim Gettys (the current editor of this document) wishes particularly + to thank Roy Fielding, the previous editor of this document, along + with John Klensin, Jeff Mogul, Paul Leach, Dave Kristol, Koen + Holtman, John Franks, Josh Cohen, Alex Hopmann, Scott Lawrence, and + Larry Masinter for their help. And thanks go particularly to Jeff + Mogul and Scott Lawrence for performing the "MUST/MAY/SHOULD" audit. + + + + + + + +Fielding, et al. Standards Track [Page 157] + +RFC 2616 HTTP/1.1 June 1999 + + + The Apache Group, Anselm Baird-Smith, author of Jigsaw, and Henrik + Frystyk implemented RFC 2068 early, and we wish to thank them for the + discovery of many of the problems that this document attempts to + rectify. + +17 References + + [1] Alvestrand, H., "Tags for the Identification of Languages", RFC + 1766, March 1995. + + [2] Anklesaria, F., McCahill, M., Lindner, P., Johnson, D., Torrey, + D. and B. Alberti, "The Internet Gopher Protocol (a distributed + document search and retrieval protocol)", RFC 1436, March 1993. + + [3] Berners-Lee, T., "Universal Resource Identifiers in WWW", RFC + 1630, June 1994. + + [4] Berners-Lee, T., Masinter, L. and M. McCahill, "Uniform Resource + Locators (URL)", RFC 1738, December 1994. + + [5] Berners-Lee, T. and D. Connolly, "Hypertext Markup Language - + 2.0", RFC 1866, November 1995. + + [6] Berners-Lee, T., Fielding, R. and H. Frystyk, "Hypertext Transfer + Protocol -- HTTP/1.0", RFC 1945, May 1996. + + [7] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part One: Format of Internet Message Bodies", + RFC 2045, November 1996. + + [8] Braden, R., "Requirements for Internet Hosts -- Communication + Layers", STD 3, RFC 1123, October 1989. + + [9] Crocker, D., "Standard for The Format of ARPA Internet Text + Messages", STD 11, RFC 822, August 1982. + + [10] Davis, F., Kahle, B., Morris, H., Salem, J., Shen, T., Wang, R., + Sui, J., and M. Grinbaum, "WAIS Interface Protocol Prototype + Functional Specification," (v1.5), Thinking Machines + Corporation, April 1990. + + [11] Fielding, R., "Relative Uniform Resource Locators", RFC 1808, + June 1995. + + [12] Horton, M. and R. Adams, "Standard for Interchange of USENET + Messages", RFC 1036, December 1987. + + + + + +Fielding, et al. Standards Track [Page 158] + +RFC 2616 HTTP/1.1 June 1999 + + + [13] Kantor, B. and P. Lapsley, "Network News Transfer Protocol", RFC + 977, February 1986. + + [14] Moore, K., "MIME (Multipurpose Internet Mail Extensions) Part + Three: Message Header Extensions for Non-ASCII Text", RFC 2047, + November 1996. + + [15] Nebel, E. and L. Masinter, "Form-based File Upload in HTML", RFC + 1867, November 1995. + + [16] Postel, J., "Simple Mail Transfer Protocol", STD 10, RFC 821, + August 1982. + + [17] Postel, J., "Media Type Registration Procedure", RFC 1590, + November 1996. + + [18] Postel, J. and J. Reynolds, "File Transfer Protocol", STD 9, RFC + 959, October 1985. + + [19] Reynolds, J. and J. Postel, "Assigned Numbers", STD 2, RFC 1700, + October 1994. + + [20] Sollins, K. and L. Masinter, "Functional Requirements for + Uniform Resource Names", RFC 1737, December 1994. + + [21] US-ASCII. Coded Character Set - 7-Bit American Standard Code for + Information Interchange. Standard ANSI X3.4-1986, ANSI, 1986. + + [22] ISO-8859. International Standard -- Information Processing -- + 8-bit Single-Byte Coded Graphic Character Sets -- + Part 1: Latin alphabet No. 1, ISO-8859-1:1987. + Part 2: Latin alphabet No. 2, ISO-8859-2, 1987. + Part 3: Latin alphabet No. 3, ISO-8859-3, 1988. + Part 4: Latin alphabet No. 4, ISO-8859-4, 1988. + Part 5: Latin/Cyrillic alphabet, ISO-8859-5, 1988. + Part 6: Latin/Arabic alphabet, ISO-8859-6, 1987. + Part 7: Latin/Greek alphabet, ISO-8859-7, 1987. + Part 8: Latin/Hebrew alphabet, ISO-8859-8, 1988. + Part 9: Latin alphabet No. 5, ISO-8859-9, 1990. + + [23] Meyers, J. and M. Rose, "The Content-MD5 Header Field", RFC + 1864, October 1995. + + [24] Carpenter, B. and Y. Rekhter, "Renumbering Needs Work", RFC + 1900, February 1996. + + [25] Deutsch, P., "GZIP file format specification version 4.3", RFC + 1952, May 1996. + + + +Fielding, et al. Standards Track [Page 159] + +RFC 2616 HTTP/1.1 June 1999 + + + [26] Venkata N. Padmanabhan, and Jeffrey C. Mogul. "Improving HTTP + Latency", Computer Networks and ISDN Systems, v. 28, pp. 25-35, + Dec. 1995. Slightly revised version of paper in Proc. 2nd + International WWW Conference '94: Mosaic and the Web, Oct. 1994, + which is available at + http://www.ncsa.uiuc.edu/SDG/IT94/Proceedings/DDay/mogul/HTTPLat + ency.html. + + [27] Joe Touch, John Heidemann, and Katia Obraczka. "Analysis of HTTP + Performance", , + ISI Research Report ISI/RR-98-463, (original report dated Aug. + 1996), USC/Information Sciences Institute, August 1998. + + [28] Mills, D., "Network Time Protocol (Version 3) Specification, + Implementation and Analysis", RFC 1305, March 1992. + + [29] Deutsch, P., "DEFLATE Compressed Data Format Specification + version 1.3", RFC 1951, May 1996. + + [30] S. Spero, "Analysis of HTTP Performance Problems," + http://sunsite.unc.edu/mdma-release/http-prob.html. + + [31] Deutsch, P. and J. Gailly, "ZLIB Compressed Data Format + Specification version 3.3", RFC 1950, May 1996. + + [32] Franks, J., Hallam-Baker, P., Hostetler, J., Leach, P., + Luotonen, A., Sink, E. and L. Stewart, "An Extension to HTTP: + Digest Access Authentication", RFC 2069, January 1997. + + [33] Fielding, R., Gettys, J., Mogul, J., Frystyk, H. and T. + Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1", RFC + 2068, January 1997. + + [34] Bradner, S., "Key words for use in RFCs to Indicate Requirement + Levels", BCP 14, RFC 2119, March 1997. + + [35] Troost, R. and Dorner, S., "Communicating Presentation + Information in Internet Messages: The Content-Disposition + Header", RFC 1806, June 1995. + + [36] Mogul, J., Fielding, R., Gettys, J. and H. Frystyk, "Use and + Interpretation of HTTP Version Numbers", RFC 2145, May 1997. + [jg639] + + [37] Palme, J., "Common Internet Message Headers", RFC 2076, February + 1997. [jg640] + + + + + +Fielding, et al. Standards Track [Page 160] + +RFC 2616 HTTP/1.1 June 1999 + + + [38] Yergeau, F., "UTF-8, a transformation format of Unicode and + ISO-10646", RFC 2279, January 1998. [jg641] + + [39] Nielsen, H.F., Gettys, J., Baird-Smith, A., Prud'hommeaux, E., + Lie, H., and C. Lilley. "Network Performance Effects of + HTTP/1.1, CSS1, and PNG," Proceedings of ACM SIGCOMM '97, Cannes + France, September 1997.[jg642] + + [40] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Two: Media Types", RFC 2046, November + 1996. [jg643] + + [41] Alvestrand, H., "IETF Policy on Character Sets and Languages", + BCP 18, RFC 2277, January 1998. [jg644] + + [42] Berners-Lee, T., Fielding, R. and L. Masinter, "Uniform Resource + Identifiers (URI): Generic Syntax and Semantics", RFC 2396, + August 1998. [jg645] + + [43] Franks, J., Hallam-Baker, P., Hostetler, J., Lawrence, S., + Leach, P., Luotonen, A., Sink, E. and L. Stewart, "HTTP + Authentication: Basic and Digest Access Authentication", RFC + 2617, June 1999. [jg646] + + [44] Luotonen, A., "Tunneling TCP based protocols through Web proxy + servers," Work in Progress. [jg647] + + [45] Palme, J. and A. Hopmann, "MIME E-mail Encapsulation of + Aggregate Documents, such as HTML (MHTML)", RFC 2110, March + 1997. + + [46] Bradner, S., "The Internet Standards Process -- Revision 3", BCP + 9, RFC 2026, October 1996. + + [47] Masinter, L., "Hyper Text Coffee Pot Control Protocol + (HTCPCP/1.0)", RFC 2324, 1 April 1998. + + [48] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Five: Conformance Criteria and Examples", + RFC 2049, November 1996. + + [49] Troost, R., Dorner, S. and K. Moore, "Communicating Presentation + Information in Internet Messages: The Content-Disposition Header + Field", RFC 2183, August 1997. + + + + + + + +Fielding, et al. Standards Track [Page 161] + +RFC 2616 HTTP/1.1 June 1999 + + +18 Authors' Addresses + + Roy T. Fielding + Information and Computer Science + University of California, Irvine + Irvine, CA 92697-3425, USA + + Fax: +1 (949) 824-1715 + EMail: fielding@ics.uci.edu + + + James Gettys + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: jg@w3.org + + + Jeffrey C. Mogul + Western Research Laboratory + Compaq Computer Corporation + 250 University Avenue + Palo Alto, California, 94305, USA + + EMail: mogul@wrl.dec.com + + + Henrik Frystyk Nielsen + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: frystyk@w3.org + + + Larry Masinter + Xerox Corporation + 3333 Coyote Hill Road + Palo Alto, CA 94034, USA + + EMail: masinter@parc.xerox.com + + + + + +Fielding, et al. Standards Track [Page 162] + +RFC 2616 HTTP/1.1 June 1999 + + + Paul J. Leach + Microsoft Corporation + 1 Microsoft Way + Redmond, WA 98052, USA + + EMail: paulle@microsoft.com + + + Tim Berners-Lee + Director, World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: timbl@w3.org + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 163] + +RFC 2616 HTTP/1.1 June 1999 + + +19 Appendices + +19.1 Internet Media Type message/http and application/http + + In addition to defining the HTTP/1.1 protocol, this document serves + as the specification for the Internet media type "message/http" and + "application/http". The message/http type can be used to enclose a + single HTTP request or response message, provided that it obeys the + MIME restrictions for all "message" types regarding line length and + encodings. The application/http type can be used to enclose a + pipeline of one or more HTTP request or response messages (not + intermixed). The following is to be registered with IANA [17]. + + Media Type name: message + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed message + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + Media Type name: application + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed messages + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: HTTP messages enclosed by this type + are in "binary" format; use of an appropriate + Content-Transfer-Encoding is required when + transmitted via E-mail. + Security considerations: none + + + + + + + + + +Fielding, et al. Standards Track [Page 164] + +RFC 2616 HTTP/1.1 June 1999 + + +19.2 Internet Media Type multipart/byteranges + + When an HTTP 206 (Partial Content) response message includes the + content of multiple ranges (a response to a request for multiple + non-overlapping ranges), these are transmitted as a multipart + message-body. The media type for this purpose is called + "multipart/byteranges". + + The multipart/byteranges media type includes two or more parts, each + with its own Content-Type and Content-Range fields. The required + boundary parameter specifies the boundary string used to separate + each body-part. + + Media Type name: multipart + Media subtype name: byteranges + Required parameters: boundary + Optional parameters: none + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + + For example: + + HTTP/1.1 206 Partial Content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-type: multipart/byteranges; boundary=THIS_STRING_SEPARATES + + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 500-999/8000 + + ...the first range... + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 7000-7999/8000 + + ...the second range + --THIS_STRING_SEPARATES-- + + Notes: + + 1) Additional CRLFs may precede the first boundary string in the + entity. + + + + + + +Fielding, et al. Standards Track [Page 165] + +RFC 2616 HTTP/1.1 June 1999 + + + 2) Although RFC 2046 [40] permits the boundary string to be + quoted, some existing implementations handle a quoted boundary + string incorrectly. + + 3) A number of browsers and servers were coded to an early draft + of the byteranges specification to use a media type of + multipart/x-byteranges, which is almost, but not quite + compatible with the version documented in HTTP/1.1. + +19.3 Tolerant Applications + + Although this document specifies the requirements for the generation + of HTTP/1.1 messages, not all applications will be correct in their + implementation. We therefore recommend that operational applications + be tolerant of deviations whenever those deviations can be + interpreted unambiguously. + + Clients SHOULD be tolerant in parsing the Status-Line and servers + tolerant when parsing the Request-Line. In particular, they SHOULD + accept any amount of SP or HT characters between fields, even though + only a single SP is required. + + The line terminator for message-header fields is the sequence CRLF. + However, we recommend that applications, when parsing such headers, + recognize a single LF as a line terminator and ignore the leading CR. + + The character set of an entity-body SHOULD be labeled as the lowest + common denominator of the character codes used within that body, with + the exception that not labeling the entity is preferred over labeling + the entity with the labels US-ASCII or ISO-8859-1. See section 3.7.1 + and 3.4.1. + + Additional rules for requirements on parsing and encoding of dates + and other potential problems with date encodings include: + + - HTTP/1.1 clients and caches SHOULD assume that an RFC-850 date + which appears to be more than 50 years in the future is in fact + in the past (this helps solve the "year 2000" problem). + + - An HTTP/1.1 implementation MAY internally represent a parsed + Expires date as earlier than the proper value, but MUST NOT + internally represent a parsed Expires date as later than the + proper value. + + - All expiration-related calculations MUST be done in GMT. The + local time zone MUST NOT influence the calculation or comparison + of an age or expiration time. + + + + +Fielding, et al. Standards Track [Page 166] + +RFC 2616 HTTP/1.1 June 1999 + + + - If an HTTP header incorrectly carries a date value with a time + zone other than GMT, it MUST be converted into GMT using the + most conservative possible conversion. + +19.4 Differences Between HTTP Entities and RFC 2045 Entities + + HTTP/1.1 uses many of the constructs defined for Internet Mail (RFC + 822 [9]) and the Multipurpose Internet Mail Extensions (MIME [7]) to + allow entities to be transmitted in an open variety of + representations and with extensible mechanisms. However, RFC 2045 + discusses mail, and HTTP has a few features that are different from + those described in RFC 2045. These differences were carefully chosen + to optimize performance over binary connections, to allow greater + freedom in the use of new media types, to make date comparisons + easier, and to acknowledge the practice of some early HTTP servers + and clients. + + This appendix describes specific areas where HTTP differs from RFC + 2045. Proxies and gateways to strict MIME environments SHOULD be + aware of these differences and provide the appropriate conversions + where necessary. Proxies and gateways from MIME environments to HTTP + also need to be aware of the differences because some conversions + might be required. + +19.4.1 MIME-Version + + HTTP is not a MIME-compliant protocol. However, HTTP/1.1 messages MAY + include a single MIME-Version general-header field to indicate what + version of the MIME protocol was used to construct the message. Use + of the MIME-Version header field indicates that the message is in + full compliance with the MIME protocol (as defined in RFC 2045[7]). + Proxies/gateways are responsible for ensuring full compliance (where + possible) when exporting HTTP messages to strict MIME environments. + + MIME-Version = "MIME-Version" ":" 1*DIGIT "." 1*DIGIT + + MIME version "1.0" is the default for use in HTTP/1.1. However, + HTTP/1.1 message parsing and semantics are defined by this document + and not the MIME specification. + +19.4.2 Conversion to Canonical Form + + RFC 2045 [7] requires that an Internet mail entity be converted to + canonical form prior to being transferred, as described in section 4 + of RFC 2049 [48]. Section 3.7.1 of this document describes the forms + allowed for subtypes of the "text" media type when transmitted over + HTTP. RFC 2046 requires that content with a type of "text" represent + line breaks as CRLF and forbids the use of CR or LF outside of line + + + +Fielding, et al. Standards Track [Page 167] + +RFC 2616 HTTP/1.1 June 1999 + + + break sequences. HTTP allows CRLF, bare CR, and bare LF to indicate a + line break within text content when a message is transmitted over + HTTP. + + Where it is possible, a proxy or gateway from HTTP to a strict MIME + environment SHOULD translate all line breaks within the text media + types described in section 3.7.1 of this document to the RFC 2049 + canonical form of CRLF. Note, however, that this might be complicated + by the presence of a Content-Encoding and by the fact that HTTP + allows the use of some character sets which do not use octets 13 and + 10 to represent CR and LF, as is the case for some multi-byte + character sets. + + Implementors should note that conversion will break any cryptographic + checksums applied to the original content unless the original content + is already in canonical form. Therefore, the canonical form is + recommended for any content that uses such checksums in HTTP. + +19.4.3 Conversion of Date Formats + + HTTP/1.1 uses a restricted set of date formats (section 3.3.1) to + simplify the process of date comparison. Proxies and gateways from + other protocols SHOULD ensure that any Date header field present in a + message conforms to one of the HTTP/1.1 formats and rewrite the date + if necessary. + +19.4.4 Introduction of Content-Encoding + + RFC 2045 does not include any concept equivalent to HTTP/1.1's + Content-Encoding header field. Since this acts as a modifier on the + media type, proxies and gateways from HTTP to MIME-compliant + protocols MUST either change the value of the Content-Type header + field or decode the entity-body before forwarding the message. (Some + experimental applications of Content-Type for Internet mail have used + a media-type parameter of ";conversions=" to perform + a function equivalent to Content-Encoding. However, this parameter is + not part of RFC 2045.) + +19.4.5 No Content-Transfer-Encoding + + HTTP does not use the Content-Transfer-Encoding (CTE) field of RFC + 2045. Proxies and gateways from MIME-compliant protocols to HTTP MUST + remove any non-identity CTE ("quoted-printable" or "base64") encoding + prior to delivering the response message to an HTTP client. + + Proxies and gateways from HTTP to MIME-compliant protocols are + responsible for ensuring that the message is in the correct format + and encoding for safe transport on that protocol, where "safe + + + +Fielding, et al. Standards Track [Page 168] + +RFC 2616 HTTP/1.1 June 1999 + + + transport" is defined by the limitations of the protocol being used. + Such a proxy or gateway SHOULD label the data with an appropriate + Content-Transfer-Encoding if doing so will improve the likelihood of + safe transport over the destination protocol. + +19.4.6 Introduction of Transfer-Encoding + + HTTP/1.1 introduces the Transfer-Encoding header field (section + 14.41). Proxies/gateways MUST remove any transfer-coding prior to + forwarding a message via a MIME-compliant protocol. + + A process for decoding the "chunked" transfer-coding (section 3.6) + can be represented in pseudo-code as: + + length := 0 + read chunk-size, chunk-extension (if any) and CRLF + while (chunk-size > 0) { + read chunk-data and CRLF + append chunk-data to entity-body + length := length + chunk-size + read chunk-size and CRLF + } + read entity-header + while (entity-header not empty) { + append entity-header to existing header fields + read entity-header + } + Content-Length := length + Remove "chunked" from Transfer-Encoding + +19.4.7 MHTML and Line Length Limitations + + HTTP implementations which share code with MHTML [45] implementations + need to be aware of MIME line length limitations. Since HTTP does not + have this limitation, HTTP does not fold long lines. MHTML messages + being transported by HTTP follow all conventions of MHTML, including + line length limitations and folding, canonicalization, etc., since + HTTP transports all message-bodies as payload (see section 3.7.2) and + does not interpret the content or any MIME header lines that might be + contained therein. + +19.5 Additional Features + + RFC 1945 and RFC 2068 document protocol elements used by some + existing HTTP implementations, but not consistently and correctly + across most HTTP/1.1 applications. Implementors are advised to be + aware of these features, but cannot rely upon their presence in, or + interoperability with, other HTTP/1.1 applications. Some of these + + + +Fielding, et al. Standards Track [Page 169] + +RFC 2616 HTTP/1.1 June 1999 + + + describe proposed experimental features, and some describe features + that experimental deployment found lacking that are now addressed in + the base HTTP/1.1 specification. + + A number of other headers, such as Content-Disposition and Title, + from SMTP and MIME are also often implemented (see RFC 2076 [37]). + +19.5.1 Content-Disposition + + The Content-Disposition response-header field has been proposed as a + means for the origin server to suggest a default filename if the user + requests that the content is saved to a file. This usage is derived + from the definition of Content-Disposition in RFC 1806 [35]. + + content-disposition = "Content-Disposition" ":" + disposition-type *( ";" disposition-parm ) + disposition-type = "attachment" | disp-extension-token + disposition-parm = filename-parm | disp-extension-parm + filename-parm = "filename" "=" quoted-string + disp-extension-token = token + disp-extension-parm = token "=" ( token | quoted-string ) + + An example is + + Content-Disposition: attachment; filename="fname.ext" + + The receiving user agent SHOULD NOT respect any directory path + information present in the filename-parm parameter, which is the only + parameter believed to apply to HTTP implementations at this time. The + filename SHOULD be treated as a terminal component only. + + If this header is used in a response with the application/octet- + stream content-type, the implied suggestion is that the user agent + should not display the response, but directly enter a `save response + as...' dialog. + + See section 15.5 for Content-Disposition security issues. + +19.6 Compatibility with Previous Versions + + It is beyond the scope of a protocol specification to mandate + compliance with previous versions. HTTP/1.1 was deliberately + designed, however, to make supporting previous versions easy. It is + worth noting that, at the time of composing this specification + (1996), we would expect commercial HTTP/1.1 servers to: + + - recognize the format of the Request-Line for HTTP/0.9, 1.0, and + 1.1 requests; + + + +Fielding, et al. Standards Track [Page 170] + +RFC 2616 HTTP/1.1 June 1999 + + + - understand any valid request in the format of HTTP/0.9, 1.0, or + 1.1; + + - respond appropriately with a message in the same major version + used by the client. + + And we would expect HTTP/1.1 clients to: + + - recognize the format of the Status-Line for HTTP/1.0 and 1.1 + responses; + + - understand any valid response in the format of HTTP/0.9, 1.0, or + 1.1. + + For most implementations of HTTP/1.0, each connection is established + by the client prior to the request and closed by the server after + sending the response. Some implementations implement the Keep-Alive + version of persistent connections described in section 19.7.1 of RFC + 2068 [33]. + +19.6.1 Changes from HTTP/1.0 + + This section summarizes major differences between versions HTTP/1.0 + and HTTP/1.1. + +19.6.1.1 Changes to Simplify Multi-homed Web Servers and Conserve IP + Addresses + + The requirements that clients and servers support the Host request- + header, report an error if the Host request-header (section 14.23) is + missing from an HTTP/1.1 request, and accept absolute URIs (section + 5.1.2) are among the most important changes defined by this + specification. + + Older HTTP/1.0 clients assumed a one-to-one relationship of IP + addresses and servers; there was no other established mechanism for + distinguishing the intended server of a request than the IP address + to which that request was directed. The changes outlined above will + allow the Internet, once older HTTP clients are no longer common, to + support multiple Web sites from a single IP address, greatly + simplifying large operational Web servers, where allocation of many + IP addresses to a single host has created serious problems. The + Internet will also be able to recover the IP addresses that have been + allocated for the sole purpose of allowing special-purpose domain + names to be used in root-level HTTP URLs. Given the rate of growth of + the Web, and the number of servers already deployed, it is extremely + + + + + +Fielding, et al. Standards Track [Page 171] + +RFC 2616 HTTP/1.1 June 1999 + + + important that all implementations of HTTP (including updates to + existing HTTP/1.0 applications) correctly implement these + requirements: + + - Both clients and servers MUST support the Host request-header. + + - A client that sends an HTTP/1.1 request MUST send a Host header. + + - Servers MUST report a 400 (Bad Request) error if an HTTP/1.1 + request does not include a Host request-header. + + - Servers MUST accept absolute URIs. + +19.6.2 Compatibility with HTTP/1.0 Persistent Connections + + Some clients and servers might wish to be compatible with some + previous implementations of persistent connections in HTTP/1.0 + clients and servers. Persistent connections in HTTP/1.0 are + explicitly negotiated as they are not the default behavior. HTTP/1.0 + experimental implementations of persistent connections are faulty, + and the new facilities in HTTP/1.1 are designed to rectify these + problems. The problem was that some existing 1.0 clients may be + sending Keep-Alive to a proxy server that doesn't understand + Connection, which would then erroneously forward it to the next + inbound server, which would establish the Keep-Alive connection and + result in a hung HTTP/1.0 proxy waiting for the close on the + response. The result is that HTTP/1.0 clients must be prevented from + using Keep-Alive when talking to proxies. + + However, talking to proxies is the most important use of persistent + connections, so that prohibition is clearly unacceptable. Therefore, + we need some other mechanism for indicating a persistent connection + is desired, which is safe to use even when talking to an old proxy + that ignores Connection. Persistent connections are the default for + HTTP/1.1 messages; we introduce a new keyword (Connection: close) for + declaring non-persistence. See section 14.10. + + The original HTTP/1.0 form of persistent connections (the Connection: + Keep-Alive and Keep-Alive header) is documented in RFC 2068. [33] + +19.6.3 Changes from RFC 2068 + + This specification has been carefully audited to correct and + disambiguate key word usage; RFC 2068 had many problems in respect to + the conventions laid out in RFC 2119 [34]. + + Clarified which error code should be used for inbound server failures + (e.g. DNS failures). (Section 10.5.5). + + + +Fielding, et al. Standards Track [Page 172] + +RFC 2616 HTTP/1.1 June 1999 + + + CREATE had a race that required an Etag be sent when a resource is + first created. (Section 10.2.2). + + Content-Base was deleted from the specification: it was not + implemented widely, and there is no simple, safe way to introduce it + without a robust extension mechanism. In addition, it is used in a + similar, but not identical fashion in MHTML [45]. + + Transfer-coding and message lengths all interact in ways that + required fixing exactly when chunked encoding is used (to allow for + transfer encoding that may not be self delimiting); it was important + to straighten out exactly how message lengths are computed. (Sections + 3.6, 4.4, 7.2.2, 13.5.2, 14.13, 14.16) + + A content-coding of "identity" was introduced, to solve problems + discovered in caching. (section 3.5) + + Quality Values of zero should indicate that "I don't want something" + to allow clients to refuse a representation. (Section 3.9) + + The use and interpretation of HTTP version numbers has been clarified + by RFC 2145. Require proxies to upgrade requests to highest protocol + version they support to deal with problems discovered in HTTP/1.0 + implementations (Section 3.1) + + Charset wildcarding is introduced to avoid explosion of character set + names in accept headers. (Section 14.2) + + A case was missed in the Cache-Control model of HTTP/1.1; s-maxage + was introduced to add this missing case. (Sections 13.4, 14.8, 14.9, + 14.9.3) + + The Cache-Control: max-age directive was not properly defined for + responses. (Section 14.9.3) + + There are situations where a server (especially a proxy) does not + know the full length of a response but is capable of serving a + byterange request. We therefore need a mechanism to allow byteranges + with a content-range not indicating the full length of the message. + (Section 14.16) + + Range request responses would become very verbose if all meta-data + were always returned; by allowing the server to only send needed + headers in a 206 response, this problem can be avoided. (Section + 10.2.7, 13.5.3, and 14.27) + + + + + + +Fielding, et al. Standards Track [Page 173] + +RFC 2616 HTTP/1.1 June 1999 + + + Fix problem with unsatisfiable range requests; there are two cases: + syntactic problems, and range doesn't exist in the document. The 416 + status code was needed to resolve this ambiguity needed to indicate + an error for a byte range request that falls outside of the actual + contents of a document. (Section 10.4.17, 14.16) + + Rewrite of message transmission requirements to make it much harder + for implementors to get it wrong, as the consequences of errors here + can have significant impact on the Internet, and to deal with the + following problems: + + 1. Changing "HTTP/1.1 or later" to "HTTP/1.1", in contexts where + this was incorrectly placing a requirement on the behavior of + an implementation of a future version of HTTP/1.x + + 2. Made it clear that user-agents should retry requests, not + "clients" in general. + + 3. Converted requirements for clients to ignore unexpected 100 + (Continue) responses, and for proxies to forward 100 responses, + into a general requirement for 1xx responses. + + 4. Modified some TCP-specific language, to make it clearer that + non-TCP transports are possible for HTTP. + + 5. Require that the origin server MUST NOT wait for the request + body before it sends a required 100 (Continue) response. + + 6. Allow, rather than require, a server to omit 100 (Continue) if + it has already seen some of the request body. + + 7. Allow servers to defend against denial-of-service attacks and + broken clients. + + This change adds the Expect header and 417 status code. The message + transmission requirements fixes are in sections 8.2, 10.4.18, + 8.1.2.2, 13.11, and 14.20. + + Proxies should be able to add Content-Length when appropriate. + (Section 13.5.2) + + Clean up confusion between 403 and 404 responses. (Section 10.4.4, + 10.4.5, and 10.4.11) + + Warnings could be cached incorrectly, or not updated appropriately. + (Section 13.1.2, 13.2.4, 13.5.2, 13.5.3, 14.9.3, and 14.46) Warning + also needed to be a general header, as PUT or other methods may have + need for it in requests. + + + +Fielding, et al. Standards Track [Page 174] + +RFC 2616 HTTP/1.1 June 1999 + + + Transfer-coding had significant problems, particularly with + interactions with chunked encoding. The solution is that transfer- + codings become as full fledged as content-codings. This involves + adding an IANA registry for transfer-codings (separate from content + codings), a new header field (TE) and enabling trailer headers in the + future. Transfer encoding is a major performance benefit, so it was + worth fixing [39]. TE also solves another, obscure, downward + interoperability problem that could have occurred due to interactions + between authentication trailers, chunked encoding and HTTP/1.0 + clients.(Section 3.6, 3.6.1, and 14.39) + + The PATCH, LINK, UNLINK methods were defined but not commonly + implemented in previous versions of this specification. See RFC 2068 + [33]. + + The Alternates, Content-Version, Derived-From, Link, URI, Public and + Content-Base header fields were defined in previous versions of this + specification, but not commonly implemented. See RFC 2068 [33]. + +20 Index + + Please see the PostScript version of this RFC for the INDEX. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 175] + +RFC 2616 HTTP/1.1 June 1999 + + +21. Full Copyright Statement + + Copyright (C) The Internet Society (1999). All Rights Reserved. + + This document and translations of it may be copied and furnished to + others, and derivative works that comment on or otherwise explain it + or assist in its implementation may be prepared, copied, published + and distributed, in whole or in part, without restriction of any + kind, provided that the above copyright notice and this paragraph are + included on all such copies and derivative works. However, this + document itself may not be modified in any way, such as by removing + the copyright notice or references to the Internet Society or other + Internet organizations, except as needed for the purpose of + developing Internet standards in which case the procedures for + copyrights defined in the Internet Standards process must be + followed, or as required to translate it into languages other than + English. + + The limited permissions granted above are perpetual and will not be + revoked by the Internet Society or its successors or assigns. + + This document and the information contained herein is provided on an + "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING + TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING + BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION + HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF + MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + +Acknowledgement + + Funding for the RFC Editor function is currently provided by the + Internet Society. + + Network Working Group R. Fielding +Request for Comments: 2616 UC Irvine +Obsoletes: 2068 J. Gettys +Category: Standards Track Compaq/W3C + J. Mogul + Compaq + H. Frystyk + W3C/MIT + L. Masinter + Xerox + P. Leach + Microsoft + T. Berners-Lee + W3C/MIT + June 1999 + + + Hypertext Transfer Protocol -- HTTP/1.1 + +Status of this Memo + + This document specifies an Internet standards track protocol for the + Internet community, and requests discussion and suggestions for + improvements. Please refer to the current edition of the "Internet + Official Protocol Standards" (STD 1) for the standardization state + and status of this protocol. Distribution of this memo is unlimited. + +Copyright Notice + + Copyright (C) The Internet Society (1999). All Rights Reserved. + +Abstract + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. It is a generic, stateless, protocol which can be used for + many tasks beyond its use for hypertext, such as name servers and + distributed object management systems, through extension of its + request methods, error codes and headers [47]. A feature of HTTP is + the typing and negotiation of data representation, allowing systems + to be built independently of the data being transferred. + + HTTP has been in use by the World-Wide Web global information + initiative since 1990. This specification defines the protocol + referred to as "HTTP/1.1", and is an update to RFC 2068 [33]. + + + + + + +Fielding, et al. Standards Track [Page 1] + +RFC 2616 HTTP/1.1 June 1999 + + +Table of Contents + + 1 Introduction ...................................................7 + 1.1 Purpose......................................................7 + 1.2 Requirements .................................................8 + 1.3 Terminology ..................................................8 + 1.4 Overall Operation ...........................................12 + 2 Notational Conventions and Generic Grammar ....................14 + 2.1 Augmented BNF ...............................................14 + 2.2 Basic Rules .................................................15 + 3 Protocol Parameters ...........................................17 + 3.1 HTTP Version ................................................17 + 3.2 Uniform Resource Identifiers ................................18 + 3.2.1 General Syntax ...........................................19 + 3.2.2 http URL .................................................19 + 3.2.3 URI Comparison ...........................................20 + 3.3 Date/Time Formats ...........................................20 + 3.3.1 Full Date ................................................20 + 3.3.2 Delta Seconds ............................................21 + 3.4 Character Sets ..............................................21 + 3.4.1 Missing Charset ..........................................22 + 3.5 Content Codings .............................................23 + 3.6 Transfer Codings ............................................24 + 3.6.1 Chunked Transfer Coding ..................................25 + 3.7 Media Types .................................................26 + 3.7.1 Canonicalization and Text Defaults .......................27 + 3.7.2 Multipart Types ..........................................27 + 3.8 Product Tokens ..............................................28 + 3.9 Quality Values ..............................................29 + 3.10 Language Tags ...............................................29 + 3.11 Entity Tags .................................................30 + 3.12 Range Units .................................................30 + 4 HTTP Message ..................................................31 + 4.1 Message Types ...............................................31 + 4.2 Message Headers .............................................31 + 4.3 Message Body ................................................32 + 4.4 Message Length ..............................................33 + 4.5 General Header Fields .......................................34 + 5 Request .......................................................35 + 5.1 Request-Line ................................................35 + 5.1.1 Method ...................................................36 + 5.1.2 Request-URI ..............................................36 + 5.2 The Resource Identified by a Request ........................38 + 5.3 Request Header Fields .......................................38 + 6 Response ......................................................39 + 6.1 Status-Line .................................................39 + 6.1.1 Status Code and Reason Phrase ............................39 + 6.2 Response Header Fields ......................................41 + + + +Fielding, et al. Standards Track [Page 2] + +RFC 2616 HTTP/1.1 June 1999 + + + 7 Entity ........................................................42 + 7.1 Entity Header Fields ........................................42 + 7.2 Entity Body .................................................43 + 7.2.1 Type .....................................................43 + 7.2.2 Entity Length ............................................43 + 8 Connections ...................................................44 + 8.1 Persistent Connections ......................................44 + 8.1.1 Purpose ..................................................44 + 8.1.2 Overall Operation ........................................45 + 8.1.3 Proxy Servers ............................................46 + 8.1.4 Practical Considerations .................................46 + 8.2 Message Transmission Requirements ...........................47 + 8.2.1 Persistent Connections and Flow Control ..................47 + 8.2.2 Monitoring Connections for Error Status Messages .........48 + 8.2.3 Use of the 100 (Continue) Status .........................48 + 8.2.4 Client Behavior if Server Prematurely Closes Connection ..50 + 9 Method Definitions ............................................51 + 9.1 Safe and Idempotent Methods .................................51 + 9.1.1 Safe Methods .............................................51 + 9.1.2 Idempotent Methods .......................................51 + 9.2 OPTIONS .....................................................52 + 9.3 GET .........................................................53 + 9.4 HEAD ........................................................54 + 9.5 POST ........................................................54 + 9.6 PUT .........................................................55 + 9.7 DELETE ......................................................56 + 9.8 TRACE .......................................................56 + 9.9 CONNECT .....................................................57 + 10 Status Code Definitions ......................................57 + 10.1 Informational 1xx ...........................................57 + 10.1.1 100 Continue .............................................58 + 10.1.2 101 Switching Protocols ..................................58 + 10.2 Successful 2xx ..............................................58 + 10.2.1 200 OK ...................................................58 + 10.2.2 201 Created ..............................................59 + 10.2.3 202 Accepted .............................................59 + 10.2.4 203 Non-Authoritative Information ........................59 + 10.2.5 204 No Content ...........................................60 + 10.2.6 205 Reset Content ........................................60 + 10.2.7 206 Partial Content ......................................60 + 10.3 Redirection 3xx .............................................61 + 10.3.1 300 Multiple Choices .....................................61 + 10.3.2 301 Moved Permanently ....................................62 + 10.3.3 302 Found ................................................62 + 10.3.4 303 See Other ............................................63 + 10.3.5 304 Not Modified .........................................63 + 10.3.6 305 Use Proxy ............................................64 + 10.3.7 306 (Unused) .............................................64 + + + +Fielding, et al. Standards Track [Page 3] + +RFC 2616 HTTP/1.1 June 1999 + + + 10.3.8 307 Temporary Redirect ...................................65 + 10.4 Client Error 4xx ............................................65 + 10.4.1 400 Bad Request .........................................65 + 10.4.2 401 Unauthorized ........................................66 + 10.4.3 402 Payment Required ....................................66 + 10.4.4 403 Forbidden ...........................................66 + 10.4.5 404 Not Found ...........................................66 + 10.4.6 405 Method Not Allowed ..................................66 + 10.4.7 406 Not Acceptable ......................................67 + 10.4.8 407 Proxy Authentication Required .......................67 + 10.4.9 408 Request Timeout .....................................67 + 10.4.10 409 Conflict ............................................67 + 10.4.11 410 Gone ................................................68 + 10.4.12 411 Length Required .....................................68 + 10.4.13 412 Precondition Failed .................................68 + 10.4.14 413 Request Entity Too Large ............................69 + 10.4.15 414 Request-URI Too Long ................................69 + 10.4.16 415 Unsupported Media Type ..............................69 + 10.4.17 416 Requested Range Not Satisfiable .....................69 + 10.4.18 417 Expectation Failed ..................................70 + 10.5 Server Error 5xx ............................................70 + 10.5.1 500 Internal Server Error ................................70 + 10.5.2 501 Not Implemented ......................................70 + 10.5.3 502 Bad Gateway ..........................................70 + 10.5.4 503 Service Unavailable ..................................70 + 10.5.5 504 Gateway Timeout ......................................71 + 10.5.6 505 HTTP Version Not Supported ...........................71 + 11 Access Authentication ........................................71 + 12 Content Negotiation ..........................................71 + 12.1 Server-driven Negotiation ...................................72 + 12.2 Agent-driven Negotiation ....................................73 + 12.3 Transparent Negotiation .....................................74 + 13 Caching in HTTP ..............................................74 + 13.1.1 Cache Correctness ........................................75 + 13.1.2 Warnings .................................................76 + 13.1.3 Cache-control Mechanisms .................................77 + 13.1.4 Explicit User Agent Warnings .............................78 + 13.1.5 Exceptions to the Rules and Warnings .....................78 + 13.1.6 Client-controlled Behavior ...............................79 + 13.2 Expiration Model ............................................79 + 13.2.1 Server-Specified Expiration ..............................79 + 13.2.2 Heuristic Expiration .....................................80 + 13.2.3 Age Calculations .........................................80 + 13.2.4 Expiration Calculations ..................................83 + 13.2.5 Disambiguating Expiration Values .........................84 + 13.2.6 Disambiguating Multiple Responses ........................84 + 13.3 Validation Model ............................................85 + 13.3.1 Last-Modified Dates ......................................86 + + + +Fielding, et al. Standards Track [Page 4] + +RFC 2616 HTTP/1.1 June 1999 + + + 13.3.2 Entity Tag Cache Validators ..............................86 + 13.3.3 Weak and Strong Validators ...............................86 + 13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates.89 + 13.3.5 Non-validating Conditionals ..............................90 + 13.4 Response Cacheability .......................................91 + 13.5 Constructing Responses From Caches ..........................92 + 13.5.1 End-to-end and Hop-by-hop Headers ........................92 + 13.5.2 Non-modifiable Headers ...................................92 + 13.5.3 Combining Headers ........................................94 + 13.5.4 Combining Byte Ranges ....................................95 + 13.6 Caching Negotiated Responses ................................95 + 13.7 Shared and Non-Shared Caches ................................96 + 13.8 Errors or Incomplete Response Cache Behavior ................97 + 13.9 Side Effects of GET and HEAD ................................97 + 13.10 Invalidation After Updates or Deletions ...................97 + 13.11 Write-Through Mandatory ...................................98 + 13.12 Cache Replacement .........................................99 + 13.13 History Lists .............................................99 + 14 Header Field Definitions ....................................100 + 14.1 Accept .....................................................100 + 14.2 Accept-Charset .............................................102 + 14.3 Accept-Encoding ............................................102 + 14.4 Accept-Language ............................................104 + 14.5 Accept-Ranges ..............................................105 + 14.6 Age ........................................................106 + 14.7 Allow ......................................................106 + 14.8 Authorization ..............................................107 + 14.9 Cache-Control ..............................................108 + 14.9.1 What is Cacheable .......................................109 + 14.9.2 What May be Stored by Caches ............................110 + 14.9.3 Modifications of the Basic Expiration Mechanism .........111 + 14.9.4 Cache Revalidation and Reload Controls ..................113 + 14.9.5 No-Transform Directive ..................................115 + 14.9.6 Cache Control Extensions ................................116 + 14.10 Connection ...............................................117 + 14.11 Content-Encoding .........................................118 + 14.12 Content-Language .........................................118 + 14.13 Content-Length ...........................................119 + 14.14 Content-Location .........................................120 + 14.15 Content-MD5 ..............................................121 + 14.16 Content-Range ............................................122 + 14.17 Content-Type .............................................124 + 14.18 Date .....................................................124 + 14.18.1 Clockless Origin Server Operation ......................125 + 14.19 ETag .....................................................126 + 14.20 Expect ...................................................126 + 14.21 Expires ..................................................127 + 14.22 From .....................................................128 + + + +Fielding, et al. Standards Track [Page 5] + +RFC 2616 HTTP/1.1 June 1999 + + + 14.23 Host .....................................................128 + 14.24 If-Match .................................................129 + 14.25 If-Modified-Since ........................................130 + 14.26 If-None-Match ............................................132 + 14.27 If-Range .................................................133 + 14.28 If-Unmodified-Since ......................................134 + 14.29 Last-Modified ............................................134 + 14.30 Location .................................................135 + 14.31 Max-Forwards .............................................136 + 14.32 Pragma ...................................................136 + 14.33 Proxy-Authenticate .......................................137 + 14.34 Proxy-Authorization ......................................137 + 14.35 Range ....................................................138 + 14.35.1 Byte Ranges ...........................................138 + 14.35.2 Range Retrieval Requests ..............................139 + 14.36 Referer ..................................................140 + 14.37 Retry-After ..............................................141 + 14.38 Server ...................................................141 + 14.39 TE .......................................................142 + 14.40 Trailer ..................................................143 + 14.41 Transfer-Encoding..........................................143 + 14.42 Upgrade ..................................................144 + 14.43 User-Agent ...............................................145 + 14.44 Vary .....................................................145 + 14.45 Via ......................................................146 + 14.46 Warning ..................................................148 + 14.47 WWW-Authenticate .........................................150 + 15 Security Considerations .......................................150 + 15.1 Personal Information....................................151 + 15.1.1 Abuse of Server Log Information .........................151 + 15.1.2 Transfer of Sensitive Information .......................151 + 15.1.3 Encoding Sensitive Information in URI's .................152 + 15.1.4 Privacy Issues Connected to Accept Headers ..............152 + 15.2 Attacks Based On File and Path Names .......................153 + 15.3 DNS Spoofing ...............................................154 + 15.4 Location Headers and Spoofing ..............................154 + 15.5 Content-Disposition Issues .................................154 + 15.6 Authentication Credentials and Idle Clients ................155 + 15.7 Proxies and Caching ........................................155 + 15.7.1 Denial of Service Attacks on Proxies....................156 + 16 Acknowledgments .............................................156 + 17 References ..................................................158 + 18 Authors' Addresses ..........................................162 + 19 Appendices ..................................................164 + 19.1 Internet Media Type message/http and application/http ......164 + 19.2 Internet Media Type multipart/byteranges ...................165 + 19.3 Tolerant Applications ......................................166 + 19.4 Differences Between HTTP Entities and RFC 2045 Entities ....167 + + + +Fielding, et al. Standards Track [Page 6] + +RFC 2616 HTTP/1.1 June 1999 + + + 19.4.1 MIME-Version ............................................167 + 19.4.2 Conversion to Canonical Form ............................167 + 19.4.3 Conversion of Date Formats ..............................168 + 19.4.4 Introduction of Content-Encoding ........................168 + 19.4.5 No Content-Transfer-Encoding ............................168 + 19.4.6 Introduction of Transfer-Encoding .......................169 + 19.4.7 MHTML and Line Length Limitations .......................169 + 19.5 Additional Features ........................................169 + 19.5.1 Content-Disposition .....................................170 + 19.6 Compatibility with Previous Versions .......................170 + 19.6.1 Changes from HTTP/1.0 ...................................171 + 19.6.2 Compatibility with HTTP/1.0 Persistent Connections ......172 + 19.6.3 Changes from RFC 2068 ...................................172 + 20 Index .......................................................175 + 21 Full Copyright Statement ....................................176 + +1 Introduction + +1.1 Purpose + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. HTTP has been in use by the World-Wide Web global + information initiative since 1990. The first version of HTTP, + referred to as HTTP/0.9, was a simple protocol for raw data transfer + across the Internet. HTTP/1.0, as defined by RFC 1945 [6], improved + the protocol by allowing messages to be in the format of MIME-like + messages, containing metainformation about the data transferred and + modifiers on the request/response semantics. However, HTTP/1.0 does + not sufficiently take into consideration the effects of hierarchical + proxies, caching, the need for persistent connections, or virtual + hosts. In addition, the proliferation of incompletely-implemented + applications calling themselves "HTTP/1.0" has necessitated a + protocol version change in order for two communicating applications + to determine each other's true capabilities. + + This specification defines the protocol referred to as "HTTP/1.1". + This protocol includes more stringent requirements than HTTP/1.0 in + order to ensure reliable implementation of its features. + + Practical information systems require more functionality than simple + retrieval, including search, front-end update, and annotation. HTTP + allows an open-ended set of methods and headers that indicate the + purpose of a request [47]. It builds on the discipline of reference + provided by the Uniform Resource Identifier (URI) [3], as a location + (URL) [4] or name (URN) [20], for indicating the resource to which a + + + + + +Fielding, et al. Standards Track [Page 7] + +RFC 2616 HTTP/1.1 June 1999 + + + method is to be applied. Messages are passed in a format similar to + that used by Internet mail [9] as defined by the Multipurpose + Internet Mail Extensions (MIME) [7]. + + HTTP is also used as a generic protocol for communication between + user agents and proxies/gateways to other Internet systems, including + those supported by the SMTP [16], NNTP [13], FTP [18], Gopher [2], + and WAIS [10] protocols. In this way, HTTP allows basic hypermedia + access to resources available from diverse applications. + +1.2 Requirements + + The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", + "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this + document are to be interpreted as described in RFC 2119 [34]. + + An implementation is not compliant if it fails to satisfy one or more + of the MUST or REQUIRED level requirements for the protocols it + implements. An implementation that satisfies all the MUST or REQUIRED + level and all the SHOULD level requirements for its protocols is said + to be "unconditionally compliant"; one that satisfies all the MUST + level requirements but not all the SHOULD level requirements for its + protocols is said to be "conditionally compliant." + +1.3 Terminology + + This specification uses a number of terms to refer to the roles + played by participants in, and objects of, the HTTP communication. + + connection + A transport layer virtual circuit established between two programs + for the purpose of communication. + + message + The basic unit of HTTP communication, consisting of a structured + sequence of octets matching the syntax defined in section 4 and + transmitted via the connection. + + request + An HTTP request message, as defined in section 5. + + response + An HTTP response message, as defined in section 6. + + + + + + + + +Fielding, et al. Standards Track [Page 8] + +RFC 2616 HTTP/1.1 June 1999 + + + resource + A network data object or service that can be identified by a URI, + as defined in section 3.2. Resources may be available in multiple + representations (e.g. multiple languages, data formats, size, and + resolutions) or vary in other ways. + + entity + The information transferred as the payload of a request or + response. An entity consists of metainformation in the form of + entity-header fields and content in the form of an entity-body, as + described in section 7. + + representation + An entity included with a response that is subject to content + negotiation, as described in section 12. There may exist multiple + representations associated with a particular response status. + + content negotiation + The mechanism for selecting the appropriate representation when + servicing a request, as described in section 12. The + representation of entities in any response can be negotiated + (including error responses). + + variant + A resource may have one, or more than one, representation(s) + associated with it at any given instant. Each of these + representations is termed a `varriant'. Use of the term `variant' + does not necessarily imply that the resource is subject to content + negotiation. + + client + A program that establishes connections for the purpose of sending + requests. + + user agent + The client which initiates a request. These are often browsers, + editors, spiders (web-traversing robots), or other end user tools. + + server + An application program that accepts connections in order to + service requests by sending back responses. Any given program may + be capable of being both a client and a server; our use of these + terms refers only to the role being performed by the program for a + particular connection, rather than to the program's capabilities + in general. Likewise, any server may act as an origin server, + proxy, gateway, or tunnel, switching behavior based on the nature + of each request. + + + + +Fielding, et al. Standards Track [Page 9] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server + The server on which a given resource resides or is to be created. + + proxy + An intermediary program which acts as both a server and a client + for the purpose of making requests on behalf of other clients. + Requests are serviced internally or by passing them on, with + possible translation, to other servers. A proxy MUST implement + both the client and server requirements of this specification. A + "transparent proxy" is a proxy that does not modify the request or + response beyond what is required for proxy authentication and + identification. A "non-transparent proxy" is a proxy that modifies + the request or response in order to provide some added service to + the user agent, such as group annotation services, media type + transformation, protocol reduction, or anonymity filtering. Except + where either transparent or non-transparent behavior is explicitly + stated, the HTTP proxy requirements apply to both types of + proxies. + + gateway + A server which acts as an intermediary for some other server. + Unlike a proxy, a gateway receives requests as if it were the + origin server for the requested resource; the requesting client + may not be aware that it is communicating with a gateway. + + tunnel + An intermediary program which is acting as a blind relay between + two connections. Once active, a tunnel is not considered a party + to the HTTP communication, though the tunnel may have been + initiated by an HTTP request. The tunnel ceases to exist when both + ends of the relayed connections are closed. + + cache + A program's local store of response messages and the subsystem + that controls its message storage, retrieval, and deletion. A + cache stores cacheable responses in order to reduce the response + time and network bandwidth consumption on future, equivalent + requests. Any client or server may include a cache, though a cache + cannot be used by a server that is acting as a tunnel. + + cacheable + A response is cacheable if a cache is allowed to store a copy of + the response message for use in answering subsequent requests. The + rules for determining the cacheability of HTTP responses are + defined in section 13. Even if a resource is cacheable, there may + be additional constraints on whether a cache can use the cached + copy for a particular request. + + + + +Fielding, et al. Standards Track [Page 10] + +RFC 2616 HTTP/1.1 June 1999 + + + first-hand + A response is first-hand if it comes directly and without + unnecessary delay from the origin server, perhaps via one or more + proxies. A response is also first-hand if its validity has just + been checked directly with the origin server. + + explicit expiration time + The time at which the origin server intends that an entity should + no longer be returned by a cache without further validation. + + heuristic expiration time + An expiration time assigned by a cache when no explicit expiration + time is available. + + age + The age of a response is the time since it was sent by, or + successfully validated with, the origin server. + + freshness lifetime + The length of time between the generation of a response and its + expiration time. + + fresh + A response is fresh if its age has not yet exceeded its freshness + lifetime. + + stale + A response is stale if its age has passed its freshness lifetime. + + semantically transparent + A cache behaves in a "semantically transparent" manner, with + respect to a particular response, when its use affects neither the + requesting client nor the origin server, except to improve + performance. When a cache is semantically transparent, the client + receives exactly the same response (except for hop-by-hop headers) + that it would have received had its request been handled directly + by the origin server. + + validator + A protocol element (e.g., an entity tag or a Last-Modified time) + that is used to find out whether a cache entry is an equivalent + copy of an entity. + + upstream/downstream + Upstream and downstream describe the flow of a message: all + messages flow from upstream to downstream. + + + + + +Fielding, et al. Standards Track [Page 11] + +RFC 2616 HTTP/1.1 June 1999 + + + inbound/outbound + Inbound and outbound refer to the request and response paths for + messages: "inbound" means "traveling toward the origin server", + and "outbound" means "traveling toward the user agent" + +1.4 Overall Operation + + The HTTP protocol is a request/response protocol. A client sends a + request to the server in the form of a request method, URI, and + protocol version, followed by a MIME-like message containing request + modifiers, client information, and possible body content over a + connection with a server. The server responds with a status line, + including the message's protocol version and a success or error code, + followed by a MIME-like message containing server information, entity + metainformation, and possible entity-body content. The relationship + between HTTP and MIME is described in appendix 19.4. + + Most HTTP communication is initiated by a user agent and consists of + a request to be applied to a resource on some origin server. In the + simplest case, this may be accomplished via a single connection (v) + between the user agent (UA) and the origin server (O). + + request chain ------------------------> + UA -------------------v------------------- O + <----------------------- response chain + + A more complicated situation occurs when one or more intermediaries + are present in the request/response chain. There are three common + forms of intermediary: proxy, gateway, and tunnel. A proxy is a + forwarding agent, receiving requests for a URI in its absolute form, + rewriting all or part of the message, and forwarding the reformatted + request toward the server identified by the URI. A gateway is a + receiving agent, acting as a layer above some other server(s) and, if + necessary, translating the requests to the underlying server's + protocol. A tunnel acts as a relay point between two connections + without changing the messages; tunnels are used when the + communication needs to pass through an intermediary (such as a + firewall) even when the intermediary cannot understand the contents + of the messages. + + request chain --------------------------------------> + UA -----v----- A -----v----- B -----v----- C -----v----- O + <------------------------------------- response chain + + The figure above shows three intermediaries (A, B, and C) between the + user agent and origin server. A request or response message that + travels the whole chain will pass through four separate connections. + This distinction is important because some HTTP communication options + + + +Fielding, et al. Standards Track [Page 12] + +RFC 2616 HTTP/1.1 June 1999 + + + may apply only to the connection with the nearest, non-tunnel + neighbor, only to the end-points of the chain, or to all connections + along the chain. Although the diagram is linear, each participant may + be engaged in multiple, simultaneous communications. For example, B + may be receiving requests from many clients other than A, and/or + forwarding requests to servers other than C, at the same time that it + is handling A's request. + + Any party to the communication which is not acting as a tunnel may + employ an internal cache for handling requests. The effect of a cache + is that the request/response chain is shortened if one of the + participants along the chain has a cached response applicable to that + request. The following illustrates the resulting chain if B has a + cached copy of an earlier response from O (via C) for a request which + has not been cached by UA or A. + + request chain ----------> + UA -----v----- A -----v----- B - - - - - - C - - - - - - O + <--------- response chain + + Not all responses are usefully cacheable, and some requests may + contain modifiers which place special requirements on cache behavior. + HTTP requirements for cache behavior and cacheable responses are + defined in section 13. + + In fact, there are a wide variety of architectures and configurations + of caches and proxies currently being experimented with or deployed + across the World Wide Web. These systems include national hierarchies + of proxy caches to save transoceanic bandwidth, systems that + broadcast or multicast cache entries, organizations that distribute + subsets of cached data via CD-ROM, and so on. HTTP systems are used + in corporate intranets over high-bandwidth links, and for access via + PDAs with low-power radio links and intermittent connectivity. The + goal of HTTP/1.1 is to support the wide diversity of configurations + already deployed while introducing protocol constructs that meet the + needs of those who build web applications that require high + reliability and, failing that, at least reliable indications of + failure. + + HTTP communication usually takes place over TCP/IP connections. The + default port is TCP 80 [19], but other ports can be used. This does + not preclude HTTP from being implemented on top of any other protocol + on the Internet, or on other networks. HTTP only presumes a reliable + transport; any protocol that provides such guarantees can be used; + the mapping of the HTTP/1.1 request and response structures onto the + transport data units of the protocol in question is outside the scope + of this specification. + + + + +Fielding, et al. Standards Track [Page 13] + +RFC 2616 HTTP/1.1 June 1999 + + + In HTTP/1.0, most implementations used a new connection for each + request/response exchange. In HTTP/1.1, a connection may be used for + one or more request/response exchanges, although connections may be + closed for a variety of reasons (see section 8.1). + +2 Notational Conventions and Generic Grammar + +2.1 Augmented BNF + + All of the mechanisms specified in this document are described in + both prose and an augmented Backus-Naur Form (BNF) similar to that + used by RFC 822 [9]. Implementors will need to be familiar with the + notation in order to understand this specification. The augmented BNF + includes the following constructs: + + name = definition + The name of a rule is simply the name itself (without any + enclosing "<" and ">") and is separated from its definition by the + equal "=" character. White space is only significant in that + indentation of continuation lines is used to indicate a rule + definition that spans more than one line. Certain basic rules are + in uppercase, such as SP, LWS, HT, CRLF, DIGIT, ALPHA, etc. Angle + brackets are used within definitions whenever their presence will + facilitate discerning the use of rule names. + + "literal" + Quotation marks surround literal text. Unless stated otherwise, + the text is case-insensitive. + + rule1 | rule2 + Elements separated by a bar ("|") are alternatives, e.g., "yes | + no" will accept yes or no. + + (rule1 rule2) + Elements enclosed in parentheses are treated as a single element. + Thus, "(elem (foo | bar) elem)" allows the token sequences "elem + foo elem" and "elem bar elem". + + *rule + The character "*" preceding an element indicates repetition. The + full form is "*element" indicating at least and at most + occurrences of element. Default values are 0 and infinity so + that "*(element)" allows any number, including zero; "1*element" + requires at least one; and "1*2element" allows one or two. + + [rule] + Square brackets enclose optional elements; "[foo bar]" is + equivalent to "*1(foo bar)". + + + +Fielding, et al. Standards Track [Page 14] + +RFC 2616 HTTP/1.1 June 1999 + + + N rule + Specific repetition: "(element)" is equivalent to + "*(element)"; that is, exactly occurrences of (element). + Thus 2DIGIT is a 2-digit number, and 3ALPHA is a string of three + alphabetic characters. + + #rule + A construct "#" is defined, similar to "*", for defining lists of + elements. The full form is "#element" indicating at least + and at most elements, each separated by one or more commas + (",") and OPTIONAL linear white space (LWS). This makes the usual + form of lists very easy; a rule such as + ( *LWS element *( *LWS "," *LWS element )) + can be shown as + 1#element + Wherever this construct is used, null elements are allowed, but do + not contribute to the count of elements present. That is, + "(element), , (element) " is permitted, but counts as only two + elements. Therefore, where at least one element is required, at + least one non-null element MUST be present. Default values are 0 + and infinity so that "#element" allows any number, including zero; + "1#element" requires at least one; and "1#2element" allows one or + two. + + ; comment + A semi-colon, set off some distance to the right of rule text, + starts a comment that continues to the end of line. This is a + simple way of including useful notes in parallel with the + specifications. + + implied *LWS + The grammar described by this specification is word-based. Except + where noted otherwise, linear white space (LWS) can be included + between any two adjacent words (token or quoted-string), and + between adjacent words and separators, without changing the + interpretation of a field. At least one delimiter (LWS and/or + + separators) MUST exist between any two tokens (for the definition + of "token" below), since they would otherwise be interpreted as a + single token. + +2.2 Basic Rules + + The following rules are used throughout this specification to + describe basic parsing constructs. The US-ASCII coded character set + is defined by ANSI X3.4-1986 [21]. + + + + + +Fielding, et al. Standards Track [Page 15] + +RFC 2616 HTTP/1.1 June 1999 + + + OCTET = + CHAR = + UPALPHA = + LOALPHA = + ALPHA = UPALPHA | LOALPHA + DIGIT = + CTL = + CR = + LF = + SP = + HT = + <"> = + + HTTP/1.1 defines the sequence CR LF as the end-of-line marker for all + protocol elements except the entity-body (see appendix 19.3 for + tolerant applications). The end-of-line marker within an entity-body + is defined by its associated media type, as described in section 3.7. + + CRLF = CR LF + + HTTP/1.1 header field values can be folded onto multiple lines if the + continuation line begins with a space or horizontal tab. All linear + white space, including folding, has the same semantics as SP. A + recipient MAY replace any linear white space with a single SP before + interpreting the field value or forwarding the message downstream. + + LWS = [CRLF] 1*( SP | HT ) + + The TEXT rule is only used for descriptive field contents and values + that are not intended to be interpreted by the message parser. Words + of *TEXT MAY contain characters from character sets other than ISO- + 8859-1 [22] only when encoded according to the rules of RFC 2047 + [14]. + + TEXT = + + A CRLF is allowed in the definition of TEXT only as part of a header + field continuation. It is expected that the folding LWS will be + replaced with a single SP before interpretation of the TEXT value. + + Hexadecimal numeric characters are used in several protocol elements. + + HEX = "A" | "B" | "C" | "D" | "E" | "F" + | "a" | "b" | "c" | "d" | "e" | "f" | DIGIT + + + + + +Fielding, et al. Standards Track [Page 16] + +RFC 2616 HTTP/1.1 June 1999 + + + Many HTTP/1.1 header field values consist of words separated by LWS + or special characters. These special characters MUST be in a quoted + string to be used within a parameter value (as defined in section + 3.6). + + token = 1* + separators = "(" | ")" | "<" | ">" | "@" + | "," | ";" | ":" | "\" | <"> + | "/" | "[" | "]" | "?" | "=" + | "{" | "}" | SP | HT + + Comments can be included in some HTTP header fields by surrounding + the comment text with parentheses. Comments are only allowed in + fields containing "comment" as part of their field value definition. + In all other fields, parentheses are considered part of the field + value. + + comment = "(" *( ctext | quoted-pair | comment ) ")" + ctext = + + A string of text is parsed as a single word if it is quoted using + double-quote marks. + + quoted-string = ( <"> *(qdtext | quoted-pair ) <"> ) + qdtext = > + + The backslash character ("\") MAY be used as a single-character + quoting mechanism only within quoted-string and comment constructs. + + quoted-pair = "\" CHAR + +3 Protocol Parameters + +3.1 HTTP Version + + HTTP uses a "." numbering scheme to indicate versions + of the protocol. The protocol versioning policy is intended to allow + the sender to indicate the format of a message and its capacity for + understanding further HTTP communication, rather than the features + obtained via that communication. No change is made to the version + number for the addition of message components which do not affect + communication behavior or which only add to extensible field values. + The number is incremented when the changes made to the + protocol add features which do not change the general message parsing + algorithm, but which may add to the message semantics and imply + additional capabilities of the sender. The number is + incremented when the format of a message within the protocol is + changed. See RFC 2145 [36] for a fuller explanation. + + + +Fielding, et al. Standards Track [Page 17] + +RFC 2616 HTTP/1.1 June 1999 + + + The version of an HTTP message is indicated by an HTTP-Version field + in the first line of the message. + + HTTP-Version = "HTTP" "/" 1*DIGIT "." 1*DIGIT + + Note that the major and minor numbers MUST be treated as separate + integers and that each MAY be incremented higher than a single digit. + Thus, HTTP/2.4 is a lower version than HTTP/2.13, which in turn is + lower than HTTP/12.3. Leading zeros MUST be ignored by recipients and + MUST NOT be sent. + + An application that sends a request or response message that includes + HTTP-Version of "HTTP/1.1" MUST be at least conditionally compliant + with this specification. Applications that are at least conditionally + compliant with this specification SHOULD use an HTTP-Version of + "HTTP/1.1" in their messages, and MUST do so for any message that is + not compatible with HTTP/1.0. For more details on when to send + specific HTTP-Version values, see RFC 2145 [36]. + + The HTTP version of an application is the highest HTTP version for + which the application is at least conditionally compliant. + + Proxy and gateway applications need to be careful when forwarding + messages in protocol versions different from that of the application. + Since the protocol version indicates the protocol capability of the + sender, a proxy/gateway MUST NOT send a message with a version + indicator which is greater than its actual version. If a higher + version request is received, the proxy/gateway MUST either downgrade + the request version, or respond with an error, or switch to tunnel + behavior. + + Due to interoperability problems with HTTP/1.0 proxies discovered + since the publication of RFC 2068[33], caching proxies MUST, gateways + MAY, and tunnels MUST NOT upgrade the request to the highest version + they support. The proxy/gateway's response to that request MUST be in + the same major version as the request. + + Note: Converting between versions of HTTP may involve modification + of header fields required or forbidden by the versions involved. + +3.2 Uniform Resource Identifiers + + URIs have been known by many names: WWW addresses, Universal Document + Identifiers, Universal Resource Identifiers [3], and finally the + combination of Uniform Resource Locators (URL) [4] and Names (URN) + [20]. As far as HTTP is concerned, Uniform Resource Identifiers are + simply formatted strings which identify--via name, location, or any + other characteristic--a resource. + + + +Fielding, et al. Standards Track [Page 18] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.1 General Syntax + + URIs in HTTP can be represented in absolute form or relative to some + known base URI [11], depending upon the context of their use. The two + forms are differentiated by the fact that absolute URIs always begin + with a scheme name followed by a colon. For definitive information on + URL syntax and semantics, see "Uniform Resource Identifiers (URI): + Generic Syntax and Semantics," RFC 2396 [42] (which replaces RFCs + 1738 [4] and RFC 1808 [11]). This specification adopts the + definitions of "URI-reference", "absoluteURI", "relativeURI", "port", + "host","abs_path", "rel_path", and "authority" from that + specification. + + The HTTP protocol does not place any a priori limit on the length of + a URI. Servers MUST be able to handle the URI of any resource they + serve, and SHOULD be able to handle URIs of unbounded length if they + provide GET-based forms that could generate such URIs. A server + SHOULD return 414 (Request-URI Too Long) status if a URI is longer + than the server can handle (see section 10.4.15). + + Note: Servers ought to be cautious about depending on URI lengths + above 255 bytes, because some older client or proxy + implementations might not properly support these lengths. + +3.2.2 http URL + + The "http" scheme is used to locate network resources via the HTTP + protocol. This section defines the scheme-specific syntax and + semantics for http URLs. + + http_URL = "http:" "//" host [ ":" port ] [ abs_path [ "?" query ]] + + If the port is empty or not given, port 80 is assumed. The semantics + are that the identified resource is located at the server listening + for TCP connections on that port of that host, and the Request-URI + for the resource is abs_path (section 5.1.2). The use of IP addresses + in URLs SHOULD be avoided whenever possible (see RFC 1900 [24]). If + the abs_path is not present in the URL, it MUST be given as "/" when + used as a Request-URI for a resource (section 5.1.2). If a proxy + receives a host name which is not a fully qualified domain name, it + MAY add its domain to the host name it received. If a proxy receives + a fully qualified domain name, the proxy MUST NOT change the host + name. + + + + + + + + +Fielding, et al. Standards Track [Page 19] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.3 URI Comparison + + When comparing two URIs to decide if they match or not, a client + SHOULD use a case-sensitive octet-by-octet comparison of the entire + URIs, with these exceptions: + + - A port that is empty or not given is equivalent to the default + port for that URI-reference; + + - Comparisons of host names MUST be case-insensitive; + + - Comparisons of scheme names MUST be case-insensitive; + + - An empty abs_path is equivalent to an abs_path of "/". + + Characters other than those in the "reserved" and "unsafe" sets (see + RFC 2396 [42]) are equivalent to their ""%" HEX HEX" encoding. + + For example, the following three URIs are equivalent: + + http://abc.com:80/~smith/home.html + http://ABC.com/%7Esmith/home.html + http://ABC.com:/%7esmith/home.html + +3.3 Date/Time Formats + +3.3.1 Full Date + + HTTP applications have historically allowed three different formats + for the representation of date/time stamps: + + Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123 + Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036 + Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format + + The first format is preferred as an Internet standard and represents + a fixed-length subset of that defined by RFC 1123 [8] (an update to + RFC 822 [9]). The second format is in common use, but is based on the + obsolete RFC 850 [12] date format and lacks a four-digit year. + HTTP/1.1 clients and servers that parse the date value MUST accept + all three formats (for compatibility with HTTP/1.0), though they MUST + only generate the RFC 1123 format for representing HTTP-date values + in header fields. See section 19.3 for further information. + + Note: Recipients of date values are encouraged to be robust in + accepting date values that may have been sent by non-HTTP + applications, as is sometimes the case when retrieving or posting + messages via proxies/gateways to SMTP or NNTP. + + + +Fielding, et al. Standards Track [Page 20] + +RFC 2616 HTTP/1.1 June 1999 + + + All HTTP date/time stamps MUST be represented in Greenwich Mean Time + (GMT), without exception. For the purposes of HTTP, GMT is exactly + equal to UTC (Coordinated Universal Time). This is indicated in the + first two formats by the inclusion of "GMT" as the three-letter + abbreviation for time zone, and MUST be assumed when reading the + asctime format. HTTP-date is case sensitive and MUST NOT include + additional LWS beyond that specifically included as SP in the + grammar. + + HTTP-date = rfc1123-date | rfc850-date | asctime-date + rfc1123-date = wkday "," SP date1 SP time SP "GMT" + rfc850-date = weekday "," SP date2 SP time SP "GMT" + asctime-date = wkday SP date3 SP time SP 4DIGIT + date1 = 2DIGIT SP month SP 4DIGIT + ; day month year (e.g., 02 Jun 1982) + date2 = 2DIGIT "-" month "-" 2DIGIT + ; day-month-year (e.g., 02-Jun-82) + date3 = month SP ( 2DIGIT | ( SP 1DIGIT )) + ; month day (e.g., Jun 2) + time = 2DIGIT ":" 2DIGIT ":" 2DIGIT + ; 00:00:00 - 23:59:59 + wkday = "Mon" | "Tue" | "Wed" + | "Thu" | "Fri" | "Sat" | "Sun" + weekday = "Monday" | "Tuesday" | "Wednesday" + | "Thursday" | "Friday" | "Saturday" | "Sunday" + month = "Jan" | "Feb" | "Mar" | "Apr" + | "May" | "Jun" | "Jul" | "Aug" + | "Sep" | "Oct" | "Nov" | "Dec" + + Note: HTTP requirements for the date/time stamp format apply only + to their usage within the protocol stream. Clients and servers are + not required to use these formats for user presentation, request + logging, etc. + +3.3.2 Delta Seconds + + Some HTTP header fields allow a time value to be specified as an + integer number of seconds, represented in decimal, after the time + that the message was received. + + delta-seconds = 1*DIGIT + +3.4 Character Sets + + HTTP uses the same definition of the term "character set" as that + described for MIME: + + + + + +Fielding, et al. Standards Track [Page 21] + +RFC 2616 HTTP/1.1 June 1999 + + + The term "character set" is used in this document to refer to a + method used with one or more tables to convert a sequence of octets + into a sequence of characters. Note that unconditional conversion in + the other direction is not required, in that not all characters may + be available in a given character set and a character set may provide + more than one sequence of octets to represent a particular character. + This definition is intended to allow various kinds of character + encoding, from simple single-table mappings such as US-ASCII to + complex table switching methods such as those that use ISO-2022's + techniques. However, the definition associated with a MIME character + set name MUST fully specify the mapping to be performed from octets + to characters. In particular, use of external profiling information + to determine the exact mapping is not permitted. + + Note: This use of the term "character set" is more commonly + referred to as a "character encoding." However, since HTTP and + MIME share the same registry, it is important that the terminology + also be shared. + + HTTP character sets are identified by case-insensitive tokens. The + complete set of tokens is defined by the IANA Character Set registry + [19]. + + charset = token + + Although HTTP allows an arbitrary token to be used as a charset + value, any token that has a predefined value within the IANA + Character Set registry [19] MUST represent the character set defined + by that registry. Applications SHOULD limit their use of character + sets to those defined by the IANA registry. + + Implementors should be aware of IETF character set requirements [38] + [41]. + +3.4.1 Missing Charset + + Some HTTP/1.0 software has interpreted a Content-Type header without + charset parameter incorrectly to mean "recipient should guess." + Senders wishing to defeat this behavior MAY include a charset + parameter even when the charset is ISO-8859-1 and SHOULD do so when + it is known that it will not confuse the recipient. + + Unfortunately, some older HTTP/1.0 clients did not deal properly with + an explicit charset parameter. HTTP/1.1 recipients MUST respect the + charset label provided by the sender; and those user agents that have + a provision to "guess" a charset MUST use the charset from the + + + + + +Fielding, et al. Standards Track [Page 22] + +RFC 2616 HTTP/1.1 June 1999 + + + content-type field if they support that charset, rather than the + recipient's preference, when initially displaying a document. See + section 3.7.1. + +3.5 Content Codings + + Content coding values indicate an encoding transformation that has + been or can be applied to an entity. Content codings are primarily + used to allow a document to be compressed or otherwise usefully + transformed without losing the identity of its underlying media type + and without loss of information. Frequently, the entity is stored in + coded form, transmitted directly, and only decoded by the recipient. + + content-coding = token + + All content-coding values are case-insensitive. HTTP/1.1 uses + content-coding values in the Accept-Encoding (section 14.3) and + Content-Encoding (section 14.11) header fields. Although the value + describes the content-coding, what is more important is that it + indicates what decoding mechanism will be required to remove the + encoding. + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + content-coding value tokens. Initially, the registry contains the + following tokens: + + gzip An encoding format produced by the file compression program + "gzip" (GNU zip) as described in RFC 1952 [25]. This format is a + Lempel-Ziv coding (LZ77) with a 32 bit CRC. + + compress + The encoding format produced by the common UNIX file compression + program "compress". This format is an adaptive Lempel-Ziv-Welch + coding (LZW). + + Use of program names for the identification of encoding formats + is not desirable and is discouraged for future encodings. Their + use here is representative of historical practice, not good + design. For compatibility with previous implementations of HTTP, + applications SHOULD consider "x-gzip" and "x-compress" to be + equivalent to "gzip" and "compress" respectively. + + deflate + The "zlib" format defined in RFC 1950 [31] in combination with + the "deflate" compression mechanism described in RFC 1951 [29]. + + + + + + +Fielding, et al. Standards Track [Page 23] + +RFC 2616 HTTP/1.1 June 1999 + + + identity + The default (identity) encoding; the use of no transformation + whatsoever. This content-coding is used only in the Accept- + Encoding header, and SHOULD NOT be used in the Content-Encoding + header. + + New content-coding value tokens SHOULD be registered; to allow + interoperability between clients and servers, specifications of the + content coding algorithms needed to implement a new value SHOULD be + publicly available and adequate for independent implementation, and + conform to the purpose of content coding defined in this section. + +3.6 Transfer Codings + + Transfer-coding values are used to indicate an encoding + transformation that has been, can be, or may need to be applied to an + entity-body in order to ensure "safe transport" through the network. + This differs from a content coding in that the transfer-coding is a + property of the message, not of the original entity. + + transfer-coding = "chunked" | transfer-extension + transfer-extension = token *( ";" parameter ) + + Parameters are in the form of attribute/value pairs. + + parameter = attribute "=" value + attribute = token + value = token | quoted-string + + All transfer-coding values are case-insensitive. HTTP/1.1 uses + transfer-coding values in the TE header field (section 14.39) and in + the Transfer-Encoding header field (section 14.41). + + Whenever a transfer-coding is applied to a message-body, the set of + transfer-codings MUST include "chunked", unless the message is + terminated by closing the connection. When the "chunked" transfer- + coding is used, it MUST be the last transfer-coding applied to the + message-body. The "chunked" transfer-coding MUST NOT be applied more + than once to a message-body. These rules allow the recipient to + determine the transfer-length of the message (section 4.4). + + Transfer-codings are analogous to the Content-Transfer-Encoding + values of MIME [7], which were designed to enable safe transport of + binary data over a 7-bit transport service. However, safe transport + has a different focus for an 8bit-clean transfer protocol. In HTTP, + the only unsafe characteristic of message-bodies is the difficulty in + determining the exact body length (section 7.2.2), or the desire to + encrypt data over a shared transport. + + + +Fielding, et al. Standards Track [Page 24] + +RFC 2616 HTTP/1.1 June 1999 + + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + transfer-coding value tokens. Initially, the registry contains the + following tokens: "chunked" (section 3.6.1), "identity" (section + 3.6.2), "gzip" (section 3.5), "compress" (section 3.5), and "deflate" + (section 3.5). + + New transfer-coding value tokens SHOULD be registered in the same way + as new content-coding value tokens (section 3.5). + + A server which receives an entity-body with a transfer-coding it does + not understand SHOULD return 501 (Unimplemented), and close the + connection. A server MUST NOT send transfer-codings to an HTTP/1.0 + client. + +3.6.1 Chunked Transfer Coding + + The chunked encoding modifies the body of a message in order to + transfer it as a series of chunks, each with its own size indicator, + followed by an OPTIONAL trailer containing entity-header fields. This + allows dynamically produced content to be transferred along with the + information necessary for the recipient to verify that it has + received the full message. + + Chunked-Body = *chunk + last-chunk + trailer + CRLF + + chunk = chunk-size [ chunk-extension ] CRLF + chunk-data CRLF + chunk-size = 1*HEX + last-chunk = 1*("0") [ chunk-extension ] CRLF + + chunk-extension= *( ";" chunk-ext-name [ "=" chunk-ext-val ] ) + chunk-ext-name = token + chunk-ext-val = token | quoted-string + chunk-data = chunk-size(OCTET) + trailer = *(entity-header CRLF) + + The chunk-size field is a string of hex digits indicating the size of + the chunk. The chunked encoding is ended by any chunk whose size is + zero, followed by the trailer, which is terminated by an empty line. + + The trailer allows the sender to include additional HTTP header + fields at the end of the message. The Trailer header field can be + used to indicate which header fields are included in a trailer (see + section 14.40). + + + + +Fielding, et al. Standards Track [Page 25] + +RFC 2616 HTTP/1.1 June 1999 + + + A server using chunked transfer-coding in a response MUST NOT use the + trailer for any header fields unless at least one of the following is + true: + + a)the request included a TE header field that indicates "trailers" is + acceptable in the transfer-coding of the response, as described in + section 14.39; or, + + b)the server is the origin server for the response, the trailer + fields consist entirely of optional metadata, and the recipient + could use the message (in a manner acceptable to the origin server) + without receiving this metadata. In other words, the origin server + is willing to accept the possibility that the trailer fields might + be silently discarded along the path to the client. + + This requirement prevents an interoperability failure when the + message is being received by an HTTP/1.1 (or later) proxy and + forwarded to an HTTP/1.0 recipient. It avoids a situation where + compliance with the protocol would have necessitated a possibly + infinite buffer on the proxy. + + An example process for decoding a Chunked-Body is presented in + appendix 19.4.6. + + All HTTP/1.1 applications MUST be able to receive and decode the + "chunked" transfer-coding, and MUST ignore chunk-extension extensions + they do not understand. + +3.7 Media Types + + HTTP uses Internet Media Types [17] in the Content-Type (section + 14.17) and Accept (section 14.1) header fields in order to provide + open and extensible data typing and type negotiation. + + media-type = type "/" subtype *( ";" parameter ) + type = token + subtype = token + + Parameters MAY follow the type/subtype in the form of attribute/value + pairs (as defined in section 3.6). + + The type, subtype, and parameter attribute names are case- + insensitive. Parameter values might or might not be case-sensitive, + depending on the semantics of the parameter name. Linear white space + (LWS) MUST NOT be used between the type and subtype, nor between an + attribute and its value. The presence or absence of a parameter might + be significant to the processing of a media-type, depending on its + definition within the media type registry. + + + +Fielding, et al. Standards Track [Page 26] + +RFC 2616 HTTP/1.1 June 1999 + + + Note that some older HTTP applications do not recognize media type + parameters. When sending data to older HTTP applications, + implementations SHOULD only use media type parameters when they are + required by that type/subtype definition. + + Media-type values are registered with the Internet Assigned Number + Authority (IANA [19]). The media type registration process is + outlined in RFC 1590 [17]. Use of non-registered media types is + discouraged. + +3.7.1 Canonicalization and Text Defaults + + Internet media types are registered with a canonical form. An + entity-body transferred via HTTP messages MUST be represented in the + appropriate canonical form prior to its transmission except for + "text" types, as defined in the next paragraph. + + When in canonical form, media subtypes of the "text" type use CRLF as + the text line break. HTTP relaxes this requirement and allows the + transport of text media with plain CR or LF alone representing a line + break when it is done consistently for an entire entity-body. HTTP + applications MUST accept CRLF, bare CR, and bare LF as being + representative of a line break in text media received via HTTP. In + addition, if the text is represented in a character set that does not + use octets 13 and 10 for CR and LF respectively, as is the case for + some multi-byte character sets, HTTP allows the use of whatever octet + sequences are defined by that character set to represent the + equivalent of CR and LF for line breaks. This flexibility regarding + line breaks applies only to text media in the entity-body; a bare CR + or LF MUST NOT be substituted for CRLF within any of the HTTP control + structures (such as header fields and multipart boundaries). + + If an entity-body is encoded with a content-coding, the underlying + data MUST be in a form defined above prior to being encoded. + + The "charset" parameter is used with some media types to define the + character set (section 3.4) of the data. When no explicit charset + parameter is provided by the sender, media subtypes of the "text" + type are defined to have a default charset value of "ISO-8859-1" when + received via HTTP. Data in character sets other than "ISO-8859-1" or + its subsets MUST be labeled with an appropriate charset value. See + section 3.4.1 for compatibility problems. + +3.7.2 Multipart Types + + MIME provides for a number of "multipart" types -- encapsulations of + one or more entities within a single message-body. All multipart + types share a common syntax, as defined in section 5.1.1 of RFC 2046 + + + +Fielding, et al. Standards Track [Page 27] + +RFC 2616 HTTP/1.1 June 1999 + + + [40], and MUST include a boundary parameter as part of the media type + value. The message body is itself a protocol element and MUST + therefore use only CRLF to represent line breaks between body-parts. + Unlike in RFC 2046, the epilogue of any multipart message MUST be + empty; HTTP applications MUST NOT transmit the epilogue (even if the + original multipart contains an epilogue). These restrictions exist in + order to preserve the self-delimiting nature of a multipart message- + body, wherein the "end" of the message-body is indicated by the + ending multipart boundary. + + In general, HTTP treats a multipart message-body no differently than + any other media type: strictly as payload. The one exception is the + "multipart/byteranges" type (appendix 19.2) when it appears in a 206 + (Partial Content) response, which will be interpreted by some HTTP + caching mechanisms as described in sections 13.5.4 and 14.16. In all + other cases, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + The MIME header fields within each body-part of a multipart message- + body do not have any significance to HTTP beyond that defined by + their MIME semantics. + + In general, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + If an application receives an unrecognized multipart subtype, the + application MUST treat it as being equivalent to "multipart/mixed". + + Note: The "multipart/form-data" type has been specifically defined + for carrying form data suitable for processing via the POST + request method, as described in RFC 1867 [15]. + +3.8 Product Tokens + + Product tokens are used to allow communicating applications to + identify themselves by software name and version. Most fields using + product tokens also allow sub-products which form a significant part + of the application to be listed, separated by white space. By + convention, the products are listed in order of their significance + for identifying the application. + + product = token ["/" product-version] + product-version = token + + Examples: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + Server: Apache/0.8.4 + + + + + +Fielding, et al. Standards Track [Page 28] + +RFC 2616 HTTP/1.1 June 1999 + + + Product tokens SHOULD be short and to the point. They MUST NOT be + used for advertising or other non-essential information. Although any + token character MAY appear in a product-version, this token SHOULD + only be used for a version identifier (i.e., successive versions of + the same product SHOULD only differ in the product-version portion of + the product value). + +3.9 Quality Values + + HTTP content negotiation (section 12) uses short "floating point" + numbers to indicate the relative importance ("weight") of various + negotiable parameters. A weight is normalized to a real number in + the range 0 through 1, where 0 is the minimum and 1 the maximum + value. If a parameter has a quality value of 0, then content with + this parameter is `not acceptable' for the client. HTTP/1.1 + applications MUST NOT generate more than three digits after the + decimal point. User configuration of these values SHOULD also be + limited in this fashion. + + qvalue = ( "0" [ "." 0*3DIGIT ] ) + | ( "1" [ "." 0*3("0") ] ) + + "Quality values" is a misnomer, since these values merely represent + relative degradation in desired quality. + +3.10 Language Tags + + A language tag identifies a natural language spoken, written, or + otherwise conveyed by human beings for communication of information + to other human beings. Computer languages are explicitly excluded. + HTTP uses language tags within the Accept-Language and Content- + Language fields. + + The syntax and registry of HTTP language tags is the same as that + defined by RFC 1766 [1]. In summary, a language tag is composed of 1 + or more parts: A primary language tag and a possibly empty series of + subtags: + + language-tag = primary-tag *( "-" subtag ) + primary-tag = 1*8ALPHA + subtag = 1*8ALPHA + + White space is not allowed within the tag and all tags are case- + insensitive. The name space of language tags is administered by the + IANA. Example tags include: + + en, en-US, en-cockney, i-cherokee, x-pig-latin + + + + +Fielding, et al. Standards Track [Page 29] + +RFC 2616 HTTP/1.1 June 1999 + + + where any two-letter primary-tag is an ISO-639 language abbreviation + and any two-letter initial subtag is an ISO-3166 country code. (The + last three tags above are not registered tags; all but the last are + examples of tags which could be registered in future.) + +3.11 Entity Tags + + Entity tags are used for comparing two or more entities from the same + requested resource. HTTP/1.1 uses entity tags in the ETag (section + 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and + If-Range (section 14.27) header fields. The definition of how they + are used and compared as cache validators is in section 13.3.3. An + entity tag consists of an opaque quoted string, possibly prefixed by + a weakness indicator. + + entity-tag = [ weak ] opaque-tag + weak = "W/" + opaque-tag = quoted-string + + A "strong entity tag" MAY be shared by two entities of a resource + only if they are equivalent by octet equality. + + A "weak entity tag," indicated by the "W/" prefix, MAY be shared by + two entities of a resource only if the entities are equivalent and + could be substituted for each other with no significant change in + semantics. A weak entity tag can only be used for weak comparison. + + An entity tag MUST be unique across all versions of all entities + associated with a particular resource. A given entity tag value MAY + be used for entities obtained by requests on different URIs. The use + of the same entity tag value in conjunction with entities obtained by + requests on different URIs does not imply the equivalence of those + entities. + +3.12 Range Units + + HTTP/1.1 allows a client to request that only part (a range of) the + response entity be included within the response. HTTP/1.1 uses range + units in the Range (section 14.35) and Content-Range (section 14.16) + header fields. An entity can be broken down into subranges according + to various structural units. + + range-unit = bytes-unit | other-range-unit + bytes-unit = "bytes" + other-range-unit = token + + The only range unit defined by HTTP/1.1 is "bytes". HTTP/1.1 + implementations MAY ignore ranges specified using other units. + + + +Fielding, et al. Standards Track [Page 30] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 has been designed to allow implementations of applications + that do not depend on knowledge of ranges. + +4 HTTP Message + +4.1 Message Types + + HTTP messages consist of requests from client to server and responses + from server to client. + + HTTP-message = Request | Response ; HTTP/1.1 messages + + Request (section 5) and Response (section 6) messages use the generic + message format of RFC 822 [9] for transferring entities (the payload + of the message). Both types of message consist of a start-line, zero + or more header fields (also known as "headers"), an empty line (i.e., + a line with nothing preceding the CRLF) indicating the end of the + header fields, and possibly a message-body. + + generic-message = start-line + *(message-header CRLF) + CRLF + [ message-body ] + start-line = Request-Line | Status-Line + + In the interest of robustness, servers SHOULD ignore any empty + line(s) received where a Request-Line is expected. In other words, if + the server is reading the protocol stream at the beginning of a + message and receives a CRLF first, it should ignore the CRLF. + + Certain buggy HTTP/1.0 client implementations generate extra CRLF's + after a POST request. To restate what is explicitly forbidden by the + BNF, an HTTP/1.1 client MUST NOT preface or follow a request with an + extra CRLF. + +4.2 Message Headers + + HTTP header fields, which include general-header (section 4.5), + request-header (section 5.3), response-header (section 6.2), and + entity-header (section 7.1) fields, follow the same generic format as + that given in Section 3.1 of RFC 822 [9]. Each header field consists + of a name followed by a colon (":") and the field value. Field names + are case-insensitive. The field value MAY be preceded by any amount + of LWS, though a single SP is preferred. Header fields can be + extended over multiple lines by preceding each extra line with at + least one SP or HT. Applications ought to follow "common form", where + one is known or indicated, when generating HTTP constructs, since + there might exist some implementations that fail to accept anything + + + +Fielding, et al. Standards Track [Page 31] + +RFC 2616 HTTP/1.1 June 1999 + + + beyond the common forms. + + message-header = field-name ":" [ field-value ] + field-name = token + field-value = *( field-content | LWS ) + field-content = + + The field-content does not include any leading or trailing LWS: + linear white space occurring before the first non-whitespace + character of the field-value or after the last non-whitespace + character of the field-value. Such leading or trailing LWS MAY be + removed without changing the semantics of the field value. Any LWS + that occurs between field-content MAY be replaced with a single SP + before interpreting the field value or forwarding the message + downstream. + + The order in which header fields with differing field names are + received is not significant. However, it is "good practice" to send + general-header fields first, followed by request-header or response- + header fields, and ending with the entity-header fields. + + Multiple message-header fields with the same field-name MAY be + present in a message if and only if the entire field-value for that + header field is defined as a comma-separated list [i.e., #(values)]. + It MUST be possible to combine the multiple header fields into one + "field-name: field-value" pair, without changing the semantics of the + message, by appending each subsequent field-value to the first, each + separated by a comma. The order in which header fields with the same + field-name are received is therefore significant to the + interpretation of the combined field value, and thus a proxy MUST NOT + change the order of these field values when a message is forwarded. + +4.3 Message Body + + The message-body (if any) of an HTTP message is used to carry the + entity-body associated with the request or response. The message-body + differs from the entity-body only when a transfer-coding has been + applied, as indicated by the Transfer-Encoding header field (section + 14.41). + + message-body = entity-body + | + + Transfer-Encoding MUST be used to indicate any transfer-codings + applied by an application to ensure safe and proper transfer of the + message. Transfer-Encoding is a property of the message, not of the + + + +Fielding, et al. Standards Track [Page 32] + +RFC 2616 HTTP/1.1 June 1999 + + + entity, and thus MAY be added or removed by any application along the + request/response chain. (However, section 3.6 places restrictions on + when certain transfer-codings may be used.) + + The rules for when a message-body is allowed in a message differ for + requests and responses. + + The presence of a message-body in a request is signaled by the + inclusion of a Content-Length or Transfer-Encoding header field in + the request's message-headers. A message-body MUST NOT be included in + a request if the specification of the request method (section 5.1.1) + does not allow sending an entity-body in requests. A server SHOULD + read and forward a message-body on any request; if the request method + does not include defined semantics for an entity-body, then the + message-body SHOULD be ignored when handling the request. + + For response messages, whether or not a message-body is included with + a message is dependent on both the request method and the response + status code (section 6.1.1). All responses to the HEAD request method + MUST NOT include a message-body, even though the presence of entity- + header fields might lead one to believe they do. All 1xx + (informational), 204 (no content), and 304 (not modified) responses + MUST NOT include a message-body. All other responses do include a + message-body, although it MAY be of zero length. + +4.4 Message Length + + The transfer-length of a message is the length of the message-body as + it appears in the message; that is, after any transfer-codings have + been applied. When a message-body is included with a message, the + transfer-length of that body is determined by one of the following + (in order of precedence): + + 1.Any response message which "MUST NOT" include a message-body (such + as the 1xx, 204, and 304 responses and any response to a HEAD + request) is always terminated by the first empty line after the + header fields, regardless of the entity-header fields present in + the message. + + 2.If a Transfer-Encoding header field (section 14.41) is present and + has any value other than "identity", then the transfer-length is + defined by use of the "chunked" transfer-coding (section 3.6), + unless the message is terminated by closing the connection. + + 3.If a Content-Length header field (section 14.13) is present, its + decimal value in OCTETs represents both the entity-length and the + transfer-length. The Content-Length header field MUST NOT be sent + if these two lengths are different (i.e., if a Transfer-Encoding + + + +Fielding, et al. Standards Track [Page 33] + +RFC 2616 HTTP/1.1 June 1999 + + + header field is present). If a message is received with both a + Transfer-Encoding header field and a Content-Length header field, + the latter MUST be ignored. + + 4.If the message uses the media type "multipart/byteranges", and the + ransfer-length is not otherwise specified, then this self- + elimiting media type defines the transfer-length. This media type + UST NOT be used unless the sender knows that the recipient can arse + it; the presence in a request of a Range header with ultiple byte- + range specifiers from a 1.1 client implies that the lient can parse + multipart/byteranges responses. + + A range header might be forwarded by a 1.0 proxy that does not + understand multipart/byteranges; in this case the server MUST + delimit the message using methods defined in items 1,3 or 5 of + this section. + + 5.By the server closing the connection. (Closing the connection + cannot be used to indicate the end of a request body, since that + would leave no possibility for the server to send back a response.) + + For compatibility with HTTP/1.0 applications, HTTP/1.1 requests + containing a message-body MUST include a valid Content-Length header + field unless the server is known to be HTTP/1.1 compliant. If a + request contains a message-body and a Content-Length is not given, + the server SHOULD respond with 400 (bad request) if it cannot + determine the length of the message, or with 411 (length required) if + it wishes to insist on receiving a valid Content-Length. + + All HTTP/1.1 applications that receive entities MUST accept the + "chunked" transfer-coding (section 3.6), thus allowing this mechanism + to be used for messages when the message length cannot be determined + in advance. + + Messages MUST NOT include both a Content-Length header field and a + non-identity transfer-coding. If the message does include a non- + identity transfer-coding, the Content-Length MUST be ignored. + + When a Content-Length is given in a message where a message-body is + allowed, its field value MUST exactly match the number of OCTETs in + the message-body. HTTP/1.1 user agents MUST notify the user when an + invalid length is received and detected. + +4.5 General Header Fields + + There are a few header fields which have general applicability for + both request and response messages, but which do not apply to the + entity being transferred. These header fields apply only to the + + + +Fielding, et al. Standards Track [Page 34] + +RFC 2616 HTTP/1.1 June 1999 + + + message being transmitted. + + general-header = Cache-Control ; Section 14.9 + | Connection ; Section 14.10 + | Date ; Section 14.18 + | Pragma ; Section 14.32 + | Trailer ; Section 14.40 + | Transfer-Encoding ; Section 14.41 + | Upgrade ; Section 14.42 + | Via ; Section 14.45 + | Warning ; Section 14.46 + + General-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields may be given the semantics of general + header fields if all parties in the communication recognize them to + be general-header fields. Unrecognized header fields are treated as + entity-header fields. + +5 Request + + A request message from a client to a server includes, within the + first line of that message, the method to be applied to the resource, + the identifier of the resource, and the protocol version in use. + + Request = Request-Line ; Section 5.1 + *(( general-header ; Section 4.5 + | request-header ; Section 5.3 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 4.3 + +5.1 Request-Line + + The Request-Line begins with a method token, followed by the + Request-URI and the protocol version, and ending with CRLF. The + elements are separated by SP characters. No CR or LF is allowed + except in the final CRLF sequence. + + Request-Line = Method SP Request-URI SP HTTP-Version CRLF + + + + + + + + + + + +Fielding, et al. Standards Track [Page 35] + +RFC 2616 HTTP/1.1 June 1999 + + +5.1.1 Method + + The Method token indicates the method to be performed on the + resource identified by the Request-URI. The method is case-sensitive. + + Method = "OPTIONS" ; Section 9.2 + | "GET" ; Section 9.3 + | "HEAD" ; Section 9.4 + | "POST" ; Section 9.5 + | "PUT" ; Section 9.6 + | "DELETE" ; Section 9.7 + | "TRACE" ; Section 9.8 + | "CONNECT" ; Section 9.9 + | extension-method + extension-method = token + + The list of methods allowed by a resource can be specified in an + Allow header field (section 14.7). The return code of the response + always notifies the client whether a method is currently allowed on a + resource, since the set of allowed methods can change dynamically. An + origin server SHOULD return the status code 405 (Method Not Allowed) + if the method is known by the origin server but not allowed for the + requested resource, and 501 (Not Implemented) if the method is + unrecognized or not implemented by the origin server. The methods GET + and HEAD MUST be supported by all general-purpose servers. All other + methods are OPTIONAL; however, if the above methods are implemented, + they MUST be implemented with the same semantics as those specified + in section 9. + +5.1.2 Request-URI + + The Request-URI is a Uniform Resource Identifier (section 3.2) and + identifies the resource upon which to apply the request. + + Request-URI = "*" | absoluteURI | abs_path | authority + + The four options for Request-URI are dependent on the nature of the + request. The asterisk "*" means that the request does not apply to a + particular resource, but to the server itself, and is only allowed + when the method used does not necessarily apply to a resource. One + example would be + + OPTIONS * HTTP/1.1 + + The absoluteURI form is REQUIRED when the request is being made to a + proxy. The proxy is requested to forward the request or service it + from a valid cache, and return the response. Note that the proxy MAY + forward the request on to another proxy or directly to the server + + + +Fielding, et al. Standards Track [Page 36] + +RFC 2616 HTTP/1.1 June 1999 + + + specified by the absoluteURI. In order to avoid request loops, a + proxy MUST be able to recognize all of its server names, including + any aliases, local variations, and the numeric IP address. An example + Request-Line would be: + + GET http://www.w3.org/pub/WWW/TheProject.html HTTP/1.1 + + To allow for transition to absoluteURIs in all requests in future + versions of HTTP, all HTTP/1.1 servers MUST accept the absoluteURI + form in requests, even though HTTP/1.1 clients will only generate + them in requests to proxies. + + The authority form is only used by the CONNECT method (section 9.9). + + The most common form of Request-URI is that used to identify a + resource on an origin server or gateway. In this case the absolute + path of the URI MUST be transmitted (see section 3.2.1, abs_path) as + the Request-URI, and the network location of the URI (authority) MUST + be transmitted in a Host header field. For example, a client wishing + to retrieve the resource above directly from the origin server would + create a TCP connection to port 80 of the host "www.w3.org" and send + the lines: + + GET /pub/WWW/TheProject.html HTTP/1.1 + Host: www.w3.org + + followed by the remainder of the Request. Note that the absolute path + cannot be empty; if none is present in the original URI, it MUST be + given as "/" (the server root). + + The Request-URI is transmitted in the format specified in section + 3.2.1. If the Request-URI is encoded using the "% HEX HEX" encoding + [42], the origin server MUST decode the Request-URI in order to + properly interpret the request. Servers SHOULD respond to invalid + Request-URIs with an appropriate status code. + + A transparent proxy MUST NOT rewrite the "abs_path" part of the + received Request-URI when forwarding it to the next inbound server, + except as noted above to replace a null abs_path with "/". + + Note: The "no rewrite" rule prevents the proxy from changing the + meaning of the request when the origin server is improperly using + a non-reserved URI character for a reserved purpose. Implementors + should be aware that some pre-HTTP/1.1 proxies have been known to + rewrite the Request-URI. + + + + + + +Fielding, et al. Standards Track [Page 37] + +RFC 2616 HTTP/1.1 June 1999 + + +5.2 The Resource Identified by a Request + + The exact resource identified by an Internet request is determined by + examining both the Request-URI and the Host header field. + + An origin server that does not allow resources to differ by the + requested host MAY ignore the Host header field value when + determining the resource identified by an HTTP/1.1 request. (But see + section 19.6.1.1 for other requirements on Host support in HTTP/1.1.) + + An origin server that does differentiate resources based on the host + requested (sometimes referred to as virtual hosts or vanity host + names) MUST use the following rules for determining the requested + resource on an HTTP/1.1 request: + + 1. If Request-URI is an absoluteURI, the host is part of the + Request-URI. Any Host header field value in the request MUST be + ignored. + + 2. If the Request-URI is not an absoluteURI, and the request includes + a Host header field, the host is determined by the Host header + field value. + + 3. If the host as determined by rule 1 or 2 is not a valid host on + the server, the response MUST be a 400 (Bad Request) error message. + + Recipients of an HTTP/1.0 request that lacks a Host header field MAY + attempt to use heuristics (e.g., examination of the URI path for + something unique to a particular host) in order to determine what + exact resource is being requested. + +5.3 Request Header Fields + + The request-header fields allow the client to pass additional + information about the request, and about the client itself, to the + server. These fields act as request modifiers, with semantics + equivalent to the parameters on a programming language method + invocation. + + request-header = Accept ; Section 14.1 + | Accept-Charset ; Section 14.2 + | Accept-Encoding ; Section 14.3 + | Accept-Language ; Section 14.4 + | Authorization ; Section 14.8 + | Expect ; Section 14.20 + | From ; Section 14.22 + | Host ; Section 14.23 + | If-Match ; Section 14.24 + + + +Fielding, et al. Standards Track [Page 38] + +RFC 2616 HTTP/1.1 June 1999 + + + | If-Modified-Since ; Section 14.25 + | If-None-Match ; Section 14.26 + | If-Range ; Section 14.27 + | If-Unmodified-Since ; Section 14.28 + | Max-Forwards ; Section 14.31 + | Proxy-Authorization ; Section 14.34 + | Range ; Section 14.35 + | Referer ; Section 14.36 + | TE ; Section 14.39 + | User-Agent ; Section 14.43 + + Request-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of request- + header fields if all parties in the communication recognize them to + be request-header fields. Unrecognized header fields are treated as + entity-header fields. + +6 Response + + After receiving and interpreting a request message, a server responds + with an HTTP response message. + + Response = Status-Line ; Section 6.1 + *(( general-header ; Section 4.5 + | response-header ; Section 6.2 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 7.2 + +6.1 Status-Line + + The first line of a Response message is the Status-Line, consisting + of the protocol version followed by a numeric status code and its + associated textual phrase, with each element separated by SP + characters. No CR or LF is allowed except in the final CRLF sequence. + + Status-Line = HTTP-Version SP Status-Code SP Reason-Phrase CRLF + +6.1.1 Status Code and Reason Phrase + + The Status-Code element is a 3-digit integer result code of the + attempt to understand and satisfy the request. These codes are fully + defined in section 10. The Reason-Phrase is intended to give a short + textual description of the Status-Code. The Status-Code is intended + for use by automata and the Reason-Phrase is intended for the human + user. The client is not required to examine or display the Reason- + Phrase. + + + +Fielding, et al. Standards Track [Page 39] + +RFC 2616 HTTP/1.1 June 1999 + + + The first digit of the Status-Code defines the class of response. The + last two digits do not have any categorization role. There are 5 + values for the first digit: + + - 1xx: Informational - Request received, continuing process + + - 2xx: Success - The action was successfully received, + understood, and accepted + + - 3xx: Redirection - Further action must be taken in order to + complete the request + + - 4xx: Client Error - The request contains bad syntax or cannot + be fulfilled + + - 5xx: Server Error - The server failed to fulfill an apparently + valid request + + The individual values of the numeric status codes defined for + HTTP/1.1, and an example set of corresponding Reason-Phrase's, are + presented below. The reason phrases listed here are only + recommendations -- they MAY be replaced by local equivalents without + affecting the protocol. + + Status-Code = + "100" ; Section 10.1.1: Continue + | "101" ; Section 10.1.2: Switching Protocols + | "200" ; Section 10.2.1: OK + | "201" ; Section 10.2.2: Created + | "202" ; Section 10.2.3: Accepted + | "203" ; Section 10.2.4: Non-Authoritative Information + | "204" ; Section 10.2.5: No Content + | "205" ; Section 10.2.6: Reset Content + | "206" ; Section 10.2.7: Partial Content + | "300" ; Section 10.3.1: Multiple Choices + | "301" ; Section 10.3.2: Moved Permanently + | "302" ; Section 10.3.3: Found + | "303" ; Section 10.3.4: See Other + | "304" ; Section 10.3.5: Not Modified + | "305" ; Section 10.3.6: Use Proxy + | "307" ; Section 10.3.8: Temporary Redirect + | "400" ; Section 10.4.1: Bad Request + | "401" ; Section 10.4.2: Unauthorized + | "402" ; Section 10.4.3: Payment Required + | "403" ; Section 10.4.4: Forbidden + | "404" ; Section 10.4.5: Not Found + | "405" ; Section 10.4.6: Method Not Allowed + | "406" ; Section 10.4.7: Not Acceptable + + + +Fielding, et al. Standards Track [Page 40] + +RFC 2616 HTTP/1.1 June 1999 + + + | "407" ; Section 10.4.8: Proxy Authentication Required + | "408" ; Section 10.4.9: Request Time-out + | "409" ; Section 10.4.10: Conflict + | "410" ; Section 10.4.11: Gone + | "411" ; Section 10.4.12: Length Required + | "412" ; Section 10.4.13: Precondition Failed + | "413" ; Section 10.4.14: Request Entity Too Large + | "414" ; Section 10.4.15: Request-URI Too Large + | "415" ; Section 10.4.16: Unsupported Media Type + | "416" ; Section 10.4.17: Requested range not satisfiable + | "417" ; Section 10.4.18: Expectation Failed + | "500" ; Section 10.5.1: Internal Server Error + | "501" ; Section 10.5.2: Not Implemented + | "502" ; Section 10.5.3: Bad Gateway + | "503" ; Section 10.5.4: Service Unavailable + | "504" ; Section 10.5.5: Gateway Time-out + | "505" ; Section 10.5.6: HTTP Version not supported + | extension-code + + extension-code = 3DIGIT + Reason-Phrase = * + + HTTP status codes are extensible. HTTP applications are not required + to understand the meaning of all registered status codes, though such + understanding is obviously desirable. However, applications MUST + understand the class of any status code, as indicated by the first + digit, and treat any unrecognized response as being equivalent to the + x00 status code of that class, with the exception that an + unrecognized response MUST NOT be cached. For example, if an + unrecognized status code of 431 is received by the client, it can + safely assume that there was something wrong with its request and + treat the response as if it had received a 400 status code. In such + cases, user agents SHOULD present to the user the entity returned + with the response, since that entity is likely to include human- + readable information which will explain the unusual status. + +6.2 Response Header Fields + + The response-header fields allow the server to pass additional + information about the response which cannot be placed in the Status- + Line. These header fields give information about the server and about + further access to the resource identified by the Request-URI. + + response-header = Accept-Ranges ; Section 14.5 + | Age ; Section 14.6 + | ETag ; Section 14.19 + | Location ; Section 14.30 + | Proxy-Authenticate ; Section 14.33 + + + +Fielding, et al. Standards Track [Page 41] + +RFC 2616 HTTP/1.1 June 1999 + + + | Retry-After ; Section 14.37 + | Server ; Section 14.38 + | Vary ; Section 14.44 + | WWW-Authenticate ; Section 14.47 + + Response-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of response- + header fields if all parties in the communication recognize them to + be response-header fields. Unrecognized header fields are treated as + entity-header fields. + +7 Entity + + Request and Response messages MAY transfer an entity if not otherwise + restricted by the request method or response status code. An entity + consists of entity-header fields and an entity-body, although some + responses will only include the entity-headers. + + In this section, both sender and recipient refer to either the client + or the server, depending on who sends and who receives the entity. + +7.1 Entity Header Fields + + Entity-header fields define metainformation about the entity-body or, + if no body is present, about the resource identified by the request. + Some of this metainformation is OPTIONAL; some might be REQUIRED by + portions of this specification. + + entity-header = Allow ; Section 14.7 + | Content-Encoding ; Section 14.11 + | Content-Language ; Section 14.12 + | Content-Length ; Section 14.13 + | Content-Location ; Section 14.14 + | Content-MD5 ; Section 14.15 + | Content-Range ; Section 14.16 + | Content-Type ; Section 14.17 + | Expires ; Section 14.21 + | Last-Modified ; Section 14.29 + | extension-header + + extension-header = message-header + + The extension-header mechanism allows additional entity-header fields + to be defined without changing the protocol, but these fields cannot + be assumed to be recognizable by the recipient. Unrecognized header + fields SHOULD be ignored by the recipient and MUST be forwarded by + transparent proxies. + + + +Fielding, et al. Standards Track [Page 42] + +RFC 2616 HTTP/1.1 June 1999 + + +7.2 Entity Body + + The entity-body (if any) sent with an HTTP request or response is in + a format and encoding defined by the entity-header fields. + + entity-body = *OCTET + + An entity-body is only present in a message when a message-body is + present, as described in section 4.3. The entity-body is obtained + from the message-body by decoding any Transfer-Encoding that might + have been applied to ensure safe and proper transfer of the message. + +7.2.1 Type + + When an entity-body is included with a message, the data type of that + body is determined via the header fields Content-Type and Content- + Encoding. These define a two-layer, ordered encoding model: + + entity-body := Content-Encoding( Content-Type( data ) ) + + Content-Type specifies the media type of the underlying data. + Content-Encoding may be used to indicate any additional content + codings applied to the data, usually for the purpose of data + compression, that are a property of the requested resource. There is + no default encoding. + + Any HTTP/1.1 message containing an entity-body SHOULD include a + Content-Type header field defining the media type of that body. If + and only if the media type is not given by a Content-Type field, the + recipient MAY attempt to guess the media type via inspection of its + content and/or the name extension(s) of the URI used to identify the + resource. If the media type remains unknown, the recipient SHOULD + treat it as type "application/octet-stream". + +7.2.2 Entity Length + + The entity-length of a message is the length of the message-body + before any transfer-codings have been applied. Section 4.4 defines + how the transfer-length of a message-body is determined. + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 43] + +RFC 2616 HTTP/1.1 June 1999 + + +8 Connections + +8.1 Persistent Connections + +8.1.1 Purpose + + Prior to persistent connections, a separate TCP connection was + established to fetch each URL, increasing the load on HTTP servers + and causing congestion on the Internet. The use of inline images and + other associated data often require a client to make multiple + requests of the same server in a short amount of time. Analysis of + these performance problems and results from a prototype + implementation are available [26] [30]. Implementation experience and + measurements of actual HTTP/1.1 (RFC 2068) implementations show good + results [39]. Alternatives have also been explored, for example, + T/TCP [27]. + + Persistent HTTP connections have a number of advantages: + + - By opening and closing fewer TCP connections, CPU time is saved + in routers and hosts (clients, servers, proxies, gateways, + tunnels, or caches), and memory used for TCP protocol control + blocks can be saved in hosts. + + - HTTP requests and responses can be pipelined on a connection. + Pipelining allows a client to make multiple requests without + waiting for each response, allowing a single TCP connection to + be used much more efficiently, with much lower elapsed time. + + - Network congestion is reduced by reducing the number of packets + caused by TCP opens, and by allowing TCP sufficient time to + determine the congestion state of the network. + + - Latency on subsequent requests is reduced since there is no time + spent in TCP's connection opening handshake. + + - HTTP can evolve more gracefully, since errors can be reported + without the penalty of closing the TCP connection. Clients using + future versions of HTTP might optimistically try a new feature, + but if communicating with an older server, retry with old + semantics after an error is reported. + + HTTP implementations SHOULD implement persistent connections. + + + + + + + + +Fielding, et al. Standards Track [Page 44] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2 Overall Operation + + A significant difference between HTTP/1.1 and earlier versions of + HTTP is that persistent connections are the default behavior of any + HTTP connection. That is, unless otherwise indicated, the client + SHOULD assume that the server will maintain a persistent connection, + even after error responses from the server. + + Persistent connections provide a mechanism by which a client and a + server can signal the close of a TCP connection. This signaling takes + place using the Connection header field (section 14.10). Once a close + has been signaled, the client MUST NOT send any more requests on that + connection. + +8.1.2.1 Negotiation + + An HTTP/1.1 server MAY assume that a HTTP/1.1 client intends to + maintain a persistent connection unless a Connection header including + the connection-token "close" was sent in the request. If the server + chooses to close the connection immediately after sending the + response, it SHOULD send a Connection header including the + connection-token close. + + An HTTP/1.1 client MAY expect a connection to remain open, but would + decide to keep it open based on whether the response from a server + contains a Connection header with the connection-token close. In case + the client does not want to maintain a connection for more than that + request, it SHOULD send a Connection header including the + connection-token close. + + If either the client or the server sends the close token in the + Connection header, that request becomes the last one for the + connection. + + Clients and servers SHOULD NOT assume that a persistent connection is + maintained for HTTP versions less than 1.1 unless it is explicitly + signaled. See section 19.6.2 for more information on backward + compatibility with HTTP/1.0 clients. + + In order to remain persistent, all messages on the connection MUST + have a self-defined message length (i.e., one not defined by closure + of the connection), as described in section 4.4. + + + + + + + + + +Fielding, et al. Standards Track [Page 45] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2.2 Pipelining + + A client that supports persistent connections MAY "pipeline" its + requests (i.e., send multiple requests without waiting for each + response). A server MUST send its responses to those requests in the + same order that the requests were received. + + Clients which assume persistent connections and pipeline immediately + after connection establishment SHOULD be prepared to retry their + connection if the first pipelined attempt fails. If a client does + such a retry, it MUST NOT pipeline before it knows the connection is + persistent. Clients MUST also be prepared to resend their requests if + the server closes the connection before sending all of the + corresponding responses. + + Clients SHOULD NOT pipeline requests using non-idempotent methods or + non-idempotent sequences of methods (see section 9.1.2). Otherwise, a + premature termination of the transport connection could lead to + indeterminate results. A client wishing to send a non-idempotent + request SHOULD wait to send that request until it has received the + response status for the previous request. + +8.1.3 Proxy Servers + + It is especially important that proxies correctly implement the + properties of the Connection header field as specified in section + 14.10. + + The proxy server MUST signal persistent connections separately with + its clients and the origin servers (or other proxy servers) that it + connects to. Each persistent connection applies to only one transport + link. + + A proxy server MUST NOT establish a HTTP/1.1 persistent connection + with an HTTP/1.0 client (but see RFC 2068 [33] for information and + discussion of the problems with the Keep-Alive header implemented by + many HTTP/1.0 clients). + +8.1.4 Practical Considerations + + Servers will usually have some time-out value beyond which they will + no longer maintain an inactive connection. Proxy servers might make + this a higher value since it is likely that the client will be making + more connections through the same server. The use of persistent + connections places no requirements on the length (or existence) of + this time-out for either the client or the server. + + + + + +Fielding, et al. Standards Track [Page 46] + +RFC 2616 HTTP/1.1 June 1999 + + + When a client or server wishes to time-out it SHOULD issue a graceful + close on the transport connection. Clients and servers SHOULD both + constantly watch for the other side of the transport close, and + respond to it as appropriate. If a client or server does not detect + the other side's close promptly it could cause unnecessary resource + drain on the network. + + A client, server, or proxy MAY close the transport connection at any + time. For example, a client might have started to send a new request + at the same time that the server has decided to close the "idle" + connection. From the server's point of view, the connection is being + closed while it was idle, but from the client's point of view, a + request is in progress. + + This means that clients, servers, and proxies MUST be able to recover + from asynchronous close events. Client software SHOULD reopen the + transport connection and retransmit the aborted sequence of requests + without user interaction so long as the request sequence is + idempotent (see section 9.1.2). Non-idempotent methods or sequences + MUST NOT be automatically retried, although user agents MAY offer a + human operator the choice of retrying the request(s). Confirmation by + user-agent software with semantic understanding of the application + MAY substitute for user confirmation. The automatic retry SHOULD NOT + be repeated if the second sequence of requests fails. + + Servers SHOULD always respond to at least one request per connection, + if at all possible. Servers SHOULD NOT close a connection in the + middle of transmitting a response, unless a network or client failure + is suspected. + + Clients that use persistent connections SHOULD limit the number of + simultaneous connections that they maintain to a given server. A + single-user client SHOULD NOT maintain more than 2 connections with + any server or proxy. A proxy SHOULD use up to 2*N connections to + another server or proxy, where N is the number of simultaneously + active users. These guidelines are intended to improve HTTP response + times and avoid congestion. + +8.2 Message Transmission Requirements + +8.2.1 Persistent Connections and Flow Control + + HTTP/1.1 servers SHOULD maintain persistent connections and use TCP's + flow control mechanisms to resolve temporary overloads, rather than + terminating connections with the expectation that clients will retry. + The latter technique can exacerbate network congestion. + + + + + +Fielding, et al. Standards Track [Page 47] + +RFC 2616 HTTP/1.1 June 1999 + + +8.2.2 Monitoring Connections for Error Status Messages + + An HTTP/1.1 (or later) client sending a message-body SHOULD monitor + the network connection for an error status while it is transmitting + the request. If the client sees an error status, it SHOULD + immediately cease transmitting the body. If the body is being sent + using a "chunked" encoding (section 3.6), a zero length chunk and + empty trailer MAY be used to prematurely mark the end of the message. + If the body was preceded by a Content-Length header, the client MUST + close the connection. + +8.2.3 Use of the 100 (Continue) Status + + The purpose of the 100 (Continue) status (see section 10.1.1) is to + allow a client that is sending a request message with a request body + to determine if the origin server is willing to accept the request + (based on the request headers) before the client sends the request + body. In some cases, it might either be inappropriate or highly + inefficient for the client to send the body if the server will reject + the message without looking at the body. + + Requirements for HTTP/1.1 clients: + + - If a client will wait for a 100 (Continue) response before + sending the request body, it MUST send an Expect request-header + field (section 14.20) with the "100-continue" expectation. + + - A client MUST NOT send an Expect request-header field (section + 14.20) with the "100-continue" expectation if it does not intend + to send a request body. + + Because of the presence of older implementations, the protocol allows + ambiguous situations in which a client may send "Expect: 100- + continue" without receiving either a 417 (Expectation Failed) status + or a 100 (Continue) status. Therefore, when a client sends this + header field to an origin server (possibly via a proxy) from which it + has never seen a 100 (Continue) status, the client SHOULD NOT wait + for an indefinite period before sending the request body. + + Requirements for HTTP/1.1 origin servers: + + - Upon receiving a request which includes an Expect request-header + field with the "100-continue" expectation, an origin server MUST + either respond with 100 (Continue) status and continue to read + from the input stream, or respond with a final status code. The + origin server MUST NOT wait for the request body before sending + the 100 (Continue) response. If it responds with a final status + code, it MAY close the transport connection or it MAY continue + + + +Fielding, et al. Standards Track [Page 48] + +RFC 2616 HTTP/1.1 June 1999 + + + to read and discard the rest of the request. It MUST NOT + perform the requested method if it returns a final status code. + + - An origin server SHOULD NOT send a 100 (Continue) response if + the request message does not include an Expect request-header + field with the "100-continue" expectation, and MUST NOT send a + 100 (Continue) response if such a request comes from an HTTP/1.0 + (or earlier) client. There is an exception to this rule: for + compatibility with RFC 2068, a server MAY send a 100 (Continue) + status in response to an HTTP/1.1 PUT or POST request that does + not include an Expect request-header field with the "100- + continue" expectation. This exception, the purpose of which is + to minimize any client processing delays associated with an + undeclared wait for 100 (Continue) status, applies only to + HTTP/1.1 requests, and not to requests with any other HTTP- + version value. + + - An origin server MAY omit a 100 (Continue) response if it has + already received some or all of the request body for the + corresponding request. + + - An origin server that sends a 100 (Continue) response MUST + ultimately send a final status code, once the request body is + received and processed, unless it terminates the transport + connection prematurely. + + - If an origin server receives a request that does not include an + Expect request-header field with the "100-continue" expectation, + the request includes a request body, and the server responds + with a final status code before reading the entire request body + from the transport connection, then the server SHOULD NOT close + the transport connection until it has read the entire request, + or until the client closes the connection. Otherwise, the client + might not reliably receive the response message. However, this + requirement is not be construed as preventing a server from + defending itself against denial-of-service attacks, or from + badly broken client implementations. + + Requirements for HTTP/1.1 proxies: + + - If a proxy receives a request that includes an Expect request- + header field with the "100-continue" expectation, and the proxy + either knows that the next-hop server complies with HTTP/1.1 or + higher, or does not know the HTTP version of the next-hop + server, it MUST forward the request, including the Expect header + field. + + + + + +Fielding, et al. Standards Track [Page 49] + +RFC 2616 HTTP/1.1 June 1999 + + + - If the proxy knows that the version of the next-hop server is + HTTP/1.0 or lower, it MUST NOT forward the request, and it MUST + respond with a 417 (Expectation Failed) status. + + - Proxies SHOULD maintain a cache recording the HTTP version + numbers received from recently-referenced next-hop servers. + + - A proxy MUST NOT forward a 100 (Continue) response if the + request message was received from an HTTP/1.0 (or earlier) + client and did not include an Expect request-header field with + the "100-continue" expectation. This requirement overrides the + general rule for forwarding of 1xx responses (see section 10.1). + +8.2.4 Client Behavior if Server Prematurely Closes Connection + + If an HTTP/1.1 client sends a request which includes a request body, + but which does not include an Expect request-header field with the + "100-continue" expectation, and if the client is not directly + connected to an HTTP/1.1 origin server, and if the client sees the + connection close before receiving any status from the server, the + client SHOULD retry the request. If the client does retry this + request, it MAY use the following "binary exponential backoff" + algorithm to be assured of obtaining a reliable response: + + 1. Initiate a new connection to the server + + 2. Transmit the request-headers + + 3. Initialize a variable R to the estimated round-trip time to the + server (e.g., based on the time it took to establish the + connection), or to a constant value of 5 seconds if the round- + trip time is not available. + + 4. Compute T = R * (2**N), where N is the number of previous + retries of this request. + + 5. Wait either for an error response from the server, or for T + seconds (whichever comes first) + + 6. If no error response is received, after T seconds transmit the + body of the request. + + 7. If client sees that the connection is closed prematurely, + repeat from step 1 until the request is accepted, an error + response is received, or the user becomes impatient and + terminates the retry process. + + + + + +Fielding, et al. Standards Track [Page 50] + +RFC 2616 HTTP/1.1 June 1999 + + + If at any point an error status is received, the client + + - SHOULD NOT continue and + + - SHOULD close the connection if it has not completed sending the + request message. + +9 Method Definitions + + The set of common methods for HTTP/1.1 is defined below. Although + this set can be expanded, additional methods cannot be assumed to + share the same semantics for separately extended clients and servers. + + The Host request-header field (section 14.23) MUST accompany all + HTTP/1.1 requests. + +9.1 Safe and Idempotent Methods + +9.1.1 Safe Methods + + Implementors should be aware that the software represents the user in + their interactions over the Internet, and should be careful to allow + the user to be aware of any actions they might take which may have an + unexpected significance to themselves or others. + + In particular, the convention has been established that the GET and + HEAD methods SHOULD NOT have the significance of taking an action + other than retrieval. These methods ought to be considered "safe". + This allows user agents to represent other methods, such as POST, PUT + and DELETE, in a special way, so that the user is made aware of the + fact that a possibly unsafe action is being requested. + + Naturally, it is not possible to ensure that the server does not + generate side-effects as a result of performing a GET request; in + fact, some dynamic resources consider that a feature. The important + distinction here is that the user did not request the side-effects, + so therefore cannot be held accountable for them. + +9.1.2 Idempotent Methods + + Methods can also have the property of "idempotence" in that (aside + from error or expiration issues) the side-effects of N > 0 identical + requests is the same as for a single request. The methods GET, HEAD, + PUT and DELETE share this property. Also, the methods OPTIONS and + TRACE SHOULD NOT have side effects, and so are inherently idempotent. + + + + + + +Fielding, et al. Standards Track [Page 51] + +RFC 2616 HTTP/1.1 June 1999 + + + However, it is possible that a sequence of several requests is non- + idempotent, even if all of the methods executed in that sequence are + idempotent. (A sequence is idempotent if a single execution of the + entire sequence always yields a result that is not changed by a + reexecution of all, or part, of that sequence.) For example, a + sequence is non-idempotent if its result depends on a value that is + later modified in the same sequence. + + A sequence that never has side effects is idempotent, by definition + (provided that no concurrent operations are being executed on the + same set of resources). + +9.2 OPTIONS + + The OPTIONS method represents a request for information about the + communication options available on the request/response chain + identified by the Request-URI. This method allows the client to + determine the options and/or requirements associated with a resource, + or the capabilities of a server, without implying a resource action + or initiating a resource retrieval. + + Responses to this method are not cacheable. + + If the OPTIONS request includes an entity-body (as indicated by the + presence of Content-Length or Transfer-Encoding), then the media type + MUST be indicated by a Content-Type field. Although this + specification does not define any use for such a body, future + extensions to HTTP might use the OPTIONS body to make more detailed + queries on the server. A server that does not support such an + extension MAY discard the request body. + + If the Request-URI is an asterisk ("*"), the OPTIONS request is + intended to apply to the server in general rather than to a specific + resource. Since a server's communication options typically depend on + the resource, the "*" request is only useful as a "ping" or "no-op" + type of method; it does nothing beyond allowing the client to test + the capabilities of the server. For example, this can be used to test + a proxy for HTTP/1.1 compliance (or lack thereof). + + If the Request-URI is not an asterisk, the OPTIONS request applies + only to the options that are available when communicating with that + resource. + + A 200 response SHOULD include any header fields that indicate + optional features implemented by the server and applicable to that + resource (e.g., Allow), possibly including extensions not defined by + this specification. The response body, if any, SHOULD also include + information about the communication options. The format for such a + + + +Fielding, et al. Standards Track [Page 52] + +RFC 2616 HTTP/1.1 June 1999 + + + body is not defined by this specification, but might be defined by + future extensions to HTTP. Content negotiation MAY be used to select + the appropriate response format. If no response body is included, the + response MUST include a Content-Length field with a field-value of + "0". + + The Max-Forwards request-header field MAY be used to target a + specific proxy in the request chain. When a proxy receives an OPTIONS + request on an absoluteURI for which request forwarding is permitted, + the proxy MUST check for a Max-Forwards field. If the Max-Forwards + field-value is zero ("0"), the proxy MUST NOT forward the message; + instead, the proxy SHOULD respond with its own communication options. + If the Max-Forwards field-value is an integer greater than zero, the + proxy MUST decrement the field-value when it forwards the request. If + no Max-Forwards field is present in the request, then the forwarded + request MUST NOT include a Max-Forwards field. + +9.3 GET + + The GET method means retrieve whatever information (in the form of an + entity) is identified by the Request-URI. If the Request-URI refers + to a data-producing process, it is the produced data which shall be + returned as the entity in the response and not the source text of the + process, unless that text happens to be the output of the process. + + The semantics of the GET method change to a "conditional GET" if the + request message includes an If-Modified-Since, If-Unmodified-Since, + If-Match, If-None-Match, or If-Range header field. A conditional GET + method requests that the entity be transferred only under the + circumstances described by the conditional header field(s). The + conditional GET method is intended to reduce unnecessary network + usage by allowing cached entities to be refreshed without requiring + multiple requests or transferring data already held by the client. + + The semantics of the GET method change to a "partial GET" if the + request message includes a Range header field. A partial GET requests + that only part of the entity be transferred, as described in section + 14.35. The partial GET method is intended to reduce unnecessary + network usage by allowing partially-retrieved entities to be + completed without transferring data already held by the client. + + The response to a GET request is cacheable if and only if it meets + the requirements for HTTP caching described in section 13. + + See section 15.1.3 for security considerations when used for forms. + + + + + + +Fielding, et al. Standards Track [Page 53] + +RFC 2616 HTTP/1.1 June 1999 + + +9.4 HEAD + + The HEAD method is identical to GET except that the server MUST NOT + return a message-body in the response. The metainformation contained + in the HTTP headers in response to a HEAD request SHOULD be identical + to the information sent in response to a GET request. This method can + be used for obtaining metainformation about the entity implied by the + request without transferring the entity-body itself. This method is + often used for testing hypertext links for validity, accessibility, + and recent modification. + + The response to a HEAD request MAY be cacheable in the sense that the + information contained in the response MAY be used to update a + previously cached entity from that resource. If the new field values + indicate that the cached entity differs from the current entity (as + would be indicated by a change in Content-Length, Content-MD5, ETag + or Last-Modified), then the cache MUST treat the cache entry as + stale. + +9.5 POST + + The POST method is used to request that the origin server accept the + entity enclosed in the request as a new subordinate of the resource + identified by the Request-URI in the Request-Line. POST is designed + to allow a uniform method to cover the following functions: + + - Annotation of existing resources; + + - Posting a message to a bulletin board, newsgroup, mailing list, + or similar group of articles; + + - Providing a block of data, such as the result of submitting a + form, to a data-handling process; + + - Extending a database through an append operation. + + The actual function performed by the POST method is determined by the + server and is usually dependent on the Request-URI. The posted entity + is subordinate to that URI in the same way that a file is subordinate + to a directory containing it, a news article is subordinate to a + newsgroup to which it is posted, or a record is subordinate to a + database. + + The action performed by the POST method might not result in a + resource that can be identified by a URI. In this case, either 200 + (OK) or 204 (No Content) is the appropriate response status, + depending on whether or not the response includes an entity that + describes the result. + + + +Fielding, et al. Standards Track [Page 54] + +RFC 2616 HTTP/1.1 June 1999 + + + If a resource has been created on the origin server, the response + SHOULD be 201 (Created) and contain an entity which describes the + status of the request and refers to the new resource, and a Location + header (see section 14.30). + + Responses to this method are not cacheable, unless the response + includes appropriate Cache-Control or Expires header fields. However, + the 303 (See Other) response can be used to direct the user agent to + retrieve a cacheable resource. + + POST requests MUST obey the message transmission requirements set out + in section 8.2. + + See section 15.1.3 for security considerations. + +9.6 PUT + + The PUT method requests that the enclosed entity be stored under the + supplied Request-URI. If the Request-URI refers to an already + existing resource, the enclosed entity SHOULD be considered as a + modified version of the one residing on the origin server. If the + Request-URI does not point to an existing resource, and that URI is + capable of being defined as a new resource by the requesting user + agent, the origin server can create the resource with that URI. If a + new resource is created, the origin server MUST inform the user agent + via the 201 (Created) response. If an existing resource is modified, + either the 200 (OK) or 204 (No Content) response codes SHOULD be sent + to indicate successful completion of the request. If the resource + could not be created or modified with the Request-URI, an appropriate + error response SHOULD be given that reflects the nature of the + problem. The recipient of the entity MUST NOT ignore any Content-* + (e.g. Content-Range) headers that it does not understand or implement + and MUST return a 501 (Not Implemented) response in such cases. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + + The fundamental difference between the POST and PUT requests is + reflected in the different meaning of the Request-URI. The URI in a + POST request identifies the resource that will handle the enclosed + entity. That resource might be a data-accepting process, a gateway to + some other protocol, or a separate entity that accepts annotations. + In contrast, the URI in a PUT request identifies the entity enclosed + with the request -- the user agent knows what URI is intended and the + server MUST NOT attempt to apply the request to some other resource. + If the server desires that the request be applied to a different URI, + + + + +Fielding, et al. Standards Track [Page 55] + +RFC 2616 HTTP/1.1 June 1999 + + + it MUST send a 301 (Moved Permanently) response; the user agent MAY + then make its own decision regarding whether or not to redirect the + request. + + A single resource MAY be identified by many different URIs. For + example, an article might have a URI for identifying "the current + version" which is separate from the URI identifying each particular + version. In this case, a PUT request on a general URI might result in + several other URIs being defined by the origin server. + + HTTP/1.1 does not define how a PUT method affects the state of an + origin server. + + PUT requests MUST obey the message transmission requirements set out + in section 8.2. + + Unless otherwise specified for a particular entity-header, the + entity-headers in the PUT request SHOULD be applied to the resource + created or modified by the PUT. + +9.7 DELETE + + The DELETE method requests that the origin server delete the resource + identified by the Request-URI. This method MAY be overridden by human + intervention (or other means) on the origin server. The client cannot + be guaranteed that the operation has been carried out, even if the + status code returned from the origin server indicates that the action + has been completed successfully. However, the server SHOULD NOT + indicate success unless, at the time the response is given, it + intends to delete the resource or move it to an inaccessible + location. + + A successful response SHOULD be 200 (OK) if the response includes an + entity describing the status, 202 (Accepted) if the action has not + yet been enacted, or 204 (No Content) if the action has been enacted + but the response does not include an entity. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + +9.8 TRACE + + The TRACE method is used to invoke a remote, application-layer loop- + back of the request message. The final recipient of the request + SHOULD reflect the message received back to the client as the + entity-body of a 200 (OK) response. The final recipient is either the + + + + +Fielding, et al. Standards Track [Page 56] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server or the first proxy or gateway to receive a Max-Forwards + value of zero (0) in the request (see section 14.31). A TRACE request + MUST NOT include an entity. + + TRACE allows the client to see what is being received at the other + end of the request chain and use that data for testing or diagnostic + information. The value of the Via header field (section 14.45) is of + particular interest, since it acts as a trace of the request chain. + Use of the Max-Forwards header field allows the client to limit the + length of the request chain, which is useful for testing a chain of + proxies forwarding messages in an infinite loop. + + If the request is valid, the response SHOULD contain the entire + request message in the entity-body, with a Content-Type of + "message/http". Responses to this method MUST NOT be cached. + +9.9 CONNECT + + This specification reserves the method name CONNECT for use with a + proxy that can dynamically switch to being a tunnel (e.g. SSL + tunneling [44]). + +10 Status Code Definitions + + Each Status-Code is described below, including a description of which + method(s) it can follow and any metainformation required in the + response. + +10.1 Informational 1xx + + This class of status code indicates a provisional response, + consisting only of the Status-Line and optional headers, and is + terminated by an empty line. There are no required headers for this + class of status code. Since HTTP/1.0 did not define any 1xx status + codes, servers MUST NOT send a 1xx response to an HTTP/1.0 client + except under experimental conditions. + + A client MUST be prepared to accept one or more 1xx status responses + prior to a regular response, even if the client does not expect a 100 + (Continue) status message. Unexpected 1xx status responses MAY be + ignored by a user agent. + + Proxies MUST forward 1xx responses, unless the connection between the + proxy and its client has been closed, or unless the proxy itself + requested the generation of the 1xx response. (For example, if a + + + + + + +Fielding, et al. Standards Track [Page 57] + +RFC 2616 HTTP/1.1 June 1999 + + + proxy adds a "Expect: 100-continue" field when it forwards a request, + then it need not forward the corresponding 100 (Continue) + response(s).) + +10.1.1 100 Continue + + The client SHOULD continue with its request. This interim response is + used to inform the client that the initial part of the request has + been received and has not yet been rejected by the server. The client + SHOULD continue by sending the remainder of the request or, if the + request has already been completed, ignore this response. The server + MUST send a final response after the request has been completed. See + section 8.2.3 for detailed discussion of the use and handling of this + status code. + +10.1.2 101 Switching Protocols + + The server understands and is willing to comply with the client's + request, via the Upgrade message header field (section 14.42), for a + change in the application protocol being used on this connection. The + server will switch protocols to those defined by the response's + Upgrade header field immediately after the empty line which + terminates the 101 response. + + The protocol SHOULD be switched only when it is advantageous to do + so. For example, switching to a newer version of HTTP is advantageous + over older versions, and switching to a real-time, synchronous + protocol might be advantageous when delivering resources that use + such features. + +10.2 Successful 2xx + + This class of status code indicates that the client's request was + successfully received, understood, and accepted. + +10.2.1 200 OK + + The request has succeeded. The information returned with the response + is dependent on the method used in the request, for example: + + GET an entity corresponding to the requested resource is sent in + the response; + + HEAD the entity-header fields corresponding to the requested + resource are sent in the response without any message-body; + + POST an entity describing or containing the result of the action; + + + + +Fielding, et al. Standards Track [Page 58] + +RFC 2616 HTTP/1.1 June 1999 + + + TRACE an entity containing the request message as received by the + end server. + +10.2.2 201 Created + + The request has been fulfilled and resulted in a new resource being + created. The newly created resource can be referenced by the URI(s) + returned in the entity of the response, with the most specific URI + for the resource given by a Location header field. The response + SHOULD include an entity containing a list of resource + characteristics and location(s) from which the user or user agent can + choose the one most appropriate. The entity format is specified by + the media type given in the Content-Type header field. The origin + server MUST create the resource before returning the 201 status code. + If the action cannot be carried out immediately, the server SHOULD + respond with 202 (Accepted) response instead. + + A 201 response MAY contain an ETag response header field indicating + the current value of the entity tag for the requested variant just + created, see section 14.19. + +10.2.3 202 Accepted + + The request has been accepted for processing, but the processing has + not been completed. The request might or might not eventually be + acted upon, as it might be disallowed when processing actually takes + place. There is no facility for re-sending a status code from an + asynchronous operation such as this. + + The 202 response is intentionally non-committal. Its purpose is to + allow a server to accept a request for some other process (perhaps a + batch-oriented process that is only run once per day) without + requiring that the user agent's connection to the server persist + until the process is completed. The entity returned with this + response SHOULD include an indication of the request's current status + and either a pointer to a status monitor or some estimate of when the + user can expect the request to be fulfilled. + +10.2.4 203 Non-Authoritative Information + + The returned metainformation in the entity-header is not the + definitive set as available from the origin server, but is gathered + from a local or a third-party copy. The set presented MAY be a subset + or superset of the original version. For example, including local + annotation information about the resource might result in a superset + of the metainformation known by the origin server. Use of this + response code is not required and is only appropriate when the + response would otherwise be 200 (OK). + + + +Fielding, et al. Standards Track [Page 59] + +RFC 2616 HTTP/1.1 June 1999 + + +10.2.5 204 No Content + + The server has fulfilled the request but does not need to return an + entity-body, and might want to return updated metainformation. The + response MAY include new or updated metainformation in the form of + entity-headers, which if present SHOULD be associated with the + requested variant. + + If the client is a user agent, it SHOULD NOT change its document view + from that which caused the request to be sent. This response is + primarily intended to allow input for actions to take place without + causing a change to the user agent's active document view, although + any new or updated metainformation SHOULD be applied to the document + currently in the user agent's active view. + + The 204 response MUST NOT include a message-body, and thus is always + terminated by the first empty line after the header fields. + +10.2.6 205 Reset Content + + The server has fulfilled the request and the user agent SHOULD reset + the document view which caused the request to be sent. This response + is primarily intended to allow input for actions to take place via + user input, followed by a clearing of the form in which the input is + given so that the user can easily initiate another input action. The + response MUST NOT include an entity. + +10.2.7 206 Partial Content + + The server has fulfilled the partial GET request for the resource. + The request MUST have included a Range header field (section 14.35) + indicating the desired range, and MAY have included an If-Range + header field (section 14.27) to make the request conditional. + + The response MUST include the following header fields: + + - Either a Content-Range header field (section 14.16) indicating + the range included with this response, or a multipart/byteranges + Content-Type including Content-Range fields for each part. If a + Content-Length header field is present in the response, its + value MUST match the actual number of OCTETs transmitted in the + message-body. + + - Date + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + + + +Fielding, et al. Standards Track [Page 60] + +RFC 2616 HTTP/1.1 June 1999 + + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the 206 response is the result of an If-Range request that used a + strong cache validator (see section 13.3.3), the response SHOULD NOT + include other entity-headers. If the response is the result of an + If-Range request that used a weak validator, the response MUST NOT + include other entity-headers; this prevents inconsistencies between + cached entity-bodies and updated headers. Otherwise, the response + MUST include all of the entity-headers that would have been returned + with a 200 (OK) response to the same request. + + A cache MUST NOT combine a 206 response with other previously cached + content if the ETag or Last-Modified headers do not match exactly, + see 13.5.4. + + A cache that does not support the Range and Content-Range headers + MUST NOT cache 206 (Partial) responses. + +10.3 Redirection 3xx + + This class of status code indicates that further action needs to be + taken by the user agent in order to fulfill the request. The action + required MAY be carried out by the user agent without interaction + with the user if and only if the method used in the second request is + GET or HEAD. A client SHOULD detect infinite redirection loops, since + such loops generate network traffic for each redirection. + + Note: previous versions of this specification recommended a + maximum of five redirections. Content developers should be aware + that there might be clients that implement such a fixed + limitation. + +10.3.1 300 Multiple Choices + + The requested resource corresponds to any one of a set of + representations, each with its own specific location, and agent- + driven negotiation information (section 12) is being provided so that + the user (or user agent) can select a preferred representation and + redirect its request to that location. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of resource characteristics and location(s) from + which the user or user agent can choose the one most appropriate. The + entity format is specified by the media type given in the Content- + Type header field. Depending upon the format and the capabilities of + + + + +Fielding, et al. Standards Track [Page 61] + +RFC 2616 HTTP/1.1 June 1999 + + + the user agent, selection of the most appropriate choice MAY be + performed automatically. However, this specification does not define + any standard for such automatic selection. + + If the server has a preferred choice of representation, it SHOULD + include the specific URI for that representation in the Location + field; user agents MAY use the Location field value for automatic + redirection. This response is cacheable unless indicated otherwise. + +10.3.2 301 Moved Permanently + + The requested resource has been assigned a new permanent URI and any + future references to this resource SHOULD use one of the returned + URIs. Clients with link editing capabilities ought to automatically + re-link references to the Request-URI to one or more of the new + references returned by the server, where possible. This response is + cacheable unless indicated otherwise. + + The new permanent URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + If the 301 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: When automatically redirecting a POST request after + receiving a 301 status code, some existing HTTP/1.0 user agents + will erroneously change it into a GET request. + +10.3.3 302 Found + + The requested resource resides temporarily under a different URI. + Since the redirection might be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + + + + + + +Fielding, et al. Standards Track [Page 62] + +RFC 2616 HTTP/1.1 June 1999 + + + If the 302 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: RFC 1945 and RFC 2068 specify that the client is not allowed + to change the method on the redirected request. However, most + existing user agent implementations treat 302 as if it were a 303 + response, performing a GET on the Location field-value regardless + of the original request method. The status codes 303 and 307 have + been added for servers that wish to make unambiguously clear which + kind of reaction is expected of the client. + +10.3.4 303 See Other + + The response to the request can be found under a different URI and + SHOULD be retrieved using a GET method on that resource. This method + exists primarily to allow the output of a POST-activated script to + redirect the user agent to a selected resource. The new URI is not a + substitute reference for the originally requested resource. The 303 + response MUST NOT be cached, but the response to the second + (redirected) request might be cacheable. + + The different URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + Note: Many pre-HTTP/1.1 user agents do not understand the 303 + status. When interoperability with such clients is a concern, the + 302 status code may be used instead, since most user agents react + to a 302 response as described here for 303. + +10.3.5 304 Not Modified + + If the client has performed a conditional GET request and access is + allowed, but the document has not been modified, the server SHOULD + respond with this status code. The 304 response MUST NOT contain a + message-body, and thus is always terminated by the first empty line + after the header fields. + + The response MUST include the following header fields: + + - Date, unless its omission is required by section 14.18.1 + + + + + + + +Fielding, et al. Standards Track [Page 63] + +RFC 2616 HTTP/1.1 June 1999 + + + If a clockless origin server obeys these rules, and proxies and + clients add their own Date to any response received without one (as + already specified by [RFC 2068], section 14.19), caches will operate + correctly. + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the conditional GET used a strong cache validator (see section + 13.3.3), the response SHOULD NOT include other entity-headers. + Otherwise (i.e., the conditional GET used a weak validator), the + response MUST NOT include other entity-headers; this prevents + inconsistencies between cached entity-bodies and updated headers. + + If a 304 response indicates an entity not currently cached, then the + cache MUST disregard the response and repeat the request without the + conditional. + + If a cache uses a received 304 response to update a cache entry, the + cache MUST update the entry to reflect any new field values given in + the response. + +10.3.6 305 Use Proxy + + The requested resource MUST be accessed through the proxy given by + the Location field. The Location field gives the URI of the proxy. + The recipient is expected to repeat this single request via the + proxy. 305 responses MUST only be generated by origin servers. + + Note: RFC 2068 was not clear that 305 was intended to redirect a + single request, and to be generated by origin servers only. Not + observing these limitations has significant security consequences. + +10.3.7 306 (Unused) + + The 306 status code was used in a previous version of the + specification, is no longer used, and the code is reserved. + + + + + + + + + + +Fielding, et al. Standards Track [Page 64] + +RFC 2616 HTTP/1.1 June 1999 + + +10.3.8 307 Temporary Redirect + + The requested resource resides temporarily under a different URI. + Since the redirection MAY be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s) , since many pre-HTTP/1.1 user agents do not + understand the 307 status. Therefore, the note SHOULD contain the + information necessary for a user to repeat the original request on + the new URI. + + If the 307 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + +10.4 Client Error 4xx + + The 4xx class of status code is intended for cases in which the + client seems to have erred. Except when responding to a HEAD request, + the server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. These status codes are applicable to any request method. + User agents SHOULD display any included entity to the user. + + If the client is sending data, a server implementation using TCP + SHOULD be careful to ensure that the client acknowledges receipt of + the packet(s) containing the response, before the server closes the + input connection. If the client continues sending data to the server + after the close, the server's TCP stack will send a reset packet to + the client, which may erase the client's unacknowledged input buffers + before they can be read and interpreted by the HTTP application. + +10.4.1 400 Bad Request + + The request could not be understood by the server due to malformed + syntax. The client SHOULD NOT repeat the request without + modifications. + + + + + + + + +Fielding, et al. Standards Track [Page 65] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.2 401 Unauthorized + + The request requires user authentication. The response MUST include a + WWW-Authenticate header field (section 14.47) containing a challenge + applicable to the requested resource. The client MAY repeat the + request with a suitable Authorization header field (section 14.8). If + the request already included Authorization credentials, then the 401 + response indicates that authorization has been refused for those + credentials. If the 401 response contains the same challenge as the + prior response, and the user agent has already attempted + authentication at least once, then the user SHOULD be presented the + entity that was given in the response, since that entity might + include relevant diagnostic information. HTTP access authentication + is explained in "HTTP Authentication: Basic and Digest Access + Authentication" [43]. + +10.4.3 402 Payment Required + + This code is reserved for future use. + +10.4.4 403 Forbidden + + The server understood the request, but is refusing to fulfill it. + Authorization will not help and the request SHOULD NOT be repeated. + If the request method was not HEAD and the server wishes to make + public why the request has not been fulfilled, it SHOULD describe the + reason for the refusal in the entity. If the server does not wish to + make this information available to the client, the status code 404 + (Not Found) can be used instead. + +10.4.5 404 Not Found + + The server has not found anything matching the Request-URI. No + indication is given of whether the condition is temporary or + permanent. The 410 (Gone) status code SHOULD be used if the server + knows, through some internally configurable mechanism, that an old + resource is permanently unavailable and has no forwarding address. + This status code is commonly used when the server does not wish to + reveal exactly why the request has been refused, or when no other + response is applicable. + +10.4.6 405 Method Not Allowed + + The method specified in the Request-Line is not allowed for the + resource identified by the Request-URI. The response MUST include an + Allow header containing a list of valid methods for the requested + resource. + + + + +Fielding, et al. Standards Track [Page 66] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.7 406 Not Acceptable + + The resource identified by the request is only capable of generating + response entities which have content characteristics not acceptable + according to the accept headers sent in the request. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of available entity characteristics and location(s) + from which the user or user agent can choose the one most + appropriate. The entity format is specified by the media type given + in the Content-Type header field. Depending upon the format and the + capabilities of the user agent, selection of the most appropriate + choice MAY be performed automatically. However, this specification + does not define any standard for such automatic selection. + + Note: HTTP/1.1 servers are allowed to return responses which are + not acceptable according to the accept headers sent in the + request. In some cases, this may even be preferable to sending a + 406 response. User agents are encouraged to inspect the headers of + an incoming response to determine if it is acceptable. + + If the response could be unacceptable, a user agent SHOULD + temporarily stop receipt of more data and query the user for a + decision on further actions. + +10.4.8 407 Proxy Authentication Required + + This code is similar to 401 (Unauthorized), but indicates that the + client must first authenticate itself with the proxy. The proxy MUST + return a Proxy-Authenticate header field (section 14.33) containing a + challenge applicable to the proxy for the requested resource. The + client MAY repeat the request with a suitable Proxy-Authorization + header field (section 14.34). HTTP access authentication is explained + in "HTTP Authentication: Basic and Digest Access Authentication" + [43]. + +10.4.9 408 Request Timeout + + The client did not produce a request within the time that the server + was prepared to wait. The client MAY repeat the request without + modifications at any later time. + +10.4.10 409 Conflict + + The request could not be completed due to a conflict with the current + state of the resource. This code is only allowed in situations where + it is expected that the user might be able to resolve the conflict + and resubmit the request. The response body SHOULD include enough + + + +Fielding, et al. Standards Track [Page 67] + +RFC 2616 HTTP/1.1 June 1999 + + + information for the user to recognize the source of the conflict. + Ideally, the response entity would include enough information for the + user or user agent to fix the problem; however, that might not be + possible and is not required. + + Conflicts are most likely to occur in response to a PUT request. For + example, if versioning were being used and the entity being PUT + included changes to a resource which conflict with those made by an + earlier (third-party) request, the server might use the 409 response + to indicate that it can't complete the request. In this case, the + response entity would likely contain a list of the differences + between the two versions in a format defined by the response + Content-Type. + +10.4.11 410 Gone + + The requested resource is no longer available at the server and no + forwarding address is known. This condition is expected to be + considered permanent. Clients with link editing capabilities SHOULD + delete references to the Request-URI after user approval. If the + server does not know, or has no facility to determine, whether or not + the condition is permanent, the status code 404 (Not Found) SHOULD be + used instead. This response is cacheable unless indicated otherwise. + + The 410 response is primarily intended to assist the task of web + maintenance by notifying the recipient that the resource is + intentionally unavailable and that the server owners desire that + remote links to that resource be removed. Such an event is common for + limited-time, promotional services and for resources belonging to + individuals no longer working at the server's site. It is not + necessary to mark all permanently unavailable resources as "gone" or + to keep the mark for any length of time -- that is left to the + discretion of the server owner. + +10.4.12 411 Length Required + + The server refuses to accept the request without a defined Content- + Length. The client MAY repeat the request if it adds a valid + Content-Length header field containing the length of the message-body + in the request message. + +10.4.13 412 Precondition Failed + + The precondition given in one or more of the request-header fields + evaluated to false when it was tested on the server. This response + code allows the client to place preconditions on the current resource + metainformation (header field data) and thus prevent the requested + method from being applied to a resource other than the one intended. + + + +Fielding, et al. Standards Track [Page 68] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.14 413 Request Entity Too Large + + The server is refusing to process a request because the request + entity is larger than the server is willing or able to process. The + server MAY close the connection to prevent the client from continuing + the request. + + If the condition is temporary, the server SHOULD include a Retry- + After header field to indicate that it is temporary and after what + time the client MAY try again. + +10.4.15 414 Request-URI Too Long + + The server is refusing to service the request because the Request-URI + is longer than the server is willing to interpret. This rare + condition is only likely to occur when a client has improperly + converted a POST request to a GET request with long query + information, when the client has descended into a URI "black hole" of + redirection (e.g., a redirected URI prefix that points to a suffix of + itself), or when the server is under attack by a client attempting to + exploit security holes present in some servers using fixed-length + buffers for reading or manipulating the Request-URI. + +10.4.16 415 Unsupported Media Type + + The server is refusing to service the request because the entity of + the request is in a format not supported by the requested resource + for the requested method. + +10.4.17 416 Requested Range Not Satisfiable + + A server SHOULD return a response with this status code if a request + included a Range request-header field (section 14.35), and none of + the range-specifier values in this field overlap the current extent + of the selected resource, and the request did not include an If-Range + request-header field. (For byte-ranges, this means that the first- + byte-pos of all of the byte-range-spec values were greater than the + current length of the selected resource.) + + When this status code is returned for a byte-range request, the + response SHOULD include a Content-Range entity-header field + specifying the current length of the selected resource (see section + 14.16). This response MUST NOT use the multipart/byteranges content- + type. + + + + + + + +Fielding, et al. Standards Track [Page 69] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.18 417 Expectation Failed + + The expectation given in an Expect request-header field (see section + 14.20) could not be met by this server, or, if the server is a proxy, + the server has unambiguous evidence that the request could not be met + by the next-hop server. + +10.5 Server Error 5xx + + Response status codes beginning with the digit "5" indicate cases in + which the server is aware that it has erred or is incapable of + performing the request. Except when responding to a HEAD request, the + server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. User agents SHOULD display any included entity to the + user. These response codes are applicable to any request method. + +10.5.1 500 Internal Server Error + + The server encountered an unexpected condition which prevented it + from fulfilling the request. + +10.5.2 501 Not Implemented + + The server does not support the functionality required to fulfill the + request. This is the appropriate response when the server does not + recognize the request method and is not capable of supporting it for + any resource. + +10.5.3 502 Bad Gateway + + The server, while acting as a gateway or proxy, received an invalid + response from the upstream server it accessed in attempting to + fulfill the request. + +10.5.4 503 Service Unavailable + + The server is currently unable to handle the request due to a + temporary overloading or maintenance of the server. The implication + is that this is a temporary condition which will be alleviated after + some delay. If known, the length of the delay MAY be indicated in a + Retry-After header. If no Retry-After is given, the client SHOULD + handle the response as it would for a 500 response. + + Note: The existence of the 503 status code does not imply that a + server must use it when becoming overloaded. Some servers may wish + to simply refuse the connection. + + + + +Fielding, et al. Standards Track [Page 70] + +RFC 2616 HTTP/1.1 June 1999 + + +10.5.5 504 Gateway Timeout + + The server, while acting as a gateway or proxy, did not receive a + timely response from the upstream server specified by the URI (e.g. + HTTP, FTP, LDAP) or some other auxiliary server (e.g. DNS) it needed + to access in attempting to complete the request. + + Note: Note to implementors: some deployed proxies are known to + return 400 or 500 when DNS lookups time out. + +10.5.6 505 HTTP Version Not Supported + + The server does not support, or refuses to support, the HTTP protocol + version that was used in the request message. The server is + indicating that it is unable or unwilling to complete the request + using the same major version as the client, as described in section + 3.1, other than with this error message. The response SHOULD contain + an entity describing why that version is not supported and what other + protocols are supported by that server. + +11 Access Authentication + + HTTP provides several OPTIONAL challenge-response authentication + mechanisms which can be used by a server to challenge a client + request and by a client to provide authentication information. The + general framework for access authentication, and the specification of + "basic" and "digest" authentication, are specified in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. This + specification adopts the definitions of "challenge" and "credentials" + from that specification. + +12 Content Negotiation + + Most HTTP responses include an entity which contains information for + interpretation by a human user. Naturally, it is desirable to supply + the user with the "best available" entity corresponding to the + request. Unfortunately for servers and caches, not all users have the + same preferences for what is "best," and not all user agents are + equally capable of rendering all entity types. For that reason, HTTP + has provisions for several mechanisms for "content negotiation" -- + the process of selecting the best representation for a given response + when there are multiple representations available. + + Note: This is not called "format negotiation" because the + alternate representations may be of the same media type, but use + different capabilities of that type, be in different languages, + etc. + + + + +Fielding, et al. Standards Track [Page 71] + +RFC 2616 HTTP/1.1 June 1999 + + + Any response containing an entity-body MAY be subject to negotiation, + including error responses. + + There are two kinds of content negotiation which are possible in + HTTP: server-driven and agent-driven negotiation. These two kinds of + negotiation are orthogonal and thus may be used separately or in + combination. One method of combination, referred to as transparent + negotiation, occurs when a cache uses the agent-driven negotiation + information provided by the origin server in order to provide + server-driven negotiation for subsequent requests. + +12.1 Server-driven Negotiation + + If the selection of the best representation for a response is made by + an algorithm located at the server, it is called server-driven + negotiation. Selection is based on the available representations of + the response (the dimensions over which it can vary; e.g. language, + content-coding, etc.) and the contents of particular header fields in + the request message or on other information pertaining to the request + (such as the network address of the client). + + Server-driven negotiation is advantageous when the algorithm for + selecting from among the available representations is difficult to + describe to the user agent, or when the server desires to send its + "best guess" to the client along with the first response (hoping to + avoid the round-trip delay of a subsequent request if the "best + guess" is good enough for the user). In order to improve the server's + guess, the user agent MAY include request header fields (Accept, + Accept-Language, Accept-Encoding, etc.) which describe its + preferences for such a response. + + Server-driven negotiation has disadvantages: + + 1. It is impossible for the server to accurately determine what + might be "best" for any given user, since that would require + complete knowledge of both the capabilities of the user agent + and the intended use for the response (e.g., does the user want + to view it on screen or print it on paper?). + + 2. Having the user agent describe its capabilities in every + request can be both very inefficient (given that only a small + percentage of responses have multiple representations) and a + potential violation of the user's privacy. + + 3. It complicates the implementation of an origin server and the + algorithms for generating responses to a request. + + + + + +Fielding, et al. Standards Track [Page 72] + +RFC 2616 HTTP/1.1 June 1999 + + + 4. It may limit a public cache's ability to use the same response + for multiple user's requests. + + HTTP/1.1 includes the following request-header fields for enabling + server-driven negotiation through description of user agent + capabilities and user preferences: Accept (section 14.1), Accept- + Charset (section 14.2), Accept-Encoding (section 14.3), Accept- + Language (section 14.4), and User-Agent (section 14.43). However, an + origin server is not limited to these dimensions and MAY vary the + response based on any aspect of the request, including information + outside the request-header fields or within extension header fields + not defined by this specification. + + The Vary header field can be used to express the parameters the + server uses to select a representation that is subject to server- + driven negotiation. See section 13.6 for use of the Vary header field + by caches and section 14.44 for use of the Vary header field by + servers. + +12.2 Agent-driven Negotiation + + With agent-driven negotiation, selection of the best representation + for a response is performed by the user agent after receiving an + initial response from the origin server. Selection is based on a list + of the available representations of the response included within the + header fields or entity-body of the initial response, with each + representation identified by its own URI. Selection from among the + representations may be performed automatically (if the user agent is + capable of doing so) or manually by the user selecting from a + generated (possibly hypertext) menu. + + Agent-driven negotiation is advantageous when the response would vary + over commonly-used dimensions (such as type, language, or encoding), + when the origin server is unable to determine a user agent's + capabilities from examining the request, and generally when public + caches are used to distribute server load and reduce network usage. + + Agent-driven negotiation suffers from the disadvantage of needing a + second request to obtain the best alternate representation. This + second request is only efficient when caching is used. In addition, + this specification does not define any mechanism for supporting + automatic selection, though it also does not prevent any such + mechanism from being developed as an extension and used within + HTTP/1.1. + + + + + + + +Fielding, et al. Standards Track [Page 73] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 defines the 300 (Multiple Choices) and 406 (Not Acceptable) + status codes for enabling agent-driven negotiation when the server is + unwilling or unable to provide a varying response using server-driven + negotiation. + +12.3 Transparent Negotiation + + Transparent negotiation is a combination of both server-driven and + agent-driven negotiation. When a cache is supplied with a form of the + list of available representations of the response (as in agent-driven + negotiation) and the dimensions of variance are completely understood + by the cache, then the cache becomes capable of performing server- + driven negotiation on behalf of the origin server for subsequent + requests on that resource. + + Transparent negotiation has the advantage of distributing the + negotiation work that would otherwise be required of the origin + server and also removing the second request delay of agent-driven + negotiation when the cache is able to correctly guess the right + response. + + This specification does not define any mechanism for transparent + negotiation, though it also does not prevent any such mechanism from + being developed as an extension that could be used within HTTP/1.1. + +13 Caching in HTTP + + HTTP is typically used for distributed information systems, where + performance can be improved by the use of response caches. The + HTTP/1.1 protocol includes a number of elements intended to make + caching work as well as possible. Because these elements are + inextricable from other aspects of the protocol, and because they + interact with each other, it is useful to describe the basic caching + design of HTTP separately from the detailed descriptions of methods, + headers, response codes, etc. + + Caching would be useless if it did not significantly improve + performance. The goal of caching in HTTP/1.1 is to eliminate the need + to send requests in many cases, and to eliminate the need to send + full responses in many other cases. The former reduces the number of + network round-trips required for many operations; we use an + "expiration" mechanism for this purpose (see section 13.2). The + latter reduces network bandwidth requirements; we use a "validation" + mechanism for this purpose (see section 13.3). + + Requirements for performance, availability, and disconnected + operation require us to be able to relax the goal of semantic + transparency. The HTTP/1.1 protocol allows origin servers, caches, + + + +Fielding, et al. Standards Track [Page 74] + +RFC 2616 HTTP/1.1 June 1999 + + + and clients to explicitly reduce transparency when necessary. + However, because non-transparent operation may confuse non-expert + users, and might be incompatible with certain server applications + (such as those for ordering merchandise), the protocol requires that + transparency be relaxed + + - only by an explicit protocol-level request when relaxed by + client or origin server + + - only with an explicit warning to the end user when relaxed by + cache or client + + Therefore, the HTTP/1.1 protocol provides these important elements: + + 1. Protocol features that provide full semantic transparency when + this is required by all parties. + + 2. Protocol features that allow an origin server or user agent to + explicitly request and control non-transparent operation. + + 3. Protocol features that allow a cache to attach warnings to + responses that do not preserve the requested approximation of + semantic transparency. + + A basic principle is that it must be possible for the clients to + detect any potential relaxation of semantic transparency. + + Note: The server, cache, or client implementor might be faced with + design decisions not explicitly discussed in this specification. + If a decision might affect semantic transparency, the implementor + ought to err on the side of maintaining transparency unless a + careful and complete analysis shows significant benefits in + breaking transparency. + +13.1.1 Cache Correctness + + A correct cache MUST respond to a request with the most up-to-date + response held by the cache that is appropriate to the request (see + sections 13.2.5, 13.2.6, and 13.12) which meets one of the following + conditions: + + 1. It has been checked for equivalence with what the origin server + would have returned by revalidating the response with the + origin server (section 13.3); + + + + + + + +Fielding, et al. Standards Track [Page 75] + +RFC 2616 HTTP/1.1 June 1999 + + + 2. It is "fresh enough" (see section 13.2). In the default case, + this means it meets the least restrictive freshness requirement + of the client, origin server, and cache (see section 14.9); if + the origin server so specifies, it is the freshness requirement + of the origin server alone. + + If a stored response is not "fresh enough" by the most + restrictive freshness requirement of both the client and the + origin server, in carefully considered circumstances the cache + MAY still return the response with the appropriate Warning + header (see section 13.1.5 and 14.46), unless such a response + is prohibited (e.g., by a "no-store" cache-directive, or by a + "no-cache" cache-request-directive; see section 14.9). + + 3. It is an appropriate 304 (Not Modified), 305 (Proxy Redirect), + or error (4xx or 5xx) response message. + + If the cache can not communicate with the origin server, then a + correct cache SHOULD respond as above if the response can be + correctly served from the cache; if not it MUST return an error or + warning indicating that there was a communication failure. + + If a cache receives a response (either an entire response, or a 304 + (Not Modified) response) that it would normally forward to the + requesting client, and the received response is no longer fresh, the + cache SHOULD forward it to the requesting client without adding a new + Warning (but without removing any existing Warning headers). A cache + SHOULD NOT attempt to revalidate a response simply because that + response became stale in transit; this might lead to an infinite + loop. A user agent that receives a stale response without a Warning + MAY display a warning indication to the user. + +13.1.2 Warnings + + Whenever a cache returns a response that is neither first-hand nor + "fresh enough" (in the sense of condition 2 in section 13.1.1), it + MUST attach a warning to that effect, using a Warning general-header. + The Warning header and the currently defined warnings are described + in section 14.46. The warning allows clients to take appropriate + action. + + Warnings MAY be used for other purposes, both cache-related and + otherwise. The use of a warning, rather than an error status code, + distinguish these responses from true failures. + + Warnings are assigned three digit warn-codes. The first digit + indicates whether the Warning MUST or MUST NOT be deleted from a + stored cache entry after a successful revalidation: + + + +Fielding, et al. Standards Track [Page 76] + +RFC 2616 HTTP/1.1 June 1999 + + + 1xx Warnings that describe the freshness or revalidation status of + the response, and so MUST be deleted after a successful + revalidation. 1XX warn-codes MAY be generated by a cache only when + validating a cached entry. It MUST NOT be generated by clients. + + 2xx Warnings that describe some aspect of the entity body or entity + headers that is not rectified by a revalidation (for example, a + lossy compression of the entity bodies) and which MUST NOT be + deleted after a successful revalidation. + + See section 14.46 for the definitions of the codes themselves. + + HTTP/1.0 caches will cache all Warnings in responses, without + deleting the ones in the first category. Warnings in responses that + are passed to HTTP/1.0 caches carry an extra warning-date field, + which prevents a future HTTP/1.1 recipient from believing an + erroneously cached Warning. + + Warnings also carry a warning text. The text MAY be in any + appropriate natural language (perhaps based on the client's Accept + headers), and include an OPTIONAL indication of what character set is + used. + + Multiple warnings MAY be attached to a response (either by the origin + server or by a cache), including multiple warnings with the same code + number. For example, a server might provide the same warning with + texts in both English and Basque. + + When multiple warnings are attached to a response, it might not be + practical or reasonable to display all of them to the user. This + version of HTTP does not specify strict priority rules for deciding + which warnings to display and in what order, but does suggest some + heuristics. + +13.1.3 Cache-control Mechanisms + + The basic cache mechanisms in HTTP/1.1 (server-specified expiration + times and validators) are implicit directives to caches. In some + cases, a server or client might need to provide explicit directives + to the HTTP caches. We use the Cache-Control header for this purpose. + + The Cache-Control header allows a client or server to transmit a + variety of directives in either requests or responses. These + directives typically override the default caching algorithms. As a + general rule, if there is any apparent conflict between header + values, the most restrictive interpretation is applied (that is, the + one that is most likely to preserve semantic transparency). However, + + + + +Fielding, et al. Standards Track [Page 77] + +RFC 2616 HTTP/1.1 June 1999 + + + in some cases, cache-control directives are explicitly specified as + weakening the approximation of semantic transparency (for example, + "max-stale" or "public"). + + The cache-control directives are described in detail in section 14.9. + +13.1.4 Explicit User Agent Warnings + + Many user agents make it possible for users to override the basic + caching mechanisms. For example, the user agent might allow the user + to specify that cached entities (even explicitly stale ones) are + never validated. Or the user agent might habitually add "Cache- + Control: max-stale=3600" to every request. The user agent SHOULD NOT + default to either non-transparent behavior, or behavior that results + in abnormally ineffective caching, but MAY be explicitly configured + to do so by an explicit action of the user. + + If the user has overridden the basic caching mechanisms, the user + agent SHOULD explicitly indicate to the user whenever this results in + the display of information that might not meet the server's + transparency requirements (in particular, if the displayed entity is + known to be stale). Since the protocol normally allows the user agent + to determine if responses are stale or not, this indication need only + be displayed when this actually happens. The indication need not be a + dialog box; it could be an icon (for example, a picture of a rotting + fish) or some other indicator. + + If the user has overridden the caching mechanisms in a way that would + abnormally reduce the effectiveness of caches, the user agent SHOULD + continually indicate this state to the user (for example, by a + display of a picture of currency in flames) so that the user does not + inadvertently consume excess resources or suffer from excessive + latency. + +13.1.5 Exceptions to the Rules and Warnings + + In some cases, the operator of a cache MAY choose to configure it to + return stale responses even when not requested by clients. This + decision ought not be made lightly, but may be necessary for reasons + of availability or performance, especially when the cache is poorly + connected to the origin server. Whenever a cache returns a stale + response, it MUST mark it as such (using a Warning header) enabling + the client software to alert the user that there might be a potential + problem. + + + + + + + +Fielding, et al. Standards Track [Page 78] + +RFC 2616 HTTP/1.1 June 1999 + + + It also allows the user agent to take steps to obtain a first-hand or + fresh response. For this reason, a cache SHOULD NOT return a stale + response if the client explicitly requests a first-hand or fresh one, + unless it is impossible to comply for technical or policy reasons. + +13.1.6 Client-controlled Behavior + + While the origin server (and to a lesser extent, intermediate caches, + by their contribution to the age of a response) are the primary + source of expiration information, in some cases the client might need + to control a cache's decision about whether to return a cached + response without validating it. Clients do this using several + directives of the Cache-Control header. + + A client's request MAY specify the maximum age it is willing to + accept of an unvalidated response; specifying a value of zero forces + the cache(s) to revalidate all responses. A client MAY also specify + the minimum time remaining before a response expires. Both of these + options increase constraints on the behavior of caches, and so cannot + further relax the cache's approximation of semantic transparency. + + A client MAY also specify that it will accept stale responses, up to + some maximum amount of staleness. This loosens the constraints on the + caches, and so might violate the origin server's specified + constraints on semantic transparency, but might be necessary to + support disconnected operation, or high availability in the face of + poor connectivity. + +13.2 Expiration Model + +13.2.1 Server-Specified Expiration + + HTTP caching works best when caches can entirely avoid making + requests to the origin server. The primary mechanism for avoiding + requests is for an origin server to provide an explicit expiration + time in the future, indicating that a response MAY be used to satisfy + subsequent requests. In other words, a cache can return a fresh + response without first contacting the server. + + Our expectation is that servers will assign future explicit + expiration times to responses in the belief that the entity is not + likely to change, in a semantically significant way, before the + expiration time is reached. This normally preserves semantic + transparency, as long as the server's expiration times are carefully + chosen. + + + + + + +Fielding, et al. Standards Track [Page 79] + +RFC 2616 HTTP/1.1 June 1999 + + + The expiration mechanism applies only to responses taken from a cache + and not to first-hand responses forwarded immediately to the + requesting client. + + If an origin server wishes to force a semantically transparent cache + to validate every request, it MAY assign an explicit expiration time + in the past. This means that the response is always stale, and so the + cache SHOULD validate it before using it for subsequent requests. See + section 14.9.4 for a more restrictive way to force revalidation. + + If an origin server wishes to force any HTTP/1.1 cache, no matter how + it is configured, to validate every request, it SHOULD use the "must- + revalidate" cache-control directive (see section 14.9). + + Servers specify explicit expiration times using either the Expires + header, or the max-age directive of the Cache-Control header. + + An expiration time cannot be used to force a user agent to refresh + its display or reload a resource; its semantics apply only to caching + mechanisms, and such mechanisms need only check a resource's + expiration status when a new request for that resource is initiated. + See section 13.13 for an explanation of the difference between caches + and history mechanisms. + +13.2.2 Heuristic Expiration + + Since origin servers do not always provide explicit expiration times, + HTTP caches typically assign heuristic expiration times, employing + algorithms that use other header values (such as the Last-Modified + time) to estimate a plausible expiration time. The HTTP/1.1 + specification does not provide specific algorithms, but does impose + worst-case constraints on their results. Since heuristic expiration + times might compromise semantic transparency, they ought to used + cautiously, and we encourage origin servers to provide explicit + expiration times as much as possible. + +13.2.3 Age Calculations + + In order to know if a cached entry is fresh, a cache needs to know if + its age exceeds its freshness lifetime. We discuss how to calculate + the latter in section 13.2.4; this section describes how to calculate + the age of a response or cache entry. + + In this discussion, we use the term "now" to mean "the current value + of the clock at the host performing the calculation." Hosts that use + HTTP, but especially hosts running origin servers and caches, SHOULD + use NTP [28] or some similar protocol to synchronize their clocks to + a globally accurate time standard. + + + +Fielding, et al. Standards Track [Page 80] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 requires origin servers to send a Date header, if possible, + with every response, giving the time at which the response was + generated (see section 14.18). We use the term "date_value" to denote + the value of the Date header, in a form appropriate for arithmetic + operations. + + HTTP/1.1 uses the Age response-header to convey the estimated age of + the response message when obtained from a cache. The Age field value + is the cache's estimate of the amount of time since the response was + generated or revalidated by the origin server. + + In essence, the Age value is the sum of the time that the response + has been resident in each of the caches along the path from the + origin server, plus the amount of time it has been in transit along + network paths. + + We use the term "age_value" to denote the value of the Age header, in + a form appropriate for arithmetic operations. + + A response's age can be calculated in two entirely independent ways: + + 1. now minus date_value, if the local clock is reasonably well + synchronized to the origin server's clock. If the result is + negative, the result is replaced by zero. + + 2. age_value, if all of the caches along the response path + implement HTTP/1.1. + + Given that we have two independent ways to compute the age of a + response when it is received, we can combine these as + + corrected_received_age = max(now - date_value, age_value) + + and as long as we have either nearly synchronized clocks or all- + HTTP/1.1 paths, one gets a reliable (conservative) result. + + Because of network-imposed delays, some significant interval might + pass between the time that a server generates a response and the time + it is received at the next outbound cache or client. If uncorrected, + this delay could result in improperly low ages. + + Because the request that resulted in the returned Age value must have + been initiated prior to that Age value's generation, we can correct + for delays imposed by the network by recording the time at which the + request was initiated. Then, when an Age value is received, it MUST + be interpreted relative to the time the request was initiated, not + + + + + +Fielding, et al. Standards Track [Page 81] + +RFC 2616 HTTP/1.1 June 1999 + + + the time that the response was received. This algorithm results in + conservative behavior no matter how much delay is experienced. So, we + compute: + + corrected_initial_age = corrected_received_age + + (now - request_time) + + where "request_time" is the time (according to the local clock) when + the request that elicited this response was sent. + + Summary of age calculation algorithm, when a cache receives a + response: + + /* + * age_value + * is the value of Age: header received by the cache with + * this response. + * date_value + * is the value of the origin server's Date: header + * request_time + * is the (local) time when the cache made the request + * that resulted in this cached response + * response_time + * is the (local) time when the cache received the + * response + * now + * is the current (local) time + */ + + apparent_age = max(0, response_time - date_value); + corrected_received_age = max(apparent_age, age_value); + response_delay = response_time - request_time; + corrected_initial_age = corrected_received_age + response_delay; + resident_time = now - response_time; + current_age = corrected_initial_age + resident_time; + + The current_age of a cache entry is calculated by adding the amount + of time (in seconds) since the cache entry was last validated by the + origin server to the corrected_initial_age. When a response is + generated from a cache entry, the cache MUST include a single Age + header field in the response with a value equal to the cache entry's + current_age. + + The presence of an Age header field in a response implies that a + response is not first-hand. However, the converse is not true, since + the lack of an Age header field in a response does not imply that the + + + + + +Fielding, et al. Standards Track [Page 82] + +RFC 2616 HTTP/1.1 June 1999 + + + response is first-hand unless all caches along the request path are + compliant with HTTP/1.1 (i.e., older HTTP caches did not implement + the Age header field). + +13.2.4 Expiration Calculations + + In order to decide whether a response is fresh or stale, we need to + compare its freshness lifetime to its age. The age is calculated as + described in section 13.2.3; this section describes how to calculate + the freshness lifetime, and to determine if a response has expired. + In the discussion below, the values can be represented in any form + appropriate for arithmetic operations. + + We use the term "expires_value" to denote the value of the Expires + header. We use the term "max_age_value" to denote an appropriate + value of the number of seconds carried by the "max-age" directive of + the Cache-Control header in a response (see section 14.9.3). + + The max-age directive takes priority over Expires, so if max-age is + present in a response, the calculation is simply: + + freshness_lifetime = max_age_value + + Otherwise, if Expires is present in the response, the calculation is: + + freshness_lifetime = expires_value - date_value + + Note that neither of these calculations is vulnerable to clock skew, + since all of the information comes from the origin server. + + If none of Expires, Cache-Control: max-age, or Cache-Control: s- + maxage (see section 14.9.3) appears in the response, and the response + does not include other restrictions on caching, the cache MAY compute + a freshness lifetime using a heuristic. The cache MUST attach Warning + 113 to any response whose age is more than 24 hours if such warning + has not already been added. + + Also, if the response does have a Last-Modified time, the heuristic + expiration value SHOULD be no more than some fraction of the interval + since that time. A typical setting of this fraction might be 10%. + + The calculation to determine if a response has expired is quite + simple: + + response_is_fresh = (freshness_lifetime > current_age) + + + + + + +Fielding, et al. Standards Track [Page 83] + +RFC 2616 HTTP/1.1 June 1999 + + +13.2.5 Disambiguating Expiration Values + + Because expiration values are assigned optimistically, it is possible + for two caches to contain fresh values for the same resource that are + different. + + If a client performing a retrieval receives a non-first-hand response + for a request that was already fresh in its own cache, and the Date + header in its existing cache entry is newer than the Date on the new + response, then the client MAY ignore the response. If so, it MAY + retry the request with a "Cache-Control: max-age=0" directive (see + section 14.9), to force a check with the origin server. + + If a cache has two fresh responses for the same representation with + different validators, it MUST use the one with the more recent Date + header. This situation might arise because the cache is pooling + responses from other caches, or because a client has asked for a + reload or a revalidation of an apparently fresh cache entry. + +13.2.6 Disambiguating Multiple Responses + + Because a client might be receiving responses via multiple paths, so + that some responses flow through one set of caches and other + responses flow through a different set of caches, a client might + receive responses in an order different from that in which the origin + server sent them. We would like the client to use the most recently + generated response, even if older responses are still apparently + fresh. + + Neither the entity tag nor the expiration value can impose an + ordering on responses, since it is possible that a later response + intentionally carries an earlier expiration time. The Date values are + ordered to a granularity of one second. + + When a client tries to revalidate a cache entry, and the response it + receives contains a Date header that appears to be older than the one + for the existing entry, then the client SHOULD repeat the request + unconditionally, and include + + Cache-Control: max-age=0 + + to force any intermediate caches to validate their copies directly + with the origin server, or + + Cache-Control: no-cache + + to force any intermediate caches to obtain a new copy from the origin + server. + + + +Fielding, et al. Standards Track [Page 84] + +RFC 2616 HTTP/1.1 June 1999 + + + If the Date values are equal, then the client MAY use either response + (or MAY, if it is being extremely prudent, request a new response). + Servers MUST NOT depend on clients being able to choose + deterministically between responses generated during the same second, + if their expiration times overlap. + +13.3 Validation Model + + When a cache has a stale entry that it would like to use as a + response to a client's request, it first has to check with the origin + server (or possibly an intermediate cache with a fresh response) to + see if its cached entry is still usable. We call this "validating" + the cache entry. Since we do not want to have to pay the overhead of + retransmitting the full response if the cached entry is good, and we + do not want to pay the overhead of an extra round trip if the cached + entry is invalid, the HTTP/1.1 protocol supports the use of + conditional methods. + + The key protocol features for supporting conditional methods are + those concerned with "cache validators." When an origin server + generates a full response, it attaches some sort of validator to it, + which is kept with the cache entry. When a client (user agent or + proxy cache) makes a conditional request for a resource for which it + has a cache entry, it includes the associated validator in the + request. + + The server then checks that validator against the current validator + for the entity, and, if they match (see section 13.3.3), it responds + with a special status code (usually, 304 (Not Modified)) and no + entity-body. Otherwise, it returns a full response (including + entity-body). Thus, we avoid transmitting the full response if the + validator matches, and we avoid an extra round trip if it does not + match. + + In HTTP/1.1, a conditional request looks exactly the same as a normal + request for the same resource, except that it carries a special + header (which includes the validator) that implicitly turns the + method (usually, GET) into a conditional. + + The protocol includes both positive and negative senses of cache- + validating conditions. That is, it is possible to request either that + a method be performed if and only if a validator matches or if and + only if no validators match. + + + + + + + + +Fielding, et al. Standards Track [Page 85] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: a response that lacks a validator may still be cached, and + served from cache until it expires, unless this is explicitly + prohibited by a cache-control directive. However, a cache cannot + do a conditional retrieval if it does not have a validator for the + entity, which means it will not be refreshable after it expires. + +13.3.1 Last-Modified Dates + + The Last-Modified entity-header field value is often used as a cache + validator. In simple terms, a cache entry is considered to be valid + if the entity has not been modified since the Last-Modified value. + +13.3.2 Entity Tag Cache Validators + + The ETag response-header field value, an entity tag, provides for an + "opaque" cache validator. This might allow more reliable validation + in situations where it is inconvenient to store modification dates, + where the one-second resolution of HTTP date values is not + sufficient, or where the origin server wishes to avoid certain + paradoxes that might arise from the use of modification dates. + + Entity Tags are described in section 3.11. The headers used with + entity tags are described in sections 14.19, 14.24, 14.26 and 14.44. + +13.3.3 Weak and Strong Validators + + Since both origin servers and caches will compare two validators to + decide if they represent the same or different entities, one normally + would expect that if the entity (the entity-body or any entity- + headers) changes in any way, then the associated validator would + change as well. If this is true, then we call this validator a + "strong validator." + + However, there might be cases when a server prefers to change the + validator only on semantically significant changes, and not when + insignificant aspects of the entity change. A validator that does not + always change when the resource changes is a "weak validator." + + Entity tags are normally "strong validators," but the protocol + provides a mechanism to tag an entity tag as "weak." One can think of + a strong validator as one that changes whenever the bits of an entity + changes, while a weak value changes whenever the meaning of an entity + changes. Alternatively, one can think of a strong validator as part + of an identifier for a specific entity, while a weak validator is + part of an identifier for a set of semantically equivalent entities. + + Note: One example of a strong validator is an integer that is + incremented in stable storage every time an entity is changed. + + + +Fielding, et al. Standards Track [Page 86] + +RFC 2616 HTTP/1.1 June 1999 + + + An entity's modification time, if represented with one-second + resolution, could be a weak validator, since it is possible that + the resource might be modified twice during a single second. + + Support for weak validators is optional. However, weak validators + allow for more efficient caching of equivalent objects; for + example, a hit counter on a site is probably good enough if it is + updated every few days or weeks, and any value during that period + is likely "good enough" to be equivalent. + + A "use" of a validator is either when a client generates a request + and includes the validator in a validating header field, or when a + server compares two validators. + + Strong validators are usable in any context. Weak validators are only + usable in contexts that do not depend on exact equality of an entity. + For example, either kind is usable for a conditional GET of a full + entity. However, only a strong validator is usable for a sub-range + retrieval, since otherwise the client might end up with an internally + inconsistent entity. + + Clients MAY issue simple (non-subrange) GET requests with either weak + validators or strong validators. Clients MUST NOT use weak validators + in other forms of request. + + The only function that the HTTP/1.1 protocol defines on validators is + comparison. There are two validator comparison functions, depending + on whether the comparison context allows the use of weak validators + or not: + + - The strong comparison function: in order to be considered equal, + both validators MUST be identical in every way, and both MUST + NOT be weak. + + - The weak comparison function: in order to be considered equal, + both validators MUST be identical in every way, but either or + both of them MAY be tagged as "weak" without affecting the + result. + + An entity tag is strong unless it is explicitly tagged as weak. + Section 3.11 gives the syntax for entity tags. + + A Last-Modified time, when used as a validator in a request, is + implicitly weak unless it is possible to deduce that it is strong, + using the following rules: + + - The validator is being compared by an origin server to the + actual current validator for the entity and, + + + +Fielding, et al. Standards Track [Page 87] + +RFC 2616 HTTP/1.1 June 1999 + + + - That origin server reliably knows that the associated entity did + not change twice during the second covered by the presented + validator. + + or + + - The validator is about to be used by a client in an If- + Modified-Since or If-Unmodified-Since header, because the client + has a cache entry for the associated entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + or + + - The validator is being compared by an intermediate cache to the + validator stored in its cache entry for the entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + This method relies on the fact that if two different responses were + sent by the origin server during the same second, but both had the + same Last-Modified time, then at least one of those responses would + have a Date value equal to its Last-Modified time. The arbitrary 60- + second limit guards against the possibility that the Date and Last- + Modified values are generated from different clocks, or at somewhat + different times during the preparation of the response. An + implementation MAY use a value larger than 60 seconds, if it is + believed that 60 seconds is too short. + + If a client wishes to perform a sub-range retrieval on a value for + which it has only a Last-Modified time and no opaque validator, it + MAY do this only if the Last-Modified time is strong in the sense + described here. + + A cache or origin server receiving a conditional request, other than + a full-body GET request, MUST use the strong comparison function to + evaluate the condition. + + These rules allow HTTP/1.1 caches and clients to safely perform sub- + range retrievals on values that have been obtained from HTTP/1.0 + + + +Fielding, et al. Standards Track [Page 88] + +RFC 2616 HTTP/1.1 June 1999 + + + servers. + +13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates + + We adopt a set of rules and recommendations for origin servers, + clients, and caches regarding when various validator types ought to + be used, and for what purposes. + + HTTP/1.1 origin servers: + + - SHOULD send an entity tag validator unless it is not feasible to + generate one. + + - MAY send a weak entity tag instead of a strong entity tag, if + performance considerations support the use of weak entity tags, + or if it is unfeasible to send a strong entity tag. + + - SHOULD send a Last-Modified value if it is feasible to send one, + unless the risk of a breakdown in semantic transparency that + could result from using this date in an If-Modified-Since header + would lead to serious problems. + + In other words, the preferred behavior for an HTTP/1.1 origin server + is to send both a strong entity tag and a Last-Modified value. + + In order to be legal, a strong entity tag MUST change whenever the + associated entity value changes in any way. A weak entity tag SHOULD + change whenever the associated entity changes in a semantically + significant way. + + Note: in order to provide semantically transparent caching, an + origin server must avoid reusing a specific strong entity tag + value for two different entities, or reusing a specific weak + entity tag value for two semantically different entities. Cache + entries might persist for arbitrarily long periods, regardless of + expiration times, so it might be inappropriate to expect that a + cache will never again attempt to validate an entry using a + validator that it obtained at some point in the past. + + HTTP/1.1 clients: + + - If an entity tag has been provided by the origin server, MUST + use that entity tag in any cache-conditional request (using If- + Match or If-None-Match). + + - If only a Last-Modified value has been provided by the origin + server, SHOULD use that value in non-subrange cache-conditional + requests (using If-Modified-Since). + + + +Fielding, et al. Standards Track [Page 89] + +RFC 2616 HTTP/1.1 June 1999 + + + - If only a Last-Modified value has been provided by an HTTP/1.0 + origin server, MAY use that value in subrange cache-conditional + requests (using If-Unmodified-Since:). The user agent SHOULD + provide a way to disable this, in case of difficulty. + + - If both an entity tag and a Last-Modified value have been + provided by the origin server, SHOULD use both validators in + cache-conditional requests. This allows both HTTP/1.0 and + HTTP/1.1 caches to respond appropriately. + + An HTTP/1.1 origin server, upon receiving a conditional request that + includes both a Last-Modified date (e.g., in an If-Modified-Since or + If-Unmodified-Since header field) and one or more entity tags (e.g., + in an If-Match, If-None-Match, or If-Range header field) as cache + validators, MUST NOT return a response status of 304 (Not Modified) + unless doing so is consistent with all of the conditional header + fields in the request. + + An HTTP/1.1 caching proxy, upon receiving a conditional request that + includes both a Last-Modified date and one or more entity tags as + cache validators, MUST NOT return a locally cached response to the + client unless that cached response is consistent with all of the + conditional header fields in the request. + + Note: The general principle behind these rules is that HTTP/1.1 + servers and clients should transmit as much non-redundant + information as is available in their responses and requests. + HTTP/1.1 systems receiving this information will make the most + conservative assumptions about the validators they receive. + + HTTP/1.0 clients and caches will ignore entity tags. Generally, + last-modified values received or used by these systems will + support transparent and efficient caching, and so HTTP/1.1 origin + servers should provide Last-Modified values. In those rare cases + where the use of a Last-Modified value as a validator by an + HTTP/1.0 system could result in a serious problem, then HTTP/1.1 + origin servers should not provide one. + +13.3.5 Non-validating Conditionals + + The principle behind entity tags is that only the service author + knows the semantics of a resource well enough to select an + appropriate cache validation mechanism, and the specification of any + validator comparison function more complex than byte-equality would + open up a can of worms. Thus, comparisons of any other headers + (except Last-Modified, for compatibility with HTTP/1.0) are never + used for purposes of validating a cache entry. + + + + +Fielding, et al. Standards Track [Page 90] + +RFC 2616 HTTP/1.1 June 1999 + + +13.4 Response Cacheability + + Unless specifically constrained by a cache-control (section 14.9) + directive, a caching system MAY always store a successful response + (see section 13.8) as a cache entry, MAY return it without validation + if it is fresh, and MAY return it after successful validation. If + there is neither a cache validator nor an explicit expiration time + associated with a response, we do not expect it to be cached, but + certain caches MAY violate this expectation (for example, when little + or no network connectivity is available). A client can usually detect + that such a response was taken from a cache by comparing the Date + header to the current time. + + Note: some HTTP/1.0 caches are known to violate this expectation + without providing any Warning. + + However, in some cases it might be inappropriate for a cache to + retain an entity, or to return it in response to a subsequent + request. This might be because absolute semantic transparency is + deemed necessary by the service author, or because of security or + privacy considerations. Certain cache-control directives are + therefore provided so that the server can indicate that certain + resource entities, or portions thereof, are not to be cached + regardless of other considerations. + + Note that section 14.8 normally prevents a shared cache from saving + and returning a response to a previous request if that request + included an Authorization header. + + A response received with a status code of 200, 203, 206, 300, 301 or + 410 MAY be stored by a cache and used in reply to a subsequent + request, subject to the expiration mechanism, unless a cache-control + directive prohibits caching. However, a cache that does not support + the Range and Content-Range headers MUST NOT cache 206 (Partial + Content) responses. + + A response received with any other status code (e.g. status codes 302 + and 307) MUST NOT be returned in a reply to a subsequent request + unless there are cache-control directives or another header(s) that + explicitly allow it. For example, these include the following: an + Expires header (section 14.21); a "max-age", "s-maxage", "must- + revalidate", "proxy-revalidate", "public" or "private" cache-control + directive (section 14.9). + + + + + + + + +Fielding, et al. Standards Track [Page 91] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5 Constructing Responses From Caches + + The purpose of an HTTP cache is to store information received in + response to requests for use in responding to future requests. In + many cases, a cache simply returns the appropriate parts of a + response to the requester. However, if the cache holds a cache entry + based on a previous response, it might have to combine parts of a new + response with what is held in the cache entry. + +13.5.1 End-to-end and Hop-by-hop Headers + + For the purpose of defining the behavior of caches and non-caching + proxies, we divide HTTP headers into two categories: + + - End-to-end headers, which are transmitted to the ultimate + recipient of a request or response. End-to-end headers in + responses MUST be stored as part of a cache entry and MUST be + transmitted in any response formed from a cache entry. + + - Hop-by-hop headers, which are meaningful only for a single + transport-level connection, and are not stored by caches or + forwarded by proxies. + + The following HTTP/1.1 headers are hop-by-hop headers: + + - Connection + - Keep-Alive + - Proxy-Authenticate + - Proxy-Authorization + - TE + - Trailers + - Transfer-Encoding + - Upgrade + + All other headers defined by HTTP/1.1 are end-to-end headers. + + Other hop-by-hop headers MUST be listed in a Connection header, + (section 14.10) to be introduced into HTTP/1.1 (or later). + +13.5.2 Non-modifiable Headers + + Some features of the HTTP/1.1 protocol, such as Digest + Authentication, depend on the value of certain end-to-end headers. A + transparent proxy SHOULD NOT modify an end-to-end header unless the + definition of that header requires or specifically allows that. + + + + + + +Fielding, et al. Standards Track [Page 92] + +RFC 2616 HTTP/1.1 June 1999 + + + A transparent proxy MUST NOT modify any of the following fields in a + request or response, and it MUST NOT add any of these fields if not + already present: + + - Content-Location + + - Content-MD5 + + - ETag + + - Last-Modified + + A transparent proxy MUST NOT modify any of the following fields in a + response: + + - Expires + + but it MAY add any of these fields if not already present. If an + Expires header is added, it MUST be given a field-value identical to + that of the Date header in that response. + + A proxy MUST NOT modify or add any of the following fields in a + message that contains the no-transform cache-control directive, or in + any request: + + - Content-Encoding + + - Content-Range + + - Content-Type + + A non-transparent proxy MAY modify or add these fields to a message + that does not include no-transform, but if it does so, it MUST add a + Warning 214 (Transformation applied) if one does not already appear + in the message (see section 14.46). + + Warning: unnecessary modification of end-to-end headers might + cause authentication failures if stronger authentication + mechanisms are introduced in later versions of HTTP. Such + authentication mechanisms MAY rely on the values of header fields + not listed here. + + The Content-Length field of a request or response is added or deleted + according to the rules in section 4.4. A transparent proxy MUST + preserve the entity-length (section 7.2.2) of the entity-body, + although it MAY change the transfer-length (section 4.4). + + + + + +Fielding, et al. Standards Track [Page 93] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.3 Combining Headers + + When a cache makes a validating request to a server, and the server + provides a 304 (Not Modified) response or a 206 (Partial Content) + response, the cache then constructs a response to send to the + requesting client. + + If the status code is 304 (Not Modified), the cache uses the entity- + body stored in the cache entry as the entity-body of this outgoing + response. If the status code is 206 (Partial Content) and the ETag or + Last-Modified headers match exactly, the cache MAY combine the + contents stored in the cache entry with the new contents received in + the response and use the result as the entity-body of this outgoing + response, (see 13.5.4). + + The end-to-end headers stored in the cache entry are used for the + constructed response, except that + + - any stored Warning headers with warn-code 1xx (see section + 14.46) MUST be deleted from the cache entry and the forwarded + response. + + - any stored Warning headers with warn-code 2xx MUST be retained + in the cache entry and the forwarded response. + + - any end-to-end headers provided in the 304 or 206 response MUST + replace the corresponding headers from the cache entry. + + Unless the cache decides to remove the cache entry, it MUST also + replace the end-to-end headers stored with the cache entry with + corresponding headers received in the incoming response, except for + Warning headers as described immediately above. If a header field- + name in the incoming response matches more than one header in the + cache entry, all such old headers MUST be replaced. + + In other words, the set of end-to-end headers received in the + incoming response overrides all corresponding end-to-end headers + stored with the cache entry (except for stored Warning headers with + warn-code 1xx, which are deleted even if not overridden). + + Note: this rule allows an origin server to use a 304 (Not + Modified) or a 206 (Partial Content) response to update any header + associated with a previous response for the same entity or sub- + ranges thereof, although it might not always be meaningful or + correct to do so. This rule does not allow an origin server to use + a 304 (Not Modified) or a 206 (Partial Content) response to + entirely delete a header that it had provided with a previous + response. + + + +Fielding, et al. Standards Track [Page 94] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.4 Combining Byte Ranges + + A response might transfer only a subrange of the bytes of an entity- + body, either because the request included one or more Range + specifications, or because a connection was broken prematurely. After + several such transfers, a cache might have received several ranges of + the same entity-body. + + If a cache has a stored non-empty set of subranges for an entity, and + an incoming response transfers another subrange, the cache MAY + combine the new subrange with the existing set if both the following + conditions are met: + + - Both the incoming response and the cache entry have a cache + validator. + + - The two cache validators match using the strong comparison + function (see section 13.3.3). + + If either requirement is not met, the cache MUST use only the most + recent partial response (based on the Date values transmitted with + every response, and using the incoming response if these values are + equal or missing), and MUST discard the other partial information. + +13.6 Caching Negotiated Responses + + Use of server-driven content negotiation (section 12.1), as indicated + by the presence of a Vary header field in a response, alters the + conditions and procedure by which a cache can use the response for + subsequent requests. See section 14.44 for use of the Vary header + field by servers. + + A server SHOULD use the Vary header field to inform a cache of what + request-header fields were used to select among multiple + representations of a cacheable response subject to server-driven + negotiation. The set of header fields named by the Vary field value + is known as the "selecting" request-headers. + + When the cache receives a subsequent request whose Request-URI + specifies one or more cache entries including a Vary header field, + the cache MUST NOT use such a cache entry to construct a response to + the new request unless all of the selecting request-headers present + in the new request match the corresponding stored request-headers in + the original request. + + The selecting request-headers from two requests are defined to match + if and only if the selecting request-headers in the first request can + be transformed to the selecting request-headers in the second request + + + +Fielding, et al. Standards Track [Page 95] + +RFC 2616 HTTP/1.1 June 1999 + + + by adding or removing linear white space (LWS) at places where this + is allowed by the corresponding BNF, and/or combining multiple + message-header fields with the same field name following the rules + about message headers in section 4.2. + + A Vary header field-value of "*" always fails to match and subsequent + requests on that resource can only be properly interpreted by the + origin server. + + If the selecting request header fields for the cached entry do not + match the selecting request header fields of the new request, then + the cache MUST NOT use a cached entry to satisfy the request unless + it first relays the new request to the origin server in a conditional + request and the server responds with 304 (Not Modified), including an + entity tag or Content-Location that indicates the entity to be used. + + If an entity tag was assigned to a cached representation, the + forwarded request SHOULD be conditional and include the entity tags + in an If-None-Match header field from all its cache entries for the + resource. This conveys to the server the set of entities currently + held by the cache, so that if any one of these entities matches the + requested entity, the server can use the ETag header field in its 304 + (Not Modified) response to tell the cache which entry is appropriate. + If the entity-tag of the new response matches that of an existing + entry, the new response SHOULD be used to update the header fields of + the existing entry, and the result MUST be returned to the client. + + If any of the existing cache entries contains only partial content + for the associated entity, its entity-tag SHOULD NOT be included in + the If-None-Match header field unless the request is for a range that + would be fully satisfied by that entry. + + If a cache receives a successful response whose Content-Location + field matches that of an existing cache entry for the same Request- + ]URI, whose entity-tag differs from that of the existing entry, and + whose Date is more recent than that of the existing entry, the + existing entry SHOULD NOT be returned in response to future requests + and SHOULD be deleted from the cache. + +13.7 Shared and Non-Shared Caches + + For reasons of security and privacy, it is necessary to make a + distinction between "shared" and "non-shared" caches. A non-shared + cache is one that is accessible only to a single user. Accessibility + in this case SHOULD be enforced by appropriate security mechanisms. + All other caches are considered to be "shared." Other sections of + + + + + +Fielding, et al. Standards Track [Page 96] + +RFC 2616 HTTP/1.1 June 1999 + + + this specification place certain constraints on the operation of + shared caches in order to prevent loss of privacy or failure of + access controls. + +13.8 Errors or Incomplete Response Cache Behavior + + A cache that receives an incomplete response (for example, with fewer + bytes of data than specified in a Content-Length header) MAY store + the response. However, the cache MUST treat this as a partial + response. Partial responses MAY be combined as described in section + 13.5.4; the result might be a full response or might still be + partial. A cache MUST NOT return a partial response to a client + without explicitly marking it as such, using the 206 (Partial + Content) status code. A cache MUST NOT return a partial response + using a status code of 200 (OK). + + If a cache receives a 5xx response while attempting to revalidate an + entry, it MAY either forward this response to the requesting client, + or act as if the server failed to respond. In the latter case, it MAY + return a previously received response unless the cached entry + includes the "must-revalidate" cache-control directive (see section + 14.9). + +13.9 Side Effects of GET and HEAD + + Unless the origin server explicitly prohibits the caching of their + responses, the application of GET and HEAD methods to any resources + SHOULD NOT have side effects that would lead to erroneous behavior if + these responses are taken from a cache. They MAY still have side + effects, but a cache is not required to consider such side effects in + its caching decisions. Caches are always expected to observe an + origin server's explicit restrictions on caching. + + We note one exception to this rule: since some applications have + traditionally used GETs and HEADs with query URLs (those containing a + "?" in the rel_path part) to perform operations with significant side + effects, caches MUST NOT treat responses to such URIs as fresh unless + the server provides an explicit expiration time. This specifically + means that responses from HTTP/1.0 servers for such URIs SHOULD NOT + be taken from a cache. See section 9.1.1 for related information. + +13.10 Invalidation After Updates or Deletions + + The effect of certain methods performed on a resource at the origin + server might cause one or more existing cache entries to become non- + transparently invalid. That is, although they might continue to be + "fresh," they do not accurately reflect what the origin server would + return for a new request on that resource. + + + +Fielding, et al. Standards Track [Page 97] + +RFC 2616 HTTP/1.1 June 1999 + + + There is no way for the HTTP protocol to guarantee that all such + cache entries are marked invalid. For example, the request that + caused the change at the origin server might not have gone through + the proxy where a cache entry is stored. However, several rules help + reduce the likelihood of erroneous behavior. + + In this section, the phrase "invalidate an entity" means that the + cache will either remove all instances of that entity from its + storage, or will mark these as "invalid" and in need of a mandatory + revalidation before they can be returned in response to a subsequent + request. + + Some HTTP methods MUST cause a cache to invalidate an entity. This is + either the entity referred to by the Request-URI, or by the Location + or Content-Location headers (if present). These methods are: + + - PUT + + - DELETE + + - POST + + In order to prevent denial of service attacks, an invalidation based + on the URI in a Location or Content-Location header MUST only be + performed if the host part is the same as in the Request-URI. + + A cache that passes through requests for methods it does not + understand SHOULD invalidate any entities referred to by the + Request-URI. + +13.11 Write-Through Mandatory + + All methods that might be expected to cause modifications to the + origin server's resources MUST be written through to the origin + server. This currently includes all methods except for GET and HEAD. + A cache MUST NOT reply to such a request from a client before having + transmitted the request to the inbound server, and having received a + corresponding response from the inbound server. This does not prevent + a proxy cache from sending a 100 (Continue) response before the + inbound server has sent its final reply. + + The alternative (known as "write-back" or "copy-back" caching) is not + allowed in HTTP/1.1, due to the difficulty of providing consistent + updates and the problems arising from server, cache, or network + failure prior to write-back. + + + + + + +Fielding, et al. Standards Track [Page 98] + +RFC 2616 HTTP/1.1 June 1999 + + +13.12 Cache Replacement + + If a new cacheable (see sections 14.9.2, 13.2.5, 13.2.6 and 13.8) + response is received from a resource while any existing responses for + the same resource are cached, the cache SHOULD use the new response + to reply to the current request. It MAY insert it into cache storage + and MAY, if it meets all other requirements, use it to respond to any + future requests that would previously have caused the old response to + be returned. If it inserts the new response into cache storage the + rules in section 13.5.3 apply. + + Note: a new response that has an older Date header value than + existing cached responses is not cacheable. + +13.13 History Lists + + User agents often have history mechanisms, such as "Back" buttons and + history lists, which can be used to redisplay an entity retrieved + earlier in a session. + + History mechanisms and caches are different. In particular history + mechanisms SHOULD NOT try to show a semantically transparent view of + the current state of a resource. Rather, a history mechanism is meant + to show exactly what the user saw at the time when the resource was + retrieved. + + By default, an expiration time does not apply to history mechanisms. + If the entity is still in storage, a history mechanism SHOULD display + it even if the entity has expired, unless the user has specifically + configured the agent to refresh expired history documents. + + This is not to be construed to prohibit the history mechanism from + telling the user that a view might be stale. + + Note: if history list mechanisms unnecessarily prevent users from + viewing stale resources, this will tend to force service authors + to avoid using HTTP expiration controls and cache controls when + they would otherwise like to. Service authors may consider it + important that users not be presented with error messages or + warning messages when they use navigation controls (such as BACK) + to view previously fetched resources. Even though sometimes such + resources ought not to cached, or ought to expire quickly, user + interface considerations may force service authors to resort to + other means of preventing caching (e.g. "once-only" URLs) in order + not to suffer the effects of improperly functioning history + mechanisms. + + + + + +Fielding, et al. Standards Track [Page 99] + +RFC 2616 HTTP/1.1 June 1999 + + +14 Header Field Definitions + + This section defines the syntax and semantics of all standard + HTTP/1.1 header fields. For entity-header fields, both sender and + recipient refer to either the client or the server, depending on who + sends and who receives the entity. + +14.1 Accept + + The Accept request-header field can be used to specify certain media + types which are acceptable for the response. Accept headers can be + used to indicate that the request is specifically limited to a small + set of desired types, as in the case of a request for an in-line + image. + + Accept = "Accept" ":" + #( media-range [ accept-params ] ) + + media-range = ( "*/*" + | ( type "/" "*" ) + | ( type "/" subtype ) + ) *( ";" parameter ) + accept-params = ";" "q" "=" qvalue *( accept-extension ) + accept-extension = ";" token [ "=" ( token | quoted-string ) ] + + The asterisk "*" character is used to group media types into ranges, + with "*/*" indicating all media types and "type/*" indicating all + subtypes of that type. The media-range MAY include media type + parameters that are applicable to that range. + + Each media-range MAY be followed by one or more accept-params, + beginning with the "q" parameter for indicating a relative quality + factor. The first "q" parameter (if any) separates the media-range + parameter(s) from the accept-params. Quality factors allow the user + or user agent to indicate the relative degree of preference for that + media-range, using the qvalue scale from 0 to 1 (section 3.9). The + default value is q=1. + + Note: Use of the "q" parameter name to separate media type + parameters from Accept extension parameters is due to historical + practice. Although this prevents any media type parameter named + "q" from being used with a media range, such an event is believed + to be unlikely given the lack of any "q" parameters in the IANA + media type registry and the rare usage of any media type + parameters in Accept. Future media types are discouraged from + registering any parameter named "q". + + + + + +Fielding, et al. Standards Track [Page 100] + +RFC 2616 HTTP/1.1 June 1999 + + + The example + + Accept: audio/*; q=0.2, audio/basic + + SHOULD be interpreted as "I prefer audio/basic, but send me any audio + type if it is the best available after an 80% mark-down in quality." + + If no Accept header field is present, then it is assumed that the + client accepts all media types. If an Accept header field is present, + and if the server cannot send a response which is acceptable + according to the combined Accept field value, then the server SHOULD + send a 406 (not acceptable) response. + + A more elaborate example is + + Accept: text/plain; q=0.5, text/html, + text/x-dvi; q=0.8, text/x-c + + Verbally, this would be interpreted as "text/html and text/x-c are + the preferred media types, but if they do not exist, then send the + text/x-dvi entity, and if that does not exist, send the text/plain + entity." + + Media ranges can be overridden by more specific media ranges or + specific media types. If more than one media range applies to a given + type, the most specific reference has precedence. For example, + + Accept: text/*, text/html, text/html;level=1, */* + + have the following precedence: + + 1) text/html;level=1 + 2) text/html + 3) text/* + 4) */* + + The media type quality factor associated with a given type is + determined by finding the media range with the highest precedence + which matches that type. For example, + + Accept: text/*;q=0.3, text/html;q=0.7, text/html;level=1, + text/html;level=2;q=0.4, */*;q=0.5 + + would cause the following values to be associated: + + text/html;level=1 = 1 + text/html = 0.7 + text/plain = 0.3 + + + +Fielding, et al. Standards Track [Page 101] + +RFC 2616 HTTP/1.1 June 1999 + + + image/jpeg = 0.5 + text/html;level=2 = 0.4 + text/html;level=3 = 0.7 + + Note: A user agent might be provided with a default set of quality + values for certain media ranges. However, unless the user agent is + a closed system which cannot interact with other rendering agents, + this default set ought to be configurable by the user. + +14.2 Accept-Charset + + The Accept-Charset request-header field can be used to indicate what + character sets are acceptable for the response. This field allows + clients capable of understanding more comprehensive or special- + purpose character sets to signal that capability to a server which is + capable of representing documents in those character sets. + + Accept-Charset = "Accept-Charset" ":" + 1#( ( charset | "*" )[ ";" "q" "=" qvalue ] ) + + + Character set values are described in section 3.4. Each charset MAY + be given an associated quality value which represents the user's + preference for that charset. The default value is q=1. An example is + + Accept-Charset: iso-8859-5, unicode-1-1;q=0.8 + + The special value "*", if present in the Accept-Charset field, + matches every character set (including ISO-8859-1) which is not + mentioned elsewhere in the Accept-Charset field. If no "*" is present + in an Accept-Charset field, then all character sets not explicitly + mentioned get a quality value of 0, except for ISO-8859-1, which gets + a quality value of 1 if not explicitly mentioned. + + If no Accept-Charset header is present, the default is that any + character set is acceptable. If an Accept-Charset header is present, + and if the server cannot send a response which is acceptable + according to the Accept-Charset header, then the server SHOULD send + an error response with the 406 (not acceptable) status code, though + the sending of an unacceptable response is also allowed. + +14.3 Accept-Encoding + + The Accept-Encoding request-header field is similar to Accept, but + restricts the content-codings (section 3.5) that are acceptable in + the response. + + Accept-Encoding = "Accept-Encoding" ":" + + + +Fielding, et al. Standards Track [Page 102] + +RFC 2616 HTTP/1.1 June 1999 + + + 1#( codings [ ";" "q" "=" qvalue ] ) + codings = ( content-coding | "*" ) + + Examples of its use are: + + Accept-Encoding: compress, gzip + Accept-Encoding: + Accept-Encoding: * + Accept-Encoding: compress;q=0.5, gzip;q=1.0 + Accept-Encoding: gzip;q=1.0, identity; q=0.5, *;q=0 + + A server tests whether a content-coding is acceptable, according to + an Accept-Encoding field, using these rules: + + 1. If the content-coding is one of the content-codings listed in + the Accept-Encoding field, then it is acceptable, unless it is + accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + 2. The special "*" symbol in an Accept-Encoding field matches any + available content-coding not explicitly listed in the header + field. + + 3. If multiple content-codings are acceptable, then the acceptable + content-coding with the highest non-zero qvalue is preferred. + + 4. The "identity" content-coding is always acceptable, unless + specifically refused because the Accept-Encoding field includes + "identity;q=0", or because the field includes "*;q=0" and does + not explicitly include the "identity" content-coding. If the + Accept-Encoding field-value is empty, then only the "identity" + encoding is acceptable. + + If an Accept-Encoding field is present in a request, and if the + server cannot send a response which is acceptable according to the + Accept-Encoding header, then the server SHOULD send an error response + with the 406 (Not Acceptable) status code. + + If no Accept-Encoding field is present in a request, the server MAY + assume that the client will accept any content coding. In this case, + if "identity" is one of the available content-codings, then the + server SHOULD use the "identity" content-coding, unless it has + additional information that a different content-coding is meaningful + to the client. + + Note: If the request does not include an Accept-Encoding field, + and if the "identity" content-coding is unavailable, then + content-codings commonly understood by HTTP/1.0 clients (i.e., + + + +Fielding, et al. Standards Track [Page 103] + +RFC 2616 HTTP/1.1 June 1999 + + + "gzip" and "compress") are preferred; some older clients + improperly display messages sent with other content-codings. The + server might also make this decision based on information about + the particular user-agent or client. + + Note: Most HTTP/1.0 applications do not recognize or obey qvalues + associated with content-codings. This means that qvalues will not + work and are not permitted with x-gzip or x-compress. + +14.4 Accept-Language + + The Accept-Language request-header field is similar to Accept, but + restricts the set of natural languages that are preferred as a + response to the request. Language tags are defined in section 3.10. + + Accept-Language = "Accept-Language" ":" + 1#( language-range [ ";" "q" "=" qvalue ] ) + language-range = ( ( 1*8ALPHA *( "-" 1*8ALPHA ) ) | "*" ) + + Each language-range MAY be given an associated quality value which + represents an estimate of the user's preference for the languages + specified by that range. The quality value defaults to "q=1". For + example, + + Accept-Language: da, en-gb;q=0.8, en;q=0.7 + + would mean: "I prefer Danish, but will accept British English and + other types of English." A language-range matches a language-tag if + it exactly equals the tag, or if it exactly equals a prefix of the + tag such that the first tag character following the prefix is "-". + The special range "*", if present in the Accept-Language field, + matches every tag not matched by any other range present in the + Accept-Language field. + + Note: This use of a prefix matching rule does not imply that + language tags are assigned to languages in such a way that it is + always true that if a user understands a language with a certain + tag, then this user will also understand all languages with tags + for which this tag is a prefix. The prefix rule simply allows the + use of prefix tags if this is the case. + + The language quality factor assigned to a language-tag by the + Accept-Language field is the quality value of the longest language- + range in the field that matches the language-tag. If no language- + range in the field matches the tag, the language quality factor + assigned is 0. If no Accept-Language header is present in the + request, the server + + + + +Fielding, et al. Standards Track [Page 104] + +RFC 2616 HTTP/1.1 June 1999 + + + SHOULD assume that all languages are equally acceptable. If an + Accept-Language header is present, then all languages which are + assigned a quality factor greater than 0 are acceptable. + + It might be contrary to the privacy expectations of the user to send + an Accept-Language header with the complete linguistic preferences of + the user in every request. For a discussion of this issue, see + section 15.1.4. + + As intelligibility is highly dependent on the individual user, it is + recommended that client applications make the choice of linguistic + preference available to the user. If the choice is not made + available, then the Accept-Language header field MUST NOT be given in + the request. + + Note: When making the choice of linguistic preference available to + the user, we remind implementors of the fact that users are not + familiar with the details of language matching as described above, + and should provide appropriate guidance. As an example, users + might assume that on selecting "en-gb", they will be served any + kind of English document if British English is not available. A + user agent might suggest in such a case to add "en" to get the + best matching behavior. + +14.5 Accept-Ranges + + The Accept-Ranges response-header field allows the server to + indicate its acceptance of range requests for a resource: + + Accept-Ranges = "Accept-Ranges" ":" acceptable-ranges + acceptable-ranges = 1#range-unit | "none" + + Origin servers that accept byte-range requests MAY send + + Accept-Ranges: bytes + + but are not required to do so. Clients MAY generate byte-range + requests without having received this header for the resource + involved. Range units are defined in section 3.12. + + Servers that do not accept any kind of range request for a + resource MAY send + + Accept-Ranges: none + + to advise the client not to attempt a range request. + + + + + +Fielding, et al. Standards Track [Page 105] + +RFC 2616 HTTP/1.1 June 1999 + + +14.6 Age + + The Age response-header field conveys the sender's estimate of the + amount of time since the response (or its revalidation) was + generated at the origin server. A cached response is "fresh" if + its age does not exceed its freshness lifetime. Age values are + calculated as specified in section 13.2.3. + + Age = "Age" ":" age-value + age-value = delta-seconds + + Age values are non-negative decimal integers, representing time in + seconds. + + If a cache receives a value larger than the largest positive + integer it can represent, or if any of its age calculations + overflows, it MUST transmit an Age header with a value of + 2147483648 (2^31). An HTTP/1.1 server that includes a cache MUST + include an Age header field in every response generated from its + own cache. Caches SHOULD use an arithmetic type of at least 31 + bits of range. + +14.7 Allow + + The Allow entity-header field lists the set of methods supported + by the resource identified by the Request-URI. The purpose of this + field is strictly to inform the recipient of valid methods + associated with the resource. An Allow header field MUST be + present in a 405 (Method Not Allowed) response. + + Allow = "Allow" ":" #Method + + Example of use: + + Allow: GET, HEAD, PUT + + This field cannot prevent a client from trying other methods. + However, the indications given by the Allow header field value + SHOULD be followed. The actual set of allowed methods is defined + by the origin server at the time of each request. + + The Allow header field MAY be provided with a PUT request to + recommend the methods to be supported by the new or modified + resource. The server is not required to support these methods and + SHOULD include an Allow header in the response giving the actual + supported methods. + + + + + +Fielding, et al. Standards Track [Page 106] + +RFC 2616 HTTP/1.1 June 1999 + + + A proxy MUST NOT modify the Allow header field even if it does not + understand all the methods specified, since the user agent might + have other means of communicating with the origin server. + +14.8 Authorization + + A user agent that wishes to authenticate itself with a server-- + usually, but not necessarily, after receiving a 401 response--does + so by including an Authorization request-header field with the + request. The Authorization field value consists of credentials + containing the authentication information of the user agent for + the realm of the resource being requested. + + Authorization = "Authorization" ":" credentials + + HTTP access authentication is described in "HTTP Authentication: + Basic and Digest Access Authentication" [43]. If a request is + authenticated and a realm specified, the same credentials SHOULD + be valid for all other requests within this realm (assuming that + the authentication scheme itself does not require otherwise, such + as credentials that vary according to a challenge value or using + synchronized clocks). + + When a shared cache (see section 13.7) receives a request + containing an Authorization field, it MUST NOT return the + corresponding response as a reply to any other request, unless one + of the following specific exceptions holds: + + 1. If the response includes the "s-maxage" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But (if the specified maximum age has + passed) a proxy cache MUST first revalidate it with the origin + server, using the request-headers from the new request to allow + the origin server to authenticate the new request. (This is the + defined behavior for s-maxage.) If the response includes "s- + maxage=0", the proxy MUST always revalidate it before re-using + it. + + 2. If the response includes the "must-revalidate" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But if the response is stale, all caches + MUST first revalidate it with the origin server, using the + request-headers from the new request to allow the origin server + to authenticate the new request. + + 3. If the response includes the "public" cache-control directive, + it MAY be returned in reply to any subsequent request. + + + + +Fielding, et al. Standards Track [Page 107] + +RFC 2616 HTTP/1.1 June 1999 + + +14.9 Cache-Control + + The Cache-Control general-header field is used to specify directives + that MUST be obeyed by all caching mechanisms along the + request/response chain. The directives specify behavior intended to + prevent caches from adversely interfering with the request or + response. These directives typically override the default caching + algorithms. Cache directives are unidirectional in that the presence + of a directive in a request does not imply that the same directive is + to be given in the response. + + Note that HTTP/1.0 caches might not implement Cache-Control and + might only implement Pragma: no-cache (see section 14.32). + + Cache directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a cache- + directive for a specific cache. + + Cache-Control = "Cache-Control" ":" 1#cache-directive + + cache-directive = cache-request-directive + | cache-response-directive + + cache-request-directive = + "no-cache" ; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "max-age" "=" delta-seconds ; Section 14.9.3, 14.9.4 + | "max-stale" [ "=" delta-seconds ] ; Section 14.9.3 + | "min-fresh" "=" delta-seconds ; Section 14.9.3 + | "no-transform" ; Section 14.9.5 + | "only-if-cached" ; Section 14.9.4 + | cache-extension ; Section 14.9.6 + + cache-response-directive = + "public" ; Section 14.9.1 + | "private" [ "=" <"> 1#field-name <"> ] ; Section 14.9.1 + | "no-cache" [ "=" <"> 1#field-name <"> ]; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "no-transform" ; Section 14.9.5 + | "must-revalidate" ; Section 14.9.4 + | "proxy-revalidate" ; Section 14.9.4 + | "max-age" "=" delta-seconds ; Section 14.9.3 + | "s-maxage" "=" delta-seconds ; Section 14.9.3 + | cache-extension ; Section 14.9.6 + + cache-extension = token [ "=" ( token | quoted-string ) ] + + + +Fielding, et al. Standards Track [Page 108] + +RFC 2616 HTTP/1.1 June 1999 + + + When a directive appears without any 1#field-name parameter, the + directive applies to the entire request or response. When such a + directive appears with a 1#field-name parameter, it applies only to + the named field or fields, and not to the rest of the request or + response. This mechanism supports extensibility; implementations of + future versions of the HTTP protocol might apply these directives to + header fields not defined in HTTP/1.1. + + The cache-control directives can be broken down into these general + categories: + + - Restrictions on what are cacheable; these may only be imposed by + the origin server. + + - Restrictions on what may be stored by a cache; these may be + imposed by either the origin server or the user agent. + + - Modifications of the basic expiration mechanism; these may be + imposed by either the origin server or the user agent. + + - Controls over cache revalidation and reload; these may only be + imposed by a user agent. + + - Control over transformation of entities. + + - Extensions to the caching system. + +14.9.1 What is Cacheable + + By default, a response is cacheable if the requirements of the + request method, request header fields, and the response status + indicate that it is cacheable. Section 13.4 summarizes these defaults + for cacheability. The following Cache-Control response directives + allow an origin server to override the default cacheability of a + response: + + public + Indicates that the response MAY be cached by any cache, even if it + would normally be non-cacheable or cacheable only within a non- + shared cache. (See also Authorization, section 14.8, for + additional details.) + + private + Indicates that all or part of the response message is intended for + a single user and MUST NOT be cached by a shared cache. This + allows an origin server to state that the specified parts of the + + + + + +Fielding, et al. Standards Track [Page 109] + +RFC 2616 HTTP/1.1 June 1999 + + + response are intended for only one user and are not a valid + response for requests by other users. A private (non-shared) cache + MAY cache the response. + + Note: This usage of the word private only controls where the + response may be cached, and cannot ensure the privacy of the + message content. + + no-cache + If the no-cache directive does not specify a field-name, then a + cache MUST NOT use the response to satisfy a subsequent request + without successful revalidation with the origin server. This + allows an origin server to prevent caching even by caches that + have been configured to return stale responses to client requests. + + If the no-cache directive does specify one or more field-names, + then a cache MAY use the response to satisfy a subsequent request, + subject to any other restrictions on caching. However, the + specified field-name(s) MUST NOT be sent in the response to a + subsequent request without successful revalidation with the origin + server. This allows an origin server to prevent the re-use of + certain header fields in a response, while still allowing caching + of the rest of the response. + + Note: Most HTTP/1.0 caches will not recognize or obey this + directive. + +14.9.2 What May be Stored by Caches + + no-store + The purpose of the no-store directive is to prevent the + inadvertent release or retention of sensitive information (for + example, on backup tapes). The no-store directive applies to the + entire message, and MAY be sent either in a response or in a + request. If sent in a request, a cache MUST NOT store any part of + either this request or any response to it. If sent in a response, + a cache MUST NOT store any part of either this response or the + request that elicited it. This directive applies to both non- + shared and shared caches. "MUST NOT store" in this context means + that the cache MUST NOT intentionally store the information in + non-volatile storage, and MUST make a best-effort attempt to + remove the information from volatile storage as promptly as + possible after forwarding it. + + Even when this directive is associated with a response, users + might explicitly store such a response outside of the caching + system (e.g., with a "Save As" dialog). History buffers MAY store + such responses as part of their normal operation. + + + +Fielding, et al. Standards Track [Page 110] + +RFC 2616 HTTP/1.1 June 1999 + + + The purpose of this directive is to meet the stated requirements + of certain users and service authors who are concerned about + accidental releases of information via unanticipated accesses to + cache data structures. While the use of this directive might + improve privacy in some cases, we caution that it is NOT in any + way a reliable or sufficient mechanism for ensuring privacy. In + particular, malicious or compromised caches might not recognize or + obey this directive, and communications networks might be + vulnerable to eavesdropping. + +14.9.3 Modifications of the Basic Expiration Mechanism + + The expiration time of an entity MAY be specified by the origin + server using the Expires header (see section 14.21). Alternatively, + it MAY be specified using the max-age directive in a response. When + the max-age cache-control directive is present in a cached response, + the response is stale if its current age is greater than the age + value given (in seconds) at the time of a new request for that + resource. The max-age directive on a response implies that the + response is cacheable (i.e., "public") unless some other, more + restrictive cache directive is also present. + + If a response includes both an Expires header and a max-age + directive, the max-age directive overrides the Expires header, even + if the Expires header is more restrictive. This rule allows an origin + server to provide, for a given response, a longer expiration time to + an HTTP/1.1 (or later) cache than to an HTTP/1.0 cache. This might be + useful if certain HTTP/1.0 caches improperly calculate ages or + expiration times, perhaps due to desynchronized clocks. + + Many HTTP/1.0 cache implementations will treat an Expires value that + is less than or equal to the response Date value as being equivalent + to the Cache-Control response directive "no-cache". If an HTTP/1.1 + cache receives such a response, and the response does not include a + Cache-Control header field, it SHOULD consider the response to be + non-cacheable in order to retain compatibility with HTTP/1.0 servers. + + Note: An origin server might wish to use a relatively new HTTP + cache control feature, such as the "private" directive, on a + network including older caches that do not understand that + feature. The origin server will need to combine the new feature + with an Expires field whose value is less than or equal to the + Date value. This will prevent older caches from improperly + caching the response. + + + + + + + +Fielding, et al. Standards Track [Page 111] + +RFC 2616 HTTP/1.1 June 1999 + + + s-maxage + If a response includes an s-maxage directive, then for a shared + cache (but not for a private cache), the maximum age specified by + this directive overrides the maximum age specified by either the + max-age directive or the Expires header. The s-maxage directive + also implies the semantics of the proxy-revalidate directive (see + section 14.9.4), i.e., that the shared cache must not use the + entry after it becomes stale to respond to a subsequent request + without first revalidating it with the origin server. The s- + maxage directive is always ignored by a private cache. + + Note that most older caches, not compliant with this specification, + do not implement any cache-control directives. An origin server + wishing to use a cache-control directive that restricts, but does not + prevent, caching by an HTTP/1.1-compliant cache MAY exploit the + requirement that the max-age directive overrides the Expires header, + and the fact that pre-HTTP/1.1-compliant caches do not observe the + max-age directive. + + Other directives allow a user agent to modify the basic expiration + mechanism. These directives MAY be specified on a request: + + max-age + Indicates that the client is willing to accept a response whose + age is no greater than the specified time in seconds. Unless max- + stale directive is also included, the client is not willing to + accept a stale response. + + min-fresh + Indicates that the client is willing to accept a response whose + freshness lifetime is no less than its current age plus the + specified time in seconds. That is, the client wants a response + that will still be fresh for at least the specified number of + seconds. + + max-stale + Indicates that the client is willing to accept a response that has + exceeded its expiration time. If max-stale is assigned a value, + then the client is willing to accept a response that has exceeded + its expiration time by no more than the specified number of + seconds. If no value is assigned to max-stale, then the client is + willing to accept a stale response of any age. + + If a cache returns a stale response, either because of a max-stale + directive on a request, or because the cache is configured to + override the expiration time of a response, the cache MUST attach a + Warning header to the stale response, using Warning 110 (Response is + stale). + + + +Fielding, et al. Standards Track [Page 112] + +RFC 2616 HTTP/1.1 June 1999 + + + A cache MAY be configured to return stale responses without + validation, but only if this does not conflict with any "MUST"-level + requirements concerning cache validation (e.g., a "must-revalidate" + cache-control directive). + + If both the new request and the cached entry include "max-age" + directives, then the lesser of the two values is used for determining + the freshness of the cached entry for that request. + +14.9.4 Cache Revalidation and Reload Controls + + Sometimes a user agent might want or need to insist that a cache + revalidate its cache entry with the origin server (and not just with + the next cache along the path to the origin server), or to reload its + cache entry from the origin server. End-to-end revalidation might be + necessary if either the cache or the origin server has overestimated + the expiration time of the cached response. End-to-end reload may be + necessary if the cache entry has become corrupted for some reason. + + End-to-end revalidation may be requested either when the client does + not have its own local cached copy, in which case we call it + "unspecified end-to-end revalidation", or when the client does have a + local cached copy, in which case we call it "specific end-to-end + revalidation." + + The client can specify these three kinds of action using Cache- + Control request directives: + + End-to-end reload + The request includes a "no-cache" cache-control directive or, for + compatibility with HTTP/1.0 clients, "Pragma: no-cache". Field + names MUST NOT be included with the no-cache directive in a + request. The server MUST NOT use a cached copy when responding to + such a request. + + Specific end-to-end revalidation + The request includes a "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request includes a cache-validating conditional with + the client's current validator. + + Unspecified end-to-end revalidation + The request includes "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request does not include a cache-validating + + + + +Fielding, et al. Standards Track [Page 113] + +RFC 2616 HTTP/1.1 June 1999 + + + conditional; the first cache along the path (if any) that holds a + cache entry for this resource includes a cache-validating + conditional with its current validator. + + max-age + When an intermediate cache is forced, by means of a max-age=0 + directive, to revalidate its own cache entry, and the client has + supplied its own validator in the request, the supplied validator + might differ from the validator currently stored with the cache + entry. In this case, the cache MAY use either validator in making + its own request without affecting semantic transparency. + + However, the choice of validator might affect performance. The + best approach is for the intermediate cache to use its own + validator when making its request. If the server replies with 304 + (Not Modified), then the cache can return its now validated copy + to the client with a 200 (OK) response. If the server replies with + a new entity and cache validator, however, the intermediate cache + can compare the returned validator with the one provided in the + client's request, using the strong comparison function. If the + client's validator is equal to the origin server's, then the + intermediate cache simply returns 304 (Not Modified). Otherwise, + it returns the new entity with a 200 (OK) response. + + If a request includes the no-cache directive, it SHOULD NOT + include min-fresh, max-stale, or max-age. + + only-if-cached + In some cases, such as times of extremely poor network + connectivity, a client may want a cache to return only those + responses that it currently has stored, and not to reload or + revalidate with the origin server. To do this, the client may + include the only-if-cached directive in a request. If it receives + this directive, a cache SHOULD either respond using a cached entry + that is consistent with the other constraints of the request, or + respond with a 504 (Gateway Timeout) status. However, if a group + of caches is being operated as a unified system with good internal + connectivity, such a request MAY be forwarded within that group of + caches. + + must-revalidate + Because a cache MAY be configured to ignore a server's specified + expiration time, and because a client request MAY include a max- + stale directive (which has a similar effect), the protocol also + includes a mechanism for the origin server to require revalidation + of a cache entry on any subsequent use. When the must-revalidate + directive is present in a response received by a cache, that cache + MUST NOT use the entry after it becomes stale to respond to a + + + +Fielding, et al. Standards Track [Page 114] + +RFC 2616 HTTP/1.1 June 1999 + + + subsequent request without first revalidating it with the origin + server. (I.e., the cache MUST do an end-to-end revalidation every + time, if, based solely on the origin server's Expires or max-age + value, the cached response is stale.) + + The must-revalidate directive is necessary to support reliable + operation for certain protocol features. In all circumstances an + HTTP/1.1 cache MUST obey the must-revalidate directive; in + particular, if the cache cannot reach the origin server for any + reason, it MUST generate a 504 (Gateway Timeout) response. + + Servers SHOULD send the must-revalidate directive if and only if + failure to revalidate a request on the entity could result in + incorrect operation, such as a silently unexecuted financial + transaction. Recipients MUST NOT take any automated action that + violates this directive, and MUST NOT automatically provide an + unvalidated copy of the entity if revalidation fails. + + Although this is not recommended, user agents operating under + severe connectivity constraints MAY violate this directive but, if + so, MUST explicitly warn the user that an unvalidated response has + been provided. The warning MUST be provided on each unvalidated + access, and SHOULD require explicit user confirmation. + + proxy-revalidate + The proxy-revalidate directive has the same meaning as the must- + revalidate directive, except that it does not apply to non-shared + user agent caches. It can be used on a response to an + authenticated request to permit the user's cache to store and + later return the response without needing to revalidate it (since + it has already been authenticated once by that user), while still + requiring proxies that service many users to revalidate each time + (in order to make sure that each user has been authenticated). + Note that such authenticated responses also need the public cache + control directive in order to allow them to be cached at all. + +14.9.5 No-Transform Directive + + no-transform + Implementors of intermediate caches (proxies) have found it useful + to convert the media type of certain entity bodies. A non- + transparent proxy might, for example, convert between image + formats in order to save cache space or to reduce the amount of + traffic on a slow link. + + Serious operational problems occur, however, when these + transformations are applied to entity bodies intended for certain + kinds of applications. For example, applications for medical + + + +Fielding, et al. Standards Track [Page 115] + +RFC 2616 HTTP/1.1 June 1999 + + + imaging, scientific data analysis and those using end-to-end + authentication, all depend on receiving an entity body that is bit + for bit identical to the original entity-body. + + Therefore, if a message includes the no-transform directive, an + intermediate cache or proxy MUST NOT change those headers that are + listed in section 13.5.2 as being subject to the no-transform + directive. This implies that the cache or proxy MUST NOT change + any aspect of the entity-body that is specified by these headers, + including the value of the entity-body itself. + +14.9.6 Cache Control Extensions + + The Cache-Control header field can be extended through the use of one + or more cache-extension tokens, each with an optional assigned value. + Informational extensions (those which do not require a change in + cache behavior) MAY be added without changing the semantics of other + directives. Behavioral extensions are designed to work by acting as + modifiers to the existing base of cache directives. Both the new + directive and the standard directive are supplied, such that + applications which do not understand the new directive will default + to the behavior specified by the standard directive, and those that + understand the new directive will recognize it as modifying the + requirements associated with the standard directive. In this way, + extensions to the cache-control directives can be made without + requiring changes to the base protocol. + + This extension mechanism depends on an HTTP cache obeying all of the + cache-control directives defined for its native HTTP-version, obeying + certain extensions, and ignoring all directives that it does not + understand. + + For example, consider a hypothetical new response directive called + community which acts as a modifier to the private directive. We + define this new directive to mean that, in addition to any non-shared + cache, any cache which is shared only by members of the community + named within its value may cache the response. An origin server + wishing to allow the UCI community to use an otherwise private + response in their shared cache(s) could do so by including + + Cache-Control: private, community="UCI" + + A cache seeing this header field will act correctly even if the cache + does not understand the community cache-extension, since it will also + see and understand the private directive and thus default to the safe + behavior. + + + + + +Fielding, et al. Standards Track [Page 116] + +RFC 2616 HTTP/1.1 June 1999 + + + Unrecognized cache-directives MUST be ignored; it is assumed that any + cache-directive likely to be unrecognized by an HTTP/1.1 cache will + be combined with standard directives (or the response's default + cacheability) such that the cache behavior will remain minimally + correct even if the cache does not understand the extension(s). + +14.10 Connection + + The Connection general-header field allows the sender to specify + options that are desired for that particular connection and MUST NOT + be communicated by proxies over further connections. + + The Connection header has the following grammar: + + Connection = "Connection" ":" 1#(connection-token) + connection-token = token + + HTTP/1.1 proxies MUST parse the Connection header field before a + message is forwarded and, for each connection-token in this field, + remove any header field(s) from the message with the same name as the + connection-token. Connection options are signaled by the presence of + a connection-token in the Connection header field, not by any + corresponding additional header field(s), since the additional header + field may not be sent if there are no parameters associated with that + connection option. + + Message headers listed in the Connection header MUST NOT include + end-to-end headers, such as Cache-Control. + + HTTP/1.1 defines the "close" connection option for the sender to + signal that the connection will be closed after completion of the + response. For example, + + Connection: close + + in either the request or the response header fields indicates that + the connection SHOULD NOT be considered `persistent' (section 8.1) + after the current request/response is complete. + + HTTP/1.1 applications that do not support persistent connections MUST + include the "close" connection option in every message. + + A system receiving an HTTP/1.0 (or lower-version) message that + includes a Connection header MUST, for each connection-token in this + field, remove and ignore any header field(s) from the message with + the same name as the connection-token. This protects against mistaken + forwarding of such header fields by pre-HTTP/1.1 proxies. See section + 19.6.2. + + + +Fielding, et al. Standards Track [Page 117] + +RFC 2616 HTTP/1.1 June 1999 + + +14.11 Content-Encoding + + The Content-Encoding entity-header field is used as a modifier to the + media-type. When present, its value indicates what additional content + codings have been applied to the entity-body, and thus what decoding + mechanisms must be applied in order to obtain the media-type + referenced by the Content-Type header field. Content-Encoding is + primarily used to allow a document to be compressed without losing + the identity of its underlying media type. + + Content-Encoding = "Content-Encoding" ":" 1#content-coding + + Content codings are defined in section 3.5. An example of its use is + + Content-Encoding: gzip + + The content-coding is a characteristic of the entity identified by + the Request-URI. Typically, the entity-body is stored with this + encoding and is only decoded before rendering or analogous usage. + However, a non-transparent proxy MAY modify the content-coding if the + new coding is known to be acceptable to the recipient, unless the + "no-transform" cache-control directive is present in the message. + + If the content-coding of an entity is not "identity", then the + response MUST include a Content-Encoding entity-header (section + 14.11) that lists the non-identity content-coding(s) used. + + If the content-coding of an entity in a request message is not + acceptable to the origin server, the server SHOULD respond with a + status code of 415 (Unsupported Media Type). + + If multiple encodings have been applied to an entity, the content + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + +14.12 Content-Language + + The Content-Language entity-header field describes the natural + language(s) of the intended audience for the enclosed entity. Note + that this might not be equivalent to all the languages used within + the entity-body. + + Content-Language = "Content-Language" ":" 1#language-tag + + + + + + + +Fielding, et al. Standards Track [Page 118] + +RFC 2616 HTTP/1.1 June 1999 + + + Language tags are defined in section 3.10. The primary purpose of + Content-Language is to allow a user to identify and differentiate + entities according to the user's own preferred language. Thus, if the + body content is intended only for a Danish-literate audience, the + appropriate field is + + Content-Language: da + + If no Content-Language is specified, the default is that the content + is intended for all language audiences. This might mean that the + sender does not consider it to be specific to any natural language, + or that the sender does not know for which language it is intended. + + Multiple languages MAY be listed for content that is intended for + multiple audiences. For example, a rendition of the "Treaty of + Waitangi," presented simultaneously in the original Maori and English + versions, would call for + + Content-Language: mi, en + + However, just because multiple languages are present within an entity + does not mean that it is intended for multiple linguistic audiences. + An example would be a beginner's language primer, such as "A First + Lesson in Latin," which is clearly intended to be used by an + English-literate audience. In this case, the Content-Language would + properly only include "en". + + Content-Language MAY be applied to any media type -- it is not + limited to textual documents. + +14.13 Content-Length + + The Content-Length entity-header field indicates the size of the + entity-body, in decimal number of OCTETs, sent to the recipient or, + in the case of the HEAD method, the size of the entity-body that + would have been sent had the request been a GET. + + Content-Length = "Content-Length" ":" 1*DIGIT + + An example is + + Content-Length: 3495 + + Applications SHOULD use this field to indicate the transfer-length of + the message-body, unless this is prohibited by the rules in section + 4.4. + + + + + +Fielding, et al. Standards Track [Page 119] + +RFC 2616 HTTP/1.1 June 1999 + + + Any Content-Length greater than or equal to zero is a valid value. + Section 4.4 describes how to determine the length of a message-body + if a Content-Length is not given. + + Note that the meaning of this field is significantly different from + the corresponding definition in MIME, where it is an optional field + used within the "message/external-body" content-type. In HTTP, it + SHOULD be sent whenever the message's length can be determined prior + to being transferred, unless this is prohibited by the rules in + section 4.4. + +14.14 Content-Location + + The Content-Location entity-header field MAY be used to supply the + resource location for the entity enclosed in the message when that + entity is accessible from a location separate from the requested + resource's URI. A server SHOULD provide a Content-Location for the + variant corresponding to the response entity; especially in the case + where a resource has multiple entities associated with it, and those + entities actually have separate locations by which they might be + individually accessed, the server SHOULD provide a Content-Location + for the particular variant which is returned. + + Content-Location = "Content-Location" ":" + ( absoluteURI | relativeURI ) + + The value of Content-Location also defines the base URI for the + entity. + + The Content-Location value is not a replacement for the original + requested URI; it is only a statement of the location of the resource + corresponding to this particular entity at the time of the request. + Future requests MAY specify the Content-Location URI as the request- + URI if the desire is to identify the source of that particular + entity. + + A cache cannot assume that an entity with a Content-Location + different from the URI used to retrieve it can be used to respond to + later requests on that Content-Location URI. However, the Content- + Location can be used to differentiate between multiple entities + retrieved from a single requested resource, as described in section + 13.6. + + If the Content-Location is a relative URI, the relative URI is + interpreted relative to the Request-URI. + + The meaning of the Content-Location header in PUT or POST requests is + undefined; servers are free to ignore it in those cases. + + + +Fielding, et al. Standards Track [Page 120] + +RFC 2616 HTTP/1.1 June 1999 + + +14.15 Content-MD5 + + The Content-MD5 entity-header field, as defined in RFC 1864 [23], is + an MD5 digest of the entity-body for the purpose of providing an + end-to-end message integrity check (MIC) of the entity-body. (Note: a + MIC is good for detecting accidental modification of the entity-body + in transit, but is not proof against malicious attacks.) + + Content-MD5 = "Content-MD5" ":" md5-digest + md5-digest = + + The Content-MD5 header field MAY be generated by an origin server or + client to function as an integrity check of the entity-body. Only + origin servers or clients MAY generate the Content-MD5 header field; + proxies and gateways MUST NOT generate it, as this would defeat its + value as an end-to-end integrity check. Any recipient of the entity- + body, including gateways and proxies, MAY check that the digest value + in this header field matches that of the entity-body as received. + + The MD5 digest is computed based on the content of the entity-body, + including any content-coding that has been applied, but not including + any transfer-encoding applied to the message-body. If the message is + received with a transfer-encoding, that encoding MUST be removed + prior to checking the Content-MD5 value against the received entity. + + This has the result that the digest is computed on the octets of the + entity-body exactly as, and in the order that, they would be sent if + no transfer-encoding were being applied. + + HTTP extends RFC 1864 to permit the digest to be computed for MIME + composite media-types (e.g., multipart/* and message/rfc822), but + this does not change how the digest is computed as defined in the + preceding paragraph. + + There are several consequences of this. The entity-body for composite + types MAY contain many body-parts, each with its own MIME and HTTP + headers (including Content-MD5, Content-Transfer-Encoding, and + Content-Encoding headers). If a body-part has a Content-Transfer- + Encoding or Content-Encoding header, it is assumed that the content + of the body-part has had the encoding applied, and the body-part is + included in the Content-MD5 digest as is -- i.e., after the + application. The Transfer-Encoding header field is not allowed within + body-parts. + + Conversion of all line breaks to CRLF MUST NOT be done before + computing or checking the digest: the line break convention used in + the text actually transmitted MUST be left unaltered when computing + the digest. + + + +Fielding, et al. Standards Track [Page 121] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: while the definition of Content-MD5 is exactly the same for + HTTP as in RFC 1864 for MIME entity-bodies, there are several ways + in which the application of Content-MD5 to HTTP entity-bodies + differs from its application to MIME entity-bodies. One is that + HTTP, unlike MIME, does not use Content-Transfer-Encoding, and + does use Transfer-Encoding and Content-Encoding. Another is that + HTTP more frequently uses binary content types than MIME, so it is + worth noting that, in such cases, the byte order used to compute + the digest is the transmission byte order defined for the type. + Lastly, HTTP allows transmission of text types with any of several + line break conventions and not just the canonical form using CRLF. + +14.16 Content-Range + + The Content-Range entity-header is sent with a partial entity-body to + specify where in the full entity-body the partial body should be + applied. Range units are defined in section 3.12. + + Content-Range = "Content-Range" ":" content-range-spec + + content-range-spec = byte-content-range-spec + byte-content-range-spec = bytes-unit SP + byte-range-resp-spec "/" + ( instance-length | "*" ) + + byte-range-resp-spec = (first-byte-pos "-" last-byte-pos) + | "*" + instance-length = 1*DIGIT + + The header SHOULD indicate the total length of the full entity-body, + unless this length is unknown or difficult to determine. The asterisk + "*" character means that the instance-length is unknown at the time + when the response was generated. + + Unlike byte-ranges-specifier values (see section 14.35.1), a byte- + range-resp-spec MUST only specify one range, and MUST contain + absolute byte positions for both the first and last byte of the + range. + + A byte-content-range-spec with a byte-range-resp-spec whose last- + byte-pos value is less than its first-byte-pos value, or whose + instance-length value is less than or equal to its last-byte-pos + value, is invalid. The recipient of an invalid byte-content-range- + spec MUST ignore it and any content transferred along with it. + + A server sending a response with status code 416 (Requested range not + satisfiable) SHOULD include a Content-Range field with a byte-range- + resp-spec of "*". The instance-length specifies the current length of + + + +Fielding, et al. Standards Track [Page 122] + +RFC 2616 HTTP/1.1 June 1999 + + + the selected resource. A response with status code 206 (Partial + Content) MUST NOT include a Content-Range field with a byte-range- + resp-spec of "*". + + Examples of byte-content-range-spec values, assuming that the entity + contains a total of 1234 bytes: + + . The first 500 bytes: + bytes 0-499/1234 + + . The second 500 bytes: + bytes 500-999/1234 + + . All except for the first 500 bytes: + bytes 500-1233/1234 + + . The last 500 bytes: + bytes 734-1233/1234 + + When an HTTP message includes the content of a single range (for + example, a response to a request for a single range, or to a request + for a set of ranges that overlap without any holes), this content is + transmitted with a Content-Range header, and a Content-Length header + showing the number of bytes actually transferred. For example, + + HTTP/1.1 206 Partial content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-Range: bytes 21010-47021/47022 + Content-Length: 26012 + Content-Type: image/gif + + When an HTTP message includes the content of multiple ranges (for + example, a response to a request for multiple non-overlapping + ranges), these are transmitted as a multipart message. The multipart + media type used for this purpose is "multipart/byteranges" as defined + in appendix 19.2. See appendix 19.6.3 for a compatibility issue. + + A response to a request for a single range MUST NOT be sent using the + multipart/byteranges media type. A response to a request for + multiple ranges, whose result is a single range, MAY be sent as a + multipart/byteranges media type with one part. A client that cannot + decode a multipart/byteranges message MUST NOT ask for multiple + byte-ranges in a single request. + + When a client requests multiple byte-ranges in one request, the + server SHOULD return them in the order that they appeared in the + request. + + + +Fielding, et al. Standards Track [Page 123] + +RFC 2616 HTTP/1.1 June 1999 + + + If the server ignores a byte-range-spec because it is syntactically + invalid, the server SHOULD treat the request as if the invalid Range + header field did not exist. (Normally, this means return a 200 + response containing the full entity). + + If the server receives a request (other than one including an If- + Range request-header field) with an unsatisfiable Range request- + header field (that is, all of whose byte-range-spec values have a + first-byte-pos value greater than the current length of the selected + resource), it SHOULD return a response code of 416 (Requested range + not satisfiable) (section 10.4.17). + + Note: clients cannot depend on servers to send a 416 (Requested + range not satisfiable) response instead of a 200 (OK) response for + an unsatisfiable Range request-header, since not all servers + implement this request-header. + +14.17 Content-Type + + The Content-Type entity-header field indicates the media type of the + entity-body sent to the recipient or, in the case of the HEAD method, + the media type that would have been sent had the request been a GET. + + Content-Type = "Content-Type" ":" media-type + + Media types are defined in section 3.7. An example of the field is + + Content-Type: text/html; charset=ISO-8859-4 + + Further discussion of methods for identifying the media type of an + entity is provided in section 7.2.1. + +14.18 Date + + The Date general-header field represents the date and time at which + the message was originated, having the same semantics as orig-date in + RFC 822. The field value is an HTTP-date, as described in section + 3.3.1; it MUST be sent in RFC 1123 [8]-date format. + + Date = "Date" ":" HTTP-date + + An example is + + Date: Tue, 15 Nov 1994 08:12:31 GMT + + Origin servers MUST include a Date header field in all responses, + except in these cases: + + + + +Fielding, et al. Standards Track [Page 124] + +RFC 2616 HTTP/1.1 June 1999 + + + 1. If the response status code is 100 (Continue) or 101 (Switching + Protocols), the response MAY include a Date header field, at + the server's option. + + 2. If the response status code conveys a server error, e.g. 500 + (Internal Server Error) or 503 (Service Unavailable), and it is + inconvenient or impossible to generate a valid Date. + + 3. If the server does not have a clock that can provide a + reasonable approximation of the current time, its responses + MUST NOT include a Date header field. In this case, the rules + in section 14.18.1 MUST be followed. + + A received message that does not have a Date header field MUST be + assigned one by the recipient if the message will be cached by that + recipient or gatewayed via a protocol which requires a Date. An HTTP + implementation without a clock MUST NOT cache responses without + revalidating them on every use. An HTTP cache, especially a shared + cache, SHOULD use a mechanism, such as NTP [28], to synchronize its + clock with a reliable external standard. + + Clients SHOULD only send a Date header field in messages that include + an entity-body, as in the case of the PUT and POST requests, and even + then it is optional. A client without a clock MUST NOT send a Date + header field in a request. + + The HTTP-date sent in a Date header SHOULD NOT represent a date and + time subsequent to the generation of the message. It SHOULD represent + the best available approximation of the date and time of message + generation, unless the implementation has no means of generating a + reasonably accurate date and time. In theory, the date ought to + represent the moment just before the entity is generated. In + practice, the date can be generated at any time during the message + origination without affecting its semantic value. + +14.18.1 Clockless Origin Server Operation + + Some origin server implementations might not have a clock available. + An origin server without a clock MUST NOT assign Expires or Last- + Modified values to a response, unless these values were associated + with the resource by a system or user with a reliable clock. It MAY + assign an Expires value that is known, at or before server + configuration time, to be in the past (this allows "pre-expiration" + of responses without storing separate Expires values for each + resource). + + + + + + +Fielding, et al. Standards Track [Page 125] + +RFC 2616 HTTP/1.1 June 1999 + + +14.19 ETag + + The ETag response-header field provides the current value of the + entity tag for the requested variant. The headers used with entity + tags are described in sections 14.24, 14.26 and 14.44. The entity tag + MAY be used for comparison with other entities from the same resource + (see section 13.3.3). + + ETag = "ETag" ":" entity-tag + + Examples: + + ETag: "xyzzy" + ETag: W/"xyzzy" + ETag: "" + +14.20 Expect + + The Expect request-header field is used to indicate that particular + server behaviors are required by the client. + + Expect = "Expect" ":" 1#expectation + + expectation = "100-continue" | expectation-extension + expectation-extension = token [ "=" ( token | quoted-string ) + *expect-params ] + expect-params = ";" token [ "=" ( token | quoted-string ) ] + + + A server that does not understand or is unable to comply with any of + the expectation values in the Expect field of a request MUST respond + with appropriate error status. The server MUST respond with a 417 + (Expectation Failed) status if any of the expectations cannot be met + or, if there are other problems with the request, some other 4xx + status. + + This header field is defined with extensible syntax to allow for + future extensions. If a server receives a request containing an + Expect field that includes an expectation-extension that it does not + support, it MUST respond with a 417 (Expectation Failed) status. + + Comparison of expectation values is case-insensitive for unquoted + tokens (including the 100-continue token), and is case-sensitive for + quoted-string expectation-extensions. + + + + + + + +Fielding, et al. Standards Track [Page 126] + +RFC 2616 HTTP/1.1 June 1999 + + + The Expect mechanism is hop-by-hop: that is, an HTTP/1.1 proxy MUST + return a 417 (Expectation Failed) status if it receives a request + with an expectation that it cannot meet. However, the Expect + request-header itself is end-to-end; it MUST be forwarded if the + request is forwarded. + + Many older HTTP/1.0 and HTTP/1.1 applications do not understand the + Expect header. + + See section 8.2.3 for the use of the 100 (continue) status. + +14.21 Expires + + The Expires entity-header field gives the date/time after which the + response is considered stale. A stale cache entry may not normally be + returned by a cache (either a proxy cache or a user agent cache) + unless it is first validated with the origin server (or with an + intermediate cache that has a fresh copy of the entity). See section + 13.2 for further discussion of the expiration model. + + The presence of an Expires field does not imply that the original + resource will change or cease to exist at, before, or after that + time. + + The format is an absolute date and time as defined by HTTP-date in + section 3.3.1; it MUST be in RFC 1123 date format: + + Expires = "Expires" ":" HTTP-date + + An example of its use is + + Expires: Thu, 01 Dec 1994 16:00:00 GMT + + Note: if a response includes a Cache-Control field with the max- + age directive (see section 14.9.3), that directive overrides the + Expires field. + + HTTP/1.1 clients and caches MUST treat other invalid date formats, + especially including the value "0", as in the past (i.e., "already + expired"). + + To mark a response as "already expired," an origin server sends an + Expires date that is equal to the Date header value. (See the rules + for expiration calculations in section 13.2.4.) + + + + + + + +Fielding, et al. Standards Track [Page 127] + +RFC 2616 HTTP/1.1 June 1999 + + + To mark a response as "never expires," an origin server sends an + Expires date approximately one year from the time the response is + sent. HTTP/1.1 servers SHOULD NOT send Expires dates more than one + year in the future. + + The presence of an Expires header field with a date value of some + time in the future on a response that otherwise would by default be + non-cacheable indicates that the response is cacheable, unless + indicated otherwise by a Cache-Control header field (section 14.9). + +14.22 From + + The From request-header field, if given, SHOULD contain an Internet + e-mail address for the human user who controls the requesting user + agent. The address SHOULD be machine-usable, as defined by "mailbox" + in RFC 822 [9] as updated by RFC 1123 [8]: + + From = "From" ":" mailbox + + An example is: + + From: webmaster@w3.org + + This header field MAY be used for logging purposes and as a means for + identifying the source of invalid or unwanted requests. It SHOULD NOT + be used as an insecure form of access protection. The interpretation + of this field is that the request is being performed on behalf of the + person given, who accepts responsibility for the method performed. In + particular, robot agents SHOULD include this header so that the + person responsible for running the robot can be contacted if problems + occur on the receiving end. + + The Internet e-mail address in this field MAY be separate from the + Internet host which issued the request. For example, when a request + is passed through a proxy the original issuer's address SHOULD be + used. + + The client SHOULD NOT send the From header field without the user's + approval, as it might conflict with the user's privacy interests or + their site's security policy. It is strongly recommended that the + user be able to disable, enable, and modify the value of this field + at any time prior to a request. + +14.23 Host + + The Host request-header field specifies the Internet host and port + number of the resource being requested, as obtained from the original + URI given by the user or referring resource (generally an HTTP URL, + + + +Fielding, et al. Standards Track [Page 128] + +RFC 2616 HTTP/1.1 June 1999 + + + as described in section 3.2.2). The Host field value MUST represent + the naming authority of the origin server or gateway given by the + original URL. This allows the origin server or gateway to + differentiate between internally-ambiguous URLs, such as the root "/" + URL of a server for multiple host names on a single IP address. + + Host = "Host" ":" host [ ":" port ] ; Section 3.2.2 + + A "host" without any trailing port information implies the default + port for the service requested (e.g., "80" for an HTTP URL). For + example, a request on the origin server for + would properly include: + + GET /pub/WWW/ HTTP/1.1 + Host: www.w3.org + + A client MUST include a Host header field in all HTTP/1.1 request + messages . If the requested URI does not include an Internet host + name for the service being requested, then the Host header field MUST + be given with an empty value. An HTTP/1.1 proxy MUST ensure that any + request message it forwards does contain an appropriate Host header + field that identifies the service being requested by the proxy. All + Internet-based HTTP/1.1 servers MUST respond with a 400 (Bad Request) + status code to any HTTP/1.1 request message which lacks a Host header + field. + + See sections 5.2 and 19.6.1.1 for other requirements relating to + Host. + +14.24 If-Match + + The If-Match request-header field is used with a method to make it + conditional. A client that has one or more entities previously + obtained from the resource can verify that one of those entities is + current by including a list of their associated entity tags in the + If-Match header field. Entity tags are defined in section 3.11. The + purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. It is also + used, on updating requests, to prevent inadvertent modification of + the wrong version of a resource. As a special case, the value "*" + matches any current entity of the resource. + + If-Match = "If-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-Match header) on that resource, or if "*" is given + + + + +Fielding, et al. Standards Track [Page 129] + +RFC 2616 HTTP/1.1 June 1999 + + + and any current entity exists for that resource, then the server MAY + perform the requested method as if the If-Match header field did not + exist. + + A server MUST use the strong comparison function (see section 13.3.3) + to compare the entity tags in If-Match. + + If none of the entity tags match, or if "*" is given and no current + entity exists, the server MUST NOT perform the requested method, and + MUST return a 412 (Precondition Failed) response. This behavior is + most useful when the client wants to prevent an updating method, such + as PUT, from modifying a resource that has changed since the client + last retrieved it. + + If the request would, without the If-Match header field, result in + anything other than a 2xx or 412 status, then the If-Match header + MUST be ignored. + + The meaning of "If-Match: *" is that the method SHOULD be performed + if the representation selected by the origin server (or by a cache, + possibly using the Vary mechanism, see section 14.44) exists, and + MUST NOT be performed if the representation does not exist. + + A request intended to update a resource (e.g., a PUT) MAY include an + If-Match header field to signal that the request method MUST NOT be + applied if the entity corresponding to the If-Match value (a single + entity tag) is no longer a representation of that resource. This + allows the user to indicate that they do not wish the request to be + successful if the resource has been changed without their knowledge. + Examples: + + If-Match: "xyzzy" + If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-Match: * + + The result of a request having both an If-Match header field and + either an If-None-Match or an If-Modified-Since header fields is + undefined by this specification. + +14.25 If-Modified-Since + + The If-Modified-Since request-header field is used with a method to + make it conditional: if the requested variant has not been modified + since the time specified in this field, an entity will not be + returned from the server; instead, a 304 (not modified) response will + be returned without any message-body. + + If-Modified-Since = "If-Modified-Since" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 130] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of the field is: + + If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + A GET method with an If-Modified-Since header and no Range header + requests that the identified entity be transferred only if it has + been modified since the date given by the If-Modified-Since header. + The algorithm for determining this includes the following cases: + + a) If the request would normally result in anything other than a + 200 (OK) status, or if the passed If-Modified-Since date is + invalid, the response is exactly the same as for a normal GET. + A date which is later than the server's current time is + invalid. + + b) If the variant has been modified since the If-Modified-Since + date, the response is exactly the same as for a normal GET. + + c) If the variant has not been modified since a valid If- + Modified-Since date, the server SHOULD return a 304 (Not + Modified) response. + + The purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. + + Note: The Range request-header field modifies the meaning of If- + Modified-Since; see section 14.35 for full details. + + Note: If-Modified-Since times are interpreted by the server, whose + clock might not be synchronized with the client. + + Note: When handling an If-Modified-Since header field, some + servers will use an exact date comparison function, rather than a + less-than function, for deciding whether to send a 304 (Not + Modified) response. To get best results when sending an If- + Modified-Since header field for cache validation, clients are + advised to use the exact date string received in a previous Last- + Modified header field whenever possible. + + Note: If a client uses an arbitrary date in the If-Modified-Since + header instead of a date taken from the Last-Modified header for + the same request, the client should be aware of the fact that this + date is interpreted in the server's understanding of time. The + client should consider unsynchronized clocks and rounding problems + due to the different encodings of time between the client and + server. This includes the possibility of race conditions if the + document has changed between the time it was first requested and + the If-Modified-Since date of a subsequent request, and the + + + +Fielding, et al. Standards Track [Page 131] + +RFC 2616 HTTP/1.1 June 1999 + + + possibility of clock-skew-related problems if the If-Modified- + Since date is derived from the client's clock without correction + to the server's clock. Corrections for different time bases + between client and server are at best approximate due to network + latency. + + The result of a request having both an If-Modified-Since header field + and either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.26 If-None-Match + + The If-None-Match request-header field is used with a method to make + it conditional. A client that has one or more entities previously + obtained from the resource can verify that none of those entities is + current by including a list of their associated entity tags in the + If-None-Match header field. The purpose of this feature is to allow + efficient updates of cached information with a minimum amount of + transaction overhead. It is also used to prevent a method (e.g. PUT) + from inadvertently modifying an existing resource when the client + believes that the resource does not exist. + + As a special case, the value "*" matches any current entity of the + resource. + + If-None-Match = "If-None-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-None-Match header) on that resource, or if "*" is + given and any current entity exists for that resource, then the + server MUST NOT perform the requested method, unless required to do + so because the resource's modification date fails to match that + supplied in an If-Modified-Since header field in the request. + Instead, if the request method was GET or HEAD, the server SHOULD + respond with a 304 (Not Modified) response, including the cache- + related header fields (particularly ETag) of one of the entities that + matched. For all other request methods, the server MUST respond with + a status of 412 (Precondition Failed). + + See section 13.3.3 for rules on how to determine if two entities tags + match. The weak comparison function can only be used with GET or HEAD + requests. + + + + + + + + +Fielding, et al. Standards Track [Page 132] + +RFC 2616 HTTP/1.1 June 1999 + + + If none of the entity tags match, then the server MAY perform the + requested method as if the If-None-Match header field did not exist, + but MUST also ignore any If-Modified-Since header field(s) in the + request. That is, if no entity tags match, then the server MUST NOT + return a 304 (Not Modified) response. + + If the request would, without the If-None-Match header field, result + in anything other than a 2xx or 304 status, then the If-None-Match + header MUST be ignored. (See section 13.3.4 for a discussion of + server behavior when both If-Modified-Since and If-None-Match appear + in the same request.) + + The meaning of "If-None-Match: *" is that the method MUST NOT be + performed if the representation selected by the origin server (or by + a cache, possibly using the Vary mechanism, see section 14.44) + exists, and SHOULD be performed if the representation does not exist. + This feature is intended to be useful in preventing races between PUT + operations. + + Examples: + + If-None-Match: "xyzzy" + If-None-Match: W/"xyzzy" + If-None-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-None-Match: W/"xyzzy", W/"r2d2xxxx", W/"c3piozzzz" + If-None-Match: * + + The result of a request having both an If-None-Match header field and + either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.27 If-Range + + If a client has a partial copy of an entity in its cache, and wishes + to have an up-to-date copy of the entire entity in its cache, it + could use the Range request-header with a conditional GET (using + either or both of If-Unmodified-Since and If-Match.) However, if the + condition fails because the entity has been modified, the client + would then have to make a second request to obtain the entire current + entity-body. + + The If-Range header allows a client to "short-circuit" the second + request. Informally, its meaning is `if the entity is unchanged, send + me the part(s) that I am missing; otherwise, send me the entire new + entity'. + + If-Range = "If-Range" ":" ( entity-tag | HTTP-date ) + + + + +Fielding, et al. Standards Track [Page 133] + +RFC 2616 HTTP/1.1 June 1999 + + + If the client has no entity tag for an entity, but does have a Last- + Modified date, it MAY use that date in an If-Range header. (The + server can distinguish between a valid HTTP-date and any form of + entity-tag by examining no more than two characters.) The If-Range + header SHOULD only be used together with a Range header, and MUST be + ignored if the request does not include a Range header, or if the + server does not support the sub-range operation. + + If the entity tag given in the If-Range header matches the current + entity tag for the entity, then the server SHOULD provide the + specified sub-range of the entity using a 206 (Partial content) + response. If the entity tag does not match, then the server SHOULD + return the entire entity using a 200 (OK) response. + +14.28 If-Unmodified-Since + + The If-Unmodified-Since request-header field is used with a method to + make it conditional. If the requested resource has not been modified + since the time specified in this field, the server SHOULD perform the + requested operation as if the If-Unmodified-Since header were not + present. + + If the requested variant has been modified since the specified time, + the server MUST NOT perform the requested operation, and MUST return + a 412 (Precondition Failed). + + If-Unmodified-Since = "If-Unmodified-Since" ":" HTTP-date + + An example of the field is: + + If-Unmodified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + If the request normally (i.e., without the If-Unmodified-Since + header) would result in anything other than a 2xx or 412 status, the + If-Unmodified-Since header SHOULD be ignored. + + If the specified date is invalid, the header is ignored. + + The result of a request having both an If-Unmodified-Since header + field and either an If-None-Match or an If-Modified-Since header + fields is undefined by this specification. + +14.29 Last-Modified + + The Last-Modified entity-header field indicates the date and time at + which the origin server believes the variant was last modified. + + Last-Modified = "Last-Modified" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 134] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of its use is + + Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT + + The exact meaning of this header field depends on the implementation + of the origin server and the nature of the original resource. For + files, it may be just the file system last-modified time. For + entities with dynamically included parts, it may be the most recent + of the set of last-modify times for its component parts. For database + gateways, it may be the last-update time stamp of the record. For + virtual objects, it may be the last time the internal state changed. + + An origin server MUST NOT send a Last-Modified date which is later + than the server's time of message origination. In such cases, where + the resource's last modification would indicate some time in the + future, the server MUST replace that date with the message + origination date. + + An origin server SHOULD obtain the Last-Modified value of the entity + as close as possible to the time that it generates the Date value of + its response. This allows a recipient to make an accurate assessment + of the entity's modification time, especially if the entity changes + near the time that the response is generated. + + HTTP/1.1 servers SHOULD send Last-Modified whenever feasible. + +14.30 Location + + The Location response-header field is used to redirect the recipient + to a location other than the Request-URI for completion of the + request or identification of a new resource. For 201 (Created) + responses, the Location is that of the new resource which was created + by the request. For 3xx responses, the location SHOULD indicate the + server's preferred URI for automatic redirection to the resource. The + field value consists of a single absolute URI. + + Location = "Location" ":" absoluteURI + + An example is: + + Location: http://www.w3.org/pub/WWW/People.html + + Note: The Content-Location header field (section 14.14) differs + from Location in that the Content-Location identifies the original + location of the entity enclosed in the request. It is therefore + possible for a response to contain header fields for both Location + and Content-Location. Also see section 13.10 for cache + requirements of some methods. + + + +Fielding, et al. Standards Track [Page 135] + +RFC 2616 HTTP/1.1 June 1999 + + +14.31 Max-Forwards + + The Max-Forwards request-header field provides a mechanism with the + TRACE (section 9.8) and OPTIONS (section 9.2) methods to limit the + number of proxies or gateways that can forward the request to the + next inbound server. This can be useful when the client is attempting + to trace a request chain which appears to be failing or looping in + mid-chain. + + Max-Forwards = "Max-Forwards" ":" 1*DIGIT + + The Max-Forwards value is a decimal integer indicating the remaining + number of times this request message may be forwarded. + + Each proxy or gateway recipient of a TRACE or OPTIONS request + containing a Max-Forwards header field MUST check and update its + value prior to forwarding the request. If the received value is zero + (0), the recipient MUST NOT forward the request; instead, it MUST + respond as the final recipient. If the received Max-Forwards value is + greater than zero, then the forwarded message MUST contain an updated + Max-Forwards field with a value decremented by one (1). + + The Max-Forwards header field MAY be ignored for all other methods + defined by this specification and for any extension methods for which + it is not explicitly referred to as part of that method definition. + +14.32 Pragma + + The Pragma general-header field is used to include implementation- + specific directives that might apply to any recipient along the + request/response chain. All pragma directives specify optional + behavior from the viewpoint of the protocol; however, some systems + MAY require that behavior be consistent with the directives. + + Pragma = "Pragma" ":" 1#pragma-directive + pragma-directive = "no-cache" | extension-pragma + extension-pragma = token [ "=" ( token | quoted-string ) ] + + When the no-cache directive is present in a request message, an + application SHOULD forward the request toward the origin server even + if it has a cached copy of what is being requested. This pragma + directive has the same semantics as the no-cache cache-directive (see + section 14.9) and is defined here for backward compatibility with + HTTP/1.0. Clients SHOULD include both header fields when a no-cache + request is sent to a server not known to be HTTP/1.1 compliant. + + + + + + +Fielding, et al. Standards Track [Page 136] + +RFC 2616 HTTP/1.1 June 1999 + + + Pragma directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a pragma for a + specific recipient; however, any pragma directive not relevant to a + recipient SHOULD be ignored by that recipient. + + HTTP/1.1 caches SHOULD treat "Pragma: no-cache" as if the client had + sent "Cache-Control: no-cache". No new Pragma directives will be + defined in HTTP. + + Note: because the meaning of "Pragma: no-cache as a response + header field is not actually specified, it does not provide a + reliable replacement for "Cache-Control: no-cache" in a response + +14.33 Proxy-Authenticate + + The Proxy-Authenticate response-header field MUST be included as part + of a 407 (Proxy Authentication Required) response. The field value + consists of a challenge that indicates the authentication scheme and + parameters applicable to the proxy for this Request-URI. + + Proxy-Authenticate = "Proxy-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. Unlike + WWW-Authenticate, the Proxy-Authenticate header field applies only to + the current connection and SHOULD NOT be passed on to downstream + clients. However, an intermediate proxy might need to obtain its own + credentials by requesting them from the downstream client, which in + some circumstances will appear as if the proxy is forwarding the + Proxy-Authenticate header field. + +14.34 Proxy-Authorization + + The Proxy-Authorization request-header field allows the client to + identify itself (or its user) to a proxy which requires + authentication. The Proxy-Authorization field value consists of + credentials containing the authentication information of the user + agent for the proxy and/or realm of the resource being requested. + + Proxy-Authorization = "Proxy-Authorization" ":" credentials + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43] . Unlike + Authorization, the Proxy-Authorization header field applies only to + the next outbound proxy that demanded authentication using the Proxy- + Authenticate field. When multiple proxies are used in a chain, the + + + +Fielding, et al. Standards Track [Page 137] + +RFC 2616 HTTP/1.1 June 1999 + + + Proxy-Authorization header field is consumed by the first outbound + proxy that was expecting to receive credentials. A proxy MAY relay + the credentials from the client request to the next proxy if that is + the mechanism by which the proxies cooperatively authenticate a given + request. + +14.35 Range + +14.35.1 Byte Ranges + + Since all HTTP entities are represented in HTTP messages as sequences + of bytes, the concept of a byte range is meaningful for any HTTP + entity. (However, not all clients and servers need to support byte- + range operations.) + + Byte range specifications in HTTP apply to the sequence of bytes in + the entity-body (not necessarily the same as the message-body). + + A byte range operation MAY specify a single range of bytes, or a set + of ranges within a single entity. + + ranges-specifier = byte-ranges-specifier + byte-ranges-specifier = bytes-unit "=" byte-range-set + byte-range-set = 1#( byte-range-spec | suffix-byte-range-spec ) + byte-range-spec = first-byte-pos "-" [last-byte-pos] + first-byte-pos = 1*DIGIT + last-byte-pos = 1*DIGIT + + The first-byte-pos value in a byte-range-spec gives the byte-offset + of the first byte in a range. The last-byte-pos value gives the + byte-offset of the last byte in the range; that is, the byte + positions specified are inclusive. Byte offsets start at zero. + + If the last-byte-pos value is present, it MUST be greater than or + equal to the first-byte-pos in that byte-range-spec, or the byte- + range-spec is syntactically invalid. The recipient of a byte-range- + set that includes one or more syntactically invalid byte-range-spec + values MUST ignore the header field that includes that byte-range- + set. + + If the last-byte-pos value is absent, or if the value is greater than + or equal to the current length of the entity-body, last-byte-pos is + taken to be equal to one less than the current length of the entity- + body in bytes. + + By its choice of last-byte-pos, a client can limit the number of + bytes retrieved without knowing the size of the entity. + + + + +Fielding, et al. Standards Track [Page 138] + +RFC 2616 HTTP/1.1 June 1999 + + + suffix-byte-range-spec = "-" suffix-length + suffix-length = 1*DIGIT + + A suffix-byte-range-spec is used to specify the suffix of the + entity-body, of a length given by the suffix-length value. (That is, + this form specifies the last N bytes of an entity-body.) If the + entity is shorter than the specified suffix-length, the entire + entity-body is used. + + If a syntactically valid byte-range-set includes at least one byte- + range-spec whose first-byte-pos is less than the current length of + the entity-body, or at least one suffix-byte-range-spec with a non- + zero suffix-length, then the byte-range-set is satisfiable. + Otherwise, the byte-range-set is unsatisfiable. If the byte-range-set + is unsatisfiable, the server SHOULD return a response with a status + of 416 (Requested range not satisfiable). Otherwise, the server + SHOULD return a response with a status of 206 (Partial Content) + containing the satisfiable ranges of the entity-body. + + Examples of byte-ranges-specifier values (assuming an entity-body of + length 10000): + + - The first 500 bytes (byte offsets 0-499, inclusive): bytes=0- + 499 + + - The second 500 bytes (byte offsets 500-999, inclusive): + bytes=500-999 + + - The final 500 bytes (byte offsets 9500-9999, inclusive): + bytes=-500 + + - Or bytes=9500- + + - The first and last bytes only (bytes 0 and 9999): bytes=0-0,-1 + + - Several legal but not canonical specifications of the second 500 + bytes (byte offsets 500-999, inclusive): + bytes=500-600,601-999 + bytes=500-700,601-999 + +14.35.2 Range Retrieval Requests + + HTTP retrieval requests using conditional or unconditional GET + methods MAY request one or more sub-ranges of the entity, instead of + the entire entity, using the Range request header, which applies to + the entity returned as the result of the request: + + Range = "Range" ":" ranges-specifier + + + +Fielding, et al. Standards Track [Page 139] + +RFC 2616 HTTP/1.1 June 1999 + + + A server MAY ignore the Range header. However, HTTP/1.1 origin + servers and intermediate caches ought to support byte ranges when + possible, since Range supports efficient recovery from partially + failed transfers, and supports efficient partial retrieval of large + entities. + + If the server supports the Range header and the specified range or + ranges are appropriate for the entity: + + - The presence of a Range header in an unconditional GET modifies + what is returned if the GET is otherwise successful. In other + words, the response carries a status code of 206 (Partial + Content) instead of 200 (OK). + + - The presence of a Range header in a conditional GET (a request + using one or both of If-Modified-Since and If-None-Match, or + one or both of If-Unmodified-Since and If-Match) modifies what + is returned if the GET is otherwise successful and the + condition is true. It does not affect the 304 (Not Modified) + response returned if the conditional is false. + + In some cases, it might be more appropriate to use the If-Range + header (see section 14.27) in addition to the Range header. + + If a proxy that supports ranges receives a Range request, forwards + the request to an inbound server, and receives an entire entity in + reply, it SHOULD only return the requested range to its client. It + SHOULD store the entire received response in its cache if that is + consistent with its cache allocation policies. + +14.36 Referer + + The Referer[sic] request-header field allows the client to specify, + for the server's benefit, the address (URI) of the resource from + which the Request-URI was obtained (the "referrer", although the + header field is misspelled.) The Referer request-header allows a + server to generate lists of back-links to resources for interest, + logging, optimized caching, etc. It also allows obsolete or mistyped + links to be traced for maintenance. The Referer field MUST NOT be + sent if the Request-URI was obtained from a source that does not have + its own URI, such as input from the user keyboard. + + Referer = "Referer" ":" ( absoluteURI | relativeURI ) + + Example: + + Referer: http://www.w3.org/hypertext/DataSources/Overview.html + + + + +Fielding, et al. Standards Track [Page 140] + +RFC 2616 HTTP/1.1 June 1999 + + + If the field value is a relative URI, it SHOULD be interpreted + relative to the Request-URI. The URI MUST NOT include a fragment. See + section 15.1.3 for security considerations. + +14.37 Retry-After + + The Retry-After response-header field can be used with a 503 (Service + Unavailable) response to indicate how long the service is expected to + be unavailable to the requesting client. This field MAY also be used + with any 3xx (Redirection) response to indicate the minimum time the + user-agent is asked wait before issuing the redirected request. The + value of this field can be either an HTTP-date or an integer number + of seconds (in decimal) after the time of the response. + + Retry-After = "Retry-After" ":" ( HTTP-date | delta-seconds ) + + Two examples of its use are + + Retry-After: Fri, 31 Dec 1999 23:59:59 GMT + Retry-After: 120 + + In the latter example, the delay is 2 minutes. + +14.38 Server + + The Server response-header field contains information about the + software used by the origin server to handle the request. The field + can contain multiple product tokens (section 3.8) and comments + identifying the server and any significant subproducts. The product + tokens are listed in order of their significance for identifying the + application. + + Server = "Server" ":" 1*( product | comment ) + + Example: + + Server: CERN/3.0 libwww/2.17 + + If the response is being forwarded through a proxy, the proxy + application MUST NOT modify the Server response-header. Instead, it + SHOULD include a Via field (as described in section 14.45). + + Note: Revealing the specific software version of the server might + allow the server machine to become more vulnerable to attacks + against software that is known to contain security holes. Server + implementors are encouraged to make this field a configurable + option. + + + + +Fielding, et al. Standards Track [Page 141] + +RFC 2616 HTTP/1.1 June 1999 + + +14.39 TE + + The TE request-header field indicates what extension transfer-codings + it is willing to accept in the response and whether or not it is + willing to accept trailer fields in a chunked transfer-coding. Its + value may consist of the keyword "trailers" and/or a comma-separated + list of extension transfer-coding names with optional accept + parameters (as described in section 3.6). + + TE = "TE" ":" #( t-codings ) + t-codings = "trailers" | ( transfer-extension [ accept-params ] ) + + The presence of the keyword "trailers" indicates that the client is + willing to accept trailer fields in a chunked transfer-coding, as + defined in section 3.6.1. This keyword is reserved for use with + transfer-coding values even though it does not itself represent a + transfer-coding. + + Examples of its use are: + + TE: deflate + TE: + TE: trailers, deflate;q=0.5 + + The TE header field only applies to the immediate connection. + Therefore, the keyword MUST be supplied within a Connection header + field (section 14.10) whenever TE is present in an HTTP/1.1 message. + + A server tests whether a transfer-coding is acceptable, according to + a TE field, using these rules: + + 1. The "chunked" transfer-coding is always acceptable. If the + keyword "trailers" is listed, the client indicates that it is + willing to accept trailer fields in the chunked response on + behalf of itself and any downstream clients. The implication is + that, if given, the client is stating that either all + downstream clients are willing to accept trailer fields in the + forwarded response, or that it will attempt to buffer the + response on behalf of downstream recipients. + + Note: HTTP/1.1 does not define any means to limit the size of a + chunked response such that a client can be assured of buffering + the entire response. + + 2. If the transfer-coding being tested is one of the transfer- + codings listed in the TE field, then it is acceptable unless it + is accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + + +Fielding, et al. Standards Track [Page 142] + +RFC 2616 HTTP/1.1 June 1999 + + + 3. If multiple transfer-codings are acceptable, then the + acceptable transfer-coding with the highest non-zero qvalue is + preferred. The "chunked" transfer-coding always has a qvalue + of 1. + + If the TE field-value is empty or if no TE field is present, the only + transfer-coding is "chunked". A message with no transfer-coding is + always acceptable. + +14.40 Trailer + + The Trailer general field value indicates that the given set of + header fields is present in the trailer of a message encoded with + chunked transfer-coding. + + Trailer = "Trailer" ":" 1#field-name + + An HTTP/1.1 message SHOULD include a Trailer header field in a + message using chunked transfer-coding with a non-empty trailer. Doing + so allows the recipient to know which header fields to expect in the + trailer. + + If no Trailer header field is present, the trailer SHOULD NOT include + any header fields. See section 3.6.1 for restrictions on the use of + trailer fields in a "chunked" transfer-coding. + + Message header fields listed in the Trailer header field MUST NOT + include the following header fields: + + . Transfer-Encoding + + . Content-Length + + . Trailer + +14.41 Transfer-Encoding + + The Transfer-Encoding general-header field indicates what (if any) + type of transformation has been applied to the message body in order + to safely transfer it between the sender and the recipient. This + differs from the content-coding in that the transfer-coding is a + property of the message, not of the entity. + + Transfer-Encoding = "Transfer-Encoding" ":" 1#transfer-coding + + Transfer-codings are defined in section 3.6. An example is: + + Transfer-Encoding: chunked + + + +Fielding, et al. Standards Track [Page 143] + +RFC 2616 HTTP/1.1 June 1999 + + + If multiple encodings have been applied to an entity, the transfer- + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + + Many older HTTP/1.0 applications do not understand the Transfer- + Encoding header. + +14.42 Upgrade + + The Upgrade general-header allows the client to specify what + additional communication protocols it supports and would like to use + if the server finds it appropriate to switch protocols. The server + MUST use the Upgrade header field within a 101 (Switching Protocols) + response to indicate which protocol(s) are being switched. + + Upgrade = "Upgrade" ":" 1#product + + For example, + + Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11 + + The Upgrade header field is intended to provide a simple mechanism + for transition from HTTP/1.1 to some other, incompatible protocol. It + does so by allowing the client to advertise its desire to use another + protocol, such as a later version of HTTP with a higher major version + number, even though the current request has been made using HTTP/1.1. + This eases the difficult transition between incompatible protocols by + allowing the client to initiate a request in the more commonly + supported protocol while indicating to the server that it would like + to use a "better" protocol if available (where "better" is determined + by the server, possibly according to the nature of the method and/or + resource being requested). + + The Upgrade header field only applies to switching application-layer + protocols upon the existing transport-layer connection. Upgrade + cannot be used to insist on a protocol change; its acceptance and use + by the server is optional. The capabilities and nature of the + application-layer communication after the protocol change is entirely + dependent upon the new protocol chosen, although the first action + after changing the protocol MUST be a response to the initial HTTP + request containing the Upgrade header field. + + The Upgrade header field only applies to the immediate connection. + Therefore, the upgrade keyword MUST be supplied within a Connection + header field (section 14.10) whenever Upgrade is present in an + HTTP/1.1 message. + + + + +Fielding, et al. Standards Track [Page 144] + +RFC 2616 HTTP/1.1 June 1999 + + + The Upgrade header field cannot be used to indicate a switch to a + protocol on a different connection. For that purpose, it is more + appropriate to use a 301, 302, 303, or 305 redirection response. + + This specification only defines the protocol name "HTTP" for use by + the family of Hypertext Transfer Protocols, as defined by the HTTP + version rules of section 3.1 and future updates to this + specification. Any token can be used as a protocol name; however, it + will only be useful if both the client and server associate the name + with the same protocol. + +14.43 User-Agent + + The User-Agent request-header field contains information about the + user agent originating the request. This is for statistical purposes, + the tracing of protocol violations, and automated recognition of user + agents for the sake of tailoring responses to avoid particular user + agent limitations. User agents SHOULD include this field with + requests. The field can contain multiple product tokens (section 3.8) + and comments identifying the agent and any subproducts which form a + significant part of the user agent. By convention, the product tokens + are listed in order of their significance for identifying the + application. + + User-Agent = "User-Agent" ":" 1*( product | comment ) + + Example: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + +14.44 Vary + + The Vary field value indicates the set of request-header fields that + fully determines, while the response is fresh, whether a cache is + permitted to use the response to reply to a subsequent request + without revalidation. For uncacheable or stale responses, the Vary + field value advises the user agent about the criteria that were used + to select the representation. A Vary field value of "*" implies that + a cache cannot determine from the request headers of a subsequent + request whether this response is the appropriate representation. See + section 13.6 for use of the Vary header field by caches. + + Vary = "Vary" ":" ( "*" | 1#field-name ) + + An HTTP/1.1 server SHOULD include a Vary header field with any + cacheable response that is subject to server-driven negotiation. + Doing so allows a cache to properly interpret future requests on that + resource and informs the user agent about the presence of negotiation + + + +Fielding, et al. Standards Track [Page 145] + +RFC 2616 HTTP/1.1 June 1999 + + + on that resource. A server MAY include a Vary header field with a + non-cacheable response that is subject to server-driven negotiation, + since this might provide the user agent with useful information about + the dimensions over which the response varies at the time of the + response. + + A Vary field value consisting of a list of field-names signals that + the representation selected for the response is based on a selection + algorithm which considers ONLY the listed request-header field values + in selecting the most appropriate representation. A cache MAY assume + that the same selection will be made for future requests with the + same values for the listed field names, for the duration of time for + which the response is fresh. + + The field-names given are not limited to the set of standard + request-header fields defined by this specification. Field names are + case-insensitive. + + A Vary field value of "*" signals that unspecified parameters not + limited to the request-headers (e.g., the network address of the + client), play a role in the selection of the response representation. + The "*" value MUST NOT be generated by a proxy server; it may only be + generated by an origin server. + +14.45 Via + + The Via general-header field MUST be used by gateways and proxies to + indicate the intermediate protocols and recipients between the user + agent and the server on requests, and between the origin server and + the client on responses. It is analogous to the "Received" field of + RFC 822 [9] and is intended to be used for tracking message forwards, + avoiding request loops, and identifying the protocol capabilities of + all senders along the request/response chain. + + Via = "Via" ":" 1#( received-protocol received-by [ comment ] ) + received-protocol = [ protocol-name "/" ] protocol-version + protocol-name = token + protocol-version = token + received-by = ( host [ ":" port ] ) | pseudonym + pseudonym = token + + The received-protocol indicates the protocol version of the message + received by the server or client along each segment of the + request/response chain. The received-protocol version is appended to + the Via field value when the message is forwarded so that information + about the protocol capabilities of upstream applications remains + visible to all recipients. + + + + +Fielding, et al. Standards Track [Page 146] + +RFC 2616 HTTP/1.1 June 1999 + + + The protocol-name is optional if and only if it would be "HTTP". The + received-by field is normally the host and optional port number of a + recipient server or client that subsequently forwarded the message. + However, if the real host is considered to be sensitive information, + it MAY be replaced by a pseudonym. If the port is not given, it MAY + be assumed to be the default port of the received-protocol. + + Multiple Via field values represents each proxy or gateway that has + forwarded the message. Each recipient MUST append its information + such that the end result is ordered according to the sequence of + forwarding applications. + + Comments MAY be used in the Via header field to identify the software + of the recipient proxy or gateway, analogous to the User-Agent and + Server header fields. However, all comments in the Via field are + optional and MAY be removed by any recipient prior to forwarding the + message. + + For example, a request message could be sent from an HTTP/1.0 user + agent to an internal proxy code-named "fred", which uses HTTP/1.1 to + forward the request to a public proxy at nowhere.com, which completes + the request by forwarding it to the origin server at www.ics.uci.edu. + The request received by www.ics.uci.edu would then have the following + Via header field: + + Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1) + + Proxies and gateways used as a portal through a network firewall + SHOULD NOT, by default, forward the names and ports of hosts within + the firewall region. This information SHOULD only be propagated if + explicitly enabled. If not enabled, the received-by host of any host + behind the firewall SHOULD be replaced by an appropriate pseudonym + for that host. + + For organizations that have strong privacy requirements for hiding + internal structures, a proxy MAY combine an ordered subsequence of + Via header field entries with identical received-protocol values into + a single such entry. For example, + + Via: 1.0 ricky, 1.1 ethel, 1.1 fred, 1.0 lucy + + could be collapsed to + + Via: 1.0 ricky, 1.1 mertz, 1.0 lucy + + + + + + + +Fielding, et al. Standards Track [Page 147] + +RFC 2616 HTTP/1.1 June 1999 + + + Applications SHOULD NOT combine multiple entries unless they are all + under the same organizational control and the hosts have already been + replaced by pseudonyms. Applications MUST NOT combine entries which + have different received-protocol values. + +14.46 Warning + + The Warning general-header field is used to carry additional + information about the status or transformation of a message which + might not be reflected in the message. This information is typically + used to warn about a possible lack of semantic transparency from + caching operations or transformations applied to the entity body of + the message. + + Warning headers are sent with responses using: + + Warning = "Warning" ":" 1#warning-value + + warning-value = warn-code SP warn-agent SP warn-text + [SP warn-date] + + warn-code = 3DIGIT + warn-agent = ( host [ ":" port ] ) | pseudonym + ; the name or pseudonym of the server adding + ; the Warning header, for use in debugging + warn-text = quoted-string + warn-date = <"> HTTP-date <"> + + A response MAY carry more than one Warning header. + + The warn-text SHOULD be in a natural language and character set that + is most likely to be intelligible to the human user receiving the + response. This decision MAY be based on any available knowledge, such + as the location of the cache or user, the Accept-Language field in a + request, the Content-Language field in a response, etc. The default + language is English and the default character set is ISO-8859-1. + + If a character set other than ISO-8859-1 is used, it MUST be encoded + in the warn-text using the method described in RFC 2047 [14]. + + Warning headers can in general be applied to any message, however + some specific warn-codes are specific to caches and can only be + applied to response messages. New Warning headers SHOULD be added + after any existing Warning headers. A cache MUST NOT delete any + Warning header that it received with a message. However, if a cache + successfully validates a cache entry, it SHOULD remove any Warning + headers previously attached to that entry except as specified for + + + + +Fielding, et al. Standards Track [Page 148] + +RFC 2616 HTTP/1.1 June 1999 + + + specific Warning codes. It MUST then add any Warning headers received + in the validating response. In other words, Warning headers are those + that would be attached to the most recent relevant response. + + When multiple Warning headers are attached to a response, the user + agent ought to inform the user of as many of them as possible, in the + order that they appear in the response. If it is not possible to + inform the user of all of the warnings, the user agent SHOULD follow + these heuristics: + + - Warnings that appear early in the response take priority over + those appearing later in the response. + + - Warnings in the user's preferred character set take priority + over warnings in other character sets but with identical warn- + codes and warn-agents. + + Systems that generate multiple Warning headers SHOULD order them with + this user agent behavior in mind. + + Requirements for the behavior of caches with respect to Warnings are + stated in section 13.1.2. + + This is a list of the currently-defined warn-codes, each with a + recommended warn-text in English, and a description of its meaning. + + 110 Response is stale + MUST be included whenever the returned response is stale. + + 111 Revalidation failed + MUST be included if a cache returns a stale response because an + attempt to revalidate the response failed, due to an inability to + reach the server. + + 112 Disconnected operation + SHOULD be included if the cache is intentionally disconnected from + the rest of the network for a period of time. + + 113 Heuristic expiration + MUST be included if the cache heuristically chose a freshness + lifetime greater than 24 hours and the response's age is greater + than 24 hours. + + 199 Miscellaneous warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action, besides presenting the warning to + the user. + + + +Fielding, et al. Standards Track [Page 149] + +RFC 2616 HTTP/1.1 June 1999 + + + 214 Transformation applied + MUST be added by an intermediate cache or proxy if it applies any + transformation changing the content-coding (as specified in the + Content-Encoding header) or media-type (as specified in the + Content-Type header) of the response, or the entity-body of the + response, unless this Warning code already appears in the response. + + 299 Miscellaneous persistent warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action. + + If an implementation sends a message with one or more Warning headers + whose version is HTTP/1.0 or lower, then the sender MUST include in + each warning-value a warn-date that matches the date in the response. + + If an implementation receives a message with a warning-value that + includes a warn-date, and that warn-date is different from the Date + value in the response, then that warning-value MUST be deleted from + the message before storing, forwarding, or using it. (This prevents + bad consequences of naive caching of Warning header fields.) If all + of the warning-values are deleted for this reason, the Warning header + MUST be deleted as well. + +14.47 WWW-Authenticate + + The WWW-Authenticate response-header field MUST be included in 401 + (Unauthorized) response messages. The field value consists of at + least one challenge that indicates the authentication scheme(s) and + parameters applicable to the Request-URI. + + WWW-Authenticate = "WWW-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. User + agents are advised to take special care in parsing the WWW- + Authenticate field value as it might contain more than one challenge, + or if more than one WWW-Authenticate header field is provided, the + contents of a challenge itself can contain a comma-separated list of + authentication parameters. + +15 Security Considerations + + This section is meant to inform application developers, information + providers, and users of the security limitations in HTTP/1.1 as + described by this document. The discussion does not include + definitive solutions to the problems revealed, though it does make + some suggestions for reducing security risks. + + + +Fielding, et al. Standards Track [Page 150] + +RFC 2616 HTTP/1.1 June 1999 + + +15.1 Personal Information + + HTTP clients are often privy to large amounts of personal information + (e.g. the user's name, location, mail address, passwords, encryption + keys, etc.), and SHOULD be very careful to prevent unintentional + leakage of this information via the HTTP protocol to other sources. + We very strongly recommend that a convenient interface be provided + for the user to control dissemination of such information, and that + designers and implementors be particularly careful in this area. + History shows that errors in this area often create serious security + and/or privacy problems and generate highly adverse publicity for the + implementor's company. + +15.1.1 Abuse of Server Log Information + + A server is in the position to save personal data about a user's + requests which might identify their reading patterns or subjects of + interest. This information is clearly confidential in nature and its + handling can be constrained by law in certain countries. People using + the HTTP protocol to provide data are responsible for ensuring that + such material is not distributed without the permission of any + individuals that are identifiable by the published results. + +15.1.2 Transfer of Sensitive Information + + Like any generic data transfer protocol, HTTP cannot regulate the + content of the data that is transferred, nor is there any a priori + method of determining the sensitivity of any particular piece of + information within the context of any given request. Therefore, + applications SHOULD supply as much control over this information as + possible to the provider of that information. Four header fields are + worth special mention in this context: Server, Via, Referer and From. + + Revealing the specific software version of the server might allow the + server machine to become more vulnerable to attacks against software + that is known to contain security holes. Implementors SHOULD make the + Server header field a configurable option. + + Proxies which serve as a portal through a network firewall SHOULD + take special precautions regarding the transfer of header information + that identifies the hosts behind the firewall. In particular, they + SHOULD remove, or replace with sanitized versions, any Via fields + generated behind the firewall. + + The Referer header allows reading patterns to be studied and reverse + links drawn. Although it can be very useful, its power can be abused + if user details are not separated from the information contained in + + + + +Fielding, et al. Standards Track [Page 151] + +RFC 2616 HTTP/1.1 June 1999 + + + the Referer. Even when the personal information has been removed, the + Referer header might indicate a private document's URI whose + publication would be inappropriate. + + The information sent in the From field might conflict with the user's + privacy interests or their site's security policy, and hence it + SHOULD NOT be transmitted without the user being able to disable, + enable, and modify the contents of the field. The user MUST be able + to set the contents of this field within a user preference or + application defaults configuration. + + We suggest, though do not require, that a convenient toggle interface + be provided for the user to enable or disable the sending of From and + Referer information. + + The User-Agent (section 14.43) or Server (section 14.38) header + fields can sometimes be used to determine that a specific client or + server have a particular security hole which might be exploited. + Unfortunately, this same information is often used for other valuable + purposes for which HTTP currently has no better mechanism. + +15.1.3 Encoding Sensitive Information in URI's + + Because the source of a link might be private information or might + reveal an otherwise private information source, it is strongly + recommended that the user be able to select whether or not the + Referer field is sent. For example, a browser client could have a + toggle switch for browsing openly/anonymously, which would + respectively enable/disable the sending of Referer and From + information. + + Clients SHOULD NOT include a Referer header field in a (non-secure) + HTTP request if the referring page was transferred with a secure + protocol. + + Authors of services which use the HTTP protocol SHOULD NOT use GET + based forms for the submission of sensitive data, because this will + cause this data to be encoded in the Request-URI. Many existing + servers, proxies, and user agents will log the request URI in some + place where it might be visible to third parties. Servers can use + POST-based form submission instead + +15.1.4 Privacy Issues Connected to Accept Headers + + Accept request-headers can reveal information about the user to all + servers which are accessed. The Accept-Language header in particular + can reveal information the user would consider to be of a private + nature, because the understanding of particular languages is often + + + +Fielding, et al. Standards Track [Page 152] + +RFC 2616 HTTP/1.1 June 1999 + + + strongly correlated to the membership of a particular ethnic group. + User agents which offer the option to configure the contents of an + Accept-Language header to be sent in every request are strongly + encouraged to let the configuration process include a message which + makes the user aware of the loss of privacy involved. + + An approach that limits the loss of privacy would be for a user agent + to omit the sending of Accept-Language headers by default, and to ask + the user whether or not to start sending Accept-Language headers to a + server if it detects, by looking for any Vary response-header fields + generated by the server, that such sending could improve the quality + of service. + + Elaborate user-customized accept header fields sent in every request, + in particular if these include quality values, can be used by servers + as relatively reliable and long-lived user identifiers. Such user + identifiers would allow content providers to do click-trail tracking, + and would allow collaborating content providers to match cross-server + click-trails or form submissions of individual users. Note that for + many users not behind a proxy, the network address of the host + running the user agent will also serve as a long-lived user + identifier. In environments where proxies are used to enhance + privacy, user agents ought to be conservative in offering accept + header configuration options to end users. As an extreme privacy + measure, proxies could filter the accept headers in relayed requests. + General purpose user agents which provide a high degree of header + configurability SHOULD warn users about the loss of privacy which can + be involved. + +15.2 Attacks Based On File and Path Names + + Implementations of HTTP origin servers SHOULD be careful to restrict + the documents returned by HTTP requests to be only those that were + intended by the server administrators. If an HTTP server translates + HTTP URIs directly into file system calls, the server MUST take + special care not to serve files that were not intended to be + delivered to HTTP clients. For example, UNIX, Microsoft Windows, and + other operating systems use ".." as a path component to indicate a + directory level above the current one. On such a system, an HTTP + server MUST disallow any such construct in the Request-URI if it + would otherwise allow access to a resource outside those intended to + be accessible via the HTTP server. Similarly, files intended for + reference only internally to the server (such as access control + files, configuration files, and script code) MUST be protected from + inappropriate retrieval, since they might contain sensitive + information. Experience has shown that minor bugs in such HTTP server + implementations have turned into security risks. + + + + +Fielding, et al. Standards Track [Page 153] + +RFC 2616 HTTP/1.1 June 1999 + + +15.3 DNS Spoofing + + Clients using HTTP rely heavily on the Domain Name Service, and are + thus generally prone to security attacks based on the deliberate + mis-association of IP addresses and DNS names. Clients need to be + cautious in assuming the continuing validity of an IP number/DNS name + association. + + In particular, HTTP clients SHOULD rely on their name resolver for + confirmation of an IP number/DNS name association, rather than + caching the result of previous host name lookups. Many platforms + already can cache host name lookups locally when appropriate, and + they SHOULD be configured to do so. It is proper for these lookups to + be cached, however, only when the TTL (Time To Live) information + reported by the name server makes it likely that the cached + information will remain useful. + + If HTTP clients cache the results of host name lookups in order to + achieve a performance improvement, they MUST observe the TTL + information reported by DNS. + + If HTTP clients do not observe this rule, they could be spoofed when + a previously-accessed server's IP address changes. As network + renumbering is expected to become increasingly common [24], the + possibility of this form of attack will grow. Observing this + requirement thus reduces this potential security vulnerability. + + This requirement also improves the load-balancing behavior of clients + for replicated servers using the same DNS name and reduces the + likelihood of a user's experiencing failure in accessing sites which + use that strategy. + +15.4 Location Headers and Spoofing + + If a single server supports multiple organizations that do not trust + one another, then it MUST check the values of Location and Content- + Location headers in responses that are generated under control of + said organizations to make sure that they do not attempt to + invalidate resources over which they have no authority. + +15.5 Content-Disposition Issues + + RFC 1806 [35], from which the often implemented Content-Disposition + (see section 19.5.1) header in HTTP is derived, has a number of very + serious security considerations. Content-Disposition is not part of + the HTTP standard, but since it is widely implemented, we are + documenting its use and risks for implementors. See RFC 2183 [49] + (which updates RFC 1806) for details. + + + +Fielding, et al. Standards Track [Page 154] + +RFC 2616 HTTP/1.1 June 1999 + + +15.6 Authentication Credentials and Idle Clients + + Existing HTTP clients and user agents typically retain authentication + information indefinitely. HTTP/1.1. does not provide a method for a + server to direct clients to discard these cached credentials. This is + a significant defect that requires further extensions to HTTP. + Circumstances under which credential caching can interfere with the + application's security model include but are not limited to: + + - Clients which have been idle for an extended period following + which the server might wish to cause the client to reprompt the + user for credentials. + + - Applications which include a session termination indication + (such as a `logout' or `commit' button on a page) after which + the server side of the application `knows' that there is no + further reason for the client to retain the credentials. + + This is currently under separate study. There are a number of work- + arounds to parts of this problem, and we encourage the use of + password protection in screen savers, idle time-outs, and other + methods which mitigate the security problems inherent in this + problem. In particular, user agents which cache credentials are + encouraged to provide a readily accessible mechanism for discarding + cached credentials under user control. + +15.7 Proxies and Caching + + By their very nature, HTTP proxies are men-in-the-middle, and + represent an opportunity for man-in-the-middle attacks. Compromise of + the systems on which the proxies run can result in serious security + and privacy problems. Proxies have access to security-related + information, personal information about individual users and + organizations, and proprietary information belonging to users and + content providers. A compromised proxy, or a proxy implemented or + configured without regard to security and privacy considerations, + might be used in the commission of a wide range of potential attacks. + + Proxy operators should protect the systems on which proxies run as + they would protect any system that contains or transports sensitive + information. In particular, log information gathered at proxies often + contains highly sensitive personal information, and/or information + about organizations. Log information should be carefully guarded, and + appropriate guidelines for use developed and followed. (Section + 15.1.1). + + + + + + +Fielding, et al. Standards Track [Page 155] + +RFC 2616 HTTP/1.1 June 1999 + + + Caching proxies provide additional potential vulnerabilities, since + the contents of the cache represent an attractive target for + malicious exploitation. Because cache contents persist after an HTTP + request is complete, an attack on the cache can reveal information + long after a user believes that the information has been removed from + the network. Therefore, cache contents should be protected as + sensitive information. + + Proxy implementors should consider the privacy and security + implications of their design and coding decisions, and of the + configuration options they provide to proxy operators (especially the + default configuration). + + Users of a proxy need to be aware that they are no trustworthier than + the people who run the proxy; HTTP itself cannot solve this problem. + + The judicious use of cryptography, when appropriate, may suffice to + protect against a broad range of security and privacy attacks. Such + cryptography is beyond the scope of the HTTP/1.1 specification. + +15.7.1 Denial of Service Attacks on Proxies + + They exist. They are hard to defend against. Research continues. + Beware. + +16 Acknowledgments + + This specification makes heavy use of the augmented BNF and generic + constructs defined by David H. Crocker for RFC 822 [9]. Similarly, it + reuses many of the definitions provided by Nathaniel Borenstein and + Ned Freed for MIME [7]. We hope that their inclusion in this + specification will help reduce past confusion over the relationship + between HTTP and Internet mail message formats. + + The HTTP protocol has evolved considerably over the years. It has + benefited from a large and active developer community--the many + people who have participated on the www-talk mailing list--and it is + that community which has been most responsible for the success of + HTTP and of the World-Wide Web in general. Marc Andreessen, Robert + Cailliau, Daniel W. Connolly, Bob Denny, John Franks, Jean-Francois + Groff, Phillip M. Hallam-Baker, Hakon W. Lie, Ari Luotonen, Rob + McCool, Lou Montulli, Dave Raggett, Tony Sanders, and Marc + VanHeyningen deserve special recognition for their efforts in + defining early aspects of the protocol. + + This document has benefited greatly from the comments of all those + participating in the HTTP-WG. In addition to those already mentioned, + the following individuals have contributed to this specification: + + + +Fielding, et al. Standards Track [Page 156] + +RFC 2616 HTTP/1.1 June 1999 + + + Gary Adams Ross Patterson + Harald Tveit Alvestrand Albert Lunde + Keith Ball John C. Mallery + Brian Behlendorf Jean-Philippe Martin-Flatin + Paul Burchard Mitra + Maurizio Codogno David Morris + Mike Cowlishaw Gavin Nicol + Roman Czyborra Bill Perry + Michael A. Dolan Jeffrey Perry + David J. Fiander Scott Powers + Alan Freier Owen Rees + Marc Hedlund Luigi Rizzo + Greg Herlihy David Robinson + Koen Holtman Marc Salomon + Alex Hopmann Rich Salz + Bob Jernigan Allan M. Schiffman + Shel Kaphan Jim Seidman + Rohit Khare Chuck Shotton + John Klensin Eric W. Sink + Martijn Koster Simon E. Spero + Alexei Kosut Richard N. Taylor + David M. Kristol Robert S. Thau + Daniel LaLiberte Bill (BearHeart) Weinman + Ben Laurie Francois Yergeau + Paul J. Leach Mary Ellen Zurko + Daniel DuBois Josh Cohen + + + Much of the content and presentation of the caching design is due to + suggestions and comments from individuals including: Shel Kaphan, + Paul Leach, Koen Holtman, David Morris, and Larry Masinter. + + Most of the specification of ranges is based on work originally done + by Ari Luotonen and John Franks, with additional input from Steve + Zilles. + + Thanks to the "cave men" of Palo Alto. You know who you are. + + Jim Gettys (the current editor of this document) wishes particularly + to thank Roy Fielding, the previous editor of this document, along + with John Klensin, Jeff Mogul, Paul Leach, Dave Kristol, Koen + Holtman, John Franks, Josh Cohen, Alex Hopmann, Scott Lawrence, and + Larry Masinter for their help. And thanks go particularly to Jeff + Mogul and Scott Lawrence for performing the "MUST/MAY/SHOULD" audit. + + + + + + + +Fielding, et al. Standards Track [Page 157] + +RFC 2616 HTTP/1.1 June 1999 + + + The Apache Group, Anselm Baird-Smith, author of Jigsaw, and Henrik + Frystyk implemented RFC 2068 early, and we wish to thank them for the + discovery of many of the problems that this document attempts to + rectify. + +17 References + + [1] Alvestrand, H., "Tags for the Identification of Languages", RFC + 1766, March 1995. + + [2] Anklesaria, F., McCahill, M., Lindner, P., Johnson, D., Torrey, + D. and B. Alberti, "The Internet Gopher Protocol (a distributed + document search and retrieval protocol)", RFC 1436, March 1993. + + [3] Berners-Lee, T., "Universal Resource Identifiers in WWW", RFC + 1630, June 1994. + + [4] Berners-Lee, T., Masinter, L. and M. McCahill, "Uniform Resource + Locators (URL)", RFC 1738, December 1994. + + [5] Berners-Lee, T. and D. Connolly, "Hypertext Markup Language - + 2.0", RFC 1866, November 1995. + + [6] Berners-Lee, T., Fielding, R. and H. Frystyk, "Hypertext Transfer + Protocol -- HTTP/1.0", RFC 1945, May 1996. + + [7] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part One: Format of Internet Message Bodies", + RFC 2045, November 1996. + + [8] Braden, R., "Requirements for Internet Hosts -- Communication + Layers", STD 3, RFC 1123, October 1989. + + [9] Crocker, D., "Standard for The Format of ARPA Internet Text + Messages", STD 11, RFC 822, August 1982. + + [10] Davis, F., Kahle, B., Morris, H., Salem, J., Shen, T., Wang, R., + Sui, J., and M. Grinbaum, "WAIS Interface Protocol Prototype + Functional Specification," (v1.5), Thinking Machines + Corporation, April 1990. + + [11] Fielding, R., "Relative Uniform Resource Locators", RFC 1808, + June 1995. + + [12] Horton, M. and R. Adams, "Standard for Interchange of USENET + Messages", RFC 1036, December 1987. + + + + + +Fielding, et al. Standards Track [Page 158] + +RFC 2616 HTTP/1.1 June 1999 + + + [13] Kantor, B. and P. Lapsley, "Network News Transfer Protocol", RFC + 977, February 1986. + + [14] Moore, K., "MIME (Multipurpose Internet Mail Extensions) Part + Three: Message Header Extensions for Non-ASCII Text", RFC 2047, + November 1996. + + [15] Nebel, E. and L. Masinter, "Form-based File Upload in HTML", RFC + 1867, November 1995. + + [16] Postel, J., "Simple Mail Transfer Protocol", STD 10, RFC 821, + August 1982. + + [17] Postel, J., "Media Type Registration Procedure", RFC 1590, + November 1996. + + [18] Postel, J. and J. Reynolds, "File Transfer Protocol", STD 9, RFC + 959, October 1985. + + [19] Reynolds, J. and J. Postel, "Assigned Numbers", STD 2, RFC 1700, + October 1994. + + [20] Sollins, K. and L. Masinter, "Functional Requirements for + Uniform Resource Names", RFC 1737, December 1994. + + [21] US-ASCII. Coded Character Set - 7-Bit American Standard Code for + Information Interchange. Standard ANSI X3.4-1986, ANSI, 1986. + + [22] ISO-8859. International Standard -- Information Processing -- + 8-bit Single-Byte Coded Graphic Character Sets -- + Part 1: Latin alphabet No. 1, ISO-8859-1:1987. + Part 2: Latin alphabet No. 2, ISO-8859-2, 1987. + Part 3: Latin alphabet No. 3, ISO-8859-3, 1988. + Part 4: Latin alphabet No. 4, ISO-8859-4, 1988. + Part 5: Latin/Cyrillic alphabet, ISO-8859-5, 1988. + Part 6: Latin/Arabic alphabet, ISO-8859-6, 1987. + Part 7: Latin/Greek alphabet, ISO-8859-7, 1987. + Part 8: Latin/Hebrew alphabet, ISO-8859-8, 1988. + Part 9: Latin alphabet No. 5, ISO-8859-9, 1990. + + [23] Meyers, J. and M. Rose, "The Content-MD5 Header Field", RFC + 1864, October 1995. + + [24] Carpenter, B. and Y. Rekhter, "Renumbering Needs Work", RFC + 1900, February 1996. + + [25] Deutsch, P., "GZIP file format specification version 4.3", RFC + 1952, May 1996. + + + +Fielding, et al. Standards Track [Page 159] + +RFC 2616 HTTP/1.1 June 1999 + + + [26] Venkata N. Padmanabhan, and Jeffrey C. Mogul. "Improving HTTP + Latency", Computer Networks and ISDN Systems, v. 28, pp. 25-35, + Dec. 1995. Slightly revised version of paper in Proc. 2nd + International WWW Conference '94: Mosaic and the Web, Oct. 1994, + which is available at + http://www.ncsa.uiuc.edu/SDG/IT94/Proceedings/DDay/mogul/HTTPLat + ency.html. + + [27] Joe Touch, John Heidemann, and Katia Obraczka. "Analysis of HTTP + Performance", , + ISI Research Report ISI/RR-98-463, (original report dated Aug. + 1996), USC/Information Sciences Institute, August 1998. + + [28] Mills, D., "Network Time Protocol (Version 3) Specification, + Implementation and Analysis", RFC 1305, March 1992. + + [29] Deutsch, P., "DEFLATE Compressed Data Format Specification + version 1.3", RFC 1951, May 1996. + + [30] S. Spero, "Analysis of HTTP Performance Problems," + http://sunsite.unc.edu/mdma-release/http-prob.html. + + [31] Deutsch, P. and J. Gailly, "ZLIB Compressed Data Format + Specification version 3.3", RFC 1950, May 1996. + + [32] Franks, J., Hallam-Baker, P., Hostetler, J., Leach, P., + Luotonen, A., Sink, E. and L. Stewart, "An Extension to HTTP: + Digest Access Authentication", RFC 2069, January 1997. + + [33] Fielding, R., Gettys, J., Mogul, J., Frystyk, H. and T. + Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1", RFC + 2068, January 1997. + + [34] Bradner, S., "Key words for use in RFCs to Indicate Requirement + Levels", BCP 14, RFC 2119, March 1997. + + [35] Troost, R. and Dorner, S., "Communicating Presentation + Information in Internet Messages: The Content-Disposition + Header", RFC 1806, June 1995. + + [36] Mogul, J., Fielding, R., Gettys, J. and H. Frystyk, "Use and + Interpretation of HTTP Version Numbers", RFC 2145, May 1997. + [jg639] + + [37] Palme, J., "Common Internet Message Headers", RFC 2076, February + 1997. [jg640] + + + + + +Fielding, et al. Standards Track [Page 160] + +RFC 2616 HTTP/1.1 June 1999 + + + [38] Yergeau, F., "UTF-8, a transformation format of Unicode and + ISO-10646", RFC 2279, January 1998. [jg641] + + [39] Nielsen, H.F., Gettys, J., Baird-Smith, A., Prud'hommeaux, E., + Lie, H., and C. Lilley. "Network Performance Effects of + HTTP/1.1, CSS1, and PNG," Proceedings of ACM SIGCOMM '97, Cannes + France, September 1997.[jg642] + + [40] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Two: Media Types", RFC 2046, November + 1996. [jg643] + + [41] Alvestrand, H., "IETF Policy on Character Sets and Languages", + BCP 18, RFC 2277, January 1998. [jg644] + + [42] Berners-Lee, T., Fielding, R. and L. Masinter, "Uniform Resource + Identifiers (URI): Generic Syntax and Semantics", RFC 2396, + August 1998. [jg645] + + [43] Franks, J., Hallam-Baker, P., Hostetler, J., Lawrence, S., + Leach, P., Luotonen, A., Sink, E. and L. Stewart, "HTTP + Authentication: Basic and Digest Access Authentication", RFC + 2617, June 1999. [jg646] + + [44] Luotonen, A., "Tunneling TCP based protocols through Web proxy + servers," Work in Progress. [jg647] + + [45] Palme, J. and A. Hopmann, "MIME E-mail Encapsulation of + Aggregate Documents, such as HTML (MHTML)", RFC 2110, March + 1997. + + [46] Bradner, S., "The Internet Standards Process -- Revision 3", BCP + 9, RFC 2026, October 1996. + + [47] Masinter, L., "Hyper Text Coffee Pot Control Protocol + (HTCPCP/1.0)", RFC 2324, 1 April 1998. + + [48] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Five: Conformance Criteria and Examples", + RFC 2049, November 1996. + + [49] Troost, R., Dorner, S. and K. Moore, "Communicating Presentation + Information in Internet Messages: The Content-Disposition Header + Field", RFC 2183, August 1997. + + + + + + + +Fielding, et al. Standards Track [Page 161] + +RFC 2616 HTTP/1.1 June 1999 + + +18 Authors' Addresses + + Roy T. Fielding + Information and Computer Science + University of California, Irvine + Irvine, CA 92697-3425, USA + + Fax: +1 (949) 824-1715 + EMail: fielding@ics.uci.edu + + + James Gettys + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: jg@w3.org + + + Jeffrey C. Mogul + Western Research Laboratory + Compaq Computer Corporation + 250 University Avenue + Palo Alto, California, 94305, USA + + EMail: mogul@wrl.dec.com + + + Henrik Frystyk Nielsen + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: frystyk@w3.org + + + Larry Masinter + Xerox Corporation + 3333 Coyote Hill Road + Palo Alto, CA 94034, USA + + EMail: masinter@parc.xerox.com + + + + + +Fielding, et al. Standards Track [Page 162] + +RFC 2616 HTTP/1.1 June 1999 + + + Paul J. Leach + Microsoft Corporation + 1 Microsoft Way + Redmond, WA 98052, USA + + EMail: paulle@microsoft.com + + + Tim Berners-Lee + Director, World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: timbl@w3.org + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 163] + +RFC 2616 HTTP/1.1 June 1999 + + +19 Appendices + +19.1 Internet Media Type message/http and application/http + + In addition to defining the HTTP/1.1 protocol, this document serves + as the specification for the Internet media type "message/http" and + "application/http". The message/http type can be used to enclose a + single HTTP request or response message, provided that it obeys the + MIME restrictions for all "message" types regarding line length and + encodings. The application/http type can be used to enclose a + pipeline of one or more HTTP request or response messages (not + intermixed). The following is to be registered with IANA [17]. + + Media Type name: message + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed message + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + Media Type name: application + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed messages + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: HTTP messages enclosed by this type + are in "binary" format; use of an appropriate + Content-Transfer-Encoding is required when + transmitted via E-mail. + Security considerations: none + + + + + + + + + +Fielding, et al. Standards Track [Page 164] + +RFC 2616 HTTP/1.1 June 1999 + + +19.2 Internet Media Type multipart/byteranges + + When an HTTP 206 (Partial Content) response message includes the + content of multiple ranges (a response to a request for multiple + non-overlapping ranges), these are transmitted as a multipart + message-body. The media type for this purpose is called + "multipart/byteranges". + + The multipart/byteranges media type includes two or more parts, each + with its own Content-Type and Content-Range fields. The required + boundary parameter specifies the boundary string used to separate + each body-part. + + Media Type name: multipart + Media subtype name: byteranges + Required parameters: boundary + Optional parameters: none + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + + For example: + + HTTP/1.1 206 Partial Content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-type: multipart/byteranges; boundary=THIS_STRING_SEPARATES + + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 500-999/8000 + + ...the first range... + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 7000-7999/8000 + + ...the second range + --THIS_STRING_SEPARATES-- + + Notes: + + 1) Additional CRLFs may precede the first boundary string in the + entity. + + + + + + +Fielding, et al. Standards Track [Page 165] + +RFC 2616 HTTP/1.1 June 1999 + + + 2) Although RFC 2046 [40] permits the boundary string to be + quoted, some existing implementations handle a quoted boundary + string incorrectly. + + 3) A number of browsers and servers were coded to an early draft + of the byteranges specification to use a media type of + multipart/x-byteranges, which is almost, but not quite + compatible with the version documented in HTTP/1.1. + +19.3 Tolerant Applications + + Although this document specifies the requirements for the generation + of HTTP/1.1 messages, not all applications will be correct in their + implementation. We therefore recommend that operational applications + be tolerant of deviations whenever those deviations can be + interpreted unambiguously. + + Clients SHOULD be tolerant in parsing the Status-Line and servers + tolerant when parsing the Request-Line. In particular, they SHOULD + accept any amount of SP or HT characters between fields, even though + only a single SP is required. + + The line terminator for message-header fields is the sequence CRLF. + However, we recommend that applications, when parsing such headers, + recognize a single LF as a line terminator and ignore the leading CR. + + The character set of an entity-body SHOULD be labeled as the lowest + common denominator of the character codes used within that body, with + the exception that not labeling the entity is preferred over labeling + the entity with the labels US-ASCII or ISO-8859-1. See section 3.7.1 + and 3.4.1. + + Additional rules for requirements on parsing and encoding of dates + and other potential problems with date encodings include: + + - HTTP/1.1 clients and caches SHOULD assume that an RFC-850 date + which appears to be more than 50 years in the future is in fact + in the past (this helps solve the "year 2000" problem). + + - An HTTP/1.1 implementation MAY internally represent a parsed + Expires date as earlier than the proper value, but MUST NOT + internally represent a parsed Expires date as later than the + proper value. + + - All expiration-related calculations MUST be done in GMT. The + local time zone MUST NOT influence the calculation or comparison + of an age or expiration time. + + + + +Fielding, et al. Standards Track [Page 166] + +RFC 2616 HTTP/1.1 June 1999 + + + - If an HTTP header incorrectly carries a date value with a time + zone other than GMT, it MUST be converted into GMT using the + most conservative possible conversion. + +19.4 Differences Between HTTP Entities and RFC 2045 Entities + + HTTP/1.1 uses many of the constructs defined for Internet Mail (RFC + 822 [9]) and the Multipurpose Internet Mail Extensions (MIME [7]) to + allow entities to be transmitted in an open variety of + representations and with extensible mechanisms. However, RFC 2045 + discusses mail, and HTTP has a few features that are different from + those described in RFC 2045. These differences were carefully chosen + to optimize performance over binary connections, to allow greater + freedom in the use of new media types, to make date comparisons + easier, and to acknowledge the practice of some early HTTP servers + and clients. + + This appendix describes specific areas where HTTP differs from RFC + 2045. Proxies and gateways to strict MIME environments SHOULD be + aware of these differences and provide the appropriate conversions + where necessary. Proxies and gateways from MIME environments to HTTP + also need to be aware of the differences because some conversions + might be required. + +19.4.1 MIME-Version + + HTTP is not a MIME-compliant protocol. However, HTTP/1.1 messages MAY + include a single MIME-Version general-header field to indicate what + version of the MIME protocol was used to construct the message. Use + of the MIME-Version header field indicates that the message is in + full compliance with the MIME protocol (as defined in RFC 2045[7]). + Proxies/gateways are responsible for ensuring full compliance (where + possible) when exporting HTTP messages to strict MIME environments. + + MIME-Version = "MIME-Version" ":" 1*DIGIT "." 1*DIGIT + + MIME version "1.0" is the default for use in HTTP/1.1. However, + HTTP/1.1 message parsing and semantics are defined by this document + and not the MIME specification. + +19.4.2 Conversion to Canonical Form + + RFC 2045 [7] requires that an Internet mail entity be converted to + canonical form prior to being transferred, as described in section 4 + of RFC 2049 [48]. Section 3.7.1 of this document describes the forms + allowed for subtypes of the "text" media type when transmitted over + HTTP. RFC 2046 requires that content with a type of "text" represent + line breaks as CRLF and forbids the use of CR or LF outside of line + + + +Fielding, et al. Standards Track [Page 167] + +RFC 2616 HTTP/1.1 June 1999 + + + break sequences. HTTP allows CRLF, bare CR, and bare LF to indicate a + line break within text content when a message is transmitted over + HTTP. + + Where it is possible, a proxy or gateway from HTTP to a strict MIME + environment SHOULD translate all line breaks within the text media + types described in section 3.7.1 of this document to the RFC 2049 + canonical form of CRLF. Note, however, that this might be complicated + by the presence of a Content-Encoding and by the fact that HTTP + allows the use of some character sets which do not use octets 13 and + 10 to represent CR and LF, as is the case for some multi-byte + character sets. + + Implementors should note that conversion will break any cryptographic + checksums applied to the original content unless the original content + is already in canonical form. Therefore, the canonical form is + recommended for any content that uses such checksums in HTTP. + +19.4.3 Conversion of Date Formats + + HTTP/1.1 uses a restricted set of date formats (section 3.3.1) to + simplify the process of date comparison. Proxies and gateways from + other protocols SHOULD ensure that any Date header field present in a + message conforms to one of the HTTP/1.1 formats and rewrite the date + if necessary. + +19.4.4 Introduction of Content-Encoding + + RFC 2045 does not include any concept equivalent to HTTP/1.1's + Content-Encoding header field. Since this acts as a modifier on the + media type, proxies and gateways from HTTP to MIME-compliant + protocols MUST either change the value of the Content-Type header + field or decode the entity-body before forwarding the message. (Some + experimental applications of Content-Type for Internet mail have used + a media-type parameter of ";conversions=" to perform + a function equivalent to Content-Encoding. However, this parameter is + not part of RFC 2045.) + +19.4.5 No Content-Transfer-Encoding + + HTTP does not use the Content-Transfer-Encoding (CTE) field of RFC + 2045. Proxies and gateways from MIME-compliant protocols to HTTP MUST + remove any non-identity CTE ("quoted-printable" or "base64") encoding + prior to delivering the response message to an HTTP client. + + Proxies and gateways from HTTP to MIME-compliant protocols are + responsible for ensuring that the message is in the correct format + and encoding for safe transport on that protocol, where "safe + + + +Fielding, et al. Standards Track [Page 168] + +RFC 2616 HTTP/1.1 June 1999 + + + transport" is defined by the limitations of the protocol being used. + Such a proxy or gateway SHOULD label the data with an appropriate + Content-Transfer-Encoding if doing so will improve the likelihood of + safe transport over the destination protocol. + +19.4.6 Introduction of Transfer-Encoding + + HTTP/1.1 introduces the Transfer-Encoding header field (section + 14.41). Proxies/gateways MUST remove any transfer-coding prior to + forwarding a message via a MIME-compliant protocol. + + A process for decoding the "chunked" transfer-coding (section 3.6) + can be represented in pseudo-code as: + + length := 0 + read chunk-size, chunk-extension (if any) and CRLF + while (chunk-size > 0) { + read chunk-data and CRLF + append chunk-data to entity-body + length := length + chunk-size + read chunk-size and CRLF + } + read entity-header + while (entity-header not empty) { + append entity-header to existing header fields + read entity-header + } + Content-Length := length + Remove "chunked" from Transfer-Encoding + +19.4.7 MHTML and Line Length Limitations + + HTTP implementations which share code with MHTML [45] implementations + need to be aware of MIME line length limitations. Since HTTP does not + have this limitation, HTTP does not fold long lines. MHTML messages + being transported by HTTP follow all conventions of MHTML, including + line length limitations and folding, canonicalization, etc., since + HTTP transports all message-bodies as payload (see section 3.7.2) and + does not interpret the content or any MIME header lines that might be + contained therein. + +19.5 Additional Features + + RFC 1945 and RFC 2068 document protocol elements used by some + existing HTTP implementations, but not consistently and correctly + across most HTTP/1.1 applications. Implementors are advised to be + aware of these features, but cannot rely upon their presence in, or + interoperability with, other HTTP/1.1 applications. Some of these + + + +Fielding, et al. Standards Track [Page 169] + +RFC 2616 HTTP/1.1 June 1999 + + + describe proposed experimental features, and some describe features + that experimental deployment found lacking that are now addressed in + the base HTTP/1.1 specification. + + A number of other headers, such as Content-Disposition and Title, + from SMTP and MIME are also often implemented (see RFC 2076 [37]). + +19.5.1 Content-Disposition + + The Content-Disposition response-header field has been proposed as a + means for the origin server to suggest a default filename if the user + requests that the content is saved to a file. This usage is derived + from the definition of Content-Disposition in RFC 1806 [35]. + + content-disposition = "Content-Disposition" ":" + disposition-type *( ";" disposition-parm ) + disposition-type = "attachment" | disp-extension-token + disposition-parm = filename-parm | disp-extension-parm + filename-parm = "filename" "=" quoted-string + disp-extension-token = token + disp-extension-parm = token "=" ( token | quoted-string ) + + An example is + + Content-Disposition: attachment; filename="fname.ext" + + The receiving user agent SHOULD NOT respect any directory path + information present in the filename-parm parameter, which is the only + parameter believed to apply to HTTP implementations at this time. The + filename SHOULD be treated as a terminal component only. + + If this header is used in a response with the application/octet- + stream content-type, the implied suggestion is that the user agent + should not display the response, but directly enter a `save response + as...' dialog. + + See section 15.5 for Content-Disposition security issues. + +19.6 Compatibility with Previous Versions + + It is beyond the scope of a protocol specification to mandate + compliance with previous versions. HTTP/1.1 was deliberately + designed, however, to make supporting previous versions easy. It is + worth noting that, at the time of composing this specification + (1996), we would expect commercial HTTP/1.1 servers to: + + - recognize the format of the Request-Line for HTTP/0.9, 1.0, and + 1.1 requests; + + + +Fielding, et al. Standards Track [Page 170] + +RFC 2616 HTTP/1.1 June 1999 + + + - understand any valid request in the format of HTTP/0.9, 1.0, or + 1.1; + + - respond appropriately with a message in the same major version + used by the client. + + And we would expect HTTP/1.1 clients to: + + - recognize the format of the Status-Line for HTTP/1.0 and 1.1 + responses; + + - understand any valid response in the format of HTTP/0.9, 1.0, or + 1.1. + + For most implementations of HTTP/1.0, each connection is established + by the client prior to the request and closed by the server after + sending the response. Some implementations implement the Keep-Alive + version of persistent connections described in section 19.7.1 of RFC + 2068 [33]. + +19.6.1 Changes from HTTP/1.0 + + This section summarizes major differences between versions HTTP/1.0 + and HTTP/1.1. + +19.6.1.1 Changes to Simplify Multi-homed Web Servers and Conserve IP + Addresses + + The requirements that clients and servers support the Host request- + header, report an error if the Host request-header (section 14.23) is + missing from an HTTP/1.1 request, and accept absolute URIs (section + 5.1.2) are among the most important changes defined by this + specification. + + Older HTTP/1.0 clients assumed a one-to-one relationship of IP + addresses and servers; there was no other established mechanism for + distinguishing the intended server of a request than the IP address + to which that request was directed. The changes outlined above will + allow the Internet, once older HTTP clients are no longer common, to + support multiple Web sites from a single IP address, greatly + simplifying large operational Web servers, where allocation of many + IP addresses to a single host has created serious problems. The + Internet will also be able to recover the IP addresses that have been + allocated for the sole purpose of allowing special-purpose domain + names to be used in root-level HTTP URLs. Given the rate of growth of + the Web, and the number of servers already deployed, it is extremely + + + + + +Fielding, et al. Standards Track [Page 171] + +RFC 2616 HTTP/1.1 June 1999 + + + important that all implementations of HTTP (including updates to + existing HTTP/1.0 applications) correctly implement these + requirements: + + - Both clients and servers MUST support the Host request-header. + + - A client that sends an HTTP/1.1 request MUST send a Host header. + + - Servers MUST report a 400 (Bad Request) error if an HTTP/1.1 + request does not include a Host request-header. + + - Servers MUST accept absolute URIs. + +19.6.2 Compatibility with HTTP/1.0 Persistent Connections + + Some clients and servers might wish to be compatible with some + previous implementations of persistent connections in HTTP/1.0 + clients and servers. Persistent connections in HTTP/1.0 are + explicitly negotiated as they are not the default behavior. HTTP/1.0 + experimental implementations of persistent connections are faulty, + and the new facilities in HTTP/1.1 are designed to rectify these + problems. The problem was that some existing 1.0 clients may be + sending Keep-Alive to a proxy server that doesn't understand + Connection, which would then erroneously forward it to the next + inbound server, which would establish the Keep-Alive connection and + result in a hung HTTP/1.0 proxy waiting for the close on the + response. The result is that HTTP/1.0 clients must be prevented from + using Keep-Alive when talking to proxies. + + However, talking to proxies is the most important use of persistent + connections, so that prohibition is clearly unacceptable. Therefore, + we need some other mechanism for indicating a persistent connection + is desired, which is safe to use even when talking to an old proxy + that ignores Connection. Persistent connections are the default for + HTTP/1.1 messages; we introduce a new keyword (Connection: close) for + declaring non-persistence. See section 14.10. + + The original HTTP/1.0 form of persistent connections (the Connection: + Keep-Alive and Keep-Alive header) is documented in RFC 2068. [33] + +19.6.3 Changes from RFC 2068 + + This specification has been carefully audited to correct and + disambiguate key word usage; RFC 2068 had many problems in respect to + the conventions laid out in RFC 2119 [34]. + + Clarified which error code should be used for inbound server failures + (e.g. DNS failures). (Section 10.5.5). + + + +Fielding, et al. Standards Track [Page 172] + +RFC 2616 HTTP/1.1 June 1999 + + + CREATE had a race that required an Etag be sent when a resource is + first created. (Section 10.2.2). + + Content-Base was deleted from the specification: it was not + implemented widely, and there is no simple, safe way to introduce it + without a robust extension mechanism. In addition, it is used in a + similar, but not identical fashion in MHTML [45]. + + Transfer-coding and message lengths all interact in ways that + required fixing exactly when chunked encoding is used (to allow for + transfer encoding that may not be self delimiting); it was important + to straighten out exactly how message lengths are computed. (Sections + 3.6, 4.4, 7.2.2, 13.5.2, 14.13, 14.16) + + A content-coding of "identity" was introduced, to solve problems + discovered in caching. (section 3.5) + + Quality Values of zero should indicate that "I don't want something" + to allow clients to refuse a representation. (Section 3.9) + + The use and interpretation of HTTP version numbers has been clarified + by RFC 2145. Require proxies to upgrade requests to highest protocol + version they support to deal with problems discovered in HTTP/1.0 + implementations (Section 3.1) + + Charset wildcarding is introduced to avoid explosion of character set + names in accept headers. (Section 14.2) + + A case was missed in the Cache-Control model of HTTP/1.1; s-maxage + was introduced to add this missing case. (Sections 13.4, 14.8, 14.9, + 14.9.3) + + The Cache-Control: max-age directive was not properly defined for + responses. (Section 14.9.3) + + There are situations where a server (especially a proxy) does not + know the full length of a response but is capable of serving a + byterange request. We therefore need a mechanism to allow byteranges + with a content-range not indicating the full length of the message. + (Section 14.16) + + Range request responses would become very verbose if all meta-data + were always returned; by allowing the server to only send needed + headers in a 206 response, this problem can be avoided. (Section + 10.2.7, 13.5.3, and 14.27) + + + + + + +Fielding, et al. Standards Track [Page 173] + +RFC 2616 HTTP/1.1 June 1999 + + + Fix problem with unsatisfiable range requests; there are two cases: + syntactic problems, and range doesn't exist in the document. The 416 + status code was needed to resolve this ambiguity needed to indicate + an error for a byte range request that falls outside of the actual + contents of a document. (Section 10.4.17, 14.16) + + Rewrite of message transmission requirements to make it much harder + for implementors to get it wrong, as the consequences of errors here + can have significant impact on the Internet, and to deal with the + following problems: + + 1. Changing "HTTP/1.1 or later" to "HTTP/1.1", in contexts where + this was incorrectly placing a requirement on the behavior of + an implementation of a future version of HTTP/1.x + + 2. Made it clear that user-agents should retry requests, not + "clients" in general. + + 3. Converted requirements for clients to ignore unexpected 100 + (Continue) responses, and for proxies to forward 100 responses, + into a general requirement for 1xx responses. + + 4. Modified some TCP-specific language, to make it clearer that + non-TCP transports are possible for HTTP. + + 5. Require that the origin server MUST NOT wait for the request + body before it sends a required 100 (Continue) response. + + 6. Allow, rather than require, a server to omit 100 (Continue) if + it has already seen some of the request body. + + 7. Allow servers to defend against denial-of-service attacks and + broken clients. + + This change adds the Expect header and 417 status code. The message + transmission requirements fixes are in sections 8.2, 10.4.18, + 8.1.2.2, 13.11, and 14.20. + + Proxies should be able to add Content-Length when appropriate. + (Section 13.5.2) + + Clean up confusion between 403 and 404 responses. (Section 10.4.4, + 10.4.5, and 10.4.11) + + Warnings could be cached incorrectly, or not updated appropriately. + (Section 13.1.2, 13.2.4, 13.5.2, 13.5.3, 14.9.3, and 14.46) Warning + also needed to be a general header, as PUT or other methods may have + need for it in requests. + + + +Fielding, et al. Standards Track [Page 174] + +RFC 2616 HTTP/1.1 June 1999 + + + Transfer-coding had significant problems, particularly with + interactions with chunked encoding. The solution is that transfer- + codings become as full fledged as content-codings. This involves + adding an IANA registry for transfer-codings (separate from content + codings), a new header field (TE) and enabling trailer headers in the + future. Transfer encoding is a major performance benefit, so it was + worth fixing [39]. TE also solves another, obscure, downward + interoperability problem that could have occurred due to interactions + between authentication trailers, chunked encoding and HTTP/1.0 + clients.(Section 3.6, 3.6.1, and 14.39) + + The PATCH, LINK, UNLINK methods were defined but not commonly + implemented in previous versions of this specification. See RFC 2068 + [33]. + + The Alternates, Content-Version, Derived-From, Link, URI, Public and + Content-Base header fields were defined in previous versions of this + specification, but not commonly implemented. See RFC 2068 [33]. + +20 Index + + Please see the PostScript version of this RFC for the INDEX. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 175] + +RFC 2616 HTTP/1.1 June 1999 + + +21. Full Copyright Statement + + Copyright (C) The Internet Society (1999). All Rights Reserved. + + This document and translations of it may be copied and furnished to + others, and derivative works that comment on or otherwise explain it + or assist in its implementation may be prepared, copied, published + and distributed, in whole or in part, without restriction of any + kind, provided that the above copyright notice and this paragraph are + included on all such copies and derivative works. However, this + document itself may not be modified in any way, such as by removing + the copyright notice or references to the Internet Society or other + Internet organizations, except as needed for the purpose of + developing Internet standards in which case the procedures for + copyrights defined in the Internet Standards process must be + followed, or as required to translate it into languages other than + English. + + The limited permissions granted above are perpetual and will not be + revoked by the Internet Society or its successors or assigns. + + This document and the information contained herein is provided on an + "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING + TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING + BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION + HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF + MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + +Acknowledgement + + Funding for the RFC Editor function is currently provided by the + Internet Society. + + Network Working Group R. Fielding +Request for Comments: 2616 UC Irvine +Obsoletes: 2068 J. Gettys +Category: Standards Track Compaq/W3C + J. Mogul + Compaq + H. Frystyk + W3C/MIT + L. Masinter + Xerox + P. Leach + Microsoft + T. Berners-Lee + W3C/MIT + June 1999 + + + Hypertext Transfer Protocol -- HTTP/1.1 + +Status of this Memo + + This document specifies an Internet standards track protocol for the + Internet community, and requests discussion and suggestions for + improvements. Please refer to the current edition of the "Internet + Official Protocol Standards" (STD 1) for the standardization state + and status of this protocol. Distribution of this memo is unlimited. + +Copyright Notice + + Copyright (C) The Internet Society (1999). All Rights Reserved. + +Abstract + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. It is a generic, stateless, protocol which can be used for + many tasks beyond its use for hypertext, such as name servers and + distributed object management systems, through extension of its + request methods, error codes and headers [47]. A feature of HTTP is + the typing and negotiation of data representation, allowing systems + to be built independently of the data being transferred. + + HTTP has been in use by the World-Wide Web global information + initiative since 1990. This specification defines the protocol + referred to as "HTTP/1.1", and is an update to RFC 2068 [33]. + + + + + + +Fielding, et al. Standards Track [Page 1] + +RFC 2616 HTTP/1.1 June 1999 + + +Table of Contents + + 1 Introduction ...................................................7 + 1.1 Purpose......................................................7 + 1.2 Requirements .................................................8 + 1.3 Terminology ..................................................8 + 1.4 Overall Operation ...........................................12 + 2 Notational Conventions and Generic Grammar ....................14 + 2.1 Augmented BNF ...............................................14 + 2.2 Basic Rules .................................................15 + 3 Protocol Parameters ...........................................17 + 3.1 HTTP Version ................................................17 + 3.2 Uniform Resource Identifiers ................................18 + 3.2.1 General Syntax ...........................................19 + 3.2.2 http URL .................................................19 + 3.2.3 URI Comparison ...........................................20 + 3.3 Date/Time Formats ...........................................20 + 3.3.1 Full Date ................................................20 + 3.3.2 Delta Seconds ............................................21 + 3.4 Character Sets ..............................................21 + 3.4.1 Missing Charset ..........................................22 + 3.5 Content Codings .............................................23 + 3.6 Transfer Codings ............................................24 + 3.6.1 Chunked Transfer Coding ..................................25 + 3.7 Media Types .................................................26 + 3.7.1 Canonicalization and Text Defaults .......................27 + 3.7.2 Multipart Types ..........................................27 + 3.8 Product Tokens ..............................................28 + 3.9 Quality Values ..............................................29 + 3.10 Language Tags ...............................................29 + 3.11 Entity Tags .................................................30 + 3.12 Range Units .................................................30 + 4 HTTP Message ..................................................31 + 4.1 Message Types ...............................................31 + 4.2 Message Headers .............................................31 + 4.3 Message Body ................................................32 + 4.4 Message Length ..............................................33 + 4.5 General Header Fields .......................................34 + 5 Request .......................................................35 + 5.1 Request-Line ................................................35 + 5.1.1 Method ...................................................36 + 5.1.2 Request-URI ..............................................36 + 5.2 The Resource Identified by a Request ........................38 + 5.3 Request Header Fields .......................................38 + 6 Response ......................................................39 + 6.1 Status-Line .................................................39 + 6.1.1 Status Code and Reason Phrase ............................39 + 6.2 Response Header Fields ......................................41 + + + +Fielding, et al. Standards Track [Page 2] + +RFC 2616 HTTP/1.1 June 1999 + + + 7 Entity ........................................................42 + 7.1 Entity Header Fields ........................................42 + 7.2 Entity Body .................................................43 + 7.2.1 Type .....................................................43 + 7.2.2 Entity Length ............................................43 + 8 Connections ...................................................44 + 8.1 Persistent Connections ......................................44 + 8.1.1 Purpose ..................................................44 + 8.1.2 Overall Operation ........................................45 + 8.1.3 Proxy Servers ............................................46 + 8.1.4 Practical Considerations .................................46 + 8.2 Message Transmission Requirements ...........................47 + 8.2.1 Persistent Connections and Flow Control ..................47 + 8.2.2 Monitoring Connections for Error Status Messages .........48 + 8.2.3 Use of the 100 (Continue) Status .........................48 + 8.2.4 Client Behavior if Server Prematurely Closes Connection ..50 + 9 Method Definitions ............................................51 + 9.1 Safe and Idempotent Methods .................................51 + 9.1.1 Safe Methods .............................................51 + 9.1.2 Idempotent Methods .......................................51 + 9.2 OPTIONS .....................................................52 + 9.3 GET .........................................................53 + 9.4 HEAD ........................................................54 + 9.5 POST ........................................................54 + 9.6 PUT .........................................................55 + 9.7 DELETE ......................................................56 + 9.8 TRACE .......................................................56 + 9.9 CONNECT .....................................................57 + 10 Status Code Definitions ......................................57 + 10.1 Informational 1xx ...........................................57 + 10.1.1 100 Continue .............................................58 + 10.1.2 101 Switching Protocols ..................................58 + 10.2 Successful 2xx ..............................................58 + 10.2.1 200 OK ...................................................58 + 10.2.2 201 Created ..............................................59 + 10.2.3 202 Accepted .............................................59 + 10.2.4 203 Non-Authoritative Information ........................59 + 10.2.5 204 No Content ...........................................60 + 10.2.6 205 Reset Content ........................................60 + 10.2.7 206 Partial Content ......................................60 + 10.3 Redirection 3xx .............................................61 + 10.3.1 300 Multiple Choices .....................................61 + 10.3.2 301 Moved Permanently ....................................62 + 10.3.3 302 Found ................................................62 + 10.3.4 303 See Other ............................................63 + 10.3.5 304 Not Modified .........................................63 + 10.3.6 305 Use Proxy ............................................64 + 10.3.7 306 (Unused) .............................................64 + + + +Fielding, et al. Standards Track [Page 3] + +RFC 2616 HTTP/1.1 June 1999 + + + 10.3.8 307 Temporary Redirect ...................................65 + 10.4 Client Error 4xx ............................................65 + 10.4.1 400 Bad Request .........................................65 + 10.4.2 401 Unauthorized ........................................66 + 10.4.3 402 Payment Required ....................................66 + 10.4.4 403 Forbidden ...........................................66 + 10.4.5 404 Not Found ...........................................66 + 10.4.6 405 Method Not Allowed ..................................66 + 10.4.7 406 Not Acceptable ......................................67 + 10.4.8 407 Proxy Authentication Required .......................67 + 10.4.9 408 Request Timeout .....................................67 + 10.4.10 409 Conflict ............................................67 + 10.4.11 410 Gone ................................................68 + 10.4.12 411 Length Required .....................................68 + 10.4.13 412 Precondition Failed .................................68 + 10.4.14 413 Request Entity Too Large ............................69 + 10.4.15 414 Request-URI Too Long ................................69 + 10.4.16 415 Unsupported Media Type ..............................69 + 10.4.17 416 Requested Range Not Satisfiable .....................69 + 10.4.18 417 Expectation Failed ..................................70 + 10.5 Server Error 5xx ............................................70 + 10.5.1 500 Internal Server Error ................................70 + 10.5.2 501 Not Implemented ......................................70 + 10.5.3 502 Bad Gateway ..........................................70 + 10.5.4 503 Service Unavailable ..................................70 + 10.5.5 504 Gateway Timeout ......................................71 + 10.5.6 505 HTTP Version Not Supported ...........................71 + 11 Access Authentication ........................................71 + 12 Content Negotiation ..........................................71 + 12.1 Server-driven Negotiation ...................................72 + 12.2 Agent-driven Negotiation ....................................73 + 12.3 Transparent Negotiation .....................................74 + 13 Caching in HTTP ..............................................74 + 13.1.1 Cache Correctness ........................................75 + 13.1.2 Warnings .................................................76 + 13.1.3 Cache-control Mechanisms .................................77 + 13.1.4 Explicit User Agent Warnings .............................78 + 13.1.5 Exceptions to the Rules and Warnings .....................78 + 13.1.6 Client-controlled Behavior ...............................79 + 13.2 Expiration Model ............................................79 + 13.2.1 Server-Specified Expiration ..............................79 + 13.2.2 Heuristic Expiration .....................................80 + 13.2.3 Age Calculations .........................................80 + 13.2.4 Expiration Calculations ..................................83 + 13.2.5 Disambiguating Expiration Values .........................84 + 13.2.6 Disambiguating Multiple Responses ........................84 + 13.3 Validation Model ............................................85 + 13.3.1 Last-Modified Dates ......................................86 + + + +Fielding, et al. Standards Track [Page 4] + +RFC 2616 HTTP/1.1 June 1999 + + + 13.3.2 Entity Tag Cache Validators ..............................86 + 13.3.3 Weak and Strong Validators ...............................86 + 13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates.89 + 13.3.5 Non-validating Conditionals ..............................90 + 13.4 Response Cacheability .......................................91 + 13.5 Constructing Responses From Caches ..........................92 + 13.5.1 End-to-end and Hop-by-hop Headers ........................92 + 13.5.2 Non-modifiable Headers ...................................92 + 13.5.3 Combining Headers ........................................94 + 13.5.4 Combining Byte Ranges ....................................95 + 13.6 Caching Negotiated Responses ................................95 + 13.7 Shared and Non-Shared Caches ................................96 + 13.8 Errors or Incomplete Response Cache Behavior ................97 + 13.9 Side Effects of GET and HEAD ................................97 + 13.10 Invalidation After Updates or Deletions ...................97 + 13.11 Write-Through Mandatory ...................................98 + 13.12 Cache Replacement .........................................99 + 13.13 History Lists .............................................99 + 14 Header Field Definitions ....................................100 + 14.1 Accept .....................................................100 + 14.2 Accept-Charset .............................................102 + 14.3 Accept-Encoding ............................................102 + 14.4 Accept-Language ............................................104 + 14.5 Accept-Ranges ..............................................105 + 14.6 Age ........................................................106 + 14.7 Allow ......................................................106 + 14.8 Authorization ..............................................107 + 14.9 Cache-Control ..............................................108 + 14.9.1 What is Cacheable .......................................109 + 14.9.2 What May be Stored by Caches ............................110 + 14.9.3 Modifications of the Basic Expiration Mechanism .........111 + 14.9.4 Cache Revalidation and Reload Controls ..................113 + 14.9.5 No-Transform Directive ..................................115 + 14.9.6 Cache Control Extensions ................................116 + 14.10 Connection ...............................................117 + 14.11 Content-Encoding .........................................118 + 14.12 Content-Language .........................................118 + 14.13 Content-Length ...........................................119 + 14.14 Content-Location .........................................120 + 14.15 Content-MD5 ..............................................121 + 14.16 Content-Range ............................................122 + 14.17 Content-Type .............................................124 + 14.18 Date .....................................................124 + 14.18.1 Clockless Origin Server Operation ......................125 + 14.19 ETag .....................................................126 + 14.20 Expect ...................................................126 + 14.21 Expires ..................................................127 + 14.22 From .....................................................128 + + + +Fielding, et al. Standards Track [Page 5] + +RFC 2616 HTTP/1.1 June 1999 + + + 14.23 Host .....................................................128 + 14.24 If-Match .................................................129 + 14.25 If-Modified-Since ........................................130 + 14.26 If-None-Match ............................................132 + 14.27 If-Range .................................................133 + 14.28 If-Unmodified-Since ......................................134 + 14.29 Last-Modified ............................................134 + 14.30 Location .................................................135 + 14.31 Max-Forwards .............................................136 + 14.32 Pragma ...................................................136 + 14.33 Proxy-Authenticate .......................................137 + 14.34 Proxy-Authorization ......................................137 + 14.35 Range ....................................................138 + 14.35.1 Byte Ranges ...........................................138 + 14.35.2 Range Retrieval Requests ..............................139 + 14.36 Referer ..................................................140 + 14.37 Retry-After ..............................................141 + 14.38 Server ...................................................141 + 14.39 TE .......................................................142 + 14.40 Trailer ..................................................143 + 14.41 Transfer-Encoding..........................................143 + 14.42 Upgrade ..................................................144 + 14.43 User-Agent ...............................................145 + 14.44 Vary .....................................................145 + 14.45 Via ......................................................146 + 14.46 Warning ..................................................148 + 14.47 WWW-Authenticate .........................................150 + 15 Security Considerations .......................................150 + 15.1 Personal Information....................................151 + 15.1.1 Abuse of Server Log Information .........................151 + 15.1.2 Transfer of Sensitive Information .......................151 + 15.1.3 Encoding Sensitive Information in URI's .................152 + 15.1.4 Privacy Issues Connected to Accept Headers ..............152 + 15.2 Attacks Based On File and Path Names .......................153 + 15.3 DNS Spoofing ...............................................154 + 15.4 Location Headers and Spoofing ..............................154 + 15.5 Content-Disposition Issues .................................154 + 15.6 Authentication Credentials and Idle Clients ................155 + 15.7 Proxies and Caching ........................................155 + 15.7.1 Denial of Service Attacks on Proxies....................156 + 16 Acknowledgments .............................................156 + 17 References ..................................................158 + 18 Authors' Addresses ..........................................162 + 19 Appendices ..................................................164 + 19.1 Internet Media Type message/http and application/http ......164 + 19.2 Internet Media Type multipart/byteranges ...................165 + 19.3 Tolerant Applications ......................................166 + 19.4 Differences Between HTTP Entities and RFC 2045 Entities ....167 + + + +Fielding, et al. Standards Track [Page 6] + +RFC 2616 HTTP/1.1 June 1999 + + + 19.4.1 MIME-Version ............................................167 + 19.4.2 Conversion to Canonical Form ............................167 + 19.4.3 Conversion of Date Formats ..............................168 + 19.4.4 Introduction of Content-Encoding ........................168 + 19.4.5 No Content-Transfer-Encoding ............................168 + 19.4.6 Introduction of Transfer-Encoding .......................169 + 19.4.7 MHTML and Line Length Limitations .......................169 + 19.5 Additional Features ........................................169 + 19.5.1 Content-Disposition .....................................170 + 19.6 Compatibility with Previous Versions .......................170 + 19.6.1 Changes from HTTP/1.0 ...................................171 + 19.6.2 Compatibility with HTTP/1.0 Persistent Connections ......172 + 19.6.3 Changes from RFC 2068 ...................................172 + 20 Index .......................................................175 + 21 Full Copyright Statement ....................................176 + +1 Introduction + +1.1 Purpose + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. HTTP has been in use by the World-Wide Web global + information initiative since 1990. The first version of HTTP, + referred to as HTTP/0.9, was a simple protocol for raw data transfer + across the Internet. HTTP/1.0, as defined by RFC 1945 [6], improved + the protocol by allowing messages to be in the format of MIME-like + messages, containing metainformation about the data transferred and + modifiers on the request/response semantics. However, HTTP/1.0 does + not sufficiently take into consideration the effects of hierarchical + proxies, caching, the need for persistent connections, or virtual + hosts. In addition, the proliferation of incompletely-implemented + applications calling themselves "HTTP/1.0" has necessitated a + protocol version change in order for two communicating applications + to determine each other's true capabilities. + + This specification defines the protocol referred to as "HTTP/1.1". + This protocol includes more stringent requirements than HTTP/1.0 in + order to ensure reliable implementation of its features. + + Practical information systems require more functionality than simple + retrieval, including search, front-end update, and annotation. HTTP + allows an open-ended set of methods and headers that indicate the + purpose of a request [47]. It builds on the discipline of reference + provided by the Uniform Resource Identifier (URI) [3], as a location + (URL) [4] or name (URN) [20], for indicating the resource to which a + + + + + +Fielding, et al. Standards Track [Page 7] + +RFC 2616 HTTP/1.1 June 1999 + + + method is to be applied. Messages are passed in a format similar to + that used by Internet mail [9] as defined by the Multipurpose + Internet Mail Extensions (MIME) [7]. + + HTTP is also used as a generic protocol for communication between + user agents and proxies/gateways to other Internet systems, including + those supported by the SMTP [16], NNTP [13], FTP [18], Gopher [2], + and WAIS [10] protocols. In this way, HTTP allows basic hypermedia + access to resources available from diverse applications. + +1.2 Requirements + + The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", + "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this + document are to be interpreted as described in RFC 2119 [34]. + + An implementation is not compliant if it fails to satisfy one or more + of the MUST or REQUIRED level requirements for the protocols it + implements. An implementation that satisfies all the MUST or REQUIRED + level and all the SHOULD level requirements for its protocols is said + to be "unconditionally compliant"; one that satisfies all the MUST + level requirements but not all the SHOULD level requirements for its + protocols is said to be "conditionally compliant." + +1.3 Terminology + + This specification uses a number of terms to refer to the roles + played by participants in, and objects of, the HTTP communication. + + connection + A transport layer virtual circuit established between two programs + for the purpose of communication. + + message + The basic unit of HTTP communication, consisting of a structured + sequence of octets matching the syntax defined in section 4 and + transmitted via the connection. + + request + An HTTP request message, as defined in section 5. + + response + An HTTP response message, as defined in section 6. + + + + + + + + +Fielding, et al. Standards Track [Page 8] + +RFC 2616 HTTP/1.1 June 1999 + + + resource + A network data object or service that can be identified by a URI, + as defined in section 3.2. Resources may be available in multiple + representations (e.g. multiple languages, data formats, size, and + resolutions) or vary in other ways. + + entity + The information transferred as the payload of a request or + response. An entity consists of metainformation in the form of + entity-header fields and content in the form of an entity-body, as + described in section 7. + + representation + An entity included with a response that is subject to content + negotiation, as described in section 12. There may exist multiple + representations associated with a particular response status. + + content negotiation + The mechanism for selecting the appropriate representation when + servicing a request, as described in section 12. The + representation of entities in any response can be negotiated + (including error responses). + + variant + A resource may have one, or more than one, representation(s) + associated with it at any given instant. Each of these + representations is termed a `varriant'. Use of the term `variant' + does not necessarily imply that the resource is subject to content + negotiation. + + client + A program that establishes connections for the purpose of sending + requests. + + user agent + The client which initiates a request. These are often browsers, + editors, spiders (web-traversing robots), or other end user tools. + + server + An application program that accepts connections in order to + service requests by sending back responses. Any given program may + be capable of being both a client and a server; our use of these + terms refers only to the role being performed by the program for a + particular connection, rather than to the program's capabilities + in general. Likewise, any server may act as an origin server, + proxy, gateway, or tunnel, switching behavior based on the nature + of each request. + + + + +Fielding, et al. Standards Track [Page 9] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server + The server on which a given resource resides or is to be created. + + proxy + An intermediary program which acts as both a server and a client + for the purpose of making requests on behalf of other clients. + Requests are serviced internally or by passing them on, with + possible translation, to other servers. A proxy MUST implement + both the client and server requirements of this specification. A + "transparent proxy" is a proxy that does not modify the request or + response beyond what is required for proxy authentication and + identification. A "non-transparent proxy" is a proxy that modifies + the request or response in order to provide some added service to + the user agent, such as group annotation services, media type + transformation, protocol reduction, or anonymity filtering. Except + where either transparent or non-transparent behavior is explicitly + stated, the HTTP proxy requirements apply to both types of + proxies. + + gateway + A server which acts as an intermediary for some other server. + Unlike a proxy, a gateway receives requests as if it were the + origin server for the requested resource; the requesting client + may not be aware that it is communicating with a gateway. + + tunnel + An intermediary program which is acting as a blind relay between + two connections. Once active, a tunnel is not considered a party + to the HTTP communication, though the tunnel may have been + initiated by an HTTP request. The tunnel ceases to exist when both + ends of the relayed connections are closed. + + cache + A program's local store of response messages and the subsystem + that controls its message storage, retrieval, and deletion. A + cache stores cacheable responses in order to reduce the response + time and network bandwidth consumption on future, equivalent + requests. Any client or server may include a cache, though a cache + cannot be used by a server that is acting as a tunnel. + + cacheable + A response is cacheable if a cache is allowed to store a copy of + the response message for use in answering subsequent requests. The + rules for determining the cacheability of HTTP responses are + defined in section 13. Even if a resource is cacheable, there may + be additional constraints on whether a cache can use the cached + copy for a particular request. + + + + +Fielding, et al. Standards Track [Page 10] + +RFC 2616 HTTP/1.1 June 1999 + + + first-hand + A response is first-hand if it comes directly and without + unnecessary delay from the origin server, perhaps via one or more + proxies. A response is also first-hand if its validity has just + been checked directly with the origin server. + + explicit expiration time + The time at which the origin server intends that an entity should + no longer be returned by a cache without further validation. + + heuristic expiration time + An expiration time assigned by a cache when no explicit expiration + time is available. + + age + The age of a response is the time since it was sent by, or + successfully validated with, the origin server. + + freshness lifetime + The length of time between the generation of a response and its + expiration time. + + fresh + A response is fresh if its age has not yet exceeded its freshness + lifetime. + + stale + A response is stale if its age has passed its freshness lifetime. + + semantically transparent + A cache behaves in a "semantically transparent" manner, with + respect to a particular response, when its use affects neither the + requesting client nor the origin server, except to improve + performance. When a cache is semantically transparent, the client + receives exactly the same response (except for hop-by-hop headers) + that it would have received had its request been handled directly + by the origin server. + + validator + A protocol element (e.g., an entity tag or a Last-Modified time) + that is used to find out whether a cache entry is an equivalent + copy of an entity. + + upstream/downstream + Upstream and downstream describe the flow of a message: all + messages flow from upstream to downstream. + + + + + +Fielding, et al. Standards Track [Page 11] + +RFC 2616 HTTP/1.1 June 1999 + + + inbound/outbound + Inbound and outbound refer to the request and response paths for + messages: "inbound" means "traveling toward the origin server", + and "outbound" means "traveling toward the user agent" + +1.4 Overall Operation + + The HTTP protocol is a request/response protocol. A client sends a + request to the server in the form of a request method, URI, and + protocol version, followed by a MIME-like message containing request + modifiers, client information, and possible body content over a + connection with a server. The server responds with a status line, + including the message's protocol version and a success or error code, + followed by a MIME-like message containing server information, entity + metainformation, and possible entity-body content. The relationship + between HTTP and MIME is described in appendix 19.4. + + Most HTTP communication is initiated by a user agent and consists of + a request to be applied to a resource on some origin server. In the + simplest case, this may be accomplished via a single connection (v) + between the user agent (UA) and the origin server (O). + + request chain ------------------------> + UA -------------------v------------------- O + <----------------------- response chain + + A more complicated situation occurs when one or more intermediaries + are present in the request/response chain. There are three common + forms of intermediary: proxy, gateway, and tunnel. A proxy is a + forwarding agent, receiving requests for a URI in its absolute form, + rewriting all or part of the message, and forwarding the reformatted + request toward the server identified by the URI. A gateway is a + receiving agent, acting as a layer above some other server(s) and, if + necessary, translating the requests to the underlying server's + protocol. A tunnel acts as a relay point between two connections + without changing the messages; tunnels are used when the + communication needs to pass through an intermediary (such as a + firewall) even when the intermediary cannot understand the contents + of the messages. + + request chain --------------------------------------> + UA -----v----- A -----v----- B -----v----- C -----v----- O + <------------------------------------- response chain + + The figure above shows three intermediaries (A, B, and C) between the + user agent and origin server. A request or response message that + travels the whole chain will pass through four separate connections. + This distinction is important because some HTTP communication options + + + +Fielding, et al. Standards Track [Page 12] + +RFC 2616 HTTP/1.1 June 1999 + + + may apply only to the connection with the nearest, non-tunnel + neighbor, only to the end-points of the chain, or to all connections + along the chain. Although the diagram is linear, each participant may + be engaged in multiple, simultaneous communications. For example, B + may be receiving requests from many clients other than A, and/or + forwarding requests to servers other than C, at the same time that it + is handling A's request. + + Any party to the communication which is not acting as a tunnel may + employ an internal cache for handling requests. The effect of a cache + is that the request/response chain is shortened if one of the + participants along the chain has a cached response applicable to that + request. The following illustrates the resulting chain if B has a + cached copy of an earlier response from O (via C) for a request which + has not been cached by UA or A. + + request chain ----------> + UA -----v----- A -----v----- B - - - - - - C - - - - - - O + <--------- response chain + + Not all responses are usefully cacheable, and some requests may + contain modifiers which place special requirements on cache behavior. + HTTP requirements for cache behavior and cacheable responses are + defined in section 13. + + In fact, there are a wide variety of architectures and configurations + of caches and proxies currently being experimented with or deployed + across the World Wide Web. These systems include national hierarchies + of proxy caches to save transoceanic bandwidth, systems that + broadcast or multicast cache entries, organizations that distribute + subsets of cached data via CD-ROM, and so on. HTTP systems are used + in corporate intranets over high-bandwidth links, and for access via + PDAs with low-power radio links and intermittent connectivity. The + goal of HTTP/1.1 is to support the wide diversity of configurations + already deployed while introducing protocol constructs that meet the + needs of those who build web applications that require high + reliability and, failing that, at least reliable indications of + failure. + + HTTP communication usually takes place over TCP/IP connections. The + default port is TCP 80 [19], but other ports can be used. This does + not preclude HTTP from being implemented on top of any other protocol + on the Internet, or on other networks. HTTP only presumes a reliable + transport; any protocol that provides such guarantees can be used; + the mapping of the HTTP/1.1 request and response structures onto the + transport data units of the protocol in question is outside the scope + of this specification. + + + + +Fielding, et al. Standards Track [Page 13] + +RFC 2616 HTTP/1.1 June 1999 + + + In HTTP/1.0, most implementations used a new connection for each + request/response exchange. In HTTP/1.1, a connection may be used for + one or more request/response exchanges, although connections may be + closed for a variety of reasons (see section 8.1). + +2 Notational Conventions and Generic Grammar + +2.1 Augmented BNF + + All of the mechanisms specified in this document are described in + both prose and an augmented Backus-Naur Form (BNF) similar to that + used by RFC 822 [9]. Implementors will need to be familiar with the + notation in order to understand this specification. The augmented BNF + includes the following constructs: + + name = definition + The name of a rule is simply the name itself (without any + enclosing "<" and ">") and is separated from its definition by the + equal "=" character. White space is only significant in that + indentation of continuation lines is used to indicate a rule + definition that spans more than one line. Certain basic rules are + in uppercase, such as SP, LWS, HT, CRLF, DIGIT, ALPHA, etc. Angle + brackets are used within definitions whenever their presence will + facilitate discerning the use of rule names. + + "literal" + Quotation marks surround literal text. Unless stated otherwise, + the text is case-insensitive. + + rule1 | rule2 + Elements separated by a bar ("|") are alternatives, e.g., "yes | + no" will accept yes or no. + + (rule1 rule2) + Elements enclosed in parentheses are treated as a single element. + Thus, "(elem (foo | bar) elem)" allows the token sequences "elem + foo elem" and "elem bar elem". + + *rule + The character "*" preceding an element indicates repetition. The + full form is "*element" indicating at least and at most + occurrences of element. Default values are 0 and infinity so + that "*(element)" allows any number, including zero; "1*element" + requires at least one; and "1*2element" allows one or two. + + [rule] + Square brackets enclose optional elements; "[foo bar]" is + equivalent to "*1(foo bar)". + + + +Fielding, et al. Standards Track [Page 14] + +RFC 2616 HTTP/1.1 June 1999 + + + N rule + Specific repetition: "(element)" is equivalent to + "*(element)"; that is, exactly occurrences of (element). + Thus 2DIGIT is a 2-digit number, and 3ALPHA is a string of three + alphabetic characters. + + #rule + A construct "#" is defined, similar to "*", for defining lists of + elements. The full form is "#element" indicating at least + and at most elements, each separated by one or more commas + (",") and OPTIONAL linear white space (LWS). This makes the usual + form of lists very easy; a rule such as + ( *LWS element *( *LWS "," *LWS element )) + can be shown as + 1#element + Wherever this construct is used, null elements are allowed, but do + not contribute to the count of elements present. That is, + "(element), , (element) " is permitted, but counts as only two + elements. Therefore, where at least one element is required, at + least one non-null element MUST be present. Default values are 0 + and infinity so that "#element" allows any number, including zero; + "1#element" requires at least one; and "1#2element" allows one or + two. + + ; comment + A semi-colon, set off some distance to the right of rule text, + starts a comment that continues to the end of line. This is a + simple way of including useful notes in parallel with the + specifications. + + implied *LWS + The grammar described by this specification is word-based. Except + where noted otherwise, linear white space (LWS) can be included + between any two adjacent words (token or quoted-string), and + between adjacent words and separators, without changing the + interpretation of a field. At least one delimiter (LWS and/or + + separators) MUST exist between any two tokens (for the definition + of "token" below), since they would otherwise be interpreted as a + single token. + +2.2 Basic Rules + + The following rules are used throughout this specification to + describe basic parsing constructs. The US-ASCII coded character set + is defined by ANSI X3.4-1986 [21]. + + + + + +Fielding, et al. Standards Track [Page 15] + +RFC 2616 HTTP/1.1 June 1999 + + + OCTET = + CHAR = + UPALPHA = + LOALPHA = + ALPHA = UPALPHA | LOALPHA + DIGIT = + CTL = + CR = + LF = + SP = + HT = + <"> = + + HTTP/1.1 defines the sequence CR LF as the end-of-line marker for all + protocol elements except the entity-body (see appendix 19.3 for + tolerant applications). The end-of-line marker within an entity-body + is defined by its associated media type, as described in section 3.7. + + CRLF = CR LF + + HTTP/1.1 header field values can be folded onto multiple lines if the + continuation line begins with a space or horizontal tab. All linear + white space, including folding, has the same semantics as SP. A + recipient MAY replace any linear white space with a single SP before + interpreting the field value or forwarding the message downstream. + + LWS = [CRLF] 1*( SP | HT ) + + The TEXT rule is only used for descriptive field contents and values + that are not intended to be interpreted by the message parser. Words + of *TEXT MAY contain characters from character sets other than ISO- + 8859-1 [22] only when encoded according to the rules of RFC 2047 + [14]. + + TEXT = + + A CRLF is allowed in the definition of TEXT only as part of a header + field continuation. It is expected that the folding LWS will be + replaced with a single SP before interpretation of the TEXT value. + + Hexadecimal numeric characters are used in several protocol elements. + + HEX = "A" | "B" | "C" | "D" | "E" | "F" + | "a" | "b" | "c" | "d" | "e" | "f" | DIGIT + + + + + +Fielding, et al. Standards Track [Page 16] + +RFC 2616 HTTP/1.1 June 1999 + + + Many HTTP/1.1 header field values consist of words separated by LWS + or special characters. These special characters MUST be in a quoted + string to be used within a parameter value (as defined in section + 3.6). + + token = 1* + separators = "(" | ")" | "<" | ">" | "@" + | "," | ";" | ":" | "\" | <"> + | "/" | "[" | "]" | "?" | "=" + | "{" | "}" | SP | HT + + Comments can be included in some HTTP header fields by surrounding + the comment text with parentheses. Comments are only allowed in + fields containing "comment" as part of their field value definition. + In all other fields, parentheses are considered part of the field + value. + + comment = "(" *( ctext | quoted-pair | comment ) ")" + ctext = + + A string of text is parsed as a single word if it is quoted using + double-quote marks. + + quoted-string = ( <"> *(qdtext | quoted-pair ) <"> ) + qdtext = > + + The backslash character ("\") MAY be used as a single-character + quoting mechanism only within quoted-string and comment constructs. + + quoted-pair = "\" CHAR + +3 Protocol Parameters + +3.1 HTTP Version + + HTTP uses a "." numbering scheme to indicate versions + of the protocol. The protocol versioning policy is intended to allow + the sender to indicate the format of a message and its capacity for + understanding further HTTP communication, rather than the features + obtained via that communication. No change is made to the version + number for the addition of message components which do not affect + communication behavior or which only add to extensible field values. + The number is incremented when the changes made to the + protocol add features which do not change the general message parsing + algorithm, but which may add to the message semantics and imply + additional capabilities of the sender. The number is + incremented when the format of a message within the protocol is + changed. See RFC 2145 [36] for a fuller explanation. + + + +Fielding, et al. Standards Track [Page 17] + +RFC 2616 HTTP/1.1 June 1999 + + + The version of an HTTP message is indicated by an HTTP-Version field + in the first line of the message. + + HTTP-Version = "HTTP" "/" 1*DIGIT "." 1*DIGIT + + Note that the major and minor numbers MUST be treated as separate + integers and that each MAY be incremented higher than a single digit. + Thus, HTTP/2.4 is a lower version than HTTP/2.13, which in turn is + lower than HTTP/12.3. Leading zeros MUST be ignored by recipients and + MUST NOT be sent. + + An application that sends a request or response message that includes + HTTP-Version of "HTTP/1.1" MUST be at least conditionally compliant + with this specification. Applications that are at least conditionally + compliant with this specification SHOULD use an HTTP-Version of + "HTTP/1.1" in their messages, and MUST do so for any message that is + not compatible with HTTP/1.0. For more details on when to send + specific HTTP-Version values, see RFC 2145 [36]. + + The HTTP version of an application is the highest HTTP version for + which the application is at least conditionally compliant. + + Proxy and gateway applications need to be careful when forwarding + messages in protocol versions different from that of the application. + Since the protocol version indicates the protocol capability of the + sender, a proxy/gateway MUST NOT send a message with a version + indicator which is greater than its actual version. If a higher + version request is received, the proxy/gateway MUST either downgrade + the request version, or respond with an error, or switch to tunnel + behavior. + + Due to interoperability problems with HTTP/1.0 proxies discovered + since the publication of RFC 2068[33], caching proxies MUST, gateways + MAY, and tunnels MUST NOT upgrade the request to the highest version + they support. The proxy/gateway's response to that request MUST be in + the same major version as the request. + + Note: Converting between versions of HTTP may involve modification + of header fields required or forbidden by the versions involved. + +3.2 Uniform Resource Identifiers + + URIs have been known by many names: WWW addresses, Universal Document + Identifiers, Universal Resource Identifiers [3], and finally the + combination of Uniform Resource Locators (URL) [4] and Names (URN) + [20]. As far as HTTP is concerned, Uniform Resource Identifiers are + simply formatted strings which identify--via name, location, or any + other characteristic--a resource. + + + +Fielding, et al. Standards Track [Page 18] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.1 General Syntax + + URIs in HTTP can be represented in absolute form or relative to some + known base URI [11], depending upon the context of their use. The two + forms are differentiated by the fact that absolute URIs always begin + with a scheme name followed by a colon. For definitive information on + URL syntax and semantics, see "Uniform Resource Identifiers (URI): + Generic Syntax and Semantics," RFC 2396 [42] (which replaces RFCs + 1738 [4] and RFC 1808 [11]). This specification adopts the + definitions of "URI-reference", "absoluteURI", "relativeURI", "port", + "host","abs_path", "rel_path", and "authority" from that + specification. + + The HTTP protocol does not place any a priori limit on the length of + a URI. Servers MUST be able to handle the URI of any resource they + serve, and SHOULD be able to handle URIs of unbounded length if they + provide GET-based forms that could generate such URIs. A server + SHOULD return 414 (Request-URI Too Long) status if a URI is longer + than the server can handle (see section 10.4.15). + + Note: Servers ought to be cautious about depending on URI lengths + above 255 bytes, because some older client or proxy + implementations might not properly support these lengths. + +3.2.2 http URL + + The "http" scheme is used to locate network resources via the HTTP + protocol. This section defines the scheme-specific syntax and + semantics for http URLs. + + http_URL = "http:" "//" host [ ":" port ] [ abs_path [ "?" query ]] + + If the port is empty or not given, port 80 is assumed. The semantics + are that the identified resource is located at the server listening + for TCP connections on that port of that host, and the Request-URI + for the resource is abs_path (section 5.1.2). The use of IP addresses + in URLs SHOULD be avoided whenever possible (see RFC 1900 [24]). If + the abs_path is not present in the URL, it MUST be given as "/" when + used as a Request-URI for a resource (section 5.1.2). If a proxy + receives a host name which is not a fully qualified domain name, it + MAY add its domain to the host name it received. If a proxy receives + a fully qualified domain name, the proxy MUST NOT change the host + name. + + + + + + + + +Fielding, et al. Standards Track [Page 19] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.3 URI Comparison + + When comparing two URIs to decide if they match or not, a client + SHOULD use a case-sensitive octet-by-octet comparison of the entire + URIs, with these exceptions: + + - A port that is empty or not given is equivalent to the default + port for that URI-reference; + + - Comparisons of host names MUST be case-insensitive; + + - Comparisons of scheme names MUST be case-insensitive; + + - An empty abs_path is equivalent to an abs_path of "/". + + Characters other than those in the "reserved" and "unsafe" sets (see + RFC 2396 [42]) are equivalent to their ""%" HEX HEX" encoding. + + For example, the following three URIs are equivalent: + + http://abc.com:80/~smith/home.html + http://ABC.com/%7Esmith/home.html + http://ABC.com:/%7esmith/home.html + +3.3 Date/Time Formats + +3.3.1 Full Date + + HTTP applications have historically allowed three different formats + for the representation of date/time stamps: + + Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123 + Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036 + Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format + + The first format is preferred as an Internet standard and represents + a fixed-length subset of that defined by RFC 1123 [8] (an update to + RFC 822 [9]). The second format is in common use, but is based on the + obsolete RFC 850 [12] date format and lacks a four-digit year. + HTTP/1.1 clients and servers that parse the date value MUST accept + all three formats (for compatibility with HTTP/1.0), though they MUST + only generate the RFC 1123 format for representing HTTP-date values + in header fields. See section 19.3 for further information. + + Note: Recipients of date values are encouraged to be robust in + accepting date values that may have been sent by non-HTTP + applications, as is sometimes the case when retrieving or posting + messages via proxies/gateways to SMTP or NNTP. + + + +Fielding, et al. Standards Track [Page 20] + +RFC 2616 HTTP/1.1 June 1999 + + + All HTTP date/time stamps MUST be represented in Greenwich Mean Time + (GMT), without exception. For the purposes of HTTP, GMT is exactly + equal to UTC (Coordinated Universal Time). This is indicated in the + first two formats by the inclusion of "GMT" as the three-letter + abbreviation for time zone, and MUST be assumed when reading the + asctime format. HTTP-date is case sensitive and MUST NOT include + additional LWS beyond that specifically included as SP in the + grammar. + + HTTP-date = rfc1123-date | rfc850-date | asctime-date + rfc1123-date = wkday "," SP date1 SP time SP "GMT" + rfc850-date = weekday "," SP date2 SP time SP "GMT" + asctime-date = wkday SP date3 SP time SP 4DIGIT + date1 = 2DIGIT SP month SP 4DIGIT + ; day month year (e.g., 02 Jun 1982) + date2 = 2DIGIT "-" month "-" 2DIGIT + ; day-month-year (e.g., 02-Jun-82) + date3 = month SP ( 2DIGIT | ( SP 1DIGIT )) + ; month day (e.g., Jun 2) + time = 2DIGIT ":" 2DIGIT ":" 2DIGIT + ; 00:00:00 - 23:59:59 + wkday = "Mon" | "Tue" | "Wed" + | "Thu" | "Fri" | "Sat" | "Sun" + weekday = "Monday" | "Tuesday" | "Wednesday" + | "Thursday" | "Friday" | "Saturday" | "Sunday" + month = "Jan" | "Feb" | "Mar" | "Apr" + | "May" | "Jun" | "Jul" | "Aug" + | "Sep" | "Oct" | "Nov" | "Dec" + + Note: HTTP requirements for the date/time stamp format apply only + to their usage within the protocol stream. Clients and servers are + not required to use these formats for user presentation, request + logging, etc. + +3.3.2 Delta Seconds + + Some HTTP header fields allow a time value to be specified as an + integer number of seconds, represented in decimal, after the time + that the message was received. + + delta-seconds = 1*DIGIT + +3.4 Character Sets + + HTTP uses the same definition of the term "character set" as that + described for MIME: + + + + + +Fielding, et al. Standards Track [Page 21] + +RFC 2616 HTTP/1.1 June 1999 + + + The term "character set" is used in this document to refer to a + method used with one or more tables to convert a sequence of octets + into a sequence of characters. Note that unconditional conversion in + the other direction is not required, in that not all characters may + be available in a given character set and a character set may provide + more than one sequence of octets to represent a particular character. + This definition is intended to allow various kinds of character + encoding, from simple single-table mappings such as US-ASCII to + complex table switching methods such as those that use ISO-2022's + techniques. However, the definition associated with a MIME character + set name MUST fully specify the mapping to be performed from octets + to characters. In particular, use of external profiling information + to determine the exact mapping is not permitted. + + Note: This use of the term "character set" is more commonly + referred to as a "character encoding." However, since HTTP and + MIME share the same registry, it is important that the terminology + also be shared. + + HTTP character sets are identified by case-insensitive tokens. The + complete set of tokens is defined by the IANA Character Set registry + [19]. + + charset = token + + Although HTTP allows an arbitrary token to be used as a charset + value, any token that has a predefined value within the IANA + Character Set registry [19] MUST represent the character set defined + by that registry. Applications SHOULD limit their use of character + sets to those defined by the IANA registry. + + Implementors should be aware of IETF character set requirements [38] + [41]. + +3.4.1 Missing Charset + + Some HTTP/1.0 software has interpreted a Content-Type header without + charset parameter incorrectly to mean "recipient should guess." + Senders wishing to defeat this behavior MAY include a charset + parameter even when the charset is ISO-8859-1 and SHOULD do so when + it is known that it will not confuse the recipient. + + Unfortunately, some older HTTP/1.0 clients did not deal properly with + an explicit charset parameter. HTTP/1.1 recipients MUST respect the + charset label provided by the sender; and those user agents that have + a provision to "guess" a charset MUST use the charset from the + + + + + +Fielding, et al. Standards Track [Page 22] + +RFC 2616 HTTP/1.1 June 1999 + + + content-type field if they support that charset, rather than the + recipient's preference, when initially displaying a document. See + section 3.7.1. + +3.5 Content Codings + + Content coding values indicate an encoding transformation that has + been or can be applied to an entity. Content codings are primarily + used to allow a document to be compressed or otherwise usefully + transformed without losing the identity of its underlying media type + and without loss of information. Frequently, the entity is stored in + coded form, transmitted directly, and only decoded by the recipient. + + content-coding = token + + All content-coding values are case-insensitive. HTTP/1.1 uses + content-coding values in the Accept-Encoding (section 14.3) and + Content-Encoding (section 14.11) header fields. Although the value + describes the content-coding, what is more important is that it + indicates what decoding mechanism will be required to remove the + encoding. + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + content-coding value tokens. Initially, the registry contains the + following tokens: + + gzip An encoding format produced by the file compression program + "gzip" (GNU zip) as described in RFC 1952 [25]. This format is a + Lempel-Ziv coding (LZ77) with a 32 bit CRC. + + compress + The encoding format produced by the common UNIX file compression + program "compress". This format is an adaptive Lempel-Ziv-Welch + coding (LZW). + + Use of program names for the identification of encoding formats + is not desirable and is discouraged for future encodings. Their + use here is representative of historical practice, not good + design. For compatibility with previous implementations of HTTP, + applications SHOULD consider "x-gzip" and "x-compress" to be + equivalent to "gzip" and "compress" respectively. + + deflate + The "zlib" format defined in RFC 1950 [31] in combination with + the "deflate" compression mechanism described in RFC 1951 [29]. + + + + + + +Fielding, et al. Standards Track [Page 23] + +RFC 2616 HTTP/1.1 June 1999 + + + identity + The default (identity) encoding; the use of no transformation + whatsoever. This content-coding is used only in the Accept- + Encoding header, and SHOULD NOT be used in the Content-Encoding + header. + + New content-coding value tokens SHOULD be registered; to allow + interoperability between clients and servers, specifications of the + content coding algorithms needed to implement a new value SHOULD be + publicly available and adequate for independent implementation, and + conform to the purpose of content coding defined in this section. + +3.6 Transfer Codings + + Transfer-coding values are used to indicate an encoding + transformation that has been, can be, or may need to be applied to an + entity-body in order to ensure "safe transport" through the network. + This differs from a content coding in that the transfer-coding is a + property of the message, not of the original entity. + + transfer-coding = "chunked" | transfer-extension + transfer-extension = token *( ";" parameter ) + + Parameters are in the form of attribute/value pairs. + + parameter = attribute "=" value + attribute = token + value = token | quoted-string + + All transfer-coding values are case-insensitive. HTTP/1.1 uses + transfer-coding values in the TE header field (section 14.39) and in + the Transfer-Encoding header field (section 14.41). + + Whenever a transfer-coding is applied to a message-body, the set of + transfer-codings MUST include "chunked", unless the message is + terminated by closing the connection. When the "chunked" transfer- + coding is used, it MUST be the last transfer-coding applied to the + message-body. The "chunked" transfer-coding MUST NOT be applied more + than once to a message-body. These rules allow the recipient to + determine the transfer-length of the message (section 4.4). + + Transfer-codings are analogous to the Content-Transfer-Encoding + values of MIME [7], which were designed to enable safe transport of + binary data over a 7-bit transport service. However, safe transport + has a different focus for an 8bit-clean transfer protocol. In HTTP, + the only unsafe characteristic of message-bodies is the difficulty in + determining the exact body length (section 7.2.2), or the desire to + encrypt data over a shared transport. + + + +Fielding, et al. Standards Track [Page 24] + +RFC 2616 HTTP/1.1 June 1999 + + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + transfer-coding value tokens. Initially, the registry contains the + following tokens: "chunked" (section 3.6.1), "identity" (section + 3.6.2), "gzip" (section 3.5), "compress" (section 3.5), and "deflate" + (section 3.5). + + New transfer-coding value tokens SHOULD be registered in the same way + as new content-coding value tokens (section 3.5). + + A server which receives an entity-body with a transfer-coding it does + not understand SHOULD return 501 (Unimplemented), and close the + connection. A server MUST NOT send transfer-codings to an HTTP/1.0 + client. + +3.6.1 Chunked Transfer Coding + + The chunked encoding modifies the body of a message in order to + transfer it as a series of chunks, each with its own size indicator, + followed by an OPTIONAL trailer containing entity-header fields. This + allows dynamically produced content to be transferred along with the + information necessary for the recipient to verify that it has + received the full message. + + Chunked-Body = *chunk + last-chunk + trailer + CRLF + + chunk = chunk-size [ chunk-extension ] CRLF + chunk-data CRLF + chunk-size = 1*HEX + last-chunk = 1*("0") [ chunk-extension ] CRLF + + chunk-extension= *( ";" chunk-ext-name [ "=" chunk-ext-val ] ) + chunk-ext-name = token + chunk-ext-val = token | quoted-string + chunk-data = chunk-size(OCTET) + trailer = *(entity-header CRLF) + + The chunk-size field is a string of hex digits indicating the size of + the chunk. The chunked encoding is ended by any chunk whose size is + zero, followed by the trailer, which is terminated by an empty line. + + The trailer allows the sender to include additional HTTP header + fields at the end of the message. The Trailer header field can be + used to indicate which header fields are included in a trailer (see + section 14.40). + + + + +Fielding, et al. Standards Track [Page 25] + +RFC 2616 HTTP/1.1 June 1999 + + + A server using chunked transfer-coding in a response MUST NOT use the + trailer for any header fields unless at least one of the following is + true: + + a)the request included a TE header field that indicates "trailers" is + acceptable in the transfer-coding of the response, as described in + section 14.39; or, + + b)the server is the origin server for the response, the trailer + fields consist entirely of optional metadata, and the recipient + could use the message (in a manner acceptable to the origin server) + without receiving this metadata. In other words, the origin server + is willing to accept the possibility that the trailer fields might + be silently discarded along the path to the client. + + This requirement prevents an interoperability failure when the + message is being received by an HTTP/1.1 (or later) proxy and + forwarded to an HTTP/1.0 recipient. It avoids a situation where + compliance with the protocol would have necessitated a possibly + infinite buffer on the proxy. + + An example process for decoding a Chunked-Body is presented in + appendix 19.4.6. + + All HTTP/1.1 applications MUST be able to receive and decode the + "chunked" transfer-coding, and MUST ignore chunk-extension extensions + they do not understand. + +3.7 Media Types + + HTTP uses Internet Media Types [17] in the Content-Type (section + 14.17) and Accept (section 14.1) header fields in order to provide + open and extensible data typing and type negotiation. + + media-type = type "/" subtype *( ";" parameter ) + type = token + subtype = token + + Parameters MAY follow the type/subtype in the form of attribute/value + pairs (as defined in section 3.6). + + The type, subtype, and parameter attribute names are case- + insensitive. Parameter values might or might not be case-sensitive, + depending on the semantics of the parameter name. Linear white space + (LWS) MUST NOT be used between the type and subtype, nor between an + attribute and its value. The presence or absence of a parameter might + be significant to the processing of a media-type, depending on its + definition within the media type registry. + + + +Fielding, et al. Standards Track [Page 26] + +RFC 2616 HTTP/1.1 June 1999 + + + Note that some older HTTP applications do not recognize media type + parameters. When sending data to older HTTP applications, + implementations SHOULD only use media type parameters when they are + required by that type/subtype definition. + + Media-type values are registered with the Internet Assigned Number + Authority (IANA [19]). The media type registration process is + outlined in RFC 1590 [17]. Use of non-registered media types is + discouraged. + +3.7.1 Canonicalization and Text Defaults + + Internet media types are registered with a canonical form. An + entity-body transferred via HTTP messages MUST be represented in the + appropriate canonical form prior to its transmission except for + "text" types, as defined in the next paragraph. + + When in canonical form, media subtypes of the "text" type use CRLF as + the text line break. HTTP relaxes this requirement and allows the + transport of text media with plain CR or LF alone representing a line + break when it is done consistently for an entire entity-body. HTTP + applications MUST accept CRLF, bare CR, and bare LF as being + representative of a line break in text media received via HTTP. In + addition, if the text is represented in a character set that does not + use octets 13 and 10 for CR and LF respectively, as is the case for + some multi-byte character sets, HTTP allows the use of whatever octet + sequences are defined by that character set to represent the + equivalent of CR and LF for line breaks. This flexibility regarding + line breaks applies only to text media in the entity-body; a bare CR + or LF MUST NOT be substituted for CRLF within any of the HTTP control + structures (such as header fields and multipart boundaries). + + If an entity-body is encoded with a content-coding, the underlying + data MUST be in a form defined above prior to being encoded. + + The "charset" parameter is used with some media types to define the + character set (section 3.4) of the data. When no explicit charset + parameter is provided by the sender, media subtypes of the "text" + type are defined to have a default charset value of "ISO-8859-1" when + received via HTTP. Data in character sets other than "ISO-8859-1" or + its subsets MUST be labeled with an appropriate charset value. See + section 3.4.1 for compatibility problems. + +3.7.2 Multipart Types + + MIME provides for a number of "multipart" types -- encapsulations of + one or more entities within a single message-body. All multipart + types share a common syntax, as defined in section 5.1.1 of RFC 2046 + + + +Fielding, et al. Standards Track [Page 27] + +RFC 2616 HTTP/1.1 June 1999 + + + [40], and MUST include a boundary parameter as part of the media type + value. The message body is itself a protocol element and MUST + therefore use only CRLF to represent line breaks between body-parts. + Unlike in RFC 2046, the epilogue of any multipart message MUST be + empty; HTTP applications MUST NOT transmit the epilogue (even if the + original multipart contains an epilogue). These restrictions exist in + order to preserve the self-delimiting nature of a multipart message- + body, wherein the "end" of the message-body is indicated by the + ending multipart boundary. + + In general, HTTP treats a multipart message-body no differently than + any other media type: strictly as payload. The one exception is the + "multipart/byteranges" type (appendix 19.2) when it appears in a 206 + (Partial Content) response, which will be interpreted by some HTTP + caching mechanisms as described in sections 13.5.4 and 14.16. In all + other cases, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + The MIME header fields within each body-part of a multipart message- + body do not have any significance to HTTP beyond that defined by + their MIME semantics. + + In general, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + If an application receives an unrecognized multipart subtype, the + application MUST treat it as being equivalent to "multipart/mixed". + + Note: The "multipart/form-data" type has been specifically defined + for carrying form data suitable for processing via the POST + request method, as described in RFC 1867 [15]. + +3.8 Product Tokens + + Product tokens are used to allow communicating applications to + identify themselves by software name and version. Most fields using + product tokens also allow sub-products which form a significant part + of the application to be listed, separated by white space. By + convention, the products are listed in order of their significance + for identifying the application. + + product = token ["/" product-version] + product-version = token + + Examples: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + Server: Apache/0.8.4 + + + + + +Fielding, et al. Standards Track [Page 28] + +RFC 2616 HTTP/1.1 June 1999 + + + Product tokens SHOULD be short and to the point. They MUST NOT be + used for advertising or other non-essential information. Although any + token character MAY appear in a product-version, this token SHOULD + only be used for a version identifier (i.e., successive versions of + the same product SHOULD only differ in the product-version portion of + the product value). + +3.9 Quality Values + + HTTP content negotiation (section 12) uses short "floating point" + numbers to indicate the relative importance ("weight") of various + negotiable parameters. A weight is normalized to a real number in + the range 0 through 1, where 0 is the minimum and 1 the maximum + value. If a parameter has a quality value of 0, then content with + this parameter is `not acceptable' for the client. HTTP/1.1 + applications MUST NOT generate more than three digits after the + decimal point. User configuration of these values SHOULD also be + limited in this fashion. + + qvalue = ( "0" [ "." 0*3DIGIT ] ) + | ( "1" [ "." 0*3("0") ] ) + + "Quality values" is a misnomer, since these values merely represent + relative degradation in desired quality. + +3.10 Language Tags + + A language tag identifies a natural language spoken, written, or + otherwise conveyed by human beings for communication of information + to other human beings. Computer languages are explicitly excluded. + HTTP uses language tags within the Accept-Language and Content- + Language fields. + + The syntax and registry of HTTP language tags is the same as that + defined by RFC 1766 [1]. In summary, a language tag is composed of 1 + or more parts: A primary language tag and a possibly empty series of + subtags: + + language-tag = primary-tag *( "-" subtag ) + primary-tag = 1*8ALPHA + subtag = 1*8ALPHA + + White space is not allowed within the tag and all tags are case- + insensitive. The name space of language tags is administered by the + IANA. Example tags include: + + en, en-US, en-cockney, i-cherokee, x-pig-latin + + + + +Fielding, et al. Standards Track [Page 29] + +RFC 2616 HTTP/1.1 June 1999 + + + where any two-letter primary-tag is an ISO-639 language abbreviation + and any two-letter initial subtag is an ISO-3166 country code. (The + last three tags above are not registered tags; all but the last are + examples of tags which could be registered in future.) + +3.11 Entity Tags + + Entity tags are used for comparing two or more entities from the same + requested resource. HTTP/1.1 uses entity tags in the ETag (section + 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and + If-Range (section 14.27) header fields. The definition of how they + are used and compared as cache validators is in section 13.3.3. An + entity tag consists of an opaque quoted string, possibly prefixed by + a weakness indicator. + + entity-tag = [ weak ] opaque-tag + weak = "W/" + opaque-tag = quoted-string + + A "strong entity tag" MAY be shared by two entities of a resource + only if they are equivalent by octet equality. + + A "weak entity tag," indicated by the "W/" prefix, MAY be shared by + two entities of a resource only if the entities are equivalent and + could be substituted for each other with no significant change in + semantics. A weak entity tag can only be used for weak comparison. + + An entity tag MUST be unique across all versions of all entities + associated with a particular resource. A given entity tag value MAY + be used for entities obtained by requests on different URIs. The use + of the same entity tag value in conjunction with entities obtained by + requests on different URIs does not imply the equivalence of those + entities. + +3.12 Range Units + + HTTP/1.1 allows a client to request that only part (a range of) the + response entity be included within the response. HTTP/1.1 uses range + units in the Range (section 14.35) and Content-Range (section 14.16) + header fields. An entity can be broken down into subranges according + to various structural units. + + range-unit = bytes-unit | other-range-unit + bytes-unit = "bytes" + other-range-unit = token + + The only range unit defined by HTTP/1.1 is "bytes". HTTP/1.1 + implementations MAY ignore ranges specified using other units. + + + +Fielding, et al. Standards Track [Page 30] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 has been designed to allow implementations of applications + that do not depend on knowledge of ranges. + +4 HTTP Message + +4.1 Message Types + + HTTP messages consist of requests from client to server and responses + from server to client. + + HTTP-message = Request | Response ; HTTP/1.1 messages + + Request (section 5) and Response (section 6) messages use the generic + message format of RFC 822 [9] for transferring entities (the payload + of the message). Both types of message consist of a start-line, zero + or more header fields (also known as "headers"), an empty line (i.e., + a line with nothing preceding the CRLF) indicating the end of the + header fields, and possibly a message-body. + + generic-message = start-line + *(message-header CRLF) + CRLF + [ message-body ] + start-line = Request-Line | Status-Line + + In the interest of robustness, servers SHOULD ignore any empty + line(s) received where a Request-Line is expected. In other words, if + the server is reading the protocol stream at the beginning of a + message and receives a CRLF first, it should ignore the CRLF. + + Certain buggy HTTP/1.0 client implementations generate extra CRLF's + after a POST request. To restate what is explicitly forbidden by the + BNF, an HTTP/1.1 client MUST NOT preface or follow a request with an + extra CRLF. + +4.2 Message Headers + + HTTP header fields, which include general-header (section 4.5), + request-header (section 5.3), response-header (section 6.2), and + entity-header (section 7.1) fields, follow the same generic format as + that given in Section 3.1 of RFC 822 [9]. Each header field consists + of a name followed by a colon (":") and the field value. Field names + are case-insensitive. The field value MAY be preceded by any amount + of LWS, though a single SP is preferred. Header fields can be + extended over multiple lines by preceding each extra line with at + least one SP or HT. Applications ought to follow "common form", where + one is known or indicated, when generating HTTP constructs, since + there might exist some implementations that fail to accept anything + + + +Fielding, et al. Standards Track [Page 31] + +RFC 2616 HTTP/1.1 June 1999 + + + beyond the common forms. + + message-header = field-name ":" [ field-value ] + field-name = token + field-value = *( field-content | LWS ) + field-content = + + The field-content does not include any leading or trailing LWS: + linear white space occurring before the first non-whitespace + character of the field-value or after the last non-whitespace + character of the field-value. Such leading or trailing LWS MAY be + removed without changing the semantics of the field value. Any LWS + that occurs between field-content MAY be replaced with a single SP + before interpreting the field value or forwarding the message + downstream. + + The order in which header fields with differing field names are + received is not significant. However, it is "good practice" to send + general-header fields first, followed by request-header or response- + header fields, and ending with the entity-header fields. + + Multiple message-header fields with the same field-name MAY be + present in a message if and only if the entire field-value for that + header field is defined as a comma-separated list [i.e., #(values)]. + It MUST be possible to combine the multiple header fields into one + "field-name: field-value" pair, without changing the semantics of the + message, by appending each subsequent field-value to the first, each + separated by a comma. The order in which header fields with the same + field-name are received is therefore significant to the + interpretation of the combined field value, and thus a proxy MUST NOT + change the order of these field values when a message is forwarded. + +4.3 Message Body + + The message-body (if any) of an HTTP message is used to carry the + entity-body associated with the request or response. The message-body + differs from the entity-body only when a transfer-coding has been + applied, as indicated by the Transfer-Encoding header field (section + 14.41). + + message-body = entity-body + | + + Transfer-Encoding MUST be used to indicate any transfer-codings + applied by an application to ensure safe and proper transfer of the + message. Transfer-Encoding is a property of the message, not of the + + + +Fielding, et al. Standards Track [Page 32] + +RFC 2616 HTTP/1.1 June 1999 + + + entity, and thus MAY be added or removed by any application along the + request/response chain. (However, section 3.6 places restrictions on + when certain transfer-codings may be used.) + + The rules for when a message-body is allowed in a message differ for + requests and responses. + + The presence of a message-body in a request is signaled by the + inclusion of a Content-Length or Transfer-Encoding header field in + the request's message-headers. A message-body MUST NOT be included in + a request if the specification of the request method (section 5.1.1) + does not allow sending an entity-body in requests. A server SHOULD + read and forward a message-body on any request; if the request method + does not include defined semantics for an entity-body, then the + message-body SHOULD be ignored when handling the request. + + For response messages, whether or not a message-body is included with + a message is dependent on both the request method and the response + status code (section 6.1.1). All responses to the HEAD request method + MUST NOT include a message-body, even though the presence of entity- + header fields might lead one to believe they do. All 1xx + (informational), 204 (no content), and 304 (not modified) responses + MUST NOT include a message-body. All other responses do include a + message-body, although it MAY be of zero length. + +4.4 Message Length + + The transfer-length of a message is the length of the message-body as + it appears in the message; that is, after any transfer-codings have + been applied. When a message-body is included with a message, the + transfer-length of that body is determined by one of the following + (in order of precedence): + + 1.Any response message which "MUST NOT" include a message-body (such + as the 1xx, 204, and 304 responses and any response to a HEAD + request) is always terminated by the first empty line after the + header fields, regardless of the entity-header fields present in + the message. + + 2.If a Transfer-Encoding header field (section 14.41) is present and + has any value other than "identity", then the transfer-length is + defined by use of the "chunked" transfer-coding (section 3.6), + unless the message is terminated by closing the connection. + + 3.If a Content-Length header field (section 14.13) is present, its + decimal value in OCTETs represents both the entity-length and the + transfer-length. The Content-Length header field MUST NOT be sent + if these two lengths are different (i.e., if a Transfer-Encoding + + + +Fielding, et al. Standards Track [Page 33] + +RFC 2616 HTTP/1.1 June 1999 + + + header field is present). If a message is received with both a + Transfer-Encoding header field and a Content-Length header field, + the latter MUST be ignored. + + 4.If the message uses the media type "multipart/byteranges", and the + ransfer-length is not otherwise specified, then this self- + elimiting media type defines the transfer-length. This media type + UST NOT be used unless the sender knows that the recipient can arse + it; the presence in a request of a Range header with ultiple byte- + range specifiers from a 1.1 client implies that the lient can parse + multipart/byteranges responses. + + A range header might be forwarded by a 1.0 proxy that does not + understand multipart/byteranges; in this case the server MUST + delimit the message using methods defined in items 1,3 or 5 of + this section. + + 5.By the server closing the connection. (Closing the connection + cannot be used to indicate the end of a request body, since that + would leave no possibility for the server to send back a response.) + + For compatibility with HTTP/1.0 applications, HTTP/1.1 requests + containing a message-body MUST include a valid Content-Length header + field unless the server is known to be HTTP/1.1 compliant. If a + request contains a message-body and a Content-Length is not given, + the server SHOULD respond with 400 (bad request) if it cannot + determine the length of the message, or with 411 (length required) if + it wishes to insist on receiving a valid Content-Length. + + All HTTP/1.1 applications that receive entities MUST accept the + "chunked" transfer-coding (section 3.6), thus allowing this mechanism + to be used for messages when the message length cannot be determined + in advance. + + Messages MUST NOT include both a Content-Length header field and a + non-identity transfer-coding. If the message does include a non- + identity transfer-coding, the Content-Length MUST be ignored. + + When a Content-Length is given in a message where a message-body is + allowed, its field value MUST exactly match the number of OCTETs in + the message-body. HTTP/1.1 user agents MUST notify the user when an + invalid length is received and detected. + +4.5 General Header Fields + + There are a few header fields which have general applicability for + both request and response messages, but which do not apply to the + entity being transferred. These header fields apply only to the + + + +Fielding, et al. Standards Track [Page 34] + +RFC 2616 HTTP/1.1 June 1999 + + + message being transmitted. + + general-header = Cache-Control ; Section 14.9 + | Connection ; Section 14.10 + | Date ; Section 14.18 + | Pragma ; Section 14.32 + | Trailer ; Section 14.40 + | Transfer-Encoding ; Section 14.41 + | Upgrade ; Section 14.42 + | Via ; Section 14.45 + | Warning ; Section 14.46 + + General-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields may be given the semantics of general + header fields if all parties in the communication recognize them to + be general-header fields. Unrecognized header fields are treated as + entity-header fields. + +5 Request + + A request message from a client to a server includes, within the + first line of that message, the method to be applied to the resource, + the identifier of the resource, and the protocol version in use. + + Request = Request-Line ; Section 5.1 + *(( general-header ; Section 4.5 + | request-header ; Section 5.3 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 4.3 + +5.1 Request-Line + + The Request-Line begins with a method token, followed by the + Request-URI and the protocol version, and ending with CRLF. The + elements are separated by SP characters. No CR or LF is allowed + except in the final CRLF sequence. + + Request-Line = Method SP Request-URI SP HTTP-Version CRLF + + + + + + + + + + + +Fielding, et al. Standards Track [Page 35] + +RFC 2616 HTTP/1.1 June 1999 + + +5.1.1 Method + + The Method token indicates the method to be performed on the + resource identified by the Request-URI. The method is case-sensitive. + + Method = "OPTIONS" ; Section 9.2 + | "GET" ; Section 9.3 + | "HEAD" ; Section 9.4 + | "POST" ; Section 9.5 + | "PUT" ; Section 9.6 + | "DELETE" ; Section 9.7 + | "TRACE" ; Section 9.8 + | "CONNECT" ; Section 9.9 + | extension-method + extension-method = token + + The list of methods allowed by a resource can be specified in an + Allow header field (section 14.7). The return code of the response + always notifies the client whether a method is currently allowed on a + resource, since the set of allowed methods can change dynamically. An + origin server SHOULD return the status code 405 (Method Not Allowed) + if the method is known by the origin server but not allowed for the + requested resource, and 501 (Not Implemented) if the method is + unrecognized or not implemented by the origin server. The methods GET + and HEAD MUST be supported by all general-purpose servers. All other + methods are OPTIONAL; however, if the above methods are implemented, + they MUST be implemented with the same semantics as those specified + in section 9. + +5.1.2 Request-URI + + The Request-URI is a Uniform Resource Identifier (section 3.2) and + identifies the resource upon which to apply the request. + + Request-URI = "*" | absoluteURI | abs_path | authority + + The four options for Request-URI are dependent on the nature of the + request. The asterisk "*" means that the request does not apply to a + particular resource, but to the server itself, and is only allowed + when the method used does not necessarily apply to a resource. One + example would be + + OPTIONS * HTTP/1.1 + + The absoluteURI form is REQUIRED when the request is being made to a + proxy. The proxy is requested to forward the request or service it + from a valid cache, and return the response. Note that the proxy MAY + forward the request on to another proxy or directly to the server + + + +Fielding, et al. Standards Track [Page 36] + +RFC 2616 HTTP/1.1 June 1999 + + + specified by the absoluteURI. In order to avoid request loops, a + proxy MUST be able to recognize all of its server names, including + any aliases, local variations, and the numeric IP address. An example + Request-Line would be: + + GET http://www.w3.org/pub/WWW/TheProject.html HTTP/1.1 + + To allow for transition to absoluteURIs in all requests in future + versions of HTTP, all HTTP/1.1 servers MUST accept the absoluteURI + form in requests, even though HTTP/1.1 clients will only generate + them in requests to proxies. + + The authority form is only used by the CONNECT method (section 9.9). + + The most common form of Request-URI is that used to identify a + resource on an origin server or gateway. In this case the absolute + path of the URI MUST be transmitted (see section 3.2.1, abs_path) as + the Request-URI, and the network location of the URI (authority) MUST + be transmitted in a Host header field. For example, a client wishing + to retrieve the resource above directly from the origin server would + create a TCP connection to port 80 of the host "www.w3.org" and send + the lines: + + GET /pub/WWW/TheProject.html HTTP/1.1 + Host: www.w3.org + + followed by the remainder of the Request. Note that the absolute path + cannot be empty; if none is present in the original URI, it MUST be + given as "/" (the server root). + + The Request-URI is transmitted in the format specified in section + 3.2.1. If the Request-URI is encoded using the "% HEX HEX" encoding + [42], the origin server MUST decode the Request-URI in order to + properly interpret the request. Servers SHOULD respond to invalid + Request-URIs with an appropriate status code. + + A transparent proxy MUST NOT rewrite the "abs_path" part of the + received Request-URI when forwarding it to the next inbound server, + except as noted above to replace a null abs_path with "/". + + Note: The "no rewrite" rule prevents the proxy from changing the + meaning of the request when the origin server is improperly using + a non-reserved URI character for a reserved purpose. Implementors + should be aware that some pre-HTTP/1.1 proxies have been known to + rewrite the Request-URI. + + + + + + +Fielding, et al. Standards Track [Page 37] + +RFC 2616 HTTP/1.1 June 1999 + + +5.2 The Resource Identified by a Request + + The exact resource identified by an Internet request is determined by + examining both the Request-URI and the Host header field. + + An origin server that does not allow resources to differ by the + requested host MAY ignore the Host header field value when + determining the resource identified by an HTTP/1.1 request. (But see + section 19.6.1.1 for other requirements on Host support in HTTP/1.1.) + + An origin server that does differentiate resources based on the host + requested (sometimes referred to as virtual hosts or vanity host + names) MUST use the following rules for determining the requested + resource on an HTTP/1.1 request: + + 1. If Request-URI is an absoluteURI, the host is part of the + Request-URI. Any Host header field value in the request MUST be + ignored. + + 2. If the Request-URI is not an absoluteURI, and the request includes + a Host header field, the host is determined by the Host header + field value. + + 3. If the host as determined by rule 1 or 2 is not a valid host on + the server, the response MUST be a 400 (Bad Request) error message. + + Recipients of an HTTP/1.0 request that lacks a Host header field MAY + attempt to use heuristics (e.g., examination of the URI path for + something unique to a particular host) in order to determine what + exact resource is being requested. + +5.3 Request Header Fields + + The request-header fields allow the client to pass additional + information about the request, and about the client itself, to the + server. These fields act as request modifiers, with semantics + equivalent to the parameters on a programming language method + invocation. + + request-header = Accept ; Section 14.1 + | Accept-Charset ; Section 14.2 + | Accept-Encoding ; Section 14.3 + | Accept-Language ; Section 14.4 + | Authorization ; Section 14.8 + | Expect ; Section 14.20 + | From ; Section 14.22 + | Host ; Section 14.23 + | If-Match ; Section 14.24 + + + +Fielding, et al. Standards Track [Page 38] + +RFC 2616 HTTP/1.1 June 1999 + + + | If-Modified-Since ; Section 14.25 + | If-None-Match ; Section 14.26 + | If-Range ; Section 14.27 + | If-Unmodified-Since ; Section 14.28 + | Max-Forwards ; Section 14.31 + | Proxy-Authorization ; Section 14.34 + | Range ; Section 14.35 + | Referer ; Section 14.36 + | TE ; Section 14.39 + | User-Agent ; Section 14.43 + + Request-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of request- + header fields if all parties in the communication recognize them to + be request-header fields. Unrecognized header fields are treated as + entity-header fields. + +6 Response + + After receiving and interpreting a request message, a server responds + with an HTTP response message. + + Response = Status-Line ; Section 6.1 + *(( general-header ; Section 4.5 + | response-header ; Section 6.2 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 7.2 + +6.1 Status-Line + + The first line of a Response message is the Status-Line, consisting + of the protocol version followed by a numeric status code and its + associated textual phrase, with each element separated by SP + characters. No CR or LF is allowed except in the final CRLF sequence. + + Status-Line = HTTP-Version SP Status-Code SP Reason-Phrase CRLF + +6.1.1 Status Code and Reason Phrase + + The Status-Code element is a 3-digit integer result code of the + attempt to understand and satisfy the request. These codes are fully + defined in section 10. The Reason-Phrase is intended to give a short + textual description of the Status-Code. The Status-Code is intended + for use by automata and the Reason-Phrase is intended for the human + user. The client is not required to examine or display the Reason- + Phrase. + + + +Fielding, et al. Standards Track [Page 39] + +RFC 2616 HTTP/1.1 June 1999 + + + The first digit of the Status-Code defines the class of response. The + last two digits do not have any categorization role. There are 5 + values for the first digit: + + - 1xx: Informational - Request received, continuing process + + - 2xx: Success - The action was successfully received, + understood, and accepted + + - 3xx: Redirection - Further action must be taken in order to + complete the request + + - 4xx: Client Error - The request contains bad syntax or cannot + be fulfilled + + - 5xx: Server Error - The server failed to fulfill an apparently + valid request + + The individual values of the numeric status codes defined for + HTTP/1.1, and an example set of corresponding Reason-Phrase's, are + presented below. The reason phrases listed here are only + recommendations -- they MAY be replaced by local equivalents without + affecting the protocol. + + Status-Code = + "100" ; Section 10.1.1: Continue + | "101" ; Section 10.1.2: Switching Protocols + | "200" ; Section 10.2.1: OK + | "201" ; Section 10.2.2: Created + | "202" ; Section 10.2.3: Accepted + | "203" ; Section 10.2.4: Non-Authoritative Information + | "204" ; Section 10.2.5: No Content + | "205" ; Section 10.2.6: Reset Content + | "206" ; Section 10.2.7: Partial Content + | "300" ; Section 10.3.1: Multiple Choices + | "301" ; Section 10.3.2: Moved Permanently + | "302" ; Section 10.3.3: Found + | "303" ; Section 10.3.4: See Other + | "304" ; Section 10.3.5: Not Modified + | "305" ; Section 10.3.6: Use Proxy + | "307" ; Section 10.3.8: Temporary Redirect + | "400" ; Section 10.4.1: Bad Request + | "401" ; Section 10.4.2: Unauthorized + | "402" ; Section 10.4.3: Payment Required + | "403" ; Section 10.4.4: Forbidden + | "404" ; Section 10.4.5: Not Found + | "405" ; Section 10.4.6: Method Not Allowed + | "406" ; Section 10.4.7: Not Acceptable + + + +Fielding, et al. Standards Track [Page 40] + +RFC 2616 HTTP/1.1 June 1999 + + + | "407" ; Section 10.4.8: Proxy Authentication Required + | "408" ; Section 10.4.9: Request Time-out + | "409" ; Section 10.4.10: Conflict + | "410" ; Section 10.4.11: Gone + | "411" ; Section 10.4.12: Length Required + | "412" ; Section 10.4.13: Precondition Failed + | "413" ; Section 10.4.14: Request Entity Too Large + | "414" ; Section 10.4.15: Request-URI Too Large + | "415" ; Section 10.4.16: Unsupported Media Type + | "416" ; Section 10.4.17: Requested range not satisfiable + | "417" ; Section 10.4.18: Expectation Failed + | "500" ; Section 10.5.1: Internal Server Error + | "501" ; Section 10.5.2: Not Implemented + | "502" ; Section 10.5.3: Bad Gateway + | "503" ; Section 10.5.4: Service Unavailable + | "504" ; Section 10.5.5: Gateway Time-out + | "505" ; Section 10.5.6: HTTP Version not supported + | extension-code + + extension-code = 3DIGIT + Reason-Phrase = * + + HTTP status codes are extensible. HTTP applications are not required + to understand the meaning of all registered status codes, though such + understanding is obviously desirable. However, applications MUST + understand the class of any status code, as indicated by the first + digit, and treat any unrecognized response as being equivalent to the + x00 status code of that class, with the exception that an + unrecognized response MUST NOT be cached. For example, if an + unrecognized status code of 431 is received by the client, it can + safely assume that there was something wrong with its request and + treat the response as if it had received a 400 status code. In such + cases, user agents SHOULD present to the user the entity returned + with the response, since that entity is likely to include human- + readable information which will explain the unusual status. + +6.2 Response Header Fields + + The response-header fields allow the server to pass additional + information about the response which cannot be placed in the Status- + Line. These header fields give information about the server and about + further access to the resource identified by the Request-URI. + + response-header = Accept-Ranges ; Section 14.5 + | Age ; Section 14.6 + | ETag ; Section 14.19 + | Location ; Section 14.30 + | Proxy-Authenticate ; Section 14.33 + + + +Fielding, et al. Standards Track [Page 41] + +RFC 2616 HTTP/1.1 June 1999 + + + | Retry-After ; Section 14.37 + | Server ; Section 14.38 + | Vary ; Section 14.44 + | WWW-Authenticate ; Section 14.47 + + Response-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of response- + header fields if all parties in the communication recognize them to + be response-header fields. Unrecognized header fields are treated as + entity-header fields. + +7 Entity + + Request and Response messages MAY transfer an entity if not otherwise + restricted by the request method or response status code. An entity + consists of entity-header fields and an entity-body, although some + responses will only include the entity-headers. + + In this section, both sender and recipient refer to either the client + or the server, depending on who sends and who receives the entity. + +7.1 Entity Header Fields + + Entity-header fields define metainformation about the entity-body or, + if no body is present, about the resource identified by the request. + Some of this metainformation is OPTIONAL; some might be REQUIRED by + portions of this specification. + + entity-header = Allow ; Section 14.7 + | Content-Encoding ; Section 14.11 + | Content-Language ; Section 14.12 + | Content-Length ; Section 14.13 + | Content-Location ; Section 14.14 + | Content-MD5 ; Section 14.15 + | Content-Range ; Section 14.16 + | Content-Type ; Section 14.17 + | Expires ; Section 14.21 + | Last-Modified ; Section 14.29 + | extension-header + + extension-header = message-header + + The extension-header mechanism allows additional entity-header fields + to be defined without changing the protocol, but these fields cannot + be assumed to be recognizable by the recipient. Unrecognized header + fields SHOULD be ignored by the recipient and MUST be forwarded by + transparent proxies. + + + +Fielding, et al. Standards Track [Page 42] + +RFC 2616 HTTP/1.1 June 1999 + + +7.2 Entity Body + + The entity-body (if any) sent with an HTTP request or response is in + a format and encoding defined by the entity-header fields. + + entity-body = *OCTET + + An entity-body is only present in a message when a message-body is + present, as described in section 4.3. The entity-body is obtained + from the message-body by decoding any Transfer-Encoding that might + have been applied to ensure safe and proper transfer of the message. + +7.2.1 Type + + When an entity-body is included with a message, the data type of that + body is determined via the header fields Content-Type and Content- + Encoding. These define a two-layer, ordered encoding model: + + entity-body := Content-Encoding( Content-Type( data ) ) + + Content-Type specifies the media type of the underlying data. + Content-Encoding may be used to indicate any additional content + codings applied to the data, usually for the purpose of data + compression, that are a property of the requested resource. There is + no default encoding. + + Any HTTP/1.1 message containing an entity-body SHOULD include a + Content-Type header field defining the media type of that body. If + and only if the media type is not given by a Content-Type field, the + recipient MAY attempt to guess the media type via inspection of its + content and/or the name extension(s) of the URI used to identify the + resource. If the media type remains unknown, the recipient SHOULD + treat it as type "application/octet-stream". + +7.2.2 Entity Length + + The entity-length of a message is the length of the message-body + before any transfer-codings have been applied. Section 4.4 defines + how the transfer-length of a message-body is determined. + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 43] + +RFC 2616 HTTP/1.1 June 1999 + + +8 Connections + +8.1 Persistent Connections + +8.1.1 Purpose + + Prior to persistent connections, a separate TCP connection was + established to fetch each URL, increasing the load on HTTP servers + and causing congestion on the Internet. The use of inline images and + other associated data often require a client to make multiple + requests of the same server in a short amount of time. Analysis of + these performance problems and results from a prototype + implementation are available [26] [30]. Implementation experience and + measurements of actual HTTP/1.1 (RFC 2068) implementations show good + results [39]. Alternatives have also been explored, for example, + T/TCP [27]. + + Persistent HTTP connections have a number of advantages: + + - By opening and closing fewer TCP connections, CPU time is saved + in routers and hosts (clients, servers, proxies, gateways, + tunnels, or caches), and memory used for TCP protocol control + blocks can be saved in hosts. + + - HTTP requests and responses can be pipelined on a connection. + Pipelining allows a client to make multiple requests without + waiting for each response, allowing a single TCP connection to + be used much more efficiently, with much lower elapsed time. + + - Network congestion is reduced by reducing the number of packets + caused by TCP opens, and by allowing TCP sufficient time to + determine the congestion state of the network. + + - Latency on subsequent requests is reduced since there is no time + spent in TCP's connection opening handshake. + + - HTTP can evolve more gracefully, since errors can be reported + without the penalty of closing the TCP connection. Clients using + future versions of HTTP might optimistically try a new feature, + but if communicating with an older server, retry with old + semantics after an error is reported. + + HTTP implementations SHOULD implement persistent connections. + + + + + + + + +Fielding, et al. Standards Track [Page 44] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2 Overall Operation + + A significant difference between HTTP/1.1 and earlier versions of + HTTP is that persistent connections are the default behavior of any + HTTP connection. That is, unless otherwise indicated, the client + SHOULD assume that the server will maintain a persistent connection, + even after error responses from the server. + + Persistent connections provide a mechanism by which a client and a + server can signal the close of a TCP connection. This signaling takes + place using the Connection header field (section 14.10). Once a close + has been signaled, the client MUST NOT send any more requests on that + connection. + +8.1.2.1 Negotiation + + An HTTP/1.1 server MAY assume that a HTTP/1.1 client intends to + maintain a persistent connection unless a Connection header including + the connection-token "close" was sent in the request. If the server + chooses to close the connection immediately after sending the + response, it SHOULD send a Connection header including the + connection-token close. + + An HTTP/1.1 client MAY expect a connection to remain open, but would + decide to keep it open based on whether the response from a server + contains a Connection header with the connection-token close. In case + the client does not want to maintain a connection for more than that + request, it SHOULD send a Connection header including the + connection-token close. + + If either the client or the server sends the close token in the + Connection header, that request becomes the last one for the + connection. + + Clients and servers SHOULD NOT assume that a persistent connection is + maintained for HTTP versions less than 1.1 unless it is explicitly + signaled. See section 19.6.2 for more information on backward + compatibility with HTTP/1.0 clients. + + In order to remain persistent, all messages on the connection MUST + have a self-defined message length (i.e., one not defined by closure + of the connection), as described in section 4.4. + + + + + + + + + +Fielding, et al. Standards Track [Page 45] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2.2 Pipelining + + A client that supports persistent connections MAY "pipeline" its + requests (i.e., send multiple requests without waiting for each + response). A server MUST send its responses to those requests in the + same order that the requests were received. + + Clients which assume persistent connections and pipeline immediately + after connection establishment SHOULD be prepared to retry their + connection if the first pipelined attempt fails. If a client does + such a retry, it MUST NOT pipeline before it knows the connection is + persistent. Clients MUST also be prepared to resend their requests if + the server closes the connection before sending all of the + corresponding responses. + + Clients SHOULD NOT pipeline requests using non-idempotent methods or + non-idempotent sequences of methods (see section 9.1.2). Otherwise, a + premature termination of the transport connection could lead to + indeterminate results. A client wishing to send a non-idempotent + request SHOULD wait to send that request until it has received the + response status for the previous request. + +8.1.3 Proxy Servers + + It is especially important that proxies correctly implement the + properties of the Connection header field as specified in section + 14.10. + + The proxy server MUST signal persistent connections separately with + its clients and the origin servers (or other proxy servers) that it + connects to. Each persistent connection applies to only one transport + link. + + A proxy server MUST NOT establish a HTTP/1.1 persistent connection + with an HTTP/1.0 client (but see RFC 2068 [33] for information and + discussion of the problems with the Keep-Alive header implemented by + many HTTP/1.0 clients). + +8.1.4 Practical Considerations + + Servers will usually have some time-out value beyond which they will + no longer maintain an inactive connection. Proxy servers might make + this a higher value since it is likely that the client will be making + more connections through the same server. The use of persistent + connections places no requirements on the length (or existence) of + this time-out for either the client or the server. + + + + + +Fielding, et al. Standards Track [Page 46] + +RFC 2616 HTTP/1.1 June 1999 + + + When a client or server wishes to time-out it SHOULD issue a graceful + close on the transport connection. Clients and servers SHOULD both + constantly watch for the other side of the transport close, and + respond to it as appropriate. If a client or server does not detect + the other side's close promptly it could cause unnecessary resource + drain on the network. + + A client, server, or proxy MAY close the transport connection at any + time. For example, a client might have started to send a new request + at the same time that the server has decided to close the "idle" + connection. From the server's point of view, the connection is being + closed while it was idle, but from the client's point of view, a + request is in progress. + + This means that clients, servers, and proxies MUST be able to recover + from asynchronous close events. Client software SHOULD reopen the + transport connection and retransmit the aborted sequence of requests + without user interaction so long as the request sequence is + idempotent (see section 9.1.2). Non-idempotent methods or sequences + MUST NOT be automatically retried, although user agents MAY offer a + human operator the choice of retrying the request(s). Confirmation by + user-agent software with semantic understanding of the application + MAY substitute for user confirmation. The automatic retry SHOULD NOT + be repeated if the second sequence of requests fails. + + Servers SHOULD always respond to at least one request per connection, + if at all possible. Servers SHOULD NOT close a connection in the + middle of transmitting a response, unless a network or client failure + is suspected. + + Clients that use persistent connections SHOULD limit the number of + simultaneous connections that they maintain to a given server. A + single-user client SHOULD NOT maintain more than 2 connections with + any server or proxy. A proxy SHOULD use up to 2*N connections to + another server or proxy, where N is the number of simultaneously + active users. These guidelines are intended to improve HTTP response + times and avoid congestion. + +8.2 Message Transmission Requirements + +8.2.1 Persistent Connections and Flow Control + + HTTP/1.1 servers SHOULD maintain persistent connections and use TCP's + flow control mechanisms to resolve temporary overloads, rather than + terminating connections with the expectation that clients will retry. + The latter technique can exacerbate network congestion. + + + + + +Fielding, et al. Standards Track [Page 47] + +RFC 2616 HTTP/1.1 June 1999 + + +8.2.2 Monitoring Connections for Error Status Messages + + An HTTP/1.1 (or later) client sending a message-body SHOULD monitor + the network connection for an error status while it is transmitting + the request. If the client sees an error status, it SHOULD + immediately cease transmitting the body. If the body is being sent + using a "chunked" encoding (section 3.6), a zero length chunk and + empty trailer MAY be used to prematurely mark the end of the message. + If the body was preceded by a Content-Length header, the client MUST + close the connection. + +8.2.3 Use of the 100 (Continue) Status + + The purpose of the 100 (Continue) status (see section 10.1.1) is to + allow a client that is sending a request message with a request body + to determine if the origin server is willing to accept the request + (based on the request headers) before the client sends the request + body. In some cases, it might either be inappropriate or highly + inefficient for the client to send the body if the server will reject + the message without looking at the body. + + Requirements for HTTP/1.1 clients: + + - If a client will wait for a 100 (Continue) response before + sending the request body, it MUST send an Expect request-header + field (section 14.20) with the "100-continue" expectation. + + - A client MUST NOT send an Expect request-header field (section + 14.20) with the "100-continue" expectation if it does not intend + to send a request body. + + Because of the presence of older implementations, the protocol allows + ambiguous situations in which a client may send "Expect: 100- + continue" without receiving either a 417 (Expectation Failed) status + or a 100 (Continue) status. Therefore, when a client sends this + header field to an origin server (possibly via a proxy) from which it + has never seen a 100 (Continue) status, the client SHOULD NOT wait + for an indefinite period before sending the request body. + + Requirements for HTTP/1.1 origin servers: + + - Upon receiving a request which includes an Expect request-header + field with the "100-continue" expectation, an origin server MUST + either respond with 100 (Continue) status and continue to read + from the input stream, or respond with a final status code. The + origin server MUST NOT wait for the request body before sending + the 100 (Continue) response. If it responds with a final status + code, it MAY close the transport connection or it MAY continue + + + +Fielding, et al. Standards Track [Page 48] + +RFC 2616 HTTP/1.1 June 1999 + + + to read and discard the rest of the request. It MUST NOT + perform the requested method if it returns a final status code. + + - An origin server SHOULD NOT send a 100 (Continue) response if + the request message does not include an Expect request-header + field with the "100-continue" expectation, and MUST NOT send a + 100 (Continue) response if such a request comes from an HTTP/1.0 + (or earlier) client. There is an exception to this rule: for + compatibility with RFC 2068, a server MAY send a 100 (Continue) + status in response to an HTTP/1.1 PUT or POST request that does + not include an Expect request-header field with the "100- + continue" expectation. This exception, the purpose of which is + to minimize any client processing delays associated with an + undeclared wait for 100 (Continue) status, applies only to + HTTP/1.1 requests, and not to requests with any other HTTP- + version value. + + - An origin server MAY omit a 100 (Continue) response if it has + already received some or all of the request body for the + corresponding request. + + - An origin server that sends a 100 (Continue) response MUST + ultimately send a final status code, once the request body is + received and processed, unless it terminates the transport + connection prematurely. + + - If an origin server receives a request that does not include an + Expect request-header field with the "100-continue" expectation, + the request includes a request body, and the server responds + with a final status code before reading the entire request body + from the transport connection, then the server SHOULD NOT close + the transport connection until it has read the entire request, + or until the client closes the connection. Otherwise, the client + might not reliably receive the response message. However, this + requirement is not be construed as preventing a server from + defending itself against denial-of-service attacks, or from + badly broken client implementations. + + Requirements for HTTP/1.1 proxies: + + - If a proxy receives a request that includes an Expect request- + header field with the "100-continue" expectation, and the proxy + either knows that the next-hop server complies with HTTP/1.1 or + higher, or does not know the HTTP version of the next-hop + server, it MUST forward the request, including the Expect header + field. + + + + + +Fielding, et al. Standards Track [Page 49] + +RFC 2616 HTTP/1.1 June 1999 + + + - If the proxy knows that the version of the next-hop server is + HTTP/1.0 or lower, it MUST NOT forward the request, and it MUST + respond with a 417 (Expectation Failed) status. + + - Proxies SHOULD maintain a cache recording the HTTP version + numbers received from recently-referenced next-hop servers. + + - A proxy MUST NOT forward a 100 (Continue) response if the + request message was received from an HTTP/1.0 (or earlier) + client and did not include an Expect request-header field with + the "100-continue" expectation. This requirement overrides the + general rule for forwarding of 1xx responses (see section 10.1). + +8.2.4 Client Behavior if Server Prematurely Closes Connection + + If an HTTP/1.1 client sends a request which includes a request body, + but which does not include an Expect request-header field with the + "100-continue" expectation, and if the client is not directly + connected to an HTTP/1.1 origin server, and if the client sees the + connection close before receiving any status from the server, the + client SHOULD retry the request. If the client does retry this + request, it MAY use the following "binary exponential backoff" + algorithm to be assured of obtaining a reliable response: + + 1. Initiate a new connection to the server + + 2. Transmit the request-headers + + 3. Initialize a variable R to the estimated round-trip time to the + server (e.g., based on the time it took to establish the + connection), or to a constant value of 5 seconds if the round- + trip time is not available. + + 4. Compute T = R * (2**N), where N is the number of previous + retries of this request. + + 5. Wait either for an error response from the server, or for T + seconds (whichever comes first) + + 6. If no error response is received, after T seconds transmit the + body of the request. + + 7. If client sees that the connection is closed prematurely, + repeat from step 1 until the request is accepted, an error + response is received, or the user becomes impatient and + terminates the retry process. + + + + + +Fielding, et al. Standards Track [Page 50] + +RFC 2616 HTTP/1.1 June 1999 + + + If at any point an error status is received, the client + + - SHOULD NOT continue and + + - SHOULD close the connection if it has not completed sending the + request message. + +9 Method Definitions + + The set of common methods for HTTP/1.1 is defined below. Although + this set can be expanded, additional methods cannot be assumed to + share the same semantics for separately extended clients and servers. + + The Host request-header field (section 14.23) MUST accompany all + HTTP/1.1 requests. + +9.1 Safe and Idempotent Methods + +9.1.1 Safe Methods + + Implementors should be aware that the software represents the user in + their interactions over the Internet, and should be careful to allow + the user to be aware of any actions they might take which may have an + unexpected significance to themselves or others. + + In particular, the convention has been established that the GET and + HEAD methods SHOULD NOT have the significance of taking an action + other than retrieval. These methods ought to be considered "safe". + This allows user agents to represent other methods, such as POST, PUT + and DELETE, in a special way, so that the user is made aware of the + fact that a possibly unsafe action is being requested. + + Naturally, it is not possible to ensure that the server does not + generate side-effects as a result of performing a GET request; in + fact, some dynamic resources consider that a feature. The important + distinction here is that the user did not request the side-effects, + so therefore cannot be held accountable for them. + +9.1.2 Idempotent Methods + + Methods can also have the property of "idempotence" in that (aside + from error or expiration issues) the side-effects of N > 0 identical + requests is the same as for a single request. The methods GET, HEAD, + PUT and DELETE share this property. Also, the methods OPTIONS and + TRACE SHOULD NOT have side effects, and so are inherently idempotent. + + + + + + +Fielding, et al. Standards Track [Page 51] + +RFC 2616 HTTP/1.1 June 1999 + + + However, it is possible that a sequence of several requests is non- + idempotent, even if all of the methods executed in that sequence are + idempotent. (A sequence is idempotent if a single execution of the + entire sequence always yields a result that is not changed by a + reexecution of all, or part, of that sequence.) For example, a + sequence is non-idempotent if its result depends on a value that is + later modified in the same sequence. + + A sequence that never has side effects is idempotent, by definition + (provided that no concurrent operations are being executed on the + same set of resources). + +9.2 OPTIONS + + The OPTIONS method represents a request for information about the + communication options available on the request/response chain + identified by the Request-URI. This method allows the client to + determine the options and/or requirements associated with a resource, + or the capabilities of a server, without implying a resource action + or initiating a resource retrieval. + + Responses to this method are not cacheable. + + If the OPTIONS request includes an entity-body (as indicated by the + presence of Content-Length or Transfer-Encoding), then the media type + MUST be indicated by a Content-Type field. Although this + specification does not define any use for such a body, future + extensions to HTTP might use the OPTIONS body to make more detailed + queries on the server. A server that does not support such an + extension MAY discard the request body. + + If the Request-URI is an asterisk ("*"), the OPTIONS request is + intended to apply to the server in general rather than to a specific + resource. Since a server's communication options typically depend on + the resource, the "*" request is only useful as a "ping" or "no-op" + type of method; it does nothing beyond allowing the client to test + the capabilities of the server. For example, this can be used to test + a proxy for HTTP/1.1 compliance (or lack thereof). + + If the Request-URI is not an asterisk, the OPTIONS request applies + only to the options that are available when communicating with that + resource. + + A 200 response SHOULD include any header fields that indicate + optional features implemented by the server and applicable to that + resource (e.g., Allow), possibly including extensions not defined by + this specification. The response body, if any, SHOULD also include + information about the communication options. The format for such a + + + +Fielding, et al. Standards Track [Page 52] + +RFC 2616 HTTP/1.1 June 1999 + + + body is not defined by this specification, but might be defined by + future extensions to HTTP. Content negotiation MAY be used to select + the appropriate response format. If no response body is included, the + response MUST include a Content-Length field with a field-value of + "0". + + The Max-Forwards request-header field MAY be used to target a + specific proxy in the request chain. When a proxy receives an OPTIONS + request on an absoluteURI for which request forwarding is permitted, + the proxy MUST check for a Max-Forwards field. If the Max-Forwards + field-value is zero ("0"), the proxy MUST NOT forward the message; + instead, the proxy SHOULD respond with its own communication options. + If the Max-Forwards field-value is an integer greater than zero, the + proxy MUST decrement the field-value when it forwards the request. If + no Max-Forwards field is present in the request, then the forwarded + request MUST NOT include a Max-Forwards field. + +9.3 GET + + The GET method means retrieve whatever information (in the form of an + entity) is identified by the Request-URI. If the Request-URI refers + to a data-producing process, it is the produced data which shall be + returned as the entity in the response and not the source text of the + process, unless that text happens to be the output of the process. + + The semantics of the GET method change to a "conditional GET" if the + request message includes an If-Modified-Since, If-Unmodified-Since, + If-Match, If-None-Match, or If-Range header field. A conditional GET + method requests that the entity be transferred only under the + circumstances described by the conditional header field(s). The + conditional GET method is intended to reduce unnecessary network + usage by allowing cached entities to be refreshed without requiring + multiple requests or transferring data already held by the client. + + The semantics of the GET method change to a "partial GET" if the + request message includes a Range header field. A partial GET requests + that only part of the entity be transferred, as described in section + 14.35. The partial GET method is intended to reduce unnecessary + network usage by allowing partially-retrieved entities to be + completed without transferring data already held by the client. + + The response to a GET request is cacheable if and only if it meets + the requirements for HTTP caching described in section 13. + + See section 15.1.3 for security considerations when used for forms. + + + + + + +Fielding, et al. Standards Track [Page 53] + +RFC 2616 HTTP/1.1 June 1999 + + +9.4 HEAD + + The HEAD method is identical to GET except that the server MUST NOT + return a message-body in the response. The metainformation contained + in the HTTP headers in response to a HEAD request SHOULD be identical + to the information sent in response to a GET request. This method can + be used for obtaining metainformation about the entity implied by the + request without transferring the entity-body itself. This method is + often used for testing hypertext links for validity, accessibility, + and recent modification. + + The response to a HEAD request MAY be cacheable in the sense that the + information contained in the response MAY be used to update a + previously cached entity from that resource. If the new field values + indicate that the cached entity differs from the current entity (as + would be indicated by a change in Content-Length, Content-MD5, ETag + or Last-Modified), then the cache MUST treat the cache entry as + stale. + +9.5 POST + + The POST method is used to request that the origin server accept the + entity enclosed in the request as a new subordinate of the resource + identified by the Request-URI in the Request-Line. POST is designed + to allow a uniform method to cover the following functions: + + - Annotation of existing resources; + + - Posting a message to a bulletin board, newsgroup, mailing list, + or similar group of articles; + + - Providing a block of data, such as the result of submitting a + form, to a data-handling process; + + - Extending a database through an append operation. + + The actual function performed by the POST method is determined by the + server and is usually dependent on the Request-URI. The posted entity + is subordinate to that URI in the same way that a file is subordinate + to a directory containing it, a news article is subordinate to a + newsgroup to which it is posted, or a record is subordinate to a + database. + + The action performed by the POST method might not result in a + resource that can be identified by a URI. In this case, either 200 + (OK) or 204 (No Content) is the appropriate response status, + depending on whether or not the response includes an entity that + describes the result. + + + +Fielding, et al. Standards Track [Page 54] + +RFC 2616 HTTP/1.1 June 1999 + + + If a resource has been created on the origin server, the response + SHOULD be 201 (Created) and contain an entity which describes the + status of the request and refers to the new resource, and a Location + header (see section 14.30). + + Responses to this method are not cacheable, unless the response + includes appropriate Cache-Control or Expires header fields. However, + the 303 (See Other) response can be used to direct the user agent to + retrieve a cacheable resource. + + POST requests MUST obey the message transmission requirements set out + in section 8.2. + + See section 15.1.3 for security considerations. + +9.6 PUT + + The PUT method requests that the enclosed entity be stored under the + supplied Request-URI. If the Request-URI refers to an already + existing resource, the enclosed entity SHOULD be considered as a + modified version of the one residing on the origin server. If the + Request-URI does not point to an existing resource, and that URI is + capable of being defined as a new resource by the requesting user + agent, the origin server can create the resource with that URI. If a + new resource is created, the origin server MUST inform the user agent + via the 201 (Created) response. If an existing resource is modified, + either the 200 (OK) or 204 (No Content) response codes SHOULD be sent + to indicate successful completion of the request. If the resource + could not be created or modified with the Request-URI, an appropriate + error response SHOULD be given that reflects the nature of the + problem. The recipient of the entity MUST NOT ignore any Content-* + (e.g. Content-Range) headers that it does not understand or implement + and MUST return a 501 (Not Implemented) response in such cases. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + + The fundamental difference between the POST and PUT requests is + reflected in the different meaning of the Request-URI. The URI in a + POST request identifies the resource that will handle the enclosed + entity. That resource might be a data-accepting process, a gateway to + some other protocol, or a separate entity that accepts annotations. + In contrast, the URI in a PUT request identifies the entity enclosed + with the request -- the user agent knows what URI is intended and the + server MUST NOT attempt to apply the request to some other resource. + If the server desires that the request be applied to a different URI, + + + + +Fielding, et al. Standards Track [Page 55] + +RFC 2616 HTTP/1.1 June 1999 + + + it MUST send a 301 (Moved Permanently) response; the user agent MAY + then make its own decision regarding whether or not to redirect the + request. + + A single resource MAY be identified by many different URIs. For + example, an article might have a URI for identifying "the current + version" which is separate from the URI identifying each particular + version. In this case, a PUT request on a general URI might result in + several other URIs being defined by the origin server. + + HTTP/1.1 does not define how a PUT method affects the state of an + origin server. + + PUT requests MUST obey the message transmission requirements set out + in section 8.2. + + Unless otherwise specified for a particular entity-header, the + entity-headers in the PUT request SHOULD be applied to the resource + created or modified by the PUT. + +9.7 DELETE + + The DELETE method requests that the origin server delete the resource + identified by the Request-URI. This method MAY be overridden by human + intervention (or other means) on the origin server. The client cannot + be guaranteed that the operation has been carried out, even if the + status code returned from the origin server indicates that the action + has been completed successfully. However, the server SHOULD NOT + indicate success unless, at the time the response is given, it + intends to delete the resource or move it to an inaccessible + location. + + A successful response SHOULD be 200 (OK) if the response includes an + entity describing the status, 202 (Accepted) if the action has not + yet been enacted, or 204 (No Content) if the action has been enacted + but the response does not include an entity. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + +9.8 TRACE + + The TRACE method is used to invoke a remote, application-layer loop- + back of the request message. The final recipient of the request + SHOULD reflect the message received back to the client as the + entity-body of a 200 (OK) response. The final recipient is either the + + + + +Fielding, et al. Standards Track [Page 56] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server or the first proxy or gateway to receive a Max-Forwards + value of zero (0) in the request (see section 14.31). A TRACE request + MUST NOT include an entity. + + TRACE allows the client to see what is being received at the other + end of the request chain and use that data for testing or diagnostic + information. The value of the Via header field (section 14.45) is of + particular interest, since it acts as a trace of the request chain. + Use of the Max-Forwards header field allows the client to limit the + length of the request chain, which is useful for testing a chain of + proxies forwarding messages in an infinite loop. + + If the request is valid, the response SHOULD contain the entire + request message in the entity-body, with a Content-Type of + "message/http". Responses to this method MUST NOT be cached. + +9.9 CONNECT + + This specification reserves the method name CONNECT for use with a + proxy that can dynamically switch to being a tunnel (e.g. SSL + tunneling [44]). + +10 Status Code Definitions + + Each Status-Code is described below, including a description of which + method(s) it can follow and any metainformation required in the + response. + +10.1 Informational 1xx + + This class of status code indicates a provisional response, + consisting only of the Status-Line and optional headers, and is + terminated by an empty line. There are no required headers for this + class of status code. Since HTTP/1.0 did not define any 1xx status + codes, servers MUST NOT send a 1xx response to an HTTP/1.0 client + except under experimental conditions. + + A client MUST be prepared to accept one or more 1xx status responses + prior to a regular response, even if the client does not expect a 100 + (Continue) status message. Unexpected 1xx status responses MAY be + ignored by a user agent. + + Proxies MUST forward 1xx responses, unless the connection between the + proxy and its client has been closed, or unless the proxy itself + requested the generation of the 1xx response. (For example, if a + + + + + + +Fielding, et al. Standards Track [Page 57] + +RFC 2616 HTTP/1.1 June 1999 + + + proxy adds a "Expect: 100-continue" field when it forwards a request, + then it need not forward the corresponding 100 (Continue) + response(s).) + +10.1.1 100 Continue + + The client SHOULD continue with its request. This interim response is + used to inform the client that the initial part of the request has + been received and has not yet been rejected by the server. The client + SHOULD continue by sending the remainder of the request or, if the + request has already been completed, ignore this response. The server + MUST send a final response after the request has been completed. See + section 8.2.3 for detailed discussion of the use and handling of this + status code. + +10.1.2 101 Switching Protocols + + The server understands and is willing to comply with the client's + request, via the Upgrade message header field (section 14.42), for a + change in the application protocol being used on this connection. The + server will switch protocols to those defined by the response's + Upgrade header field immediately after the empty line which + terminates the 101 response. + + The protocol SHOULD be switched only when it is advantageous to do + so. For example, switching to a newer version of HTTP is advantageous + over older versions, and switching to a real-time, synchronous + protocol might be advantageous when delivering resources that use + such features. + +10.2 Successful 2xx + + This class of status code indicates that the client's request was + successfully received, understood, and accepted. + +10.2.1 200 OK + + The request has succeeded. The information returned with the response + is dependent on the method used in the request, for example: + + GET an entity corresponding to the requested resource is sent in + the response; + + HEAD the entity-header fields corresponding to the requested + resource are sent in the response without any message-body; + + POST an entity describing or containing the result of the action; + + + + +Fielding, et al. Standards Track [Page 58] + +RFC 2616 HTTP/1.1 June 1999 + + + TRACE an entity containing the request message as received by the + end server. + +10.2.2 201 Created + + The request has been fulfilled and resulted in a new resource being + created. The newly created resource can be referenced by the URI(s) + returned in the entity of the response, with the most specific URI + for the resource given by a Location header field. The response + SHOULD include an entity containing a list of resource + characteristics and location(s) from which the user or user agent can + choose the one most appropriate. The entity format is specified by + the media type given in the Content-Type header field. The origin + server MUST create the resource before returning the 201 status code. + If the action cannot be carried out immediately, the server SHOULD + respond with 202 (Accepted) response instead. + + A 201 response MAY contain an ETag response header field indicating + the current value of the entity tag for the requested variant just + created, see section 14.19. + +10.2.3 202 Accepted + + The request has been accepted for processing, but the processing has + not been completed. The request might or might not eventually be + acted upon, as it might be disallowed when processing actually takes + place. There is no facility for re-sending a status code from an + asynchronous operation such as this. + + The 202 response is intentionally non-committal. Its purpose is to + allow a server to accept a request for some other process (perhaps a + batch-oriented process that is only run once per day) without + requiring that the user agent's connection to the server persist + until the process is completed. The entity returned with this + response SHOULD include an indication of the request's current status + and either a pointer to a status monitor or some estimate of when the + user can expect the request to be fulfilled. + +10.2.4 203 Non-Authoritative Information + + The returned metainformation in the entity-header is not the + definitive set as available from the origin server, but is gathered + from a local or a third-party copy. The set presented MAY be a subset + or superset of the original version. For example, including local + annotation information about the resource might result in a superset + of the metainformation known by the origin server. Use of this + response code is not required and is only appropriate when the + response would otherwise be 200 (OK). + + + +Fielding, et al. Standards Track [Page 59] + +RFC 2616 HTTP/1.1 June 1999 + + +10.2.5 204 No Content + + The server has fulfilled the request but does not need to return an + entity-body, and might want to return updated metainformation. The + response MAY include new or updated metainformation in the form of + entity-headers, which if present SHOULD be associated with the + requested variant. + + If the client is a user agent, it SHOULD NOT change its document view + from that which caused the request to be sent. This response is + primarily intended to allow input for actions to take place without + causing a change to the user agent's active document view, although + any new or updated metainformation SHOULD be applied to the document + currently in the user agent's active view. + + The 204 response MUST NOT include a message-body, and thus is always + terminated by the first empty line after the header fields. + +10.2.6 205 Reset Content + + The server has fulfilled the request and the user agent SHOULD reset + the document view which caused the request to be sent. This response + is primarily intended to allow input for actions to take place via + user input, followed by a clearing of the form in which the input is + given so that the user can easily initiate another input action. The + response MUST NOT include an entity. + +10.2.7 206 Partial Content + + The server has fulfilled the partial GET request for the resource. + The request MUST have included a Range header field (section 14.35) + indicating the desired range, and MAY have included an If-Range + header field (section 14.27) to make the request conditional. + + The response MUST include the following header fields: + + - Either a Content-Range header field (section 14.16) indicating + the range included with this response, or a multipart/byteranges + Content-Type including Content-Range fields for each part. If a + Content-Length header field is present in the response, its + value MUST match the actual number of OCTETs transmitted in the + message-body. + + - Date + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + + + +Fielding, et al. Standards Track [Page 60] + +RFC 2616 HTTP/1.1 June 1999 + + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the 206 response is the result of an If-Range request that used a + strong cache validator (see section 13.3.3), the response SHOULD NOT + include other entity-headers. If the response is the result of an + If-Range request that used a weak validator, the response MUST NOT + include other entity-headers; this prevents inconsistencies between + cached entity-bodies and updated headers. Otherwise, the response + MUST include all of the entity-headers that would have been returned + with a 200 (OK) response to the same request. + + A cache MUST NOT combine a 206 response with other previously cached + content if the ETag or Last-Modified headers do not match exactly, + see 13.5.4. + + A cache that does not support the Range and Content-Range headers + MUST NOT cache 206 (Partial) responses. + +10.3 Redirection 3xx + + This class of status code indicates that further action needs to be + taken by the user agent in order to fulfill the request. The action + required MAY be carried out by the user agent without interaction + with the user if and only if the method used in the second request is + GET or HEAD. A client SHOULD detect infinite redirection loops, since + such loops generate network traffic for each redirection. + + Note: previous versions of this specification recommended a + maximum of five redirections. Content developers should be aware + that there might be clients that implement such a fixed + limitation. + +10.3.1 300 Multiple Choices + + The requested resource corresponds to any one of a set of + representations, each with its own specific location, and agent- + driven negotiation information (section 12) is being provided so that + the user (or user agent) can select a preferred representation and + redirect its request to that location. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of resource characteristics and location(s) from + which the user or user agent can choose the one most appropriate. The + entity format is specified by the media type given in the Content- + Type header field. Depending upon the format and the capabilities of + + + + +Fielding, et al. Standards Track [Page 61] + +RFC 2616 HTTP/1.1 June 1999 + + + the user agent, selection of the most appropriate choice MAY be + performed automatically. However, this specification does not define + any standard for such automatic selection. + + If the server has a preferred choice of representation, it SHOULD + include the specific URI for that representation in the Location + field; user agents MAY use the Location field value for automatic + redirection. This response is cacheable unless indicated otherwise. + +10.3.2 301 Moved Permanently + + The requested resource has been assigned a new permanent URI and any + future references to this resource SHOULD use one of the returned + URIs. Clients with link editing capabilities ought to automatically + re-link references to the Request-URI to one or more of the new + references returned by the server, where possible. This response is + cacheable unless indicated otherwise. + + The new permanent URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + If the 301 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: When automatically redirecting a POST request after + receiving a 301 status code, some existing HTTP/1.0 user agents + will erroneously change it into a GET request. + +10.3.3 302 Found + + The requested resource resides temporarily under a different URI. + Since the redirection might be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + + + + + + +Fielding, et al. Standards Track [Page 62] + +RFC 2616 HTTP/1.1 June 1999 + + + If the 302 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: RFC 1945 and RFC 2068 specify that the client is not allowed + to change the method on the redirected request. However, most + existing user agent implementations treat 302 as if it were a 303 + response, performing a GET on the Location field-value regardless + of the original request method. The status codes 303 and 307 have + been added for servers that wish to make unambiguously clear which + kind of reaction is expected of the client. + +10.3.4 303 See Other + + The response to the request can be found under a different URI and + SHOULD be retrieved using a GET method on that resource. This method + exists primarily to allow the output of a POST-activated script to + redirect the user agent to a selected resource. The new URI is not a + substitute reference for the originally requested resource. The 303 + response MUST NOT be cached, but the response to the second + (redirected) request might be cacheable. + + The different URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + Note: Many pre-HTTP/1.1 user agents do not understand the 303 + status. When interoperability with such clients is a concern, the + 302 status code may be used instead, since most user agents react + to a 302 response as described here for 303. + +10.3.5 304 Not Modified + + If the client has performed a conditional GET request and access is + allowed, but the document has not been modified, the server SHOULD + respond with this status code. The 304 response MUST NOT contain a + message-body, and thus is always terminated by the first empty line + after the header fields. + + The response MUST include the following header fields: + + - Date, unless its omission is required by section 14.18.1 + + + + + + + +Fielding, et al. Standards Track [Page 63] + +RFC 2616 HTTP/1.1 June 1999 + + + If a clockless origin server obeys these rules, and proxies and + clients add their own Date to any response received without one (as + already specified by [RFC 2068], section 14.19), caches will operate + correctly. + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the conditional GET used a strong cache validator (see section + 13.3.3), the response SHOULD NOT include other entity-headers. + Otherwise (i.e., the conditional GET used a weak validator), the + response MUST NOT include other entity-headers; this prevents + inconsistencies between cached entity-bodies and updated headers. + + If a 304 response indicates an entity not currently cached, then the + cache MUST disregard the response and repeat the request without the + conditional. + + If a cache uses a received 304 response to update a cache entry, the + cache MUST update the entry to reflect any new field values given in + the response. + +10.3.6 305 Use Proxy + + The requested resource MUST be accessed through the proxy given by + the Location field. The Location field gives the URI of the proxy. + The recipient is expected to repeat this single request via the + proxy. 305 responses MUST only be generated by origin servers. + + Note: RFC 2068 was not clear that 305 was intended to redirect a + single request, and to be generated by origin servers only. Not + observing these limitations has significant security consequences. + +10.3.7 306 (Unused) + + The 306 status code was used in a previous version of the + specification, is no longer used, and the code is reserved. + + + + + + + + + + +Fielding, et al. Standards Track [Page 64] + +RFC 2616 HTTP/1.1 June 1999 + + +10.3.8 307 Temporary Redirect + + The requested resource resides temporarily under a different URI. + Since the redirection MAY be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s) , since many pre-HTTP/1.1 user agents do not + understand the 307 status. Therefore, the note SHOULD contain the + information necessary for a user to repeat the original request on + the new URI. + + If the 307 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + +10.4 Client Error 4xx + + The 4xx class of status code is intended for cases in which the + client seems to have erred. Except when responding to a HEAD request, + the server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. These status codes are applicable to any request method. + User agents SHOULD display any included entity to the user. + + If the client is sending data, a server implementation using TCP + SHOULD be careful to ensure that the client acknowledges receipt of + the packet(s) containing the response, before the server closes the + input connection. If the client continues sending data to the server + after the close, the server's TCP stack will send a reset packet to + the client, which may erase the client's unacknowledged input buffers + before they can be read and interpreted by the HTTP application. + +10.4.1 400 Bad Request + + The request could not be understood by the server due to malformed + syntax. The client SHOULD NOT repeat the request without + modifications. + + + + + + + + +Fielding, et al. Standards Track [Page 65] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.2 401 Unauthorized + + The request requires user authentication. The response MUST include a + WWW-Authenticate header field (section 14.47) containing a challenge + applicable to the requested resource. The client MAY repeat the + request with a suitable Authorization header field (section 14.8). If + the request already included Authorization credentials, then the 401 + response indicates that authorization has been refused for those + credentials. If the 401 response contains the same challenge as the + prior response, and the user agent has already attempted + authentication at least once, then the user SHOULD be presented the + entity that was given in the response, since that entity might + include relevant diagnostic information. HTTP access authentication + is explained in "HTTP Authentication: Basic and Digest Access + Authentication" [43]. + +10.4.3 402 Payment Required + + This code is reserved for future use. + +10.4.4 403 Forbidden + + The server understood the request, but is refusing to fulfill it. + Authorization will not help and the request SHOULD NOT be repeated. + If the request method was not HEAD and the server wishes to make + public why the request has not been fulfilled, it SHOULD describe the + reason for the refusal in the entity. If the server does not wish to + make this information available to the client, the status code 404 + (Not Found) can be used instead. + +10.4.5 404 Not Found + + The server has not found anything matching the Request-URI. No + indication is given of whether the condition is temporary or + permanent. The 410 (Gone) status code SHOULD be used if the server + knows, through some internally configurable mechanism, that an old + resource is permanently unavailable and has no forwarding address. + This status code is commonly used when the server does not wish to + reveal exactly why the request has been refused, or when no other + response is applicable. + +10.4.6 405 Method Not Allowed + + The method specified in the Request-Line is not allowed for the + resource identified by the Request-URI. The response MUST include an + Allow header containing a list of valid methods for the requested + resource. + + + + +Fielding, et al. Standards Track [Page 66] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.7 406 Not Acceptable + + The resource identified by the request is only capable of generating + response entities which have content characteristics not acceptable + according to the accept headers sent in the request. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of available entity characteristics and location(s) + from which the user or user agent can choose the one most + appropriate. The entity format is specified by the media type given + in the Content-Type header field. Depending upon the format and the + capabilities of the user agent, selection of the most appropriate + choice MAY be performed automatically. However, this specification + does not define any standard for such automatic selection. + + Note: HTTP/1.1 servers are allowed to return responses which are + not acceptable according to the accept headers sent in the + request. In some cases, this may even be preferable to sending a + 406 response. User agents are encouraged to inspect the headers of + an incoming response to determine if it is acceptable. + + If the response could be unacceptable, a user agent SHOULD + temporarily stop receipt of more data and query the user for a + decision on further actions. + +10.4.8 407 Proxy Authentication Required + + This code is similar to 401 (Unauthorized), but indicates that the + client must first authenticate itself with the proxy. The proxy MUST + return a Proxy-Authenticate header field (section 14.33) containing a + challenge applicable to the proxy for the requested resource. The + client MAY repeat the request with a suitable Proxy-Authorization + header field (section 14.34). HTTP access authentication is explained + in "HTTP Authentication: Basic and Digest Access Authentication" + [43]. + +10.4.9 408 Request Timeout + + The client did not produce a request within the time that the server + was prepared to wait. The client MAY repeat the request without + modifications at any later time. + +10.4.10 409 Conflict + + The request could not be completed due to a conflict with the current + state of the resource. This code is only allowed in situations where + it is expected that the user might be able to resolve the conflict + and resubmit the request. The response body SHOULD include enough + + + +Fielding, et al. Standards Track [Page 67] + +RFC 2616 HTTP/1.1 June 1999 + + + information for the user to recognize the source of the conflict. + Ideally, the response entity would include enough information for the + user or user agent to fix the problem; however, that might not be + possible and is not required. + + Conflicts are most likely to occur in response to a PUT request. For + example, if versioning were being used and the entity being PUT + included changes to a resource which conflict with those made by an + earlier (third-party) request, the server might use the 409 response + to indicate that it can't complete the request. In this case, the + response entity would likely contain a list of the differences + between the two versions in a format defined by the response + Content-Type. + +10.4.11 410 Gone + + The requested resource is no longer available at the server and no + forwarding address is known. This condition is expected to be + considered permanent. Clients with link editing capabilities SHOULD + delete references to the Request-URI after user approval. If the + server does not know, or has no facility to determine, whether or not + the condition is permanent, the status code 404 (Not Found) SHOULD be + used instead. This response is cacheable unless indicated otherwise. + + The 410 response is primarily intended to assist the task of web + maintenance by notifying the recipient that the resource is + intentionally unavailable and that the server owners desire that + remote links to that resource be removed. Such an event is common for + limited-time, promotional services and for resources belonging to + individuals no longer working at the server's site. It is not + necessary to mark all permanently unavailable resources as "gone" or + to keep the mark for any length of time -- that is left to the + discretion of the server owner. + +10.4.12 411 Length Required + + The server refuses to accept the request without a defined Content- + Length. The client MAY repeat the request if it adds a valid + Content-Length header field containing the length of the message-body + in the request message. + +10.4.13 412 Precondition Failed + + The precondition given in one or more of the request-header fields + evaluated to false when it was tested on the server. This response + code allows the client to place preconditions on the current resource + metainformation (header field data) and thus prevent the requested + method from being applied to a resource other than the one intended. + + + +Fielding, et al. Standards Track [Page 68] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.14 413 Request Entity Too Large + + The server is refusing to process a request because the request + entity is larger than the server is willing or able to process. The + server MAY close the connection to prevent the client from continuing + the request. + + If the condition is temporary, the server SHOULD include a Retry- + After header field to indicate that it is temporary and after what + time the client MAY try again. + +10.4.15 414 Request-URI Too Long + + The server is refusing to service the request because the Request-URI + is longer than the server is willing to interpret. This rare + condition is only likely to occur when a client has improperly + converted a POST request to a GET request with long query + information, when the client has descended into a URI "black hole" of + redirection (e.g., a redirected URI prefix that points to a suffix of + itself), or when the server is under attack by a client attempting to + exploit security holes present in some servers using fixed-length + buffers for reading or manipulating the Request-URI. + +10.4.16 415 Unsupported Media Type + + The server is refusing to service the request because the entity of + the request is in a format not supported by the requested resource + for the requested method. + +10.4.17 416 Requested Range Not Satisfiable + + A server SHOULD return a response with this status code if a request + included a Range request-header field (section 14.35), and none of + the range-specifier values in this field overlap the current extent + of the selected resource, and the request did not include an If-Range + request-header field. (For byte-ranges, this means that the first- + byte-pos of all of the byte-range-spec values were greater than the + current length of the selected resource.) + + When this status code is returned for a byte-range request, the + response SHOULD include a Content-Range entity-header field + specifying the current length of the selected resource (see section + 14.16). This response MUST NOT use the multipart/byteranges content- + type. + + + + + + + +Fielding, et al. Standards Track [Page 69] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.18 417 Expectation Failed + + The expectation given in an Expect request-header field (see section + 14.20) could not be met by this server, or, if the server is a proxy, + the server has unambiguous evidence that the request could not be met + by the next-hop server. + +10.5 Server Error 5xx + + Response status codes beginning with the digit "5" indicate cases in + which the server is aware that it has erred or is incapable of + performing the request. Except when responding to a HEAD request, the + server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. User agents SHOULD display any included entity to the + user. These response codes are applicable to any request method. + +10.5.1 500 Internal Server Error + + The server encountered an unexpected condition which prevented it + from fulfilling the request. + +10.5.2 501 Not Implemented + + The server does not support the functionality required to fulfill the + request. This is the appropriate response when the server does not + recognize the request method and is not capable of supporting it for + any resource. + +10.5.3 502 Bad Gateway + + The server, while acting as a gateway or proxy, received an invalid + response from the upstream server it accessed in attempting to + fulfill the request. + +10.5.4 503 Service Unavailable + + The server is currently unable to handle the request due to a + temporary overloading or maintenance of the server. The implication + is that this is a temporary condition which will be alleviated after + some delay. If known, the length of the delay MAY be indicated in a + Retry-After header. If no Retry-After is given, the client SHOULD + handle the response as it would for a 500 response. + + Note: The existence of the 503 status code does not imply that a + server must use it when becoming overloaded. Some servers may wish + to simply refuse the connection. + + + + +Fielding, et al. Standards Track [Page 70] + +RFC 2616 HTTP/1.1 June 1999 + + +10.5.5 504 Gateway Timeout + + The server, while acting as a gateway or proxy, did not receive a + timely response from the upstream server specified by the URI (e.g. + HTTP, FTP, LDAP) or some other auxiliary server (e.g. DNS) it needed + to access in attempting to complete the request. + + Note: Note to implementors: some deployed proxies are known to + return 400 or 500 when DNS lookups time out. + +10.5.6 505 HTTP Version Not Supported + + The server does not support, or refuses to support, the HTTP protocol + version that was used in the request message. The server is + indicating that it is unable or unwilling to complete the request + using the same major version as the client, as described in section + 3.1, other than with this error message. The response SHOULD contain + an entity describing why that version is not supported and what other + protocols are supported by that server. + +11 Access Authentication + + HTTP provides several OPTIONAL challenge-response authentication + mechanisms which can be used by a server to challenge a client + request and by a client to provide authentication information. The + general framework for access authentication, and the specification of + "basic" and "digest" authentication, are specified in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. This + specification adopts the definitions of "challenge" and "credentials" + from that specification. + +12 Content Negotiation + + Most HTTP responses include an entity which contains information for + interpretation by a human user. Naturally, it is desirable to supply + the user with the "best available" entity corresponding to the + request. Unfortunately for servers and caches, not all users have the + same preferences for what is "best," and not all user agents are + equally capable of rendering all entity types. For that reason, HTTP + has provisions for several mechanisms for "content negotiation" -- + the process of selecting the best representation for a given response + when there are multiple representations available. + + Note: This is not called "format negotiation" because the + alternate representations may be of the same media type, but use + different capabilities of that type, be in different languages, + etc. + + + + +Fielding, et al. Standards Track [Page 71] + +RFC 2616 HTTP/1.1 June 1999 + + + Any response containing an entity-body MAY be subject to negotiation, + including error responses. + + There are two kinds of content negotiation which are possible in + HTTP: server-driven and agent-driven negotiation. These two kinds of + negotiation are orthogonal and thus may be used separately or in + combination. One method of combination, referred to as transparent + negotiation, occurs when a cache uses the agent-driven negotiation + information provided by the origin server in order to provide + server-driven negotiation for subsequent requests. + +12.1 Server-driven Negotiation + + If the selection of the best representation for a response is made by + an algorithm located at the server, it is called server-driven + negotiation. Selection is based on the available representations of + the response (the dimensions over which it can vary; e.g. language, + content-coding, etc.) and the contents of particular header fields in + the request message or on other information pertaining to the request + (such as the network address of the client). + + Server-driven negotiation is advantageous when the algorithm for + selecting from among the available representations is difficult to + describe to the user agent, or when the server desires to send its + "best guess" to the client along with the first response (hoping to + avoid the round-trip delay of a subsequent request if the "best + guess" is good enough for the user). In order to improve the server's + guess, the user agent MAY include request header fields (Accept, + Accept-Language, Accept-Encoding, etc.) which describe its + preferences for such a response. + + Server-driven negotiation has disadvantages: + + 1. It is impossible for the server to accurately determine what + might be "best" for any given user, since that would require + complete knowledge of both the capabilities of the user agent + and the intended use for the response (e.g., does the user want + to view it on screen or print it on paper?). + + 2. Having the user agent describe its capabilities in every + request can be both very inefficient (given that only a small + percentage of responses have multiple representations) and a + potential violation of the user's privacy. + + 3. It complicates the implementation of an origin server and the + algorithms for generating responses to a request. + + + + + +Fielding, et al. Standards Track [Page 72] + +RFC 2616 HTTP/1.1 June 1999 + + + 4. It may limit a public cache's ability to use the same response + for multiple user's requests. + + HTTP/1.1 includes the following request-header fields for enabling + server-driven negotiation through description of user agent + capabilities and user preferences: Accept (section 14.1), Accept- + Charset (section 14.2), Accept-Encoding (section 14.3), Accept- + Language (section 14.4), and User-Agent (section 14.43). However, an + origin server is not limited to these dimensions and MAY vary the + response based on any aspect of the request, including information + outside the request-header fields or within extension header fields + not defined by this specification. + + The Vary header field can be used to express the parameters the + server uses to select a representation that is subject to server- + driven negotiation. See section 13.6 for use of the Vary header field + by caches and section 14.44 for use of the Vary header field by + servers. + +12.2 Agent-driven Negotiation + + With agent-driven negotiation, selection of the best representation + for a response is performed by the user agent after receiving an + initial response from the origin server. Selection is based on a list + of the available representations of the response included within the + header fields or entity-body of the initial response, with each + representation identified by its own URI. Selection from among the + representations may be performed automatically (if the user agent is + capable of doing so) or manually by the user selecting from a + generated (possibly hypertext) menu. + + Agent-driven negotiation is advantageous when the response would vary + over commonly-used dimensions (such as type, language, or encoding), + when the origin server is unable to determine a user agent's + capabilities from examining the request, and generally when public + caches are used to distribute server load and reduce network usage. + + Agent-driven negotiation suffers from the disadvantage of needing a + second request to obtain the best alternate representation. This + second request is only efficient when caching is used. In addition, + this specification does not define any mechanism for supporting + automatic selection, though it also does not prevent any such + mechanism from being developed as an extension and used within + HTTP/1.1. + + + + + + + +Fielding, et al. Standards Track [Page 73] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 defines the 300 (Multiple Choices) and 406 (Not Acceptable) + status codes for enabling agent-driven negotiation when the server is + unwilling or unable to provide a varying response using server-driven + negotiation. + +12.3 Transparent Negotiation + + Transparent negotiation is a combination of both server-driven and + agent-driven negotiation. When a cache is supplied with a form of the + list of available representations of the response (as in agent-driven + negotiation) and the dimensions of variance are completely understood + by the cache, then the cache becomes capable of performing server- + driven negotiation on behalf of the origin server for subsequent + requests on that resource. + + Transparent negotiation has the advantage of distributing the + negotiation work that would otherwise be required of the origin + server and also removing the second request delay of agent-driven + negotiation when the cache is able to correctly guess the right + response. + + This specification does not define any mechanism for transparent + negotiation, though it also does not prevent any such mechanism from + being developed as an extension that could be used within HTTP/1.1. + +13 Caching in HTTP + + HTTP is typically used for distributed information systems, where + performance can be improved by the use of response caches. The + HTTP/1.1 protocol includes a number of elements intended to make + caching work as well as possible. Because these elements are + inextricable from other aspects of the protocol, and because they + interact with each other, it is useful to describe the basic caching + design of HTTP separately from the detailed descriptions of methods, + headers, response codes, etc. + + Caching would be useless if it did not significantly improve + performance. The goal of caching in HTTP/1.1 is to eliminate the need + to send requests in many cases, and to eliminate the need to send + full responses in many other cases. The former reduces the number of + network round-trips required for many operations; we use an + "expiration" mechanism for this purpose (see section 13.2). The + latter reduces network bandwidth requirements; we use a "validation" + mechanism for this purpose (see section 13.3). + + Requirements for performance, availability, and disconnected + operation require us to be able to relax the goal of semantic + transparency. The HTTP/1.1 protocol allows origin servers, caches, + + + +Fielding, et al. Standards Track [Page 74] + +RFC 2616 HTTP/1.1 June 1999 + + + and clients to explicitly reduce transparency when necessary. + However, because non-transparent operation may confuse non-expert + users, and might be incompatible with certain server applications + (such as those for ordering merchandise), the protocol requires that + transparency be relaxed + + - only by an explicit protocol-level request when relaxed by + client or origin server + + - only with an explicit warning to the end user when relaxed by + cache or client + + Therefore, the HTTP/1.1 protocol provides these important elements: + + 1. Protocol features that provide full semantic transparency when + this is required by all parties. + + 2. Protocol features that allow an origin server or user agent to + explicitly request and control non-transparent operation. + + 3. Protocol features that allow a cache to attach warnings to + responses that do not preserve the requested approximation of + semantic transparency. + + A basic principle is that it must be possible for the clients to + detect any potential relaxation of semantic transparency. + + Note: The server, cache, or client implementor might be faced with + design decisions not explicitly discussed in this specification. + If a decision might affect semantic transparency, the implementor + ought to err on the side of maintaining transparency unless a + careful and complete analysis shows significant benefits in + breaking transparency. + +13.1.1 Cache Correctness + + A correct cache MUST respond to a request with the most up-to-date + response held by the cache that is appropriate to the request (see + sections 13.2.5, 13.2.6, and 13.12) which meets one of the following + conditions: + + 1. It has been checked for equivalence with what the origin server + would have returned by revalidating the response with the + origin server (section 13.3); + + + + + + + +Fielding, et al. Standards Track [Page 75] + +RFC 2616 HTTP/1.1 June 1999 + + + 2. It is "fresh enough" (see section 13.2). In the default case, + this means it meets the least restrictive freshness requirement + of the client, origin server, and cache (see section 14.9); if + the origin server so specifies, it is the freshness requirement + of the origin server alone. + + If a stored response is not "fresh enough" by the most + restrictive freshness requirement of both the client and the + origin server, in carefully considered circumstances the cache + MAY still return the response with the appropriate Warning + header (see section 13.1.5 and 14.46), unless such a response + is prohibited (e.g., by a "no-store" cache-directive, or by a + "no-cache" cache-request-directive; see section 14.9). + + 3. It is an appropriate 304 (Not Modified), 305 (Proxy Redirect), + or error (4xx or 5xx) response message. + + If the cache can not communicate with the origin server, then a + correct cache SHOULD respond as above if the response can be + correctly served from the cache; if not it MUST return an error or + warning indicating that there was a communication failure. + + If a cache receives a response (either an entire response, or a 304 + (Not Modified) response) that it would normally forward to the + requesting client, and the received response is no longer fresh, the + cache SHOULD forward it to the requesting client without adding a new + Warning (but without removing any existing Warning headers). A cache + SHOULD NOT attempt to revalidate a response simply because that + response became stale in transit; this might lead to an infinite + loop. A user agent that receives a stale response without a Warning + MAY display a warning indication to the user. + +13.1.2 Warnings + + Whenever a cache returns a response that is neither first-hand nor + "fresh enough" (in the sense of condition 2 in section 13.1.1), it + MUST attach a warning to that effect, using a Warning general-header. + The Warning header and the currently defined warnings are described + in section 14.46. The warning allows clients to take appropriate + action. + + Warnings MAY be used for other purposes, both cache-related and + otherwise. The use of a warning, rather than an error status code, + distinguish these responses from true failures. + + Warnings are assigned three digit warn-codes. The first digit + indicates whether the Warning MUST or MUST NOT be deleted from a + stored cache entry after a successful revalidation: + + + +Fielding, et al. Standards Track [Page 76] + +RFC 2616 HTTP/1.1 June 1999 + + + 1xx Warnings that describe the freshness or revalidation status of + the response, and so MUST be deleted after a successful + revalidation. 1XX warn-codes MAY be generated by a cache only when + validating a cached entry. It MUST NOT be generated by clients. + + 2xx Warnings that describe some aspect of the entity body or entity + headers that is not rectified by a revalidation (for example, a + lossy compression of the entity bodies) and which MUST NOT be + deleted after a successful revalidation. + + See section 14.46 for the definitions of the codes themselves. + + HTTP/1.0 caches will cache all Warnings in responses, without + deleting the ones in the first category. Warnings in responses that + are passed to HTTP/1.0 caches carry an extra warning-date field, + which prevents a future HTTP/1.1 recipient from believing an + erroneously cached Warning. + + Warnings also carry a warning text. The text MAY be in any + appropriate natural language (perhaps based on the client's Accept + headers), and include an OPTIONAL indication of what character set is + used. + + Multiple warnings MAY be attached to a response (either by the origin + server or by a cache), including multiple warnings with the same code + number. For example, a server might provide the same warning with + texts in both English and Basque. + + When multiple warnings are attached to a response, it might not be + practical or reasonable to display all of them to the user. This + version of HTTP does not specify strict priority rules for deciding + which warnings to display and in what order, but does suggest some + heuristics. + +13.1.3 Cache-control Mechanisms + + The basic cache mechanisms in HTTP/1.1 (server-specified expiration + times and validators) are implicit directives to caches. In some + cases, a server or client might need to provide explicit directives + to the HTTP caches. We use the Cache-Control header for this purpose. + + The Cache-Control header allows a client or server to transmit a + variety of directives in either requests or responses. These + directives typically override the default caching algorithms. As a + general rule, if there is any apparent conflict between header + values, the most restrictive interpretation is applied (that is, the + one that is most likely to preserve semantic transparency). However, + + + + +Fielding, et al. Standards Track [Page 77] + +RFC 2616 HTTP/1.1 June 1999 + + + in some cases, cache-control directives are explicitly specified as + weakening the approximation of semantic transparency (for example, + "max-stale" or "public"). + + The cache-control directives are described in detail in section 14.9. + +13.1.4 Explicit User Agent Warnings + + Many user agents make it possible for users to override the basic + caching mechanisms. For example, the user agent might allow the user + to specify that cached entities (even explicitly stale ones) are + never validated. Or the user agent might habitually add "Cache- + Control: max-stale=3600" to every request. The user agent SHOULD NOT + default to either non-transparent behavior, or behavior that results + in abnormally ineffective caching, but MAY be explicitly configured + to do so by an explicit action of the user. + + If the user has overridden the basic caching mechanisms, the user + agent SHOULD explicitly indicate to the user whenever this results in + the display of information that might not meet the server's + transparency requirements (in particular, if the displayed entity is + known to be stale). Since the protocol normally allows the user agent + to determine if responses are stale or not, this indication need only + be displayed when this actually happens. The indication need not be a + dialog box; it could be an icon (for example, a picture of a rotting + fish) or some other indicator. + + If the user has overridden the caching mechanisms in a way that would + abnormally reduce the effectiveness of caches, the user agent SHOULD + continually indicate this state to the user (for example, by a + display of a picture of currency in flames) so that the user does not + inadvertently consume excess resources or suffer from excessive + latency. + +13.1.5 Exceptions to the Rules and Warnings + + In some cases, the operator of a cache MAY choose to configure it to + return stale responses even when not requested by clients. This + decision ought not be made lightly, but may be necessary for reasons + of availability or performance, especially when the cache is poorly + connected to the origin server. Whenever a cache returns a stale + response, it MUST mark it as such (using a Warning header) enabling + the client software to alert the user that there might be a potential + problem. + + + + + + + +Fielding, et al. Standards Track [Page 78] + +RFC 2616 HTTP/1.1 June 1999 + + + It also allows the user agent to take steps to obtain a first-hand or + fresh response. For this reason, a cache SHOULD NOT return a stale + response if the client explicitly requests a first-hand or fresh one, + unless it is impossible to comply for technical or policy reasons. + +13.1.6 Client-controlled Behavior + + While the origin server (and to a lesser extent, intermediate caches, + by their contribution to the age of a response) are the primary + source of expiration information, in some cases the client might need + to control a cache's decision about whether to return a cached + response without validating it. Clients do this using several + directives of the Cache-Control header. + + A client's request MAY specify the maximum age it is willing to + accept of an unvalidated response; specifying a value of zero forces + the cache(s) to revalidate all responses. A client MAY also specify + the minimum time remaining before a response expires. Both of these + options increase constraints on the behavior of caches, and so cannot + further relax the cache's approximation of semantic transparency. + + A client MAY also specify that it will accept stale responses, up to + some maximum amount of staleness. This loosens the constraints on the + caches, and so might violate the origin server's specified + constraints on semantic transparency, but might be necessary to + support disconnected operation, or high availability in the face of + poor connectivity. + +13.2 Expiration Model + +13.2.1 Server-Specified Expiration + + HTTP caching works best when caches can entirely avoid making + requests to the origin server. The primary mechanism for avoiding + requests is for an origin server to provide an explicit expiration + time in the future, indicating that a response MAY be used to satisfy + subsequent requests. In other words, a cache can return a fresh + response without first contacting the server. + + Our expectation is that servers will assign future explicit + expiration times to responses in the belief that the entity is not + likely to change, in a semantically significant way, before the + expiration time is reached. This normally preserves semantic + transparency, as long as the server's expiration times are carefully + chosen. + + + + + + +Fielding, et al. Standards Track [Page 79] + +RFC 2616 HTTP/1.1 June 1999 + + + The expiration mechanism applies only to responses taken from a cache + and not to first-hand responses forwarded immediately to the + requesting client. + + If an origin server wishes to force a semantically transparent cache + to validate every request, it MAY assign an explicit expiration time + in the past. This means that the response is always stale, and so the + cache SHOULD validate it before using it for subsequent requests. See + section 14.9.4 for a more restrictive way to force revalidation. + + If an origin server wishes to force any HTTP/1.1 cache, no matter how + it is configured, to validate every request, it SHOULD use the "must- + revalidate" cache-control directive (see section 14.9). + + Servers specify explicit expiration times using either the Expires + header, or the max-age directive of the Cache-Control header. + + An expiration time cannot be used to force a user agent to refresh + its display or reload a resource; its semantics apply only to caching + mechanisms, and such mechanisms need only check a resource's + expiration status when a new request for that resource is initiated. + See section 13.13 for an explanation of the difference between caches + and history mechanisms. + +13.2.2 Heuristic Expiration + + Since origin servers do not always provide explicit expiration times, + HTTP caches typically assign heuristic expiration times, employing + algorithms that use other header values (such as the Last-Modified + time) to estimate a plausible expiration time. The HTTP/1.1 + specification does not provide specific algorithms, but does impose + worst-case constraints on their results. Since heuristic expiration + times might compromise semantic transparency, they ought to used + cautiously, and we encourage origin servers to provide explicit + expiration times as much as possible. + +13.2.3 Age Calculations + + In order to know if a cached entry is fresh, a cache needs to know if + its age exceeds its freshness lifetime. We discuss how to calculate + the latter in section 13.2.4; this section describes how to calculate + the age of a response or cache entry. + + In this discussion, we use the term "now" to mean "the current value + of the clock at the host performing the calculation." Hosts that use + HTTP, but especially hosts running origin servers and caches, SHOULD + use NTP [28] or some similar protocol to synchronize their clocks to + a globally accurate time standard. + + + +Fielding, et al. Standards Track [Page 80] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 requires origin servers to send a Date header, if possible, + with every response, giving the time at which the response was + generated (see section 14.18). We use the term "date_value" to denote + the value of the Date header, in a form appropriate for arithmetic + operations. + + HTTP/1.1 uses the Age response-header to convey the estimated age of + the response message when obtained from a cache. The Age field value + is the cache's estimate of the amount of time since the response was + generated or revalidated by the origin server. + + In essence, the Age value is the sum of the time that the response + has been resident in each of the caches along the path from the + origin server, plus the amount of time it has been in transit along + network paths. + + We use the term "age_value" to denote the value of the Age header, in + a form appropriate for arithmetic operations. + + A response's age can be calculated in two entirely independent ways: + + 1. now minus date_value, if the local clock is reasonably well + synchronized to the origin server's clock. If the result is + negative, the result is replaced by zero. + + 2. age_value, if all of the caches along the response path + implement HTTP/1.1. + + Given that we have two independent ways to compute the age of a + response when it is received, we can combine these as + + corrected_received_age = max(now - date_value, age_value) + + and as long as we have either nearly synchronized clocks or all- + HTTP/1.1 paths, one gets a reliable (conservative) result. + + Because of network-imposed delays, some significant interval might + pass between the time that a server generates a response and the time + it is received at the next outbound cache or client. If uncorrected, + this delay could result in improperly low ages. + + Because the request that resulted in the returned Age value must have + been initiated prior to that Age value's generation, we can correct + for delays imposed by the network by recording the time at which the + request was initiated. Then, when an Age value is received, it MUST + be interpreted relative to the time the request was initiated, not + + + + + +Fielding, et al. Standards Track [Page 81] + +RFC 2616 HTTP/1.1 June 1999 + + + the time that the response was received. This algorithm results in + conservative behavior no matter how much delay is experienced. So, we + compute: + + corrected_initial_age = corrected_received_age + + (now - request_time) + + where "request_time" is the time (according to the local clock) when + the request that elicited this response was sent. + + Summary of age calculation algorithm, when a cache receives a + response: + + /* + * age_value + * is the value of Age: header received by the cache with + * this response. + * date_value + * is the value of the origin server's Date: header + * request_time + * is the (local) time when the cache made the request + * that resulted in this cached response + * response_time + * is the (local) time when the cache received the + * response + * now + * is the current (local) time + */ + + apparent_age = max(0, response_time - date_value); + corrected_received_age = max(apparent_age, age_value); + response_delay = response_time - request_time; + corrected_initial_age = corrected_received_age + response_delay; + resident_time = now - response_time; + current_age = corrected_initial_age + resident_time; + + The current_age of a cache entry is calculated by adding the amount + of time (in seconds) since the cache entry was last validated by the + origin server to the corrected_initial_age. When a response is + generated from a cache entry, the cache MUST include a single Age + header field in the response with a value equal to the cache entry's + current_age. + + The presence of an Age header field in a response implies that a + response is not first-hand. However, the converse is not true, since + the lack of an Age header field in a response does not imply that the + + + + + +Fielding, et al. Standards Track [Page 82] + +RFC 2616 HTTP/1.1 June 1999 + + + response is first-hand unless all caches along the request path are + compliant with HTTP/1.1 (i.e., older HTTP caches did not implement + the Age header field). + +13.2.4 Expiration Calculations + + In order to decide whether a response is fresh or stale, we need to + compare its freshness lifetime to its age. The age is calculated as + described in section 13.2.3; this section describes how to calculate + the freshness lifetime, and to determine if a response has expired. + In the discussion below, the values can be represented in any form + appropriate for arithmetic operations. + + We use the term "expires_value" to denote the value of the Expires + header. We use the term "max_age_value" to denote an appropriate + value of the number of seconds carried by the "max-age" directive of + the Cache-Control header in a response (see section 14.9.3). + + The max-age directive takes priority over Expires, so if max-age is + present in a response, the calculation is simply: + + freshness_lifetime = max_age_value + + Otherwise, if Expires is present in the response, the calculation is: + + freshness_lifetime = expires_value - date_value + + Note that neither of these calculations is vulnerable to clock skew, + since all of the information comes from the origin server. + + If none of Expires, Cache-Control: max-age, or Cache-Control: s- + maxage (see section 14.9.3) appears in the response, and the response + does not include other restrictions on caching, the cache MAY compute + a freshness lifetime using a heuristic. The cache MUST attach Warning + 113 to any response whose age is more than 24 hours if such warning + has not already been added. + + Also, if the response does have a Last-Modified time, the heuristic + expiration value SHOULD be no more than some fraction of the interval + since that time. A typical setting of this fraction might be 10%. + + The calculation to determine if a response has expired is quite + simple: + + response_is_fresh = (freshness_lifetime > current_age) + + + + + + +Fielding, et al. Standards Track [Page 83] + +RFC 2616 HTTP/1.1 June 1999 + + +13.2.5 Disambiguating Expiration Values + + Because expiration values are assigned optimistically, it is possible + for two caches to contain fresh values for the same resource that are + different. + + If a client performing a retrieval receives a non-first-hand response + for a request that was already fresh in its own cache, and the Date + header in its existing cache entry is newer than the Date on the new + response, then the client MAY ignore the response. If so, it MAY + retry the request with a "Cache-Control: max-age=0" directive (see + section 14.9), to force a check with the origin server. + + If a cache has two fresh responses for the same representation with + different validators, it MUST use the one with the more recent Date + header. This situation might arise because the cache is pooling + responses from other caches, or because a client has asked for a + reload or a revalidation of an apparently fresh cache entry. + +13.2.6 Disambiguating Multiple Responses + + Because a client might be receiving responses via multiple paths, so + that some responses flow through one set of caches and other + responses flow through a different set of caches, a client might + receive responses in an order different from that in which the origin + server sent them. We would like the client to use the most recently + generated response, even if older responses are still apparently + fresh. + + Neither the entity tag nor the expiration value can impose an + ordering on responses, since it is possible that a later response + intentionally carries an earlier expiration time. The Date values are + ordered to a granularity of one second. + + When a client tries to revalidate a cache entry, and the response it + receives contains a Date header that appears to be older than the one + for the existing entry, then the client SHOULD repeat the request + unconditionally, and include + + Cache-Control: max-age=0 + + to force any intermediate caches to validate their copies directly + with the origin server, or + + Cache-Control: no-cache + + to force any intermediate caches to obtain a new copy from the origin + server. + + + +Fielding, et al. Standards Track [Page 84] + +RFC 2616 HTTP/1.1 June 1999 + + + If the Date values are equal, then the client MAY use either response + (or MAY, if it is being extremely prudent, request a new response). + Servers MUST NOT depend on clients being able to choose + deterministically between responses generated during the same second, + if their expiration times overlap. + +13.3 Validation Model + + When a cache has a stale entry that it would like to use as a + response to a client's request, it first has to check with the origin + server (or possibly an intermediate cache with a fresh response) to + see if its cached entry is still usable. We call this "validating" + the cache entry. Since we do not want to have to pay the overhead of + retransmitting the full response if the cached entry is good, and we + do not want to pay the overhead of an extra round trip if the cached + entry is invalid, the HTTP/1.1 protocol supports the use of + conditional methods. + + The key protocol features for supporting conditional methods are + those concerned with "cache validators." When an origin server + generates a full response, it attaches some sort of validator to it, + which is kept with the cache entry. When a client (user agent or + proxy cache) makes a conditional request for a resource for which it + has a cache entry, it includes the associated validator in the + request. + + The server then checks that validator against the current validator + for the entity, and, if they match (see section 13.3.3), it responds + with a special status code (usually, 304 (Not Modified)) and no + entity-body. Otherwise, it returns a full response (including + entity-body). Thus, we avoid transmitting the full response if the + validator matches, and we avoid an extra round trip if it does not + match. + + In HTTP/1.1, a conditional request looks exactly the same as a normal + request for the same resource, except that it carries a special + header (which includes the validator) that implicitly turns the + method (usually, GET) into a conditional. + + The protocol includes both positive and negative senses of cache- + validating conditions. That is, it is possible to request either that + a method be performed if and only if a validator matches or if and + only if no validators match. + + + + + + + + +Fielding, et al. Standards Track [Page 85] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: a response that lacks a validator may still be cached, and + served from cache until it expires, unless this is explicitly + prohibited by a cache-control directive. However, a cache cannot + do a conditional retrieval if it does not have a validator for the + entity, which means it will not be refreshable after it expires. + +13.3.1 Last-Modified Dates + + The Last-Modified entity-header field value is often used as a cache + validator. In simple terms, a cache entry is considered to be valid + if the entity has not been modified since the Last-Modified value. + +13.3.2 Entity Tag Cache Validators + + The ETag response-header field value, an entity tag, provides for an + "opaque" cache validator. This might allow more reliable validation + in situations where it is inconvenient to store modification dates, + where the one-second resolution of HTTP date values is not + sufficient, or where the origin server wishes to avoid certain + paradoxes that might arise from the use of modification dates. + + Entity Tags are described in section 3.11. The headers used with + entity tags are described in sections 14.19, 14.24, 14.26 and 14.44. + +13.3.3 Weak and Strong Validators + + Since both origin servers and caches will compare two validators to + decide if they represent the same or different entities, one normally + would expect that if the entity (the entity-body or any entity- + headers) changes in any way, then the associated validator would + change as well. If this is true, then we call this validator a + "strong validator." + + However, there might be cases when a server prefers to change the + validator only on semantically significant changes, and not when + insignificant aspects of the entity change. A validator that does not + always change when the resource changes is a "weak validator." + + Entity tags are normally "strong validators," but the protocol + provides a mechanism to tag an entity tag as "weak." One can think of + a strong validator as one that changes whenever the bits of an entity + changes, while a weak value changes whenever the meaning of an entity + changes. Alternatively, one can think of a strong validator as part + of an identifier for a specific entity, while a weak validator is + part of an identifier for a set of semantically equivalent entities. + + Note: One example of a strong validator is an integer that is + incremented in stable storage every time an entity is changed. + + + +Fielding, et al. Standards Track [Page 86] + +RFC 2616 HTTP/1.1 June 1999 + + + An entity's modification time, if represented with one-second + resolution, could be a weak validator, since it is possible that + the resource might be modified twice during a single second. + + Support for weak validators is optional. However, weak validators + allow for more efficient caching of equivalent objects; for + example, a hit counter on a site is probably good enough if it is + updated every few days or weeks, and any value during that period + is likely "good enough" to be equivalent. + + A "use" of a validator is either when a client generates a request + and includes the validator in a validating header field, or when a + server compares two validators. + + Strong validators are usable in any context. Weak validators are only + usable in contexts that do not depend on exact equality of an entity. + For example, either kind is usable for a conditional GET of a full + entity. However, only a strong validator is usable for a sub-range + retrieval, since otherwise the client might end up with an internally + inconsistent entity. + + Clients MAY issue simple (non-subrange) GET requests with either weak + validators or strong validators. Clients MUST NOT use weak validators + in other forms of request. + + The only function that the HTTP/1.1 protocol defines on validators is + comparison. There are two validator comparison functions, depending + on whether the comparison context allows the use of weak validators + or not: + + - The strong comparison function: in order to be considered equal, + both validators MUST be identical in every way, and both MUST + NOT be weak. + + - The weak comparison function: in order to be considered equal, + both validators MUST be identical in every way, but either or + both of them MAY be tagged as "weak" without affecting the + result. + + An entity tag is strong unless it is explicitly tagged as weak. + Section 3.11 gives the syntax for entity tags. + + A Last-Modified time, when used as a validator in a request, is + implicitly weak unless it is possible to deduce that it is strong, + using the following rules: + + - The validator is being compared by an origin server to the + actual current validator for the entity and, + + + +Fielding, et al. Standards Track [Page 87] + +RFC 2616 HTTP/1.1 June 1999 + + + - That origin server reliably knows that the associated entity did + not change twice during the second covered by the presented + validator. + + or + + - The validator is about to be used by a client in an If- + Modified-Since or If-Unmodified-Since header, because the client + has a cache entry for the associated entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + or + + - The validator is being compared by an intermediate cache to the + validator stored in its cache entry for the entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + This method relies on the fact that if two different responses were + sent by the origin server during the same second, but both had the + same Last-Modified time, then at least one of those responses would + have a Date value equal to its Last-Modified time. The arbitrary 60- + second limit guards against the possibility that the Date and Last- + Modified values are generated from different clocks, or at somewhat + different times during the preparation of the response. An + implementation MAY use a value larger than 60 seconds, if it is + believed that 60 seconds is too short. + + If a client wishes to perform a sub-range retrieval on a value for + which it has only a Last-Modified time and no opaque validator, it + MAY do this only if the Last-Modified time is strong in the sense + described here. + + A cache or origin server receiving a conditional request, other than + a full-body GET request, MUST use the strong comparison function to + evaluate the condition. + + These rules allow HTTP/1.1 caches and clients to safely perform sub- + range retrievals on values that have been obtained from HTTP/1.0 + + + +Fielding, et al. Standards Track [Page 88] + +RFC 2616 HTTP/1.1 June 1999 + + + servers. + +13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates + + We adopt a set of rules and recommendations for origin servers, + clients, and caches regarding when various validator types ought to + be used, and for what purposes. + + HTTP/1.1 origin servers: + + - SHOULD send an entity tag validator unless it is not feasible to + generate one. + + - MAY send a weak entity tag instead of a strong entity tag, if + performance considerations support the use of weak entity tags, + or if it is unfeasible to send a strong entity tag. + + - SHOULD send a Last-Modified value if it is feasible to send one, + unless the risk of a breakdown in semantic transparency that + could result from using this date in an If-Modified-Since header + would lead to serious problems. + + In other words, the preferred behavior for an HTTP/1.1 origin server + is to send both a strong entity tag and a Last-Modified value. + + In order to be legal, a strong entity tag MUST change whenever the + associated entity value changes in any way. A weak entity tag SHOULD + change whenever the associated entity changes in a semantically + significant way. + + Note: in order to provide semantically transparent caching, an + origin server must avoid reusing a specific strong entity tag + value for two different entities, or reusing a specific weak + entity tag value for two semantically different entities. Cache + entries might persist for arbitrarily long periods, regardless of + expiration times, so it might be inappropriate to expect that a + cache will never again attempt to validate an entry using a + validator that it obtained at some point in the past. + + HTTP/1.1 clients: + + - If an entity tag has been provided by the origin server, MUST + use that entity tag in any cache-conditional request (using If- + Match or If-None-Match). + + - If only a Last-Modified value has been provided by the origin + server, SHOULD use that value in non-subrange cache-conditional + requests (using If-Modified-Since). + + + +Fielding, et al. Standards Track [Page 89] + +RFC 2616 HTTP/1.1 June 1999 + + + - If only a Last-Modified value has been provided by an HTTP/1.0 + origin server, MAY use that value in subrange cache-conditional + requests (using If-Unmodified-Since:). The user agent SHOULD + provide a way to disable this, in case of difficulty. + + - If both an entity tag and a Last-Modified value have been + provided by the origin server, SHOULD use both validators in + cache-conditional requests. This allows both HTTP/1.0 and + HTTP/1.1 caches to respond appropriately. + + An HTTP/1.1 origin server, upon receiving a conditional request that + includes both a Last-Modified date (e.g., in an If-Modified-Since or + If-Unmodified-Since header field) and one or more entity tags (e.g., + in an If-Match, If-None-Match, or If-Range header field) as cache + validators, MUST NOT return a response status of 304 (Not Modified) + unless doing so is consistent with all of the conditional header + fields in the request. + + An HTTP/1.1 caching proxy, upon receiving a conditional request that + includes both a Last-Modified date and one or more entity tags as + cache validators, MUST NOT return a locally cached response to the + client unless that cached response is consistent with all of the + conditional header fields in the request. + + Note: The general principle behind these rules is that HTTP/1.1 + servers and clients should transmit as much non-redundant + information as is available in their responses and requests. + HTTP/1.1 systems receiving this information will make the most + conservative assumptions about the validators they receive. + + HTTP/1.0 clients and caches will ignore entity tags. Generally, + last-modified values received or used by these systems will + support transparent and efficient caching, and so HTTP/1.1 origin + servers should provide Last-Modified values. In those rare cases + where the use of a Last-Modified value as a validator by an + HTTP/1.0 system could result in a serious problem, then HTTP/1.1 + origin servers should not provide one. + +13.3.5 Non-validating Conditionals + + The principle behind entity tags is that only the service author + knows the semantics of a resource well enough to select an + appropriate cache validation mechanism, and the specification of any + validator comparison function more complex than byte-equality would + open up a can of worms. Thus, comparisons of any other headers + (except Last-Modified, for compatibility with HTTP/1.0) are never + used for purposes of validating a cache entry. + + + + +Fielding, et al. Standards Track [Page 90] + +RFC 2616 HTTP/1.1 June 1999 + + +13.4 Response Cacheability + + Unless specifically constrained by a cache-control (section 14.9) + directive, a caching system MAY always store a successful response + (see section 13.8) as a cache entry, MAY return it without validation + if it is fresh, and MAY return it after successful validation. If + there is neither a cache validator nor an explicit expiration time + associated with a response, we do not expect it to be cached, but + certain caches MAY violate this expectation (for example, when little + or no network connectivity is available). A client can usually detect + that such a response was taken from a cache by comparing the Date + header to the current time. + + Note: some HTTP/1.0 caches are known to violate this expectation + without providing any Warning. + + However, in some cases it might be inappropriate for a cache to + retain an entity, or to return it in response to a subsequent + request. This might be because absolute semantic transparency is + deemed necessary by the service author, or because of security or + privacy considerations. Certain cache-control directives are + therefore provided so that the server can indicate that certain + resource entities, or portions thereof, are not to be cached + regardless of other considerations. + + Note that section 14.8 normally prevents a shared cache from saving + and returning a response to a previous request if that request + included an Authorization header. + + A response received with a status code of 200, 203, 206, 300, 301 or + 410 MAY be stored by a cache and used in reply to a subsequent + request, subject to the expiration mechanism, unless a cache-control + directive prohibits caching. However, a cache that does not support + the Range and Content-Range headers MUST NOT cache 206 (Partial + Content) responses. + + A response received with any other status code (e.g. status codes 302 + and 307) MUST NOT be returned in a reply to a subsequent request + unless there are cache-control directives or another header(s) that + explicitly allow it. For example, these include the following: an + Expires header (section 14.21); a "max-age", "s-maxage", "must- + revalidate", "proxy-revalidate", "public" or "private" cache-control + directive (section 14.9). + + + + + + + + +Fielding, et al. Standards Track [Page 91] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5 Constructing Responses From Caches + + The purpose of an HTTP cache is to store information received in + response to requests for use in responding to future requests. In + many cases, a cache simply returns the appropriate parts of a + response to the requester. However, if the cache holds a cache entry + based on a previous response, it might have to combine parts of a new + response with what is held in the cache entry. + +13.5.1 End-to-end and Hop-by-hop Headers + + For the purpose of defining the behavior of caches and non-caching + proxies, we divide HTTP headers into two categories: + + - End-to-end headers, which are transmitted to the ultimate + recipient of a request or response. End-to-end headers in + responses MUST be stored as part of a cache entry and MUST be + transmitted in any response formed from a cache entry. + + - Hop-by-hop headers, which are meaningful only for a single + transport-level connection, and are not stored by caches or + forwarded by proxies. + + The following HTTP/1.1 headers are hop-by-hop headers: + + - Connection + - Keep-Alive + - Proxy-Authenticate + - Proxy-Authorization + - TE + - Trailers + - Transfer-Encoding + - Upgrade + + All other headers defined by HTTP/1.1 are end-to-end headers. + + Other hop-by-hop headers MUST be listed in a Connection header, + (section 14.10) to be introduced into HTTP/1.1 (or later). + +13.5.2 Non-modifiable Headers + + Some features of the HTTP/1.1 protocol, such as Digest + Authentication, depend on the value of certain end-to-end headers. A + transparent proxy SHOULD NOT modify an end-to-end header unless the + definition of that header requires or specifically allows that. + + + + + + +Fielding, et al. Standards Track [Page 92] + +RFC 2616 HTTP/1.1 June 1999 + + + A transparent proxy MUST NOT modify any of the following fields in a + request or response, and it MUST NOT add any of these fields if not + already present: + + - Content-Location + + - Content-MD5 + + - ETag + + - Last-Modified + + A transparent proxy MUST NOT modify any of the following fields in a + response: + + - Expires + + but it MAY add any of these fields if not already present. If an + Expires header is added, it MUST be given a field-value identical to + that of the Date header in that response. + + A proxy MUST NOT modify or add any of the following fields in a + message that contains the no-transform cache-control directive, or in + any request: + + - Content-Encoding + + - Content-Range + + - Content-Type + + A non-transparent proxy MAY modify or add these fields to a message + that does not include no-transform, but if it does so, it MUST add a + Warning 214 (Transformation applied) if one does not already appear + in the message (see section 14.46). + + Warning: unnecessary modification of end-to-end headers might + cause authentication failures if stronger authentication + mechanisms are introduced in later versions of HTTP. Such + authentication mechanisms MAY rely on the values of header fields + not listed here. + + The Content-Length field of a request or response is added or deleted + according to the rules in section 4.4. A transparent proxy MUST + preserve the entity-length (section 7.2.2) of the entity-body, + although it MAY change the transfer-length (section 4.4). + + + + + +Fielding, et al. Standards Track [Page 93] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.3 Combining Headers + + When a cache makes a validating request to a server, and the server + provides a 304 (Not Modified) response or a 206 (Partial Content) + response, the cache then constructs a response to send to the + requesting client. + + If the status code is 304 (Not Modified), the cache uses the entity- + body stored in the cache entry as the entity-body of this outgoing + response. If the status code is 206 (Partial Content) and the ETag or + Last-Modified headers match exactly, the cache MAY combine the + contents stored in the cache entry with the new contents received in + the response and use the result as the entity-body of this outgoing + response, (see 13.5.4). + + The end-to-end headers stored in the cache entry are used for the + constructed response, except that + + - any stored Warning headers with warn-code 1xx (see section + 14.46) MUST be deleted from the cache entry and the forwarded + response. + + - any stored Warning headers with warn-code 2xx MUST be retained + in the cache entry and the forwarded response. + + - any end-to-end headers provided in the 304 or 206 response MUST + replace the corresponding headers from the cache entry. + + Unless the cache decides to remove the cache entry, it MUST also + replace the end-to-end headers stored with the cache entry with + corresponding headers received in the incoming response, except for + Warning headers as described immediately above. If a header field- + name in the incoming response matches more than one header in the + cache entry, all such old headers MUST be replaced. + + In other words, the set of end-to-end headers received in the + incoming response overrides all corresponding end-to-end headers + stored with the cache entry (except for stored Warning headers with + warn-code 1xx, which are deleted even if not overridden). + + Note: this rule allows an origin server to use a 304 (Not + Modified) or a 206 (Partial Content) response to update any header + associated with a previous response for the same entity or sub- + ranges thereof, although it might not always be meaningful or + correct to do so. This rule does not allow an origin server to use + a 304 (Not Modified) or a 206 (Partial Content) response to + entirely delete a header that it had provided with a previous + response. + + + +Fielding, et al. Standards Track [Page 94] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.4 Combining Byte Ranges + + A response might transfer only a subrange of the bytes of an entity- + body, either because the request included one or more Range + specifications, or because a connection was broken prematurely. After + several such transfers, a cache might have received several ranges of + the same entity-body. + + If a cache has a stored non-empty set of subranges for an entity, and + an incoming response transfers another subrange, the cache MAY + combine the new subrange with the existing set if both the following + conditions are met: + + - Both the incoming response and the cache entry have a cache + validator. + + - The two cache validators match using the strong comparison + function (see section 13.3.3). + + If either requirement is not met, the cache MUST use only the most + recent partial response (based on the Date values transmitted with + every response, and using the incoming response if these values are + equal or missing), and MUST discard the other partial information. + +13.6 Caching Negotiated Responses + + Use of server-driven content negotiation (section 12.1), as indicated + by the presence of a Vary header field in a response, alters the + conditions and procedure by which a cache can use the response for + subsequent requests. See section 14.44 for use of the Vary header + field by servers. + + A server SHOULD use the Vary header field to inform a cache of what + request-header fields were used to select among multiple + representations of a cacheable response subject to server-driven + negotiation. The set of header fields named by the Vary field value + is known as the "selecting" request-headers. + + When the cache receives a subsequent request whose Request-URI + specifies one or more cache entries including a Vary header field, + the cache MUST NOT use such a cache entry to construct a response to + the new request unless all of the selecting request-headers present + in the new request match the corresponding stored request-headers in + the original request. + + The selecting request-headers from two requests are defined to match + if and only if the selecting request-headers in the first request can + be transformed to the selecting request-headers in the second request + + + +Fielding, et al. Standards Track [Page 95] + +RFC 2616 HTTP/1.1 June 1999 + + + by adding or removing linear white space (LWS) at places where this + is allowed by the corresponding BNF, and/or combining multiple + message-header fields with the same field name following the rules + about message headers in section 4.2. + + A Vary header field-value of "*" always fails to match and subsequent + requests on that resource can only be properly interpreted by the + origin server. + + If the selecting request header fields for the cached entry do not + match the selecting request header fields of the new request, then + the cache MUST NOT use a cached entry to satisfy the request unless + it first relays the new request to the origin server in a conditional + request and the server responds with 304 (Not Modified), including an + entity tag or Content-Location that indicates the entity to be used. + + If an entity tag was assigned to a cached representation, the + forwarded request SHOULD be conditional and include the entity tags + in an If-None-Match header field from all its cache entries for the + resource. This conveys to the server the set of entities currently + held by the cache, so that if any one of these entities matches the + requested entity, the server can use the ETag header field in its 304 + (Not Modified) response to tell the cache which entry is appropriate. + If the entity-tag of the new response matches that of an existing + entry, the new response SHOULD be used to update the header fields of + the existing entry, and the result MUST be returned to the client. + + If any of the existing cache entries contains only partial content + for the associated entity, its entity-tag SHOULD NOT be included in + the If-None-Match header field unless the request is for a range that + would be fully satisfied by that entry. + + If a cache receives a successful response whose Content-Location + field matches that of an existing cache entry for the same Request- + ]URI, whose entity-tag differs from that of the existing entry, and + whose Date is more recent than that of the existing entry, the + existing entry SHOULD NOT be returned in response to future requests + and SHOULD be deleted from the cache. + +13.7 Shared and Non-Shared Caches + + For reasons of security and privacy, it is necessary to make a + distinction between "shared" and "non-shared" caches. A non-shared + cache is one that is accessible only to a single user. Accessibility + in this case SHOULD be enforced by appropriate security mechanisms. + All other caches are considered to be "shared." Other sections of + + + + + +Fielding, et al. Standards Track [Page 96] + +RFC 2616 HTTP/1.1 June 1999 + + + this specification place certain constraints on the operation of + shared caches in order to prevent loss of privacy or failure of + access controls. + +13.8 Errors or Incomplete Response Cache Behavior + + A cache that receives an incomplete response (for example, with fewer + bytes of data than specified in a Content-Length header) MAY store + the response. However, the cache MUST treat this as a partial + response. Partial responses MAY be combined as described in section + 13.5.4; the result might be a full response or might still be + partial. A cache MUST NOT return a partial response to a client + without explicitly marking it as such, using the 206 (Partial + Content) status code. A cache MUST NOT return a partial response + using a status code of 200 (OK). + + If a cache receives a 5xx response while attempting to revalidate an + entry, it MAY either forward this response to the requesting client, + or act as if the server failed to respond. In the latter case, it MAY + return a previously received response unless the cached entry + includes the "must-revalidate" cache-control directive (see section + 14.9). + +13.9 Side Effects of GET and HEAD + + Unless the origin server explicitly prohibits the caching of their + responses, the application of GET and HEAD methods to any resources + SHOULD NOT have side effects that would lead to erroneous behavior if + these responses are taken from a cache. They MAY still have side + effects, but a cache is not required to consider such side effects in + its caching decisions. Caches are always expected to observe an + origin server's explicit restrictions on caching. + + We note one exception to this rule: since some applications have + traditionally used GETs and HEADs with query URLs (those containing a + "?" in the rel_path part) to perform operations with significant side + effects, caches MUST NOT treat responses to such URIs as fresh unless + the server provides an explicit expiration time. This specifically + means that responses from HTTP/1.0 servers for such URIs SHOULD NOT + be taken from a cache. See section 9.1.1 for related information. + +13.10 Invalidation After Updates or Deletions + + The effect of certain methods performed on a resource at the origin + server might cause one or more existing cache entries to become non- + transparently invalid. That is, although they might continue to be + "fresh," they do not accurately reflect what the origin server would + return for a new request on that resource. + + + +Fielding, et al. Standards Track [Page 97] + +RFC 2616 HTTP/1.1 June 1999 + + + There is no way for the HTTP protocol to guarantee that all such + cache entries are marked invalid. For example, the request that + caused the change at the origin server might not have gone through + the proxy where a cache entry is stored. However, several rules help + reduce the likelihood of erroneous behavior. + + In this section, the phrase "invalidate an entity" means that the + cache will either remove all instances of that entity from its + storage, or will mark these as "invalid" and in need of a mandatory + revalidation before they can be returned in response to a subsequent + request. + + Some HTTP methods MUST cause a cache to invalidate an entity. This is + either the entity referred to by the Request-URI, or by the Location + or Content-Location headers (if present). These methods are: + + - PUT + + - DELETE + + - POST + + In order to prevent denial of service attacks, an invalidation based + on the URI in a Location or Content-Location header MUST only be + performed if the host part is the same as in the Request-URI. + + A cache that passes through requests for methods it does not + understand SHOULD invalidate any entities referred to by the + Request-URI. + +13.11 Write-Through Mandatory + + All methods that might be expected to cause modifications to the + origin server's resources MUST be written through to the origin + server. This currently includes all methods except for GET and HEAD. + A cache MUST NOT reply to such a request from a client before having + transmitted the request to the inbound server, and having received a + corresponding response from the inbound server. This does not prevent + a proxy cache from sending a 100 (Continue) response before the + inbound server has sent its final reply. + + The alternative (known as "write-back" or "copy-back" caching) is not + allowed in HTTP/1.1, due to the difficulty of providing consistent + updates and the problems arising from server, cache, or network + failure prior to write-back. + + + + + + +Fielding, et al. Standards Track [Page 98] + +RFC 2616 HTTP/1.1 June 1999 + + +13.12 Cache Replacement + + If a new cacheable (see sections 14.9.2, 13.2.5, 13.2.6 and 13.8) + response is received from a resource while any existing responses for + the same resource are cached, the cache SHOULD use the new response + to reply to the current request. It MAY insert it into cache storage + and MAY, if it meets all other requirements, use it to respond to any + future requests that would previously have caused the old response to + be returned. If it inserts the new response into cache storage the + rules in section 13.5.3 apply. + + Note: a new response that has an older Date header value than + existing cached responses is not cacheable. + +13.13 History Lists + + User agents often have history mechanisms, such as "Back" buttons and + history lists, which can be used to redisplay an entity retrieved + earlier in a session. + + History mechanisms and caches are different. In particular history + mechanisms SHOULD NOT try to show a semantically transparent view of + the current state of a resource. Rather, a history mechanism is meant + to show exactly what the user saw at the time when the resource was + retrieved. + + By default, an expiration time does not apply to history mechanisms. + If the entity is still in storage, a history mechanism SHOULD display + it even if the entity has expired, unless the user has specifically + configured the agent to refresh expired history documents. + + This is not to be construed to prohibit the history mechanism from + telling the user that a view might be stale. + + Note: if history list mechanisms unnecessarily prevent users from + viewing stale resources, this will tend to force service authors + to avoid using HTTP expiration controls and cache controls when + they would otherwise like to. Service authors may consider it + important that users not be presented with error messages or + warning messages when they use navigation controls (such as BACK) + to view previously fetched resources. Even though sometimes such + resources ought not to cached, or ought to expire quickly, user + interface considerations may force service authors to resort to + other means of preventing caching (e.g. "once-only" URLs) in order + not to suffer the effects of improperly functioning history + mechanisms. + + + + + +Fielding, et al. Standards Track [Page 99] + +RFC 2616 HTTP/1.1 June 1999 + + +14 Header Field Definitions + + This section defines the syntax and semantics of all standard + HTTP/1.1 header fields. For entity-header fields, both sender and + recipient refer to either the client or the server, depending on who + sends and who receives the entity. + +14.1 Accept + + The Accept request-header field can be used to specify certain media + types which are acceptable for the response. Accept headers can be + used to indicate that the request is specifically limited to a small + set of desired types, as in the case of a request for an in-line + image. + + Accept = "Accept" ":" + #( media-range [ accept-params ] ) + + media-range = ( "*/*" + | ( type "/" "*" ) + | ( type "/" subtype ) + ) *( ";" parameter ) + accept-params = ";" "q" "=" qvalue *( accept-extension ) + accept-extension = ";" token [ "=" ( token | quoted-string ) ] + + The asterisk "*" character is used to group media types into ranges, + with "*/*" indicating all media types and "type/*" indicating all + subtypes of that type. The media-range MAY include media type + parameters that are applicable to that range. + + Each media-range MAY be followed by one or more accept-params, + beginning with the "q" parameter for indicating a relative quality + factor. The first "q" parameter (if any) separates the media-range + parameter(s) from the accept-params. Quality factors allow the user + or user agent to indicate the relative degree of preference for that + media-range, using the qvalue scale from 0 to 1 (section 3.9). The + default value is q=1. + + Note: Use of the "q" parameter name to separate media type + parameters from Accept extension parameters is due to historical + practice. Although this prevents any media type parameter named + "q" from being used with a media range, such an event is believed + to be unlikely given the lack of any "q" parameters in the IANA + media type registry and the rare usage of any media type + parameters in Accept. Future media types are discouraged from + registering any parameter named "q". + + + + + +Fielding, et al. Standards Track [Page 100] + +RFC 2616 HTTP/1.1 June 1999 + + + The example + + Accept: audio/*; q=0.2, audio/basic + + SHOULD be interpreted as "I prefer audio/basic, but send me any audio + type if it is the best available after an 80% mark-down in quality." + + If no Accept header field is present, then it is assumed that the + client accepts all media types. If an Accept header field is present, + and if the server cannot send a response which is acceptable + according to the combined Accept field value, then the server SHOULD + send a 406 (not acceptable) response. + + A more elaborate example is + + Accept: text/plain; q=0.5, text/html, + text/x-dvi; q=0.8, text/x-c + + Verbally, this would be interpreted as "text/html and text/x-c are + the preferred media types, but if they do not exist, then send the + text/x-dvi entity, and if that does not exist, send the text/plain + entity." + + Media ranges can be overridden by more specific media ranges or + specific media types. If more than one media range applies to a given + type, the most specific reference has precedence. For example, + + Accept: text/*, text/html, text/html;level=1, */* + + have the following precedence: + + 1) text/html;level=1 + 2) text/html + 3) text/* + 4) */* + + The media type quality factor associated with a given type is + determined by finding the media range with the highest precedence + which matches that type. For example, + + Accept: text/*;q=0.3, text/html;q=0.7, text/html;level=1, + text/html;level=2;q=0.4, */*;q=0.5 + + would cause the following values to be associated: + + text/html;level=1 = 1 + text/html = 0.7 + text/plain = 0.3 + + + +Fielding, et al. Standards Track [Page 101] + +RFC 2616 HTTP/1.1 June 1999 + + + image/jpeg = 0.5 + text/html;level=2 = 0.4 + text/html;level=3 = 0.7 + + Note: A user agent might be provided with a default set of quality + values for certain media ranges. However, unless the user agent is + a closed system which cannot interact with other rendering agents, + this default set ought to be configurable by the user. + +14.2 Accept-Charset + + The Accept-Charset request-header field can be used to indicate what + character sets are acceptable for the response. This field allows + clients capable of understanding more comprehensive or special- + purpose character sets to signal that capability to a server which is + capable of representing documents in those character sets. + + Accept-Charset = "Accept-Charset" ":" + 1#( ( charset | "*" )[ ";" "q" "=" qvalue ] ) + + + Character set values are described in section 3.4. Each charset MAY + be given an associated quality value which represents the user's + preference for that charset. The default value is q=1. An example is + + Accept-Charset: iso-8859-5, unicode-1-1;q=0.8 + + The special value "*", if present in the Accept-Charset field, + matches every character set (including ISO-8859-1) which is not + mentioned elsewhere in the Accept-Charset field. If no "*" is present + in an Accept-Charset field, then all character sets not explicitly + mentioned get a quality value of 0, except for ISO-8859-1, which gets + a quality value of 1 if not explicitly mentioned. + + If no Accept-Charset header is present, the default is that any + character set is acceptable. If an Accept-Charset header is present, + and if the server cannot send a response which is acceptable + according to the Accept-Charset header, then the server SHOULD send + an error response with the 406 (not acceptable) status code, though + the sending of an unacceptable response is also allowed. + +14.3 Accept-Encoding + + The Accept-Encoding request-header field is similar to Accept, but + restricts the content-codings (section 3.5) that are acceptable in + the response. + + Accept-Encoding = "Accept-Encoding" ":" + + + +Fielding, et al. Standards Track [Page 102] + +RFC 2616 HTTP/1.1 June 1999 + + + 1#( codings [ ";" "q" "=" qvalue ] ) + codings = ( content-coding | "*" ) + + Examples of its use are: + + Accept-Encoding: compress, gzip + Accept-Encoding: + Accept-Encoding: * + Accept-Encoding: compress;q=0.5, gzip;q=1.0 + Accept-Encoding: gzip;q=1.0, identity; q=0.5, *;q=0 + + A server tests whether a content-coding is acceptable, according to + an Accept-Encoding field, using these rules: + + 1. If the content-coding is one of the content-codings listed in + the Accept-Encoding field, then it is acceptable, unless it is + accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + 2. The special "*" symbol in an Accept-Encoding field matches any + available content-coding not explicitly listed in the header + field. + + 3. If multiple content-codings are acceptable, then the acceptable + content-coding with the highest non-zero qvalue is preferred. + + 4. The "identity" content-coding is always acceptable, unless + specifically refused because the Accept-Encoding field includes + "identity;q=0", or because the field includes "*;q=0" and does + not explicitly include the "identity" content-coding. If the + Accept-Encoding field-value is empty, then only the "identity" + encoding is acceptable. + + If an Accept-Encoding field is present in a request, and if the + server cannot send a response which is acceptable according to the + Accept-Encoding header, then the server SHOULD send an error response + with the 406 (Not Acceptable) status code. + + If no Accept-Encoding field is present in a request, the server MAY + assume that the client will accept any content coding. In this case, + if "identity" is one of the available content-codings, then the + server SHOULD use the "identity" content-coding, unless it has + additional information that a different content-coding is meaningful + to the client. + + Note: If the request does not include an Accept-Encoding field, + and if the "identity" content-coding is unavailable, then + content-codings commonly understood by HTTP/1.0 clients (i.e., + + + +Fielding, et al. Standards Track [Page 103] + +RFC 2616 HTTP/1.1 June 1999 + + + "gzip" and "compress") are preferred; some older clients + improperly display messages sent with other content-codings. The + server might also make this decision based on information about + the particular user-agent or client. + + Note: Most HTTP/1.0 applications do not recognize or obey qvalues + associated with content-codings. This means that qvalues will not + work and are not permitted with x-gzip or x-compress. + +14.4 Accept-Language + + The Accept-Language request-header field is similar to Accept, but + restricts the set of natural languages that are preferred as a + response to the request. Language tags are defined in section 3.10. + + Accept-Language = "Accept-Language" ":" + 1#( language-range [ ";" "q" "=" qvalue ] ) + language-range = ( ( 1*8ALPHA *( "-" 1*8ALPHA ) ) | "*" ) + + Each language-range MAY be given an associated quality value which + represents an estimate of the user's preference for the languages + specified by that range. The quality value defaults to "q=1". For + example, + + Accept-Language: da, en-gb;q=0.8, en;q=0.7 + + would mean: "I prefer Danish, but will accept British English and + other types of English." A language-range matches a language-tag if + it exactly equals the tag, or if it exactly equals a prefix of the + tag such that the first tag character following the prefix is "-". + The special range "*", if present in the Accept-Language field, + matches every tag not matched by any other range present in the + Accept-Language field. + + Note: This use of a prefix matching rule does not imply that + language tags are assigned to languages in such a way that it is + always true that if a user understands a language with a certain + tag, then this user will also understand all languages with tags + for which this tag is a prefix. The prefix rule simply allows the + use of prefix tags if this is the case. + + The language quality factor assigned to a language-tag by the + Accept-Language field is the quality value of the longest language- + range in the field that matches the language-tag. If no language- + range in the field matches the tag, the language quality factor + assigned is 0. If no Accept-Language header is present in the + request, the server + + + + +Fielding, et al. Standards Track [Page 104] + +RFC 2616 HTTP/1.1 June 1999 + + + SHOULD assume that all languages are equally acceptable. If an + Accept-Language header is present, then all languages which are + assigned a quality factor greater than 0 are acceptable. + + It might be contrary to the privacy expectations of the user to send + an Accept-Language header with the complete linguistic preferences of + the user in every request. For a discussion of this issue, see + section 15.1.4. + + As intelligibility is highly dependent on the individual user, it is + recommended that client applications make the choice of linguistic + preference available to the user. If the choice is not made + available, then the Accept-Language header field MUST NOT be given in + the request. + + Note: When making the choice of linguistic preference available to + the user, we remind implementors of the fact that users are not + familiar with the details of language matching as described above, + and should provide appropriate guidance. As an example, users + might assume that on selecting "en-gb", they will be served any + kind of English document if British English is not available. A + user agent might suggest in such a case to add "en" to get the + best matching behavior. + +14.5 Accept-Ranges + + The Accept-Ranges response-header field allows the server to + indicate its acceptance of range requests for a resource: + + Accept-Ranges = "Accept-Ranges" ":" acceptable-ranges + acceptable-ranges = 1#range-unit | "none" + + Origin servers that accept byte-range requests MAY send + + Accept-Ranges: bytes + + but are not required to do so. Clients MAY generate byte-range + requests without having received this header for the resource + involved. Range units are defined in section 3.12. + + Servers that do not accept any kind of range request for a + resource MAY send + + Accept-Ranges: none + + to advise the client not to attempt a range request. + + + + + +Fielding, et al. Standards Track [Page 105] + +RFC 2616 HTTP/1.1 June 1999 + + +14.6 Age + + The Age response-header field conveys the sender's estimate of the + amount of time since the response (or its revalidation) was + generated at the origin server. A cached response is "fresh" if + its age does not exceed its freshness lifetime. Age values are + calculated as specified in section 13.2.3. + + Age = "Age" ":" age-value + age-value = delta-seconds + + Age values are non-negative decimal integers, representing time in + seconds. + + If a cache receives a value larger than the largest positive + integer it can represent, or if any of its age calculations + overflows, it MUST transmit an Age header with a value of + 2147483648 (2^31). An HTTP/1.1 server that includes a cache MUST + include an Age header field in every response generated from its + own cache. Caches SHOULD use an arithmetic type of at least 31 + bits of range. + +14.7 Allow + + The Allow entity-header field lists the set of methods supported + by the resource identified by the Request-URI. The purpose of this + field is strictly to inform the recipient of valid methods + associated with the resource. An Allow header field MUST be + present in a 405 (Method Not Allowed) response. + + Allow = "Allow" ":" #Method + + Example of use: + + Allow: GET, HEAD, PUT + + This field cannot prevent a client from trying other methods. + However, the indications given by the Allow header field value + SHOULD be followed. The actual set of allowed methods is defined + by the origin server at the time of each request. + + The Allow header field MAY be provided with a PUT request to + recommend the methods to be supported by the new or modified + resource. The server is not required to support these methods and + SHOULD include an Allow header in the response giving the actual + supported methods. + + + + + +Fielding, et al. Standards Track [Page 106] + +RFC 2616 HTTP/1.1 June 1999 + + + A proxy MUST NOT modify the Allow header field even if it does not + understand all the methods specified, since the user agent might + have other means of communicating with the origin server. + +14.8 Authorization + + A user agent that wishes to authenticate itself with a server-- + usually, but not necessarily, after receiving a 401 response--does + so by including an Authorization request-header field with the + request. The Authorization field value consists of credentials + containing the authentication information of the user agent for + the realm of the resource being requested. + + Authorization = "Authorization" ":" credentials + + HTTP access authentication is described in "HTTP Authentication: + Basic and Digest Access Authentication" [43]. If a request is + authenticated and a realm specified, the same credentials SHOULD + be valid for all other requests within this realm (assuming that + the authentication scheme itself does not require otherwise, such + as credentials that vary according to a challenge value or using + synchronized clocks). + + When a shared cache (see section 13.7) receives a request + containing an Authorization field, it MUST NOT return the + corresponding response as a reply to any other request, unless one + of the following specific exceptions holds: + + 1. If the response includes the "s-maxage" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But (if the specified maximum age has + passed) a proxy cache MUST first revalidate it with the origin + server, using the request-headers from the new request to allow + the origin server to authenticate the new request. (This is the + defined behavior for s-maxage.) If the response includes "s- + maxage=0", the proxy MUST always revalidate it before re-using + it. + + 2. If the response includes the "must-revalidate" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But if the response is stale, all caches + MUST first revalidate it with the origin server, using the + request-headers from the new request to allow the origin server + to authenticate the new request. + + 3. If the response includes the "public" cache-control directive, + it MAY be returned in reply to any subsequent request. + + + + +Fielding, et al. Standards Track [Page 107] + +RFC 2616 HTTP/1.1 June 1999 + + +14.9 Cache-Control + + The Cache-Control general-header field is used to specify directives + that MUST be obeyed by all caching mechanisms along the + request/response chain. The directives specify behavior intended to + prevent caches from adversely interfering with the request or + response. These directives typically override the default caching + algorithms. Cache directives are unidirectional in that the presence + of a directive in a request does not imply that the same directive is + to be given in the response. + + Note that HTTP/1.0 caches might not implement Cache-Control and + might only implement Pragma: no-cache (see section 14.32). + + Cache directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a cache- + directive for a specific cache. + + Cache-Control = "Cache-Control" ":" 1#cache-directive + + cache-directive = cache-request-directive + | cache-response-directive + + cache-request-directive = + "no-cache" ; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "max-age" "=" delta-seconds ; Section 14.9.3, 14.9.4 + | "max-stale" [ "=" delta-seconds ] ; Section 14.9.3 + | "min-fresh" "=" delta-seconds ; Section 14.9.3 + | "no-transform" ; Section 14.9.5 + | "only-if-cached" ; Section 14.9.4 + | cache-extension ; Section 14.9.6 + + cache-response-directive = + "public" ; Section 14.9.1 + | "private" [ "=" <"> 1#field-name <"> ] ; Section 14.9.1 + | "no-cache" [ "=" <"> 1#field-name <"> ]; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "no-transform" ; Section 14.9.5 + | "must-revalidate" ; Section 14.9.4 + | "proxy-revalidate" ; Section 14.9.4 + | "max-age" "=" delta-seconds ; Section 14.9.3 + | "s-maxage" "=" delta-seconds ; Section 14.9.3 + | cache-extension ; Section 14.9.6 + + cache-extension = token [ "=" ( token | quoted-string ) ] + + + +Fielding, et al. Standards Track [Page 108] + +RFC 2616 HTTP/1.1 June 1999 + + + When a directive appears without any 1#field-name parameter, the + directive applies to the entire request or response. When such a + directive appears with a 1#field-name parameter, it applies only to + the named field or fields, and not to the rest of the request or + response. This mechanism supports extensibility; implementations of + future versions of the HTTP protocol might apply these directives to + header fields not defined in HTTP/1.1. + + The cache-control directives can be broken down into these general + categories: + + - Restrictions on what are cacheable; these may only be imposed by + the origin server. + + - Restrictions on what may be stored by a cache; these may be + imposed by either the origin server or the user agent. + + - Modifications of the basic expiration mechanism; these may be + imposed by either the origin server or the user agent. + + - Controls over cache revalidation and reload; these may only be + imposed by a user agent. + + - Control over transformation of entities. + + - Extensions to the caching system. + +14.9.1 What is Cacheable + + By default, a response is cacheable if the requirements of the + request method, request header fields, and the response status + indicate that it is cacheable. Section 13.4 summarizes these defaults + for cacheability. The following Cache-Control response directives + allow an origin server to override the default cacheability of a + response: + + public + Indicates that the response MAY be cached by any cache, even if it + would normally be non-cacheable or cacheable only within a non- + shared cache. (See also Authorization, section 14.8, for + additional details.) + + private + Indicates that all or part of the response message is intended for + a single user and MUST NOT be cached by a shared cache. This + allows an origin server to state that the specified parts of the + + + + + +Fielding, et al. Standards Track [Page 109] + +RFC 2616 HTTP/1.1 June 1999 + + + response are intended for only one user and are not a valid + response for requests by other users. A private (non-shared) cache + MAY cache the response. + + Note: This usage of the word private only controls where the + response may be cached, and cannot ensure the privacy of the + message content. + + no-cache + If the no-cache directive does not specify a field-name, then a + cache MUST NOT use the response to satisfy a subsequent request + without successful revalidation with the origin server. This + allows an origin server to prevent caching even by caches that + have been configured to return stale responses to client requests. + + If the no-cache directive does specify one or more field-names, + then a cache MAY use the response to satisfy a subsequent request, + subject to any other restrictions on caching. However, the + specified field-name(s) MUST NOT be sent in the response to a + subsequent request without successful revalidation with the origin + server. This allows an origin server to prevent the re-use of + certain header fields in a response, while still allowing caching + of the rest of the response. + + Note: Most HTTP/1.0 caches will not recognize or obey this + directive. + +14.9.2 What May be Stored by Caches + + no-store + The purpose of the no-store directive is to prevent the + inadvertent release or retention of sensitive information (for + example, on backup tapes). The no-store directive applies to the + entire message, and MAY be sent either in a response or in a + request. If sent in a request, a cache MUST NOT store any part of + either this request or any response to it. If sent in a response, + a cache MUST NOT store any part of either this response or the + request that elicited it. This directive applies to both non- + shared and shared caches. "MUST NOT store" in this context means + that the cache MUST NOT intentionally store the information in + non-volatile storage, and MUST make a best-effort attempt to + remove the information from volatile storage as promptly as + possible after forwarding it. + + Even when this directive is associated with a response, users + might explicitly store such a response outside of the caching + system (e.g., with a "Save As" dialog). History buffers MAY store + such responses as part of their normal operation. + + + +Fielding, et al. Standards Track [Page 110] + +RFC 2616 HTTP/1.1 June 1999 + + + The purpose of this directive is to meet the stated requirements + of certain users and service authors who are concerned about + accidental releases of information via unanticipated accesses to + cache data structures. While the use of this directive might + improve privacy in some cases, we caution that it is NOT in any + way a reliable or sufficient mechanism for ensuring privacy. In + particular, malicious or compromised caches might not recognize or + obey this directive, and communications networks might be + vulnerable to eavesdropping. + +14.9.3 Modifications of the Basic Expiration Mechanism + + The expiration time of an entity MAY be specified by the origin + server using the Expires header (see section 14.21). Alternatively, + it MAY be specified using the max-age directive in a response. When + the max-age cache-control directive is present in a cached response, + the response is stale if its current age is greater than the age + value given (in seconds) at the time of a new request for that + resource. The max-age directive on a response implies that the + response is cacheable (i.e., "public") unless some other, more + restrictive cache directive is also present. + + If a response includes both an Expires header and a max-age + directive, the max-age directive overrides the Expires header, even + if the Expires header is more restrictive. This rule allows an origin + server to provide, for a given response, a longer expiration time to + an HTTP/1.1 (or later) cache than to an HTTP/1.0 cache. This might be + useful if certain HTTP/1.0 caches improperly calculate ages or + expiration times, perhaps due to desynchronized clocks. + + Many HTTP/1.0 cache implementations will treat an Expires value that + is less than or equal to the response Date value as being equivalent + to the Cache-Control response directive "no-cache". If an HTTP/1.1 + cache receives such a response, and the response does not include a + Cache-Control header field, it SHOULD consider the response to be + non-cacheable in order to retain compatibility with HTTP/1.0 servers. + + Note: An origin server might wish to use a relatively new HTTP + cache control feature, such as the "private" directive, on a + network including older caches that do not understand that + feature. The origin server will need to combine the new feature + with an Expires field whose value is less than or equal to the + Date value. This will prevent older caches from improperly + caching the response. + + + + + + + +Fielding, et al. Standards Track [Page 111] + +RFC 2616 HTTP/1.1 June 1999 + + + s-maxage + If a response includes an s-maxage directive, then for a shared + cache (but not for a private cache), the maximum age specified by + this directive overrides the maximum age specified by either the + max-age directive or the Expires header. The s-maxage directive + also implies the semantics of the proxy-revalidate directive (see + section 14.9.4), i.e., that the shared cache must not use the + entry after it becomes stale to respond to a subsequent request + without first revalidating it with the origin server. The s- + maxage directive is always ignored by a private cache. + + Note that most older caches, not compliant with this specification, + do not implement any cache-control directives. An origin server + wishing to use a cache-control directive that restricts, but does not + prevent, caching by an HTTP/1.1-compliant cache MAY exploit the + requirement that the max-age directive overrides the Expires header, + and the fact that pre-HTTP/1.1-compliant caches do not observe the + max-age directive. + + Other directives allow a user agent to modify the basic expiration + mechanism. These directives MAY be specified on a request: + + max-age + Indicates that the client is willing to accept a response whose + age is no greater than the specified time in seconds. Unless max- + stale directive is also included, the client is not willing to + accept a stale response. + + min-fresh + Indicates that the client is willing to accept a response whose + freshness lifetime is no less than its current age plus the + specified time in seconds. That is, the client wants a response + that will still be fresh for at least the specified number of + seconds. + + max-stale + Indicates that the client is willing to accept a response that has + exceeded its expiration time. If max-stale is assigned a value, + then the client is willing to accept a response that has exceeded + its expiration time by no more than the specified number of + seconds. If no value is assigned to max-stale, then the client is + willing to accept a stale response of any age. + + If a cache returns a stale response, either because of a max-stale + directive on a request, or because the cache is configured to + override the expiration time of a response, the cache MUST attach a + Warning header to the stale response, using Warning 110 (Response is + stale). + + + +Fielding, et al. Standards Track [Page 112] + +RFC 2616 HTTP/1.1 June 1999 + + + A cache MAY be configured to return stale responses without + validation, but only if this does not conflict with any "MUST"-level + requirements concerning cache validation (e.g., a "must-revalidate" + cache-control directive). + + If both the new request and the cached entry include "max-age" + directives, then the lesser of the two values is used for determining + the freshness of the cached entry for that request. + +14.9.4 Cache Revalidation and Reload Controls + + Sometimes a user agent might want or need to insist that a cache + revalidate its cache entry with the origin server (and not just with + the next cache along the path to the origin server), or to reload its + cache entry from the origin server. End-to-end revalidation might be + necessary if either the cache or the origin server has overestimated + the expiration time of the cached response. End-to-end reload may be + necessary if the cache entry has become corrupted for some reason. + + End-to-end revalidation may be requested either when the client does + not have its own local cached copy, in which case we call it + "unspecified end-to-end revalidation", or when the client does have a + local cached copy, in which case we call it "specific end-to-end + revalidation." + + The client can specify these three kinds of action using Cache- + Control request directives: + + End-to-end reload + The request includes a "no-cache" cache-control directive or, for + compatibility with HTTP/1.0 clients, "Pragma: no-cache". Field + names MUST NOT be included with the no-cache directive in a + request. The server MUST NOT use a cached copy when responding to + such a request. + + Specific end-to-end revalidation + The request includes a "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request includes a cache-validating conditional with + the client's current validator. + + Unspecified end-to-end revalidation + The request includes "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request does not include a cache-validating + + + + +Fielding, et al. Standards Track [Page 113] + +RFC 2616 HTTP/1.1 June 1999 + + + conditional; the first cache along the path (if any) that holds a + cache entry for this resource includes a cache-validating + conditional with its current validator. + + max-age + When an intermediate cache is forced, by means of a max-age=0 + directive, to revalidate its own cache entry, and the client has + supplied its own validator in the request, the supplied validator + might differ from the validator currently stored with the cache + entry. In this case, the cache MAY use either validator in making + its own request without affecting semantic transparency. + + However, the choice of validator might affect performance. The + best approach is for the intermediate cache to use its own + validator when making its request. If the server replies with 304 + (Not Modified), then the cache can return its now validated copy + to the client with a 200 (OK) response. If the server replies with + a new entity and cache validator, however, the intermediate cache + can compare the returned validator with the one provided in the + client's request, using the strong comparison function. If the + client's validator is equal to the origin server's, then the + intermediate cache simply returns 304 (Not Modified). Otherwise, + it returns the new entity with a 200 (OK) response. + + If a request includes the no-cache directive, it SHOULD NOT + include min-fresh, max-stale, or max-age. + + only-if-cached + In some cases, such as times of extremely poor network + connectivity, a client may want a cache to return only those + responses that it currently has stored, and not to reload or + revalidate with the origin server. To do this, the client may + include the only-if-cached directive in a request. If it receives + this directive, a cache SHOULD either respond using a cached entry + that is consistent with the other constraints of the request, or + respond with a 504 (Gateway Timeout) status. However, if a group + of caches is being operated as a unified system with good internal + connectivity, such a request MAY be forwarded within that group of + caches. + + must-revalidate + Because a cache MAY be configured to ignore a server's specified + expiration time, and because a client request MAY include a max- + stale directive (which has a similar effect), the protocol also + includes a mechanism for the origin server to require revalidation + of a cache entry on any subsequent use. When the must-revalidate + directive is present in a response received by a cache, that cache + MUST NOT use the entry after it becomes stale to respond to a + + + +Fielding, et al. Standards Track [Page 114] + +RFC 2616 HTTP/1.1 June 1999 + + + subsequent request without first revalidating it with the origin + server. (I.e., the cache MUST do an end-to-end revalidation every + time, if, based solely on the origin server's Expires or max-age + value, the cached response is stale.) + + The must-revalidate directive is necessary to support reliable + operation for certain protocol features. In all circumstances an + HTTP/1.1 cache MUST obey the must-revalidate directive; in + particular, if the cache cannot reach the origin server for any + reason, it MUST generate a 504 (Gateway Timeout) response. + + Servers SHOULD send the must-revalidate directive if and only if + failure to revalidate a request on the entity could result in + incorrect operation, such as a silently unexecuted financial + transaction. Recipients MUST NOT take any automated action that + violates this directive, and MUST NOT automatically provide an + unvalidated copy of the entity if revalidation fails. + + Although this is not recommended, user agents operating under + severe connectivity constraints MAY violate this directive but, if + so, MUST explicitly warn the user that an unvalidated response has + been provided. The warning MUST be provided on each unvalidated + access, and SHOULD require explicit user confirmation. + + proxy-revalidate + The proxy-revalidate directive has the same meaning as the must- + revalidate directive, except that it does not apply to non-shared + user agent caches. It can be used on a response to an + authenticated request to permit the user's cache to store and + later return the response without needing to revalidate it (since + it has already been authenticated once by that user), while still + requiring proxies that service many users to revalidate each time + (in order to make sure that each user has been authenticated). + Note that such authenticated responses also need the public cache + control directive in order to allow them to be cached at all. + +14.9.5 No-Transform Directive + + no-transform + Implementors of intermediate caches (proxies) have found it useful + to convert the media type of certain entity bodies. A non- + transparent proxy might, for example, convert between image + formats in order to save cache space or to reduce the amount of + traffic on a slow link. + + Serious operational problems occur, however, when these + transformations are applied to entity bodies intended for certain + kinds of applications. For example, applications for medical + + + +Fielding, et al. Standards Track [Page 115] + +RFC 2616 HTTP/1.1 June 1999 + + + imaging, scientific data analysis and those using end-to-end + authentication, all depend on receiving an entity body that is bit + for bit identical to the original entity-body. + + Therefore, if a message includes the no-transform directive, an + intermediate cache or proxy MUST NOT change those headers that are + listed in section 13.5.2 as being subject to the no-transform + directive. This implies that the cache or proxy MUST NOT change + any aspect of the entity-body that is specified by these headers, + including the value of the entity-body itself. + +14.9.6 Cache Control Extensions + + The Cache-Control header field can be extended through the use of one + or more cache-extension tokens, each with an optional assigned value. + Informational extensions (those which do not require a change in + cache behavior) MAY be added without changing the semantics of other + directives. Behavioral extensions are designed to work by acting as + modifiers to the existing base of cache directives. Both the new + directive and the standard directive are supplied, such that + applications which do not understand the new directive will default + to the behavior specified by the standard directive, and those that + understand the new directive will recognize it as modifying the + requirements associated with the standard directive. In this way, + extensions to the cache-control directives can be made without + requiring changes to the base protocol. + + This extension mechanism depends on an HTTP cache obeying all of the + cache-control directives defined for its native HTTP-version, obeying + certain extensions, and ignoring all directives that it does not + understand. + + For example, consider a hypothetical new response directive called + community which acts as a modifier to the private directive. We + define this new directive to mean that, in addition to any non-shared + cache, any cache which is shared only by members of the community + named within its value may cache the response. An origin server + wishing to allow the UCI community to use an otherwise private + response in their shared cache(s) could do so by including + + Cache-Control: private, community="UCI" + + A cache seeing this header field will act correctly even if the cache + does not understand the community cache-extension, since it will also + see and understand the private directive and thus default to the safe + behavior. + + + + + +Fielding, et al. Standards Track [Page 116] + +RFC 2616 HTTP/1.1 June 1999 + + + Unrecognized cache-directives MUST be ignored; it is assumed that any + cache-directive likely to be unrecognized by an HTTP/1.1 cache will + be combined with standard directives (or the response's default + cacheability) such that the cache behavior will remain minimally + correct even if the cache does not understand the extension(s). + +14.10 Connection + + The Connection general-header field allows the sender to specify + options that are desired for that particular connection and MUST NOT + be communicated by proxies over further connections. + + The Connection header has the following grammar: + + Connection = "Connection" ":" 1#(connection-token) + connection-token = token + + HTTP/1.1 proxies MUST parse the Connection header field before a + message is forwarded and, for each connection-token in this field, + remove any header field(s) from the message with the same name as the + connection-token. Connection options are signaled by the presence of + a connection-token in the Connection header field, not by any + corresponding additional header field(s), since the additional header + field may not be sent if there are no parameters associated with that + connection option. + + Message headers listed in the Connection header MUST NOT include + end-to-end headers, such as Cache-Control. + + HTTP/1.1 defines the "close" connection option for the sender to + signal that the connection will be closed after completion of the + response. For example, + + Connection: close + + in either the request or the response header fields indicates that + the connection SHOULD NOT be considered `persistent' (section 8.1) + after the current request/response is complete. + + HTTP/1.1 applications that do not support persistent connections MUST + include the "close" connection option in every message. + + A system receiving an HTTP/1.0 (or lower-version) message that + includes a Connection header MUST, for each connection-token in this + field, remove and ignore any header field(s) from the message with + the same name as the connection-token. This protects against mistaken + forwarding of such header fields by pre-HTTP/1.1 proxies. See section + 19.6.2. + + + +Fielding, et al. Standards Track [Page 117] + +RFC 2616 HTTP/1.1 June 1999 + + +14.11 Content-Encoding + + The Content-Encoding entity-header field is used as a modifier to the + media-type. When present, its value indicates what additional content + codings have been applied to the entity-body, and thus what decoding + mechanisms must be applied in order to obtain the media-type + referenced by the Content-Type header field. Content-Encoding is + primarily used to allow a document to be compressed without losing + the identity of its underlying media type. + + Content-Encoding = "Content-Encoding" ":" 1#content-coding + + Content codings are defined in section 3.5. An example of its use is + + Content-Encoding: gzip + + The content-coding is a characteristic of the entity identified by + the Request-URI. Typically, the entity-body is stored with this + encoding and is only decoded before rendering or analogous usage. + However, a non-transparent proxy MAY modify the content-coding if the + new coding is known to be acceptable to the recipient, unless the + "no-transform" cache-control directive is present in the message. + + If the content-coding of an entity is not "identity", then the + response MUST include a Content-Encoding entity-header (section + 14.11) that lists the non-identity content-coding(s) used. + + If the content-coding of an entity in a request message is not + acceptable to the origin server, the server SHOULD respond with a + status code of 415 (Unsupported Media Type). + + If multiple encodings have been applied to an entity, the content + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + +14.12 Content-Language + + The Content-Language entity-header field describes the natural + language(s) of the intended audience for the enclosed entity. Note + that this might not be equivalent to all the languages used within + the entity-body. + + Content-Language = "Content-Language" ":" 1#language-tag + + + + + + + +Fielding, et al. Standards Track [Page 118] + +RFC 2616 HTTP/1.1 June 1999 + + + Language tags are defined in section 3.10. The primary purpose of + Content-Language is to allow a user to identify and differentiate + entities according to the user's own preferred language. Thus, if the + body content is intended only for a Danish-literate audience, the + appropriate field is + + Content-Language: da + + If no Content-Language is specified, the default is that the content + is intended for all language audiences. This might mean that the + sender does not consider it to be specific to any natural language, + or that the sender does not know for which language it is intended. + + Multiple languages MAY be listed for content that is intended for + multiple audiences. For example, a rendition of the "Treaty of + Waitangi," presented simultaneously in the original Maori and English + versions, would call for + + Content-Language: mi, en + + However, just because multiple languages are present within an entity + does not mean that it is intended for multiple linguistic audiences. + An example would be a beginner's language primer, such as "A First + Lesson in Latin," which is clearly intended to be used by an + English-literate audience. In this case, the Content-Language would + properly only include "en". + + Content-Language MAY be applied to any media type -- it is not + limited to textual documents. + +14.13 Content-Length + + The Content-Length entity-header field indicates the size of the + entity-body, in decimal number of OCTETs, sent to the recipient or, + in the case of the HEAD method, the size of the entity-body that + would have been sent had the request been a GET. + + Content-Length = "Content-Length" ":" 1*DIGIT + + An example is + + Content-Length: 3495 + + Applications SHOULD use this field to indicate the transfer-length of + the message-body, unless this is prohibited by the rules in section + 4.4. + + + + + +Fielding, et al. Standards Track [Page 119] + +RFC 2616 HTTP/1.1 June 1999 + + + Any Content-Length greater than or equal to zero is a valid value. + Section 4.4 describes how to determine the length of a message-body + if a Content-Length is not given. + + Note that the meaning of this field is significantly different from + the corresponding definition in MIME, where it is an optional field + used within the "message/external-body" content-type. In HTTP, it + SHOULD be sent whenever the message's length can be determined prior + to being transferred, unless this is prohibited by the rules in + section 4.4. + +14.14 Content-Location + + The Content-Location entity-header field MAY be used to supply the + resource location for the entity enclosed in the message when that + entity is accessible from a location separate from the requested + resource's URI. A server SHOULD provide a Content-Location for the + variant corresponding to the response entity; especially in the case + where a resource has multiple entities associated with it, and those + entities actually have separate locations by which they might be + individually accessed, the server SHOULD provide a Content-Location + for the particular variant which is returned. + + Content-Location = "Content-Location" ":" + ( absoluteURI | relativeURI ) + + The value of Content-Location also defines the base URI for the + entity. + + The Content-Location value is not a replacement for the original + requested URI; it is only a statement of the location of the resource + corresponding to this particular entity at the time of the request. + Future requests MAY specify the Content-Location URI as the request- + URI if the desire is to identify the source of that particular + entity. + + A cache cannot assume that an entity with a Content-Location + different from the URI used to retrieve it can be used to respond to + later requests on that Content-Location URI. However, the Content- + Location can be used to differentiate between multiple entities + retrieved from a single requested resource, as described in section + 13.6. + + If the Content-Location is a relative URI, the relative URI is + interpreted relative to the Request-URI. + + The meaning of the Content-Location header in PUT or POST requests is + undefined; servers are free to ignore it in those cases. + + + +Fielding, et al. Standards Track [Page 120] + +RFC 2616 HTTP/1.1 June 1999 + + +14.15 Content-MD5 + + The Content-MD5 entity-header field, as defined in RFC 1864 [23], is + an MD5 digest of the entity-body for the purpose of providing an + end-to-end message integrity check (MIC) of the entity-body. (Note: a + MIC is good for detecting accidental modification of the entity-body + in transit, but is not proof against malicious attacks.) + + Content-MD5 = "Content-MD5" ":" md5-digest + md5-digest = + + The Content-MD5 header field MAY be generated by an origin server or + client to function as an integrity check of the entity-body. Only + origin servers or clients MAY generate the Content-MD5 header field; + proxies and gateways MUST NOT generate it, as this would defeat its + value as an end-to-end integrity check. Any recipient of the entity- + body, including gateways and proxies, MAY check that the digest value + in this header field matches that of the entity-body as received. + + The MD5 digest is computed based on the content of the entity-body, + including any content-coding that has been applied, but not including + any transfer-encoding applied to the message-body. If the message is + received with a transfer-encoding, that encoding MUST be removed + prior to checking the Content-MD5 value against the received entity. + + This has the result that the digest is computed on the octets of the + entity-body exactly as, and in the order that, they would be sent if + no transfer-encoding were being applied. + + HTTP extends RFC 1864 to permit the digest to be computed for MIME + composite media-types (e.g., multipart/* and message/rfc822), but + this does not change how the digest is computed as defined in the + preceding paragraph. + + There are several consequences of this. The entity-body for composite + types MAY contain many body-parts, each with its own MIME and HTTP + headers (including Content-MD5, Content-Transfer-Encoding, and + Content-Encoding headers). If a body-part has a Content-Transfer- + Encoding or Content-Encoding header, it is assumed that the content + of the body-part has had the encoding applied, and the body-part is + included in the Content-MD5 digest as is -- i.e., after the + application. The Transfer-Encoding header field is not allowed within + body-parts. + + Conversion of all line breaks to CRLF MUST NOT be done before + computing or checking the digest: the line break convention used in + the text actually transmitted MUST be left unaltered when computing + the digest. + + + +Fielding, et al. Standards Track [Page 121] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: while the definition of Content-MD5 is exactly the same for + HTTP as in RFC 1864 for MIME entity-bodies, there are several ways + in which the application of Content-MD5 to HTTP entity-bodies + differs from its application to MIME entity-bodies. One is that + HTTP, unlike MIME, does not use Content-Transfer-Encoding, and + does use Transfer-Encoding and Content-Encoding. Another is that + HTTP more frequently uses binary content types than MIME, so it is + worth noting that, in such cases, the byte order used to compute + the digest is the transmission byte order defined for the type. + Lastly, HTTP allows transmission of text types with any of several + line break conventions and not just the canonical form using CRLF. + +14.16 Content-Range + + The Content-Range entity-header is sent with a partial entity-body to + specify where in the full entity-body the partial body should be + applied. Range units are defined in section 3.12. + + Content-Range = "Content-Range" ":" content-range-spec + + content-range-spec = byte-content-range-spec + byte-content-range-spec = bytes-unit SP + byte-range-resp-spec "/" + ( instance-length | "*" ) + + byte-range-resp-spec = (first-byte-pos "-" last-byte-pos) + | "*" + instance-length = 1*DIGIT + + The header SHOULD indicate the total length of the full entity-body, + unless this length is unknown or difficult to determine. The asterisk + "*" character means that the instance-length is unknown at the time + when the response was generated. + + Unlike byte-ranges-specifier values (see section 14.35.1), a byte- + range-resp-spec MUST only specify one range, and MUST contain + absolute byte positions for both the first and last byte of the + range. + + A byte-content-range-spec with a byte-range-resp-spec whose last- + byte-pos value is less than its first-byte-pos value, or whose + instance-length value is less than or equal to its last-byte-pos + value, is invalid. The recipient of an invalid byte-content-range- + spec MUST ignore it and any content transferred along with it. + + A server sending a response with status code 416 (Requested range not + satisfiable) SHOULD include a Content-Range field with a byte-range- + resp-spec of "*". The instance-length specifies the current length of + + + +Fielding, et al. Standards Track [Page 122] + +RFC 2616 HTTP/1.1 June 1999 + + + the selected resource. A response with status code 206 (Partial + Content) MUST NOT include a Content-Range field with a byte-range- + resp-spec of "*". + + Examples of byte-content-range-spec values, assuming that the entity + contains a total of 1234 bytes: + + . The first 500 bytes: + bytes 0-499/1234 + + . The second 500 bytes: + bytes 500-999/1234 + + . All except for the first 500 bytes: + bytes 500-1233/1234 + + . The last 500 bytes: + bytes 734-1233/1234 + + When an HTTP message includes the content of a single range (for + example, a response to a request for a single range, or to a request + for a set of ranges that overlap without any holes), this content is + transmitted with a Content-Range header, and a Content-Length header + showing the number of bytes actually transferred. For example, + + HTTP/1.1 206 Partial content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-Range: bytes 21010-47021/47022 + Content-Length: 26012 + Content-Type: image/gif + + When an HTTP message includes the content of multiple ranges (for + example, a response to a request for multiple non-overlapping + ranges), these are transmitted as a multipart message. The multipart + media type used for this purpose is "multipart/byteranges" as defined + in appendix 19.2. See appendix 19.6.3 for a compatibility issue. + + A response to a request for a single range MUST NOT be sent using the + multipart/byteranges media type. A response to a request for + multiple ranges, whose result is a single range, MAY be sent as a + multipart/byteranges media type with one part. A client that cannot + decode a multipart/byteranges message MUST NOT ask for multiple + byte-ranges in a single request. + + When a client requests multiple byte-ranges in one request, the + server SHOULD return them in the order that they appeared in the + request. + + + +Fielding, et al. Standards Track [Page 123] + +RFC 2616 HTTP/1.1 June 1999 + + + If the server ignores a byte-range-spec because it is syntactically + invalid, the server SHOULD treat the request as if the invalid Range + header field did not exist. (Normally, this means return a 200 + response containing the full entity). + + If the server receives a request (other than one including an If- + Range request-header field) with an unsatisfiable Range request- + header field (that is, all of whose byte-range-spec values have a + first-byte-pos value greater than the current length of the selected + resource), it SHOULD return a response code of 416 (Requested range + not satisfiable) (section 10.4.17). + + Note: clients cannot depend on servers to send a 416 (Requested + range not satisfiable) response instead of a 200 (OK) response for + an unsatisfiable Range request-header, since not all servers + implement this request-header. + +14.17 Content-Type + + The Content-Type entity-header field indicates the media type of the + entity-body sent to the recipient or, in the case of the HEAD method, + the media type that would have been sent had the request been a GET. + + Content-Type = "Content-Type" ":" media-type + + Media types are defined in section 3.7. An example of the field is + + Content-Type: text/html; charset=ISO-8859-4 + + Further discussion of methods for identifying the media type of an + entity is provided in section 7.2.1. + +14.18 Date + + The Date general-header field represents the date and time at which + the message was originated, having the same semantics as orig-date in + RFC 822. The field value is an HTTP-date, as described in section + 3.3.1; it MUST be sent in RFC 1123 [8]-date format. + + Date = "Date" ":" HTTP-date + + An example is + + Date: Tue, 15 Nov 1994 08:12:31 GMT + + Origin servers MUST include a Date header field in all responses, + except in these cases: + + + + +Fielding, et al. Standards Track [Page 124] + +RFC 2616 HTTP/1.1 June 1999 + + + 1. If the response status code is 100 (Continue) or 101 (Switching + Protocols), the response MAY include a Date header field, at + the server's option. + + 2. If the response status code conveys a server error, e.g. 500 + (Internal Server Error) or 503 (Service Unavailable), and it is + inconvenient or impossible to generate a valid Date. + + 3. If the server does not have a clock that can provide a + reasonable approximation of the current time, its responses + MUST NOT include a Date header field. In this case, the rules + in section 14.18.1 MUST be followed. + + A received message that does not have a Date header field MUST be + assigned one by the recipient if the message will be cached by that + recipient or gatewayed via a protocol which requires a Date. An HTTP + implementation without a clock MUST NOT cache responses without + revalidating them on every use. An HTTP cache, especially a shared + cache, SHOULD use a mechanism, such as NTP [28], to synchronize its + clock with a reliable external standard. + + Clients SHOULD only send a Date header field in messages that include + an entity-body, as in the case of the PUT and POST requests, and even + then it is optional. A client without a clock MUST NOT send a Date + header field in a request. + + The HTTP-date sent in a Date header SHOULD NOT represent a date and + time subsequent to the generation of the message. It SHOULD represent + the best available approximation of the date and time of message + generation, unless the implementation has no means of generating a + reasonably accurate date and time. In theory, the date ought to + represent the moment just before the entity is generated. In + practice, the date can be generated at any time during the message + origination without affecting its semantic value. + +14.18.1 Clockless Origin Server Operation + + Some origin server implementations might not have a clock available. + An origin server without a clock MUST NOT assign Expires or Last- + Modified values to a response, unless these values were associated + with the resource by a system or user with a reliable clock. It MAY + assign an Expires value that is known, at or before server + configuration time, to be in the past (this allows "pre-expiration" + of responses without storing separate Expires values for each + resource). + + + + + + +Fielding, et al. Standards Track [Page 125] + +RFC 2616 HTTP/1.1 June 1999 + + +14.19 ETag + + The ETag response-header field provides the current value of the + entity tag for the requested variant. The headers used with entity + tags are described in sections 14.24, 14.26 and 14.44. The entity tag + MAY be used for comparison with other entities from the same resource + (see section 13.3.3). + + ETag = "ETag" ":" entity-tag + + Examples: + + ETag: "xyzzy" + ETag: W/"xyzzy" + ETag: "" + +14.20 Expect + + The Expect request-header field is used to indicate that particular + server behaviors are required by the client. + + Expect = "Expect" ":" 1#expectation + + expectation = "100-continue" | expectation-extension + expectation-extension = token [ "=" ( token | quoted-string ) + *expect-params ] + expect-params = ";" token [ "=" ( token | quoted-string ) ] + + + A server that does not understand or is unable to comply with any of + the expectation values in the Expect field of a request MUST respond + with appropriate error status. The server MUST respond with a 417 + (Expectation Failed) status if any of the expectations cannot be met + or, if there are other problems with the request, some other 4xx + status. + + This header field is defined with extensible syntax to allow for + future extensions. If a server receives a request containing an + Expect field that includes an expectation-extension that it does not + support, it MUST respond with a 417 (Expectation Failed) status. + + Comparison of expectation values is case-insensitive for unquoted + tokens (including the 100-continue token), and is case-sensitive for + quoted-string expectation-extensions. + + + + + + + +Fielding, et al. Standards Track [Page 126] + +RFC 2616 HTTP/1.1 June 1999 + + + The Expect mechanism is hop-by-hop: that is, an HTTP/1.1 proxy MUST + return a 417 (Expectation Failed) status if it receives a request + with an expectation that it cannot meet. However, the Expect + request-header itself is end-to-end; it MUST be forwarded if the + request is forwarded. + + Many older HTTP/1.0 and HTTP/1.1 applications do not understand the + Expect header. + + See section 8.2.3 for the use of the 100 (continue) status. + +14.21 Expires + + The Expires entity-header field gives the date/time after which the + response is considered stale. A stale cache entry may not normally be + returned by a cache (either a proxy cache or a user agent cache) + unless it is first validated with the origin server (or with an + intermediate cache that has a fresh copy of the entity). See section + 13.2 for further discussion of the expiration model. + + The presence of an Expires field does not imply that the original + resource will change or cease to exist at, before, or after that + time. + + The format is an absolute date and time as defined by HTTP-date in + section 3.3.1; it MUST be in RFC 1123 date format: + + Expires = "Expires" ":" HTTP-date + + An example of its use is + + Expires: Thu, 01 Dec 1994 16:00:00 GMT + + Note: if a response includes a Cache-Control field with the max- + age directive (see section 14.9.3), that directive overrides the + Expires field. + + HTTP/1.1 clients and caches MUST treat other invalid date formats, + especially including the value "0", as in the past (i.e., "already + expired"). + + To mark a response as "already expired," an origin server sends an + Expires date that is equal to the Date header value. (See the rules + for expiration calculations in section 13.2.4.) + + + + + + + +Fielding, et al. Standards Track [Page 127] + +RFC 2616 HTTP/1.1 June 1999 + + + To mark a response as "never expires," an origin server sends an + Expires date approximately one year from the time the response is + sent. HTTP/1.1 servers SHOULD NOT send Expires dates more than one + year in the future. + + The presence of an Expires header field with a date value of some + time in the future on a response that otherwise would by default be + non-cacheable indicates that the response is cacheable, unless + indicated otherwise by a Cache-Control header field (section 14.9). + +14.22 From + + The From request-header field, if given, SHOULD contain an Internet + e-mail address for the human user who controls the requesting user + agent. The address SHOULD be machine-usable, as defined by "mailbox" + in RFC 822 [9] as updated by RFC 1123 [8]: + + From = "From" ":" mailbox + + An example is: + + From: webmaster@w3.org + + This header field MAY be used for logging purposes and as a means for + identifying the source of invalid or unwanted requests. It SHOULD NOT + be used as an insecure form of access protection. The interpretation + of this field is that the request is being performed on behalf of the + person given, who accepts responsibility for the method performed. In + particular, robot agents SHOULD include this header so that the + person responsible for running the robot can be contacted if problems + occur on the receiving end. + + The Internet e-mail address in this field MAY be separate from the + Internet host which issued the request. For example, when a request + is passed through a proxy the original issuer's address SHOULD be + used. + + The client SHOULD NOT send the From header field without the user's + approval, as it might conflict with the user's privacy interests or + their site's security policy. It is strongly recommended that the + user be able to disable, enable, and modify the value of this field + at any time prior to a request. + +14.23 Host + + The Host request-header field specifies the Internet host and port + number of the resource being requested, as obtained from the original + URI given by the user or referring resource (generally an HTTP URL, + + + +Fielding, et al. Standards Track [Page 128] + +RFC 2616 HTTP/1.1 June 1999 + + + as described in section 3.2.2). The Host field value MUST represent + the naming authority of the origin server or gateway given by the + original URL. This allows the origin server or gateway to + differentiate between internally-ambiguous URLs, such as the root "/" + URL of a server for multiple host names on a single IP address. + + Host = "Host" ":" host [ ":" port ] ; Section 3.2.2 + + A "host" without any trailing port information implies the default + port for the service requested (e.g., "80" for an HTTP URL). For + example, a request on the origin server for + would properly include: + + GET /pub/WWW/ HTTP/1.1 + Host: www.w3.org + + A client MUST include a Host header field in all HTTP/1.1 request + messages . If the requested URI does not include an Internet host + name for the service being requested, then the Host header field MUST + be given with an empty value. An HTTP/1.1 proxy MUST ensure that any + request message it forwards does contain an appropriate Host header + field that identifies the service being requested by the proxy. All + Internet-based HTTP/1.1 servers MUST respond with a 400 (Bad Request) + status code to any HTTP/1.1 request message which lacks a Host header + field. + + See sections 5.2 and 19.6.1.1 for other requirements relating to + Host. + +14.24 If-Match + + The If-Match request-header field is used with a method to make it + conditional. A client that has one or more entities previously + obtained from the resource can verify that one of those entities is + current by including a list of their associated entity tags in the + If-Match header field. Entity tags are defined in section 3.11. The + purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. It is also + used, on updating requests, to prevent inadvertent modification of + the wrong version of a resource. As a special case, the value "*" + matches any current entity of the resource. + + If-Match = "If-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-Match header) on that resource, or if "*" is given + + + + +Fielding, et al. Standards Track [Page 129] + +RFC 2616 HTTP/1.1 June 1999 + + + and any current entity exists for that resource, then the server MAY + perform the requested method as if the If-Match header field did not + exist. + + A server MUST use the strong comparison function (see section 13.3.3) + to compare the entity tags in If-Match. + + If none of the entity tags match, or if "*" is given and no current + entity exists, the server MUST NOT perform the requested method, and + MUST return a 412 (Precondition Failed) response. This behavior is + most useful when the client wants to prevent an updating method, such + as PUT, from modifying a resource that has changed since the client + last retrieved it. + + If the request would, without the If-Match header field, result in + anything other than a 2xx or 412 status, then the If-Match header + MUST be ignored. + + The meaning of "If-Match: *" is that the method SHOULD be performed + if the representation selected by the origin server (or by a cache, + possibly using the Vary mechanism, see section 14.44) exists, and + MUST NOT be performed if the representation does not exist. + + A request intended to update a resource (e.g., a PUT) MAY include an + If-Match header field to signal that the request method MUST NOT be + applied if the entity corresponding to the If-Match value (a single + entity tag) is no longer a representation of that resource. This + allows the user to indicate that they do not wish the request to be + successful if the resource has been changed without their knowledge. + Examples: + + If-Match: "xyzzy" + If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-Match: * + + The result of a request having both an If-Match header field and + either an If-None-Match or an If-Modified-Since header fields is + undefined by this specification. + +14.25 If-Modified-Since + + The If-Modified-Since request-header field is used with a method to + make it conditional: if the requested variant has not been modified + since the time specified in this field, an entity will not be + returned from the server; instead, a 304 (not modified) response will + be returned without any message-body. + + If-Modified-Since = "If-Modified-Since" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 130] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of the field is: + + If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + A GET method with an If-Modified-Since header and no Range header + requests that the identified entity be transferred only if it has + been modified since the date given by the If-Modified-Since header. + The algorithm for determining this includes the following cases: + + a) If the request would normally result in anything other than a + 200 (OK) status, or if the passed If-Modified-Since date is + invalid, the response is exactly the same as for a normal GET. + A date which is later than the server's current time is + invalid. + + b) If the variant has been modified since the If-Modified-Since + date, the response is exactly the same as for a normal GET. + + c) If the variant has not been modified since a valid If- + Modified-Since date, the server SHOULD return a 304 (Not + Modified) response. + + The purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. + + Note: The Range request-header field modifies the meaning of If- + Modified-Since; see section 14.35 for full details. + + Note: If-Modified-Since times are interpreted by the server, whose + clock might not be synchronized with the client. + + Note: When handling an If-Modified-Since header field, some + servers will use an exact date comparison function, rather than a + less-than function, for deciding whether to send a 304 (Not + Modified) response. To get best results when sending an If- + Modified-Since header field for cache validation, clients are + advised to use the exact date string received in a previous Last- + Modified header field whenever possible. + + Note: If a client uses an arbitrary date in the If-Modified-Since + header instead of a date taken from the Last-Modified header for + the same request, the client should be aware of the fact that this + date is interpreted in the server's understanding of time. The + client should consider unsynchronized clocks and rounding problems + due to the different encodings of time between the client and + server. This includes the possibility of race conditions if the + document has changed between the time it was first requested and + the If-Modified-Since date of a subsequent request, and the + + + +Fielding, et al. Standards Track [Page 131] + +RFC 2616 HTTP/1.1 June 1999 + + + possibility of clock-skew-related problems if the If-Modified- + Since date is derived from the client's clock without correction + to the server's clock. Corrections for different time bases + between client and server are at best approximate due to network + latency. + + The result of a request having both an If-Modified-Since header field + and either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.26 If-None-Match + + The If-None-Match request-header field is used with a method to make + it conditional. A client that has one or more entities previously + obtained from the resource can verify that none of those entities is + current by including a list of their associated entity tags in the + If-None-Match header field. The purpose of this feature is to allow + efficient updates of cached information with a minimum amount of + transaction overhead. It is also used to prevent a method (e.g. PUT) + from inadvertently modifying an existing resource when the client + believes that the resource does not exist. + + As a special case, the value "*" matches any current entity of the + resource. + + If-None-Match = "If-None-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-None-Match header) on that resource, or if "*" is + given and any current entity exists for that resource, then the + server MUST NOT perform the requested method, unless required to do + so because the resource's modification date fails to match that + supplied in an If-Modified-Since header field in the request. + Instead, if the request method was GET or HEAD, the server SHOULD + respond with a 304 (Not Modified) response, including the cache- + related header fields (particularly ETag) of one of the entities that + matched. For all other request methods, the server MUST respond with + a status of 412 (Precondition Failed). + + See section 13.3.3 for rules on how to determine if two entities tags + match. The weak comparison function can only be used with GET or HEAD + requests. + + + + + + + + +Fielding, et al. Standards Track [Page 132] + +RFC 2616 HTTP/1.1 June 1999 + + + If none of the entity tags match, then the server MAY perform the + requested method as if the If-None-Match header field did not exist, + but MUST also ignore any If-Modified-Since header field(s) in the + request. That is, if no entity tags match, then the server MUST NOT + return a 304 (Not Modified) response. + + If the request would, without the If-None-Match header field, result + in anything other than a 2xx or 304 status, then the If-None-Match + header MUST be ignored. (See section 13.3.4 for a discussion of + server behavior when both If-Modified-Since and If-None-Match appear + in the same request.) + + The meaning of "If-None-Match: *" is that the method MUST NOT be + performed if the representation selected by the origin server (or by + a cache, possibly using the Vary mechanism, see section 14.44) + exists, and SHOULD be performed if the representation does not exist. + This feature is intended to be useful in preventing races between PUT + operations. + + Examples: + + If-None-Match: "xyzzy" + If-None-Match: W/"xyzzy" + If-None-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-None-Match: W/"xyzzy", W/"r2d2xxxx", W/"c3piozzzz" + If-None-Match: * + + The result of a request having both an If-None-Match header field and + either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.27 If-Range + + If a client has a partial copy of an entity in its cache, and wishes + to have an up-to-date copy of the entire entity in its cache, it + could use the Range request-header with a conditional GET (using + either or both of If-Unmodified-Since and If-Match.) However, if the + condition fails because the entity has been modified, the client + would then have to make a second request to obtain the entire current + entity-body. + + The If-Range header allows a client to "short-circuit" the second + request. Informally, its meaning is `if the entity is unchanged, send + me the part(s) that I am missing; otherwise, send me the entire new + entity'. + + If-Range = "If-Range" ":" ( entity-tag | HTTP-date ) + + + + +Fielding, et al. Standards Track [Page 133] + +RFC 2616 HTTP/1.1 June 1999 + + + If the client has no entity tag for an entity, but does have a Last- + Modified date, it MAY use that date in an If-Range header. (The + server can distinguish between a valid HTTP-date and any form of + entity-tag by examining no more than two characters.) The If-Range + header SHOULD only be used together with a Range header, and MUST be + ignored if the request does not include a Range header, or if the + server does not support the sub-range operation. + + If the entity tag given in the If-Range header matches the current + entity tag for the entity, then the server SHOULD provide the + specified sub-range of the entity using a 206 (Partial content) + response. If the entity tag does not match, then the server SHOULD + return the entire entity using a 200 (OK) response. + +14.28 If-Unmodified-Since + + The If-Unmodified-Since request-header field is used with a method to + make it conditional. If the requested resource has not been modified + since the time specified in this field, the server SHOULD perform the + requested operation as if the If-Unmodified-Since header were not + present. + + If the requested variant has been modified since the specified time, + the server MUST NOT perform the requested operation, and MUST return + a 412 (Precondition Failed). + + If-Unmodified-Since = "If-Unmodified-Since" ":" HTTP-date + + An example of the field is: + + If-Unmodified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + If the request normally (i.e., without the If-Unmodified-Since + header) would result in anything other than a 2xx or 412 status, the + If-Unmodified-Since header SHOULD be ignored. + + If the specified date is invalid, the header is ignored. + + The result of a request having both an If-Unmodified-Since header + field and either an If-None-Match or an If-Modified-Since header + fields is undefined by this specification. + +14.29 Last-Modified + + The Last-Modified entity-header field indicates the date and time at + which the origin server believes the variant was last modified. + + Last-Modified = "Last-Modified" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 134] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of its use is + + Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT + + The exact meaning of this header field depends on the implementation + of the origin server and the nature of the original resource. For + files, it may be just the file system last-modified time. For + entities with dynamically included parts, it may be the most recent + of the set of last-modify times for its component parts. For database + gateways, it may be the last-update time stamp of the record. For + virtual objects, it may be the last time the internal state changed. + + An origin server MUST NOT send a Last-Modified date which is later + than the server's time of message origination. In such cases, where + the resource's last modification would indicate some time in the + future, the server MUST replace that date with the message + origination date. + + An origin server SHOULD obtain the Last-Modified value of the entity + as close as possible to the time that it generates the Date value of + its response. This allows a recipient to make an accurate assessment + of the entity's modification time, especially if the entity changes + near the time that the response is generated. + + HTTP/1.1 servers SHOULD send Last-Modified whenever feasible. + +14.30 Location + + The Location response-header field is used to redirect the recipient + to a location other than the Request-URI for completion of the + request or identification of a new resource. For 201 (Created) + responses, the Location is that of the new resource which was created + by the request. For 3xx responses, the location SHOULD indicate the + server's preferred URI for automatic redirection to the resource. The + field value consists of a single absolute URI. + + Location = "Location" ":" absoluteURI + + An example is: + + Location: http://www.w3.org/pub/WWW/People.html + + Note: The Content-Location header field (section 14.14) differs + from Location in that the Content-Location identifies the original + location of the entity enclosed in the request. It is therefore + possible for a response to contain header fields for both Location + and Content-Location. Also see section 13.10 for cache + requirements of some methods. + + + +Fielding, et al. Standards Track [Page 135] + +RFC 2616 HTTP/1.1 June 1999 + + +14.31 Max-Forwards + + The Max-Forwards request-header field provides a mechanism with the + TRACE (section 9.8) and OPTIONS (section 9.2) methods to limit the + number of proxies or gateways that can forward the request to the + next inbound server. This can be useful when the client is attempting + to trace a request chain which appears to be failing or looping in + mid-chain. + + Max-Forwards = "Max-Forwards" ":" 1*DIGIT + + The Max-Forwards value is a decimal integer indicating the remaining + number of times this request message may be forwarded. + + Each proxy or gateway recipient of a TRACE or OPTIONS request + containing a Max-Forwards header field MUST check and update its + value prior to forwarding the request. If the received value is zero + (0), the recipient MUST NOT forward the request; instead, it MUST + respond as the final recipient. If the received Max-Forwards value is + greater than zero, then the forwarded message MUST contain an updated + Max-Forwards field with a value decremented by one (1). + + The Max-Forwards header field MAY be ignored for all other methods + defined by this specification and for any extension methods for which + it is not explicitly referred to as part of that method definition. + +14.32 Pragma + + The Pragma general-header field is used to include implementation- + specific directives that might apply to any recipient along the + request/response chain. All pragma directives specify optional + behavior from the viewpoint of the protocol; however, some systems + MAY require that behavior be consistent with the directives. + + Pragma = "Pragma" ":" 1#pragma-directive + pragma-directive = "no-cache" | extension-pragma + extension-pragma = token [ "=" ( token | quoted-string ) ] + + When the no-cache directive is present in a request message, an + application SHOULD forward the request toward the origin server even + if it has a cached copy of what is being requested. This pragma + directive has the same semantics as the no-cache cache-directive (see + section 14.9) and is defined here for backward compatibility with + HTTP/1.0. Clients SHOULD include both header fields when a no-cache + request is sent to a server not known to be HTTP/1.1 compliant. + + + + + + +Fielding, et al. Standards Track [Page 136] + +RFC 2616 HTTP/1.1 June 1999 + + + Pragma directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a pragma for a + specific recipient; however, any pragma directive not relevant to a + recipient SHOULD be ignored by that recipient. + + HTTP/1.1 caches SHOULD treat "Pragma: no-cache" as if the client had + sent "Cache-Control: no-cache". No new Pragma directives will be + defined in HTTP. + + Note: because the meaning of "Pragma: no-cache as a response + header field is not actually specified, it does not provide a + reliable replacement for "Cache-Control: no-cache" in a response + +14.33 Proxy-Authenticate + + The Proxy-Authenticate response-header field MUST be included as part + of a 407 (Proxy Authentication Required) response. The field value + consists of a challenge that indicates the authentication scheme and + parameters applicable to the proxy for this Request-URI. + + Proxy-Authenticate = "Proxy-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. Unlike + WWW-Authenticate, the Proxy-Authenticate header field applies only to + the current connection and SHOULD NOT be passed on to downstream + clients. However, an intermediate proxy might need to obtain its own + credentials by requesting them from the downstream client, which in + some circumstances will appear as if the proxy is forwarding the + Proxy-Authenticate header field. + +14.34 Proxy-Authorization + + The Proxy-Authorization request-header field allows the client to + identify itself (or its user) to a proxy which requires + authentication. The Proxy-Authorization field value consists of + credentials containing the authentication information of the user + agent for the proxy and/or realm of the resource being requested. + + Proxy-Authorization = "Proxy-Authorization" ":" credentials + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43] . Unlike + Authorization, the Proxy-Authorization header field applies only to + the next outbound proxy that demanded authentication using the Proxy- + Authenticate field. When multiple proxies are used in a chain, the + + + +Fielding, et al. Standards Track [Page 137] + +RFC 2616 HTTP/1.1 June 1999 + + + Proxy-Authorization header field is consumed by the first outbound + proxy that was expecting to receive credentials. A proxy MAY relay + the credentials from the client request to the next proxy if that is + the mechanism by which the proxies cooperatively authenticate a given + request. + +14.35 Range + +14.35.1 Byte Ranges + + Since all HTTP entities are represented in HTTP messages as sequences + of bytes, the concept of a byte range is meaningful for any HTTP + entity. (However, not all clients and servers need to support byte- + range operations.) + + Byte range specifications in HTTP apply to the sequence of bytes in + the entity-body (not necessarily the same as the message-body). + + A byte range operation MAY specify a single range of bytes, or a set + of ranges within a single entity. + + ranges-specifier = byte-ranges-specifier + byte-ranges-specifier = bytes-unit "=" byte-range-set + byte-range-set = 1#( byte-range-spec | suffix-byte-range-spec ) + byte-range-spec = first-byte-pos "-" [last-byte-pos] + first-byte-pos = 1*DIGIT + last-byte-pos = 1*DIGIT + + The first-byte-pos value in a byte-range-spec gives the byte-offset + of the first byte in a range. The last-byte-pos value gives the + byte-offset of the last byte in the range; that is, the byte + positions specified are inclusive. Byte offsets start at zero. + + If the last-byte-pos value is present, it MUST be greater than or + equal to the first-byte-pos in that byte-range-spec, or the byte- + range-spec is syntactically invalid. The recipient of a byte-range- + set that includes one or more syntactically invalid byte-range-spec + values MUST ignore the header field that includes that byte-range- + set. + + If the last-byte-pos value is absent, or if the value is greater than + or equal to the current length of the entity-body, last-byte-pos is + taken to be equal to one less than the current length of the entity- + body in bytes. + + By its choice of last-byte-pos, a client can limit the number of + bytes retrieved without knowing the size of the entity. + + + + +Fielding, et al. Standards Track [Page 138] + +RFC 2616 HTTP/1.1 June 1999 + + + suffix-byte-range-spec = "-" suffix-length + suffix-length = 1*DIGIT + + A suffix-byte-range-spec is used to specify the suffix of the + entity-body, of a length given by the suffix-length value. (That is, + this form specifies the last N bytes of an entity-body.) If the + entity is shorter than the specified suffix-length, the entire + entity-body is used. + + If a syntactically valid byte-range-set includes at least one byte- + range-spec whose first-byte-pos is less than the current length of + the entity-body, or at least one suffix-byte-range-spec with a non- + zero suffix-length, then the byte-range-set is satisfiable. + Otherwise, the byte-range-set is unsatisfiable. If the byte-range-set + is unsatisfiable, the server SHOULD return a response with a status + of 416 (Requested range not satisfiable). Otherwise, the server + SHOULD return a response with a status of 206 (Partial Content) + containing the satisfiable ranges of the entity-body. + + Examples of byte-ranges-specifier values (assuming an entity-body of + length 10000): + + - The first 500 bytes (byte offsets 0-499, inclusive): bytes=0- + 499 + + - The second 500 bytes (byte offsets 500-999, inclusive): + bytes=500-999 + + - The final 500 bytes (byte offsets 9500-9999, inclusive): + bytes=-500 + + - Or bytes=9500- + + - The first and last bytes only (bytes 0 and 9999): bytes=0-0,-1 + + - Several legal but not canonical specifications of the second 500 + bytes (byte offsets 500-999, inclusive): + bytes=500-600,601-999 + bytes=500-700,601-999 + +14.35.2 Range Retrieval Requests + + HTTP retrieval requests using conditional or unconditional GET + methods MAY request one or more sub-ranges of the entity, instead of + the entire entity, using the Range request header, which applies to + the entity returned as the result of the request: + + Range = "Range" ":" ranges-specifier + + + +Fielding, et al. Standards Track [Page 139] + +RFC 2616 HTTP/1.1 June 1999 + + + A server MAY ignore the Range header. However, HTTP/1.1 origin + servers and intermediate caches ought to support byte ranges when + possible, since Range supports efficient recovery from partially + failed transfers, and supports efficient partial retrieval of large + entities. + + If the server supports the Range header and the specified range or + ranges are appropriate for the entity: + + - The presence of a Range header in an unconditional GET modifies + what is returned if the GET is otherwise successful. In other + words, the response carries a status code of 206 (Partial + Content) instead of 200 (OK). + + - The presence of a Range header in a conditional GET (a request + using one or both of If-Modified-Since and If-None-Match, or + one or both of If-Unmodified-Since and If-Match) modifies what + is returned if the GET is otherwise successful and the + condition is true. It does not affect the 304 (Not Modified) + response returned if the conditional is false. + + In some cases, it might be more appropriate to use the If-Range + header (see section 14.27) in addition to the Range header. + + If a proxy that supports ranges receives a Range request, forwards + the request to an inbound server, and receives an entire entity in + reply, it SHOULD only return the requested range to its client. It + SHOULD store the entire received response in its cache if that is + consistent with its cache allocation policies. + +14.36 Referer + + The Referer[sic] request-header field allows the client to specify, + for the server's benefit, the address (URI) of the resource from + which the Request-URI was obtained (the "referrer", although the + header field is misspelled.) The Referer request-header allows a + server to generate lists of back-links to resources for interest, + logging, optimized caching, etc. It also allows obsolete or mistyped + links to be traced for maintenance. The Referer field MUST NOT be + sent if the Request-URI was obtained from a source that does not have + its own URI, such as input from the user keyboard. + + Referer = "Referer" ":" ( absoluteURI | relativeURI ) + + Example: + + Referer: http://www.w3.org/hypertext/DataSources/Overview.html + + + + +Fielding, et al. Standards Track [Page 140] + +RFC 2616 HTTP/1.1 June 1999 + + + If the field value is a relative URI, it SHOULD be interpreted + relative to the Request-URI. The URI MUST NOT include a fragment. See + section 15.1.3 for security considerations. + +14.37 Retry-After + + The Retry-After response-header field can be used with a 503 (Service + Unavailable) response to indicate how long the service is expected to + be unavailable to the requesting client. This field MAY also be used + with any 3xx (Redirection) response to indicate the minimum time the + user-agent is asked wait before issuing the redirected request. The + value of this field can be either an HTTP-date or an integer number + of seconds (in decimal) after the time of the response. + + Retry-After = "Retry-After" ":" ( HTTP-date | delta-seconds ) + + Two examples of its use are + + Retry-After: Fri, 31 Dec 1999 23:59:59 GMT + Retry-After: 120 + + In the latter example, the delay is 2 minutes. + +14.38 Server + + The Server response-header field contains information about the + software used by the origin server to handle the request. The field + can contain multiple product tokens (section 3.8) and comments + identifying the server and any significant subproducts. The product + tokens are listed in order of their significance for identifying the + application. + + Server = "Server" ":" 1*( product | comment ) + + Example: + + Server: CERN/3.0 libwww/2.17 + + If the response is being forwarded through a proxy, the proxy + application MUST NOT modify the Server response-header. Instead, it + SHOULD include a Via field (as described in section 14.45). + + Note: Revealing the specific software version of the server might + allow the server machine to become more vulnerable to attacks + against software that is known to contain security holes. Server + implementors are encouraged to make this field a configurable + option. + + + + +Fielding, et al. Standards Track [Page 141] + +RFC 2616 HTTP/1.1 June 1999 + + +14.39 TE + + The TE request-header field indicates what extension transfer-codings + it is willing to accept in the response and whether or not it is + willing to accept trailer fields in a chunked transfer-coding. Its + value may consist of the keyword "trailers" and/or a comma-separated + list of extension transfer-coding names with optional accept + parameters (as described in section 3.6). + + TE = "TE" ":" #( t-codings ) + t-codings = "trailers" | ( transfer-extension [ accept-params ] ) + + The presence of the keyword "trailers" indicates that the client is + willing to accept trailer fields in a chunked transfer-coding, as + defined in section 3.6.1. This keyword is reserved for use with + transfer-coding values even though it does not itself represent a + transfer-coding. + + Examples of its use are: + + TE: deflate + TE: + TE: trailers, deflate;q=0.5 + + The TE header field only applies to the immediate connection. + Therefore, the keyword MUST be supplied within a Connection header + field (section 14.10) whenever TE is present in an HTTP/1.1 message. + + A server tests whether a transfer-coding is acceptable, according to + a TE field, using these rules: + + 1. The "chunked" transfer-coding is always acceptable. If the + keyword "trailers" is listed, the client indicates that it is + willing to accept trailer fields in the chunked response on + behalf of itself and any downstream clients. The implication is + that, if given, the client is stating that either all + downstream clients are willing to accept trailer fields in the + forwarded response, or that it will attempt to buffer the + response on behalf of downstream recipients. + + Note: HTTP/1.1 does not define any means to limit the size of a + chunked response such that a client can be assured of buffering + the entire response. + + 2. If the transfer-coding being tested is one of the transfer- + codings listed in the TE field, then it is acceptable unless it + is accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + + +Fielding, et al. Standards Track [Page 142] + +RFC 2616 HTTP/1.1 June 1999 + + + 3. If multiple transfer-codings are acceptable, then the + acceptable transfer-coding with the highest non-zero qvalue is + preferred. The "chunked" transfer-coding always has a qvalue + of 1. + + If the TE field-value is empty or if no TE field is present, the only + transfer-coding is "chunked". A message with no transfer-coding is + always acceptable. + +14.40 Trailer + + The Trailer general field value indicates that the given set of + header fields is present in the trailer of a message encoded with + chunked transfer-coding. + + Trailer = "Trailer" ":" 1#field-name + + An HTTP/1.1 message SHOULD include a Trailer header field in a + message using chunked transfer-coding with a non-empty trailer. Doing + so allows the recipient to know which header fields to expect in the + trailer. + + If no Trailer header field is present, the trailer SHOULD NOT include + any header fields. See section 3.6.1 for restrictions on the use of + trailer fields in a "chunked" transfer-coding. + + Message header fields listed in the Trailer header field MUST NOT + include the following header fields: + + . Transfer-Encoding + + . Content-Length + + . Trailer + +14.41 Transfer-Encoding + + The Transfer-Encoding general-header field indicates what (if any) + type of transformation has been applied to the message body in order + to safely transfer it between the sender and the recipient. This + differs from the content-coding in that the transfer-coding is a + property of the message, not of the entity. + + Transfer-Encoding = "Transfer-Encoding" ":" 1#transfer-coding + + Transfer-codings are defined in section 3.6. An example is: + + Transfer-Encoding: chunked + + + +Fielding, et al. Standards Track [Page 143] + +RFC 2616 HTTP/1.1 June 1999 + + + If multiple encodings have been applied to an entity, the transfer- + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + + Many older HTTP/1.0 applications do not understand the Transfer- + Encoding header. + +14.42 Upgrade + + The Upgrade general-header allows the client to specify what + additional communication protocols it supports and would like to use + if the server finds it appropriate to switch protocols. The server + MUST use the Upgrade header field within a 101 (Switching Protocols) + response to indicate which protocol(s) are being switched. + + Upgrade = "Upgrade" ":" 1#product + + For example, + + Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11 + + The Upgrade header field is intended to provide a simple mechanism + for transition from HTTP/1.1 to some other, incompatible protocol. It + does so by allowing the client to advertise its desire to use another + protocol, such as a later version of HTTP with a higher major version + number, even though the current request has been made using HTTP/1.1. + This eases the difficult transition between incompatible protocols by + allowing the client to initiate a request in the more commonly + supported protocol while indicating to the server that it would like + to use a "better" protocol if available (where "better" is determined + by the server, possibly according to the nature of the method and/or + resource being requested). + + The Upgrade header field only applies to switching application-layer + protocols upon the existing transport-layer connection. Upgrade + cannot be used to insist on a protocol change; its acceptance and use + by the server is optional. The capabilities and nature of the + application-layer communication after the protocol change is entirely + dependent upon the new protocol chosen, although the first action + after changing the protocol MUST be a response to the initial HTTP + request containing the Upgrade header field. + + The Upgrade header field only applies to the immediate connection. + Therefore, the upgrade keyword MUST be supplied within a Connection + header field (section 14.10) whenever Upgrade is present in an + HTTP/1.1 message. + + + + +Fielding, et al. Standards Track [Page 144] + +RFC 2616 HTTP/1.1 June 1999 + + + The Upgrade header field cannot be used to indicate a switch to a + protocol on a different connection. For that purpose, it is more + appropriate to use a 301, 302, 303, or 305 redirection response. + + This specification only defines the protocol name "HTTP" for use by + the family of Hypertext Transfer Protocols, as defined by the HTTP + version rules of section 3.1 and future updates to this + specification. Any token can be used as a protocol name; however, it + will only be useful if both the client and server associate the name + with the same protocol. + +14.43 User-Agent + + The User-Agent request-header field contains information about the + user agent originating the request. This is for statistical purposes, + the tracing of protocol violations, and automated recognition of user + agents for the sake of tailoring responses to avoid particular user + agent limitations. User agents SHOULD include this field with + requests. The field can contain multiple product tokens (section 3.8) + and comments identifying the agent and any subproducts which form a + significant part of the user agent. By convention, the product tokens + are listed in order of their significance for identifying the + application. + + User-Agent = "User-Agent" ":" 1*( product | comment ) + + Example: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + +14.44 Vary + + The Vary field value indicates the set of request-header fields that + fully determines, while the response is fresh, whether a cache is + permitted to use the response to reply to a subsequent request + without revalidation. For uncacheable or stale responses, the Vary + field value advises the user agent about the criteria that were used + to select the representation. A Vary field value of "*" implies that + a cache cannot determine from the request headers of a subsequent + request whether this response is the appropriate representation. See + section 13.6 for use of the Vary header field by caches. + + Vary = "Vary" ":" ( "*" | 1#field-name ) + + An HTTP/1.1 server SHOULD include a Vary header field with any + cacheable response that is subject to server-driven negotiation. + Doing so allows a cache to properly interpret future requests on that + resource and informs the user agent about the presence of negotiation + + + +Fielding, et al. Standards Track [Page 145] + +RFC 2616 HTTP/1.1 June 1999 + + + on that resource. A server MAY include a Vary header field with a + non-cacheable response that is subject to server-driven negotiation, + since this might provide the user agent with useful information about + the dimensions over which the response varies at the time of the + response. + + A Vary field value consisting of a list of field-names signals that + the representation selected for the response is based on a selection + algorithm which considers ONLY the listed request-header field values + in selecting the most appropriate representation. A cache MAY assume + that the same selection will be made for future requests with the + same values for the listed field names, for the duration of time for + which the response is fresh. + + The field-names given are not limited to the set of standard + request-header fields defined by this specification. Field names are + case-insensitive. + + A Vary field value of "*" signals that unspecified parameters not + limited to the request-headers (e.g., the network address of the + client), play a role in the selection of the response representation. + The "*" value MUST NOT be generated by a proxy server; it may only be + generated by an origin server. + +14.45 Via + + The Via general-header field MUST be used by gateways and proxies to + indicate the intermediate protocols and recipients between the user + agent and the server on requests, and between the origin server and + the client on responses. It is analogous to the "Received" field of + RFC 822 [9] and is intended to be used for tracking message forwards, + avoiding request loops, and identifying the protocol capabilities of + all senders along the request/response chain. + + Via = "Via" ":" 1#( received-protocol received-by [ comment ] ) + received-protocol = [ protocol-name "/" ] protocol-version + protocol-name = token + protocol-version = token + received-by = ( host [ ":" port ] ) | pseudonym + pseudonym = token + + The received-protocol indicates the protocol version of the message + received by the server or client along each segment of the + request/response chain. The received-protocol version is appended to + the Via field value when the message is forwarded so that information + about the protocol capabilities of upstream applications remains + visible to all recipients. + + + + +Fielding, et al. Standards Track [Page 146] + +RFC 2616 HTTP/1.1 June 1999 + + + The protocol-name is optional if and only if it would be "HTTP". The + received-by field is normally the host and optional port number of a + recipient server or client that subsequently forwarded the message. + However, if the real host is considered to be sensitive information, + it MAY be replaced by a pseudonym. If the port is not given, it MAY + be assumed to be the default port of the received-protocol. + + Multiple Via field values represents each proxy or gateway that has + forwarded the message. Each recipient MUST append its information + such that the end result is ordered according to the sequence of + forwarding applications. + + Comments MAY be used in the Via header field to identify the software + of the recipient proxy or gateway, analogous to the User-Agent and + Server header fields. However, all comments in the Via field are + optional and MAY be removed by any recipient prior to forwarding the + message. + + For example, a request message could be sent from an HTTP/1.0 user + agent to an internal proxy code-named "fred", which uses HTTP/1.1 to + forward the request to a public proxy at nowhere.com, which completes + the request by forwarding it to the origin server at www.ics.uci.edu. + The request received by www.ics.uci.edu would then have the following + Via header field: + + Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1) + + Proxies and gateways used as a portal through a network firewall + SHOULD NOT, by default, forward the names and ports of hosts within + the firewall region. This information SHOULD only be propagated if + explicitly enabled. If not enabled, the received-by host of any host + behind the firewall SHOULD be replaced by an appropriate pseudonym + for that host. + + For organizations that have strong privacy requirements for hiding + internal structures, a proxy MAY combine an ordered subsequence of + Via header field entries with identical received-protocol values into + a single such entry. For example, + + Via: 1.0 ricky, 1.1 ethel, 1.1 fred, 1.0 lucy + + could be collapsed to + + Via: 1.0 ricky, 1.1 mertz, 1.0 lucy + + + + + + + +Fielding, et al. Standards Track [Page 147] + +RFC 2616 HTTP/1.1 June 1999 + + + Applications SHOULD NOT combine multiple entries unless they are all + under the same organizational control and the hosts have already been + replaced by pseudonyms. Applications MUST NOT combine entries which + have different received-protocol values. + +14.46 Warning + + The Warning general-header field is used to carry additional + information about the status or transformation of a message which + might not be reflected in the message. This information is typically + used to warn about a possible lack of semantic transparency from + caching operations or transformations applied to the entity body of + the message. + + Warning headers are sent with responses using: + + Warning = "Warning" ":" 1#warning-value + + warning-value = warn-code SP warn-agent SP warn-text + [SP warn-date] + + warn-code = 3DIGIT + warn-agent = ( host [ ":" port ] ) | pseudonym + ; the name or pseudonym of the server adding + ; the Warning header, for use in debugging + warn-text = quoted-string + warn-date = <"> HTTP-date <"> + + A response MAY carry more than one Warning header. + + The warn-text SHOULD be in a natural language and character set that + is most likely to be intelligible to the human user receiving the + response. This decision MAY be based on any available knowledge, such + as the location of the cache or user, the Accept-Language field in a + request, the Content-Language field in a response, etc. The default + language is English and the default character set is ISO-8859-1. + + If a character set other than ISO-8859-1 is used, it MUST be encoded + in the warn-text using the method described in RFC 2047 [14]. + + Warning headers can in general be applied to any message, however + some specific warn-codes are specific to caches and can only be + applied to response messages. New Warning headers SHOULD be added + after any existing Warning headers. A cache MUST NOT delete any + Warning header that it received with a message. However, if a cache + successfully validates a cache entry, it SHOULD remove any Warning + headers previously attached to that entry except as specified for + + + + +Fielding, et al. Standards Track [Page 148] + +RFC 2616 HTTP/1.1 June 1999 + + + specific Warning codes. It MUST then add any Warning headers received + in the validating response. In other words, Warning headers are those + that would be attached to the most recent relevant response. + + When multiple Warning headers are attached to a response, the user + agent ought to inform the user of as many of them as possible, in the + order that they appear in the response. If it is not possible to + inform the user of all of the warnings, the user agent SHOULD follow + these heuristics: + + - Warnings that appear early in the response take priority over + those appearing later in the response. + + - Warnings in the user's preferred character set take priority + over warnings in other character sets but with identical warn- + codes and warn-agents. + + Systems that generate multiple Warning headers SHOULD order them with + this user agent behavior in mind. + + Requirements for the behavior of caches with respect to Warnings are + stated in section 13.1.2. + + This is a list of the currently-defined warn-codes, each with a + recommended warn-text in English, and a description of its meaning. + + 110 Response is stale + MUST be included whenever the returned response is stale. + + 111 Revalidation failed + MUST be included if a cache returns a stale response because an + attempt to revalidate the response failed, due to an inability to + reach the server. + + 112 Disconnected operation + SHOULD be included if the cache is intentionally disconnected from + the rest of the network for a period of time. + + 113 Heuristic expiration + MUST be included if the cache heuristically chose a freshness + lifetime greater than 24 hours and the response's age is greater + than 24 hours. + + 199 Miscellaneous warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action, besides presenting the warning to + the user. + + + +Fielding, et al. Standards Track [Page 149] + +RFC 2616 HTTP/1.1 June 1999 + + + 214 Transformation applied + MUST be added by an intermediate cache or proxy if it applies any + transformation changing the content-coding (as specified in the + Content-Encoding header) or media-type (as specified in the + Content-Type header) of the response, or the entity-body of the + response, unless this Warning code already appears in the response. + + 299 Miscellaneous persistent warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action. + + If an implementation sends a message with one or more Warning headers + whose version is HTTP/1.0 or lower, then the sender MUST include in + each warning-value a warn-date that matches the date in the response. + + If an implementation receives a message with a warning-value that + includes a warn-date, and that warn-date is different from the Date + value in the response, then that warning-value MUST be deleted from + the message before storing, forwarding, or using it. (This prevents + bad consequences of naive caching of Warning header fields.) If all + of the warning-values are deleted for this reason, the Warning header + MUST be deleted as well. + +14.47 WWW-Authenticate + + The WWW-Authenticate response-header field MUST be included in 401 + (Unauthorized) response messages. The field value consists of at + least one challenge that indicates the authentication scheme(s) and + parameters applicable to the Request-URI. + + WWW-Authenticate = "WWW-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. User + agents are advised to take special care in parsing the WWW- + Authenticate field value as it might contain more than one challenge, + or if more than one WWW-Authenticate header field is provided, the + contents of a challenge itself can contain a comma-separated list of + authentication parameters. + +15 Security Considerations + + This section is meant to inform application developers, information + providers, and users of the security limitations in HTTP/1.1 as + described by this document. The discussion does not include + definitive solutions to the problems revealed, though it does make + some suggestions for reducing security risks. + + + +Fielding, et al. Standards Track [Page 150] + +RFC 2616 HTTP/1.1 June 1999 + + +15.1 Personal Information + + HTTP clients are often privy to large amounts of personal information + (e.g. the user's name, location, mail address, passwords, encryption + keys, etc.), and SHOULD be very careful to prevent unintentional + leakage of this information via the HTTP protocol to other sources. + We very strongly recommend that a convenient interface be provided + for the user to control dissemination of such information, and that + designers and implementors be particularly careful in this area. + History shows that errors in this area often create serious security + and/or privacy problems and generate highly adverse publicity for the + implementor's company. + +15.1.1 Abuse of Server Log Information + + A server is in the position to save personal data about a user's + requests which might identify their reading patterns or subjects of + interest. This information is clearly confidential in nature and its + handling can be constrained by law in certain countries. People using + the HTTP protocol to provide data are responsible for ensuring that + such material is not distributed without the permission of any + individuals that are identifiable by the published results. + +15.1.2 Transfer of Sensitive Information + + Like any generic data transfer protocol, HTTP cannot regulate the + content of the data that is transferred, nor is there any a priori + method of determining the sensitivity of any particular piece of + information within the context of any given request. Therefore, + applications SHOULD supply as much control over this information as + possible to the provider of that information. Four header fields are + worth special mention in this context: Server, Via, Referer and From. + + Revealing the specific software version of the server might allow the + server machine to become more vulnerable to attacks against software + that is known to contain security holes. Implementors SHOULD make the + Server header field a configurable option. + + Proxies which serve as a portal through a network firewall SHOULD + take special precautions regarding the transfer of header information + that identifies the hosts behind the firewall. In particular, they + SHOULD remove, or replace with sanitized versions, any Via fields + generated behind the firewall. + + The Referer header allows reading patterns to be studied and reverse + links drawn. Although it can be very useful, its power can be abused + if user details are not separated from the information contained in + + + + +Fielding, et al. Standards Track [Page 151] + +RFC 2616 HTTP/1.1 June 1999 + + + the Referer. Even when the personal information has been removed, the + Referer header might indicate a private document's URI whose + publication would be inappropriate. + + The information sent in the From field might conflict with the user's + privacy interests or their site's security policy, and hence it + SHOULD NOT be transmitted without the user being able to disable, + enable, and modify the contents of the field. The user MUST be able + to set the contents of this field within a user preference or + application defaults configuration. + + We suggest, though do not require, that a convenient toggle interface + be provided for the user to enable or disable the sending of From and + Referer information. + + The User-Agent (section 14.43) or Server (section 14.38) header + fields can sometimes be used to determine that a specific client or + server have a particular security hole which might be exploited. + Unfortunately, this same information is often used for other valuable + purposes for which HTTP currently has no better mechanism. + +15.1.3 Encoding Sensitive Information in URI's + + Because the source of a link might be private information or might + reveal an otherwise private information source, it is strongly + recommended that the user be able to select whether or not the + Referer field is sent. For example, a browser client could have a + toggle switch for browsing openly/anonymously, which would + respectively enable/disable the sending of Referer and From + information. + + Clients SHOULD NOT include a Referer header field in a (non-secure) + HTTP request if the referring page was transferred with a secure + protocol. + + Authors of services which use the HTTP protocol SHOULD NOT use GET + based forms for the submission of sensitive data, because this will + cause this data to be encoded in the Request-URI. Many existing + servers, proxies, and user agents will log the request URI in some + place where it might be visible to third parties. Servers can use + POST-based form submission instead + +15.1.4 Privacy Issues Connected to Accept Headers + + Accept request-headers can reveal information about the user to all + servers which are accessed. The Accept-Language header in particular + can reveal information the user would consider to be of a private + nature, because the understanding of particular languages is often + + + +Fielding, et al. Standards Track [Page 152] + +RFC 2616 HTTP/1.1 June 1999 + + + strongly correlated to the membership of a particular ethnic group. + User agents which offer the option to configure the contents of an + Accept-Language header to be sent in every request are strongly + encouraged to let the configuration process include a message which + makes the user aware of the loss of privacy involved. + + An approach that limits the loss of privacy would be for a user agent + to omit the sending of Accept-Language headers by default, and to ask + the user whether or not to start sending Accept-Language headers to a + server if it detects, by looking for any Vary response-header fields + generated by the server, that such sending could improve the quality + of service. + + Elaborate user-customized accept header fields sent in every request, + in particular if these include quality values, can be used by servers + as relatively reliable and long-lived user identifiers. Such user + identifiers would allow content providers to do click-trail tracking, + and would allow collaborating content providers to match cross-server + click-trails or form submissions of individual users. Note that for + many users not behind a proxy, the network address of the host + running the user agent will also serve as a long-lived user + identifier. In environments where proxies are used to enhance + privacy, user agents ought to be conservative in offering accept + header configuration options to end users. As an extreme privacy + measure, proxies could filter the accept headers in relayed requests. + General purpose user agents which provide a high degree of header + configurability SHOULD warn users about the loss of privacy which can + be involved. + +15.2 Attacks Based On File and Path Names + + Implementations of HTTP origin servers SHOULD be careful to restrict + the documents returned by HTTP requests to be only those that were + intended by the server administrators. If an HTTP server translates + HTTP URIs directly into file system calls, the server MUST take + special care not to serve files that were not intended to be + delivered to HTTP clients. For example, UNIX, Microsoft Windows, and + other operating systems use ".." as a path component to indicate a + directory level above the current one. On such a system, an HTTP + server MUST disallow any such construct in the Request-URI if it + would otherwise allow access to a resource outside those intended to + be accessible via the HTTP server. Similarly, files intended for + reference only internally to the server (such as access control + files, configuration files, and script code) MUST be protected from + inappropriate retrieval, since they might contain sensitive + information. Experience has shown that minor bugs in such HTTP server + implementations have turned into security risks. + + + + +Fielding, et al. Standards Track [Page 153] + +RFC 2616 HTTP/1.1 June 1999 + + +15.3 DNS Spoofing + + Clients using HTTP rely heavily on the Domain Name Service, and are + thus generally prone to security attacks based on the deliberate + mis-association of IP addresses and DNS names. Clients need to be + cautious in assuming the continuing validity of an IP number/DNS name + association. + + In particular, HTTP clients SHOULD rely on their name resolver for + confirmation of an IP number/DNS name association, rather than + caching the result of previous host name lookups. Many platforms + already can cache host name lookups locally when appropriate, and + they SHOULD be configured to do so. It is proper for these lookups to + be cached, however, only when the TTL (Time To Live) information + reported by the name server makes it likely that the cached + information will remain useful. + + If HTTP clients cache the results of host name lookups in order to + achieve a performance improvement, they MUST observe the TTL + information reported by DNS. + + If HTTP clients do not observe this rule, they could be spoofed when + a previously-accessed server's IP address changes. As network + renumbering is expected to become increasingly common [24], the + possibility of this form of attack will grow. Observing this + requirement thus reduces this potential security vulnerability. + + This requirement also improves the load-balancing behavior of clients + for replicated servers using the same DNS name and reduces the + likelihood of a user's experiencing failure in accessing sites which + use that strategy. + +15.4 Location Headers and Spoofing + + If a single server supports multiple organizations that do not trust + one another, then it MUST check the values of Location and Content- + Location headers in responses that are generated under control of + said organizations to make sure that they do not attempt to + invalidate resources over which they have no authority. + +15.5 Content-Disposition Issues + + RFC 1806 [35], from which the often implemented Content-Disposition + (see section 19.5.1) header in HTTP is derived, has a number of very + serious security considerations. Content-Disposition is not part of + the HTTP standard, but since it is widely implemented, we are + documenting its use and risks for implementors. See RFC 2183 [49] + (which updates RFC 1806) for details. + + + +Fielding, et al. Standards Track [Page 154] + +RFC 2616 HTTP/1.1 June 1999 + + +15.6 Authentication Credentials and Idle Clients + + Existing HTTP clients and user agents typically retain authentication + information indefinitely. HTTP/1.1. does not provide a method for a + server to direct clients to discard these cached credentials. This is + a significant defect that requires further extensions to HTTP. + Circumstances under which credential caching can interfere with the + application's security model include but are not limited to: + + - Clients which have been idle for an extended period following + which the server might wish to cause the client to reprompt the + user for credentials. + + - Applications which include a session termination indication + (such as a `logout' or `commit' button on a page) after which + the server side of the application `knows' that there is no + further reason for the client to retain the credentials. + + This is currently under separate study. There are a number of work- + arounds to parts of this problem, and we encourage the use of + password protection in screen savers, idle time-outs, and other + methods which mitigate the security problems inherent in this + problem. In particular, user agents which cache credentials are + encouraged to provide a readily accessible mechanism for discarding + cached credentials under user control. + +15.7 Proxies and Caching + + By their very nature, HTTP proxies are men-in-the-middle, and + represent an opportunity for man-in-the-middle attacks. Compromise of + the systems on which the proxies run can result in serious security + and privacy problems. Proxies have access to security-related + information, personal information about individual users and + organizations, and proprietary information belonging to users and + content providers. A compromised proxy, or a proxy implemented or + configured without regard to security and privacy considerations, + might be used in the commission of a wide range of potential attacks. + + Proxy operators should protect the systems on which proxies run as + they would protect any system that contains or transports sensitive + information. In particular, log information gathered at proxies often + contains highly sensitive personal information, and/or information + about organizations. Log information should be carefully guarded, and + appropriate guidelines for use developed and followed. (Section + 15.1.1). + + + + + + +Fielding, et al. Standards Track [Page 155] + +RFC 2616 HTTP/1.1 June 1999 + + + Caching proxies provide additional potential vulnerabilities, since + the contents of the cache represent an attractive target for + malicious exploitation. Because cache contents persist after an HTTP + request is complete, an attack on the cache can reveal information + long after a user believes that the information has been removed from + the network. Therefore, cache contents should be protected as + sensitive information. + + Proxy implementors should consider the privacy and security + implications of their design and coding decisions, and of the + configuration options they provide to proxy operators (especially the + default configuration). + + Users of a proxy need to be aware that they are no trustworthier than + the people who run the proxy; HTTP itself cannot solve this problem. + + The judicious use of cryptography, when appropriate, may suffice to + protect against a broad range of security and privacy attacks. Such + cryptography is beyond the scope of the HTTP/1.1 specification. + +15.7.1 Denial of Service Attacks on Proxies + + They exist. They are hard to defend against. Research continues. + Beware. + +16 Acknowledgments + + This specification makes heavy use of the augmented BNF and generic + constructs defined by David H. Crocker for RFC 822 [9]. Similarly, it + reuses many of the definitions provided by Nathaniel Borenstein and + Ned Freed for MIME [7]. We hope that their inclusion in this + specification will help reduce past confusion over the relationship + between HTTP and Internet mail message formats. + + The HTTP protocol has evolved considerably over the years. It has + benefited from a large and active developer community--the many + people who have participated on the www-talk mailing list--and it is + that community which has been most responsible for the success of + HTTP and of the World-Wide Web in general. Marc Andreessen, Robert + Cailliau, Daniel W. Connolly, Bob Denny, John Franks, Jean-Francois + Groff, Phillip M. Hallam-Baker, Hakon W. Lie, Ari Luotonen, Rob + McCool, Lou Montulli, Dave Raggett, Tony Sanders, and Marc + VanHeyningen deserve special recognition for their efforts in + defining early aspects of the protocol. + + This document has benefited greatly from the comments of all those + participating in the HTTP-WG. In addition to those already mentioned, + the following individuals have contributed to this specification: + + + +Fielding, et al. Standards Track [Page 156] + +RFC 2616 HTTP/1.1 June 1999 + + + Gary Adams Ross Patterson + Harald Tveit Alvestrand Albert Lunde + Keith Ball John C. Mallery + Brian Behlendorf Jean-Philippe Martin-Flatin + Paul Burchard Mitra + Maurizio Codogno David Morris + Mike Cowlishaw Gavin Nicol + Roman Czyborra Bill Perry + Michael A. Dolan Jeffrey Perry + David J. Fiander Scott Powers + Alan Freier Owen Rees + Marc Hedlund Luigi Rizzo + Greg Herlihy David Robinson + Koen Holtman Marc Salomon + Alex Hopmann Rich Salz + Bob Jernigan Allan M. Schiffman + Shel Kaphan Jim Seidman + Rohit Khare Chuck Shotton + John Klensin Eric W. Sink + Martijn Koster Simon E. Spero + Alexei Kosut Richard N. Taylor + David M. Kristol Robert S. Thau + Daniel LaLiberte Bill (BearHeart) Weinman + Ben Laurie Francois Yergeau + Paul J. Leach Mary Ellen Zurko + Daniel DuBois Josh Cohen + + + Much of the content and presentation of the caching design is due to + suggestions and comments from individuals including: Shel Kaphan, + Paul Leach, Koen Holtman, David Morris, and Larry Masinter. + + Most of the specification of ranges is based on work originally done + by Ari Luotonen and John Franks, with additional input from Steve + Zilles. + + Thanks to the "cave men" of Palo Alto. You know who you are. + + Jim Gettys (the current editor of this document) wishes particularly + to thank Roy Fielding, the previous editor of this document, along + with John Klensin, Jeff Mogul, Paul Leach, Dave Kristol, Koen + Holtman, John Franks, Josh Cohen, Alex Hopmann, Scott Lawrence, and + Larry Masinter for their help. And thanks go particularly to Jeff + Mogul and Scott Lawrence for performing the "MUST/MAY/SHOULD" audit. + + + + + + + +Fielding, et al. Standards Track [Page 157] + +RFC 2616 HTTP/1.1 June 1999 + + + The Apache Group, Anselm Baird-Smith, author of Jigsaw, and Henrik + Frystyk implemented RFC 2068 early, and we wish to thank them for the + discovery of many of the problems that this document attempts to + rectify. + +17 References + + [1] Alvestrand, H., "Tags for the Identification of Languages", RFC + 1766, March 1995. + + [2] Anklesaria, F., McCahill, M., Lindner, P., Johnson, D., Torrey, + D. and B. Alberti, "The Internet Gopher Protocol (a distributed + document search and retrieval protocol)", RFC 1436, March 1993. + + [3] Berners-Lee, T., "Universal Resource Identifiers in WWW", RFC + 1630, June 1994. + + [4] Berners-Lee, T., Masinter, L. and M. McCahill, "Uniform Resource + Locators (URL)", RFC 1738, December 1994. + + [5] Berners-Lee, T. and D. Connolly, "Hypertext Markup Language - + 2.0", RFC 1866, November 1995. + + [6] Berners-Lee, T., Fielding, R. and H. Frystyk, "Hypertext Transfer + Protocol -- HTTP/1.0", RFC 1945, May 1996. + + [7] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part One: Format of Internet Message Bodies", + RFC 2045, November 1996. + + [8] Braden, R., "Requirements for Internet Hosts -- Communication + Layers", STD 3, RFC 1123, October 1989. + + [9] Crocker, D., "Standard for The Format of ARPA Internet Text + Messages", STD 11, RFC 822, August 1982. + + [10] Davis, F., Kahle, B., Morris, H., Salem, J., Shen, T., Wang, R., + Sui, J., and M. Grinbaum, "WAIS Interface Protocol Prototype + Functional Specification," (v1.5), Thinking Machines + Corporation, April 1990. + + [11] Fielding, R., "Relative Uniform Resource Locators", RFC 1808, + June 1995. + + [12] Horton, M. and R. Adams, "Standard for Interchange of USENET + Messages", RFC 1036, December 1987. + + + + + +Fielding, et al. Standards Track [Page 158] + +RFC 2616 HTTP/1.1 June 1999 + + + [13] Kantor, B. and P. Lapsley, "Network News Transfer Protocol", RFC + 977, February 1986. + + [14] Moore, K., "MIME (Multipurpose Internet Mail Extensions) Part + Three: Message Header Extensions for Non-ASCII Text", RFC 2047, + November 1996. + + [15] Nebel, E. and L. Masinter, "Form-based File Upload in HTML", RFC + 1867, November 1995. + + [16] Postel, J., "Simple Mail Transfer Protocol", STD 10, RFC 821, + August 1982. + + [17] Postel, J., "Media Type Registration Procedure", RFC 1590, + November 1996. + + [18] Postel, J. and J. Reynolds, "File Transfer Protocol", STD 9, RFC + 959, October 1985. + + [19] Reynolds, J. and J. Postel, "Assigned Numbers", STD 2, RFC 1700, + October 1994. + + [20] Sollins, K. and L. Masinter, "Functional Requirements for + Uniform Resource Names", RFC 1737, December 1994. + + [21] US-ASCII. Coded Character Set - 7-Bit American Standard Code for + Information Interchange. Standard ANSI X3.4-1986, ANSI, 1986. + + [22] ISO-8859. International Standard -- Information Processing -- + 8-bit Single-Byte Coded Graphic Character Sets -- + Part 1: Latin alphabet No. 1, ISO-8859-1:1987. + Part 2: Latin alphabet No. 2, ISO-8859-2, 1987. + Part 3: Latin alphabet No. 3, ISO-8859-3, 1988. + Part 4: Latin alphabet No. 4, ISO-8859-4, 1988. + Part 5: Latin/Cyrillic alphabet, ISO-8859-5, 1988. + Part 6: Latin/Arabic alphabet, ISO-8859-6, 1987. + Part 7: Latin/Greek alphabet, ISO-8859-7, 1987. + Part 8: Latin/Hebrew alphabet, ISO-8859-8, 1988. + Part 9: Latin alphabet No. 5, ISO-8859-9, 1990. + + [23] Meyers, J. and M. Rose, "The Content-MD5 Header Field", RFC + 1864, October 1995. + + [24] Carpenter, B. and Y. Rekhter, "Renumbering Needs Work", RFC + 1900, February 1996. + + [25] Deutsch, P., "GZIP file format specification version 4.3", RFC + 1952, May 1996. + + + +Fielding, et al. Standards Track [Page 159] + +RFC 2616 HTTP/1.1 June 1999 + + + [26] Venkata N. Padmanabhan, and Jeffrey C. Mogul. "Improving HTTP + Latency", Computer Networks and ISDN Systems, v. 28, pp. 25-35, + Dec. 1995. Slightly revised version of paper in Proc. 2nd + International WWW Conference '94: Mosaic and the Web, Oct. 1994, + which is available at + http://www.ncsa.uiuc.edu/SDG/IT94/Proceedings/DDay/mogul/HTTPLat + ency.html. + + [27] Joe Touch, John Heidemann, and Katia Obraczka. "Analysis of HTTP + Performance", , + ISI Research Report ISI/RR-98-463, (original report dated Aug. + 1996), USC/Information Sciences Institute, August 1998. + + [28] Mills, D., "Network Time Protocol (Version 3) Specification, + Implementation and Analysis", RFC 1305, March 1992. + + [29] Deutsch, P., "DEFLATE Compressed Data Format Specification + version 1.3", RFC 1951, May 1996. + + [30] S. Spero, "Analysis of HTTP Performance Problems," + http://sunsite.unc.edu/mdma-release/http-prob.html. + + [31] Deutsch, P. and J. Gailly, "ZLIB Compressed Data Format + Specification version 3.3", RFC 1950, May 1996. + + [32] Franks, J., Hallam-Baker, P., Hostetler, J., Leach, P., + Luotonen, A., Sink, E. and L. Stewart, "An Extension to HTTP: + Digest Access Authentication", RFC 2069, January 1997. + + [33] Fielding, R., Gettys, J., Mogul, J., Frystyk, H. and T. + Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1", RFC + 2068, January 1997. + + [34] Bradner, S., "Key words for use in RFCs to Indicate Requirement + Levels", BCP 14, RFC 2119, March 1997. + + [35] Troost, R. and Dorner, S., "Communicating Presentation + Information in Internet Messages: The Content-Disposition + Header", RFC 1806, June 1995. + + [36] Mogul, J., Fielding, R., Gettys, J. and H. Frystyk, "Use and + Interpretation of HTTP Version Numbers", RFC 2145, May 1997. + [jg639] + + [37] Palme, J., "Common Internet Message Headers", RFC 2076, February + 1997. [jg640] + + + + + +Fielding, et al. Standards Track [Page 160] + +RFC 2616 HTTP/1.1 June 1999 + + + [38] Yergeau, F., "UTF-8, a transformation format of Unicode and + ISO-10646", RFC 2279, January 1998. [jg641] + + [39] Nielsen, H.F., Gettys, J., Baird-Smith, A., Prud'hommeaux, E., + Lie, H., and C. Lilley. "Network Performance Effects of + HTTP/1.1, CSS1, and PNG," Proceedings of ACM SIGCOMM '97, Cannes + France, September 1997.[jg642] + + [40] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Two: Media Types", RFC 2046, November + 1996. [jg643] + + [41] Alvestrand, H., "IETF Policy on Character Sets and Languages", + BCP 18, RFC 2277, January 1998. [jg644] + + [42] Berners-Lee, T., Fielding, R. and L. Masinter, "Uniform Resource + Identifiers (URI): Generic Syntax and Semantics", RFC 2396, + August 1998. [jg645] + + [43] Franks, J., Hallam-Baker, P., Hostetler, J., Lawrence, S., + Leach, P., Luotonen, A., Sink, E. and L. Stewart, "HTTP + Authentication: Basic and Digest Access Authentication", RFC + 2617, June 1999. [jg646] + + [44] Luotonen, A., "Tunneling TCP based protocols through Web proxy + servers," Work in Progress. [jg647] + + [45] Palme, J. and A. Hopmann, "MIME E-mail Encapsulation of + Aggregate Documents, such as HTML (MHTML)", RFC 2110, March + 1997. + + [46] Bradner, S., "The Internet Standards Process -- Revision 3", BCP + 9, RFC 2026, October 1996. + + [47] Masinter, L., "Hyper Text Coffee Pot Control Protocol + (HTCPCP/1.0)", RFC 2324, 1 April 1998. + + [48] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Five: Conformance Criteria and Examples", + RFC 2049, November 1996. + + [49] Troost, R., Dorner, S. and K. Moore, "Communicating Presentation + Information in Internet Messages: The Content-Disposition Header + Field", RFC 2183, August 1997. + + + + + + + +Fielding, et al. Standards Track [Page 161] + +RFC 2616 HTTP/1.1 June 1999 + + +18 Authors' Addresses + + Roy T. Fielding + Information and Computer Science + University of California, Irvine + Irvine, CA 92697-3425, USA + + Fax: +1 (949) 824-1715 + EMail: fielding@ics.uci.edu + + + James Gettys + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: jg@w3.org + + + Jeffrey C. Mogul + Western Research Laboratory + Compaq Computer Corporation + 250 University Avenue + Palo Alto, California, 94305, USA + + EMail: mogul@wrl.dec.com + + + Henrik Frystyk Nielsen + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: frystyk@w3.org + + + Larry Masinter + Xerox Corporation + 3333 Coyote Hill Road + Palo Alto, CA 94034, USA + + EMail: masinter@parc.xerox.com + + + + + +Fielding, et al. Standards Track [Page 162] + +RFC 2616 HTTP/1.1 June 1999 + + + Paul J. Leach + Microsoft Corporation + 1 Microsoft Way + Redmond, WA 98052, USA + + EMail: paulle@microsoft.com + + + Tim Berners-Lee + Director, World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: timbl@w3.org + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 163] + +RFC 2616 HTTP/1.1 June 1999 + + +19 Appendices + +19.1 Internet Media Type message/http and application/http + + In addition to defining the HTTP/1.1 protocol, this document serves + as the specification for the Internet media type "message/http" and + "application/http". The message/http type can be used to enclose a + single HTTP request or response message, provided that it obeys the + MIME restrictions for all "message" types regarding line length and + encodings. The application/http type can be used to enclose a + pipeline of one or more HTTP request or response messages (not + intermixed). The following is to be registered with IANA [17]. + + Media Type name: message + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed message + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + Media Type name: application + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed messages + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: HTTP messages enclosed by this type + are in "binary" format; use of an appropriate + Content-Transfer-Encoding is required when + transmitted via E-mail. + Security considerations: none + + + + + + + + + +Fielding, et al. Standards Track [Page 164] + +RFC 2616 HTTP/1.1 June 1999 + + +19.2 Internet Media Type multipart/byteranges + + When an HTTP 206 (Partial Content) response message includes the + content of multiple ranges (a response to a request for multiple + non-overlapping ranges), these are transmitted as a multipart + message-body. The media type for this purpose is called + "multipart/byteranges". + + The multipart/byteranges media type includes two or more parts, each + with its own Content-Type and Content-Range fields. The required + boundary parameter specifies the boundary string used to separate + each body-part. + + Media Type name: multipart + Media subtype name: byteranges + Required parameters: boundary + Optional parameters: none + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + + For example: + + HTTP/1.1 206 Partial Content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-type: multipart/byteranges; boundary=THIS_STRING_SEPARATES + + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 500-999/8000 + + ...the first range... + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 7000-7999/8000 + + ...the second range + --THIS_STRING_SEPARATES-- + + Notes: + + 1) Additional CRLFs may precede the first boundary string in the + entity. + + + + + + +Fielding, et al. Standards Track [Page 165] + +RFC 2616 HTTP/1.1 June 1999 + + + 2) Although RFC 2046 [40] permits the boundary string to be + quoted, some existing implementations handle a quoted boundary + string incorrectly. + + 3) A number of browsers and servers were coded to an early draft + of the byteranges specification to use a media type of + multipart/x-byteranges, which is almost, but not quite + compatible with the version documented in HTTP/1.1. + +19.3 Tolerant Applications + + Although this document specifies the requirements for the generation + of HTTP/1.1 messages, not all applications will be correct in their + implementation. We therefore recommend that operational applications + be tolerant of deviations whenever those deviations can be + interpreted unambiguously. + + Clients SHOULD be tolerant in parsing the Status-Line and servers + tolerant when parsing the Request-Line. In particular, they SHOULD + accept any amount of SP or HT characters between fields, even though + only a single SP is required. + + The line terminator for message-header fields is the sequence CRLF. + However, we recommend that applications, when parsing such headers, + recognize a single LF as a line terminator and ignore the leading CR. + + The character set of an entity-body SHOULD be labeled as the lowest + common denominator of the character codes used within that body, with + the exception that not labeling the entity is preferred over labeling + the entity with the labels US-ASCII or ISO-8859-1. See section 3.7.1 + and 3.4.1. + + Additional rules for requirements on parsing and encoding of dates + and other potential problems with date encodings include: + + - HTTP/1.1 clients and caches SHOULD assume that an RFC-850 date + which appears to be more than 50 years in the future is in fact + in the past (this helps solve the "year 2000" problem). + + - An HTTP/1.1 implementation MAY internally represent a parsed + Expires date as earlier than the proper value, but MUST NOT + internally represent a parsed Expires date as later than the + proper value. + + - All expiration-related calculations MUST be done in GMT. The + local time zone MUST NOT influence the calculation or comparison + of an age or expiration time. + + + + +Fielding, et al. Standards Track [Page 166] + +RFC 2616 HTTP/1.1 June 1999 + + + - If an HTTP header incorrectly carries a date value with a time + zone other than GMT, it MUST be converted into GMT using the + most conservative possible conversion. + +19.4 Differences Between HTTP Entities and RFC 2045 Entities + + HTTP/1.1 uses many of the constructs defined for Internet Mail (RFC + 822 [9]) and the Multipurpose Internet Mail Extensions (MIME [7]) to + allow entities to be transmitted in an open variety of + representations and with extensible mechanisms. However, RFC 2045 + discusses mail, and HTTP has a few features that are different from + those described in RFC 2045. These differences were carefully chosen + to optimize performance over binary connections, to allow greater + freedom in the use of new media types, to make date comparisons + easier, and to acknowledge the practice of some early HTTP servers + and clients. + + This appendix describes specific areas where HTTP differs from RFC + 2045. Proxies and gateways to strict MIME environments SHOULD be + aware of these differences and provide the appropriate conversions + where necessary. Proxies and gateways from MIME environments to HTTP + also need to be aware of the differences because some conversions + might be required. + +19.4.1 MIME-Version + + HTTP is not a MIME-compliant protocol. However, HTTP/1.1 messages MAY + include a single MIME-Version general-header field to indicate what + version of the MIME protocol was used to construct the message. Use + of the MIME-Version header field indicates that the message is in + full compliance with the MIME protocol (as defined in RFC 2045[7]). + Proxies/gateways are responsible for ensuring full compliance (where + possible) when exporting HTTP messages to strict MIME environments. + + MIME-Version = "MIME-Version" ":" 1*DIGIT "." 1*DIGIT + + MIME version "1.0" is the default for use in HTTP/1.1. However, + HTTP/1.1 message parsing and semantics are defined by this document + and not the MIME specification. + +19.4.2 Conversion to Canonical Form + + RFC 2045 [7] requires that an Internet mail entity be converted to + canonical form prior to being transferred, as described in section 4 + of RFC 2049 [48]. Section 3.7.1 of this document describes the forms + allowed for subtypes of the "text" media type when transmitted over + HTTP. RFC 2046 requires that content with a type of "text" represent + line breaks as CRLF and forbids the use of CR or LF outside of line + + + +Fielding, et al. Standards Track [Page 167] + +RFC 2616 HTTP/1.1 June 1999 + + + break sequences. HTTP allows CRLF, bare CR, and bare LF to indicate a + line break within text content when a message is transmitted over + HTTP. + + Where it is possible, a proxy or gateway from HTTP to a strict MIME + environment SHOULD translate all line breaks within the text media + types described in section 3.7.1 of this document to the RFC 2049 + canonical form of CRLF. Note, however, that this might be complicated + by the presence of a Content-Encoding and by the fact that HTTP + allows the use of some character sets which do not use octets 13 and + 10 to represent CR and LF, as is the case for some multi-byte + character sets. + + Implementors should note that conversion will break any cryptographic + checksums applied to the original content unless the original content + is already in canonical form. Therefore, the canonical form is + recommended for any content that uses such checksums in HTTP. + +19.4.3 Conversion of Date Formats + + HTTP/1.1 uses a restricted set of date formats (section 3.3.1) to + simplify the process of date comparison. Proxies and gateways from + other protocols SHOULD ensure that any Date header field present in a + message conforms to one of the HTTP/1.1 formats and rewrite the date + if necessary. + +19.4.4 Introduction of Content-Encoding + + RFC 2045 does not include any concept equivalent to HTTP/1.1's + Content-Encoding header field. Since this acts as a modifier on the + media type, proxies and gateways from HTTP to MIME-compliant + protocols MUST either change the value of the Content-Type header + field or decode the entity-body before forwarding the message. (Some + experimental applications of Content-Type for Internet mail have used + a media-type parameter of ";conversions=" to perform + a function equivalent to Content-Encoding. However, this parameter is + not part of RFC 2045.) + +19.4.5 No Content-Transfer-Encoding + + HTTP does not use the Content-Transfer-Encoding (CTE) field of RFC + 2045. Proxies and gateways from MIME-compliant protocols to HTTP MUST + remove any non-identity CTE ("quoted-printable" or "base64") encoding + prior to delivering the response message to an HTTP client. + + Proxies and gateways from HTTP to MIME-compliant protocols are + responsible for ensuring that the message is in the correct format + and encoding for safe transport on that protocol, where "safe + + + +Fielding, et al. Standards Track [Page 168] + +RFC 2616 HTTP/1.1 June 1999 + + + transport" is defined by the limitations of the protocol being used. + Such a proxy or gateway SHOULD label the data with an appropriate + Content-Transfer-Encoding if doing so will improve the likelihood of + safe transport over the destination protocol. + +19.4.6 Introduction of Transfer-Encoding + + HTTP/1.1 introduces the Transfer-Encoding header field (section + 14.41). Proxies/gateways MUST remove any transfer-coding prior to + forwarding a message via a MIME-compliant protocol. + + A process for decoding the "chunked" transfer-coding (section 3.6) + can be represented in pseudo-code as: + + length := 0 + read chunk-size, chunk-extension (if any) and CRLF + while (chunk-size > 0) { + read chunk-data and CRLF + append chunk-data to entity-body + length := length + chunk-size + read chunk-size and CRLF + } + read entity-header + while (entity-header not empty) { + append entity-header to existing header fields + read entity-header + } + Content-Length := length + Remove "chunked" from Transfer-Encoding + +19.4.7 MHTML and Line Length Limitations + + HTTP implementations which share code with MHTML [45] implementations + need to be aware of MIME line length limitations. Since HTTP does not + have this limitation, HTTP does not fold long lines. MHTML messages + being transported by HTTP follow all conventions of MHTML, including + line length limitations and folding, canonicalization, etc., since + HTTP transports all message-bodies as payload (see section 3.7.2) and + does not interpret the content or any MIME header lines that might be + contained therein. + +19.5 Additional Features + + RFC 1945 and RFC 2068 document protocol elements used by some + existing HTTP implementations, but not consistently and correctly + across most HTTP/1.1 applications. Implementors are advised to be + aware of these features, but cannot rely upon their presence in, or + interoperability with, other HTTP/1.1 applications. Some of these + + + +Fielding, et al. Standards Track [Page 169] + +RFC 2616 HTTP/1.1 June 1999 + + + describe proposed experimental features, and some describe features + that experimental deployment found lacking that are now addressed in + the base HTTP/1.1 specification. + + A number of other headers, such as Content-Disposition and Title, + from SMTP and MIME are also often implemented (see RFC 2076 [37]). + +19.5.1 Content-Disposition + + The Content-Disposition response-header field has been proposed as a + means for the origin server to suggest a default filename if the user + requests that the content is saved to a file. This usage is derived + from the definition of Content-Disposition in RFC 1806 [35]. + + content-disposition = "Content-Disposition" ":" + disposition-type *( ";" disposition-parm ) + disposition-type = "attachment" | disp-extension-token + disposition-parm = filename-parm | disp-extension-parm + filename-parm = "filename" "=" quoted-string + disp-extension-token = token + disp-extension-parm = token "=" ( token | quoted-string ) + + An example is + + Content-Disposition: attachment; filename="fname.ext" + + The receiving user agent SHOULD NOT respect any directory path + information present in the filename-parm parameter, which is the only + parameter believed to apply to HTTP implementations at this time. The + filename SHOULD be treated as a terminal component only. + + If this header is used in a response with the application/octet- + stream content-type, the implied suggestion is that the user agent + should not display the response, but directly enter a `save response + as...' dialog. + + See section 15.5 for Content-Disposition security issues. + +19.6 Compatibility with Previous Versions + + It is beyond the scope of a protocol specification to mandate + compliance with previous versions. HTTP/1.1 was deliberately + designed, however, to make supporting previous versions easy. It is + worth noting that, at the time of composing this specification + (1996), we would expect commercial HTTP/1.1 servers to: + + - recognize the format of the Request-Line for HTTP/0.9, 1.0, and + 1.1 requests; + + + +Fielding, et al. Standards Track [Page 170] + +RFC 2616 HTTP/1.1 June 1999 + + + - understand any valid request in the format of HTTP/0.9, 1.0, or + 1.1; + + - respond appropriately with a message in the same major version + used by the client. + + And we would expect HTTP/1.1 clients to: + + - recognize the format of the Status-Line for HTTP/1.0 and 1.1 + responses; + + - understand any valid response in the format of HTTP/0.9, 1.0, or + 1.1. + + For most implementations of HTTP/1.0, each connection is established + by the client prior to the request and closed by the server after + sending the response. Some implementations implement the Keep-Alive + version of persistent connections described in section 19.7.1 of RFC + 2068 [33]. + +19.6.1 Changes from HTTP/1.0 + + This section summarizes major differences between versions HTTP/1.0 + and HTTP/1.1. + +19.6.1.1 Changes to Simplify Multi-homed Web Servers and Conserve IP + Addresses + + The requirements that clients and servers support the Host request- + header, report an error if the Host request-header (section 14.23) is + missing from an HTTP/1.1 request, and accept absolute URIs (section + 5.1.2) are among the most important changes defined by this + specification. + + Older HTTP/1.0 clients assumed a one-to-one relationship of IP + addresses and servers; there was no other established mechanism for + distinguishing the intended server of a request than the IP address + to which that request was directed. The changes outlined above will + allow the Internet, once older HTTP clients are no longer common, to + support multiple Web sites from a single IP address, greatly + simplifying large operational Web servers, where allocation of many + IP addresses to a single host has created serious problems. The + Internet will also be able to recover the IP addresses that have been + allocated for the sole purpose of allowing special-purpose domain + names to be used in root-level HTTP URLs. Given the rate of growth of + the Web, and the number of servers already deployed, it is extremely + + + + + +Fielding, et al. Standards Track [Page 171] + +RFC 2616 HTTP/1.1 June 1999 + + + important that all implementations of HTTP (including updates to + existing HTTP/1.0 applications) correctly implement these + requirements: + + - Both clients and servers MUST support the Host request-header. + + - A client that sends an HTTP/1.1 request MUST send a Host header. + + - Servers MUST report a 400 (Bad Request) error if an HTTP/1.1 + request does not include a Host request-header. + + - Servers MUST accept absolute URIs. + +19.6.2 Compatibility with HTTP/1.0 Persistent Connections + + Some clients and servers might wish to be compatible with some + previous implementations of persistent connections in HTTP/1.0 + clients and servers. Persistent connections in HTTP/1.0 are + explicitly negotiated as they are not the default behavior. HTTP/1.0 + experimental implementations of persistent connections are faulty, + and the new facilities in HTTP/1.1 are designed to rectify these + problems. The problem was that some existing 1.0 clients may be + sending Keep-Alive to a proxy server that doesn't understand + Connection, which would then erroneously forward it to the next + inbound server, which would establish the Keep-Alive connection and + result in a hung HTTP/1.0 proxy waiting for the close on the + response. The result is that HTTP/1.0 clients must be prevented from + using Keep-Alive when talking to proxies. + + However, talking to proxies is the most important use of persistent + connections, so that prohibition is clearly unacceptable. Therefore, + we need some other mechanism for indicating a persistent connection + is desired, which is safe to use even when talking to an old proxy + that ignores Connection. Persistent connections are the default for + HTTP/1.1 messages; we introduce a new keyword (Connection: close) for + declaring non-persistence. See section 14.10. + + The original HTTP/1.0 form of persistent connections (the Connection: + Keep-Alive and Keep-Alive header) is documented in RFC 2068. [33] + +19.6.3 Changes from RFC 2068 + + This specification has been carefully audited to correct and + disambiguate key word usage; RFC 2068 had many problems in respect to + the conventions laid out in RFC 2119 [34]. + + Clarified which error code should be used for inbound server failures + (e.g. DNS failures). (Section 10.5.5). + + + +Fielding, et al. Standards Track [Page 172] + +RFC 2616 HTTP/1.1 June 1999 + + + CREATE had a race that required an Etag be sent when a resource is + first created. (Section 10.2.2). + + Content-Base was deleted from the specification: it was not + implemented widely, and there is no simple, safe way to introduce it + without a robust extension mechanism. In addition, it is used in a + similar, but not identical fashion in MHTML [45]. + + Transfer-coding and message lengths all interact in ways that + required fixing exactly when chunked encoding is used (to allow for + transfer encoding that may not be self delimiting); it was important + to straighten out exactly how message lengths are computed. (Sections + 3.6, 4.4, 7.2.2, 13.5.2, 14.13, 14.16) + + A content-coding of "identity" was introduced, to solve problems + discovered in caching. (section 3.5) + + Quality Values of zero should indicate that "I don't want something" + to allow clients to refuse a representation. (Section 3.9) + + The use and interpretation of HTTP version numbers has been clarified + by RFC 2145. Require proxies to upgrade requests to highest protocol + version they support to deal with problems discovered in HTTP/1.0 + implementations (Section 3.1) + + Charset wildcarding is introduced to avoid explosion of character set + names in accept headers. (Section 14.2) + + A case was missed in the Cache-Control model of HTTP/1.1; s-maxage + was introduced to add this missing case. (Sections 13.4, 14.8, 14.9, + 14.9.3) + + The Cache-Control: max-age directive was not properly defined for + responses. (Section 14.9.3) + + There are situations where a server (especially a proxy) does not + know the full length of a response but is capable of serving a + byterange request. We therefore need a mechanism to allow byteranges + with a content-range not indicating the full length of the message. + (Section 14.16) + + Range request responses would become very verbose if all meta-data + were always returned; by allowing the server to only send needed + headers in a 206 response, this problem can be avoided. (Section + 10.2.7, 13.5.3, and 14.27) + + + + + + +Fielding, et al. Standards Track [Page 173] + +RFC 2616 HTTP/1.1 June 1999 + + + Fix problem with unsatisfiable range requests; there are two cases: + syntactic problems, and range doesn't exist in the document. The 416 + status code was needed to resolve this ambiguity needed to indicate + an error for a byte range request that falls outside of the actual + contents of a document. (Section 10.4.17, 14.16) + + Rewrite of message transmission requirements to make it much harder + for implementors to get it wrong, as the consequences of errors here + can have significant impact on the Internet, and to deal with the + following problems: + + 1. Changing "HTTP/1.1 or later" to "HTTP/1.1", in contexts where + this was incorrectly placing a requirement on the behavior of + an implementation of a future version of HTTP/1.x + + 2. Made it clear that user-agents should retry requests, not + "clients" in general. + + 3. Converted requirements for clients to ignore unexpected 100 + (Continue) responses, and for proxies to forward 100 responses, + into a general requirement for 1xx responses. + + 4. Modified some TCP-specific language, to make it clearer that + non-TCP transports are possible for HTTP. + + 5. Require that the origin server MUST NOT wait for the request + body before it sends a required 100 (Continue) response. + + 6. Allow, rather than require, a server to omit 100 (Continue) if + it has already seen some of the request body. + + 7. Allow servers to defend against denial-of-service attacks and + broken clients. + + This change adds the Expect header and 417 status code. The message + transmission requirements fixes are in sections 8.2, 10.4.18, + 8.1.2.2, 13.11, and 14.20. + + Proxies should be able to add Content-Length when appropriate. + (Section 13.5.2) + + Clean up confusion between 403 and 404 responses. (Section 10.4.4, + 10.4.5, and 10.4.11) + + Warnings could be cached incorrectly, or not updated appropriately. + (Section 13.1.2, 13.2.4, 13.5.2, 13.5.3, 14.9.3, and 14.46) Warning + also needed to be a general header, as PUT or other methods may have + need for it in requests. + + + +Fielding, et al. Standards Track [Page 174] + +RFC 2616 HTTP/1.1 June 1999 + + + Transfer-coding had significant problems, particularly with + interactions with chunked encoding. The solution is that transfer- + codings become as full fledged as content-codings. This involves + adding an IANA registry for transfer-codings (separate from content + codings), a new header field (TE) and enabling trailer headers in the + future. Transfer encoding is a major performance benefit, so it was + worth fixing [39]. TE also solves another, obscure, downward + interoperability problem that could have occurred due to interactions + between authentication trailers, chunked encoding and HTTP/1.0 + clients.(Section 3.6, 3.6.1, and 14.39) + + The PATCH, LINK, UNLINK methods were defined but not commonly + implemented in previous versions of this specification. See RFC 2068 + [33]. + + The Alternates, Content-Version, Derived-From, Link, URI, Public and + Content-Base header fields were defined in previous versions of this + specification, but not commonly implemented. See RFC 2068 [33]. + +20 Index + + Please see the PostScript version of this RFC for the INDEX. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 175] + +RFC 2616 HTTP/1.1 June 1999 + + +21. Full Copyright Statement + + Copyright (C) The Internet Society (1999). All Rights Reserved. + + This document and translations of it may be copied and furnished to + others, and derivative works that comment on or otherwise explain it + or assist in its implementation may be prepared, copied, published + and distributed, in whole or in part, without restriction of any + kind, provided that the above copyright notice and this paragraph are + included on all such copies and derivative works. However, this + document itself may not be modified in any way, such as by removing + the copyright notice or references to the Internet Society or other + Internet organizations, except as needed for the purpose of + developing Internet standards in which case the procedures for + copyrights defined in the Internet Standards process must be + followed, or as required to translate it into languages other than + English. + + The limited permissions granted above are perpetual and will not be + revoked by the Internet Society or its successors or assigns. + + This document and the information contained herein is provided on an + "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING + TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING + BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION + HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF + MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + +Acknowledgement + + Funding for the RFC Editor function is currently provided by the + Internet Society. + + Network Working Group R. Fielding +Request for Comments: 2616 UC Irvine +Obsoletes: 2068 J. Gettys +Category: Standards Track Compaq/W3C + J. Mogul + Compaq + H. Frystyk + W3C/MIT + L. Masinter + Xerox + P. Leach + Microsoft + T. Berners-Lee + W3C/MIT + June 1999 + + + Hypertext Transfer Protocol -- HTTP/1.1 + +Status of this Memo + + This document specifies an Internet standards track protocol for the + Internet community, and requests discussion and suggestions for + improvements. Please refer to the current edition of the "Internet + Official Protocol Standards" (STD 1) for the standardization state + and status of this protocol. Distribution of this memo is unlimited. + +Copyright Notice + + Copyright (C) The Internet Society (1999). All Rights Reserved. + +Abstract + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. It is a generic, stateless, protocol which can be used for + many tasks beyond its use for hypertext, such as name servers and + distributed object management systems, through extension of its + request methods, error codes and headers [47]. A feature of HTTP is + the typing and negotiation of data representation, allowing systems + to be built independently of the data being transferred. + + HTTP has been in use by the World-Wide Web global information + initiative since 1990. This specification defines the protocol + referred to as "HTTP/1.1", and is an update to RFC 2068 [33]. + + + + + + +Fielding, et al. Standards Track [Page 1] + +RFC 2616 HTTP/1.1 June 1999 + + +Table of Contents + + 1 Introduction ...................................................7 + 1.1 Purpose......................................................7 + 1.2 Requirements .................................................8 + 1.3 Terminology ..................................................8 + 1.4 Overall Operation ...........................................12 + 2 Notational Conventions and Generic Grammar ....................14 + 2.1 Augmented BNF ...............................................14 + 2.2 Basic Rules .................................................15 + 3 Protocol Parameters ...........................................17 + 3.1 HTTP Version ................................................17 + 3.2 Uniform Resource Identifiers ................................18 + 3.2.1 General Syntax ...........................................19 + 3.2.2 http URL .................................................19 + 3.2.3 URI Comparison ...........................................20 + 3.3 Date/Time Formats ...........................................20 + 3.3.1 Full Date ................................................20 + 3.3.2 Delta Seconds ............................................21 + 3.4 Character Sets ..............................................21 + 3.4.1 Missing Charset ..........................................22 + 3.5 Content Codings .............................................23 + 3.6 Transfer Codings ............................................24 + 3.6.1 Chunked Transfer Coding ..................................25 + 3.7 Media Types .................................................26 + 3.7.1 Canonicalization and Text Defaults .......................27 + 3.7.2 Multipart Types ..........................................27 + 3.8 Product Tokens ..............................................28 + 3.9 Quality Values ..............................................29 + 3.10 Language Tags ...............................................29 + 3.11 Entity Tags .................................................30 + 3.12 Range Units .................................................30 + 4 HTTP Message ..................................................31 + 4.1 Message Types ...............................................31 + 4.2 Message Headers .............................................31 + 4.3 Message Body ................................................32 + 4.4 Message Length ..............................................33 + 4.5 General Header Fields .......................................34 + 5 Request .......................................................35 + 5.1 Request-Line ................................................35 + 5.1.1 Method ...................................................36 + 5.1.2 Request-URI ..............................................36 + 5.2 The Resource Identified by a Request ........................38 + 5.3 Request Header Fields .......................................38 + 6 Response ......................................................39 + 6.1 Status-Line .................................................39 + 6.1.1 Status Code and Reason Phrase ............................39 + 6.2 Response Header Fields ......................................41 + + + +Fielding, et al. Standards Track [Page 2] + +RFC 2616 HTTP/1.1 June 1999 + + + 7 Entity ........................................................42 + 7.1 Entity Header Fields ........................................42 + 7.2 Entity Body .................................................43 + 7.2.1 Type .....................................................43 + 7.2.2 Entity Length ............................................43 + 8 Connections ...................................................44 + 8.1 Persistent Connections ......................................44 + 8.1.1 Purpose ..................................................44 + 8.1.2 Overall Operation ........................................45 + 8.1.3 Proxy Servers ............................................46 + 8.1.4 Practical Considerations .................................46 + 8.2 Message Transmission Requirements ...........................47 + 8.2.1 Persistent Connections and Flow Control ..................47 + 8.2.2 Monitoring Connections for Error Status Messages .........48 + 8.2.3 Use of the 100 (Continue) Status .........................48 + 8.2.4 Client Behavior if Server Prematurely Closes Connection ..50 + 9 Method Definitions ............................................51 + 9.1 Safe and Idempotent Methods .................................51 + 9.1.1 Safe Methods .............................................51 + 9.1.2 Idempotent Methods .......................................51 + 9.2 OPTIONS .....................................................52 + 9.3 GET .........................................................53 + 9.4 HEAD ........................................................54 + 9.5 POST ........................................................54 + 9.6 PUT .........................................................55 + 9.7 DELETE ......................................................56 + 9.8 TRACE .......................................................56 + 9.9 CONNECT .....................................................57 + 10 Status Code Definitions ......................................57 + 10.1 Informational 1xx ...........................................57 + 10.1.1 100 Continue .............................................58 + 10.1.2 101 Switching Protocols ..................................58 + 10.2 Successful 2xx ..............................................58 + 10.2.1 200 OK ...................................................58 + 10.2.2 201 Created ..............................................59 + 10.2.3 202 Accepted .............................................59 + 10.2.4 203 Non-Authoritative Information ........................59 + 10.2.5 204 No Content ...........................................60 + 10.2.6 205 Reset Content ........................................60 + 10.2.7 206 Partial Content ......................................60 + 10.3 Redirection 3xx .............................................61 + 10.3.1 300 Multiple Choices .....................................61 + 10.3.2 301 Moved Permanently ....................................62 + 10.3.3 302 Found ................................................62 + 10.3.4 303 See Other ............................................63 + 10.3.5 304 Not Modified .........................................63 + 10.3.6 305 Use Proxy ............................................64 + 10.3.7 306 (Unused) .............................................64 + + + +Fielding, et al. Standards Track [Page 3] + +RFC 2616 HTTP/1.1 June 1999 + + + 10.3.8 307 Temporary Redirect ...................................65 + 10.4 Client Error 4xx ............................................65 + 10.4.1 400 Bad Request .........................................65 + 10.4.2 401 Unauthorized ........................................66 + 10.4.3 402 Payment Required ....................................66 + 10.4.4 403 Forbidden ...........................................66 + 10.4.5 404 Not Found ...........................................66 + 10.4.6 405 Method Not Allowed ..................................66 + 10.4.7 406 Not Acceptable ......................................67 + 10.4.8 407 Proxy Authentication Required .......................67 + 10.4.9 408 Request Timeout .....................................67 + 10.4.10 409 Conflict ............................................67 + 10.4.11 410 Gone ................................................68 + 10.4.12 411 Length Required .....................................68 + 10.4.13 412 Precondition Failed .................................68 + 10.4.14 413 Request Entity Too Large ............................69 + 10.4.15 414 Request-URI Too Long ................................69 + 10.4.16 415 Unsupported Media Type ..............................69 + 10.4.17 416 Requested Range Not Satisfiable .....................69 + 10.4.18 417 Expectation Failed ..................................70 + 10.5 Server Error 5xx ............................................70 + 10.5.1 500 Internal Server Error ................................70 + 10.5.2 501 Not Implemented ......................................70 + 10.5.3 502 Bad Gateway ..........................................70 + 10.5.4 503 Service Unavailable ..................................70 + 10.5.5 504 Gateway Timeout ......................................71 + 10.5.6 505 HTTP Version Not Supported ...........................71 + 11 Access Authentication ........................................71 + 12 Content Negotiation ..........................................71 + 12.1 Server-driven Negotiation ...................................72 + 12.2 Agent-driven Negotiation ....................................73 + 12.3 Transparent Negotiation .....................................74 + 13 Caching in HTTP ..............................................74 + 13.1.1 Cache Correctness ........................................75 + 13.1.2 Warnings .................................................76 + 13.1.3 Cache-control Mechanisms .................................77 + 13.1.4 Explicit User Agent Warnings .............................78 + 13.1.5 Exceptions to the Rules and Warnings .....................78 + 13.1.6 Client-controlled Behavior ...............................79 + 13.2 Expiration Model ............................................79 + 13.2.1 Server-Specified Expiration ..............................79 + 13.2.2 Heuristic Expiration .....................................80 + 13.2.3 Age Calculations .........................................80 + 13.2.4 Expiration Calculations ..................................83 + 13.2.5 Disambiguating Expiration Values .........................84 + 13.2.6 Disambiguating Multiple Responses ........................84 + 13.3 Validation Model ............................................85 + 13.3.1 Last-Modified Dates ......................................86 + + + +Fielding, et al. Standards Track [Page 4] + +RFC 2616 HTTP/1.1 June 1999 + + + 13.3.2 Entity Tag Cache Validators ..............................86 + 13.3.3 Weak and Strong Validators ...............................86 + 13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates.89 + 13.3.5 Non-validating Conditionals ..............................90 + 13.4 Response Cacheability .......................................91 + 13.5 Constructing Responses From Caches ..........................92 + 13.5.1 End-to-end and Hop-by-hop Headers ........................92 + 13.5.2 Non-modifiable Headers ...................................92 + 13.5.3 Combining Headers ........................................94 + 13.5.4 Combining Byte Ranges ....................................95 + 13.6 Caching Negotiated Responses ................................95 + 13.7 Shared and Non-Shared Caches ................................96 + 13.8 Errors or Incomplete Response Cache Behavior ................97 + 13.9 Side Effects of GET and HEAD ................................97 + 13.10 Invalidation After Updates or Deletions ...................97 + 13.11 Write-Through Mandatory ...................................98 + 13.12 Cache Replacement .........................................99 + 13.13 History Lists .............................................99 + 14 Header Field Definitions ....................................100 + 14.1 Accept .....................................................100 + 14.2 Accept-Charset .............................................102 + 14.3 Accept-Encoding ............................................102 + 14.4 Accept-Language ............................................104 + 14.5 Accept-Ranges ..............................................105 + 14.6 Age ........................................................106 + 14.7 Allow ......................................................106 + 14.8 Authorization ..............................................107 + 14.9 Cache-Control ..............................................108 + 14.9.1 What is Cacheable .......................................109 + 14.9.2 What May be Stored by Caches ............................110 + 14.9.3 Modifications of the Basic Expiration Mechanism .........111 + 14.9.4 Cache Revalidation and Reload Controls ..................113 + 14.9.5 No-Transform Directive ..................................115 + 14.9.6 Cache Control Extensions ................................116 + 14.10 Connection ...............................................117 + 14.11 Content-Encoding .........................................118 + 14.12 Content-Language .........................................118 + 14.13 Content-Length ...........................................119 + 14.14 Content-Location .........................................120 + 14.15 Content-MD5 ..............................................121 + 14.16 Content-Range ............................................122 + 14.17 Content-Type .............................................124 + 14.18 Date .....................................................124 + 14.18.1 Clockless Origin Server Operation ......................125 + 14.19 ETag .....................................................126 + 14.20 Expect ...................................................126 + 14.21 Expires ..................................................127 + 14.22 From .....................................................128 + + + +Fielding, et al. Standards Track [Page 5] + +RFC 2616 HTTP/1.1 June 1999 + + + 14.23 Host .....................................................128 + 14.24 If-Match .................................................129 + 14.25 If-Modified-Since ........................................130 + 14.26 If-None-Match ............................................132 + 14.27 If-Range .................................................133 + 14.28 If-Unmodified-Since ......................................134 + 14.29 Last-Modified ............................................134 + 14.30 Location .................................................135 + 14.31 Max-Forwards .............................................136 + 14.32 Pragma ...................................................136 + 14.33 Proxy-Authenticate .......................................137 + 14.34 Proxy-Authorization ......................................137 + 14.35 Range ....................................................138 + 14.35.1 Byte Ranges ...........................................138 + 14.35.2 Range Retrieval Requests ..............................139 + 14.36 Referer ..................................................140 + 14.37 Retry-After ..............................................141 + 14.38 Server ...................................................141 + 14.39 TE .......................................................142 + 14.40 Trailer ..................................................143 + 14.41 Transfer-Encoding..........................................143 + 14.42 Upgrade ..................................................144 + 14.43 User-Agent ...............................................145 + 14.44 Vary .....................................................145 + 14.45 Via ......................................................146 + 14.46 Warning ..................................................148 + 14.47 WWW-Authenticate .........................................150 + 15 Security Considerations .......................................150 + 15.1 Personal Information....................................151 + 15.1.1 Abuse of Server Log Information .........................151 + 15.1.2 Transfer of Sensitive Information .......................151 + 15.1.3 Encoding Sensitive Information in URI's .................152 + 15.1.4 Privacy Issues Connected to Accept Headers ..............152 + 15.2 Attacks Based On File and Path Names .......................153 + 15.3 DNS Spoofing ...............................................154 + 15.4 Location Headers and Spoofing ..............................154 + 15.5 Content-Disposition Issues .................................154 + 15.6 Authentication Credentials and Idle Clients ................155 + 15.7 Proxies and Caching ........................................155 + 15.7.1 Denial of Service Attacks on Proxies....................156 + 16 Acknowledgments .............................................156 + 17 References ..................................................158 + 18 Authors' Addresses ..........................................162 + 19 Appendices ..................................................164 + 19.1 Internet Media Type message/http and application/http ......164 + 19.2 Internet Media Type multipart/byteranges ...................165 + 19.3 Tolerant Applications ......................................166 + 19.4 Differences Between HTTP Entities and RFC 2045 Entities ....167 + + + +Fielding, et al. Standards Track [Page 6] + +RFC 2616 HTTP/1.1 June 1999 + + + 19.4.1 MIME-Version ............................................167 + 19.4.2 Conversion to Canonical Form ............................167 + 19.4.3 Conversion of Date Formats ..............................168 + 19.4.4 Introduction of Content-Encoding ........................168 + 19.4.5 No Content-Transfer-Encoding ............................168 + 19.4.6 Introduction of Transfer-Encoding .......................169 + 19.4.7 MHTML and Line Length Limitations .......................169 + 19.5 Additional Features ........................................169 + 19.5.1 Content-Disposition .....................................170 + 19.6 Compatibility with Previous Versions .......................170 + 19.6.1 Changes from HTTP/1.0 ...................................171 + 19.6.2 Compatibility with HTTP/1.0 Persistent Connections ......172 + 19.6.3 Changes from RFC 2068 ...................................172 + 20 Index .......................................................175 + 21 Full Copyright Statement ....................................176 + +1 Introduction + +1.1 Purpose + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. HTTP has been in use by the World-Wide Web global + information initiative since 1990. The first version of HTTP, + referred to as HTTP/0.9, was a simple protocol for raw data transfer + across the Internet. HTTP/1.0, as defined by RFC 1945 [6], improved + the protocol by allowing messages to be in the format of MIME-like + messages, containing metainformation about the data transferred and + modifiers on the request/response semantics. However, HTTP/1.0 does + not sufficiently take into consideration the effects of hierarchical + proxies, caching, the need for persistent connections, or virtual + hosts. In addition, the proliferation of incompletely-implemented + applications calling themselves "HTTP/1.0" has necessitated a + protocol version change in order for two communicating applications + to determine each other's true capabilities. + + This specification defines the protocol referred to as "HTTP/1.1". + This protocol includes more stringent requirements than HTTP/1.0 in + order to ensure reliable implementation of its features. + + Practical information systems require more functionality than simple + retrieval, including search, front-end update, and annotation. HTTP + allows an open-ended set of methods and headers that indicate the + purpose of a request [47]. It builds on the discipline of reference + provided by the Uniform Resource Identifier (URI) [3], as a location + (URL) [4] or name (URN) [20], for indicating the resource to which a + + + + + +Fielding, et al. Standards Track [Page 7] + +RFC 2616 HTTP/1.1 June 1999 + + + method is to be applied. Messages are passed in a format similar to + that used by Internet mail [9] as defined by the Multipurpose + Internet Mail Extensions (MIME) [7]. + + HTTP is also used as a generic protocol for communication between + user agents and proxies/gateways to other Internet systems, including + those supported by the SMTP [16], NNTP [13], FTP [18], Gopher [2], + and WAIS [10] protocols. In this way, HTTP allows basic hypermedia + access to resources available from diverse applications. + +1.2 Requirements + + The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", + "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this + document are to be interpreted as described in RFC 2119 [34]. + + An implementation is not compliant if it fails to satisfy one or more + of the MUST or REQUIRED level requirements for the protocols it + implements. An implementation that satisfies all the MUST or REQUIRED + level and all the SHOULD level requirements for its protocols is said + to be "unconditionally compliant"; one that satisfies all the MUST + level requirements but not all the SHOULD level requirements for its + protocols is said to be "conditionally compliant." + +1.3 Terminology + + This specification uses a number of terms to refer to the roles + played by participants in, and objects of, the HTTP communication. + + connection + A transport layer virtual circuit established between two programs + for the purpose of communication. + + message + The basic unit of HTTP communication, consisting of a structured + sequence of octets matching the syntax defined in section 4 and + transmitted via the connection. + + request + An HTTP request message, as defined in section 5. + + response + An HTTP response message, as defined in section 6. + + + + + + + + +Fielding, et al. Standards Track [Page 8] + +RFC 2616 HTTP/1.1 June 1999 + + + resource + A network data object or service that can be identified by a URI, + as defined in section 3.2. Resources may be available in multiple + representations (e.g. multiple languages, data formats, size, and + resolutions) or vary in other ways. + + entity + The information transferred as the payload of a request or + response. An entity consists of metainformation in the form of + entity-header fields and content in the form of an entity-body, as + described in section 7. + + representation + An entity included with a response that is subject to content + negotiation, as described in section 12. There may exist multiple + representations associated with a particular response status. + + content negotiation + The mechanism for selecting the appropriate representation when + servicing a request, as described in section 12. The + representation of entities in any response can be negotiated + (including error responses). + + variant + A resource may have one, or more than one, representation(s) + associated with it at any given instant. Each of these + representations is termed a `varriant'. Use of the term `variant' + does not necessarily imply that the resource is subject to content + negotiation. + + client + A program that establishes connections for the purpose of sending + requests. + + user agent + The client which initiates a request. These are often browsers, + editors, spiders (web-traversing robots), or other end user tools. + + server + An application program that accepts connections in order to + service requests by sending back responses. Any given program may + be capable of being both a client and a server; our use of these + terms refers only to the role being performed by the program for a + particular connection, rather than to the program's capabilities + in general. Likewise, any server may act as an origin server, + proxy, gateway, or tunnel, switching behavior based on the nature + of each request. + + + + +Fielding, et al. Standards Track [Page 9] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server + The server on which a given resource resides or is to be created. + + proxy + An intermediary program which acts as both a server and a client + for the purpose of making requests on behalf of other clients. + Requests are serviced internally or by passing them on, with + possible translation, to other servers. A proxy MUST implement + both the client and server requirements of this specification. A + "transparent proxy" is a proxy that does not modify the request or + response beyond what is required for proxy authentication and + identification. A "non-transparent proxy" is a proxy that modifies + the request or response in order to provide some added service to + the user agent, such as group annotation services, media type + transformation, protocol reduction, or anonymity filtering. Except + where either transparent or non-transparent behavior is explicitly + stated, the HTTP proxy requirements apply to both types of + proxies. + + gateway + A server which acts as an intermediary for some other server. + Unlike a proxy, a gateway receives requests as if it were the + origin server for the requested resource; the requesting client + may not be aware that it is communicating with a gateway. + + tunnel + An intermediary program which is acting as a blind relay between + two connections. Once active, a tunnel is not considered a party + to the HTTP communication, though the tunnel may have been + initiated by an HTTP request. The tunnel ceases to exist when both + ends of the relayed connections are closed. + + cache + A program's local store of response messages and the subsystem + that controls its message storage, retrieval, and deletion. A + cache stores cacheable responses in order to reduce the response + time and network bandwidth consumption on future, equivalent + requests. Any client or server may include a cache, though a cache + cannot be used by a server that is acting as a tunnel. + + cacheable + A response is cacheable if a cache is allowed to store a copy of + the response message for use in answering subsequent requests. The + rules for determining the cacheability of HTTP responses are + defined in section 13. Even if a resource is cacheable, there may + be additional constraints on whether a cache can use the cached + copy for a particular request. + + + + +Fielding, et al. Standards Track [Page 10] + +RFC 2616 HTTP/1.1 June 1999 + + + first-hand + A response is first-hand if it comes directly and without + unnecessary delay from the origin server, perhaps via one or more + proxies. A response is also first-hand if its validity has just + been checked directly with the origin server. + + explicit expiration time + The time at which the origin server intends that an entity should + no longer be returned by a cache without further validation. + + heuristic expiration time + An expiration time assigned by a cache when no explicit expiration + time is available. + + age + The age of a response is the time since it was sent by, or + successfully validated with, the origin server. + + freshness lifetime + The length of time between the generation of a response and its + expiration time. + + fresh + A response is fresh if its age has not yet exceeded its freshness + lifetime. + + stale + A response is stale if its age has passed its freshness lifetime. + + semantically transparent + A cache behaves in a "semantically transparent" manner, with + respect to a particular response, when its use affects neither the + requesting client nor the origin server, except to improve + performance. When a cache is semantically transparent, the client + receives exactly the same response (except for hop-by-hop headers) + that it would have received had its request been handled directly + by the origin server. + + validator + A protocol element (e.g., an entity tag or a Last-Modified time) + that is used to find out whether a cache entry is an equivalent + copy of an entity. + + upstream/downstream + Upstream and downstream describe the flow of a message: all + messages flow from upstream to downstream. + + + + + +Fielding, et al. Standards Track [Page 11] + +RFC 2616 HTTP/1.1 June 1999 + + + inbound/outbound + Inbound and outbound refer to the request and response paths for + messages: "inbound" means "traveling toward the origin server", + and "outbound" means "traveling toward the user agent" + +1.4 Overall Operation + + The HTTP protocol is a request/response protocol. A client sends a + request to the server in the form of a request method, URI, and + protocol version, followed by a MIME-like message containing request + modifiers, client information, and possible body content over a + connection with a server. The server responds with a status line, + including the message's protocol version and a success or error code, + followed by a MIME-like message containing server information, entity + metainformation, and possible entity-body content. The relationship + between HTTP and MIME is described in appendix 19.4. + + Most HTTP communication is initiated by a user agent and consists of + a request to be applied to a resource on some origin server. In the + simplest case, this may be accomplished via a single connection (v) + between the user agent (UA) and the origin server (O). + + request chain ------------------------> + UA -------------------v------------------- O + <----------------------- response chain + + A more complicated situation occurs when one or more intermediaries + are present in the request/response chain. There are three common + forms of intermediary: proxy, gateway, and tunnel. A proxy is a + forwarding agent, receiving requests for a URI in its absolute form, + rewriting all or part of the message, and forwarding the reformatted + request toward the server identified by the URI. A gateway is a + receiving agent, acting as a layer above some other server(s) and, if + necessary, translating the requests to the underlying server's + protocol. A tunnel acts as a relay point between two connections + without changing the messages; tunnels are used when the + communication needs to pass through an intermediary (such as a + firewall) even when the intermediary cannot understand the contents + of the messages. + + request chain --------------------------------------> + UA -----v----- A -----v----- B -----v----- C -----v----- O + <------------------------------------- response chain + + The figure above shows three intermediaries (A, B, and C) between the + user agent and origin server. A request or response message that + travels the whole chain will pass through four separate connections. + This distinction is important because some HTTP communication options + + + +Fielding, et al. Standards Track [Page 12] + +RFC 2616 HTTP/1.1 June 1999 + + + may apply only to the connection with the nearest, non-tunnel + neighbor, only to the end-points of the chain, or to all connections + along the chain. Although the diagram is linear, each participant may + be engaged in multiple, simultaneous communications. For example, B + may be receiving requests from many clients other than A, and/or + forwarding requests to servers other than C, at the same time that it + is handling A's request. + + Any party to the communication which is not acting as a tunnel may + employ an internal cache for handling requests. The effect of a cache + is that the request/response chain is shortened if one of the + participants along the chain has a cached response applicable to that + request. The following illustrates the resulting chain if B has a + cached copy of an earlier response from O (via C) for a request which + has not been cached by UA or A. + + request chain ----------> + UA -----v----- A -----v----- B - - - - - - C - - - - - - O + <--------- response chain + + Not all responses are usefully cacheable, and some requests may + contain modifiers which place special requirements on cache behavior. + HTTP requirements for cache behavior and cacheable responses are + defined in section 13. + + In fact, there are a wide variety of architectures and configurations + of caches and proxies currently being experimented with or deployed + across the World Wide Web. These systems include national hierarchies + of proxy caches to save transoceanic bandwidth, systems that + broadcast or multicast cache entries, organizations that distribute + subsets of cached data via CD-ROM, and so on. HTTP systems are used + in corporate intranets over high-bandwidth links, and for access via + PDAs with low-power radio links and intermittent connectivity. The + goal of HTTP/1.1 is to support the wide diversity of configurations + already deployed while introducing protocol constructs that meet the + needs of those who build web applications that require high + reliability and, failing that, at least reliable indications of + failure. + + HTTP communication usually takes place over TCP/IP connections. The + default port is TCP 80 [19], but other ports can be used. This does + not preclude HTTP from being implemented on top of any other protocol + on the Internet, or on other networks. HTTP only presumes a reliable + transport; any protocol that provides such guarantees can be used; + the mapping of the HTTP/1.1 request and response structures onto the + transport data units of the protocol in question is outside the scope + of this specification. + + + + +Fielding, et al. Standards Track [Page 13] + +RFC 2616 HTTP/1.1 June 1999 + + + In HTTP/1.0, most implementations used a new connection for each + request/response exchange. In HTTP/1.1, a connection may be used for + one or more request/response exchanges, although connections may be + closed for a variety of reasons (see section 8.1). + +2 Notational Conventions and Generic Grammar + +2.1 Augmented BNF + + All of the mechanisms specified in this document are described in + both prose and an augmented Backus-Naur Form (BNF) similar to that + used by RFC 822 [9]. Implementors will need to be familiar with the + notation in order to understand this specification. The augmented BNF + includes the following constructs: + + name = definition + The name of a rule is simply the name itself (without any + enclosing "<" and ">") and is separated from its definition by the + equal "=" character. White space is only significant in that + indentation of continuation lines is used to indicate a rule + definition that spans more than one line. Certain basic rules are + in uppercase, such as SP, LWS, HT, CRLF, DIGIT, ALPHA, etc. Angle + brackets are used within definitions whenever their presence will + facilitate discerning the use of rule names. + + "literal" + Quotation marks surround literal text. Unless stated otherwise, + the text is case-insensitive. + + rule1 | rule2 + Elements separated by a bar ("|") are alternatives, e.g., "yes | + no" will accept yes or no. + + (rule1 rule2) + Elements enclosed in parentheses are treated as a single element. + Thus, "(elem (foo | bar) elem)" allows the token sequences "elem + foo elem" and "elem bar elem". + + *rule + The character "*" preceding an element indicates repetition. The + full form is "*element" indicating at least and at most + occurrences of element. Default values are 0 and infinity so + that "*(element)" allows any number, including zero; "1*element" + requires at least one; and "1*2element" allows one or two. + + [rule] + Square brackets enclose optional elements; "[foo bar]" is + equivalent to "*1(foo bar)". + + + +Fielding, et al. Standards Track [Page 14] + +RFC 2616 HTTP/1.1 June 1999 + + + N rule + Specific repetition: "(element)" is equivalent to + "*(element)"; that is, exactly occurrences of (element). + Thus 2DIGIT is a 2-digit number, and 3ALPHA is a string of three + alphabetic characters. + + #rule + A construct "#" is defined, similar to "*", for defining lists of + elements. The full form is "#element" indicating at least + and at most elements, each separated by one or more commas + (",") and OPTIONAL linear white space (LWS). This makes the usual + form of lists very easy; a rule such as + ( *LWS element *( *LWS "," *LWS element )) + can be shown as + 1#element + Wherever this construct is used, null elements are allowed, but do + not contribute to the count of elements present. That is, + "(element), , (element) " is permitted, but counts as only two + elements. Therefore, where at least one element is required, at + least one non-null element MUST be present. Default values are 0 + and infinity so that "#element" allows any number, including zero; + "1#element" requires at least one; and "1#2element" allows one or + two. + + ; comment + A semi-colon, set off some distance to the right of rule text, + starts a comment that continues to the end of line. This is a + simple way of including useful notes in parallel with the + specifications. + + implied *LWS + The grammar described by this specification is word-based. Except + where noted otherwise, linear white space (LWS) can be included + between any two adjacent words (token or quoted-string), and + between adjacent words and separators, without changing the + interpretation of a field. At least one delimiter (LWS and/or + + separators) MUST exist between any two tokens (for the definition + of "token" below), since they would otherwise be interpreted as a + single token. + +2.2 Basic Rules + + The following rules are used throughout this specification to + describe basic parsing constructs. The US-ASCII coded character set + is defined by ANSI X3.4-1986 [21]. + + + + + +Fielding, et al. Standards Track [Page 15] + +RFC 2616 HTTP/1.1 June 1999 + + + OCTET = + CHAR = + UPALPHA = + LOALPHA = + ALPHA = UPALPHA | LOALPHA + DIGIT = + CTL = + CR = + LF = + SP = + HT = + <"> = + + HTTP/1.1 defines the sequence CR LF as the end-of-line marker for all + protocol elements except the entity-body (see appendix 19.3 for + tolerant applications). The end-of-line marker within an entity-body + is defined by its associated media type, as described in section 3.7. + + CRLF = CR LF + + HTTP/1.1 header field values can be folded onto multiple lines if the + continuation line begins with a space or horizontal tab. All linear + white space, including folding, has the same semantics as SP. A + recipient MAY replace any linear white space with a single SP before + interpreting the field value or forwarding the message downstream. + + LWS = [CRLF] 1*( SP | HT ) + + The TEXT rule is only used for descriptive field contents and values + that are not intended to be interpreted by the message parser. Words + of *TEXT MAY contain characters from character sets other than ISO- + 8859-1 [22] only when encoded according to the rules of RFC 2047 + [14]. + + TEXT = + + A CRLF is allowed in the definition of TEXT only as part of a header + field continuation. It is expected that the folding LWS will be + replaced with a single SP before interpretation of the TEXT value. + + Hexadecimal numeric characters are used in several protocol elements. + + HEX = "A" | "B" | "C" | "D" | "E" | "F" + | "a" | "b" | "c" | "d" | "e" | "f" | DIGIT + + + + + +Fielding, et al. Standards Track [Page 16] + +RFC 2616 HTTP/1.1 June 1999 + + + Many HTTP/1.1 header field values consist of words separated by LWS + or special characters. These special characters MUST be in a quoted + string to be used within a parameter value (as defined in section + 3.6). + + token = 1* + separators = "(" | ")" | "<" | ">" | "@" + | "," | ";" | ":" | "\" | <"> + | "/" | "[" | "]" | "?" | "=" + | "{" | "}" | SP | HT + + Comments can be included in some HTTP header fields by surrounding + the comment text with parentheses. Comments are only allowed in + fields containing "comment" as part of their field value definition. + In all other fields, parentheses are considered part of the field + value. + + comment = "(" *( ctext | quoted-pair | comment ) ")" + ctext = + + A string of text is parsed as a single word if it is quoted using + double-quote marks. + + quoted-string = ( <"> *(qdtext | quoted-pair ) <"> ) + qdtext = > + + The backslash character ("\") MAY be used as a single-character + quoting mechanism only within quoted-string and comment constructs. + + quoted-pair = "\" CHAR + +3 Protocol Parameters + +3.1 HTTP Version + + HTTP uses a "." numbering scheme to indicate versions + of the protocol. The protocol versioning policy is intended to allow + the sender to indicate the format of a message and its capacity for + understanding further HTTP communication, rather than the features + obtained via that communication. No change is made to the version + number for the addition of message components which do not affect + communication behavior or which only add to extensible field values. + The number is incremented when the changes made to the + protocol add features which do not change the general message parsing + algorithm, but which may add to the message semantics and imply + additional capabilities of the sender. The number is + incremented when the format of a message within the protocol is + changed. See RFC 2145 [36] for a fuller explanation. + + + +Fielding, et al. Standards Track [Page 17] + +RFC 2616 HTTP/1.1 June 1999 + + + The version of an HTTP message is indicated by an HTTP-Version field + in the first line of the message. + + HTTP-Version = "HTTP" "/" 1*DIGIT "." 1*DIGIT + + Note that the major and minor numbers MUST be treated as separate + integers and that each MAY be incremented higher than a single digit. + Thus, HTTP/2.4 is a lower version than HTTP/2.13, which in turn is + lower than HTTP/12.3. Leading zeros MUST be ignored by recipients and + MUST NOT be sent. + + An application that sends a request or response message that includes + HTTP-Version of "HTTP/1.1" MUST be at least conditionally compliant + with this specification. Applications that are at least conditionally + compliant with this specification SHOULD use an HTTP-Version of + "HTTP/1.1" in their messages, and MUST do so for any message that is + not compatible with HTTP/1.0. For more details on when to send + specific HTTP-Version values, see RFC 2145 [36]. + + The HTTP version of an application is the highest HTTP version for + which the application is at least conditionally compliant. + + Proxy and gateway applications need to be careful when forwarding + messages in protocol versions different from that of the application. + Since the protocol version indicates the protocol capability of the + sender, a proxy/gateway MUST NOT send a message with a version + indicator which is greater than its actual version. If a higher + version request is received, the proxy/gateway MUST either downgrade + the request version, or respond with an error, or switch to tunnel + behavior. + + Due to interoperability problems with HTTP/1.0 proxies discovered + since the publication of RFC 2068[33], caching proxies MUST, gateways + MAY, and tunnels MUST NOT upgrade the request to the highest version + they support. The proxy/gateway's response to that request MUST be in + the same major version as the request. + + Note: Converting between versions of HTTP may involve modification + of header fields required or forbidden by the versions involved. + +3.2 Uniform Resource Identifiers + + URIs have been known by many names: WWW addresses, Universal Document + Identifiers, Universal Resource Identifiers [3], and finally the + combination of Uniform Resource Locators (URL) [4] and Names (URN) + [20]. As far as HTTP is concerned, Uniform Resource Identifiers are + simply formatted strings which identify--via name, location, or any + other characteristic--a resource. + + + +Fielding, et al. Standards Track [Page 18] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.1 General Syntax + + URIs in HTTP can be represented in absolute form or relative to some + known base URI [11], depending upon the context of their use. The two + forms are differentiated by the fact that absolute URIs always begin + with a scheme name followed by a colon. For definitive information on + URL syntax and semantics, see "Uniform Resource Identifiers (URI): + Generic Syntax and Semantics," RFC 2396 [42] (which replaces RFCs + 1738 [4] and RFC 1808 [11]). This specification adopts the + definitions of "URI-reference", "absoluteURI", "relativeURI", "port", + "host","abs_path", "rel_path", and "authority" from that + specification. + + The HTTP protocol does not place any a priori limit on the length of + a URI. Servers MUST be able to handle the URI of any resource they + serve, and SHOULD be able to handle URIs of unbounded length if they + provide GET-based forms that could generate such URIs. A server + SHOULD return 414 (Request-URI Too Long) status if a URI is longer + than the server can handle (see section 10.4.15). + + Note: Servers ought to be cautious about depending on URI lengths + above 255 bytes, because some older client or proxy + implementations might not properly support these lengths. + +3.2.2 http URL + + The "http" scheme is used to locate network resources via the HTTP + protocol. This section defines the scheme-specific syntax and + semantics for http URLs. + + http_URL = "http:" "//" host [ ":" port ] [ abs_path [ "?" query ]] + + If the port is empty or not given, port 80 is assumed. The semantics + are that the identified resource is located at the server listening + for TCP connections on that port of that host, and the Request-URI + for the resource is abs_path (section 5.1.2). The use of IP addresses + in URLs SHOULD be avoided whenever possible (see RFC 1900 [24]). If + the abs_path is not present in the URL, it MUST be given as "/" when + used as a Request-URI for a resource (section 5.1.2). If a proxy + receives a host name which is not a fully qualified domain name, it + MAY add its domain to the host name it received. If a proxy receives + a fully qualified domain name, the proxy MUST NOT change the host + name. + + + + + + + + +Fielding, et al. Standards Track [Page 19] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.3 URI Comparison + + When comparing two URIs to decide if they match or not, a client + SHOULD use a case-sensitive octet-by-octet comparison of the entire + URIs, with these exceptions: + + - A port that is empty or not given is equivalent to the default + port for that URI-reference; + + - Comparisons of host names MUST be case-insensitive; + + - Comparisons of scheme names MUST be case-insensitive; + + - An empty abs_path is equivalent to an abs_path of "/". + + Characters other than those in the "reserved" and "unsafe" sets (see + RFC 2396 [42]) are equivalent to their ""%" HEX HEX" encoding. + + For example, the following three URIs are equivalent: + + http://abc.com:80/~smith/home.html + http://ABC.com/%7Esmith/home.html + http://ABC.com:/%7esmith/home.html + +3.3 Date/Time Formats + +3.3.1 Full Date + + HTTP applications have historically allowed three different formats + for the representation of date/time stamps: + + Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123 + Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036 + Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format + + The first format is preferred as an Internet standard and represents + a fixed-length subset of that defined by RFC 1123 [8] (an update to + RFC 822 [9]). The second format is in common use, but is based on the + obsolete RFC 850 [12] date format and lacks a four-digit year. + HTTP/1.1 clients and servers that parse the date value MUST accept + all three formats (for compatibility with HTTP/1.0), though they MUST + only generate the RFC 1123 format for representing HTTP-date values + in header fields. See section 19.3 for further information. + + Note: Recipients of date values are encouraged to be robust in + accepting date values that may have been sent by non-HTTP + applications, as is sometimes the case when retrieving or posting + messages via proxies/gateways to SMTP or NNTP. + + + +Fielding, et al. Standards Track [Page 20] + +RFC 2616 HTTP/1.1 June 1999 + + + All HTTP date/time stamps MUST be represented in Greenwich Mean Time + (GMT), without exception. For the purposes of HTTP, GMT is exactly + equal to UTC (Coordinated Universal Time). This is indicated in the + first two formats by the inclusion of "GMT" as the three-letter + abbreviation for time zone, and MUST be assumed when reading the + asctime format. HTTP-date is case sensitive and MUST NOT include + additional LWS beyond that specifically included as SP in the + grammar. + + HTTP-date = rfc1123-date | rfc850-date | asctime-date + rfc1123-date = wkday "," SP date1 SP time SP "GMT" + rfc850-date = weekday "," SP date2 SP time SP "GMT" + asctime-date = wkday SP date3 SP time SP 4DIGIT + date1 = 2DIGIT SP month SP 4DIGIT + ; day month year (e.g., 02 Jun 1982) + date2 = 2DIGIT "-" month "-" 2DIGIT + ; day-month-year (e.g., 02-Jun-82) + date3 = month SP ( 2DIGIT | ( SP 1DIGIT )) + ; month day (e.g., Jun 2) + time = 2DIGIT ":" 2DIGIT ":" 2DIGIT + ; 00:00:00 - 23:59:59 + wkday = "Mon" | "Tue" | "Wed" + | "Thu" | "Fri" | "Sat" | "Sun" + weekday = "Monday" | "Tuesday" | "Wednesday" + | "Thursday" | "Friday" | "Saturday" | "Sunday" + month = "Jan" | "Feb" | "Mar" | "Apr" + | "May" | "Jun" | "Jul" | "Aug" + | "Sep" | "Oct" | "Nov" | "Dec" + + Note: HTTP requirements for the date/time stamp format apply only + to their usage within the protocol stream. Clients and servers are + not required to use these formats for user presentation, request + logging, etc. + +3.3.2 Delta Seconds + + Some HTTP header fields allow a time value to be specified as an + integer number of seconds, represented in decimal, after the time + that the message was received. + + delta-seconds = 1*DIGIT + +3.4 Character Sets + + HTTP uses the same definition of the term "character set" as that + described for MIME: + + + + + +Fielding, et al. Standards Track [Page 21] + +RFC 2616 HTTP/1.1 June 1999 + + + The term "character set" is used in this document to refer to a + method used with one or more tables to convert a sequence of octets + into a sequence of characters. Note that unconditional conversion in + the other direction is not required, in that not all characters may + be available in a given character set and a character set may provide + more than one sequence of octets to represent a particular character. + This definition is intended to allow various kinds of character + encoding, from simple single-table mappings such as US-ASCII to + complex table switching methods such as those that use ISO-2022's + techniques. However, the definition associated with a MIME character + set name MUST fully specify the mapping to be performed from octets + to characters. In particular, use of external profiling information + to determine the exact mapping is not permitted. + + Note: This use of the term "character set" is more commonly + referred to as a "character encoding." However, since HTTP and + MIME share the same registry, it is important that the terminology + also be shared. + + HTTP character sets are identified by case-insensitive tokens. The + complete set of tokens is defined by the IANA Character Set registry + [19]. + + charset = token + + Although HTTP allows an arbitrary token to be used as a charset + value, any token that has a predefined value within the IANA + Character Set registry [19] MUST represent the character set defined + by that registry. Applications SHOULD limit their use of character + sets to those defined by the IANA registry. + + Implementors should be aware of IETF character set requirements [38] + [41]. + +3.4.1 Missing Charset + + Some HTTP/1.0 software has interpreted a Content-Type header without + charset parameter incorrectly to mean "recipient should guess." + Senders wishing to defeat this behavior MAY include a charset + parameter even when the charset is ISO-8859-1 and SHOULD do so when + it is known that it will not confuse the recipient. + + Unfortunately, some older HTTP/1.0 clients did not deal properly with + an explicit charset parameter. HTTP/1.1 recipients MUST respect the + charset label provided by the sender; and those user agents that have + a provision to "guess" a charset MUST use the charset from the + + + + + +Fielding, et al. Standards Track [Page 22] + +RFC 2616 HTTP/1.1 June 1999 + + + content-type field if they support that charset, rather than the + recipient's preference, when initially displaying a document. See + section 3.7.1. + +3.5 Content Codings + + Content coding values indicate an encoding transformation that has + been or can be applied to an entity. Content codings are primarily + used to allow a document to be compressed or otherwise usefully + transformed without losing the identity of its underlying media type + and without loss of information. Frequently, the entity is stored in + coded form, transmitted directly, and only decoded by the recipient. + + content-coding = token + + All content-coding values are case-insensitive. HTTP/1.1 uses + content-coding values in the Accept-Encoding (section 14.3) and + Content-Encoding (section 14.11) header fields. Although the value + describes the content-coding, what is more important is that it + indicates what decoding mechanism will be required to remove the + encoding. + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + content-coding value tokens. Initially, the registry contains the + following tokens: + + gzip An encoding format produced by the file compression program + "gzip" (GNU zip) as described in RFC 1952 [25]. This format is a + Lempel-Ziv coding (LZ77) with a 32 bit CRC. + + compress + The encoding format produced by the common UNIX file compression + program "compress". This format is an adaptive Lempel-Ziv-Welch + coding (LZW). + + Use of program names for the identification of encoding formats + is not desirable and is discouraged for future encodings. Their + use here is representative of historical practice, not good + design. For compatibility with previous implementations of HTTP, + applications SHOULD consider "x-gzip" and "x-compress" to be + equivalent to "gzip" and "compress" respectively. + + deflate + The "zlib" format defined in RFC 1950 [31] in combination with + the "deflate" compression mechanism described in RFC 1951 [29]. + + + + + + +Fielding, et al. Standards Track [Page 23] + +RFC 2616 HTTP/1.1 June 1999 + + + identity + The default (identity) encoding; the use of no transformation + whatsoever. This content-coding is used only in the Accept- + Encoding header, and SHOULD NOT be used in the Content-Encoding + header. + + New content-coding value tokens SHOULD be registered; to allow + interoperability between clients and servers, specifications of the + content coding algorithms needed to implement a new value SHOULD be + publicly available and adequate for independent implementation, and + conform to the purpose of content coding defined in this section. + +3.6 Transfer Codings + + Transfer-coding values are used to indicate an encoding + transformation that has been, can be, or may need to be applied to an + entity-body in order to ensure "safe transport" through the network. + This differs from a content coding in that the transfer-coding is a + property of the message, not of the original entity. + + transfer-coding = "chunked" | transfer-extension + transfer-extension = token *( ";" parameter ) + + Parameters are in the form of attribute/value pairs. + + parameter = attribute "=" value + attribute = token + value = token | quoted-string + + All transfer-coding values are case-insensitive. HTTP/1.1 uses + transfer-coding values in the TE header field (section 14.39) and in + the Transfer-Encoding header field (section 14.41). + + Whenever a transfer-coding is applied to a message-body, the set of + transfer-codings MUST include "chunked", unless the message is + terminated by closing the connection. When the "chunked" transfer- + coding is used, it MUST be the last transfer-coding applied to the + message-body. The "chunked" transfer-coding MUST NOT be applied more + than once to a message-body. These rules allow the recipient to + determine the transfer-length of the message (section 4.4). + + Transfer-codings are analogous to the Content-Transfer-Encoding + values of MIME [7], which were designed to enable safe transport of + binary data over a 7-bit transport service. However, safe transport + has a different focus for an 8bit-clean transfer protocol. In HTTP, + the only unsafe characteristic of message-bodies is the difficulty in + determining the exact body length (section 7.2.2), or the desire to + encrypt data over a shared transport. + + + +Fielding, et al. Standards Track [Page 24] + +RFC 2616 HTTP/1.1 June 1999 + + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + transfer-coding value tokens. Initially, the registry contains the + following tokens: "chunked" (section 3.6.1), "identity" (section + 3.6.2), "gzip" (section 3.5), "compress" (section 3.5), and "deflate" + (section 3.5). + + New transfer-coding value tokens SHOULD be registered in the same way + as new content-coding value tokens (section 3.5). + + A server which receives an entity-body with a transfer-coding it does + not understand SHOULD return 501 (Unimplemented), and close the + connection. A server MUST NOT send transfer-codings to an HTTP/1.0 + client. + +3.6.1 Chunked Transfer Coding + + The chunked encoding modifies the body of a message in order to + transfer it as a series of chunks, each with its own size indicator, + followed by an OPTIONAL trailer containing entity-header fields. This + allows dynamically produced content to be transferred along with the + information necessary for the recipient to verify that it has + received the full message. + + Chunked-Body = *chunk + last-chunk + trailer + CRLF + + chunk = chunk-size [ chunk-extension ] CRLF + chunk-data CRLF + chunk-size = 1*HEX + last-chunk = 1*("0") [ chunk-extension ] CRLF + + chunk-extension= *( ";" chunk-ext-name [ "=" chunk-ext-val ] ) + chunk-ext-name = token + chunk-ext-val = token | quoted-string + chunk-data = chunk-size(OCTET) + trailer = *(entity-header CRLF) + + The chunk-size field is a string of hex digits indicating the size of + the chunk. The chunked encoding is ended by any chunk whose size is + zero, followed by the trailer, which is terminated by an empty line. + + The trailer allows the sender to include additional HTTP header + fields at the end of the message. The Trailer header field can be + used to indicate which header fields are included in a trailer (see + section 14.40). + + + + +Fielding, et al. Standards Track [Page 25] + +RFC 2616 HTTP/1.1 June 1999 + + + A server using chunked transfer-coding in a response MUST NOT use the + trailer for any header fields unless at least one of the following is + true: + + a)the request included a TE header field that indicates "trailers" is + acceptable in the transfer-coding of the response, as described in + section 14.39; or, + + b)the server is the origin server for the response, the trailer + fields consist entirely of optional metadata, and the recipient + could use the message (in a manner acceptable to the origin server) + without receiving this metadata. In other words, the origin server + is willing to accept the possibility that the trailer fields might + be silently discarded along the path to the client. + + This requirement prevents an interoperability failure when the + message is being received by an HTTP/1.1 (or later) proxy and + forwarded to an HTTP/1.0 recipient. It avoids a situation where + compliance with the protocol would have necessitated a possibly + infinite buffer on the proxy. + + An example process for decoding a Chunked-Body is presented in + appendix 19.4.6. + + All HTTP/1.1 applications MUST be able to receive and decode the + "chunked" transfer-coding, and MUST ignore chunk-extension extensions + they do not understand. + +3.7 Media Types + + HTTP uses Internet Media Types [17] in the Content-Type (section + 14.17) and Accept (section 14.1) header fields in order to provide + open and extensible data typing and type negotiation. + + media-type = type "/" subtype *( ";" parameter ) + type = token + subtype = token + + Parameters MAY follow the type/subtype in the form of attribute/value + pairs (as defined in section 3.6). + + The type, subtype, and parameter attribute names are case- + insensitive. Parameter values might or might not be case-sensitive, + depending on the semantics of the parameter name. Linear white space + (LWS) MUST NOT be used between the type and subtype, nor between an + attribute and its value. The presence or absence of a parameter might + be significant to the processing of a media-type, depending on its + definition within the media type registry. + + + +Fielding, et al. Standards Track [Page 26] + +RFC 2616 HTTP/1.1 June 1999 + + + Note that some older HTTP applications do not recognize media type + parameters. When sending data to older HTTP applications, + implementations SHOULD only use media type parameters when they are + required by that type/subtype definition. + + Media-type values are registered with the Internet Assigned Number + Authority (IANA [19]). The media type registration process is + outlined in RFC 1590 [17]. Use of non-registered media types is + discouraged. + +3.7.1 Canonicalization and Text Defaults + + Internet media types are registered with a canonical form. An + entity-body transferred via HTTP messages MUST be represented in the + appropriate canonical form prior to its transmission except for + "text" types, as defined in the next paragraph. + + When in canonical form, media subtypes of the "text" type use CRLF as + the text line break. HTTP relaxes this requirement and allows the + transport of text media with plain CR or LF alone representing a line + break when it is done consistently for an entire entity-body. HTTP + applications MUST accept CRLF, bare CR, and bare LF as being + representative of a line break in text media received via HTTP. In + addition, if the text is represented in a character set that does not + use octets 13 and 10 for CR and LF respectively, as is the case for + some multi-byte character sets, HTTP allows the use of whatever octet + sequences are defined by that character set to represent the + equivalent of CR and LF for line breaks. This flexibility regarding + line breaks applies only to text media in the entity-body; a bare CR + or LF MUST NOT be substituted for CRLF within any of the HTTP control + structures (such as header fields and multipart boundaries). + + If an entity-body is encoded with a content-coding, the underlying + data MUST be in a form defined above prior to being encoded. + + The "charset" parameter is used with some media types to define the + character set (section 3.4) of the data. When no explicit charset + parameter is provided by the sender, media subtypes of the "text" + type are defined to have a default charset value of "ISO-8859-1" when + received via HTTP. Data in character sets other than "ISO-8859-1" or + its subsets MUST be labeled with an appropriate charset value. See + section 3.4.1 for compatibility problems. + +3.7.2 Multipart Types + + MIME provides for a number of "multipart" types -- encapsulations of + one or more entities within a single message-body. All multipart + types share a common syntax, as defined in section 5.1.1 of RFC 2046 + + + +Fielding, et al. Standards Track [Page 27] + +RFC 2616 HTTP/1.1 June 1999 + + + [40], and MUST include a boundary parameter as part of the media type + value. The message body is itself a protocol element and MUST + therefore use only CRLF to represent line breaks between body-parts. + Unlike in RFC 2046, the epilogue of any multipart message MUST be + empty; HTTP applications MUST NOT transmit the epilogue (even if the + original multipart contains an epilogue). These restrictions exist in + order to preserve the self-delimiting nature of a multipart message- + body, wherein the "end" of the message-body is indicated by the + ending multipart boundary. + + In general, HTTP treats a multipart message-body no differently than + any other media type: strictly as payload. The one exception is the + "multipart/byteranges" type (appendix 19.2) when it appears in a 206 + (Partial Content) response, which will be interpreted by some HTTP + caching mechanisms as described in sections 13.5.4 and 14.16. In all + other cases, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + The MIME header fields within each body-part of a multipart message- + body do not have any significance to HTTP beyond that defined by + their MIME semantics. + + In general, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + If an application receives an unrecognized multipart subtype, the + application MUST treat it as being equivalent to "multipart/mixed". + + Note: The "multipart/form-data" type has been specifically defined + for carrying form data suitable for processing via the POST + request method, as described in RFC 1867 [15]. + +3.8 Product Tokens + + Product tokens are used to allow communicating applications to + identify themselves by software name and version. Most fields using + product tokens also allow sub-products which form a significant part + of the application to be listed, separated by white space. By + convention, the products are listed in order of their significance + for identifying the application. + + product = token ["/" product-version] + product-version = token + + Examples: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + Server: Apache/0.8.4 + + + + + +Fielding, et al. Standards Track [Page 28] + +RFC 2616 HTTP/1.1 June 1999 + + + Product tokens SHOULD be short and to the point. They MUST NOT be + used for advertising or other non-essential information. Although any + token character MAY appear in a product-version, this token SHOULD + only be used for a version identifier (i.e., successive versions of + the same product SHOULD only differ in the product-version portion of + the product value). + +3.9 Quality Values + + HTTP content negotiation (section 12) uses short "floating point" + numbers to indicate the relative importance ("weight") of various + negotiable parameters. A weight is normalized to a real number in + the range 0 through 1, where 0 is the minimum and 1 the maximum + value. If a parameter has a quality value of 0, then content with + this parameter is `not acceptable' for the client. HTTP/1.1 + applications MUST NOT generate more than three digits after the + decimal point. User configuration of these values SHOULD also be + limited in this fashion. + + qvalue = ( "0" [ "." 0*3DIGIT ] ) + | ( "1" [ "." 0*3("0") ] ) + + "Quality values" is a misnomer, since these values merely represent + relative degradation in desired quality. + +3.10 Language Tags + + A language tag identifies a natural language spoken, written, or + otherwise conveyed by human beings for communication of information + to other human beings. Computer languages are explicitly excluded. + HTTP uses language tags within the Accept-Language and Content- + Language fields. + + The syntax and registry of HTTP language tags is the same as that + defined by RFC 1766 [1]. In summary, a language tag is composed of 1 + or more parts: A primary language tag and a possibly empty series of + subtags: + + language-tag = primary-tag *( "-" subtag ) + primary-tag = 1*8ALPHA + subtag = 1*8ALPHA + + White space is not allowed within the tag and all tags are case- + insensitive. The name space of language tags is administered by the + IANA. Example tags include: + + en, en-US, en-cockney, i-cherokee, x-pig-latin + + + + +Fielding, et al. Standards Track [Page 29] + +RFC 2616 HTTP/1.1 June 1999 + + + where any two-letter primary-tag is an ISO-639 language abbreviation + and any two-letter initial subtag is an ISO-3166 country code. (The + last three tags above are not registered tags; all but the last are + examples of tags which could be registered in future.) + +3.11 Entity Tags + + Entity tags are used for comparing two or more entities from the same + requested resource. HTTP/1.1 uses entity tags in the ETag (section + 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and + If-Range (section 14.27) header fields. The definition of how they + are used and compared as cache validators is in section 13.3.3. An + entity tag consists of an opaque quoted string, possibly prefixed by + a weakness indicator. + + entity-tag = [ weak ] opaque-tag + weak = "W/" + opaque-tag = quoted-string + + A "strong entity tag" MAY be shared by two entities of a resource + only if they are equivalent by octet equality. + + A "weak entity tag," indicated by the "W/" prefix, MAY be shared by + two entities of a resource only if the entities are equivalent and + could be substituted for each other with no significant change in + semantics. A weak entity tag can only be used for weak comparison. + + An entity tag MUST be unique across all versions of all entities + associated with a particular resource. A given entity tag value MAY + be used for entities obtained by requests on different URIs. The use + of the same entity tag value in conjunction with entities obtained by + requests on different URIs does not imply the equivalence of those + entities. + +3.12 Range Units + + HTTP/1.1 allows a client to request that only part (a range of) the + response entity be included within the response. HTTP/1.1 uses range + units in the Range (section 14.35) and Content-Range (section 14.16) + header fields. An entity can be broken down into subranges according + to various structural units. + + range-unit = bytes-unit | other-range-unit + bytes-unit = "bytes" + other-range-unit = token + + The only range unit defined by HTTP/1.1 is "bytes". HTTP/1.1 + implementations MAY ignore ranges specified using other units. + + + +Fielding, et al. Standards Track [Page 30] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 has been designed to allow implementations of applications + that do not depend on knowledge of ranges. + +4 HTTP Message + +4.1 Message Types + + HTTP messages consist of requests from client to server and responses + from server to client. + + HTTP-message = Request | Response ; HTTP/1.1 messages + + Request (section 5) and Response (section 6) messages use the generic + message format of RFC 822 [9] for transferring entities (the payload + of the message). Both types of message consist of a start-line, zero + or more header fields (also known as "headers"), an empty line (i.e., + a line with nothing preceding the CRLF) indicating the end of the + header fields, and possibly a message-body. + + generic-message = start-line + *(message-header CRLF) + CRLF + [ message-body ] + start-line = Request-Line | Status-Line + + In the interest of robustness, servers SHOULD ignore any empty + line(s) received where a Request-Line is expected. In other words, if + the server is reading the protocol stream at the beginning of a + message and receives a CRLF first, it should ignore the CRLF. + + Certain buggy HTTP/1.0 client implementations generate extra CRLF's + after a POST request. To restate what is explicitly forbidden by the + BNF, an HTTP/1.1 client MUST NOT preface or follow a request with an + extra CRLF. + +4.2 Message Headers + + HTTP header fields, which include general-header (section 4.5), + request-header (section 5.3), response-header (section 6.2), and + entity-header (section 7.1) fields, follow the same generic format as + that given in Section 3.1 of RFC 822 [9]. Each header field consists + of a name followed by a colon (":") and the field value. Field names + are case-insensitive. The field value MAY be preceded by any amount + of LWS, though a single SP is preferred. Header fields can be + extended over multiple lines by preceding each extra line with at + least one SP or HT. Applications ought to follow "common form", where + one is known or indicated, when generating HTTP constructs, since + there might exist some implementations that fail to accept anything + + + +Fielding, et al. Standards Track [Page 31] + +RFC 2616 HTTP/1.1 June 1999 + + + beyond the common forms. + + message-header = field-name ":" [ field-value ] + field-name = token + field-value = *( field-content | LWS ) + field-content = + + The field-content does not include any leading or trailing LWS: + linear white space occurring before the first non-whitespace + character of the field-value or after the last non-whitespace + character of the field-value. Such leading or trailing LWS MAY be + removed without changing the semantics of the field value. Any LWS + that occurs between field-content MAY be replaced with a single SP + before interpreting the field value or forwarding the message + downstream. + + The order in which header fields with differing field names are + received is not significant. However, it is "good practice" to send + general-header fields first, followed by request-header or response- + header fields, and ending with the entity-header fields. + + Multiple message-header fields with the same field-name MAY be + present in a message if and only if the entire field-value for that + header field is defined as a comma-separated list [i.e., #(values)]. + It MUST be possible to combine the multiple header fields into one + "field-name: field-value" pair, without changing the semantics of the + message, by appending each subsequent field-value to the first, each + separated by a comma. The order in which header fields with the same + field-name are received is therefore significant to the + interpretation of the combined field value, and thus a proxy MUST NOT + change the order of these field values when a message is forwarded. + +4.3 Message Body + + The message-body (if any) of an HTTP message is used to carry the + entity-body associated with the request or response. The message-body + differs from the entity-body only when a transfer-coding has been + applied, as indicated by the Transfer-Encoding header field (section + 14.41). + + message-body = entity-body + | + + Transfer-Encoding MUST be used to indicate any transfer-codings + applied by an application to ensure safe and proper transfer of the + message. Transfer-Encoding is a property of the message, not of the + + + +Fielding, et al. Standards Track [Page 32] + +RFC 2616 HTTP/1.1 June 1999 + + + entity, and thus MAY be added or removed by any application along the + request/response chain. (However, section 3.6 places restrictions on + when certain transfer-codings may be used.) + + The rules for when a message-body is allowed in a message differ for + requests and responses. + + The presence of a message-body in a request is signaled by the + inclusion of a Content-Length or Transfer-Encoding header field in + the request's message-headers. A message-body MUST NOT be included in + a request if the specification of the request method (section 5.1.1) + does not allow sending an entity-body in requests. A server SHOULD + read and forward a message-body on any request; if the request method + does not include defined semantics for an entity-body, then the + message-body SHOULD be ignored when handling the request. + + For response messages, whether or not a message-body is included with + a message is dependent on both the request method and the response + status code (section 6.1.1). All responses to the HEAD request method + MUST NOT include a message-body, even though the presence of entity- + header fields might lead one to believe they do. All 1xx + (informational), 204 (no content), and 304 (not modified) responses + MUST NOT include a message-body. All other responses do include a + message-body, although it MAY be of zero length. + +4.4 Message Length + + The transfer-length of a message is the length of the message-body as + it appears in the message; that is, after any transfer-codings have + been applied. When a message-body is included with a message, the + transfer-length of that body is determined by one of the following + (in order of precedence): + + 1.Any response message which "MUST NOT" include a message-body (such + as the 1xx, 204, and 304 responses and any response to a HEAD + request) is always terminated by the first empty line after the + header fields, regardless of the entity-header fields present in + the message. + + 2.If a Transfer-Encoding header field (section 14.41) is present and + has any value other than "identity", then the transfer-length is + defined by use of the "chunked" transfer-coding (section 3.6), + unless the message is terminated by closing the connection. + + 3.If a Content-Length header field (section 14.13) is present, its + decimal value in OCTETs represents both the entity-length and the + transfer-length. The Content-Length header field MUST NOT be sent + if these two lengths are different (i.e., if a Transfer-Encoding + + + +Fielding, et al. Standards Track [Page 33] + +RFC 2616 HTTP/1.1 June 1999 + + + header field is present). If a message is received with both a + Transfer-Encoding header field and a Content-Length header field, + the latter MUST be ignored. + + 4.If the message uses the media type "multipart/byteranges", and the + ransfer-length is not otherwise specified, then this self- + elimiting media type defines the transfer-length. This media type + UST NOT be used unless the sender knows that the recipient can arse + it; the presence in a request of a Range header with ultiple byte- + range specifiers from a 1.1 client implies that the lient can parse + multipart/byteranges responses. + + A range header might be forwarded by a 1.0 proxy that does not + understand multipart/byteranges; in this case the server MUST + delimit the message using methods defined in items 1,3 or 5 of + this section. + + 5.By the server closing the connection. (Closing the connection + cannot be used to indicate the end of a request body, since that + would leave no possibility for the server to send back a response.) + + For compatibility with HTTP/1.0 applications, HTTP/1.1 requests + containing a message-body MUST include a valid Content-Length header + field unless the server is known to be HTTP/1.1 compliant. If a + request contains a message-body and a Content-Length is not given, + the server SHOULD respond with 400 (bad request) if it cannot + determine the length of the message, or with 411 (length required) if + it wishes to insist on receiving a valid Content-Length. + + All HTTP/1.1 applications that receive entities MUST accept the + "chunked" transfer-coding (section 3.6), thus allowing this mechanism + to be used for messages when the message length cannot be determined + in advance. + + Messages MUST NOT include both a Content-Length header field and a + non-identity transfer-coding. If the message does include a non- + identity transfer-coding, the Content-Length MUST be ignored. + + When a Content-Length is given in a message where a message-body is + allowed, its field value MUST exactly match the number of OCTETs in + the message-body. HTTP/1.1 user agents MUST notify the user when an + invalid length is received and detected. + +4.5 General Header Fields + + There are a few header fields which have general applicability for + both request and response messages, but which do not apply to the + entity being transferred. These header fields apply only to the + + + +Fielding, et al. Standards Track [Page 34] + +RFC 2616 HTTP/1.1 June 1999 + + + message being transmitted. + + general-header = Cache-Control ; Section 14.9 + | Connection ; Section 14.10 + | Date ; Section 14.18 + | Pragma ; Section 14.32 + | Trailer ; Section 14.40 + | Transfer-Encoding ; Section 14.41 + | Upgrade ; Section 14.42 + | Via ; Section 14.45 + | Warning ; Section 14.46 + + General-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields may be given the semantics of general + header fields if all parties in the communication recognize them to + be general-header fields. Unrecognized header fields are treated as + entity-header fields. + +5 Request + + A request message from a client to a server includes, within the + first line of that message, the method to be applied to the resource, + the identifier of the resource, and the protocol version in use. + + Request = Request-Line ; Section 5.1 + *(( general-header ; Section 4.5 + | request-header ; Section 5.3 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 4.3 + +5.1 Request-Line + + The Request-Line begins with a method token, followed by the + Request-URI and the protocol version, and ending with CRLF. The + elements are separated by SP characters. No CR or LF is allowed + except in the final CRLF sequence. + + Request-Line = Method SP Request-URI SP HTTP-Version CRLF + + + + + + + + + + + +Fielding, et al. Standards Track [Page 35] + +RFC 2616 HTTP/1.1 June 1999 + + +5.1.1 Method + + The Method token indicates the method to be performed on the + resource identified by the Request-URI. The method is case-sensitive. + + Method = "OPTIONS" ; Section 9.2 + | "GET" ; Section 9.3 + | "HEAD" ; Section 9.4 + | "POST" ; Section 9.5 + | "PUT" ; Section 9.6 + | "DELETE" ; Section 9.7 + | "TRACE" ; Section 9.8 + | "CONNECT" ; Section 9.9 + | extension-method + extension-method = token + + The list of methods allowed by a resource can be specified in an + Allow header field (section 14.7). The return code of the response + always notifies the client whether a method is currently allowed on a + resource, since the set of allowed methods can change dynamically. An + origin server SHOULD return the status code 405 (Method Not Allowed) + if the method is known by the origin server but not allowed for the + requested resource, and 501 (Not Implemented) if the method is + unrecognized or not implemented by the origin server. The methods GET + and HEAD MUST be supported by all general-purpose servers. All other + methods are OPTIONAL; however, if the above methods are implemented, + they MUST be implemented with the same semantics as those specified + in section 9. + +5.1.2 Request-URI + + The Request-URI is a Uniform Resource Identifier (section 3.2) and + identifies the resource upon which to apply the request. + + Request-URI = "*" | absoluteURI | abs_path | authority + + The four options for Request-URI are dependent on the nature of the + request. The asterisk "*" means that the request does not apply to a + particular resource, but to the server itself, and is only allowed + when the method used does not necessarily apply to a resource. One + example would be + + OPTIONS * HTTP/1.1 + + The absoluteURI form is REQUIRED when the request is being made to a + proxy. The proxy is requested to forward the request or service it + from a valid cache, and return the response. Note that the proxy MAY + forward the request on to another proxy or directly to the server + + + +Fielding, et al. Standards Track [Page 36] + +RFC 2616 HTTP/1.1 June 1999 + + + specified by the absoluteURI. In order to avoid request loops, a + proxy MUST be able to recognize all of its server names, including + any aliases, local variations, and the numeric IP address. An example + Request-Line would be: + + GET http://www.w3.org/pub/WWW/TheProject.html HTTP/1.1 + + To allow for transition to absoluteURIs in all requests in future + versions of HTTP, all HTTP/1.1 servers MUST accept the absoluteURI + form in requests, even though HTTP/1.1 clients will only generate + them in requests to proxies. + + The authority form is only used by the CONNECT method (section 9.9). + + The most common form of Request-URI is that used to identify a + resource on an origin server or gateway. In this case the absolute + path of the URI MUST be transmitted (see section 3.2.1, abs_path) as + the Request-URI, and the network location of the URI (authority) MUST + be transmitted in a Host header field. For example, a client wishing + to retrieve the resource above directly from the origin server would + create a TCP connection to port 80 of the host "www.w3.org" and send + the lines: + + GET /pub/WWW/TheProject.html HTTP/1.1 + Host: www.w3.org + + followed by the remainder of the Request. Note that the absolute path + cannot be empty; if none is present in the original URI, it MUST be + given as "/" (the server root). + + The Request-URI is transmitted in the format specified in section + 3.2.1. If the Request-URI is encoded using the "% HEX HEX" encoding + [42], the origin server MUST decode the Request-URI in order to + properly interpret the request. Servers SHOULD respond to invalid + Request-URIs with an appropriate status code. + + A transparent proxy MUST NOT rewrite the "abs_path" part of the + received Request-URI when forwarding it to the next inbound server, + except as noted above to replace a null abs_path with "/". + + Note: The "no rewrite" rule prevents the proxy from changing the + meaning of the request when the origin server is improperly using + a non-reserved URI character for a reserved purpose. Implementors + should be aware that some pre-HTTP/1.1 proxies have been known to + rewrite the Request-URI. + + + + + + +Fielding, et al. Standards Track [Page 37] + +RFC 2616 HTTP/1.1 June 1999 + + +5.2 The Resource Identified by a Request + + The exact resource identified by an Internet request is determined by + examining both the Request-URI and the Host header field. + + An origin server that does not allow resources to differ by the + requested host MAY ignore the Host header field value when + determining the resource identified by an HTTP/1.1 request. (But see + section 19.6.1.1 for other requirements on Host support in HTTP/1.1.) + + An origin server that does differentiate resources based on the host + requested (sometimes referred to as virtual hosts or vanity host + names) MUST use the following rules for determining the requested + resource on an HTTP/1.1 request: + + 1. If Request-URI is an absoluteURI, the host is part of the + Request-URI. Any Host header field value in the request MUST be + ignored. + + 2. If the Request-URI is not an absoluteURI, and the request includes + a Host header field, the host is determined by the Host header + field value. + + 3. If the host as determined by rule 1 or 2 is not a valid host on + the server, the response MUST be a 400 (Bad Request) error message. + + Recipients of an HTTP/1.0 request that lacks a Host header field MAY + attempt to use heuristics (e.g., examination of the URI path for + something unique to a particular host) in order to determine what + exact resource is being requested. + +5.3 Request Header Fields + + The request-header fields allow the client to pass additional + information about the request, and about the client itself, to the + server. These fields act as request modifiers, with semantics + equivalent to the parameters on a programming language method + invocation. + + request-header = Accept ; Section 14.1 + | Accept-Charset ; Section 14.2 + | Accept-Encoding ; Section 14.3 + | Accept-Language ; Section 14.4 + | Authorization ; Section 14.8 + | Expect ; Section 14.20 + | From ; Section 14.22 + | Host ; Section 14.23 + | If-Match ; Section 14.24 + + + +Fielding, et al. Standards Track [Page 38] + +RFC 2616 HTTP/1.1 June 1999 + + + | If-Modified-Since ; Section 14.25 + | If-None-Match ; Section 14.26 + | If-Range ; Section 14.27 + | If-Unmodified-Since ; Section 14.28 + | Max-Forwards ; Section 14.31 + | Proxy-Authorization ; Section 14.34 + | Range ; Section 14.35 + | Referer ; Section 14.36 + | TE ; Section 14.39 + | User-Agent ; Section 14.43 + + Request-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of request- + header fields if all parties in the communication recognize them to + be request-header fields. Unrecognized header fields are treated as + entity-header fields. + +6 Response + + After receiving and interpreting a request message, a server responds + with an HTTP response message. + + Response = Status-Line ; Section 6.1 + *(( general-header ; Section 4.5 + | response-header ; Section 6.2 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 7.2 + +6.1 Status-Line + + The first line of a Response message is the Status-Line, consisting + of the protocol version followed by a numeric status code and its + associated textual phrase, with each element separated by SP + characters. No CR or LF is allowed except in the final CRLF sequence. + + Status-Line = HTTP-Version SP Status-Code SP Reason-Phrase CRLF + +6.1.1 Status Code and Reason Phrase + + The Status-Code element is a 3-digit integer result code of the + attempt to understand and satisfy the request. These codes are fully + defined in section 10. The Reason-Phrase is intended to give a short + textual description of the Status-Code. The Status-Code is intended + for use by automata and the Reason-Phrase is intended for the human + user. The client is not required to examine or display the Reason- + Phrase. + + + +Fielding, et al. Standards Track [Page 39] + +RFC 2616 HTTP/1.1 June 1999 + + + The first digit of the Status-Code defines the class of response. The + last two digits do not have any categorization role. There are 5 + values for the first digit: + + - 1xx: Informational - Request received, continuing process + + - 2xx: Success - The action was successfully received, + understood, and accepted + + - 3xx: Redirection - Further action must be taken in order to + complete the request + + - 4xx: Client Error - The request contains bad syntax or cannot + be fulfilled + + - 5xx: Server Error - The server failed to fulfill an apparently + valid request + + The individual values of the numeric status codes defined for + HTTP/1.1, and an example set of corresponding Reason-Phrase's, are + presented below. The reason phrases listed here are only + recommendations -- they MAY be replaced by local equivalents without + affecting the protocol. + + Status-Code = + "100" ; Section 10.1.1: Continue + | "101" ; Section 10.1.2: Switching Protocols + | "200" ; Section 10.2.1: OK + | "201" ; Section 10.2.2: Created + | "202" ; Section 10.2.3: Accepted + | "203" ; Section 10.2.4: Non-Authoritative Information + | "204" ; Section 10.2.5: No Content + | "205" ; Section 10.2.6: Reset Content + | "206" ; Section 10.2.7: Partial Content + | "300" ; Section 10.3.1: Multiple Choices + | "301" ; Section 10.3.2: Moved Permanently + | "302" ; Section 10.3.3: Found + | "303" ; Section 10.3.4: See Other + | "304" ; Section 10.3.5: Not Modified + | "305" ; Section 10.3.6: Use Proxy + | "307" ; Section 10.3.8: Temporary Redirect + | "400" ; Section 10.4.1: Bad Request + | "401" ; Section 10.4.2: Unauthorized + | "402" ; Section 10.4.3: Payment Required + | "403" ; Section 10.4.4: Forbidden + | "404" ; Section 10.4.5: Not Found + | "405" ; Section 10.4.6: Method Not Allowed + | "406" ; Section 10.4.7: Not Acceptable + + + +Fielding, et al. Standards Track [Page 40] + +RFC 2616 HTTP/1.1 June 1999 + + + | "407" ; Section 10.4.8: Proxy Authentication Required + | "408" ; Section 10.4.9: Request Time-out + | "409" ; Section 10.4.10: Conflict + | "410" ; Section 10.4.11: Gone + | "411" ; Section 10.4.12: Length Required + | "412" ; Section 10.4.13: Precondition Failed + | "413" ; Section 10.4.14: Request Entity Too Large + | "414" ; Section 10.4.15: Request-URI Too Large + | "415" ; Section 10.4.16: Unsupported Media Type + | "416" ; Section 10.4.17: Requested range not satisfiable + | "417" ; Section 10.4.18: Expectation Failed + | "500" ; Section 10.5.1: Internal Server Error + | "501" ; Section 10.5.2: Not Implemented + | "502" ; Section 10.5.3: Bad Gateway + | "503" ; Section 10.5.4: Service Unavailable + | "504" ; Section 10.5.5: Gateway Time-out + | "505" ; Section 10.5.6: HTTP Version not supported + | extension-code + + extension-code = 3DIGIT + Reason-Phrase = * + + HTTP status codes are extensible. HTTP applications are not required + to understand the meaning of all registered status codes, though such + understanding is obviously desirable. However, applications MUST + understand the class of any status code, as indicated by the first + digit, and treat any unrecognized response as being equivalent to the + x00 status code of that class, with the exception that an + unrecognized response MUST NOT be cached. For example, if an + unrecognized status code of 431 is received by the client, it can + safely assume that there was something wrong with its request and + treat the response as if it had received a 400 status code. In such + cases, user agents SHOULD present to the user the entity returned + with the response, since that entity is likely to include human- + readable information which will explain the unusual status. + +6.2 Response Header Fields + + The response-header fields allow the server to pass additional + information about the response which cannot be placed in the Status- + Line. These header fields give information about the server and about + further access to the resource identified by the Request-URI. + + response-header = Accept-Ranges ; Section 14.5 + | Age ; Section 14.6 + | ETag ; Section 14.19 + | Location ; Section 14.30 + | Proxy-Authenticate ; Section 14.33 + + + +Fielding, et al. Standards Track [Page 41] + +RFC 2616 HTTP/1.1 June 1999 + + + | Retry-After ; Section 14.37 + | Server ; Section 14.38 + | Vary ; Section 14.44 + | WWW-Authenticate ; Section 14.47 + + Response-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of response- + header fields if all parties in the communication recognize them to + be response-header fields. Unrecognized header fields are treated as + entity-header fields. + +7 Entity + + Request and Response messages MAY transfer an entity if not otherwise + restricted by the request method or response status code. An entity + consists of entity-header fields and an entity-body, although some + responses will only include the entity-headers. + + In this section, both sender and recipient refer to either the client + or the server, depending on who sends and who receives the entity. + +7.1 Entity Header Fields + + Entity-header fields define metainformation about the entity-body or, + if no body is present, about the resource identified by the request. + Some of this metainformation is OPTIONAL; some might be REQUIRED by + portions of this specification. + + entity-header = Allow ; Section 14.7 + | Content-Encoding ; Section 14.11 + | Content-Language ; Section 14.12 + | Content-Length ; Section 14.13 + | Content-Location ; Section 14.14 + | Content-MD5 ; Section 14.15 + | Content-Range ; Section 14.16 + | Content-Type ; Section 14.17 + | Expires ; Section 14.21 + | Last-Modified ; Section 14.29 + | extension-header + + extension-header = message-header + + The extension-header mechanism allows additional entity-header fields + to be defined without changing the protocol, but these fields cannot + be assumed to be recognizable by the recipient. Unrecognized header + fields SHOULD be ignored by the recipient and MUST be forwarded by + transparent proxies. + + + +Fielding, et al. Standards Track [Page 42] + +RFC 2616 HTTP/1.1 June 1999 + + +7.2 Entity Body + + The entity-body (if any) sent with an HTTP request or response is in + a format and encoding defined by the entity-header fields. + + entity-body = *OCTET + + An entity-body is only present in a message when a message-body is + present, as described in section 4.3. The entity-body is obtained + from the message-body by decoding any Transfer-Encoding that might + have been applied to ensure safe and proper transfer of the message. + +7.2.1 Type + + When an entity-body is included with a message, the data type of that + body is determined via the header fields Content-Type and Content- + Encoding. These define a two-layer, ordered encoding model: + + entity-body := Content-Encoding( Content-Type( data ) ) + + Content-Type specifies the media type of the underlying data. + Content-Encoding may be used to indicate any additional content + codings applied to the data, usually for the purpose of data + compression, that are a property of the requested resource. There is + no default encoding. + + Any HTTP/1.1 message containing an entity-body SHOULD include a + Content-Type header field defining the media type of that body. If + and only if the media type is not given by a Content-Type field, the + recipient MAY attempt to guess the media type via inspection of its + content and/or the name extension(s) of the URI used to identify the + resource. If the media type remains unknown, the recipient SHOULD + treat it as type "application/octet-stream". + +7.2.2 Entity Length + + The entity-length of a message is the length of the message-body + before any transfer-codings have been applied. Section 4.4 defines + how the transfer-length of a message-body is determined. + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 43] + +RFC 2616 HTTP/1.1 June 1999 + + +8 Connections + +8.1 Persistent Connections + +8.1.1 Purpose + + Prior to persistent connections, a separate TCP connection was + established to fetch each URL, increasing the load on HTTP servers + and causing congestion on the Internet. The use of inline images and + other associated data often require a client to make multiple + requests of the same server in a short amount of time. Analysis of + these performance problems and results from a prototype + implementation are available [26] [30]. Implementation experience and + measurements of actual HTTP/1.1 (RFC 2068) implementations show good + results [39]. Alternatives have also been explored, for example, + T/TCP [27]. + + Persistent HTTP connections have a number of advantages: + + - By opening and closing fewer TCP connections, CPU time is saved + in routers and hosts (clients, servers, proxies, gateways, + tunnels, or caches), and memory used for TCP protocol control + blocks can be saved in hosts. + + - HTTP requests and responses can be pipelined on a connection. + Pipelining allows a client to make multiple requests without + waiting for each response, allowing a single TCP connection to + be used much more efficiently, with much lower elapsed time. + + - Network congestion is reduced by reducing the number of packets + caused by TCP opens, and by allowing TCP sufficient time to + determine the congestion state of the network. + + - Latency on subsequent requests is reduced since there is no time + spent in TCP's connection opening handshake. + + - HTTP can evolve more gracefully, since errors can be reported + without the penalty of closing the TCP connection. Clients using + future versions of HTTP might optimistically try a new feature, + but if communicating with an older server, retry with old + semantics after an error is reported. + + HTTP implementations SHOULD implement persistent connections. + + + + + + + + +Fielding, et al. Standards Track [Page 44] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2 Overall Operation + + A significant difference between HTTP/1.1 and earlier versions of + HTTP is that persistent connections are the default behavior of any + HTTP connection. That is, unless otherwise indicated, the client + SHOULD assume that the server will maintain a persistent connection, + even after error responses from the server. + + Persistent connections provide a mechanism by which a client and a + server can signal the close of a TCP connection. This signaling takes + place using the Connection header field (section 14.10). Once a close + has been signaled, the client MUST NOT send any more requests on that + connection. + +8.1.2.1 Negotiation + + An HTTP/1.1 server MAY assume that a HTTP/1.1 client intends to + maintain a persistent connection unless a Connection header including + the connection-token "close" was sent in the request. If the server + chooses to close the connection immediately after sending the + response, it SHOULD send a Connection header including the + connection-token close. + + An HTTP/1.1 client MAY expect a connection to remain open, but would + decide to keep it open based on whether the response from a server + contains a Connection header with the connection-token close. In case + the client does not want to maintain a connection for more than that + request, it SHOULD send a Connection header including the + connection-token close. + + If either the client or the server sends the close token in the + Connection header, that request becomes the last one for the + connection. + + Clients and servers SHOULD NOT assume that a persistent connection is + maintained for HTTP versions less than 1.1 unless it is explicitly + signaled. See section 19.6.2 for more information on backward + compatibility with HTTP/1.0 clients. + + In order to remain persistent, all messages on the connection MUST + have a self-defined message length (i.e., one not defined by closure + of the connection), as described in section 4.4. + + + + + + + + + +Fielding, et al. Standards Track [Page 45] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2.2 Pipelining + + A client that supports persistent connections MAY "pipeline" its + requests (i.e., send multiple requests without waiting for each + response). A server MUST send its responses to those requests in the + same order that the requests were received. + + Clients which assume persistent connections and pipeline immediately + after connection establishment SHOULD be prepared to retry their + connection if the first pipelined attempt fails. If a client does + such a retry, it MUST NOT pipeline before it knows the connection is + persistent. Clients MUST also be prepared to resend their requests if + the server closes the connection before sending all of the + corresponding responses. + + Clients SHOULD NOT pipeline requests using non-idempotent methods or + non-idempotent sequences of methods (see section 9.1.2). Otherwise, a + premature termination of the transport connection could lead to + indeterminate results. A client wishing to send a non-idempotent + request SHOULD wait to send that request until it has received the + response status for the previous request. + +8.1.3 Proxy Servers + + It is especially important that proxies correctly implement the + properties of the Connection header field as specified in section + 14.10. + + The proxy server MUST signal persistent connections separately with + its clients and the origin servers (or other proxy servers) that it + connects to. Each persistent connection applies to only one transport + link. + + A proxy server MUST NOT establish a HTTP/1.1 persistent connection + with an HTTP/1.0 client (but see RFC 2068 [33] for information and + discussion of the problems with the Keep-Alive header implemented by + many HTTP/1.0 clients). + +8.1.4 Practical Considerations + + Servers will usually have some time-out value beyond which they will + no longer maintain an inactive connection. Proxy servers might make + this a higher value since it is likely that the client will be making + more connections through the same server. The use of persistent + connections places no requirements on the length (or existence) of + this time-out for either the client or the server. + + + + + +Fielding, et al. Standards Track [Page 46] + +RFC 2616 HTTP/1.1 June 1999 + + + When a client or server wishes to time-out it SHOULD issue a graceful + close on the transport connection. Clients and servers SHOULD both + constantly watch for the other side of the transport close, and + respond to it as appropriate. If a client or server does not detect + the other side's close promptly it could cause unnecessary resource + drain on the network. + + A client, server, or proxy MAY close the transport connection at any + time. For example, a client might have started to send a new request + at the same time that the server has decided to close the "idle" + connection. From the server's point of view, the connection is being + closed while it was idle, but from the client's point of view, a + request is in progress. + + This means that clients, servers, and proxies MUST be able to recover + from asynchronous close events. Client software SHOULD reopen the + transport connection and retransmit the aborted sequence of requests + without user interaction so long as the request sequence is + idempotent (see section 9.1.2). Non-idempotent methods or sequences + MUST NOT be automatically retried, although user agents MAY offer a + human operator the choice of retrying the request(s). Confirmation by + user-agent software with semantic understanding of the application + MAY substitute for user confirmation. The automatic retry SHOULD NOT + be repeated if the second sequence of requests fails. + + Servers SHOULD always respond to at least one request per connection, + if at all possible. Servers SHOULD NOT close a connection in the + middle of transmitting a response, unless a network or client failure + is suspected. + + Clients that use persistent connections SHOULD limit the number of + simultaneous connections that they maintain to a given server. A + single-user client SHOULD NOT maintain more than 2 connections with + any server or proxy. A proxy SHOULD use up to 2*N connections to + another server or proxy, where N is the number of simultaneously + active users. These guidelines are intended to improve HTTP response + times and avoid congestion. + +8.2 Message Transmission Requirements + +8.2.1 Persistent Connections and Flow Control + + HTTP/1.1 servers SHOULD maintain persistent connections and use TCP's + flow control mechanisms to resolve temporary overloads, rather than + terminating connections with the expectation that clients will retry. + The latter technique can exacerbate network congestion. + + + + + +Fielding, et al. Standards Track [Page 47] + +RFC 2616 HTTP/1.1 June 1999 + + +8.2.2 Monitoring Connections for Error Status Messages + + An HTTP/1.1 (or later) client sending a message-body SHOULD monitor + the network connection for an error status while it is transmitting + the request. If the client sees an error status, it SHOULD + immediately cease transmitting the body. If the body is being sent + using a "chunked" encoding (section 3.6), a zero length chunk and + empty trailer MAY be used to prematurely mark the end of the message. + If the body was preceded by a Content-Length header, the client MUST + close the connection. + +8.2.3 Use of the 100 (Continue) Status + + The purpose of the 100 (Continue) status (see section 10.1.1) is to + allow a client that is sending a request message with a request body + to determine if the origin server is willing to accept the request + (based on the request headers) before the client sends the request + body. In some cases, it might either be inappropriate or highly + inefficient for the client to send the body if the server will reject + the message without looking at the body. + + Requirements for HTTP/1.1 clients: + + - If a client will wait for a 100 (Continue) response before + sending the request body, it MUST send an Expect request-header + field (section 14.20) with the "100-continue" expectation. + + - A client MUST NOT send an Expect request-header field (section + 14.20) with the "100-continue" expectation if it does not intend + to send a request body. + + Because of the presence of older implementations, the protocol allows + ambiguous situations in which a client may send "Expect: 100- + continue" without receiving either a 417 (Expectation Failed) status + or a 100 (Continue) status. Therefore, when a client sends this + header field to an origin server (possibly via a proxy) from which it + has never seen a 100 (Continue) status, the client SHOULD NOT wait + for an indefinite period before sending the request body. + + Requirements for HTTP/1.1 origin servers: + + - Upon receiving a request which includes an Expect request-header + field with the "100-continue" expectation, an origin server MUST + either respond with 100 (Continue) status and continue to read + from the input stream, or respond with a final status code. The + origin server MUST NOT wait for the request body before sending + the 100 (Continue) response. If it responds with a final status + code, it MAY close the transport connection or it MAY continue + + + +Fielding, et al. Standards Track [Page 48] + +RFC 2616 HTTP/1.1 June 1999 + + + to read and discard the rest of the request. It MUST NOT + perform the requested method if it returns a final status code. + + - An origin server SHOULD NOT send a 100 (Continue) response if + the request message does not include an Expect request-header + field with the "100-continue" expectation, and MUST NOT send a + 100 (Continue) response if such a request comes from an HTTP/1.0 + (or earlier) client. There is an exception to this rule: for + compatibility with RFC 2068, a server MAY send a 100 (Continue) + status in response to an HTTP/1.1 PUT or POST request that does + not include an Expect request-header field with the "100- + continue" expectation. This exception, the purpose of which is + to minimize any client processing delays associated with an + undeclared wait for 100 (Continue) status, applies only to + HTTP/1.1 requests, and not to requests with any other HTTP- + version value. + + - An origin server MAY omit a 100 (Continue) response if it has + already received some or all of the request body for the + corresponding request. + + - An origin server that sends a 100 (Continue) response MUST + ultimately send a final status code, once the request body is + received and processed, unless it terminates the transport + connection prematurely. + + - If an origin server receives a request that does not include an + Expect request-header field with the "100-continue" expectation, + the request includes a request body, and the server responds + with a final status code before reading the entire request body + from the transport connection, then the server SHOULD NOT close + the transport connection until it has read the entire request, + or until the client closes the connection. Otherwise, the client + might not reliably receive the response message. However, this + requirement is not be construed as preventing a server from + defending itself against denial-of-service attacks, or from + badly broken client implementations. + + Requirements for HTTP/1.1 proxies: + + - If a proxy receives a request that includes an Expect request- + header field with the "100-continue" expectation, and the proxy + either knows that the next-hop server complies with HTTP/1.1 or + higher, or does not know the HTTP version of the next-hop + server, it MUST forward the request, including the Expect header + field. + + + + + +Fielding, et al. Standards Track [Page 49] + +RFC 2616 HTTP/1.1 June 1999 + + + - If the proxy knows that the version of the next-hop server is + HTTP/1.0 or lower, it MUST NOT forward the request, and it MUST + respond with a 417 (Expectation Failed) status. + + - Proxies SHOULD maintain a cache recording the HTTP version + numbers received from recently-referenced next-hop servers. + + - A proxy MUST NOT forward a 100 (Continue) response if the + request message was received from an HTTP/1.0 (or earlier) + client and did not include an Expect request-header field with + the "100-continue" expectation. This requirement overrides the + general rule for forwarding of 1xx responses (see section 10.1). + +8.2.4 Client Behavior if Server Prematurely Closes Connection + + If an HTTP/1.1 client sends a request which includes a request body, + but which does not include an Expect request-header field with the + "100-continue" expectation, and if the client is not directly + connected to an HTTP/1.1 origin server, and if the client sees the + connection close before receiving any status from the server, the + client SHOULD retry the request. If the client does retry this + request, it MAY use the following "binary exponential backoff" + algorithm to be assured of obtaining a reliable response: + + 1. Initiate a new connection to the server + + 2. Transmit the request-headers + + 3. Initialize a variable R to the estimated round-trip time to the + server (e.g., based on the time it took to establish the + connection), or to a constant value of 5 seconds if the round- + trip time is not available. + + 4. Compute T = R * (2**N), where N is the number of previous + retries of this request. + + 5. Wait either for an error response from the server, or for T + seconds (whichever comes first) + + 6. If no error response is received, after T seconds transmit the + body of the request. + + 7. If client sees that the connection is closed prematurely, + repeat from step 1 until the request is accepted, an error + response is received, or the user becomes impatient and + terminates the retry process. + + + + + +Fielding, et al. Standards Track [Page 50] + +RFC 2616 HTTP/1.1 June 1999 + + + If at any point an error status is received, the client + + - SHOULD NOT continue and + + - SHOULD close the connection if it has not completed sending the + request message. + +9 Method Definitions + + The set of common methods for HTTP/1.1 is defined below. Although + this set can be expanded, additional methods cannot be assumed to + share the same semantics for separately extended clients and servers. + + The Host request-header field (section 14.23) MUST accompany all + HTTP/1.1 requests. + +9.1 Safe and Idempotent Methods + +9.1.1 Safe Methods + + Implementors should be aware that the software represents the user in + their interactions over the Internet, and should be careful to allow + the user to be aware of any actions they might take which may have an + unexpected significance to themselves or others. + + In particular, the convention has been established that the GET and + HEAD methods SHOULD NOT have the significance of taking an action + other than retrieval. These methods ought to be considered "safe". + This allows user agents to represent other methods, such as POST, PUT + and DELETE, in a special way, so that the user is made aware of the + fact that a possibly unsafe action is being requested. + + Naturally, it is not possible to ensure that the server does not + generate side-effects as a result of performing a GET request; in + fact, some dynamic resources consider that a feature. The important + distinction here is that the user did not request the side-effects, + so therefore cannot be held accountable for them. + +9.1.2 Idempotent Methods + + Methods can also have the property of "idempotence" in that (aside + from error or expiration issues) the side-effects of N > 0 identical + requests is the same as for a single request. The methods GET, HEAD, + PUT and DELETE share this property. Also, the methods OPTIONS and + TRACE SHOULD NOT have side effects, and so are inherently idempotent. + + + + + + +Fielding, et al. Standards Track [Page 51] + +RFC 2616 HTTP/1.1 June 1999 + + + However, it is possible that a sequence of several requests is non- + idempotent, even if all of the methods executed in that sequence are + idempotent. (A sequence is idempotent if a single execution of the + entire sequence always yields a result that is not changed by a + reexecution of all, or part, of that sequence.) For example, a + sequence is non-idempotent if its result depends on a value that is + later modified in the same sequence. + + A sequence that never has side effects is idempotent, by definition + (provided that no concurrent operations are being executed on the + same set of resources). + +9.2 OPTIONS + + The OPTIONS method represents a request for information about the + communication options available on the request/response chain + identified by the Request-URI. This method allows the client to + determine the options and/or requirements associated with a resource, + or the capabilities of a server, without implying a resource action + or initiating a resource retrieval. + + Responses to this method are not cacheable. + + If the OPTIONS request includes an entity-body (as indicated by the + presence of Content-Length or Transfer-Encoding), then the media type + MUST be indicated by a Content-Type field. Although this + specification does not define any use for such a body, future + extensions to HTTP might use the OPTIONS body to make more detailed + queries on the server. A server that does not support such an + extension MAY discard the request body. + + If the Request-URI is an asterisk ("*"), the OPTIONS request is + intended to apply to the server in general rather than to a specific + resource. Since a server's communication options typically depend on + the resource, the "*" request is only useful as a "ping" or "no-op" + type of method; it does nothing beyond allowing the client to test + the capabilities of the server. For example, this can be used to test + a proxy for HTTP/1.1 compliance (or lack thereof). + + If the Request-URI is not an asterisk, the OPTIONS request applies + only to the options that are available when communicating with that + resource. + + A 200 response SHOULD include any header fields that indicate + optional features implemented by the server and applicable to that + resource (e.g., Allow), possibly including extensions not defined by + this specification. The response body, if any, SHOULD also include + information about the communication options. The format for such a + + + +Fielding, et al. Standards Track [Page 52] + +RFC 2616 HTTP/1.1 June 1999 + + + body is not defined by this specification, but might be defined by + future extensions to HTTP. Content negotiation MAY be used to select + the appropriate response format. If no response body is included, the + response MUST include a Content-Length field with a field-value of + "0". + + The Max-Forwards request-header field MAY be used to target a + specific proxy in the request chain. When a proxy receives an OPTIONS + request on an absoluteURI for which request forwarding is permitted, + the proxy MUST check for a Max-Forwards field. If the Max-Forwards + field-value is zero ("0"), the proxy MUST NOT forward the message; + instead, the proxy SHOULD respond with its own communication options. + If the Max-Forwards field-value is an integer greater than zero, the + proxy MUST decrement the field-value when it forwards the request. If + no Max-Forwards field is present in the request, then the forwarded + request MUST NOT include a Max-Forwards field. + +9.3 GET + + The GET method means retrieve whatever information (in the form of an + entity) is identified by the Request-URI. If the Request-URI refers + to a data-producing process, it is the produced data which shall be + returned as the entity in the response and not the source text of the + process, unless that text happens to be the output of the process. + + The semantics of the GET method change to a "conditional GET" if the + request message includes an If-Modified-Since, If-Unmodified-Since, + If-Match, If-None-Match, or If-Range header field. A conditional GET + method requests that the entity be transferred only under the + circumstances described by the conditional header field(s). The + conditional GET method is intended to reduce unnecessary network + usage by allowing cached entities to be refreshed without requiring + multiple requests or transferring data already held by the client. + + The semantics of the GET method change to a "partial GET" if the + request message includes a Range header field. A partial GET requests + that only part of the entity be transferred, as described in section + 14.35. The partial GET method is intended to reduce unnecessary + network usage by allowing partially-retrieved entities to be + completed without transferring data already held by the client. + + The response to a GET request is cacheable if and only if it meets + the requirements for HTTP caching described in section 13. + + See section 15.1.3 for security considerations when used for forms. + + + + + + +Fielding, et al. Standards Track [Page 53] + +RFC 2616 HTTP/1.1 June 1999 + + +9.4 HEAD + + The HEAD method is identical to GET except that the server MUST NOT + return a message-body in the response. The metainformation contained + in the HTTP headers in response to a HEAD request SHOULD be identical + to the information sent in response to a GET request. This method can + be used for obtaining metainformation about the entity implied by the + request without transferring the entity-body itself. This method is + often used for testing hypertext links for validity, accessibility, + and recent modification. + + The response to a HEAD request MAY be cacheable in the sense that the + information contained in the response MAY be used to update a + previously cached entity from that resource. If the new field values + indicate that the cached entity differs from the current entity (as + would be indicated by a change in Content-Length, Content-MD5, ETag + or Last-Modified), then the cache MUST treat the cache entry as + stale. + +9.5 POST + + The POST method is used to request that the origin server accept the + entity enclosed in the request as a new subordinate of the resource + identified by the Request-URI in the Request-Line. POST is designed + to allow a uniform method to cover the following functions: + + - Annotation of existing resources; + + - Posting a message to a bulletin board, newsgroup, mailing list, + or similar group of articles; + + - Providing a block of data, such as the result of submitting a + form, to a data-handling process; + + - Extending a database through an append operation. + + The actual function performed by the POST method is determined by the + server and is usually dependent on the Request-URI. The posted entity + is subordinate to that URI in the same way that a file is subordinate + to a directory containing it, a news article is subordinate to a + newsgroup to which it is posted, or a record is subordinate to a + database. + + The action performed by the POST method might not result in a + resource that can be identified by a URI. In this case, either 200 + (OK) or 204 (No Content) is the appropriate response status, + depending on whether or not the response includes an entity that + describes the result. + + + +Fielding, et al. Standards Track [Page 54] + +RFC 2616 HTTP/1.1 June 1999 + + + If a resource has been created on the origin server, the response + SHOULD be 201 (Created) and contain an entity which describes the + status of the request and refers to the new resource, and a Location + header (see section 14.30). + + Responses to this method are not cacheable, unless the response + includes appropriate Cache-Control or Expires header fields. However, + the 303 (See Other) response can be used to direct the user agent to + retrieve a cacheable resource. + + POST requests MUST obey the message transmission requirements set out + in section 8.2. + + See section 15.1.3 for security considerations. + +9.6 PUT + + The PUT method requests that the enclosed entity be stored under the + supplied Request-URI. If the Request-URI refers to an already + existing resource, the enclosed entity SHOULD be considered as a + modified version of the one residing on the origin server. If the + Request-URI does not point to an existing resource, and that URI is + capable of being defined as a new resource by the requesting user + agent, the origin server can create the resource with that URI. If a + new resource is created, the origin server MUST inform the user agent + via the 201 (Created) response. If an existing resource is modified, + either the 200 (OK) or 204 (No Content) response codes SHOULD be sent + to indicate successful completion of the request. If the resource + could not be created or modified with the Request-URI, an appropriate + error response SHOULD be given that reflects the nature of the + problem. The recipient of the entity MUST NOT ignore any Content-* + (e.g. Content-Range) headers that it does not understand or implement + and MUST return a 501 (Not Implemented) response in such cases. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + + The fundamental difference between the POST and PUT requests is + reflected in the different meaning of the Request-URI. The URI in a + POST request identifies the resource that will handle the enclosed + entity. That resource might be a data-accepting process, a gateway to + some other protocol, or a separate entity that accepts annotations. + In contrast, the URI in a PUT request identifies the entity enclosed + with the request -- the user agent knows what URI is intended and the + server MUST NOT attempt to apply the request to some other resource. + If the server desires that the request be applied to a different URI, + + + + +Fielding, et al. Standards Track [Page 55] + +RFC 2616 HTTP/1.1 June 1999 + + + it MUST send a 301 (Moved Permanently) response; the user agent MAY + then make its own decision regarding whether or not to redirect the + request. + + A single resource MAY be identified by many different URIs. For + example, an article might have a URI for identifying "the current + version" which is separate from the URI identifying each particular + version. In this case, a PUT request on a general URI might result in + several other URIs being defined by the origin server. + + HTTP/1.1 does not define how a PUT method affects the state of an + origin server. + + PUT requests MUST obey the message transmission requirements set out + in section 8.2. + + Unless otherwise specified for a particular entity-header, the + entity-headers in the PUT request SHOULD be applied to the resource + created or modified by the PUT. + +9.7 DELETE + + The DELETE method requests that the origin server delete the resource + identified by the Request-URI. This method MAY be overridden by human + intervention (or other means) on the origin server. The client cannot + be guaranteed that the operation has been carried out, even if the + status code returned from the origin server indicates that the action + has been completed successfully. However, the server SHOULD NOT + indicate success unless, at the time the response is given, it + intends to delete the resource or move it to an inaccessible + location. + + A successful response SHOULD be 200 (OK) if the response includes an + entity describing the status, 202 (Accepted) if the action has not + yet been enacted, or 204 (No Content) if the action has been enacted + but the response does not include an entity. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + +9.8 TRACE + + The TRACE method is used to invoke a remote, application-layer loop- + back of the request message. The final recipient of the request + SHOULD reflect the message received back to the client as the + entity-body of a 200 (OK) response. The final recipient is either the + + + + +Fielding, et al. Standards Track [Page 56] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server or the first proxy or gateway to receive a Max-Forwards + value of zero (0) in the request (see section 14.31). A TRACE request + MUST NOT include an entity. + + TRACE allows the client to see what is being received at the other + end of the request chain and use that data for testing or diagnostic + information. The value of the Via header field (section 14.45) is of + particular interest, since it acts as a trace of the request chain. + Use of the Max-Forwards header field allows the client to limit the + length of the request chain, which is useful for testing a chain of + proxies forwarding messages in an infinite loop. + + If the request is valid, the response SHOULD contain the entire + request message in the entity-body, with a Content-Type of + "message/http". Responses to this method MUST NOT be cached. + +9.9 CONNECT + + This specification reserves the method name CONNECT for use with a + proxy that can dynamically switch to being a tunnel (e.g. SSL + tunneling [44]). + +10 Status Code Definitions + + Each Status-Code is described below, including a description of which + method(s) it can follow and any metainformation required in the + response. + +10.1 Informational 1xx + + This class of status code indicates a provisional response, + consisting only of the Status-Line and optional headers, and is + terminated by an empty line. There are no required headers for this + class of status code. Since HTTP/1.0 did not define any 1xx status + codes, servers MUST NOT send a 1xx response to an HTTP/1.0 client + except under experimental conditions. + + A client MUST be prepared to accept one or more 1xx status responses + prior to a regular response, even if the client does not expect a 100 + (Continue) status message. Unexpected 1xx status responses MAY be + ignored by a user agent. + + Proxies MUST forward 1xx responses, unless the connection between the + proxy and its client has been closed, or unless the proxy itself + requested the generation of the 1xx response. (For example, if a + + + + + + +Fielding, et al. Standards Track [Page 57] + +RFC 2616 HTTP/1.1 June 1999 + + + proxy adds a "Expect: 100-continue" field when it forwards a request, + then it need not forward the corresponding 100 (Continue) + response(s).) + +10.1.1 100 Continue + + The client SHOULD continue with its request. This interim response is + used to inform the client that the initial part of the request has + been received and has not yet been rejected by the server. The client + SHOULD continue by sending the remainder of the request or, if the + request has already been completed, ignore this response. The server + MUST send a final response after the request has been completed. See + section 8.2.3 for detailed discussion of the use and handling of this + status code. + +10.1.2 101 Switching Protocols + + The server understands and is willing to comply with the client's + request, via the Upgrade message header field (section 14.42), for a + change in the application protocol being used on this connection. The + server will switch protocols to those defined by the response's + Upgrade header field immediately after the empty line which + terminates the 101 response. + + The protocol SHOULD be switched only when it is advantageous to do + so. For example, switching to a newer version of HTTP is advantageous + over older versions, and switching to a real-time, synchronous + protocol might be advantageous when delivering resources that use + such features. + +10.2 Successful 2xx + + This class of status code indicates that the client's request was + successfully received, understood, and accepted. + +10.2.1 200 OK + + The request has succeeded. The information returned with the response + is dependent on the method used in the request, for example: + + GET an entity corresponding to the requested resource is sent in + the response; + + HEAD the entity-header fields corresponding to the requested + resource are sent in the response without any message-body; + + POST an entity describing or containing the result of the action; + + + + +Fielding, et al. Standards Track [Page 58] + +RFC 2616 HTTP/1.1 June 1999 + + + TRACE an entity containing the request message as received by the + end server. + +10.2.2 201 Created + + The request has been fulfilled and resulted in a new resource being + created. The newly created resource can be referenced by the URI(s) + returned in the entity of the response, with the most specific URI + for the resource given by a Location header field. The response + SHOULD include an entity containing a list of resource + characteristics and location(s) from which the user or user agent can + choose the one most appropriate. The entity format is specified by + the media type given in the Content-Type header field. The origin + server MUST create the resource before returning the 201 status code. + If the action cannot be carried out immediately, the server SHOULD + respond with 202 (Accepted) response instead. + + A 201 response MAY contain an ETag response header field indicating + the current value of the entity tag for the requested variant just + created, see section 14.19. + +10.2.3 202 Accepted + + The request has been accepted for processing, but the processing has + not been completed. The request might or might not eventually be + acted upon, as it might be disallowed when processing actually takes + place. There is no facility for re-sending a status code from an + asynchronous operation such as this. + + The 202 response is intentionally non-committal. Its purpose is to + allow a server to accept a request for some other process (perhaps a + batch-oriented process that is only run once per day) without + requiring that the user agent's connection to the server persist + until the process is completed. The entity returned with this + response SHOULD include an indication of the request's current status + and either a pointer to a status monitor or some estimate of when the + user can expect the request to be fulfilled. + +10.2.4 203 Non-Authoritative Information + + The returned metainformation in the entity-header is not the + definitive set as available from the origin server, but is gathered + from a local or a third-party copy. The set presented MAY be a subset + or superset of the original version. For example, including local + annotation information about the resource might result in a superset + of the metainformation known by the origin server. Use of this + response code is not required and is only appropriate when the + response would otherwise be 200 (OK). + + + +Fielding, et al. Standards Track [Page 59] + +RFC 2616 HTTP/1.1 June 1999 + + +10.2.5 204 No Content + + The server has fulfilled the request but does not need to return an + entity-body, and might want to return updated metainformation. The + response MAY include new or updated metainformation in the form of + entity-headers, which if present SHOULD be associated with the + requested variant. + + If the client is a user agent, it SHOULD NOT change its document view + from that which caused the request to be sent. This response is + primarily intended to allow input for actions to take place without + causing a change to the user agent's active document view, although + any new or updated metainformation SHOULD be applied to the document + currently in the user agent's active view. + + The 204 response MUST NOT include a message-body, and thus is always + terminated by the first empty line after the header fields. + +10.2.6 205 Reset Content + + The server has fulfilled the request and the user agent SHOULD reset + the document view which caused the request to be sent. This response + is primarily intended to allow input for actions to take place via + user input, followed by a clearing of the form in which the input is + given so that the user can easily initiate another input action. The + response MUST NOT include an entity. + +10.2.7 206 Partial Content + + The server has fulfilled the partial GET request for the resource. + The request MUST have included a Range header field (section 14.35) + indicating the desired range, and MAY have included an If-Range + header field (section 14.27) to make the request conditional. + + The response MUST include the following header fields: + + - Either a Content-Range header field (section 14.16) indicating + the range included with this response, or a multipart/byteranges + Content-Type including Content-Range fields for each part. If a + Content-Length header field is present in the response, its + value MUST match the actual number of OCTETs transmitted in the + message-body. + + - Date + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + + + +Fielding, et al. Standards Track [Page 60] + +RFC 2616 HTTP/1.1 June 1999 + + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the 206 response is the result of an If-Range request that used a + strong cache validator (see section 13.3.3), the response SHOULD NOT + include other entity-headers. If the response is the result of an + If-Range request that used a weak validator, the response MUST NOT + include other entity-headers; this prevents inconsistencies between + cached entity-bodies and updated headers. Otherwise, the response + MUST include all of the entity-headers that would have been returned + with a 200 (OK) response to the same request. + + A cache MUST NOT combine a 206 response with other previously cached + content if the ETag or Last-Modified headers do not match exactly, + see 13.5.4. + + A cache that does not support the Range and Content-Range headers + MUST NOT cache 206 (Partial) responses. + +10.3 Redirection 3xx + + This class of status code indicates that further action needs to be + taken by the user agent in order to fulfill the request. The action + required MAY be carried out by the user agent without interaction + with the user if and only if the method used in the second request is + GET or HEAD. A client SHOULD detect infinite redirection loops, since + such loops generate network traffic for each redirection. + + Note: previous versions of this specification recommended a + maximum of five redirections. Content developers should be aware + that there might be clients that implement such a fixed + limitation. + +10.3.1 300 Multiple Choices + + The requested resource corresponds to any one of a set of + representations, each with its own specific location, and agent- + driven negotiation information (section 12) is being provided so that + the user (or user agent) can select a preferred representation and + redirect its request to that location. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of resource characteristics and location(s) from + which the user or user agent can choose the one most appropriate. The + entity format is specified by the media type given in the Content- + Type header field. Depending upon the format and the capabilities of + + + + +Fielding, et al. Standards Track [Page 61] + +RFC 2616 HTTP/1.1 June 1999 + + + the user agent, selection of the most appropriate choice MAY be + performed automatically. However, this specification does not define + any standard for such automatic selection. + + If the server has a preferred choice of representation, it SHOULD + include the specific URI for that representation in the Location + field; user agents MAY use the Location field value for automatic + redirection. This response is cacheable unless indicated otherwise. + +10.3.2 301 Moved Permanently + + The requested resource has been assigned a new permanent URI and any + future references to this resource SHOULD use one of the returned + URIs. Clients with link editing capabilities ought to automatically + re-link references to the Request-URI to one or more of the new + references returned by the server, where possible. This response is + cacheable unless indicated otherwise. + + The new permanent URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + If the 301 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: When automatically redirecting a POST request after + receiving a 301 status code, some existing HTTP/1.0 user agents + will erroneously change it into a GET request. + +10.3.3 302 Found + + The requested resource resides temporarily under a different URI. + Since the redirection might be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + + + + + + +Fielding, et al. Standards Track [Page 62] + +RFC 2616 HTTP/1.1 June 1999 + + + If the 302 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: RFC 1945 and RFC 2068 specify that the client is not allowed + to change the method on the redirected request. However, most + existing user agent implementations treat 302 as if it were a 303 + response, performing a GET on the Location field-value regardless + of the original request method. The status codes 303 and 307 have + been added for servers that wish to make unambiguously clear which + kind of reaction is expected of the client. + +10.3.4 303 See Other + + The response to the request can be found under a different URI and + SHOULD be retrieved using a GET method on that resource. This method + exists primarily to allow the output of a POST-activated script to + redirect the user agent to a selected resource. The new URI is not a + substitute reference for the originally requested resource. The 303 + response MUST NOT be cached, but the response to the second + (redirected) request might be cacheable. + + The different URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + Note: Many pre-HTTP/1.1 user agents do not understand the 303 + status. When interoperability with such clients is a concern, the + 302 status code may be used instead, since most user agents react + to a 302 response as described here for 303. + +10.3.5 304 Not Modified + + If the client has performed a conditional GET request and access is + allowed, but the document has not been modified, the server SHOULD + respond with this status code. The 304 response MUST NOT contain a + message-body, and thus is always terminated by the first empty line + after the header fields. + + The response MUST include the following header fields: + + - Date, unless its omission is required by section 14.18.1 + + + + + + + +Fielding, et al. Standards Track [Page 63] + +RFC 2616 HTTP/1.1 June 1999 + + + If a clockless origin server obeys these rules, and proxies and + clients add their own Date to any response received without one (as + already specified by [RFC 2068], section 14.19), caches will operate + correctly. + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the conditional GET used a strong cache validator (see section + 13.3.3), the response SHOULD NOT include other entity-headers. + Otherwise (i.e., the conditional GET used a weak validator), the + response MUST NOT include other entity-headers; this prevents + inconsistencies between cached entity-bodies and updated headers. + + If a 304 response indicates an entity not currently cached, then the + cache MUST disregard the response and repeat the request without the + conditional. + + If a cache uses a received 304 response to update a cache entry, the + cache MUST update the entry to reflect any new field values given in + the response. + +10.3.6 305 Use Proxy + + The requested resource MUST be accessed through the proxy given by + the Location field. The Location field gives the URI of the proxy. + The recipient is expected to repeat this single request via the + proxy. 305 responses MUST only be generated by origin servers. + + Note: RFC 2068 was not clear that 305 was intended to redirect a + single request, and to be generated by origin servers only. Not + observing these limitations has significant security consequences. + +10.3.7 306 (Unused) + + The 306 status code was used in a previous version of the + specification, is no longer used, and the code is reserved. + + + + + + + + + + +Fielding, et al. Standards Track [Page 64] + +RFC 2616 HTTP/1.1 June 1999 + + +10.3.8 307 Temporary Redirect + + The requested resource resides temporarily under a different URI. + Since the redirection MAY be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s) , since many pre-HTTP/1.1 user agents do not + understand the 307 status. Therefore, the note SHOULD contain the + information necessary for a user to repeat the original request on + the new URI. + + If the 307 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + +10.4 Client Error 4xx + + The 4xx class of status code is intended for cases in which the + client seems to have erred. Except when responding to a HEAD request, + the server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. These status codes are applicable to any request method. + User agents SHOULD display any included entity to the user. + + If the client is sending data, a server implementation using TCP + SHOULD be careful to ensure that the client acknowledges receipt of + the packet(s) containing the response, before the server closes the + input connection. If the client continues sending data to the server + after the close, the server's TCP stack will send a reset packet to + the client, which may erase the client's unacknowledged input buffers + before they can be read and interpreted by the HTTP application. + +10.4.1 400 Bad Request + + The request could not be understood by the server due to malformed + syntax. The client SHOULD NOT repeat the request without + modifications. + + + + + + + + +Fielding, et al. Standards Track [Page 65] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.2 401 Unauthorized + + The request requires user authentication. The response MUST include a + WWW-Authenticate header field (section 14.47) containing a challenge + applicable to the requested resource. The client MAY repeat the + request with a suitable Authorization header field (section 14.8). If + the request already included Authorization credentials, then the 401 + response indicates that authorization has been refused for those + credentials. If the 401 response contains the same challenge as the + prior response, and the user agent has already attempted + authentication at least once, then the user SHOULD be presented the + entity that was given in the response, since that entity might + include relevant diagnostic information. HTTP access authentication + is explained in "HTTP Authentication: Basic and Digest Access + Authentication" [43]. + +10.4.3 402 Payment Required + + This code is reserved for future use. + +10.4.4 403 Forbidden + + The server understood the request, but is refusing to fulfill it. + Authorization will not help and the request SHOULD NOT be repeated. + If the request method was not HEAD and the server wishes to make + public why the request has not been fulfilled, it SHOULD describe the + reason for the refusal in the entity. If the server does not wish to + make this information available to the client, the status code 404 + (Not Found) can be used instead. + +10.4.5 404 Not Found + + The server has not found anything matching the Request-URI. No + indication is given of whether the condition is temporary or + permanent. The 410 (Gone) status code SHOULD be used if the server + knows, through some internally configurable mechanism, that an old + resource is permanently unavailable and has no forwarding address. + This status code is commonly used when the server does not wish to + reveal exactly why the request has been refused, or when no other + response is applicable. + +10.4.6 405 Method Not Allowed + + The method specified in the Request-Line is not allowed for the + resource identified by the Request-URI. The response MUST include an + Allow header containing a list of valid methods for the requested + resource. + + + + +Fielding, et al. Standards Track [Page 66] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.7 406 Not Acceptable + + The resource identified by the request is only capable of generating + response entities which have content characteristics not acceptable + according to the accept headers sent in the request. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of available entity characteristics and location(s) + from which the user or user agent can choose the one most + appropriate. The entity format is specified by the media type given + in the Content-Type header field. Depending upon the format and the + capabilities of the user agent, selection of the most appropriate + choice MAY be performed automatically. However, this specification + does not define any standard for such automatic selection. + + Note: HTTP/1.1 servers are allowed to return responses which are + not acceptable according to the accept headers sent in the + request. In some cases, this may even be preferable to sending a + 406 response. User agents are encouraged to inspect the headers of + an incoming response to determine if it is acceptable. + + If the response could be unacceptable, a user agent SHOULD + temporarily stop receipt of more data and query the user for a + decision on further actions. + +10.4.8 407 Proxy Authentication Required + + This code is similar to 401 (Unauthorized), but indicates that the + client must first authenticate itself with the proxy. The proxy MUST + return a Proxy-Authenticate header field (section 14.33) containing a + challenge applicable to the proxy for the requested resource. The + client MAY repeat the request with a suitable Proxy-Authorization + header field (section 14.34). HTTP access authentication is explained + in "HTTP Authentication: Basic and Digest Access Authentication" + [43]. + +10.4.9 408 Request Timeout + + The client did not produce a request within the time that the server + was prepared to wait. The client MAY repeat the request without + modifications at any later time. + +10.4.10 409 Conflict + + The request could not be completed due to a conflict with the current + state of the resource. This code is only allowed in situations where + it is expected that the user might be able to resolve the conflict + and resubmit the request. The response body SHOULD include enough + + + +Fielding, et al. Standards Track [Page 67] + +RFC 2616 HTTP/1.1 June 1999 + + + information for the user to recognize the source of the conflict. + Ideally, the response entity would include enough information for the + user or user agent to fix the problem; however, that might not be + possible and is not required. + + Conflicts are most likely to occur in response to a PUT request. For + example, if versioning were being used and the entity being PUT + included changes to a resource which conflict with those made by an + earlier (third-party) request, the server might use the 409 response + to indicate that it can't complete the request. In this case, the + response entity would likely contain a list of the differences + between the two versions in a format defined by the response + Content-Type. + +10.4.11 410 Gone + + The requested resource is no longer available at the server and no + forwarding address is known. This condition is expected to be + considered permanent. Clients with link editing capabilities SHOULD + delete references to the Request-URI after user approval. If the + server does not know, or has no facility to determine, whether or not + the condition is permanent, the status code 404 (Not Found) SHOULD be + used instead. This response is cacheable unless indicated otherwise. + + The 410 response is primarily intended to assist the task of web + maintenance by notifying the recipient that the resource is + intentionally unavailable and that the server owners desire that + remote links to that resource be removed. Such an event is common for + limited-time, promotional services and for resources belonging to + individuals no longer working at the server's site. It is not + necessary to mark all permanently unavailable resources as "gone" or + to keep the mark for any length of time -- that is left to the + discretion of the server owner. + +10.4.12 411 Length Required + + The server refuses to accept the request without a defined Content- + Length. The client MAY repeat the request if it adds a valid + Content-Length header field containing the length of the message-body + in the request message. + +10.4.13 412 Precondition Failed + + The precondition given in one or more of the request-header fields + evaluated to false when it was tested on the server. This response + code allows the client to place preconditions on the current resource + metainformation (header field data) and thus prevent the requested + method from being applied to a resource other than the one intended. + + + +Fielding, et al. Standards Track [Page 68] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.14 413 Request Entity Too Large + + The server is refusing to process a request because the request + entity is larger than the server is willing or able to process. The + server MAY close the connection to prevent the client from continuing + the request. + + If the condition is temporary, the server SHOULD include a Retry- + After header field to indicate that it is temporary and after what + time the client MAY try again. + +10.4.15 414 Request-URI Too Long + + The server is refusing to service the request because the Request-URI + is longer than the server is willing to interpret. This rare + condition is only likely to occur when a client has improperly + converted a POST request to a GET request with long query + information, when the client has descended into a URI "black hole" of + redirection (e.g., a redirected URI prefix that points to a suffix of + itself), or when the server is under attack by a client attempting to + exploit security holes present in some servers using fixed-length + buffers for reading or manipulating the Request-URI. + +10.4.16 415 Unsupported Media Type + + The server is refusing to service the request because the entity of + the request is in a format not supported by the requested resource + for the requested method. + +10.4.17 416 Requested Range Not Satisfiable + + A server SHOULD return a response with this status code if a request + included a Range request-header field (section 14.35), and none of + the range-specifier values in this field overlap the current extent + of the selected resource, and the request did not include an If-Range + request-header field. (For byte-ranges, this means that the first- + byte-pos of all of the byte-range-spec values were greater than the + current length of the selected resource.) + + When this status code is returned for a byte-range request, the + response SHOULD include a Content-Range entity-header field + specifying the current length of the selected resource (see section + 14.16). This response MUST NOT use the multipart/byteranges content- + type. + + + + + + + +Fielding, et al. Standards Track [Page 69] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.18 417 Expectation Failed + + The expectation given in an Expect request-header field (see section + 14.20) could not be met by this server, or, if the server is a proxy, + the server has unambiguous evidence that the request could not be met + by the next-hop server. + +10.5 Server Error 5xx + + Response status codes beginning with the digit "5" indicate cases in + which the server is aware that it has erred or is incapable of + performing the request. Except when responding to a HEAD request, the + server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. User agents SHOULD display any included entity to the + user. These response codes are applicable to any request method. + +10.5.1 500 Internal Server Error + + The server encountered an unexpected condition which prevented it + from fulfilling the request. + +10.5.2 501 Not Implemented + + The server does not support the functionality required to fulfill the + request. This is the appropriate response when the server does not + recognize the request method and is not capable of supporting it for + any resource. + +10.5.3 502 Bad Gateway + + The server, while acting as a gateway or proxy, received an invalid + response from the upstream server it accessed in attempting to + fulfill the request. + +10.5.4 503 Service Unavailable + + The server is currently unable to handle the request due to a + temporary overloading or maintenance of the server. The implication + is that this is a temporary condition which will be alleviated after + some delay. If known, the length of the delay MAY be indicated in a + Retry-After header. If no Retry-After is given, the client SHOULD + handle the response as it would for a 500 response. + + Note: The existence of the 503 status code does not imply that a + server must use it when becoming overloaded. Some servers may wish + to simply refuse the connection. + + + + +Fielding, et al. Standards Track [Page 70] + +RFC 2616 HTTP/1.1 June 1999 + + +10.5.5 504 Gateway Timeout + + The server, while acting as a gateway or proxy, did not receive a + timely response from the upstream server specified by the URI (e.g. + HTTP, FTP, LDAP) or some other auxiliary server (e.g. DNS) it needed + to access in attempting to complete the request. + + Note: Note to implementors: some deployed proxies are known to + return 400 or 500 when DNS lookups time out. + +10.5.6 505 HTTP Version Not Supported + + The server does not support, or refuses to support, the HTTP protocol + version that was used in the request message. The server is + indicating that it is unable or unwilling to complete the request + using the same major version as the client, as described in section + 3.1, other than with this error message. The response SHOULD contain + an entity describing why that version is not supported and what other + protocols are supported by that server. + +11 Access Authentication + + HTTP provides several OPTIONAL challenge-response authentication + mechanisms which can be used by a server to challenge a client + request and by a client to provide authentication information. The + general framework for access authentication, and the specification of + "basic" and "digest" authentication, are specified in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. This + specification adopts the definitions of "challenge" and "credentials" + from that specification. + +12 Content Negotiation + + Most HTTP responses include an entity which contains information for + interpretation by a human user. Naturally, it is desirable to supply + the user with the "best available" entity corresponding to the + request. Unfortunately for servers and caches, not all users have the + same preferences for what is "best," and not all user agents are + equally capable of rendering all entity types. For that reason, HTTP + has provisions for several mechanisms for "content negotiation" -- + the process of selecting the best representation for a given response + when there are multiple representations available. + + Note: This is not called "format negotiation" because the + alternate representations may be of the same media type, but use + different capabilities of that type, be in different languages, + etc. + + + + +Fielding, et al. Standards Track [Page 71] + +RFC 2616 HTTP/1.1 June 1999 + + + Any response containing an entity-body MAY be subject to negotiation, + including error responses. + + There are two kinds of content negotiation which are possible in + HTTP: server-driven and agent-driven negotiation. These two kinds of + negotiation are orthogonal and thus may be used separately or in + combination. One method of combination, referred to as transparent + negotiation, occurs when a cache uses the agent-driven negotiation + information provided by the origin server in order to provide + server-driven negotiation for subsequent requests. + +12.1 Server-driven Negotiation + + If the selection of the best representation for a response is made by + an algorithm located at the server, it is called server-driven + negotiation. Selection is based on the available representations of + the response (the dimensions over which it can vary; e.g. language, + content-coding, etc.) and the contents of particular header fields in + the request message or on other information pertaining to the request + (such as the network address of the client). + + Server-driven negotiation is advantageous when the algorithm for + selecting from among the available representations is difficult to + describe to the user agent, or when the server desires to send its + "best guess" to the client along with the first response (hoping to + avoid the round-trip delay of a subsequent request if the "best + guess" is good enough for the user). In order to improve the server's + guess, the user agent MAY include request header fields (Accept, + Accept-Language, Accept-Encoding, etc.) which describe its + preferences for such a response. + + Server-driven negotiation has disadvantages: + + 1. It is impossible for the server to accurately determine what + might be "best" for any given user, since that would require + complete knowledge of both the capabilities of the user agent + and the intended use for the response (e.g., does the user want + to view it on screen or print it on paper?). + + 2. Having the user agent describe its capabilities in every + request can be both very inefficient (given that only a small + percentage of responses have multiple representations) and a + potential violation of the user's privacy. + + 3. It complicates the implementation of an origin server and the + algorithms for generating responses to a request. + + + + + +Fielding, et al. Standards Track [Page 72] + +RFC 2616 HTTP/1.1 June 1999 + + + 4. It may limit a public cache's ability to use the same response + for multiple user's requests. + + HTTP/1.1 includes the following request-header fields for enabling + server-driven negotiation through description of user agent + capabilities and user preferences: Accept (section 14.1), Accept- + Charset (section 14.2), Accept-Encoding (section 14.3), Accept- + Language (section 14.4), and User-Agent (section 14.43). However, an + origin server is not limited to these dimensions and MAY vary the + response based on any aspect of the request, including information + outside the request-header fields or within extension header fields + not defined by this specification. + + The Vary header field can be used to express the parameters the + server uses to select a representation that is subject to server- + driven negotiation. See section 13.6 for use of the Vary header field + by caches and section 14.44 for use of the Vary header field by + servers. + +12.2 Agent-driven Negotiation + + With agent-driven negotiation, selection of the best representation + for a response is performed by the user agent after receiving an + initial response from the origin server. Selection is based on a list + of the available representations of the response included within the + header fields or entity-body of the initial response, with each + representation identified by its own URI. Selection from among the + representations may be performed automatically (if the user agent is + capable of doing so) or manually by the user selecting from a + generated (possibly hypertext) menu. + + Agent-driven negotiation is advantageous when the response would vary + over commonly-used dimensions (such as type, language, or encoding), + when the origin server is unable to determine a user agent's + capabilities from examining the request, and generally when public + caches are used to distribute server load and reduce network usage. + + Agent-driven negotiation suffers from the disadvantage of needing a + second request to obtain the best alternate representation. This + second request is only efficient when caching is used. In addition, + this specification does not define any mechanism for supporting + automatic selection, though it also does not prevent any such + mechanism from being developed as an extension and used within + HTTP/1.1. + + + + + + + +Fielding, et al. Standards Track [Page 73] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 defines the 300 (Multiple Choices) and 406 (Not Acceptable) + status codes for enabling agent-driven negotiation when the server is + unwilling or unable to provide a varying response using server-driven + negotiation. + +12.3 Transparent Negotiation + + Transparent negotiation is a combination of both server-driven and + agent-driven negotiation. When a cache is supplied with a form of the + list of available representations of the response (as in agent-driven + negotiation) and the dimensions of variance are completely understood + by the cache, then the cache becomes capable of performing server- + driven negotiation on behalf of the origin server for subsequent + requests on that resource. + + Transparent negotiation has the advantage of distributing the + negotiation work that would otherwise be required of the origin + server and also removing the second request delay of agent-driven + negotiation when the cache is able to correctly guess the right + response. + + This specification does not define any mechanism for transparent + negotiation, though it also does not prevent any such mechanism from + being developed as an extension that could be used within HTTP/1.1. + +13 Caching in HTTP + + HTTP is typically used for distributed information systems, where + performance can be improved by the use of response caches. The + HTTP/1.1 protocol includes a number of elements intended to make + caching work as well as possible. Because these elements are + inextricable from other aspects of the protocol, and because they + interact with each other, it is useful to describe the basic caching + design of HTTP separately from the detailed descriptions of methods, + headers, response codes, etc. + + Caching would be useless if it did not significantly improve + performance. The goal of caching in HTTP/1.1 is to eliminate the need + to send requests in many cases, and to eliminate the need to send + full responses in many other cases. The former reduces the number of + network round-trips required for many operations; we use an + "expiration" mechanism for this purpose (see section 13.2). The + latter reduces network bandwidth requirements; we use a "validation" + mechanism for this purpose (see section 13.3). + + Requirements for performance, availability, and disconnected + operation require us to be able to relax the goal of semantic + transparency. The HTTP/1.1 protocol allows origin servers, caches, + + + +Fielding, et al. Standards Track [Page 74] + +RFC 2616 HTTP/1.1 June 1999 + + + and clients to explicitly reduce transparency when necessary. + However, because non-transparent operation may confuse non-expert + users, and might be incompatible with certain server applications + (such as those for ordering merchandise), the protocol requires that + transparency be relaxed + + - only by an explicit protocol-level request when relaxed by + client or origin server + + - only with an explicit warning to the end user when relaxed by + cache or client + + Therefore, the HTTP/1.1 protocol provides these important elements: + + 1. Protocol features that provide full semantic transparency when + this is required by all parties. + + 2. Protocol features that allow an origin server or user agent to + explicitly request and control non-transparent operation. + + 3. Protocol features that allow a cache to attach warnings to + responses that do not preserve the requested approximation of + semantic transparency. + + A basic principle is that it must be possible for the clients to + detect any potential relaxation of semantic transparency. + + Note: The server, cache, or client implementor might be faced with + design decisions not explicitly discussed in this specification. + If a decision might affect semantic transparency, the implementor + ought to err on the side of maintaining transparency unless a + careful and complete analysis shows significant benefits in + breaking transparency. + +13.1.1 Cache Correctness + + A correct cache MUST respond to a request with the most up-to-date + response held by the cache that is appropriate to the request (see + sections 13.2.5, 13.2.6, and 13.12) which meets one of the following + conditions: + + 1. It has been checked for equivalence with what the origin server + would have returned by revalidating the response with the + origin server (section 13.3); + + + + + + + +Fielding, et al. Standards Track [Page 75] + +RFC 2616 HTTP/1.1 June 1999 + + + 2. It is "fresh enough" (see section 13.2). In the default case, + this means it meets the least restrictive freshness requirement + of the client, origin server, and cache (see section 14.9); if + the origin server so specifies, it is the freshness requirement + of the origin server alone. + + If a stored response is not "fresh enough" by the most + restrictive freshness requirement of both the client and the + origin server, in carefully considered circumstances the cache + MAY still return the response with the appropriate Warning + header (see section 13.1.5 and 14.46), unless such a response + is prohibited (e.g., by a "no-store" cache-directive, or by a + "no-cache" cache-request-directive; see section 14.9). + + 3. It is an appropriate 304 (Not Modified), 305 (Proxy Redirect), + or error (4xx or 5xx) response message. + + If the cache can not communicate with the origin server, then a + correct cache SHOULD respond as above if the response can be + correctly served from the cache; if not it MUST return an error or + warning indicating that there was a communication failure. + + If a cache receives a response (either an entire response, or a 304 + (Not Modified) response) that it would normally forward to the + requesting client, and the received response is no longer fresh, the + cache SHOULD forward it to the requesting client without adding a new + Warning (but without removing any existing Warning headers). A cache + SHOULD NOT attempt to revalidate a response simply because that + response became stale in transit; this might lead to an infinite + loop. A user agent that receives a stale response without a Warning + MAY display a warning indication to the user. + +13.1.2 Warnings + + Whenever a cache returns a response that is neither first-hand nor + "fresh enough" (in the sense of condition 2 in section 13.1.1), it + MUST attach a warning to that effect, using a Warning general-header. + The Warning header and the currently defined warnings are described + in section 14.46. The warning allows clients to take appropriate + action. + + Warnings MAY be used for other purposes, both cache-related and + otherwise. The use of a warning, rather than an error status code, + distinguish these responses from true failures. + + Warnings are assigned three digit warn-codes. The first digit + indicates whether the Warning MUST or MUST NOT be deleted from a + stored cache entry after a successful revalidation: + + + +Fielding, et al. Standards Track [Page 76] + +RFC 2616 HTTP/1.1 June 1999 + + + 1xx Warnings that describe the freshness or revalidation status of + the response, and so MUST be deleted after a successful + revalidation. 1XX warn-codes MAY be generated by a cache only when + validating a cached entry. It MUST NOT be generated by clients. + + 2xx Warnings that describe some aspect of the entity body or entity + headers that is not rectified by a revalidation (for example, a + lossy compression of the entity bodies) and which MUST NOT be + deleted after a successful revalidation. + + See section 14.46 for the definitions of the codes themselves. + + HTTP/1.0 caches will cache all Warnings in responses, without + deleting the ones in the first category. Warnings in responses that + are passed to HTTP/1.0 caches carry an extra warning-date field, + which prevents a future HTTP/1.1 recipient from believing an + erroneously cached Warning. + + Warnings also carry a warning text. The text MAY be in any + appropriate natural language (perhaps based on the client's Accept + headers), and include an OPTIONAL indication of what character set is + used. + + Multiple warnings MAY be attached to a response (either by the origin + server or by a cache), including multiple warnings with the same code + number. For example, a server might provide the same warning with + texts in both English and Basque. + + When multiple warnings are attached to a response, it might not be + practical or reasonable to display all of them to the user. This + version of HTTP does not specify strict priority rules for deciding + which warnings to display and in what order, but does suggest some + heuristics. + +13.1.3 Cache-control Mechanisms + + The basic cache mechanisms in HTTP/1.1 (server-specified expiration + times and validators) are implicit directives to caches. In some + cases, a server or client might need to provide explicit directives + to the HTTP caches. We use the Cache-Control header for this purpose. + + The Cache-Control header allows a client or server to transmit a + variety of directives in either requests or responses. These + directives typically override the default caching algorithms. As a + general rule, if there is any apparent conflict between header + values, the most restrictive interpretation is applied (that is, the + one that is most likely to preserve semantic transparency). However, + + + + +Fielding, et al. Standards Track [Page 77] + +RFC 2616 HTTP/1.1 June 1999 + + + in some cases, cache-control directives are explicitly specified as + weakening the approximation of semantic transparency (for example, + "max-stale" or "public"). + + The cache-control directives are described in detail in section 14.9. + +13.1.4 Explicit User Agent Warnings + + Many user agents make it possible for users to override the basic + caching mechanisms. For example, the user agent might allow the user + to specify that cached entities (even explicitly stale ones) are + never validated. Or the user agent might habitually add "Cache- + Control: max-stale=3600" to every request. The user agent SHOULD NOT + default to either non-transparent behavior, or behavior that results + in abnormally ineffective caching, but MAY be explicitly configured + to do so by an explicit action of the user. + + If the user has overridden the basic caching mechanisms, the user + agent SHOULD explicitly indicate to the user whenever this results in + the display of information that might not meet the server's + transparency requirements (in particular, if the displayed entity is + known to be stale). Since the protocol normally allows the user agent + to determine if responses are stale or not, this indication need only + be displayed when this actually happens. The indication need not be a + dialog box; it could be an icon (for example, a picture of a rotting + fish) or some other indicator. + + If the user has overridden the caching mechanisms in a way that would + abnormally reduce the effectiveness of caches, the user agent SHOULD + continually indicate this state to the user (for example, by a + display of a picture of currency in flames) so that the user does not + inadvertently consume excess resources or suffer from excessive + latency. + +13.1.5 Exceptions to the Rules and Warnings + + In some cases, the operator of a cache MAY choose to configure it to + return stale responses even when not requested by clients. This + decision ought not be made lightly, but may be necessary for reasons + of availability or performance, especially when the cache is poorly + connected to the origin server. Whenever a cache returns a stale + response, it MUST mark it as such (using a Warning header) enabling + the client software to alert the user that there might be a potential + problem. + + + + + + + +Fielding, et al. Standards Track [Page 78] + +RFC 2616 HTTP/1.1 June 1999 + + + It also allows the user agent to take steps to obtain a first-hand or + fresh response. For this reason, a cache SHOULD NOT return a stale + response if the client explicitly requests a first-hand or fresh one, + unless it is impossible to comply for technical or policy reasons. + +13.1.6 Client-controlled Behavior + + While the origin server (and to a lesser extent, intermediate caches, + by their contribution to the age of a response) are the primary + source of expiration information, in some cases the client might need + to control a cache's decision about whether to return a cached + response without validating it. Clients do this using several + directives of the Cache-Control header. + + A client's request MAY specify the maximum age it is willing to + accept of an unvalidated response; specifying a value of zero forces + the cache(s) to revalidate all responses. A client MAY also specify + the minimum time remaining before a response expires. Both of these + options increase constraints on the behavior of caches, and so cannot + further relax the cache's approximation of semantic transparency. + + A client MAY also specify that it will accept stale responses, up to + some maximum amount of staleness. This loosens the constraints on the + caches, and so might violate the origin server's specified + constraints on semantic transparency, but might be necessary to + support disconnected operation, or high availability in the face of + poor connectivity. + +13.2 Expiration Model + +13.2.1 Server-Specified Expiration + + HTTP caching works best when caches can entirely avoid making + requests to the origin server. The primary mechanism for avoiding + requests is for an origin server to provide an explicit expiration + time in the future, indicating that a response MAY be used to satisfy + subsequent requests. In other words, a cache can return a fresh + response without first contacting the server. + + Our expectation is that servers will assign future explicit + expiration times to responses in the belief that the entity is not + likely to change, in a semantically significant way, before the + expiration time is reached. This normally preserves semantic + transparency, as long as the server's expiration times are carefully + chosen. + + + + + + +Fielding, et al. Standards Track [Page 79] + +RFC 2616 HTTP/1.1 June 1999 + + + The expiration mechanism applies only to responses taken from a cache + and not to first-hand responses forwarded immediately to the + requesting client. + + If an origin server wishes to force a semantically transparent cache + to validate every request, it MAY assign an explicit expiration time + in the past. This means that the response is always stale, and so the + cache SHOULD validate it before using it for subsequent requests. See + section 14.9.4 for a more restrictive way to force revalidation. + + If an origin server wishes to force any HTTP/1.1 cache, no matter how + it is configured, to validate every request, it SHOULD use the "must- + revalidate" cache-control directive (see section 14.9). + + Servers specify explicit expiration times using either the Expires + header, or the max-age directive of the Cache-Control header. + + An expiration time cannot be used to force a user agent to refresh + its display or reload a resource; its semantics apply only to caching + mechanisms, and such mechanisms need only check a resource's + expiration status when a new request for that resource is initiated. + See section 13.13 for an explanation of the difference between caches + and history mechanisms. + +13.2.2 Heuristic Expiration + + Since origin servers do not always provide explicit expiration times, + HTTP caches typically assign heuristic expiration times, employing + algorithms that use other header values (such as the Last-Modified + time) to estimate a plausible expiration time. The HTTP/1.1 + specification does not provide specific algorithms, but does impose + worst-case constraints on their results. Since heuristic expiration + times might compromise semantic transparency, they ought to used + cautiously, and we encourage origin servers to provide explicit + expiration times as much as possible. + +13.2.3 Age Calculations + + In order to know if a cached entry is fresh, a cache needs to know if + its age exceeds its freshness lifetime. We discuss how to calculate + the latter in section 13.2.4; this section describes how to calculate + the age of a response or cache entry. + + In this discussion, we use the term "now" to mean "the current value + of the clock at the host performing the calculation." Hosts that use + HTTP, but especially hosts running origin servers and caches, SHOULD + use NTP [28] or some similar protocol to synchronize their clocks to + a globally accurate time standard. + + + +Fielding, et al. Standards Track [Page 80] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 requires origin servers to send a Date header, if possible, + with every response, giving the time at which the response was + generated (see section 14.18). We use the term "date_value" to denote + the value of the Date header, in a form appropriate for arithmetic + operations. + + HTTP/1.1 uses the Age response-header to convey the estimated age of + the response message when obtained from a cache. The Age field value + is the cache's estimate of the amount of time since the response was + generated or revalidated by the origin server. + + In essence, the Age value is the sum of the time that the response + has been resident in each of the caches along the path from the + origin server, plus the amount of time it has been in transit along + network paths. + + We use the term "age_value" to denote the value of the Age header, in + a form appropriate for arithmetic operations. + + A response's age can be calculated in two entirely independent ways: + + 1. now minus date_value, if the local clock is reasonably well + synchronized to the origin server's clock. If the result is + negative, the result is replaced by zero. + + 2. age_value, if all of the caches along the response path + implement HTTP/1.1. + + Given that we have two independent ways to compute the age of a + response when it is received, we can combine these as + + corrected_received_age = max(now - date_value, age_value) + + and as long as we have either nearly synchronized clocks or all- + HTTP/1.1 paths, one gets a reliable (conservative) result. + + Because of network-imposed delays, some significant interval might + pass between the time that a server generates a response and the time + it is received at the next outbound cache or client. If uncorrected, + this delay could result in improperly low ages. + + Because the request that resulted in the returned Age value must have + been initiated prior to that Age value's generation, we can correct + for delays imposed by the network by recording the time at which the + request was initiated. Then, when an Age value is received, it MUST + be interpreted relative to the time the request was initiated, not + + + + + +Fielding, et al. Standards Track [Page 81] + +RFC 2616 HTTP/1.1 June 1999 + + + the time that the response was received. This algorithm results in + conservative behavior no matter how much delay is experienced. So, we + compute: + + corrected_initial_age = corrected_received_age + + (now - request_time) + + where "request_time" is the time (according to the local clock) when + the request that elicited this response was sent. + + Summary of age calculation algorithm, when a cache receives a + response: + + /* + * age_value + * is the value of Age: header received by the cache with + * this response. + * date_value + * is the value of the origin server's Date: header + * request_time + * is the (local) time when the cache made the request + * that resulted in this cached response + * response_time + * is the (local) time when the cache received the + * response + * now + * is the current (local) time + */ + + apparent_age = max(0, response_time - date_value); + corrected_received_age = max(apparent_age, age_value); + response_delay = response_time - request_time; + corrected_initial_age = corrected_received_age + response_delay; + resident_time = now - response_time; + current_age = corrected_initial_age + resident_time; + + The current_age of a cache entry is calculated by adding the amount + of time (in seconds) since the cache entry was last validated by the + origin server to the corrected_initial_age. When a response is + generated from a cache entry, the cache MUST include a single Age + header field in the response with a value equal to the cache entry's + current_age. + + The presence of an Age header field in a response implies that a + response is not first-hand. However, the converse is not true, since + the lack of an Age header field in a response does not imply that the + + + + + +Fielding, et al. Standards Track [Page 82] + +RFC 2616 HTTP/1.1 June 1999 + + + response is first-hand unless all caches along the request path are + compliant with HTTP/1.1 (i.e., older HTTP caches did not implement + the Age header field). + +13.2.4 Expiration Calculations + + In order to decide whether a response is fresh or stale, we need to + compare its freshness lifetime to its age. The age is calculated as + described in section 13.2.3; this section describes how to calculate + the freshness lifetime, and to determine if a response has expired. + In the discussion below, the values can be represented in any form + appropriate for arithmetic operations. + + We use the term "expires_value" to denote the value of the Expires + header. We use the term "max_age_value" to denote an appropriate + value of the number of seconds carried by the "max-age" directive of + the Cache-Control header in a response (see section 14.9.3). + + The max-age directive takes priority over Expires, so if max-age is + present in a response, the calculation is simply: + + freshness_lifetime = max_age_value + + Otherwise, if Expires is present in the response, the calculation is: + + freshness_lifetime = expires_value - date_value + + Note that neither of these calculations is vulnerable to clock skew, + since all of the information comes from the origin server. + + If none of Expires, Cache-Control: max-age, or Cache-Control: s- + maxage (see section 14.9.3) appears in the response, and the response + does not include other restrictions on caching, the cache MAY compute + a freshness lifetime using a heuristic. The cache MUST attach Warning + 113 to any response whose age is more than 24 hours if such warning + has not already been added. + + Also, if the response does have a Last-Modified time, the heuristic + expiration value SHOULD be no more than some fraction of the interval + since that time. A typical setting of this fraction might be 10%. + + The calculation to determine if a response has expired is quite + simple: + + response_is_fresh = (freshness_lifetime > current_age) + + + + + + +Fielding, et al. Standards Track [Page 83] + +RFC 2616 HTTP/1.1 June 1999 + + +13.2.5 Disambiguating Expiration Values + + Because expiration values are assigned optimistically, it is possible + for two caches to contain fresh values for the same resource that are + different. + + If a client performing a retrieval receives a non-first-hand response + for a request that was already fresh in its own cache, and the Date + header in its existing cache entry is newer than the Date on the new + response, then the client MAY ignore the response. If so, it MAY + retry the request with a "Cache-Control: max-age=0" directive (see + section 14.9), to force a check with the origin server. + + If a cache has two fresh responses for the same representation with + different validators, it MUST use the one with the more recent Date + header. This situation might arise because the cache is pooling + responses from other caches, or because a client has asked for a + reload or a revalidation of an apparently fresh cache entry. + +13.2.6 Disambiguating Multiple Responses + + Because a client might be receiving responses via multiple paths, so + that some responses flow through one set of caches and other + responses flow through a different set of caches, a client might + receive responses in an order different from that in which the origin + server sent them. We would like the client to use the most recently + generated response, even if older responses are still apparently + fresh. + + Neither the entity tag nor the expiration value can impose an + ordering on responses, since it is possible that a later response + intentionally carries an earlier expiration time. The Date values are + ordered to a granularity of one second. + + When a client tries to revalidate a cache entry, and the response it + receives contains a Date header that appears to be older than the one + for the existing entry, then the client SHOULD repeat the request + unconditionally, and include + + Cache-Control: max-age=0 + + to force any intermediate caches to validate their copies directly + with the origin server, or + + Cache-Control: no-cache + + to force any intermediate caches to obtain a new copy from the origin + server. + + + +Fielding, et al. Standards Track [Page 84] + +RFC 2616 HTTP/1.1 June 1999 + + + If the Date values are equal, then the client MAY use either response + (or MAY, if it is being extremely prudent, request a new response). + Servers MUST NOT depend on clients being able to choose + deterministically between responses generated during the same second, + if their expiration times overlap. + +13.3 Validation Model + + When a cache has a stale entry that it would like to use as a + response to a client's request, it first has to check with the origin + server (or possibly an intermediate cache with a fresh response) to + see if its cached entry is still usable. We call this "validating" + the cache entry. Since we do not want to have to pay the overhead of + retransmitting the full response if the cached entry is good, and we + do not want to pay the overhead of an extra round trip if the cached + entry is invalid, the HTTP/1.1 protocol supports the use of + conditional methods. + + The key protocol features for supporting conditional methods are + those concerned with "cache validators." When an origin server + generates a full response, it attaches some sort of validator to it, + which is kept with the cache entry. When a client (user agent or + proxy cache) makes a conditional request for a resource for which it + has a cache entry, it includes the associated validator in the + request. + + The server then checks that validator against the current validator + for the entity, and, if they match (see section 13.3.3), it responds + with a special status code (usually, 304 (Not Modified)) and no + entity-body. Otherwise, it returns a full response (including + entity-body). Thus, we avoid transmitting the full response if the + validator matches, and we avoid an extra round trip if it does not + match. + + In HTTP/1.1, a conditional request looks exactly the same as a normal + request for the same resource, except that it carries a special + header (which includes the validator) that implicitly turns the + method (usually, GET) into a conditional. + + The protocol includes both positive and negative senses of cache- + validating conditions. That is, it is possible to request either that + a method be performed if and only if a validator matches or if and + only if no validators match. + + + + + + + + +Fielding, et al. Standards Track [Page 85] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: a response that lacks a validator may still be cached, and + served from cache until it expires, unless this is explicitly + prohibited by a cache-control directive. However, a cache cannot + do a conditional retrieval if it does not have a validator for the + entity, which means it will not be refreshable after it expires. + +13.3.1 Last-Modified Dates + + The Last-Modified entity-header field value is often used as a cache + validator. In simple terms, a cache entry is considered to be valid + if the entity has not been modified since the Last-Modified value. + +13.3.2 Entity Tag Cache Validators + + The ETag response-header field value, an entity tag, provides for an + "opaque" cache validator. This might allow more reliable validation + in situations where it is inconvenient to store modification dates, + where the one-second resolution of HTTP date values is not + sufficient, or where the origin server wishes to avoid certain + paradoxes that might arise from the use of modification dates. + + Entity Tags are described in section 3.11. The headers used with + entity tags are described in sections 14.19, 14.24, 14.26 and 14.44. + +13.3.3 Weak and Strong Validators + + Since both origin servers and caches will compare two validators to + decide if they represent the same or different entities, one normally + would expect that if the entity (the entity-body or any entity- + headers) changes in any way, then the associated validator would + change as well. If this is true, then we call this validator a + "strong validator." + + However, there might be cases when a server prefers to change the + validator only on semantically significant changes, and not when + insignificant aspects of the entity change. A validator that does not + always change when the resource changes is a "weak validator." + + Entity tags are normally "strong validators," but the protocol + provides a mechanism to tag an entity tag as "weak." One can think of + a strong validator as one that changes whenever the bits of an entity + changes, while a weak value changes whenever the meaning of an entity + changes. Alternatively, one can think of a strong validator as part + of an identifier for a specific entity, while a weak validator is + part of an identifier for a set of semantically equivalent entities. + + Note: One example of a strong validator is an integer that is + incremented in stable storage every time an entity is changed. + + + +Fielding, et al. Standards Track [Page 86] + +RFC 2616 HTTP/1.1 June 1999 + + + An entity's modification time, if represented with one-second + resolution, could be a weak validator, since it is possible that + the resource might be modified twice during a single second. + + Support for weak validators is optional. However, weak validators + allow for more efficient caching of equivalent objects; for + example, a hit counter on a site is probably good enough if it is + updated every few days or weeks, and any value during that period + is likely "good enough" to be equivalent. + + A "use" of a validator is either when a client generates a request + and includes the validator in a validating header field, or when a + server compares two validators. + + Strong validators are usable in any context. Weak validators are only + usable in contexts that do not depend on exact equality of an entity. + For example, either kind is usable for a conditional GET of a full + entity. However, only a strong validator is usable for a sub-range + retrieval, since otherwise the client might end up with an internally + inconsistent entity. + + Clients MAY issue simple (non-subrange) GET requests with either weak + validators or strong validators. Clients MUST NOT use weak validators + in other forms of request. + + The only function that the HTTP/1.1 protocol defines on validators is + comparison. There are two validator comparison functions, depending + on whether the comparison context allows the use of weak validators + or not: + + - The strong comparison function: in order to be considered equal, + both validators MUST be identical in every way, and both MUST + NOT be weak. + + - The weak comparison function: in order to be considered equal, + both validators MUST be identical in every way, but either or + both of them MAY be tagged as "weak" without affecting the + result. + + An entity tag is strong unless it is explicitly tagged as weak. + Section 3.11 gives the syntax for entity tags. + + A Last-Modified time, when used as a validator in a request, is + implicitly weak unless it is possible to deduce that it is strong, + using the following rules: + + - The validator is being compared by an origin server to the + actual current validator for the entity and, + + + +Fielding, et al. Standards Track [Page 87] + +RFC 2616 HTTP/1.1 June 1999 + + + - That origin server reliably knows that the associated entity did + not change twice during the second covered by the presented + validator. + + or + + - The validator is about to be used by a client in an If- + Modified-Since or If-Unmodified-Since header, because the client + has a cache entry for the associated entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + or + + - The validator is being compared by an intermediate cache to the + validator stored in its cache entry for the entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + This method relies on the fact that if two different responses were + sent by the origin server during the same second, but both had the + same Last-Modified time, then at least one of those responses would + have a Date value equal to its Last-Modified time. The arbitrary 60- + second limit guards against the possibility that the Date and Last- + Modified values are generated from different clocks, or at somewhat + different times during the preparation of the response. An + implementation MAY use a value larger than 60 seconds, if it is + believed that 60 seconds is too short. + + If a client wishes to perform a sub-range retrieval on a value for + which it has only a Last-Modified time and no opaque validator, it + MAY do this only if the Last-Modified time is strong in the sense + described here. + + A cache or origin server receiving a conditional request, other than + a full-body GET request, MUST use the strong comparison function to + evaluate the condition. + + These rules allow HTTP/1.1 caches and clients to safely perform sub- + range retrievals on values that have been obtained from HTTP/1.0 + + + +Fielding, et al. Standards Track [Page 88] + +RFC 2616 HTTP/1.1 June 1999 + + + servers. + +13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates + + We adopt a set of rules and recommendations for origin servers, + clients, and caches regarding when various validator types ought to + be used, and for what purposes. + + HTTP/1.1 origin servers: + + - SHOULD send an entity tag validator unless it is not feasible to + generate one. + + - MAY send a weak entity tag instead of a strong entity tag, if + performance considerations support the use of weak entity tags, + or if it is unfeasible to send a strong entity tag. + + - SHOULD send a Last-Modified value if it is feasible to send one, + unless the risk of a breakdown in semantic transparency that + could result from using this date in an If-Modified-Since header + would lead to serious problems. + + In other words, the preferred behavior for an HTTP/1.1 origin server + is to send both a strong entity tag and a Last-Modified value. + + In order to be legal, a strong entity tag MUST change whenever the + associated entity value changes in any way. A weak entity tag SHOULD + change whenever the associated entity changes in a semantically + significant way. + + Note: in order to provide semantically transparent caching, an + origin server must avoid reusing a specific strong entity tag + value for two different entities, or reusing a specific weak + entity tag value for two semantically different entities. Cache + entries might persist for arbitrarily long periods, regardless of + expiration times, so it might be inappropriate to expect that a + cache will never again attempt to validate an entry using a + validator that it obtained at some point in the past. + + HTTP/1.1 clients: + + - If an entity tag has been provided by the origin server, MUST + use that entity tag in any cache-conditional request (using If- + Match or If-None-Match). + + - If only a Last-Modified value has been provided by the origin + server, SHOULD use that value in non-subrange cache-conditional + requests (using If-Modified-Since). + + + +Fielding, et al. Standards Track [Page 89] + +RFC 2616 HTTP/1.1 June 1999 + + + - If only a Last-Modified value has been provided by an HTTP/1.0 + origin server, MAY use that value in subrange cache-conditional + requests (using If-Unmodified-Since:). The user agent SHOULD + provide a way to disable this, in case of difficulty. + + - If both an entity tag and a Last-Modified value have been + provided by the origin server, SHOULD use both validators in + cache-conditional requests. This allows both HTTP/1.0 and + HTTP/1.1 caches to respond appropriately. + + An HTTP/1.1 origin server, upon receiving a conditional request that + includes both a Last-Modified date (e.g., in an If-Modified-Since or + If-Unmodified-Since header field) and one or more entity tags (e.g., + in an If-Match, If-None-Match, or If-Range header field) as cache + validators, MUST NOT return a response status of 304 (Not Modified) + unless doing so is consistent with all of the conditional header + fields in the request. + + An HTTP/1.1 caching proxy, upon receiving a conditional request that + includes both a Last-Modified date and one or more entity tags as + cache validators, MUST NOT return a locally cached response to the + client unless that cached response is consistent with all of the + conditional header fields in the request. + + Note: The general principle behind these rules is that HTTP/1.1 + servers and clients should transmit as much non-redundant + information as is available in their responses and requests. + HTTP/1.1 systems receiving this information will make the most + conservative assumptions about the validators they receive. + + HTTP/1.0 clients and caches will ignore entity tags. Generally, + last-modified values received or used by these systems will + support transparent and efficient caching, and so HTTP/1.1 origin + servers should provide Last-Modified values. In those rare cases + where the use of a Last-Modified value as a validator by an + HTTP/1.0 system could result in a serious problem, then HTTP/1.1 + origin servers should not provide one. + +13.3.5 Non-validating Conditionals + + The principle behind entity tags is that only the service author + knows the semantics of a resource well enough to select an + appropriate cache validation mechanism, and the specification of any + validator comparison function more complex than byte-equality would + open up a can of worms. Thus, comparisons of any other headers + (except Last-Modified, for compatibility with HTTP/1.0) are never + used for purposes of validating a cache entry. + + + + +Fielding, et al. Standards Track [Page 90] + +RFC 2616 HTTP/1.1 June 1999 + + +13.4 Response Cacheability + + Unless specifically constrained by a cache-control (section 14.9) + directive, a caching system MAY always store a successful response + (see section 13.8) as a cache entry, MAY return it without validation + if it is fresh, and MAY return it after successful validation. If + there is neither a cache validator nor an explicit expiration time + associated with a response, we do not expect it to be cached, but + certain caches MAY violate this expectation (for example, when little + or no network connectivity is available). A client can usually detect + that such a response was taken from a cache by comparing the Date + header to the current time. + + Note: some HTTP/1.0 caches are known to violate this expectation + without providing any Warning. + + However, in some cases it might be inappropriate for a cache to + retain an entity, or to return it in response to a subsequent + request. This might be because absolute semantic transparency is + deemed necessary by the service author, or because of security or + privacy considerations. Certain cache-control directives are + therefore provided so that the server can indicate that certain + resource entities, or portions thereof, are not to be cached + regardless of other considerations. + + Note that section 14.8 normally prevents a shared cache from saving + and returning a response to a previous request if that request + included an Authorization header. + + A response received with a status code of 200, 203, 206, 300, 301 or + 410 MAY be stored by a cache and used in reply to a subsequent + request, subject to the expiration mechanism, unless a cache-control + directive prohibits caching. However, a cache that does not support + the Range and Content-Range headers MUST NOT cache 206 (Partial + Content) responses. + + A response received with any other status code (e.g. status codes 302 + and 307) MUST NOT be returned in a reply to a subsequent request + unless there are cache-control directives or another header(s) that + explicitly allow it. For example, these include the following: an + Expires header (section 14.21); a "max-age", "s-maxage", "must- + revalidate", "proxy-revalidate", "public" or "private" cache-control + directive (section 14.9). + + + + + + + + +Fielding, et al. Standards Track [Page 91] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5 Constructing Responses From Caches + + The purpose of an HTTP cache is to store information received in + response to requests for use in responding to future requests. In + many cases, a cache simply returns the appropriate parts of a + response to the requester. However, if the cache holds a cache entry + based on a previous response, it might have to combine parts of a new + response with what is held in the cache entry. + +13.5.1 End-to-end and Hop-by-hop Headers + + For the purpose of defining the behavior of caches and non-caching + proxies, we divide HTTP headers into two categories: + + - End-to-end headers, which are transmitted to the ultimate + recipient of a request or response. End-to-end headers in + responses MUST be stored as part of a cache entry and MUST be + transmitted in any response formed from a cache entry. + + - Hop-by-hop headers, which are meaningful only for a single + transport-level connection, and are not stored by caches or + forwarded by proxies. + + The following HTTP/1.1 headers are hop-by-hop headers: + + - Connection + - Keep-Alive + - Proxy-Authenticate + - Proxy-Authorization + - TE + - Trailers + - Transfer-Encoding + - Upgrade + + All other headers defined by HTTP/1.1 are end-to-end headers. + + Other hop-by-hop headers MUST be listed in a Connection header, + (section 14.10) to be introduced into HTTP/1.1 (or later). + +13.5.2 Non-modifiable Headers + + Some features of the HTTP/1.1 protocol, such as Digest + Authentication, depend on the value of certain end-to-end headers. A + transparent proxy SHOULD NOT modify an end-to-end header unless the + definition of that header requires or specifically allows that. + + + + + + +Fielding, et al. Standards Track [Page 92] + +RFC 2616 HTTP/1.1 June 1999 + + + A transparent proxy MUST NOT modify any of the following fields in a + request or response, and it MUST NOT add any of these fields if not + already present: + + - Content-Location + + - Content-MD5 + + - ETag + + - Last-Modified + + A transparent proxy MUST NOT modify any of the following fields in a + response: + + - Expires + + but it MAY add any of these fields if not already present. If an + Expires header is added, it MUST be given a field-value identical to + that of the Date header in that response. + + A proxy MUST NOT modify or add any of the following fields in a + message that contains the no-transform cache-control directive, or in + any request: + + - Content-Encoding + + - Content-Range + + - Content-Type + + A non-transparent proxy MAY modify or add these fields to a message + that does not include no-transform, but if it does so, it MUST add a + Warning 214 (Transformation applied) if one does not already appear + in the message (see section 14.46). + + Warning: unnecessary modification of end-to-end headers might + cause authentication failures if stronger authentication + mechanisms are introduced in later versions of HTTP. Such + authentication mechanisms MAY rely on the values of header fields + not listed here. + + The Content-Length field of a request or response is added or deleted + according to the rules in section 4.4. A transparent proxy MUST + preserve the entity-length (section 7.2.2) of the entity-body, + although it MAY change the transfer-length (section 4.4). + + + + + +Fielding, et al. Standards Track [Page 93] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.3 Combining Headers + + When a cache makes a validating request to a server, and the server + provides a 304 (Not Modified) response or a 206 (Partial Content) + response, the cache then constructs a response to send to the + requesting client. + + If the status code is 304 (Not Modified), the cache uses the entity- + body stored in the cache entry as the entity-body of this outgoing + response. If the status code is 206 (Partial Content) and the ETag or + Last-Modified headers match exactly, the cache MAY combine the + contents stored in the cache entry with the new contents received in + the response and use the result as the entity-body of this outgoing + response, (see 13.5.4). + + The end-to-end headers stored in the cache entry are used for the + constructed response, except that + + - any stored Warning headers with warn-code 1xx (see section + 14.46) MUST be deleted from the cache entry and the forwarded + response. + + - any stored Warning headers with warn-code 2xx MUST be retained + in the cache entry and the forwarded response. + + - any end-to-end headers provided in the 304 or 206 response MUST + replace the corresponding headers from the cache entry. + + Unless the cache decides to remove the cache entry, it MUST also + replace the end-to-end headers stored with the cache entry with + corresponding headers received in the incoming response, except for + Warning headers as described immediately above. If a header field- + name in the incoming response matches more than one header in the + cache entry, all such old headers MUST be replaced. + + In other words, the set of end-to-end headers received in the + incoming response overrides all corresponding end-to-end headers + stored with the cache entry (except for stored Warning headers with + warn-code 1xx, which are deleted even if not overridden). + + Note: this rule allows an origin server to use a 304 (Not + Modified) or a 206 (Partial Content) response to update any header + associated with a previous response for the same entity or sub- + ranges thereof, although it might not always be meaningful or + correct to do so. This rule does not allow an origin server to use + a 304 (Not Modified) or a 206 (Partial Content) response to + entirely delete a header that it had provided with a previous + response. + + + +Fielding, et al. Standards Track [Page 94] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.4 Combining Byte Ranges + + A response might transfer only a subrange of the bytes of an entity- + body, either because the request included one or more Range + specifications, or because a connection was broken prematurely. After + several such transfers, a cache might have received several ranges of + the same entity-body. + + If a cache has a stored non-empty set of subranges for an entity, and + an incoming response transfers another subrange, the cache MAY + combine the new subrange with the existing set if both the following + conditions are met: + + - Both the incoming response and the cache entry have a cache + validator. + + - The two cache validators match using the strong comparison + function (see section 13.3.3). + + If either requirement is not met, the cache MUST use only the most + recent partial response (based on the Date values transmitted with + every response, and using the incoming response if these values are + equal or missing), and MUST discard the other partial information. + +13.6 Caching Negotiated Responses + + Use of server-driven content negotiation (section 12.1), as indicated + by the presence of a Vary header field in a response, alters the + conditions and procedure by which a cache can use the response for + subsequent requests. See section 14.44 for use of the Vary header + field by servers. + + A server SHOULD use the Vary header field to inform a cache of what + request-header fields were used to select among multiple + representations of a cacheable response subject to server-driven + negotiation. The set of header fields named by the Vary field value + is known as the "selecting" request-headers. + + When the cache receives a subsequent request whose Request-URI + specifies one or more cache entries including a Vary header field, + the cache MUST NOT use such a cache entry to construct a response to + the new request unless all of the selecting request-headers present + in the new request match the corresponding stored request-headers in + the original request. + + The selecting request-headers from two requests are defined to match + if and only if the selecting request-headers in the first request can + be transformed to the selecting request-headers in the second request + + + +Fielding, et al. Standards Track [Page 95] + +RFC 2616 HTTP/1.1 June 1999 + + + by adding or removing linear white space (LWS) at places where this + is allowed by the corresponding BNF, and/or combining multiple + message-header fields with the same field name following the rules + about message headers in section 4.2. + + A Vary header field-value of "*" always fails to match and subsequent + requests on that resource can only be properly interpreted by the + origin server. + + If the selecting request header fields for the cached entry do not + match the selecting request header fields of the new request, then + the cache MUST NOT use a cached entry to satisfy the request unless + it first relays the new request to the origin server in a conditional + request and the server responds with 304 (Not Modified), including an + entity tag or Content-Location that indicates the entity to be used. + + If an entity tag was assigned to a cached representation, the + forwarded request SHOULD be conditional and include the entity tags + in an If-None-Match header field from all its cache entries for the + resource. This conveys to the server the set of entities currently + held by the cache, so that if any one of these entities matches the + requested entity, the server can use the ETag header field in its 304 + (Not Modified) response to tell the cache which entry is appropriate. + If the entity-tag of the new response matches that of an existing + entry, the new response SHOULD be used to update the header fields of + the existing entry, and the result MUST be returned to the client. + + If any of the existing cache entries contains only partial content + for the associated entity, its entity-tag SHOULD NOT be included in + the If-None-Match header field unless the request is for a range that + would be fully satisfied by that entry. + + If a cache receives a successful response whose Content-Location + field matches that of an existing cache entry for the same Request- + ]URI, whose entity-tag differs from that of the existing entry, and + whose Date is more recent than that of the existing entry, the + existing entry SHOULD NOT be returned in response to future requests + and SHOULD be deleted from the cache. + +13.7 Shared and Non-Shared Caches + + For reasons of security and privacy, it is necessary to make a + distinction between "shared" and "non-shared" caches. A non-shared + cache is one that is accessible only to a single user. Accessibility + in this case SHOULD be enforced by appropriate security mechanisms. + All other caches are considered to be "shared." Other sections of + + + + + +Fielding, et al. Standards Track [Page 96] + +RFC 2616 HTTP/1.1 June 1999 + + + this specification place certain constraints on the operation of + shared caches in order to prevent loss of privacy or failure of + access controls. + +13.8 Errors or Incomplete Response Cache Behavior + + A cache that receives an incomplete response (for example, with fewer + bytes of data than specified in a Content-Length header) MAY store + the response. However, the cache MUST treat this as a partial + response. Partial responses MAY be combined as described in section + 13.5.4; the result might be a full response or might still be + partial. A cache MUST NOT return a partial response to a client + without explicitly marking it as such, using the 206 (Partial + Content) status code. A cache MUST NOT return a partial response + using a status code of 200 (OK). + + If a cache receives a 5xx response while attempting to revalidate an + entry, it MAY either forward this response to the requesting client, + or act as if the server failed to respond. In the latter case, it MAY + return a previously received response unless the cached entry + includes the "must-revalidate" cache-control directive (see section + 14.9). + +13.9 Side Effects of GET and HEAD + + Unless the origin server explicitly prohibits the caching of their + responses, the application of GET and HEAD methods to any resources + SHOULD NOT have side effects that would lead to erroneous behavior if + these responses are taken from a cache. They MAY still have side + effects, but a cache is not required to consider such side effects in + its caching decisions. Caches are always expected to observe an + origin server's explicit restrictions on caching. + + We note one exception to this rule: since some applications have + traditionally used GETs and HEADs with query URLs (those containing a + "?" in the rel_path part) to perform operations with significant side + effects, caches MUST NOT treat responses to such URIs as fresh unless + the server provides an explicit expiration time. This specifically + means that responses from HTTP/1.0 servers for such URIs SHOULD NOT + be taken from a cache. See section 9.1.1 for related information. + +13.10 Invalidation After Updates or Deletions + + The effect of certain methods performed on a resource at the origin + server might cause one or more existing cache entries to become non- + transparently invalid. That is, although they might continue to be + "fresh," they do not accurately reflect what the origin server would + return for a new request on that resource. + + + +Fielding, et al. Standards Track [Page 97] + +RFC 2616 HTTP/1.1 June 1999 + + + There is no way for the HTTP protocol to guarantee that all such + cache entries are marked invalid. For example, the request that + caused the change at the origin server might not have gone through + the proxy where a cache entry is stored. However, several rules help + reduce the likelihood of erroneous behavior. + + In this section, the phrase "invalidate an entity" means that the + cache will either remove all instances of that entity from its + storage, or will mark these as "invalid" and in need of a mandatory + revalidation before they can be returned in response to a subsequent + request. + + Some HTTP methods MUST cause a cache to invalidate an entity. This is + either the entity referred to by the Request-URI, or by the Location + or Content-Location headers (if present). These methods are: + + - PUT + + - DELETE + + - POST + + In order to prevent denial of service attacks, an invalidation based + on the URI in a Location or Content-Location header MUST only be + performed if the host part is the same as in the Request-URI. + + A cache that passes through requests for methods it does not + understand SHOULD invalidate any entities referred to by the + Request-URI. + +13.11 Write-Through Mandatory + + All methods that might be expected to cause modifications to the + origin server's resources MUST be written through to the origin + server. This currently includes all methods except for GET and HEAD. + A cache MUST NOT reply to such a request from a client before having + transmitted the request to the inbound server, and having received a + corresponding response from the inbound server. This does not prevent + a proxy cache from sending a 100 (Continue) response before the + inbound server has sent its final reply. + + The alternative (known as "write-back" or "copy-back" caching) is not + allowed in HTTP/1.1, due to the difficulty of providing consistent + updates and the problems arising from server, cache, or network + failure prior to write-back. + + + + + + +Fielding, et al. Standards Track [Page 98] + +RFC 2616 HTTP/1.1 June 1999 + + +13.12 Cache Replacement + + If a new cacheable (see sections 14.9.2, 13.2.5, 13.2.6 and 13.8) + response is received from a resource while any existing responses for + the same resource are cached, the cache SHOULD use the new response + to reply to the current request. It MAY insert it into cache storage + and MAY, if it meets all other requirements, use it to respond to any + future requests that would previously have caused the old response to + be returned. If it inserts the new response into cache storage the + rules in section 13.5.3 apply. + + Note: a new response that has an older Date header value than + existing cached responses is not cacheable. + +13.13 History Lists + + User agents often have history mechanisms, such as "Back" buttons and + history lists, which can be used to redisplay an entity retrieved + earlier in a session. + + History mechanisms and caches are different. In particular history + mechanisms SHOULD NOT try to show a semantically transparent view of + the current state of a resource. Rather, a history mechanism is meant + to show exactly what the user saw at the time when the resource was + retrieved. + + By default, an expiration time does not apply to history mechanisms. + If the entity is still in storage, a history mechanism SHOULD display + it even if the entity has expired, unless the user has specifically + configured the agent to refresh expired history documents. + + This is not to be construed to prohibit the history mechanism from + telling the user that a view might be stale. + + Note: if history list mechanisms unnecessarily prevent users from + viewing stale resources, this will tend to force service authors + to avoid using HTTP expiration controls and cache controls when + they would otherwise like to. Service authors may consider it + important that users not be presented with error messages or + warning messages when they use navigation controls (such as BACK) + to view previously fetched resources. Even though sometimes such + resources ought not to cached, or ought to expire quickly, user + interface considerations may force service authors to resort to + other means of preventing caching (e.g. "once-only" URLs) in order + not to suffer the effects of improperly functioning history + mechanisms. + + + + + +Fielding, et al. Standards Track [Page 99] + +RFC 2616 HTTP/1.1 June 1999 + + +14 Header Field Definitions + + This section defines the syntax and semantics of all standard + HTTP/1.1 header fields. For entity-header fields, both sender and + recipient refer to either the client or the server, depending on who + sends and who receives the entity. + +14.1 Accept + + The Accept request-header field can be used to specify certain media + types which are acceptable for the response. Accept headers can be + used to indicate that the request is specifically limited to a small + set of desired types, as in the case of a request for an in-line + image. + + Accept = "Accept" ":" + #( media-range [ accept-params ] ) + + media-range = ( "*/*" + | ( type "/" "*" ) + | ( type "/" subtype ) + ) *( ";" parameter ) + accept-params = ";" "q" "=" qvalue *( accept-extension ) + accept-extension = ";" token [ "=" ( token | quoted-string ) ] + + The asterisk "*" character is used to group media types into ranges, + with "*/*" indicating all media types and "type/*" indicating all + subtypes of that type. The media-range MAY include media type + parameters that are applicable to that range. + + Each media-range MAY be followed by one or more accept-params, + beginning with the "q" parameter for indicating a relative quality + factor. The first "q" parameter (if any) separates the media-range + parameter(s) from the accept-params. Quality factors allow the user + or user agent to indicate the relative degree of preference for that + media-range, using the qvalue scale from 0 to 1 (section 3.9). The + default value is q=1. + + Note: Use of the "q" parameter name to separate media type + parameters from Accept extension parameters is due to historical + practice. Although this prevents any media type parameter named + "q" from being used with a media range, such an event is believed + to be unlikely given the lack of any "q" parameters in the IANA + media type registry and the rare usage of any media type + parameters in Accept. Future media types are discouraged from + registering any parameter named "q". + + + + + +Fielding, et al. Standards Track [Page 100] + +RFC 2616 HTTP/1.1 June 1999 + + + The example + + Accept: audio/*; q=0.2, audio/basic + + SHOULD be interpreted as "I prefer audio/basic, but send me any audio + type if it is the best available after an 80% mark-down in quality." + + If no Accept header field is present, then it is assumed that the + client accepts all media types. If an Accept header field is present, + and if the server cannot send a response which is acceptable + according to the combined Accept field value, then the server SHOULD + send a 406 (not acceptable) response. + + A more elaborate example is + + Accept: text/plain; q=0.5, text/html, + text/x-dvi; q=0.8, text/x-c + + Verbally, this would be interpreted as "text/html and text/x-c are + the preferred media types, but if they do not exist, then send the + text/x-dvi entity, and if that does not exist, send the text/plain + entity." + + Media ranges can be overridden by more specific media ranges or + specific media types. If more than one media range applies to a given + type, the most specific reference has precedence. For example, + + Accept: text/*, text/html, text/html;level=1, */* + + have the following precedence: + + 1) text/html;level=1 + 2) text/html + 3) text/* + 4) */* + + The media type quality factor associated with a given type is + determined by finding the media range with the highest precedence + which matches that type. For example, + + Accept: text/*;q=0.3, text/html;q=0.7, text/html;level=1, + text/html;level=2;q=0.4, */*;q=0.5 + + would cause the following values to be associated: + + text/html;level=1 = 1 + text/html = 0.7 + text/plain = 0.3 + + + +Fielding, et al. Standards Track [Page 101] + +RFC 2616 HTTP/1.1 June 1999 + + + image/jpeg = 0.5 + text/html;level=2 = 0.4 + text/html;level=3 = 0.7 + + Note: A user agent might be provided with a default set of quality + values for certain media ranges. However, unless the user agent is + a closed system which cannot interact with other rendering agents, + this default set ought to be configurable by the user. + +14.2 Accept-Charset + + The Accept-Charset request-header field can be used to indicate what + character sets are acceptable for the response. This field allows + clients capable of understanding more comprehensive or special- + purpose character sets to signal that capability to a server which is + capable of representing documents in those character sets. + + Accept-Charset = "Accept-Charset" ":" + 1#( ( charset | "*" )[ ";" "q" "=" qvalue ] ) + + + Character set values are described in section 3.4. Each charset MAY + be given an associated quality value which represents the user's + preference for that charset. The default value is q=1. An example is + + Accept-Charset: iso-8859-5, unicode-1-1;q=0.8 + + The special value "*", if present in the Accept-Charset field, + matches every character set (including ISO-8859-1) which is not + mentioned elsewhere in the Accept-Charset field. If no "*" is present + in an Accept-Charset field, then all character sets not explicitly + mentioned get a quality value of 0, except for ISO-8859-1, which gets + a quality value of 1 if not explicitly mentioned. + + If no Accept-Charset header is present, the default is that any + character set is acceptable. If an Accept-Charset header is present, + and if the server cannot send a response which is acceptable + according to the Accept-Charset header, then the server SHOULD send + an error response with the 406 (not acceptable) status code, though + the sending of an unacceptable response is also allowed. + +14.3 Accept-Encoding + + The Accept-Encoding request-header field is similar to Accept, but + restricts the content-codings (section 3.5) that are acceptable in + the response. + + Accept-Encoding = "Accept-Encoding" ":" + + + +Fielding, et al. Standards Track [Page 102] + +RFC 2616 HTTP/1.1 June 1999 + + + 1#( codings [ ";" "q" "=" qvalue ] ) + codings = ( content-coding | "*" ) + + Examples of its use are: + + Accept-Encoding: compress, gzip + Accept-Encoding: + Accept-Encoding: * + Accept-Encoding: compress;q=0.5, gzip;q=1.0 + Accept-Encoding: gzip;q=1.0, identity; q=0.5, *;q=0 + + A server tests whether a content-coding is acceptable, according to + an Accept-Encoding field, using these rules: + + 1. If the content-coding is one of the content-codings listed in + the Accept-Encoding field, then it is acceptable, unless it is + accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + 2. The special "*" symbol in an Accept-Encoding field matches any + available content-coding not explicitly listed in the header + field. + + 3. If multiple content-codings are acceptable, then the acceptable + content-coding with the highest non-zero qvalue is preferred. + + 4. The "identity" content-coding is always acceptable, unless + specifically refused because the Accept-Encoding field includes + "identity;q=0", or because the field includes "*;q=0" and does + not explicitly include the "identity" content-coding. If the + Accept-Encoding field-value is empty, then only the "identity" + encoding is acceptable. + + If an Accept-Encoding field is present in a request, and if the + server cannot send a response which is acceptable according to the + Accept-Encoding header, then the server SHOULD send an error response + with the 406 (Not Acceptable) status code. + + If no Accept-Encoding field is present in a request, the server MAY + assume that the client will accept any content coding. In this case, + if "identity" is one of the available content-codings, then the + server SHOULD use the "identity" content-coding, unless it has + additional information that a different content-coding is meaningful + to the client. + + Note: If the request does not include an Accept-Encoding field, + and if the "identity" content-coding is unavailable, then + content-codings commonly understood by HTTP/1.0 clients (i.e., + + + +Fielding, et al. Standards Track [Page 103] + +RFC 2616 HTTP/1.1 June 1999 + + + "gzip" and "compress") are preferred; some older clients + improperly display messages sent with other content-codings. The + server might also make this decision based on information about + the particular user-agent or client. + + Note: Most HTTP/1.0 applications do not recognize or obey qvalues + associated with content-codings. This means that qvalues will not + work and are not permitted with x-gzip or x-compress. + +14.4 Accept-Language + + The Accept-Language request-header field is similar to Accept, but + restricts the set of natural languages that are preferred as a + response to the request. Language tags are defined in section 3.10. + + Accept-Language = "Accept-Language" ":" + 1#( language-range [ ";" "q" "=" qvalue ] ) + language-range = ( ( 1*8ALPHA *( "-" 1*8ALPHA ) ) | "*" ) + + Each language-range MAY be given an associated quality value which + represents an estimate of the user's preference for the languages + specified by that range. The quality value defaults to "q=1". For + example, + + Accept-Language: da, en-gb;q=0.8, en;q=0.7 + + would mean: "I prefer Danish, but will accept British English and + other types of English." A language-range matches a language-tag if + it exactly equals the tag, or if it exactly equals a prefix of the + tag such that the first tag character following the prefix is "-". + The special range "*", if present in the Accept-Language field, + matches every tag not matched by any other range present in the + Accept-Language field. + + Note: This use of a prefix matching rule does not imply that + language tags are assigned to languages in such a way that it is + always true that if a user understands a language with a certain + tag, then this user will also understand all languages with tags + for which this tag is a prefix. The prefix rule simply allows the + use of prefix tags if this is the case. + + The language quality factor assigned to a language-tag by the + Accept-Language field is the quality value of the longest language- + range in the field that matches the language-tag. If no language- + range in the field matches the tag, the language quality factor + assigned is 0. If no Accept-Language header is present in the + request, the server + + + + +Fielding, et al. Standards Track [Page 104] + +RFC 2616 HTTP/1.1 June 1999 + + + SHOULD assume that all languages are equally acceptable. If an + Accept-Language header is present, then all languages which are + assigned a quality factor greater than 0 are acceptable. + + It might be contrary to the privacy expectations of the user to send + an Accept-Language header with the complete linguistic preferences of + the user in every request. For a discussion of this issue, see + section 15.1.4. + + As intelligibility is highly dependent on the individual user, it is + recommended that client applications make the choice of linguistic + preference available to the user. If the choice is not made + available, then the Accept-Language header field MUST NOT be given in + the request. + + Note: When making the choice of linguistic preference available to + the user, we remind implementors of the fact that users are not + familiar with the details of language matching as described above, + and should provide appropriate guidance. As an example, users + might assume that on selecting "en-gb", they will be served any + kind of English document if British English is not available. A + user agent might suggest in such a case to add "en" to get the + best matching behavior. + +14.5 Accept-Ranges + + The Accept-Ranges response-header field allows the server to + indicate its acceptance of range requests for a resource: + + Accept-Ranges = "Accept-Ranges" ":" acceptable-ranges + acceptable-ranges = 1#range-unit | "none" + + Origin servers that accept byte-range requests MAY send + + Accept-Ranges: bytes + + but are not required to do so. Clients MAY generate byte-range + requests without having received this header for the resource + involved. Range units are defined in section 3.12. + + Servers that do not accept any kind of range request for a + resource MAY send + + Accept-Ranges: none + + to advise the client not to attempt a range request. + + + + + +Fielding, et al. Standards Track [Page 105] + +RFC 2616 HTTP/1.1 June 1999 + + +14.6 Age + + The Age response-header field conveys the sender's estimate of the + amount of time since the response (or its revalidation) was + generated at the origin server. A cached response is "fresh" if + its age does not exceed its freshness lifetime. Age values are + calculated as specified in section 13.2.3. + + Age = "Age" ":" age-value + age-value = delta-seconds + + Age values are non-negative decimal integers, representing time in + seconds. + + If a cache receives a value larger than the largest positive + integer it can represent, or if any of its age calculations + overflows, it MUST transmit an Age header with a value of + 2147483648 (2^31). An HTTP/1.1 server that includes a cache MUST + include an Age header field in every response generated from its + own cache. Caches SHOULD use an arithmetic type of at least 31 + bits of range. + +14.7 Allow + + The Allow entity-header field lists the set of methods supported + by the resource identified by the Request-URI. The purpose of this + field is strictly to inform the recipient of valid methods + associated with the resource. An Allow header field MUST be + present in a 405 (Method Not Allowed) response. + + Allow = "Allow" ":" #Method + + Example of use: + + Allow: GET, HEAD, PUT + + This field cannot prevent a client from trying other methods. + However, the indications given by the Allow header field value + SHOULD be followed. The actual set of allowed methods is defined + by the origin server at the time of each request. + + The Allow header field MAY be provided with a PUT request to + recommend the methods to be supported by the new or modified + resource. The server is not required to support these methods and + SHOULD include an Allow header in the response giving the actual + supported methods. + + + + + +Fielding, et al. Standards Track [Page 106] + +RFC 2616 HTTP/1.1 June 1999 + + + A proxy MUST NOT modify the Allow header field even if it does not + understand all the methods specified, since the user agent might + have other means of communicating with the origin server. + +14.8 Authorization + + A user agent that wishes to authenticate itself with a server-- + usually, but not necessarily, after receiving a 401 response--does + so by including an Authorization request-header field with the + request. The Authorization field value consists of credentials + containing the authentication information of the user agent for + the realm of the resource being requested. + + Authorization = "Authorization" ":" credentials + + HTTP access authentication is described in "HTTP Authentication: + Basic and Digest Access Authentication" [43]. If a request is + authenticated and a realm specified, the same credentials SHOULD + be valid for all other requests within this realm (assuming that + the authentication scheme itself does not require otherwise, such + as credentials that vary according to a challenge value or using + synchronized clocks). + + When a shared cache (see section 13.7) receives a request + containing an Authorization field, it MUST NOT return the + corresponding response as a reply to any other request, unless one + of the following specific exceptions holds: + + 1. If the response includes the "s-maxage" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But (if the specified maximum age has + passed) a proxy cache MUST first revalidate it with the origin + server, using the request-headers from the new request to allow + the origin server to authenticate the new request. (This is the + defined behavior for s-maxage.) If the response includes "s- + maxage=0", the proxy MUST always revalidate it before re-using + it. + + 2. If the response includes the "must-revalidate" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But if the response is stale, all caches + MUST first revalidate it with the origin server, using the + request-headers from the new request to allow the origin server + to authenticate the new request. + + 3. If the response includes the "public" cache-control directive, + it MAY be returned in reply to any subsequent request. + + + + +Fielding, et al. Standards Track [Page 107] + +RFC 2616 HTTP/1.1 June 1999 + + +14.9 Cache-Control + + The Cache-Control general-header field is used to specify directives + that MUST be obeyed by all caching mechanisms along the + request/response chain. The directives specify behavior intended to + prevent caches from adversely interfering with the request or + response. These directives typically override the default caching + algorithms. Cache directives are unidirectional in that the presence + of a directive in a request does not imply that the same directive is + to be given in the response. + + Note that HTTP/1.0 caches might not implement Cache-Control and + might only implement Pragma: no-cache (see section 14.32). + + Cache directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a cache- + directive for a specific cache. + + Cache-Control = "Cache-Control" ":" 1#cache-directive + + cache-directive = cache-request-directive + | cache-response-directive + + cache-request-directive = + "no-cache" ; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "max-age" "=" delta-seconds ; Section 14.9.3, 14.9.4 + | "max-stale" [ "=" delta-seconds ] ; Section 14.9.3 + | "min-fresh" "=" delta-seconds ; Section 14.9.3 + | "no-transform" ; Section 14.9.5 + | "only-if-cached" ; Section 14.9.4 + | cache-extension ; Section 14.9.6 + + cache-response-directive = + "public" ; Section 14.9.1 + | "private" [ "=" <"> 1#field-name <"> ] ; Section 14.9.1 + | "no-cache" [ "=" <"> 1#field-name <"> ]; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "no-transform" ; Section 14.9.5 + | "must-revalidate" ; Section 14.9.4 + | "proxy-revalidate" ; Section 14.9.4 + | "max-age" "=" delta-seconds ; Section 14.9.3 + | "s-maxage" "=" delta-seconds ; Section 14.9.3 + | cache-extension ; Section 14.9.6 + + cache-extension = token [ "=" ( token | quoted-string ) ] + + + +Fielding, et al. Standards Track [Page 108] + +RFC 2616 HTTP/1.1 June 1999 + + + When a directive appears without any 1#field-name parameter, the + directive applies to the entire request or response. When such a + directive appears with a 1#field-name parameter, it applies only to + the named field or fields, and not to the rest of the request or + response. This mechanism supports extensibility; implementations of + future versions of the HTTP protocol might apply these directives to + header fields not defined in HTTP/1.1. + + The cache-control directives can be broken down into these general + categories: + + - Restrictions on what are cacheable; these may only be imposed by + the origin server. + + - Restrictions on what may be stored by a cache; these may be + imposed by either the origin server or the user agent. + + - Modifications of the basic expiration mechanism; these may be + imposed by either the origin server or the user agent. + + - Controls over cache revalidation and reload; these may only be + imposed by a user agent. + + - Control over transformation of entities. + + - Extensions to the caching system. + +14.9.1 What is Cacheable + + By default, a response is cacheable if the requirements of the + request method, request header fields, and the response status + indicate that it is cacheable. Section 13.4 summarizes these defaults + for cacheability. The following Cache-Control response directives + allow an origin server to override the default cacheability of a + response: + + public + Indicates that the response MAY be cached by any cache, even if it + would normally be non-cacheable or cacheable only within a non- + shared cache. (See also Authorization, section 14.8, for + additional details.) + + private + Indicates that all or part of the response message is intended for + a single user and MUST NOT be cached by a shared cache. This + allows an origin server to state that the specified parts of the + + + + + +Fielding, et al. Standards Track [Page 109] + +RFC 2616 HTTP/1.1 June 1999 + + + response are intended for only one user and are not a valid + response for requests by other users. A private (non-shared) cache + MAY cache the response. + + Note: This usage of the word private only controls where the + response may be cached, and cannot ensure the privacy of the + message content. + + no-cache + If the no-cache directive does not specify a field-name, then a + cache MUST NOT use the response to satisfy a subsequent request + without successful revalidation with the origin server. This + allows an origin server to prevent caching even by caches that + have been configured to return stale responses to client requests. + + If the no-cache directive does specify one or more field-names, + then a cache MAY use the response to satisfy a subsequent request, + subject to any other restrictions on caching. However, the + specified field-name(s) MUST NOT be sent in the response to a + subsequent request without successful revalidation with the origin + server. This allows an origin server to prevent the re-use of + certain header fields in a response, while still allowing caching + of the rest of the response. + + Note: Most HTTP/1.0 caches will not recognize or obey this + directive. + +14.9.2 What May be Stored by Caches + + no-store + The purpose of the no-store directive is to prevent the + inadvertent release or retention of sensitive information (for + example, on backup tapes). The no-store directive applies to the + entire message, and MAY be sent either in a response or in a + request. If sent in a request, a cache MUST NOT store any part of + either this request or any response to it. If sent in a response, + a cache MUST NOT store any part of either this response or the + request that elicited it. This directive applies to both non- + shared and shared caches. "MUST NOT store" in this context means + that the cache MUST NOT intentionally store the information in + non-volatile storage, and MUST make a best-effort attempt to + remove the information from volatile storage as promptly as + possible after forwarding it. + + Even when this directive is associated with a response, users + might explicitly store such a response outside of the caching + system (e.g., with a "Save As" dialog). History buffers MAY store + such responses as part of their normal operation. + + + +Fielding, et al. Standards Track [Page 110] + +RFC 2616 HTTP/1.1 June 1999 + + + The purpose of this directive is to meet the stated requirements + of certain users and service authors who are concerned about + accidental releases of information via unanticipated accesses to + cache data structures. While the use of this directive might + improve privacy in some cases, we caution that it is NOT in any + way a reliable or sufficient mechanism for ensuring privacy. In + particular, malicious or compromised caches might not recognize or + obey this directive, and communications networks might be + vulnerable to eavesdropping. + +14.9.3 Modifications of the Basic Expiration Mechanism + + The expiration time of an entity MAY be specified by the origin + server using the Expires header (see section 14.21). Alternatively, + it MAY be specified using the max-age directive in a response. When + the max-age cache-control directive is present in a cached response, + the response is stale if its current age is greater than the age + value given (in seconds) at the time of a new request for that + resource. The max-age directive on a response implies that the + response is cacheable (i.e., "public") unless some other, more + restrictive cache directive is also present. + + If a response includes both an Expires header and a max-age + directive, the max-age directive overrides the Expires header, even + if the Expires header is more restrictive. This rule allows an origin + server to provide, for a given response, a longer expiration time to + an HTTP/1.1 (or later) cache than to an HTTP/1.0 cache. This might be + useful if certain HTTP/1.0 caches improperly calculate ages or + expiration times, perhaps due to desynchronized clocks. + + Many HTTP/1.0 cache implementations will treat an Expires value that + is less than or equal to the response Date value as being equivalent + to the Cache-Control response directive "no-cache". If an HTTP/1.1 + cache receives such a response, and the response does not include a + Cache-Control header field, it SHOULD consider the response to be + non-cacheable in order to retain compatibility with HTTP/1.0 servers. + + Note: An origin server might wish to use a relatively new HTTP + cache control feature, such as the "private" directive, on a + network including older caches that do not understand that + feature. The origin server will need to combine the new feature + with an Expires field whose value is less than or equal to the + Date value. This will prevent older caches from improperly + caching the response. + + + + + + + +Fielding, et al. Standards Track [Page 111] + +RFC 2616 HTTP/1.1 June 1999 + + + s-maxage + If a response includes an s-maxage directive, then for a shared + cache (but not for a private cache), the maximum age specified by + this directive overrides the maximum age specified by either the + max-age directive or the Expires header. The s-maxage directive + also implies the semantics of the proxy-revalidate directive (see + section 14.9.4), i.e., that the shared cache must not use the + entry after it becomes stale to respond to a subsequent request + without first revalidating it with the origin server. The s- + maxage directive is always ignored by a private cache. + + Note that most older caches, not compliant with this specification, + do not implement any cache-control directives. An origin server + wishing to use a cache-control directive that restricts, but does not + prevent, caching by an HTTP/1.1-compliant cache MAY exploit the + requirement that the max-age directive overrides the Expires header, + and the fact that pre-HTTP/1.1-compliant caches do not observe the + max-age directive. + + Other directives allow a user agent to modify the basic expiration + mechanism. These directives MAY be specified on a request: + + max-age + Indicates that the client is willing to accept a response whose + age is no greater than the specified time in seconds. Unless max- + stale directive is also included, the client is not willing to + accept a stale response. + + min-fresh + Indicates that the client is willing to accept a response whose + freshness lifetime is no less than its current age plus the + specified time in seconds. That is, the client wants a response + that will still be fresh for at least the specified number of + seconds. + + max-stale + Indicates that the client is willing to accept a response that has + exceeded its expiration time. If max-stale is assigned a value, + then the client is willing to accept a response that has exceeded + its expiration time by no more than the specified number of + seconds. If no value is assigned to max-stale, then the client is + willing to accept a stale response of any age. + + If a cache returns a stale response, either because of a max-stale + directive on a request, or because the cache is configured to + override the expiration time of a response, the cache MUST attach a + Warning header to the stale response, using Warning 110 (Response is + stale). + + + +Fielding, et al. Standards Track [Page 112] + +RFC 2616 HTTP/1.1 June 1999 + + + A cache MAY be configured to return stale responses without + validation, but only if this does not conflict with any "MUST"-level + requirements concerning cache validation (e.g., a "must-revalidate" + cache-control directive). + + If both the new request and the cached entry include "max-age" + directives, then the lesser of the two values is used for determining + the freshness of the cached entry for that request. + +14.9.4 Cache Revalidation and Reload Controls + + Sometimes a user agent might want or need to insist that a cache + revalidate its cache entry with the origin server (and not just with + the next cache along the path to the origin server), or to reload its + cache entry from the origin server. End-to-end revalidation might be + necessary if either the cache or the origin server has overestimated + the expiration time of the cached response. End-to-end reload may be + necessary if the cache entry has become corrupted for some reason. + + End-to-end revalidation may be requested either when the client does + not have its own local cached copy, in which case we call it + "unspecified end-to-end revalidation", or when the client does have a + local cached copy, in which case we call it "specific end-to-end + revalidation." + + The client can specify these three kinds of action using Cache- + Control request directives: + + End-to-end reload + The request includes a "no-cache" cache-control directive or, for + compatibility with HTTP/1.0 clients, "Pragma: no-cache". Field + names MUST NOT be included with the no-cache directive in a + request. The server MUST NOT use a cached copy when responding to + such a request. + + Specific end-to-end revalidation + The request includes a "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request includes a cache-validating conditional with + the client's current validator. + + Unspecified end-to-end revalidation + The request includes "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request does not include a cache-validating + + + + +Fielding, et al. Standards Track [Page 113] + +RFC 2616 HTTP/1.1 June 1999 + + + conditional; the first cache along the path (if any) that holds a + cache entry for this resource includes a cache-validating + conditional with its current validator. + + max-age + When an intermediate cache is forced, by means of a max-age=0 + directive, to revalidate its own cache entry, and the client has + supplied its own validator in the request, the supplied validator + might differ from the validator currently stored with the cache + entry. In this case, the cache MAY use either validator in making + its own request without affecting semantic transparency. + + However, the choice of validator might affect performance. The + best approach is for the intermediate cache to use its own + validator when making its request. If the server replies with 304 + (Not Modified), then the cache can return its now validated copy + to the client with a 200 (OK) response. If the server replies with + a new entity and cache validator, however, the intermediate cache + can compare the returned validator with the one provided in the + client's request, using the strong comparison function. If the + client's validator is equal to the origin server's, then the + intermediate cache simply returns 304 (Not Modified). Otherwise, + it returns the new entity with a 200 (OK) response. + + If a request includes the no-cache directive, it SHOULD NOT + include min-fresh, max-stale, or max-age. + + only-if-cached + In some cases, such as times of extremely poor network + connectivity, a client may want a cache to return only those + responses that it currently has stored, and not to reload or + revalidate with the origin server. To do this, the client may + include the only-if-cached directive in a request. If it receives + this directive, a cache SHOULD either respond using a cached entry + that is consistent with the other constraints of the request, or + respond with a 504 (Gateway Timeout) status. However, if a group + of caches is being operated as a unified system with good internal + connectivity, such a request MAY be forwarded within that group of + caches. + + must-revalidate + Because a cache MAY be configured to ignore a server's specified + expiration time, and because a client request MAY include a max- + stale directive (which has a similar effect), the protocol also + includes a mechanism for the origin server to require revalidation + of a cache entry on any subsequent use. When the must-revalidate + directive is present in a response received by a cache, that cache + MUST NOT use the entry after it becomes stale to respond to a + + + +Fielding, et al. Standards Track [Page 114] + +RFC 2616 HTTP/1.1 June 1999 + + + subsequent request without first revalidating it with the origin + server. (I.e., the cache MUST do an end-to-end revalidation every + time, if, based solely on the origin server's Expires or max-age + value, the cached response is stale.) + + The must-revalidate directive is necessary to support reliable + operation for certain protocol features. In all circumstances an + HTTP/1.1 cache MUST obey the must-revalidate directive; in + particular, if the cache cannot reach the origin server for any + reason, it MUST generate a 504 (Gateway Timeout) response. + + Servers SHOULD send the must-revalidate directive if and only if + failure to revalidate a request on the entity could result in + incorrect operation, such as a silently unexecuted financial + transaction. Recipients MUST NOT take any automated action that + violates this directive, and MUST NOT automatically provide an + unvalidated copy of the entity if revalidation fails. + + Although this is not recommended, user agents operating under + severe connectivity constraints MAY violate this directive but, if + so, MUST explicitly warn the user that an unvalidated response has + been provided. The warning MUST be provided on each unvalidated + access, and SHOULD require explicit user confirmation. + + proxy-revalidate + The proxy-revalidate directive has the same meaning as the must- + revalidate directive, except that it does not apply to non-shared + user agent caches. It can be used on a response to an + authenticated request to permit the user's cache to store and + later return the response without needing to revalidate it (since + it has already been authenticated once by that user), while still + requiring proxies that service many users to revalidate each time + (in order to make sure that each user has been authenticated). + Note that such authenticated responses also need the public cache + control directive in order to allow them to be cached at all. + +14.9.5 No-Transform Directive + + no-transform + Implementors of intermediate caches (proxies) have found it useful + to convert the media type of certain entity bodies. A non- + transparent proxy might, for example, convert between image + formats in order to save cache space or to reduce the amount of + traffic on a slow link. + + Serious operational problems occur, however, when these + transformations are applied to entity bodies intended for certain + kinds of applications. For example, applications for medical + + + +Fielding, et al. Standards Track [Page 115] + +RFC 2616 HTTP/1.1 June 1999 + + + imaging, scientific data analysis and those using end-to-end + authentication, all depend on receiving an entity body that is bit + for bit identical to the original entity-body. + + Therefore, if a message includes the no-transform directive, an + intermediate cache or proxy MUST NOT change those headers that are + listed in section 13.5.2 as being subject to the no-transform + directive. This implies that the cache or proxy MUST NOT change + any aspect of the entity-body that is specified by these headers, + including the value of the entity-body itself. + +14.9.6 Cache Control Extensions + + The Cache-Control header field can be extended through the use of one + or more cache-extension tokens, each with an optional assigned value. + Informational extensions (those which do not require a change in + cache behavior) MAY be added without changing the semantics of other + directives. Behavioral extensions are designed to work by acting as + modifiers to the existing base of cache directives. Both the new + directive and the standard directive are supplied, such that + applications which do not understand the new directive will default + to the behavior specified by the standard directive, and those that + understand the new directive will recognize it as modifying the + requirements associated with the standard directive. In this way, + extensions to the cache-control directives can be made without + requiring changes to the base protocol. + + This extension mechanism depends on an HTTP cache obeying all of the + cache-control directives defined for its native HTTP-version, obeying + certain extensions, and ignoring all directives that it does not + understand. + + For example, consider a hypothetical new response directive called + community which acts as a modifier to the private directive. We + define this new directive to mean that, in addition to any non-shared + cache, any cache which is shared only by members of the community + named within its value may cache the response. An origin server + wishing to allow the UCI community to use an otherwise private + response in their shared cache(s) could do so by including + + Cache-Control: private, community="UCI" + + A cache seeing this header field will act correctly even if the cache + does not understand the community cache-extension, since it will also + see and understand the private directive and thus default to the safe + behavior. + + + + + +Fielding, et al. Standards Track [Page 116] + +RFC 2616 HTTP/1.1 June 1999 + + + Unrecognized cache-directives MUST be ignored; it is assumed that any + cache-directive likely to be unrecognized by an HTTP/1.1 cache will + be combined with standard directives (or the response's default + cacheability) such that the cache behavior will remain minimally + correct even if the cache does not understand the extension(s). + +14.10 Connection + + The Connection general-header field allows the sender to specify + options that are desired for that particular connection and MUST NOT + be communicated by proxies over further connections. + + The Connection header has the following grammar: + + Connection = "Connection" ":" 1#(connection-token) + connection-token = token + + HTTP/1.1 proxies MUST parse the Connection header field before a + message is forwarded and, for each connection-token in this field, + remove any header field(s) from the message with the same name as the + connection-token. Connection options are signaled by the presence of + a connection-token in the Connection header field, not by any + corresponding additional header field(s), since the additional header + field may not be sent if there are no parameters associated with that + connection option. + + Message headers listed in the Connection header MUST NOT include + end-to-end headers, such as Cache-Control. + + HTTP/1.1 defines the "close" connection option for the sender to + signal that the connection will be closed after completion of the + response. For example, + + Connection: close + + in either the request or the response header fields indicates that + the connection SHOULD NOT be considered `persistent' (section 8.1) + after the current request/response is complete. + + HTTP/1.1 applications that do not support persistent connections MUST + include the "close" connection option in every message. + + A system receiving an HTTP/1.0 (or lower-version) message that + includes a Connection header MUST, for each connection-token in this + field, remove and ignore any header field(s) from the message with + the same name as the connection-token. This protects against mistaken + forwarding of such header fields by pre-HTTP/1.1 proxies. See section + 19.6.2. + + + +Fielding, et al. Standards Track [Page 117] + +RFC 2616 HTTP/1.1 June 1999 + + +14.11 Content-Encoding + + The Content-Encoding entity-header field is used as a modifier to the + media-type. When present, its value indicates what additional content + codings have been applied to the entity-body, and thus what decoding + mechanisms must be applied in order to obtain the media-type + referenced by the Content-Type header field. Content-Encoding is + primarily used to allow a document to be compressed without losing + the identity of its underlying media type. + + Content-Encoding = "Content-Encoding" ":" 1#content-coding + + Content codings are defined in section 3.5. An example of its use is + + Content-Encoding: gzip + + The content-coding is a characteristic of the entity identified by + the Request-URI. Typically, the entity-body is stored with this + encoding and is only decoded before rendering or analogous usage. + However, a non-transparent proxy MAY modify the content-coding if the + new coding is known to be acceptable to the recipient, unless the + "no-transform" cache-control directive is present in the message. + + If the content-coding of an entity is not "identity", then the + response MUST include a Content-Encoding entity-header (section + 14.11) that lists the non-identity content-coding(s) used. + + If the content-coding of an entity in a request message is not + acceptable to the origin server, the server SHOULD respond with a + status code of 415 (Unsupported Media Type). + + If multiple encodings have been applied to an entity, the content + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + +14.12 Content-Language + + The Content-Language entity-header field describes the natural + language(s) of the intended audience for the enclosed entity. Note + that this might not be equivalent to all the languages used within + the entity-body. + + Content-Language = "Content-Language" ":" 1#language-tag + + + + + + + +Fielding, et al. Standards Track [Page 118] + +RFC 2616 HTTP/1.1 June 1999 + + + Language tags are defined in section 3.10. The primary purpose of + Content-Language is to allow a user to identify and differentiate + entities according to the user's own preferred language. Thus, if the + body content is intended only for a Danish-literate audience, the + appropriate field is + + Content-Language: da + + If no Content-Language is specified, the default is that the content + is intended for all language audiences. This might mean that the + sender does not consider it to be specific to any natural language, + or that the sender does not know for which language it is intended. + + Multiple languages MAY be listed for content that is intended for + multiple audiences. For example, a rendition of the "Treaty of + Waitangi," presented simultaneously in the original Maori and English + versions, would call for + + Content-Language: mi, en + + However, just because multiple languages are present within an entity + does not mean that it is intended for multiple linguistic audiences. + An example would be a beginner's language primer, such as "A First + Lesson in Latin," which is clearly intended to be used by an + English-literate audience. In this case, the Content-Language would + properly only include "en". + + Content-Language MAY be applied to any media type -- it is not + limited to textual documents. + +14.13 Content-Length + + The Content-Length entity-header field indicates the size of the + entity-body, in decimal number of OCTETs, sent to the recipient or, + in the case of the HEAD method, the size of the entity-body that + would have been sent had the request been a GET. + + Content-Length = "Content-Length" ":" 1*DIGIT + + An example is + + Content-Length: 3495 + + Applications SHOULD use this field to indicate the transfer-length of + the message-body, unless this is prohibited by the rules in section + 4.4. + + + + + +Fielding, et al. Standards Track [Page 119] + +RFC 2616 HTTP/1.1 June 1999 + + + Any Content-Length greater than or equal to zero is a valid value. + Section 4.4 describes how to determine the length of a message-body + if a Content-Length is not given. + + Note that the meaning of this field is significantly different from + the corresponding definition in MIME, where it is an optional field + used within the "message/external-body" content-type. In HTTP, it + SHOULD be sent whenever the message's length can be determined prior + to being transferred, unless this is prohibited by the rules in + section 4.4. + +14.14 Content-Location + + The Content-Location entity-header field MAY be used to supply the + resource location for the entity enclosed in the message when that + entity is accessible from a location separate from the requested + resource's URI. A server SHOULD provide a Content-Location for the + variant corresponding to the response entity; especially in the case + where a resource has multiple entities associated with it, and those + entities actually have separate locations by which they might be + individually accessed, the server SHOULD provide a Content-Location + for the particular variant which is returned. + + Content-Location = "Content-Location" ":" + ( absoluteURI | relativeURI ) + + The value of Content-Location also defines the base URI for the + entity. + + The Content-Location value is not a replacement for the original + requested URI; it is only a statement of the location of the resource + corresponding to this particular entity at the time of the request. + Future requests MAY specify the Content-Location URI as the request- + URI if the desire is to identify the source of that particular + entity. + + A cache cannot assume that an entity with a Content-Location + different from the URI used to retrieve it can be used to respond to + later requests on that Content-Location URI. However, the Content- + Location can be used to differentiate between multiple entities + retrieved from a single requested resource, as described in section + 13.6. + + If the Content-Location is a relative URI, the relative URI is + interpreted relative to the Request-URI. + + The meaning of the Content-Location header in PUT or POST requests is + undefined; servers are free to ignore it in those cases. + + + +Fielding, et al. Standards Track [Page 120] + +RFC 2616 HTTP/1.1 June 1999 + + +14.15 Content-MD5 + + The Content-MD5 entity-header field, as defined in RFC 1864 [23], is + an MD5 digest of the entity-body for the purpose of providing an + end-to-end message integrity check (MIC) of the entity-body. (Note: a + MIC is good for detecting accidental modification of the entity-body + in transit, but is not proof against malicious attacks.) + + Content-MD5 = "Content-MD5" ":" md5-digest + md5-digest = + + The Content-MD5 header field MAY be generated by an origin server or + client to function as an integrity check of the entity-body. Only + origin servers or clients MAY generate the Content-MD5 header field; + proxies and gateways MUST NOT generate it, as this would defeat its + value as an end-to-end integrity check. Any recipient of the entity- + body, including gateways and proxies, MAY check that the digest value + in this header field matches that of the entity-body as received. + + The MD5 digest is computed based on the content of the entity-body, + including any content-coding that has been applied, but not including + any transfer-encoding applied to the message-body. If the message is + received with a transfer-encoding, that encoding MUST be removed + prior to checking the Content-MD5 value against the received entity. + + This has the result that the digest is computed on the octets of the + entity-body exactly as, and in the order that, they would be sent if + no transfer-encoding were being applied. + + HTTP extends RFC 1864 to permit the digest to be computed for MIME + composite media-types (e.g., multipart/* and message/rfc822), but + this does not change how the digest is computed as defined in the + preceding paragraph. + + There are several consequences of this. The entity-body for composite + types MAY contain many body-parts, each with its own MIME and HTTP + headers (including Content-MD5, Content-Transfer-Encoding, and + Content-Encoding headers). If a body-part has a Content-Transfer- + Encoding or Content-Encoding header, it is assumed that the content + of the body-part has had the encoding applied, and the body-part is + included in the Content-MD5 digest as is -- i.e., after the + application. The Transfer-Encoding header field is not allowed within + body-parts. + + Conversion of all line breaks to CRLF MUST NOT be done before + computing or checking the digest: the line break convention used in + the text actually transmitted MUST be left unaltered when computing + the digest. + + + +Fielding, et al. Standards Track [Page 121] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: while the definition of Content-MD5 is exactly the same for + HTTP as in RFC 1864 for MIME entity-bodies, there are several ways + in which the application of Content-MD5 to HTTP entity-bodies + differs from its application to MIME entity-bodies. One is that + HTTP, unlike MIME, does not use Content-Transfer-Encoding, and + does use Transfer-Encoding and Content-Encoding. Another is that + HTTP more frequently uses binary content types than MIME, so it is + worth noting that, in such cases, the byte order used to compute + the digest is the transmission byte order defined for the type. + Lastly, HTTP allows transmission of text types with any of several + line break conventions and not just the canonical form using CRLF. + +14.16 Content-Range + + The Content-Range entity-header is sent with a partial entity-body to + specify where in the full entity-body the partial body should be + applied. Range units are defined in section 3.12. + + Content-Range = "Content-Range" ":" content-range-spec + + content-range-spec = byte-content-range-spec + byte-content-range-spec = bytes-unit SP + byte-range-resp-spec "/" + ( instance-length | "*" ) + + byte-range-resp-spec = (first-byte-pos "-" last-byte-pos) + | "*" + instance-length = 1*DIGIT + + The header SHOULD indicate the total length of the full entity-body, + unless this length is unknown or difficult to determine. The asterisk + "*" character means that the instance-length is unknown at the time + when the response was generated. + + Unlike byte-ranges-specifier values (see section 14.35.1), a byte- + range-resp-spec MUST only specify one range, and MUST contain + absolute byte positions for both the first and last byte of the + range. + + A byte-content-range-spec with a byte-range-resp-spec whose last- + byte-pos value is less than its first-byte-pos value, or whose + instance-length value is less than or equal to its last-byte-pos + value, is invalid. The recipient of an invalid byte-content-range- + spec MUST ignore it and any content transferred along with it. + + A server sending a response with status code 416 (Requested range not + satisfiable) SHOULD include a Content-Range field with a byte-range- + resp-spec of "*". The instance-length specifies the current length of + + + +Fielding, et al. Standards Track [Page 122] + +RFC 2616 HTTP/1.1 June 1999 + + + the selected resource. A response with status code 206 (Partial + Content) MUST NOT include a Content-Range field with a byte-range- + resp-spec of "*". + + Examples of byte-content-range-spec values, assuming that the entity + contains a total of 1234 bytes: + + . The first 500 bytes: + bytes 0-499/1234 + + . The second 500 bytes: + bytes 500-999/1234 + + . All except for the first 500 bytes: + bytes 500-1233/1234 + + . The last 500 bytes: + bytes 734-1233/1234 + + When an HTTP message includes the content of a single range (for + example, a response to a request for a single range, or to a request + for a set of ranges that overlap without any holes), this content is + transmitted with a Content-Range header, and a Content-Length header + showing the number of bytes actually transferred. For example, + + HTTP/1.1 206 Partial content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-Range: bytes 21010-47021/47022 + Content-Length: 26012 + Content-Type: image/gif + + When an HTTP message includes the content of multiple ranges (for + example, a response to a request for multiple non-overlapping + ranges), these are transmitted as a multipart message. The multipart + media type used for this purpose is "multipart/byteranges" as defined + in appendix 19.2. See appendix 19.6.3 for a compatibility issue. + + A response to a request for a single range MUST NOT be sent using the + multipart/byteranges media type. A response to a request for + multiple ranges, whose result is a single range, MAY be sent as a + multipart/byteranges media type with one part. A client that cannot + decode a multipart/byteranges message MUST NOT ask for multiple + byte-ranges in a single request. + + When a client requests multiple byte-ranges in one request, the + server SHOULD return them in the order that they appeared in the + request. + + + +Fielding, et al. Standards Track [Page 123] + +RFC 2616 HTTP/1.1 June 1999 + + + If the server ignores a byte-range-spec because it is syntactically + invalid, the server SHOULD treat the request as if the invalid Range + header field did not exist. (Normally, this means return a 200 + response containing the full entity). + + If the server receives a request (other than one including an If- + Range request-header field) with an unsatisfiable Range request- + header field (that is, all of whose byte-range-spec values have a + first-byte-pos value greater than the current length of the selected + resource), it SHOULD return a response code of 416 (Requested range + not satisfiable) (section 10.4.17). + + Note: clients cannot depend on servers to send a 416 (Requested + range not satisfiable) response instead of a 200 (OK) response for + an unsatisfiable Range request-header, since not all servers + implement this request-header. + +14.17 Content-Type + + The Content-Type entity-header field indicates the media type of the + entity-body sent to the recipient or, in the case of the HEAD method, + the media type that would have been sent had the request been a GET. + + Content-Type = "Content-Type" ":" media-type + + Media types are defined in section 3.7. An example of the field is + + Content-Type: text/html; charset=ISO-8859-4 + + Further discussion of methods for identifying the media type of an + entity is provided in section 7.2.1. + +14.18 Date + + The Date general-header field represents the date and time at which + the message was originated, having the same semantics as orig-date in + RFC 822. The field value is an HTTP-date, as described in section + 3.3.1; it MUST be sent in RFC 1123 [8]-date format. + + Date = "Date" ":" HTTP-date + + An example is + + Date: Tue, 15 Nov 1994 08:12:31 GMT + + Origin servers MUST include a Date header field in all responses, + except in these cases: + + + + +Fielding, et al. Standards Track [Page 124] + +RFC 2616 HTTP/1.1 June 1999 + + + 1. If the response status code is 100 (Continue) or 101 (Switching + Protocols), the response MAY include a Date header field, at + the server's option. + + 2. If the response status code conveys a server error, e.g. 500 + (Internal Server Error) or 503 (Service Unavailable), and it is + inconvenient or impossible to generate a valid Date. + + 3. If the server does not have a clock that can provide a + reasonable approximation of the current time, its responses + MUST NOT include a Date header field. In this case, the rules + in section 14.18.1 MUST be followed. + + A received message that does not have a Date header field MUST be + assigned one by the recipient if the message will be cached by that + recipient or gatewayed via a protocol which requires a Date. An HTTP + implementation without a clock MUST NOT cache responses without + revalidating them on every use. An HTTP cache, especially a shared + cache, SHOULD use a mechanism, such as NTP [28], to synchronize its + clock with a reliable external standard. + + Clients SHOULD only send a Date header field in messages that include + an entity-body, as in the case of the PUT and POST requests, and even + then it is optional. A client without a clock MUST NOT send a Date + header field in a request. + + The HTTP-date sent in a Date header SHOULD NOT represent a date and + time subsequent to the generation of the message. It SHOULD represent + the best available approximation of the date and time of message + generation, unless the implementation has no means of generating a + reasonably accurate date and time. In theory, the date ought to + represent the moment just before the entity is generated. In + practice, the date can be generated at any time during the message + origination without affecting its semantic value. + +14.18.1 Clockless Origin Server Operation + + Some origin server implementations might not have a clock available. + An origin server without a clock MUST NOT assign Expires or Last- + Modified values to a response, unless these values were associated + with the resource by a system or user with a reliable clock. It MAY + assign an Expires value that is known, at or before server + configuration time, to be in the past (this allows "pre-expiration" + of responses without storing separate Expires values for each + resource). + + + + + + +Fielding, et al. Standards Track [Page 125] + +RFC 2616 HTTP/1.1 June 1999 + + +14.19 ETag + + The ETag response-header field provides the current value of the + entity tag for the requested variant. The headers used with entity + tags are described in sections 14.24, 14.26 and 14.44. The entity tag + MAY be used for comparison with other entities from the same resource + (see section 13.3.3). + + ETag = "ETag" ":" entity-tag + + Examples: + + ETag: "xyzzy" + ETag: W/"xyzzy" + ETag: "" + +14.20 Expect + + The Expect request-header field is used to indicate that particular + server behaviors are required by the client. + + Expect = "Expect" ":" 1#expectation + + expectation = "100-continue" | expectation-extension + expectation-extension = token [ "=" ( token | quoted-string ) + *expect-params ] + expect-params = ";" token [ "=" ( token | quoted-string ) ] + + + A server that does not understand or is unable to comply with any of + the expectation values in the Expect field of a request MUST respond + with appropriate error status. The server MUST respond with a 417 + (Expectation Failed) status if any of the expectations cannot be met + or, if there are other problems with the request, some other 4xx + status. + + This header field is defined with extensible syntax to allow for + future extensions. If a server receives a request containing an + Expect field that includes an expectation-extension that it does not + support, it MUST respond with a 417 (Expectation Failed) status. + + Comparison of expectation values is case-insensitive for unquoted + tokens (including the 100-continue token), and is case-sensitive for + quoted-string expectation-extensions. + + + + + + + +Fielding, et al. Standards Track [Page 126] + +RFC 2616 HTTP/1.1 June 1999 + + + The Expect mechanism is hop-by-hop: that is, an HTTP/1.1 proxy MUST + return a 417 (Expectation Failed) status if it receives a request + with an expectation that it cannot meet. However, the Expect + request-header itself is end-to-end; it MUST be forwarded if the + request is forwarded. + + Many older HTTP/1.0 and HTTP/1.1 applications do not understand the + Expect header. + + See section 8.2.3 for the use of the 100 (continue) status. + +14.21 Expires + + The Expires entity-header field gives the date/time after which the + response is considered stale. A stale cache entry may not normally be + returned by a cache (either a proxy cache or a user agent cache) + unless it is first validated with the origin server (or with an + intermediate cache that has a fresh copy of the entity). See section + 13.2 for further discussion of the expiration model. + + The presence of an Expires field does not imply that the original + resource will change or cease to exist at, before, or after that + time. + + The format is an absolute date and time as defined by HTTP-date in + section 3.3.1; it MUST be in RFC 1123 date format: + + Expires = "Expires" ":" HTTP-date + + An example of its use is + + Expires: Thu, 01 Dec 1994 16:00:00 GMT + + Note: if a response includes a Cache-Control field with the max- + age directive (see section 14.9.3), that directive overrides the + Expires field. + + HTTP/1.1 clients and caches MUST treat other invalid date formats, + especially including the value "0", as in the past (i.e., "already + expired"). + + To mark a response as "already expired," an origin server sends an + Expires date that is equal to the Date header value. (See the rules + for expiration calculations in section 13.2.4.) + + + + + + + +Fielding, et al. Standards Track [Page 127] + +RFC 2616 HTTP/1.1 June 1999 + + + To mark a response as "never expires," an origin server sends an + Expires date approximately one year from the time the response is + sent. HTTP/1.1 servers SHOULD NOT send Expires dates more than one + year in the future. + + The presence of an Expires header field with a date value of some + time in the future on a response that otherwise would by default be + non-cacheable indicates that the response is cacheable, unless + indicated otherwise by a Cache-Control header field (section 14.9). + +14.22 From + + The From request-header field, if given, SHOULD contain an Internet + e-mail address for the human user who controls the requesting user + agent. The address SHOULD be machine-usable, as defined by "mailbox" + in RFC 822 [9] as updated by RFC 1123 [8]: + + From = "From" ":" mailbox + + An example is: + + From: webmaster@w3.org + + This header field MAY be used for logging purposes and as a means for + identifying the source of invalid or unwanted requests. It SHOULD NOT + be used as an insecure form of access protection. The interpretation + of this field is that the request is being performed on behalf of the + person given, who accepts responsibility for the method performed. In + particular, robot agents SHOULD include this header so that the + person responsible for running the robot can be contacted if problems + occur on the receiving end. + + The Internet e-mail address in this field MAY be separate from the + Internet host which issued the request. For example, when a request + is passed through a proxy the original issuer's address SHOULD be + used. + + The client SHOULD NOT send the From header field without the user's + approval, as it might conflict with the user's privacy interests or + their site's security policy. It is strongly recommended that the + user be able to disable, enable, and modify the value of this field + at any time prior to a request. + +14.23 Host + + The Host request-header field specifies the Internet host and port + number of the resource being requested, as obtained from the original + URI given by the user or referring resource (generally an HTTP URL, + + + +Fielding, et al. Standards Track [Page 128] + +RFC 2616 HTTP/1.1 June 1999 + + + as described in section 3.2.2). The Host field value MUST represent + the naming authority of the origin server or gateway given by the + original URL. This allows the origin server or gateway to + differentiate between internally-ambiguous URLs, such as the root "/" + URL of a server for multiple host names on a single IP address. + + Host = "Host" ":" host [ ":" port ] ; Section 3.2.2 + + A "host" without any trailing port information implies the default + port for the service requested (e.g., "80" for an HTTP URL). For + example, a request on the origin server for + would properly include: + + GET /pub/WWW/ HTTP/1.1 + Host: www.w3.org + + A client MUST include a Host header field in all HTTP/1.1 request + messages . If the requested URI does not include an Internet host + name for the service being requested, then the Host header field MUST + be given with an empty value. An HTTP/1.1 proxy MUST ensure that any + request message it forwards does contain an appropriate Host header + field that identifies the service being requested by the proxy. All + Internet-based HTTP/1.1 servers MUST respond with a 400 (Bad Request) + status code to any HTTP/1.1 request message which lacks a Host header + field. + + See sections 5.2 and 19.6.1.1 for other requirements relating to + Host. + +14.24 If-Match + + The If-Match request-header field is used with a method to make it + conditional. A client that has one or more entities previously + obtained from the resource can verify that one of those entities is + current by including a list of their associated entity tags in the + If-Match header field. Entity tags are defined in section 3.11. The + purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. It is also + used, on updating requests, to prevent inadvertent modification of + the wrong version of a resource. As a special case, the value "*" + matches any current entity of the resource. + + If-Match = "If-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-Match header) on that resource, or if "*" is given + + + + +Fielding, et al. Standards Track [Page 129] + +RFC 2616 HTTP/1.1 June 1999 + + + and any current entity exists for that resource, then the server MAY + perform the requested method as if the If-Match header field did not + exist. + + A server MUST use the strong comparison function (see section 13.3.3) + to compare the entity tags in If-Match. + + If none of the entity tags match, or if "*" is given and no current + entity exists, the server MUST NOT perform the requested method, and + MUST return a 412 (Precondition Failed) response. This behavior is + most useful when the client wants to prevent an updating method, such + as PUT, from modifying a resource that has changed since the client + last retrieved it. + + If the request would, without the If-Match header field, result in + anything other than a 2xx or 412 status, then the If-Match header + MUST be ignored. + + The meaning of "If-Match: *" is that the method SHOULD be performed + if the representation selected by the origin server (or by a cache, + possibly using the Vary mechanism, see section 14.44) exists, and + MUST NOT be performed if the representation does not exist. + + A request intended to update a resource (e.g., a PUT) MAY include an + If-Match header field to signal that the request method MUST NOT be + applied if the entity corresponding to the If-Match value (a single + entity tag) is no longer a representation of that resource. This + allows the user to indicate that they do not wish the request to be + successful if the resource has been changed without their knowledge. + Examples: + + If-Match: "xyzzy" + If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-Match: * + + The result of a request having both an If-Match header field and + either an If-None-Match or an If-Modified-Since header fields is + undefined by this specification. + +14.25 If-Modified-Since + + The If-Modified-Since request-header field is used with a method to + make it conditional: if the requested variant has not been modified + since the time specified in this field, an entity will not be + returned from the server; instead, a 304 (not modified) response will + be returned without any message-body. + + If-Modified-Since = "If-Modified-Since" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 130] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of the field is: + + If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + A GET method with an If-Modified-Since header and no Range header + requests that the identified entity be transferred only if it has + been modified since the date given by the If-Modified-Since header. + The algorithm for determining this includes the following cases: + + a) If the request would normally result in anything other than a + 200 (OK) status, or if the passed If-Modified-Since date is + invalid, the response is exactly the same as for a normal GET. + A date which is later than the server's current time is + invalid. + + b) If the variant has been modified since the If-Modified-Since + date, the response is exactly the same as for a normal GET. + + c) If the variant has not been modified since a valid If- + Modified-Since date, the server SHOULD return a 304 (Not + Modified) response. + + The purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. + + Note: The Range request-header field modifies the meaning of If- + Modified-Since; see section 14.35 for full details. + + Note: If-Modified-Since times are interpreted by the server, whose + clock might not be synchronized with the client. + + Note: When handling an If-Modified-Since header field, some + servers will use an exact date comparison function, rather than a + less-than function, for deciding whether to send a 304 (Not + Modified) response. To get best results when sending an If- + Modified-Since header field for cache validation, clients are + advised to use the exact date string received in a previous Last- + Modified header field whenever possible. + + Note: If a client uses an arbitrary date in the If-Modified-Since + header instead of a date taken from the Last-Modified header for + the same request, the client should be aware of the fact that this + date is interpreted in the server's understanding of time. The + client should consider unsynchronized clocks and rounding problems + due to the different encodings of time between the client and + server. This includes the possibility of race conditions if the + document has changed between the time it was first requested and + the If-Modified-Since date of a subsequent request, and the + + + +Fielding, et al. Standards Track [Page 131] + +RFC 2616 HTTP/1.1 June 1999 + + + possibility of clock-skew-related problems if the If-Modified- + Since date is derived from the client's clock without correction + to the server's clock. Corrections for different time bases + between client and server are at best approximate due to network + latency. + + The result of a request having both an If-Modified-Since header field + and either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.26 If-None-Match + + The If-None-Match request-header field is used with a method to make + it conditional. A client that has one or more entities previously + obtained from the resource can verify that none of those entities is + current by including a list of their associated entity tags in the + If-None-Match header field. The purpose of this feature is to allow + efficient updates of cached information with a minimum amount of + transaction overhead. It is also used to prevent a method (e.g. PUT) + from inadvertently modifying an existing resource when the client + believes that the resource does not exist. + + As a special case, the value "*" matches any current entity of the + resource. + + If-None-Match = "If-None-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-None-Match header) on that resource, or if "*" is + given and any current entity exists for that resource, then the + server MUST NOT perform the requested method, unless required to do + so because the resource's modification date fails to match that + supplied in an If-Modified-Since header field in the request. + Instead, if the request method was GET or HEAD, the server SHOULD + respond with a 304 (Not Modified) response, including the cache- + related header fields (particularly ETag) of one of the entities that + matched. For all other request methods, the server MUST respond with + a status of 412 (Precondition Failed). + + See section 13.3.3 for rules on how to determine if two entities tags + match. The weak comparison function can only be used with GET or HEAD + requests. + + + + + + + + +Fielding, et al. Standards Track [Page 132] + +RFC 2616 HTTP/1.1 June 1999 + + + If none of the entity tags match, then the server MAY perform the + requested method as if the If-None-Match header field did not exist, + but MUST also ignore any If-Modified-Since header field(s) in the + request. That is, if no entity tags match, then the server MUST NOT + return a 304 (Not Modified) response. + + If the request would, without the If-None-Match header field, result + in anything other than a 2xx or 304 status, then the If-None-Match + header MUST be ignored. (See section 13.3.4 for a discussion of + server behavior when both If-Modified-Since and If-None-Match appear + in the same request.) + + The meaning of "If-None-Match: *" is that the method MUST NOT be + performed if the representation selected by the origin server (or by + a cache, possibly using the Vary mechanism, see section 14.44) + exists, and SHOULD be performed if the representation does not exist. + This feature is intended to be useful in preventing races between PUT + operations. + + Examples: + + If-None-Match: "xyzzy" + If-None-Match: W/"xyzzy" + If-None-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-None-Match: W/"xyzzy", W/"r2d2xxxx", W/"c3piozzzz" + If-None-Match: * + + The result of a request having both an If-None-Match header field and + either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.27 If-Range + + If a client has a partial copy of an entity in its cache, and wishes + to have an up-to-date copy of the entire entity in its cache, it + could use the Range request-header with a conditional GET (using + either or both of If-Unmodified-Since and If-Match.) However, if the + condition fails because the entity has been modified, the client + would then have to make a second request to obtain the entire current + entity-body. + + The If-Range header allows a client to "short-circuit" the second + request. Informally, its meaning is `if the entity is unchanged, send + me the part(s) that I am missing; otherwise, send me the entire new + entity'. + + If-Range = "If-Range" ":" ( entity-tag | HTTP-date ) + + + + +Fielding, et al. Standards Track [Page 133] + +RFC 2616 HTTP/1.1 June 1999 + + + If the client has no entity tag for an entity, but does have a Last- + Modified date, it MAY use that date in an If-Range header. (The + server can distinguish between a valid HTTP-date and any form of + entity-tag by examining no more than two characters.) The If-Range + header SHOULD only be used together with a Range header, and MUST be + ignored if the request does not include a Range header, or if the + server does not support the sub-range operation. + + If the entity tag given in the If-Range header matches the current + entity tag for the entity, then the server SHOULD provide the + specified sub-range of the entity using a 206 (Partial content) + response. If the entity tag does not match, then the server SHOULD + return the entire entity using a 200 (OK) response. + +14.28 If-Unmodified-Since + + The If-Unmodified-Since request-header field is used with a method to + make it conditional. If the requested resource has not been modified + since the time specified in this field, the server SHOULD perform the + requested operation as if the If-Unmodified-Since header were not + present. + + If the requested variant has been modified since the specified time, + the server MUST NOT perform the requested operation, and MUST return + a 412 (Precondition Failed). + + If-Unmodified-Since = "If-Unmodified-Since" ":" HTTP-date + + An example of the field is: + + If-Unmodified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + If the request normally (i.e., without the If-Unmodified-Since + header) would result in anything other than a 2xx or 412 status, the + If-Unmodified-Since header SHOULD be ignored. + + If the specified date is invalid, the header is ignored. + + The result of a request having both an If-Unmodified-Since header + field and either an If-None-Match or an If-Modified-Since header + fields is undefined by this specification. + +14.29 Last-Modified + + The Last-Modified entity-header field indicates the date and time at + which the origin server believes the variant was last modified. + + Last-Modified = "Last-Modified" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 134] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of its use is + + Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT + + The exact meaning of this header field depends on the implementation + of the origin server and the nature of the original resource. For + files, it may be just the file system last-modified time. For + entities with dynamically included parts, it may be the most recent + of the set of last-modify times for its component parts. For database + gateways, it may be the last-update time stamp of the record. For + virtual objects, it may be the last time the internal state changed. + + An origin server MUST NOT send a Last-Modified date which is later + than the server's time of message origination. In such cases, where + the resource's last modification would indicate some time in the + future, the server MUST replace that date with the message + origination date. + + An origin server SHOULD obtain the Last-Modified value of the entity + as close as possible to the time that it generates the Date value of + its response. This allows a recipient to make an accurate assessment + of the entity's modification time, especially if the entity changes + near the time that the response is generated. + + HTTP/1.1 servers SHOULD send Last-Modified whenever feasible. + +14.30 Location + + The Location response-header field is used to redirect the recipient + to a location other than the Request-URI for completion of the + request or identification of a new resource. For 201 (Created) + responses, the Location is that of the new resource which was created + by the request. For 3xx responses, the location SHOULD indicate the + server's preferred URI for automatic redirection to the resource. The + field value consists of a single absolute URI. + + Location = "Location" ":" absoluteURI + + An example is: + + Location: http://www.w3.org/pub/WWW/People.html + + Note: The Content-Location header field (section 14.14) differs + from Location in that the Content-Location identifies the original + location of the entity enclosed in the request. It is therefore + possible for a response to contain header fields for both Location + and Content-Location. Also see section 13.10 for cache + requirements of some methods. + + + +Fielding, et al. Standards Track [Page 135] + +RFC 2616 HTTP/1.1 June 1999 + + +14.31 Max-Forwards + + The Max-Forwards request-header field provides a mechanism with the + TRACE (section 9.8) and OPTIONS (section 9.2) methods to limit the + number of proxies or gateways that can forward the request to the + next inbound server. This can be useful when the client is attempting + to trace a request chain which appears to be failing or looping in + mid-chain. + + Max-Forwards = "Max-Forwards" ":" 1*DIGIT + + The Max-Forwards value is a decimal integer indicating the remaining + number of times this request message may be forwarded. + + Each proxy or gateway recipient of a TRACE or OPTIONS request + containing a Max-Forwards header field MUST check and update its + value prior to forwarding the request. If the received value is zero + (0), the recipient MUST NOT forward the request; instead, it MUST + respond as the final recipient. If the received Max-Forwards value is + greater than zero, then the forwarded message MUST contain an updated + Max-Forwards field with a value decremented by one (1). + + The Max-Forwards header field MAY be ignored for all other methods + defined by this specification and for any extension methods for which + it is not explicitly referred to as part of that method definition. + +14.32 Pragma + + The Pragma general-header field is used to include implementation- + specific directives that might apply to any recipient along the + request/response chain. All pragma directives specify optional + behavior from the viewpoint of the protocol; however, some systems + MAY require that behavior be consistent with the directives. + + Pragma = "Pragma" ":" 1#pragma-directive + pragma-directive = "no-cache" | extension-pragma + extension-pragma = token [ "=" ( token | quoted-string ) ] + + When the no-cache directive is present in a request message, an + application SHOULD forward the request toward the origin server even + if it has a cached copy of what is being requested. This pragma + directive has the same semantics as the no-cache cache-directive (see + section 14.9) and is defined here for backward compatibility with + HTTP/1.0. Clients SHOULD include both header fields when a no-cache + request is sent to a server not known to be HTTP/1.1 compliant. + + + + + + +Fielding, et al. Standards Track [Page 136] + +RFC 2616 HTTP/1.1 June 1999 + + + Pragma directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a pragma for a + specific recipient; however, any pragma directive not relevant to a + recipient SHOULD be ignored by that recipient. + + HTTP/1.1 caches SHOULD treat "Pragma: no-cache" as if the client had + sent "Cache-Control: no-cache". No new Pragma directives will be + defined in HTTP. + + Note: because the meaning of "Pragma: no-cache as a response + header field is not actually specified, it does not provide a + reliable replacement for "Cache-Control: no-cache" in a response + +14.33 Proxy-Authenticate + + The Proxy-Authenticate response-header field MUST be included as part + of a 407 (Proxy Authentication Required) response. The field value + consists of a challenge that indicates the authentication scheme and + parameters applicable to the proxy for this Request-URI. + + Proxy-Authenticate = "Proxy-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. Unlike + WWW-Authenticate, the Proxy-Authenticate header field applies only to + the current connection and SHOULD NOT be passed on to downstream + clients. However, an intermediate proxy might need to obtain its own + credentials by requesting them from the downstream client, which in + some circumstances will appear as if the proxy is forwarding the + Proxy-Authenticate header field. + +14.34 Proxy-Authorization + + The Proxy-Authorization request-header field allows the client to + identify itself (or its user) to a proxy which requires + authentication. The Proxy-Authorization field value consists of + credentials containing the authentication information of the user + agent for the proxy and/or realm of the resource being requested. + + Proxy-Authorization = "Proxy-Authorization" ":" credentials + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43] . Unlike + Authorization, the Proxy-Authorization header field applies only to + the next outbound proxy that demanded authentication using the Proxy- + Authenticate field. When multiple proxies are used in a chain, the + + + +Fielding, et al. Standards Track [Page 137] + +RFC 2616 HTTP/1.1 June 1999 + + + Proxy-Authorization header field is consumed by the first outbound + proxy that was expecting to receive credentials. A proxy MAY relay + the credentials from the client request to the next proxy if that is + the mechanism by which the proxies cooperatively authenticate a given + request. + +14.35 Range + +14.35.1 Byte Ranges + + Since all HTTP entities are represented in HTTP messages as sequences + of bytes, the concept of a byte range is meaningful for any HTTP + entity. (However, not all clients and servers need to support byte- + range operations.) + + Byte range specifications in HTTP apply to the sequence of bytes in + the entity-body (not necessarily the same as the message-body). + + A byte range operation MAY specify a single range of bytes, or a set + of ranges within a single entity. + + ranges-specifier = byte-ranges-specifier + byte-ranges-specifier = bytes-unit "=" byte-range-set + byte-range-set = 1#( byte-range-spec | suffix-byte-range-spec ) + byte-range-spec = first-byte-pos "-" [last-byte-pos] + first-byte-pos = 1*DIGIT + last-byte-pos = 1*DIGIT + + The first-byte-pos value in a byte-range-spec gives the byte-offset + of the first byte in a range. The last-byte-pos value gives the + byte-offset of the last byte in the range; that is, the byte + positions specified are inclusive. Byte offsets start at zero. + + If the last-byte-pos value is present, it MUST be greater than or + equal to the first-byte-pos in that byte-range-spec, or the byte- + range-spec is syntactically invalid. The recipient of a byte-range- + set that includes one or more syntactically invalid byte-range-spec + values MUST ignore the header field that includes that byte-range- + set. + + If the last-byte-pos value is absent, or if the value is greater than + or equal to the current length of the entity-body, last-byte-pos is + taken to be equal to one less than the current length of the entity- + body in bytes. + + By its choice of last-byte-pos, a client can limit the number of + bytes retrieved without knowing the size of the entity. + + + + +Fielding, et al. Standards Track [Page 138] + +RFC 2616 HTTP/1.1 June 1999 + + + suffix-byte-range-spec = "-" suffix-length + suffix-length = 1*DIGIT + + A suffix-byte-range-spec is used to specify the suffix of the + entity-body, of a length given by the suffix-length value. (That is, + this form specifies the last N bytes of an entity-body.) If the + entity is shorter than the specified suffix-length, the entire + entity-body is used. + + If a syntactically valid byte-range-set includes at least one byte- + range-spec whose first-byte-pos is less than the current length of + the entity-body, or at least one suffix-byte-range-spec with a non- + zero suffix-length, then the byte-range-set is satisfiable. + Otherwise, the byte-range-set is unsatisfiable. If the byte-range-set + is unsatisfiable, the server SHOULD return a response with a status + of 416 (Requested range not satisfiable). Otherwise, the server + SHOULD return a response with a status of 206 (Partial Content) + containing the satisfiable ranges of the entity-body. + + Examples of byte-ranges-specifier values (assuming an entity-body of + length 10000): + + - The first 500 bytes (byte offsets 0-499, inclusive): bytes=0- + 499 + + - The second 500 bytes (byte offsets 500-999, inclusive): + bytes=500-999 + + - The final 500 bytes (byte offsets 9500-9999, inclusive): + bytes=-500 + + - Or bytes=9500- + + - The first and last bytes only (bytes 0 and 9999): bytes=0-0,-1 + + - Several legal but not canonical specifications of the second 500 + bytes (byte offsets 500-999, inclusive): + bytes=500-600,601-999 + bytes=500-700,601-999 + +14.35.2 Range Retrieval Requests + + HTTP retrieval requests using conditional or unconditional GET + methods MAY request one or more sub-ranges of the entity, instead of + the entire entity, using the Range request header, which applies to + the entity returned as the result of the request: + + Range = "Range" ":" ranges-specifier + + + +Fielding, et al. Standards Track [Page 139] + +RFC 2616 HTTP/1.1 June 1999 + + + A server MAY ignore the Range header. However, HTTP/1.1 origin + servers and intermediate caches ought to support byte ranges when + possible, since Range supports efficient recovery from partially + failed transfers, and supports efficient partial retrieval of large + entities. + + If the server supports the Range header and the specified range or + ranges are appropriate for the entity: + + - The presence of a Range header in an unconditional GET modifies + what is returned if the GET is otherwise successful. In other + words, the response carries a status code of 206 (Partial + Content) instead of 200 (OK). + + - The presence of a Range header in a conditional GET (a request + using one or both of If-Modified-Since and If-None-Match, or + one or both of If-Unmodified-Since and If-Match) modifies what + is returned if the GET is otherwise successful and the + condition is true. It does not affect the 304 (Not Modified) + response returned if the conditional is false. + + In some cases, it might be more appropriate to use the If-Range + header (see section 14.27) in addition to the Range header. + + If a proxy that supports ranges receives a Range request, forwards + the request to an inbound server, and receives an entire entity in + reply, it SHOULD only return the requested range to its client. It + SHOULD store the entire received response in its cache if that is + consistent with its cache allocation policies. + +14.36 Referer + + The Referer[sic] request-header field allows the client to specify, + for the server's benefit, the address (URI) of the resource from + which the Request-URI was obtained (the "referrer", although the + header field is misspelled.) The Referer request-header allows a + server to generate lists of back-links to resources for interest, + logging, optimized caching, etc. It also allows obsolete or mistyped + links to be traced for maintenance. The Referer field MUST NOT be + sent if the Request-URI was obtained from a source that does not have + its own URI, such as input from the user keyboard. + + Referer = "Referer" ":" ( absoluteURI | relativeURI ) + + Example: + + Referer: http://www.w3.org/hypertext/DataSources/Overview.html + + + + +Fielding, et al. Standards Track [Page 140] + +RFC 2616 HTTP/1.1 June 1999 + + + If the field value is a relative URI, it SHOULD be interpreted + relative to the Request-URI. The URI MUST NOT include a fragment. See + section 15.1.3 for security considerations. + +14.37 Retry-After + + The Retry-After response-header field can be used with a 503 (Service + Unavailable) response to indicate how long the service is expected to + be unavailable to the requesting client. This field MAY also be used + with any 3xx (Redirection) response to indicate the minimum time the + user-agent is asked wait before issuing the redirected request. The + value of this field can be either an HTTP-date or an integer number + of seconds (in decimal) after the time of the response. + + Retry-After = "Retry-After" ":" ( HTTP-date | delta-seconds ) + + Two examples of its use are + + Retry-After: Fri, 31 Dec 1999 23:59:59 GMT + Retry-After: 120 + + In the latter example, the delay is 2 minutes. + +14.38 Server + + The Server response-header field contains information about the + software used by the origin server to handle the request. The field + can contain multiple product tokens (section 3.8) and comments + identifying the server and any significant subproducts. The product + tokens are listed in order of their significance for identifying the + application. + + Server = "Server" ":" 1*( product | comment ) + + Example: + + Server: CERN/3.0 libwww/2.17 + + If the response is being forwarded through a proxy, the proxy + application MUST NOT modify the Server response-header. Instead, it + SHOULD include a Via field (as described in section 14.45). + + Note: Revealing the specific software version of the server might + allow the server machine to become more vulnerable to attacks + against software that is known to contain security holes. Server + implementors are encouraged to make this field a configurable + option. + + + + +Fielding, et al. Standards Track [Page 141] + +RFC 2616 HTTP/1.1 June 1999 + + +14.39 TE + + The TE request-header field indicates what extension transfer-codings + it is willing to accept in the response and whether or not it is + willing to accept trailer fields in a chunked transfer-coding. Its + value may consist of the keyword "trailers" and/or a comma-separated + list of extension transfer-coding names with optional accept + parameters (as described in section 3.6). + + TE = "TE" ":" #( t-codings ) + t-codings = "trailers" | ( transfer-extension [ accept-params ] ) + + The presence of the keyword "trailers" indicates that the client is + willing to accept trailer fields in a chunked transfer-coding, as + defined in section 3.6.1. This keyword is reserved for use with + transfer-coding values even though it does not itself represent a + transfer-coding. + + Examples of its use are: + + TE: deflate + TE: + TE: trailers, deflate;q=0.5 + + The TE header field only applies to the immediate connection. + Therefore, the keyword MUST be supplied within a Connection header + field (section 14.10) whenever TE is present in an HTTP/1.1 message. + + A server tests whether a transfer-coding is acceptable, according to + a TE field, using these rules: + + 1. The "chunked" transfer-coding is always acceptable. If the + keyword "trailers" is listed, the client indicates that it is + willing to accept trailer fields in the chunked response on + behalf of itself and any downstream clients. The implication is + that, if given, the client is stating that either all + downstream clients are willing to accept trailer fields in the + forwarded response, or that it will attempt to buffer the + response on behalf of downstream recipients. + + Note: HTTP/1.1 does not define any means to limit the size of a + chunked response such that a client can be assured of buffering + the entire response. + + 2. If the transfer-coding being tested is one of the transfer- + codings listed in the TE field, then it is acceptable unless it + is accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + + +Fielding, et al. Standards Track [Page 142] + +RFC 2616 HTTP/1.1 June 1999 + + + 3. If multiple transfer-codings are acceptable, then the + acceptable transfer-coding with the highest non-zero qvalue is + preferred. The "chunked" transfer-coding always has a qvalue + of 1. + + If the TE field-value is empty or if no TE field is present, the only + transfer-coding is "chunked". A message with no transfer-coding is + always acceptable. + +14.40 Trailer + + The Trailer general field value indicates that the given set of + header fields is present in the trailer of a message encoded with + chunked transfer-coding. + + Trailer = "Trailer" ":" 1#field-name + + An HTTP/1.1 message SHOULD include a Trailer header field in a + message using chunked transfer-coding with a non-empty trailer. Doing + so allows the recipient to know which header fields to expect in the + trailer. + + If no Trailer header field is present, the trailer SHOULD NOT include + any header fields. See section 3.6.1 for restrictions on the use of + trailer fields in a "chunked" transfer-coding. + + Message header fields listed in the Trailer header field MUST NOT + include the following header fields: + + . Transfer-Encoding + + . Content-Length + + . Trailer + +14.41 Transfer-Encoding + + The Transfer-Encoding general-header field indicates what (if any) + type of transformation has been applied to the message body in order + to safely transfer it between the sender and the recipient. This + differs from the content-coding in that the transfer-coding is a + property of the message, not of the entity. + + Transfer-Encoding = "Transfer-Encoding" ":" 1#transfer-coding + + Transfer-codings are defined in section 3.6. An example is: + + Transfer-Encoding: chunked + + + +Fielding, et al. Standards Track [Page 143] + +RFC 2616 HTTP/1.1 June 1999 + + + If multiple encodings have been applied to an entity, the transfer- + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + + Many older HTTP/1.0 applications do not understand the Transfer- + Encoding header. + +14.42 Upgrade + + The Upgrade general-header allows the client to specify what + additional communication protocols it supports and would like to use + if the server finds it appropriate to switch protocols. The server + MUST use the Upgrade header field within a 101 (Switching Protocols) + response to indicate which protocol(s) are being switched. + + Upgrade = "Upgrade" ":" 1#product + + For example, + + Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11 + + The Upgrade header field is intended to provide a simple mechanism + for transition from HTTP/1.1 to some other, incompatible protocol. It + does so by allowing the client to advertise its desire to use another + protocol, such as a later version of HTTP with a higher major version + number, even though the current request has been made using HTTP/1.1. + This eases the difficult transition between incompatible protocols by + allowing the client to initiate a request in the more commonly + supported protocol while indicating to the server that it would like + to use a "better" protocol if available (where "better" is determined + by the server, possibly according to the nature of the method and/or + resource being requested). + + The Upgrade header field only applies to switching application-layer + protocols upon the existing transport-layer connection. Upgrade + cannot be used to insist on a protocol change; its acceptance and use + by the server is optional. The capabilities and nature of the + application-layer communication after the protocol change is entirely + dependent upon the new protocol chosen, although the first action + after changing the protocol MUST be a response to the initial HTTP + request containing the Upgrade header field. + + The Upgrade header field only applies to the immediate connection. + Therefore, the upgrade keyword MUST be supplied within a Connection + header field (section 14.10) whenever Upgrade is present in an + HTTP/1.1 message. + + + + +Fielding, et al. Standards Track [Page 144] + +RFC 2616 HTTP/1.1 June 1999 + + + The Upgrade header field cannot be used to indicate a switch to a + protocol on a different connection. For that purpose, it is more + appropriate to use a 301, 302, 303, or 305 redirection response. + + This specification only defines the protocol name "HTTP" for use by + the family of Hypertext Transfer Protocols, as defined by the HTTP + version rules of section 3.1 and future updates to this + specification. Any token can be used as a protocol name; however, it + will only be useful if both the client and server associate the name + with the same protocol. + +14.43 User-Agent + + The User-Agent request-header field contains information about the + user agent originating the request. This is for statistical purposes, + the tracing of protocol violations, and automated recognition of user + agents for the sake of tailoring responses to avoid particular user + agent limitations. User agents SHOULD include this field with + requests. The field can contain multiple product tokens (section 3.8) + and comments identifying the agent and any subproducts which form a + significant part of the user agent. By convention, the product tokens + are listed in order of their significance for identifying the + application. + + User-Agent = "User-Agent" ":" 1*( product | comment ) + + Example: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + +14.44 Vary + + The Vary field value indicates the set of request-header fields that + fully determines, while the response is fresh, whether a cache is + permitted to use the response to reply to a subsequent request + without revalidation. For uncacheable or stale responses, the Vary + field value advises the user agent about the criteria that were used + to select the representation. A Vary field value of "*" implies that + a cache cannot determine from the request headers of a subsequent + request whether this response is the appropriate representation. See + section 13.6 for use of the Vary header field by caches. + + Vary = "Vary" ":" ( "*" | 1#field-name ) + + An HTTP/1.1 server SHOULD include a Vary header field with any + cacheable response that is subject to server-driven negotiation. + Doing so allows a cache to properly interpret future requests on that + resource and informs the user agent about the presence of negotiation + + + +Fielding, et al. Standards Track [Page 145] + +RFC 2616 HTTP/1.1 June 1999 + + + on that resource. A server MAY include a Vary header field with a + non-cacheable response that is subject to server-driven negotiation, + since this might provide the user agent with useful information about + the dimensions over which the response varies at the time of the + response. + + A Vary field value consisting of a list of field-names signals that + the representation selected for the response is based on a selection + algorithm which considers ONLY the listed request-header field values + in selecting the most appropriate representation. A cache MAY assume + that the same selection will be made for future requests with the + same values for the listed field names, for the duration of time for + which the response is fresh. + + The field-names given are not limited to the set of standard + request-header fields defined by this specification. Field names are + case-insensitive. + + A Vary field value of "*" signals that unspecified parameters not + limited to the request-headers (e.g., the network address of the + client), play a role in the selection of the response representation. + The "*" value MUST NOT be generated by a proxy server; it may only be + generated by an origin server. + +14.45 Via + + The Via general-header field MUST be used by gateways and proxies to + indicate the intermediate protocols and recipients between the user + agent and the server on requests, and between the origin server and + the client on responses. It is analogous to the "Received" field of + RFC 822 [9] and is intended to be used for tracking message forwards, + avoiding request loops, and identifying the protocol capabilities of + all senders along the request/response chain. + + Via = "Via" ":" 1#( received-protocol received-by [ comment ] ) + received-protocol = [ protocol-name "/" ] protocol-version + protocol-name = token + protocol-version = token + received-by = ( host [ ":" port ] ) | pseudonym + pseudonym = token + + The received-protocol indicates the protocol version of the message + received by the server or client along each segment of the + request/response chain. The received-protocol version is appended to + the Via field value when the message is forwarded so that information + about the protocol capabilities of upstream applications remains + visible to all recipients. + + + + +Fielding, et al. Standards Track [Page 146] + +RFC 2616 HTTP/1.1 June 1999 + + + The protocol-name is optional if and only if it would be "HTTP". The + received-by field is normally the host and optional port number of a + recipient server or client that subsequently forwarded the message. + However, if the real host is considered to be sensitive information, + it MAY be replaced by a pseudonym. If the port is not given, it MAY + be assumed to be the default port of the received-protocol. + + Multiple Via field values represents each proxy or gateway that has + forwarded the message. Each recipient MUST append its information + such that the end result is ordered according to the sequence of + forwarding applications. + + Comments MAY be used in the Via header field to identify the software + of the recipient proxy or gateway, analogous to the User-Agent and + Server header fields. However, all comments in the Via field are + optional and MAY be removed by any recipient prior to forwarding the + message. + + For example, a request message could be sent from an HTTP/1.0 user + agent to an internal proxy code-named "fred", which uses HTTP/1.1 to + forward the request to a public proxy at nowhere.com, which completes + the request by forwarding it to the origin server at www.ics.uci.edu. + The request received by www.ics.uci.edu would then have the following + Via header field: + + Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1) + + Proxies and gateways used as a portal through a network firewall + SHOULD NOT, by default, forward the names and ports of hosts within + the firewall region. This information SHOULD only be propagated if + explicitly enabled. If not enabled, the received-by host of any host + behind the firewall SHOULD be replaced by an appropriate pseudonym + for that host. + + For organizations that have strong privacy requirements for hiding + internal structures, a proxy MAY combine an ordered subsequence of + Via header field entries with identical received-protocol values into + a single such entry. For example, + + Via: 1.0 ricky, 1.1 ethel, 1.1 fred, 1.0 lucy + + could be collapsed to + + Via: 1.0 ricky, 1.1 mertz, 1.0 lucy + + + + + + + +Fielding, et al. Standards Track [Page 147] + +RFC 2616 HTTP/1.1 June 1999 + + + Applications SHOULD NOT combine multiple entries unless they are all + under the same organizational control and the hosts have already been + replaced by pseudonyms. Applications MUST NOT combine entries which + have different received-protocol values. + +14.46 Warning + + The Warning general-header field is used to carry additional + information about the status or transformation of a message which + might not be reflected in the message. This information is typically + used to warn about a possible lack of semantic transparency from + caching operations or transformations applied to the entity body of + the message. + + Warning headers are sent with responses using: + + Warning = "Warning" ":" 1#warning-value + + warning-value = warn-code SP warn-agent SP warn-text + [SP warn-date] + + warn-code = 3DIGIT + warn-agent = ( host [ ":" port ] ) | pseudonym + ; the name or pseudonym of the server adding + ; the Warning header, for use in debugging + warn-text = quoted-string + warn-date = <"> HTTP-date <"> + + A response MAY carry more than one Warning header. + + The warn-text SHOULD be in a natural language and character set that + is most likely to be intelligible to the human user receiving the + response. This decision MAY be based on any available knowledge, such + as the location of the cache or user, the Accept-Language field in a + request, the Content-Language field in a response, etc. The default + language is English and the default character set is ISO-8859-1. + + If a character set other than ISO-8859-1 is used, it MUST be encoded + in the warn-text using the method described in RFC 2047 [14]. + + Warning headers can in general be applied to any message, however + some specific warn-codes are specific to caches and can only be + applied to response messages. New Warning headers SHOULD be added + after any existing Warning headers. A cache MUST NOT delete any + Warning header that it received with a message. However, if a cache + successfully validates a cache entry, it SHOULD remove any Warning + headers previously attached to that entry except as specified for + + + + +Fielding, et al. Standards Track [Page 148] + +RFC 2616 HTTP/1.1 June 1999 + + + specific Warning codes. It MUST then add any Warning headers received + in the validating response. In other words, Warning headers are those + that would be attached to the most recent relevant response. + + When multiple Warning headers are attached to a response, the user + agent ought to inform the user of as many of them as possible, in the + order that they appear in the response. If it is not possible to + inform the user of all of the warnings, the user agent SHOULD follow + these heuristics: + + - Warnings that appear early in the response take priority over + those appearing later in the response. + + - Warnings in the user's preferred character set take priority + over warnings in other character sets but with identical warn- + codes and warn-agents. + + Systems that generate multiple Warning headers SHOULD order them with + this user agent behavior in mind. + + Requirements for the behavior of caches with respect to Warnings are + stated in section 13.1.2. + + This is a list of the currently-defined warn-codes, each with a + recommended warn-text in English, and a description of its meaning. + + 110 Response is stale + MUST be included whenever the returned response is stale. + + 111 Revalidation failed + MUST be included if a cache returns a stale response because an + attempt to revalidate the response failed, due to an inability to + reach the server. + + 112 Disconnected operation + SHOULD be included if the cache is intentionally disconnected from + the rest of the network for a period of time. + + 113 Heuristic expiration + MUST be included if the cache heuristically chose a freshness + lifetime greater than 24 hours and the response's age is greater + than 24 hours. + + 199 Miscellaneous warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action, besides presenting the warning to + the user. + + + +Fielding, et al. Standards Track [Page 149] + +RFC 2616 HTTP/1.1 June 1999 + + + 214 Transformation applied + MUST be added by an intermediate cache or proxy if it applies any + transformation changing the content-coding (as specified in the + Content-Encoding header) or media-type (as specified in the + Content-Type header) of the response, or the entity-body of the + response, unless this Warning code already appears in the response. + + 299 Miscellaneous persistent warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action. + + If an implementation sends a message with one or more Warning headers + whose version is HTTP/1.0 or lower, then the sender MUST include in + each warning-value a warn-date that matches the date in the response. + + If an implementation receives a message with a warning-value that + includes a warn-date, and that warn-date is different from the Date + value in the response, then that warning-value MUST be deleted from + the message before storing, forwarding, or using it. (This prevents + bad consequences of naive caching of Warning header fields.) If all + of the warning-values are deleted for this reason, the Warning header + MUST be deleted as well. + +14.47 WWW-Authenticate + + The WWW-Authenticate response-header field MUST be included in 401 + (Unauthorized) response messages. The field value consists of at + least one challenge that indicates the authentication scheme(s) and + parameters applicable to the Request-URI. + + WWW-Authenticate = "WWW-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. User + agents are advised to take special care in parsing the WWW- + Authenticate field value as it might contain more than one challenge, + or if more than one WWW-Authenticate header field is provided, the + contents of a challenge itself can contain a comma-separated list of + authentication parameters. + +15 Security Considerations + + This section is meant to inform application developers, information + providers, and users of the security limitations in HTTP/1.1 as + described by this document. The discussion does not include + definitive solutions to the problems revealed, though it does make + some suggestions for reducing security risks. + + + +Fielding, et al. Standards Track [Page 150] + +RFC 2616 HTTP/1.1 June 1999 + + +15.1 Personal Information + + HTTP clients are often privy to large amounts of personal information + (e.g. the user's name, location, mail address, passwords, encryption + keys, etc.), and SHOULD be very careful to prevent unintentional + leakage of this information via the HTTP protocol to other sources. + We very strongly recommend that a convenient interface be provided + for the user to control dissemination of such information, and that + designers and implementors be particularly careful in this area. + History shows that errors in this area often create serious security + and/or privacy problems and generate highly adverse publicity for the + implementor's company. + +15.1.1 Abuse of Server Log Information + + A server is in the position to save personal data about a user's + requests which might identify their reading patterns or subjects of + interest. This information is clearly confidential in nature and its + handling can be constrained by law in certain countries. People using + the HTTP protocol to provide data are responsible for ensuring that + such material is not distributed without the permission of any + individuals that are identifiable by the published results. + +15.1.2 Transfer of Sensitive Information + + Like any generic data transfer protocol, HTTP cannot regulate the + content of the data that is transferred, nor is there any a priori + method of determining the sensitivity of any particular piece of + information within the context of any given request. Therefore, + applications SHOULD supply as much control over this information as + possible to the provider of that information. Four header fields are + worth special mention in this context: Server, Via, Referer and From. + + Revealing the specific software version of the server might allow the + server machine to become more vulnerable to attacks against software + that is known to contain security holes. Implementors SHOULD make the + Server header field a configurable option. + + Proxies which serve as a portal through a network firewall SHOULD + take special precautions regarding the transfer of header information + that identifies the hosts behind the firewall. In particular, they + SHOULD remove, or replace with sanitized versions, any Via fields + generated behind the firewall. + + The Referer header allows reading patterns to be studied and reverse + links drawn. Although it can be very useful, its power can be abused + if user details are not separated from the information contained in + + + + +Fielding, et al. Standards Track [Page 151] + +RFC 2616 HTTP/1.1 June 1999 + + + the Referer. Even when the personal information has been removed, the + Referer header might indicate a private document's URI whose + publication would be inappropriate. + + The information sent in the From field might conflict with the user's + privacy interests or their site's security policy, and hence it + SHOULD NOT be transmitted without the user being able to disable, + enable, and modify the contents of the field. The user MUST be able + to set the contents of this field within a user preference or + application defaults configuration. + + We suggest, though do not require, that a convenient toggle interface + be provided for the user to enable or disable the sending of From and + Referer information. + + The User-Agent (section 14.43) or Server (section 14.38) header + fields can sometimes be used to determine that a specific client or + server have a particular security hole which might be exploited. + Unfortunately, this same information is often used for other valuable + purposes for which HTTP currently has no better mechanism. + +15.1.3 Encoding Sensitive Information in URI's + + Because the source of a link might be private information or might + reveal an otherwise private information source, it is strongly + recommended that the user be able to select whether or not the + Referer field is sent. For example, a browser client could have a + toggle switch for browsing openly/anonymously, which would + respectively enable/disable the sending of Referer and From + information. + + Clients SHOULD NOT include a Referer header field in a (non-secure) + HTTP request if the referring page was transferred with a secure + protocol. + + Authors of services which use the HTTP protocol SHOULD NOT use GET + based forms for the submission of sensitive data, because this will + cause this data to be encoded in the Request-URI. Many existing + servers, proxies, and user agents will log the request URI in some + place where it might be visible to third parties. Servers can use + POST-based form submission instead + +15.1.4 Privacy Issues Connected to Accept Headers + + Accept request-headers can reveal information about the user to all + servers which are accessed. The Accept-Language header in particular + can reveal information the user would consider to be of a private + nature, because the understanding of particular languages is often + + + +Fielding, et al. Standards Track [Page 152] + +RFC 2616 HTTP/1.1 June 1999 + + + strongly correlated to the membership of a particular ethnic group. + User agents which offer the option to configure the contents of an + Accept-Language header to be sent in every request are strongly + encouraged to let the configuration process include a message which + makes the user aware of the loss of privacy involved. + + An approach that limits the loss of privacy would be for a user agent + to omit the sending of Accept-Language headers by default, and to ask + the user whether or not to start sending Accept-Language headers to a + server if it detects, by looking for any Vary response-header fields + generated by the server, that such sending could improve the quality + of service. + + Elaborate user-customized accept header fields sent in every request, + in particular if these include quality values, can be used by servers + as relatively reliable and long-lived user identifiers. Such user + identifiers would allow content providers to do click-trail tracking, + and would allow collaborating content providers to match cross-server + click-trails or form submissions of individual users. Note that for + many users not behind a proxy, the network address of the host + running the user agent will also serve as a long-lived user + identifier. In environments where proxies are used to enhance + privacy, user agents ought to be conservative in offering accept + header configuration options to end users. As an extreme privacy + measure, proxies could filter the accept headers in relayed requests. + General purpose user agents which provide a high degree of header + configurability SHOULD warn users about the loss of privacy which can + be involved. + +15.2 Attacks Based On File and Path Names + + Implementations of HTTP origin servers SHOULD be careful to restrict + the documents returned by HTTP requests to be only those that were + intended by the server administrators. If an HTTP server translates + HTTP URIs directly into file system calls, the server MUST take + special care not to serve files that were not intended to be + delivered to HTTP clients. For example, UNIX, Microsoft Windows, and + other operating systems use ".." as a path component to indicate a + directory level above the current one. On such a system, an HTTP + server MUST disallow any such construct in the Request-URI if it + would otherwise allow access to a resource outside those intended to + be accessible via the HTTP server. Similarly, files intended for + reference only internally to the server (such as access control + files, configuration files, and script code) MUST be protected from + inappropriate retrieval, since they might contain sensitive + information. Experience has shown that minor bugs in such HTTP server + implementations have turned into security risks. + + + + +Fielding, et al. Standards Track [Page 153] + +RFC 2616 HTTP/1.1 June 1999 + + +15.3 DNS Spoofing + + Clients using HTTP rely heavily on the Domain Name Service, and are + thus generally prone to security attacks based on the deliberate + mis-association of IP addresses and DNS names. Clients need to be + cautious in assuming the continuing validity of an IP number/DNS name + association. + + In particular, HTTP clients SHOULD rely on their name resolver for + confirmation of an IP number/DNS name association, rather than + caching the result of previous host name lookups. Many platforms + already can cache host name lookups locally when appropriate, and + they SHOULD be configured to do so. It is proper for these lookups to + be cached, however, only when the TTL (Time To Live) information + reported by the name server makes it likely that the cached + information will remain useful. + + If HTTP clients cache the results of host name lookups in order to + achieve a performance improvement, they MUST observe the TTL + information reported by DNS. + + If HTTP clients do not observe this rule, they could be spoofed when + a previously-accessed server's IP address changes. As network + renumbering is expected to become increasingly common [24], the + possibility of this form of attack will grow. Observing this + requirement thus reduces this potential security vulnerability. + + This requirement also improves the load-balancing behavior of clients + for replicated servers using the same DNS name and reduces the + likelihood of a user's experiencing failure in accessing sites which + use that strategy. + +15.4 Location Headers and Spoofing + + If a single server supports multiple organizations that do not trust + one another, then it MUST check the values of Location and Content- + Location headers in responses that are generated under control of + said organizations to make sure that they do not attempt to + invalidate resources over which they have no authority. + +15.5 Content-Disposition Issues + + RFC 1806 [35], from which the often implemented Content-Disposition + (see section 19.5.1) header in HTTP is derived, has a number of very + serious security considerations. Content-Disposition is not part of + the HTTP standard, but since it is widely implemented, we are + documenting its use and risks for implementors. See RFC 2183 [49] + (which updates RFC 1806) for details. + + + +Fielding, et al. Standards Track [Page 154] + +RFC 2616 HTTP/1.1 June 1999 + + +15.6 Authentication Credentials and Idle Clients + + Existing HTTP clients and user agents typically retain authentication + information indefinitely. HTTP/1.1. does not provide a method for a + server to direct clients to discard these cached credentials. This is + a significant defect that requires further extensions to HTTP. + Circumstances under which credential caching can interfere with the + application's security model include but are not limited to: + + - Clients which have been idle for an extended period following + which the server might wish to cause the client to reprompt the + user for credentials. + + - Applications which include a session termination indication + (such as a `logout' or `commit' button on a page) after which + the server side of the application `knows' that there is no + further reason for the client to retain the credentials. + + This is currently under separate study. There are a number of work- + arounds to parts of this problem, and we encourage the use of + password protection in screen savers, idle time-outs, and other + methods which mitigate the security problems inherent in this + problem. In particular, user agents which cache credentials are + encouraged to provide a readily accessible mechanism for discarding + cached credentials under user control. + +15.7 Proxies and Caching + + By their very nature, HTTP proxies are men-in-the-middle, and + represent an opportunity for man-in-the-middle attacks. Compromise of + the systems on which the proxies run can result in serious security + and privacy problems. Proxies have access to security-related + information, personal information about individual users and + organizations, and proprietary information belonging to users and + content providers. A compromised proxy, or a proxy implemented or + configured without regard to security and privacy considerations, + might be used in the commission of a wide range of potential attacks. + + Proxy operators should protect the systems on which proxies run as + they would protect any system that contains or transports sensitive + information. In particular, log information gathered at proxies often + contains highly sensitive personal information, and/or information + about organizations. Log information should be carefully guarded, and + appropriate guidelines for use developed and followed. (Section + 15.1.1). + + + + + + +Fielding, et al. Standards Track [Page 155] + +RFC 2616 HTTP/1.1 June 1999 + + + Caching proxies provide additional potential vulnerabilities, since + the contents of the cache represent an attractive target for + malicious exploitation. Because cache contents persist after an HTTP + request is complete, an attack on the cache can reveal information + long after a user believes that the information has been removed from + the network. Therefore, cache contents should be protected as + sensitive information. + + Proxy implementors should consider the privacy and security + implications of their design and coding decisions, and of the + configuration options they provide to proxy operators (especially the + default configuration). + + Users of a proxy need to be aware that they are no trustworthier than + the people who run the proxy; HTTP itself cannot solve this problem. + + The judicious use of cryptography, when appropriate, may suffice to + protect against a broad range of security and privacy attacks. Such + cryptography is beyond the scope of the HTTP/1.1 specification. + +15.7.1 Denial of Service Attacks on Proxies + + They exist. They are hard to defend against. Research continues. + Beware. + +16 Acknowledgments + + This specification makes heavy use of the augmented BNF and generic + constructs defined by David H. Crocker for RFC 822 [9]. Similarly, it + reuses many of the definitions provided by Nathaniel Borenstein and + Ned Freed for MIME [7]. We hope that their inclusion in this + specification will help reduce past confusion over the relationship + between HTTP and Internet mail message formats. + + The HTTP protocol has evolved considerably over the years. It has + benefited from a large and active developer community--the many + people who have participated on the www-talk mailing list--and it is + that community which has been most responsible for the success of + HTTP and of the World-Wide Web in general. Marc Andreessen, Robert + Cailliau, Daniel W. Connolly, Bob Denny, John Franks, Jean-Francois + Groff, Phillip M. Hallam-Baker, Hakon W. Lie, Ari Luotonen, Rob + McCool, Lou Montulli, Dave Raggett, Tony Sanders, and Marc + VanHeyningen deserve special recognition for their efforts in + defining early aspects of the protocol. + + This document has benefited greatly from the comments of all those + participating in the HTTP-WG. In addition to those already mentioned, + the following individuals have contributed to this specification: + + + +Fielding, et al. Standards Track [Page 156] + +RFC 2616 HTTP/1.1 June 1999 + + + Gary Adams Ross Patterson + Harald Tveit Alvestrand Albert Lunde + Keith Ball John C. Mallery + Brian Behlendorf Jean-Philippe Martin-Flatin + Paul Burchard Mitra + Maurizio Codogno David Morris + Mike Cowlishaw Gavin Nicol + Roman Czyborra Bill Perry + Michael A. Dolan Jeffrey Perry + David J. Fiander Scott Powers + Alan Freier Owen Rees + Marc Hedlund Luigi Rizzo + Greg Herlihy David Robinson + Koen Holtman Marc Salomon + Alex Hopmann Rich Salz + Bob Jernigan Allan M. Schiffman + Shel Kaphan Jim Seidman + Rohit Khare Chuck Shotton + John Klensin Eric W. Sink + Martijn Koster Simon E. Spero + Alexei Kosut Richard N. Taylor + David M. Kristol Robert S. Thau + Daniel LaLiberte Bill (BearHeart) Weinman + Ben Laurie Francois Yergeau + Paul J. Leach Mary Ellen Zurko + Daniel DuBois Josh Cohen + + + Much of the content and presentation of the caching design is due to + suggestions and comments from individuals including: Shel Kaphan, + Paul Leach, Koen Holtman, David Morris, and Larry Masinter. + + Most of the specification of ranges is based on work originally done + by Ari Luotonen and John Franks, with additional input from Steve + Zilles. + + Thanks to the "cave men" of Palo Alto. You know who you are. + + Jim Gettys (the current editor of this document) wishes particularly + to thank Roy Fielding, the previous editor of this document, along + with John Klensin, Jeff Mogul, Paul Leach, Dave Kristol, Koen + Holtman, John Franks, Josh Cohen, Alex Hopmann, Scott Lawrence, and + Larry Masinter for their help. And thanks go particularly to Jeff + Mogul and Scott Lawrence for performing the "MUST/MAY/SHOULD" audit. + + + + + + + +Fielding, et al. Standards Track [Page 157] + +RFC 2616 HTTP/1.1 June 1999 + + + The Apache Group, Anselm Baird-Smith, author of Jigsaw, and Henrik + Frystyk implemented RFC 2068 early, and we wish to thank them for the + discovery of many of the problems that this document attempts to + rectify. + +17 References + + [1] Alvestrand, H., "Tags for the Identification of Languages", RFC + 1766, March 1995. + + [2] Anklesaria, F., McCahill, M., Lindner, P., Johnson, D., Torrey, + D. and B. Alberti, "The Internet Gopher Protocol (a distributed + document search and retrieval protocol)", RFC 1436, March 1993. + + [3] Berners-Lee, T., "Universal Resource Identifiers in WWW", RFC + 1630, June 1994. + + [4] Berners-Lee, T., Masinter, L. and M. McCahill, "Uniform Resource + Locators (URL)", RFC 1738, December 1994. + + [5] Berners-Lee, T. and D. Connolly, "Hypertext Markup Language - + 2.0", RFC 1866, November 1995. + + [6] Berners-Lee, T., Fielding, R. and H. Frystyk, "Hypertext Transfer + Protocol -- HTTP/1.0", RFC 1945, May 1996. + + [7] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part One: Format of Internet Message Bodies", + RFC 2045, November 1996. + + [8] Braden, R., "Requirements for Internet Hosts -- Communication + Layers", STD 3, RFC 1123, October 1989. + + [9] Crocker, D., "Standard for The Format of ARPA Internet Text + Messages", STD 11, RFC 822, August 1982. + + [10] Davis, F., Kahle, B., Morris, H., Salem, J., Shen, T., Wang, R., + Sui, J., and M. Grinbaum, "WAIS Interface Protocol Prototype + Functional Specification," (v1.5), Thinking Machines + Corporation, April 1990. + + [11] Fielding, R., "Relative Uniform Resource Locators", RFC 1808, + June 1995. + + [12] Horton, M. and R. Adams, "Standard for Interchange of USENET + Messages", RFC 1036, December 1987. + + + + + +Fielding, et al. Standards Track [Page 158] + +RFC 2616 HTTP/1.1 June 1999 + + + [13] Kantor, B. and P. Lapsley, "Network News Transfer Protocol", RFC + 977, February 1986. + + [14] Moore, K., "MIME (Multipurpose Internet Mail Extensions) Part + Three: Message Header Extensions for Non-ASCII Text", RFC 2047, + November 1996. + + [15] Nebel, E. and L. Masinter, "Form-based File Upload in HTML", RFC + 1867, November 1995. + + [16] Postel, J., "Simple Mail Transfer Protocol", STD 10, RFC 821, + August 1982. + + [17] Postel, J., "Media Type Registration Procedure", RFC 1590, + November 1996. + + [18] Postel, J. and J. Reynolds, "File Transfer Protocol", STD 9, RFC + 959, October 1985. + + [19] Reynolds, J. and J. Postel, "Assigned Numbers", STD 2, RFC 1700, + October 1994. + + [20] Sollins, K. and L. Masinter, "Functional Requirements for + Uniform Resource Names", RFC 1737, December 1994. + + [21] US-ASCII. Coded Character Set - 7-Bit American Standard Code for + Information Interchange. Standard ANSI X3.4-1986, ANSI, 1986. + + [22] ISO-8859. International Standard -- Information Processing -- + 8-bit Single-Byte Coded Graphic Character Sets -- + Part 1: Latin alphabet No. 1, ISO-8859-1:1987. + Part 2: Latin alphabet No. 2, ISO-8859-2, 1987. + Part 3: Latin alphabet No. 3, ISO-8859-3, 1988. + Part 4: Latin alphabet No. 4, ISO-8859-4, 1988. + Part 5: Latin/Cyrillic alphabet, ISO-8859-5, 1988. + Part 6: Latin/Arabic alphabet, ISO-8859-6, 1987. + Part 7: Latin/Greek alphabet, ISO-8859-7, 1987. + Part 8: Latin/Hebrew alphabet, ISO-8859-8, 1988. + Part 9: Latin alphabet No. 5, ISO-8859-9, 1990. + + [23] Meyers, J. and M. Rose, "The Content-MD5 Header Field", RFC + 1864, October 1995. + + [24] Carpenter, B. and Y. Rekhter, "Renumbering Needs Work", RFC + 1900, February 1996. + + [25] Deutsch, P., "GZIP file format specification version 4.3", RFC + 1952, May 1996. + + + +Fielding, et al. Standards Track [Page 159] + +RFC 2616 HTTP/1.1 June 1999 + + + [26] Venkata N. Padmanabhan, and Jeffrey C. Mogul. "Improving HTTP + Latency", Computer Networks and ISDN Systems, v. 28, pp. 25-35, + Dec. 1995. Slightly revised version of paper in Proc. 2nd + International WWW Conference '94: Mosaic and the Web, Oct. 1994, + which is available at + http://www.ncsa.uiuc.edu/SDG/IT94/Proceedings/DDay/mogul/HTTPLat + ency.html. + + [27] Joe Touch, John Heidemann, and Katia Obraczka. "Analysis of HTTP + Performance", , + ISI Research Report ISI/RR-98-463, (original report dated Aug. + 1996), USC/Information Sciences Institute, August 1998. + + [28] Mills, D., "Network Time Protocol (Version 3) Specification, + Implementation and Analysis", RFC 1305, March 1992. + + [29] Deutsch, P., "DEFLATE Compressed Data Format Specification + version 1.3", RFC 1951, May 1996. + + [30] S. Spero, "Analysis of HTTP Performance Problems," + http://sunsite.unc.edu/mdma-release/http-prob.html. + + [31] Deutsch, P. and J. Gailly, "ZLIB Compressed Data Format + Specification version 3.3", RFC 1950, May 1996. + + [32] Franks, J., Hallam-Baker, P., Hostetler, J., Leach, P., + Luotonen, A., Sink, E. and L. Stewart, "An Extension to HTTP: + Digest Access Authentication", RFC 2069, January 1997. + + [33] Fielding, R., Gettys, J., Mogul, J., Frystyk, H. and T. + Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1", RFC + 2068, January 1997. + + [34] Bradner, S., "Key words for use in RFCs to Indicate Requirement + Levels", BCP 14, RFC 2119, March 1997. + + [35] Troost, R. and Dorner, S., "Communicating Presentation + Information in Internet Messages: The Content-Disposition + Header", RFC 1806, June 1995. + + [36] Mogul, J., Fielding, R., Gettys, J. and H. Frystyk, "Use and + Interpretation of HTTP Version Numbers", RFC 2145, May 1997. + [jg639] + + [37] Palme, J., "Common Internet Message Headers", RFC 2076, February + 1997. [jg640] + + + + + +Fielding, et al. Standards Track [Page 160] + +RFC 2616 HTTP/1.1 June 1999 + + + [38] Yergeau, F., "UTF-8, a transformation format of Unicode and + ISO-10646", RFC 2279, January 1998. [jg641] + + [39] Nielsen, H.F., Gettys, J., Baird-Smith, A., Prud'hommeaux, E., + Lie, H., and C. Lilley. "Network Performance Effects of + HTTP/1.1, CSS1, and PNG," Proceedings of ACM SIGCOMM '97, Cannes + France, September 1997.[jg642] + + [40] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Two: Media Types", RFC 2046, November + 1996. [jg643] + + [41] Alvestrand, H., "IETF Policy on Character Sets and Languages", + BCP 18, RFC 2277, January 1998. [jg644] + + [42] Berners-Lee, T., Fielding, R. and L. Masinter, "Uniform Resource + Identifiers (URI): Generic Syntax and Semantics", RFC 2396, + August 1998. [jg645] + + [43] Franks, J., Hallam-Baker, P., Hostetler, J., Lawrence, S., + Leach, P., Luotonen, A., Sink, E. and L. Stewart, "HTTP + Authentication: Basic and Digest Access Authentication", RFC + 2617, June 1999. [jg646] + + [44] Luotonen, A., "Tunneling TCP based protocols through Web proxy + servers," Work in Progress. [jg647] + + [45] Palme, J. and A. Hopmann, "MIME E-mail Encapsulation of + Aggregate Documents, such as HTML (MHTML)", RFC 2110, March + 1997. + + [46] Bradner, S., "The Internet Standards Process -- Revision 3", BCP + 9, RFC 2026, October 1996. + + [47] Masinter, L., "Hyper Text Coffee Pot Control Protocol + (HTCPCP/1.0)", RFC 2324, 1 April 1998. + + [48] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Five: Conformance Criteria and Examples", + RFC 2049, November 1996. + + [49] Troost, R., Dorner, S. and K. Moore, "Communicating Presentation + Information in Internet Messages: The Content-Disposition Header + Field", RFC 2183, August 1997. + + + + + + + +Fielding, et al. Standards Track [Page 161] + +RFC 2616 HTTP/1.1 June 1999 + + +18 Authors' Addresses + + Roy T. Fielding + Information and Computer Science + University of California, Irvine + Irvine, CA 92697-3425, USA + + Fax: +1 (949) 824-1715 + EMail: fielding@ics.uci.edu + + + James Gettys + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: jg@w3.org + + + Jeffrey C. Mogul + Western Research Laboratory + Compaq Computer Corporation + 250 University Avenue + Palo Alto, California, 94305, USA + + EMail: mogul@wrl.dec.com + + + Henrik Frystyk Nielsen + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: frystyk@w3.org + + + Larry Masinter + Xerox Corporation + 3333 Coyote Hill Road + Palo Alto, CA 94034, USA + + EMail: masinter@parc.xerox.com + + + + + +Fielding, et al. Standards Track [Page 162] + +RFC 2616 HTTP/1.1 June 1999 + + + Paul J. Leach + Microsoft Corporation + 1 Microsoft Way + Redmond, WA 98052, USA + + EMail: paulle@microsoft.com + + + Tim Berners-Lee + Director, World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: timbl@w3.org + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 163] + +RFC 2616 HTTP/1.1 June 1999 + + +19 Appendices + +19.1 Internet Media Type message/http and application/http + + In addition to defining the HTTP/1.1 protocol, this document serves + as the specification for the Internet media type "message/http" and + "application/http". The message/http type can be used to enclose a + single HTTP request or response message, provided that it obeys the + MIME restrictions for all "message" types regarding line length and + encodings. The application/http type can be used to enclose a + pipeline of one or more HTTP request or response messages (not + intermixed). The following is to be registered with IANA [17]. + + Media Type name: message + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed message + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + Media Type name: application + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed messages + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: HTTP messages enclosed by this type + are in "binary" format; use of an appropriate + Content-Transfer-Encoding is required when + transmitted via E-mail. + Security considerations: none + + + + + + + + + +Fielding, et al. Standards Track [Page 164] + +RFC 2616 HTTP/1.1 June 1999 + + +19.2 Internet Media Type multipart/byteranges + + When an HTTP 206 (Partial Content) response message includes the + content of multiple ranges (a response to a request for multiple + non-overlapping ranges), these are transmitted as a multipart + message-body. The media type for this purpose is called + "multipart/byteranges". + + The multipart/byteranges media type includes two or more parts, each + with its own Content-Type and Content-Range fields. The required + boundary parameter specifies the boundary string used to separate + each body-part. + + Media Type name: multipart + Media subtype name: byteranges + Required parameters: boundary + Optional parameters: none + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + + For example: + + HTTP/1.1 206 Partial Content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-type: multipart/byteranges; boundary=THIS_STRING_SEPARATES + + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 500-999/8000 + + ...the first range... + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 7000-7999/8000 + + ...the second range + --THIS_STRING_SEPARATES-- + + Notes: + + 1) Additional CRLFs may precede the first boundary string in the + entity. + + + + + + +Fielding, et al. Standards Track [Page 165] + +RFC 2616 HTTP/1.1 June 1999 + + + 2) Although RFC 2046 [40] permits the boundary string to be + quoted, some existing implementations handle a quoted boundary + string incorrectly. + + 3) A number of browsers and servers were coded to an early draft + of the byteranges specification to use a media type of + multipart/x-byteranges, which is almost, but not quite + compatible with the version documented in HTTP/1.1. + +19.3 Tolerant Applications + + Although this document specifies the requirements for the generation + of HTTP/1.1 messages, not all applications will be correct in their + implementation. We therefore recommend that operational applications + be tolerant of deviations whenever those deviations can be + interpreted unambiguously. + + Clients SHOULD be tolerant in parsing the Status-Line and servers + tolerant when parsing the Request-Line. In particular, they SHOULD + accept any amount of SP or HT characters between fields, even though + only a single SP is required. + + The line terminator for message-header fields is the sequence CRLF. + However, we recommend that applications, when parsing such headers, + recognize a single LF as a line terminator and ignore the leading CR. + + The character set of an entity-body SHOULD be labeled as the lowest + common denominator of the character codes used within that body, with + the exception that not labeling the entity is preferred over labeling + the entity with the labels US-ASCII or ISO-8859-1. See section 3.7.1 + and 3.4.1. + + Additional rules for requirements on parsing and encoding of dates + and other potential problems with date encodings include: + + - HTTP/1.1 clients and caches SHOULD assume that an RFC-850 date + which appears to be more than 50 years in the future is in fact + in the past (this helps solve the "year 2000" problem). + + - An HTTP/1.1 implementation MAY internally represent a parsed + Expires date as earlier than the proper value, but MUST NOT + internally represent a parsed Expires date as later than the + proper value. + + - All expiration-related calculations MUST be done in GMT. The + local time zone MUST NOT influence the calculation or comparison + of an age or expiration time. + + + + +Fielding, et al. Standards Track [Page 166] + +RFC 2616 HTTP/1.1 June 1999 + + + - If an HTTP header incorrectly carries a date value with a time + zone other than GMT, it MUST be converted into GMT using the + most conservative possible conversion. + +19.4 Differences Between HTTP Entities and RFC 2045 Entities + + HTTP/1.1 uses many of the constructs defined for Internet Mail (RFC + 822 [9]) and the Multipurpose Internet Mail Extensions (MIME [7]) to + allow entities to be transmitted in an open variety of + representations and with extensible mechanisms. However, RFC 2045 + discusses mail, and HTTP has a few features that are different from + those described in RFC 2045. These differences were carefully chosen + to optimize performance over binary connections, to allow greater + freedom in the use of new media types, to make date comparisons + easier, and to acknowledge the practice of some early HTTP servers + and clients. + + This appendix describes specific areas where HTTP differs from RFC + 2045. Proxies and gateways to strict MIME environments SHOULD be + aware of these differences and provide the appropriate conversions + where necessary. Proxies and gateways from MIME environments to HTTP + also need to be aware of the differences because some conversions + might be required. + +19.4.1 MIME-Version + + HTTP is not a MIME-compliant protocol. However, HTTP/1.1 messages MAY + include a single MIME-Version general-header field to indicate what + version of the MIME protocol was used to construct the message. Use + of the MIME-Version header field indicates that the message is in + full compliance with the MIME protocol (as defined in RFC 2045[7]). + Proxies/gateways are responsible for ensuring full compliance (where + possible) when exporting HTTP messages to strict MIME environments. + + MIME-Version = "MIME-Version" ":" 1*DIGIT "." 1*DIGIT + + MIME version "1.0" is the default for use in HTTP/1.1. However, + HTTP/1.1 message parsing and semantics are defined by this document + and not the MIME specification. + +19.4.2 Conversion to Canonical Form + + RFC 2045 [7] requires that an Internet mail entity be converted to + canonical form prior to being transferred, as described in section 4 + of RFC 2049 [48]. Section 3.7.1 of this document describes the forms + allowed for subtypes of the "text" media type when transmitted over + HTTP. RFC 2046 requires that content with a type of "text" represent + line breaks as CRLF and forbids the use of CR or LF outside of line + + + +Fielding, et al. Standards Track [Page 167] + +RFC 2616 HTTP/1.1 June 1999 + + + break sequences. HTTP allows CRLF, bare CR, and bare LF to indicate a + line break within text content when a message is transmitted over + HTTP. + + Where it is possible, a proxy or gateway from HTTP to a strict MIME + environment SHOULD translate all line breaks within the text media + types described in section 3.7.1 of this document to the RFC 2049 + canonical form of CRLF. Note, however, that this might be complicated + by the presence of a Content-Encoding and by the fact that HTTP + allows the use of some character sets which do not use octets 13 and + 10 to represent CR and LF, as is the case for some multi-byte + character sets. + + Implementors should note that conversion will break any cryptographic + checksums applied to the original content unless the original content + is already in canonical form. Therefore, the canonical form is + recommended for any content that uses such checksums in HTTP. + +19.4.3 Conversion of Date Formats + + HTTP/1.1 uses a restricted set of date formats (section 3.3.1) to + simplify the process of date comparison. Proxies and gateways from + other protocols SHOULD ensure that any Date header field present in a + message conforms to one of the HTTP/1.1 formats and rewrite the date + if necessary. + +19.4.4 Introduction of Content-Encoding + + RFC 2045 does not include any concept equivalent to HTTP/1.1's + Content-Encoding header field. Since this acts as a modifier on the + media type, proxies and gateways from HTTP to MIME-compliant + protocols MUST either change the value of the Content-Type header + field or decode the entity-body before forwarding the message. (Some + experimental applications of Content-Type for Internet mail have used + a media-type parameter of ";conversions=" to perform + a function equivalent to Content-Encoding. However, this parameter is + not part of RFC 2045.) + +19.4.5 No Content-Transfer-Encoding + + HTTP does not use the Content-Transfer-Encoding (CTE) field of RFC + 2045. Proxies and gateways from MIME-compliant protocols to HTTP MUST + remove any non-identity CTE ("quoted-printable" or "base64") encoding + prior to delivering the response message to an HTTP client. + + Proxies and gateways from HTTP to MIME-compliant protocols are + responsible for ensuring that the message is in the correct format + and encoding for safe transport on that protocol, where "safe + + + +Fielding, et al. Standards Track [Page 168] + +RFC 2616 HTTP/1.1 June 1999 + + + transport" is defined by the limitations of the protocol being used. + Such a proxy or gateway SHOULD label the data with an appropriate + Content-Transfer-Encoding if doing so will improve the likelihood of + safe transport over the destination protocol. + +19.4.6 Introduction of Transfer-Encoding + + HTTP/1.1 introduces the Transfer-Encoding header field (section + 14.41). Proxies/gateways MUST remove any transfer-coding prior to + forwarding a message via a MIME-compliant protocol. + + A process for decoding the "chunked" transfer-coding (section 3.6) + can be represented in pseudo-code as: + + length := 0 + read chunk-size, chunk-extension (if any) and CRLF + while (chunk-size > 0) { + read chunk-data and CRLF + append chunk-data to entity-body + length := length + chunk-size + read chunk-size and CRLF + } + read entity-header + while (entity-header not empty) { + append entity-header to existing header fields + read entity-header + } + Content-Length := length + Remove "chunked" from Transfer-Encoding + +19.4.7 MHTML and Line Length Limitations + + HTTP implementations which share code with MHTML [45] implementations + need to be aware of MIME line length limitations. Since HTTP does not + have this limitation, HTTP does not fold long lines. MHTML messages + being transported by HTTP follow all conventions of MHTML, including + line length limitations and folding, canonicalization, etc., since + HTTP transports all message-bodies as payload (see section 3.7.2) and + does not interpret the content or any MIME header lines that might be + contained therein. + +19.5 Additional Features + + RFC 1945 and RFC 2068 document protocol elements used by some + existing HTTP implementations, but not consistently and correctly + across most HTTP/1.1 applications. Implementors are advised to be + aware of these features, but cannot rely upon their presence in, or + interoperability with, other HTTP/1.1 applications. Some of these + + + +Fielding, et al. Standards Track [Page 169] + +RFC 2616 HTTP/1.1 June 1999 + + + describe proposed experimental features, and some describe features + that experimental deployment found lacking that are now addressed in + the base HTTP/1.1 specification. + + A number of other headers, such as Content-Disposition and Title, + from SMTP and MIME are also often implemented (see RFC 2076 [37]). + +19.5.1 Content-Disposition + + The Content-Disposition response-header field has been proposed as a + means for the origin server to suggest a default filename if the user + requests that the content is saved to a file. This usage is derived + from the definition of Content-Disposition in RFC 1806 [35]. + + content-disposition = "Content-Disposition" ":" + disposition-type *( ";" disposition-parm ) + disposition-type = "attachment" | disp-extension-token + disposition-parm = filename-parm | disp-extension-parm + filename-parm = "filename" "=" quoted-string + disp-extension-token = token + disp-extension-parm = token "=" ( token | quoted-string ) + + An example is + + Content-Disposition: attachment; filename="fname.ext" + + The receiving user agent SHOULD NOT respect any directory path + information present in the filename-parm parameter, which is the only + parameter believed to apply to HTTP implementations at this time. The + filename SHOULD be treated as a terminal component only. + + If this header is used in a response with the application/octet- + stream content-type, the implied suggestion is that the user agent + should not display the response, but directly enter a `save response + as...' dialog. + + See section 15.5 for Content-Disposition security issues. + +19.6 Compatibility with Previous Versions + + It is beyond the scope of a protocol specification to mandate + compliance with previous versions. HTTP/1.1 was deliberately + designed, however, to make supporting previous versions easy. It is + worth noting that, at the time of composing this specification + (1996), we would expect commercial HTTP/1.1 servers to: + + - recognize the format of the Request-Line for HTTP/0.9, 1.0, and + 1.1 requests; + + + +Fielding, et al. Standards Track [Page 170] + +RFC 2616 HTTP/1.1 June 1999 + + + - understand any valid request in the format of HTTP/0.9, 1.0, or + 1.1; + + - respond appropriately with a message in the same major version + used by the client. + + And we would expect HTTP/1.1 clients to: + + - recognize the format of the Status-Line for HTTP/1.0 and 1.1 + responses; + + - understand any valid response in the format of HTTP/0.9, 1.0, or + 1.1. + + For most implementations of HTTP/1.0, each connection is established + by the client prior to the request and closed by the server after + sending the response. Some implementations implement the Keep-Alive + version of persistent connections described in section 19.7.1 of RFC + 2068 [33]. + +19.6.1 Changes from HTTP/1.0 + + This section summarizes major differences between versions HTTP/1.0 + and HTTP/1.1. + +19.6.1.1 Changes to Simplify Multi-homed Web Servers and Conserve IP + Addresses + + The requirements that clients and servers support the Host request- + header, report an error if the Host request-header (section 14.23) is + missing from an HTTP/1.1 request, and accept absolute URIs (section + 5.1.2) are among the most important changes defined by this + specification. + + Older HTTP/1.0 clients assumed a one-to-one relationship of IP + addresses and servers; there was no other established mechanism for + distinguishing the intended server of a request than the IP address + to which that request was directed. The changes outlined above will + allow the Internet, once older HTTP clients are no longer common, to + support multiple Web sites from a single IP address, greatly + simplifying large operational Web servers, where allocation of many + IP addresses to a single host has created serious problems. The + Internet will also be able to recover the IP addresses that have been + allocated for the sole purpose of allowing special-purpose domain + names to be used in root-level HTTP URLs. Given the rate of growth of + the Web, and the number of servers already deployed, it is extremely + + + + + +Fielding, et al. Standards Track [Page 171] + +RFC 2616 HTTP/1.1 June 1999 + + + important that all implementations of HTTP (including updates to + existing HTTP/1.0 applications) correctly implement these + requirements: + + - Both clients and servers MUST support the Host request-header. + + - A client that sends an HTTP/1.1 request MUST send a Host header. + + - Servers MUST report a 400 (Bad Request) error if an HTTP/1.1 + request does not include a Host request-header. + + - Servers MUST accept absolute URIs. + +19.6.2 Compatibility with HTTP/1.0 Persistent Connections + + Some clients and servers might wish to be compatible with some + previous implementations of persistent connections in HTTP/1.0 + clients and servers. Persistent connections in HTTP/1.0 are + explicitly negotiated as they are not the default behavior. HTTP/1.0 + experimental implementations of persistent connections are faulty, + and the new facilities in HTTP/1.1 are designed to rectify these + problems. The problem was that some existing 1.0 clients may be + sending Keep-Alive to a proxy server that doesn't understand + Connection, which would then erroneously forward it to the next + inbound server, which would establish the Keep-Alive connection and + result in a hung HTTP/1.0 proxy waiting for the close on the + response. The result is that HTTP/1.0 clients must be prevented from + using Keep-Alive when talking to proxies. + + However, talking to proxies is the most important use of persistent + connections, so that prohibition is clearly unacceptable. Therefore, + we need some other mechanism for indicating a persistent connection + is desired, which is safe to use even when talking to an old proxy + that ignores Connection. Persistent connections are the default for + HTTP/1.1 messages; we introduce a new keyword (Connection: close) for + declaring non-persistence. See section 14.10. + + The original HTTP/1.0 form of persistent connections (the Connection: + Keep-Alive and Keep-Alive header) is documented in RFC 2068. [33] + +19.6.3 Changes from RFC 2068 + + This specification has been carefully audited to correct and + disambiguate key word usage; RFC 2068 had many problems in respect to + the conventions laid out in RFC 2119 [34]. + + Clarified which error code should be used for inbound server failures + (e.g. DNS failures). (Section 10.5.5). + + + +Fielding, et al. Standards Track [Page 172] + +RFC 2616 HTTP/1.1 June 1999 + + + CREATE had a race that required an Etag be sent when a resource is + first created. (Section 10.2.2). + + Content-Base was deleted from the specification: it was not + implemented widely, and there is no simple, safe way to introduce it + without a robust extension mechanism. In addition, it is used in a + similar, but not identical fashion in MHTML [45]. + + Transfer-coding and message lengths all interact in ways that + required fixing exactly when chunked encoding is used (to allow for + transfer encoding that may not be self delimiting); it was important + to straighten out exactly how message lengths are computed. (Sections + 3.6, 4.4, 7.2.2, 13.5.2, 14.13, 14.16) + + A content-coding of "identity" was introduced, to solve problems + discovered in caching. (section 3.5) + + Quality Values of zero should indicate that "I don't want something" + to allow clients to refuse a representation. (Section 3.9) + + The use and interpretation of HTTP version numbers has been clarified + by RFC 2145. Require proxies to upgrade requests to highest protocol + version they support to deal with problems discovered in HTTP/1.0 + implementations (Section 3.1) + + Charset wildcarding is introduced to avoid explosion of character set + names in accept headers. (Section 14.2) + + A case was missed in the Cache-Control model of HTTP/1.1; s-maxage + was introduced to add this missing case. (Sections 13.4, 14.8, 14.9, + 14.9.3) + + The Cache-Control: max-age directive was not properly defined for + responses. (Section 14.9.3) + + There are situations where a server (especially a proxy) does not + know the full length of a response but is capable of serving a + byterange request. We therefore need a mechanism to allow byteranges + with a content-range not indicating the full length of the message. + (Section 14.16) + + Range request responses would become very verbose if all meta-data + were always returned; by allowing the server to only send needed + headers in a 206 response, this problem can be avoided. (Section + 10.2.7, 13.5.3, and 14.27) + + + + + + +Fielding, et al. Standards Track [Page 173] + +RFC 2616 HTTP/1.1 June 1999 + + + Fix problem with unsatisfiable range requests; there are two cases: + syntactic problems, and range doesn't exist in the document. The 416 + status code was needed to resolve this ambiguity needed to indicate + an error for a byte range request that falls outside of the actual + contents of a document. (Section 10.4.17, 14.16) + + Rewrite of message transmission requirements to make it much harder + for implementors to get it wrong, as the consequences of errors here + can have significant impact on the Internet, and to deal with the + following problems: + + 1. Changing "HTTP/1.1 or later" to "HTTP/1.1", in contexts where + this was incorrectly placing a requirement on the behavior of + an implementation of a future version of HTTP/1.x + + 2. Made it clear that user-agents should retry requests, not + "clients" in general. + + 3. Converted requirements for clients to ignore unexpected 100 + (Continue) responses, and for proxies to forward 100 responses, + into a general requirement for 1xx responses. + + 4. Modified some TCP-specific language, to make it clearer that + non-TCP transports are possible for HTTP. + + 5. Require that the origin server MUST NOT wait for the request + body before it sends a required 100 (Continue) response. + + 6. Allow, rather than require, a server to omit 100 (Continue) if + it has already seen some of the request body. + + 7. Allow servers to defend against denial-of-service attacks and + broken clients. + + This change adds the Expect header and 417 status code. The message + transmission requirements fixes are in sections 8.2, 10.4.18, + 8.1.2.2, 13.11, and 14.20. + + Proxies should be able to add Content-Length when appropriate. + (Section 13.5.2) + + Clean up confusion between 403 and 404 responses. (Section 10.4.4, + 10.4.5, and 10.4.11) + + Warnings could be cached incorrectly, or not updated appropriately. + (Section 13.1.2, 13.2.4, 13.5.2, 13.5.3, 14.9.3, and 14.46) Warning + also needed to be a general header, as PUT or other methods may have + need for it in requests. + + + +Fielding, et al. Standards Track [Page 174] + +RFC 2616 HTTP/1.1 June 1999 + + + Transfer-coding had significant problems, particularly with + interactions with chunked encoding. The solution is that transfer- + codings become as full fledged as content-codings. This involves + adding an IANA registry for transfer-codings (separate from content + codings), a new header field (TE) and enabling trailer headers in the + future. Transfer encoding is a major performance benefit, so it was + worth fixing [39]. TE also solves another, obscure, downward + interoperability problem that could have occurred due to interactions + between authentication trailers, chunked encoding and HTTP/1.0 + clients.(Section 3.6, 3.6.1, and 14.39) + + The PATCH, LINK, UNLINK methods were defined but not commonly + implemented in previous versions of this specification. See RFC 2068 + [33]. + + The Alternates, Content-Version, Derived-From, Link, URI, Public and + Content-Base header fields were defined in previous versions of this + specification, but not commonly implemented. See RFC 2068 [33]. + +20 Index + + Please see the PostScript version of this RFC for the INDEX. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 175] + +RFC 2616 HTTP/1.1 June 1999 + + +21. Full Copyright Statement + + Copyright (C) The Internet Society (1999). All Rights Reserved. + + This document and translations of it may be copied and furnished to + others, and derivative works that comment on or otherwise explain it + or assist in its implementation may be prepared, copied, published + and distributed, in whole or in part, without restriction of any + kind, provided that the above copyright notice and this paragraph are + included on all such copies and derivative works. However, this + document itself may not be modified in any way, such as by removing + the copyright notice or references to the Internet Society or other + Internet organizations, except as needed for the purpose of + developing Internet standards in which case the procedures for + copyrights defined in the Internet Standards process must be + followed, or as required to translate it into languages other than + English. + + The limited permissions granted above are perpetual and will not be + revoked by the Internet Society or its successors or assigns. + + This document and the information contained herein is provided on an + "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING + TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING + BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION + HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF + MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + +Acknowledgement + + Funding for the RFC Editor function is currently provided by the + Internet Society. + + Network Working Group R. Fielding +Request for Comments: 2616 UC Irvine +Obsoletes: 2068 J. Gettys +Category: Standards Track Compaq/W3C + J. Mogul + Compaq + H. Frystyk + W3C/MIT + L. Masinter + Xerox + P. Leach + Microsoft + T. Berners-Lee + W3C/MIT + June 1999 + + + Hypertext Transfer Protocol -- HTTP/1.1 + +Status of this Memo + + This document specifies an Internet standards track protocol for the + Internet community, and requests discussion and suggestions for + improvements. Please refer to the current edition of the "Internet + Official Protocol Standards" (STD 1) for the standardization state + and status of this protocol. Distribution of this memo is unlimited. + +Copyright Notice + + Copyright (C) The Internet Society (1999). All Rights Reserved. + +Abstract + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. It is a generic, stateless, protocol which can be used for + many tasks beyond its use for hypertext, such as name servers and + distributed object management systems, through extension of its + request methods, error codes and headers [47]. A feature of HTTP is + the typing and negotiation of data representation, allowing systems + to be built independently of the data being transferred. + + HTTP has been in use by the World-Wide Web global information + initiative since 1990. This specification defines the protocol + referred to as "HTTP/1.1", and is an update to RFC 2068 [33]. + + + + + + +Fielding, et al. Standards Track [Page 1] + +RFC 2616 HTTP/1.1 June 1999 + + +Table of Contents + + 1 Introduction ...................................................7 + 1.1 Purpose......................................................7 + 1.2 Requirements .................................................8 + 1.3 Terminology ..................................................8 + 1.4 Overall Operation ...........................................12 + 2 Notational Conventions and Generic Grammar ....................14 + 2.1 Augmented BNF ...............................................14 + 2.2 Basic Rules .................................................15 + 3 Protocol Parameters ...........................................17 + 3.1 HTTP Version ................................................17 + 3.2 Uniform Resource Identifiers ................................18 + 3.2.1 General Syntax ...........................................19 + 3.2.2 http URL .................................................19 + 3.2.3 URI Comparison ...........................................20 + 3.3 Date/Time Formats ...........................................20 + 3.3.1 Full Date ................................................20 + 3.3.2 Delta Seconds ............................................21 + 3.4 Character Sets ..............................................21 + 3.4.1 Missing Charset ..........................................22 + 3.5 Content Codings .............................................23 + 3.6 Transfer Codings ............................................24 + 3.6.1 Chunked Transfer Coding ..................................25 + 3.7 Media Types .................................................26 + 3.7.1 Canonicalization and Text Defaults .......................27 + 3.7.2 Multipart Types ..........................................27 + 3.8 Product Tokens ..............................................28 + 3.9 Quality Values ..............................................29 + 3.10 Language Tags ...............................................29 + 3.11 Entity Tags .................................................30 + 3.12 Range Units .................................................30 + 4 HTTP Message ..................................................31 + 4.1 Message Types ...............................................31 + 4.2 Message Headers .............................................31 + 4.3 Message Body ................................................32 + 4.4 Message Length ..............................................33 + 4.5 General Header Fields .......................................34 + 5 Request .......................................................35 + 5.1 Request-Line ................................................35 + 5.1.1 Method ...................................................36 + 5.1.2 Request-URI ..............................................36 + 5.2 The Resource Identified by a Request ........................38 + 5.3 Request Header Fields .......................................38 + 6 Response ......................................................39 + 6.1 Status-Line .................................................39 + 6.1.1 Status Code and Reason Phrase ............................39 + 6.2 Response Header Fields ......................................41 + + + +Fielding, et al. Standards Track [Page 2] + +RFC 2616 HTTP/1.1 June 1999 + + + 7 Entity ........................................................42 + 7.1 Entity Header Fields ........................................42 + 7.2 Entity Body .................................................43 + 7.2.1 Type .....................................................43 + 7.2.2 Entity Length ............................................43 + 8 Connections ...................................................44 + 8.1 Persistent Connections ......................................44 + 8.1.1 Purpose ..................................................44 + 8.1.2 Overall Operation ........................................45 + 8.1.3 Proxy Servers ............................................46 + 8.1.4 Practical Considerations .................................46 + 8.2 Message Transmission Requirements ...........................47 + 8.2.1 Persistent Connections and Flow Control ..................47 + 8.2.2 Monitoring Connections for Error Status Messages .........48 + 8.2.3 Use of the 100 (Continue) Status .........................48 + 8.2.4 Client Behavior if Server Prematurely Closes Connection ..50 + 9 Method Definitions ............................................51 + 9.1 Safe and Idempotent Methods .................................51 + 9.1.1 Safe Methods .............................................51 + 9.1.2 Idempotent Methods .......................................51 + 9.2 OPTIONS .....................................................52 + 9.3 GET .........................................................53 + 9.4 HEAD ........................................................54 + 9.5 POST ........................................................54 + 9.6 PUT .........................................................55 + 9.7 DELETE ......................................................56 + 9.8 TRACE .......................................................56 + 9.9 CONNECT .....................................................57 + 10 Status Code Definitions ......................................57 + 10.1 Informational 1xx ...........................................57 + 10.1.1 100 Continue .............................................58 + 10.1.2 101 Switching Protocols ..................................58 + 10.2 Successful 2xx ..............................................58 + 10.2.1 200 OK ...................................................58 + 10.2.2 201 Created ..............................................59 + 10.2.3 202 Accepted .............................................59 + 10.2.4 203 Non-Authoritative Information ........................59 + 10.2.5 204 No Content ...........................................60 + 10.2.6 205 Reset Content ........................................60 + 10.2.7 206 Partial Content ......................................60 + 10.3 Redirection 3xx .............................................61 + 10.3.1 300 Multiple Choices .....................................61 + 10.3.2 301 Moved Permanently ....................................62 + 10.3.3 302 Found ................................................62 + 10.3.4 303 See Other ............................................63 + 10.3.5 304 Not Modified .........................................63 + 10.3.6 305 Use Proxy ............................................64 + 10.3.7 306 (Unused) .............................................64 + + + +Fielding, et al. Standards Track [Page 3] + +RFC 2616 HTTP/1.1 June 1999 + + + 10.3.8 307 Temporary Redirect ...................................65 + 10.4 Client Error 4xx ............................................65 + 10.4.1 400 Bad Request .........................................65 + 10.4.2 401 Unauthorized ........................................66 + 10.4.3 402 Payment Required ....................................66 + 10.4.4 403 Forbidden ...........................................66 + 10.4.5 404 Not Found ...........................................66 + 10.4.6 405 Method Not Allowed ..................................66 + 10.4.7 406 Not Acceptable ......................................67 + 10.4.8 407 Proxy Authentication Required .......................67 + 10.4.9 408 Request Timeout .....................................67 + 10.4.10 409 Conflict ............................................67 + 10.4.11 410 Gone ................................................68 + 10.4.12 411 Length Required .....................................68 + 10.4.13 412 Precondition Failed .................................68 + 10.4.14 413 Request Entity Too Large ............................69 + 10.4.15 414 Request-URI Too Long ................................69 + 10.4.16 415 Unsupported Media Type ..............................69 + 10.4.17 416 Requested Range Not Satisfiable .....................69 + 10.4.18 417 Expectation Failed ..................................70 + 10.5 Server Error 5xx ............................................70 + 10.5.1 500 Internal Server Error ................................70 + 10.5.2 501 Not Implemented ......................................70 + 10.5.3 502 Bad Gateway ..........................................70 + 10.5.4 503 Service Unavailable ..................................70 + 10.5.5 504 Gateway Timeout ......................................71 + 10.5.6 505 HTTP Version Not Supported ...........................71 + 11 Access Authentication ........................................71 + 12 Content Negotiation ..........................................71 + 12.1 Server-driven Negotiation ...................................72 + 12.2 Agent-driven Negotiation ....................................73 + 12.3 Transparent Negotiation .....................................74 + 13 Caching in HTTP ..............................................74 + 13.1.1 Cache Correctness ........................................75 + 13.1.2 Warnings .................................................76 + 13.1.3 Cache-control Mechanisms .................................77 + 13.1.4 Explicit User Agent Warnings .............................78 + 13.1.5 Exceptions to the Rules and Warnings .....................78 + 13.1.6 Client-controlled Behavior ...............................79 + 13.2 Expiration Model ............................................79 + 13.2.1 Server-Specified Expiration ..............................79 + 13.2.2 Heuristic Expiration .....................................80 + 13.2.3 Age Calculations .........................................80 + 13.2.4 Expiration Calculations ..................................83 + 13.2.5 Disambiguating Expiration Values .........................84 + 13.2.6 Disambiguating Multiple Responses ........................84 + 13.3 Validation Model ............................................85 + 13.3.1 Last-Modified Dates ......................................86 + + + +Fielding, et al. Standards Track [Page 4] + +RFC 2616 HTTP/1.1 June 1999 + + + 13.3.2 Entity Tag Cache Validators ..............................86 + 13.3.3 Weak and Strong Validators ...............................86 + 13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates.89 + 13.3.5 Non-validating Conditionals ..............................90 + 13.4 Response Cacheability .......................................91 + 13.5 Constructing Responses From Caches ..........................92 + 13.5.1 End-to-end and Hop-by-hop Headers ........................92 + 13.5.2 Non-modifiable Headers ...................................92 + 13.5.3 Combining Headers ........................................94 + 13.5.4 Combining Byte Ranges ....................................95 + 13.6 Caching Negotiated Responses ................................95 + 13.7 Shared and Non-Shared Caches ................................96 + 13.8 Errors or Incomplete Response Cache Behavior ................97 + 13.9 Side Effects of GET and HEAD ................................97 + 13.10 Invalidation After Updates or Deletions ...................97 + 13.11 Write-Through Mandatory ...................................98 + 13.12 Cache Replacement .........................................99 + 13.13 History Lists .............................................99 + 14 Header Field Definitions ....................................100 + 14.1 Accept .....................................................100 + 14.2 Accept-Charset .............................................102 + 14.3 Accept-Encoding ............................................102 + 14.4 Accept-Language ............................................104 + 14.5 Accept-Ranges ..............................................105 + 14.6 Age ........................................................106 + 14.7 Allow ......................................................106 + 14.8 Authorization ..............................................107 + 14.9 Cache-Control ..............................................108 + 14.9.1 What is Cacheable .......................................109 + 14.9.2 What May be Stored by Caches ............................110 + 14.9.3 Modifications of the Basic Expiration Mechanism .........111 + 14.9.4 Cache Revalidation and Reload Controls ..................113 + 14.9.5 No-Transform Directive ..................................115 + 14.9.6 Cache Control Extensions ................................116 + 14.10 Connection ...............................................117 + 14.11 Content-Encoding .........................................118 + 14.12 Content-Language .........................................118 + 14.13 Content-Length ...........................................119 + 14.14 Content-Location .........................................120 + 14.15 Content-MD5 ..............................................121 + 14.16 Content-Range ............................................122 + 14.17 Content-Type .............................................124 + 14.18 Date .....................................................124 + 14.18.1 Clockless Origin Server Operation ......................125 + 14.19 ETag .....................................................126 + 14.20 Expect ...................................................126 + 14.21 Expires ..................................................127 + 14.22 From .....................................................128 + + + +Fielding, et al. Standards Track [Page 5] + +RFC 2616 HTTP/1.1 June 1999 + + + 14.23 Host .....................................................128 + 14.24 If-Match .................................................129 + 14.25 If-Modified-Since ........................................130 + 14.26 If-None-Match ............................................132 + 14.27 If-Range .................................................133 + 14.28 If-Unmodified-Since ......................................134 + 14.29 Last-Modified ............................................134 + 14.30 Location .................................................135 + 14.31 Max-Forwards .............................................136 + 14.32 Pragma ...................................................136 + 14.33 Proxy-Authenticate .......................................137 + 14.34 Proxy-Authorization ......................................137 + 14.35 Range ....................................................138 + 14.35.1 Byte Ranges ...........................................138 + 14.35.2 Range Retrieval Requests ..............................139 + 14.36 Referer ..................................................140 + 14.37 Retry-After ..............................................141 + 14.38 Server ...................................................141 + 14.39 TE .......................................................142 + 14.40 Trailer ..................................................143 + 14.41 Transfer-Encoding..........................................143 + 14.42 Upgrade ..................................................144 + 14.43 User-Agent ...............................................145 + 14.44 Vary .....................................................145 + 14.45 Via ......................................................146 + 14.46 Warning ..................................................148 + 14.47 WWW-Authenticate .........................................150 + 15 Security Considerations .......................................150 + 15.1 Personal Information....................................151 + 15.1.1 Abuse of Server Log Information .........................151 + 15.1.2 Transfer of Sensitive Information .......................151 + 15.1.3 Encoding Sensitive Information in URI's .................152 + 15.1.4 Privacy Issues Connected to Accept Headers ..............152 + 15.2 Attacks Based On File and Path Names .......................153 + 15.3 DNS Spoofing ...............................................154 + 15.4 Location Headers and Spoofing ..............................154 + 15.5 Content-Disposition Issues .................................154 + 15.6 Authentication Credentials and Idle Clients ................155 + 15.7 Proxies and Caching ........................................155 + 15.7.1 Denial of Service Attacks on Proxies....................156 + 16 Acknowledgments .............................................156 + 17 References ..................................................158 + 18 Authors' Addresses ..........................................162 + 19 Appendices ..................................................164 + 19.1 Internet Media Type message/http and application/http ......164 + 19.2 Internet Media Type multipart/byteranges ...................165 + 19.3 Tolerant Applications ......................................166 + 19.4 Differences Between HTTP Entities and RFC 2045 Entities ....167 + + + +Fielding, et al. Standards Track [Page 6] + +RFC 2616 HTTP/1.1 June 1999 + + + 19.4.1 MIME-Version ............................................167 + 19.4.2 Conversion to Canonical Form ............................167 + 19.4.3 Conversion of Date Formats ..............................168 + 19.4.4 Introduction of Content-Encoding ........................168 + 19.4.5 No Content-Transfer-Encoding ............................168 + 19.4.6 Introduction of Transfer-Encoding .......................169 + 19.4.7 MHTML and Line Length Limitations .......................169 + 19.5 Additional Features ........................................169 + 19.5.1 Content-Disposition .....................................170 + 19.6 Compatibility with Previous Versions .......................170 + 19.6.1 Changes from HTTP/1.0 ...................................171 + 19.6.2 Compatibility with HTTP/1.0 Persistent Connections ......172 + 19.6.3 Changes from RFC 2068 ...................................172 + 20 Index .......................................................175 + 21 Full Copyright Statement ....................................176 + +1 Introduction + +1.1 Purpose + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. HTTP has been in use by the World-Wide Web global + information initiative since 1990. The first version of HTTP, + referred to as HTTP/0.9, was a simple protocol for raw data transfer + across the Internet. HTTP/1.0, as defined by RFC 1945 [6], improved + the protocol by allowing messages to be in the format of MIME-like + messages, containing metainformation about the data transferred and + modifiers on the request/response semantics. However, HTTP/1.0 does + not sufficiently take into consideration the effects of hierarchical + proxies, caching, the need for persistent connections, or virtual + hosts. In addition, the proliferation of incompletely-implemented + applications calling themselves "HTTP/1.0" has necessitated a + protocol version change in order for two communicating applications + to determine each other's true capabilities. + + This specification defines the protocol referred to as "HTTP/1.1". + This protocol includes more stringent requirements than HTTP/1.0 in + order to ensure reliable implementation of its features. + + Practical information systems require more functionality than simple + retrieval, including search, front-end update, and annotation. HTTP + allows an open-ended set of methods and headers that indicate the + purpose of a request [47]. It builds on the discipline of reference + provided by the Uniform Resource Identifier (URI) [3], as a location + (URL) [4] or name (URN) [20], for indicating the resource to which a + + + + + +Fielding, et al. Standards Track [Page 7] + +RFC 2616 HTTP/1.1 June 1999 + + + method is to be applied. Messages are passed in a format similar to + that used by Internet mail [9] as defined by the Multipurpose + Internet Mail Extensions (MIME) [7]. + + HTTP is also used as a generic protocol for communication between + user agents and proxies/gateways to other Internet systems, including + those supported by the SMTP [16], NNTP [13], FTP [18], Gopher [2], + and WAIS [10] protocols. In this way, HTTP allows basic hypermedia + access to resources available from diverse applications. + +1.2 Requirements + + The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", + "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this + document are to be interpreted as described in RFC 2119 [34]. + + An implementation is not compliant if it fails to satisfy one or more + of the MUST or REQUIRED level requirements for the protocols it + implements. An implementation that satisfies all the MUST or REQUIRED + level and all the SHOULD level requirements for its protocols is said + to be "unconditionally compliant"; one that satisfies all the MUST + level requirements but not all the SHOULD level requirements for its + protocols is said to be "conditionally compliant." + +1.3 Terminology + + This specification uses a number of terms to refer to the roles + played by participants in, and objects of, the HTTP communication. + + connection + A transport layer virtual circuit established between two programs + for the purpose of communication. + + message + The basic unit of HTTP communication, consisting of a structured + sequence of octets matching the syntax defined in section 4 and + transmitted via the connection. + + request + An HTTP request message, as defined in section 5. + + response + An HTTP response message, as defined in section 6. + + + + + + + + +Fielding, et al. Standards Track [Page 8] + +RFC 2616 HTTP/1.1 June 1999 + + + resource + A network data object or service that can be identified by a URI, + as defined in section 3.2. Resources may be available in multiple + representations (e.g. multiple languages, data formats, size, and + resolutions) or vary in other ways. + + entity + The information transferred as the payload of a request or + response. An entity consists of metainformation in the form of + entity-header fields and content in the form of an entity-body, as + described in section 7. + + representation + An entity included with a response that is subject to content + negotiation, as described in section 12. There may exist multiple + representations associated with a particular response status. + + content negotiation + The mechanism for selecting the appropriate representation when + servicing a request, as described in section 12. The + representation of entities in any response can be negotiated + (including error responses). + + variant + A resource may have one, or more than one, representation(s) + associated with it at any given instant. Each of these + representations is termed a `varriant'. Use of the term `variant' + does not necessarily imply that the resource is subject to content + negotiation. + + client + A program that establishes connections for the purpose of sending + requests. + + user agent + The client which initiates a request. These are often browsers, + editors, spiders (web-traversing robots), or other end user tools. + + server + An application program that accepts connections in order to + service requests by sending back responses. Any given program may + be capable of being both a client and a server; our use of these + terms refers only to the role being performed by the program for a + particular connection, rather than to the program's capabilities + in general. Likewise, any server may act as an origin server, + proxy, gateway, or tunnel, switching behavior based on the nature + of each request. + + + + +Fielding, et al. Standards Track [Page 9] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server + The server on which a given resource resides or is to be created. + + proxy + An intermediary program which acts as both a server and a client + for the purpose of making requests on behalf of other clients. + Requests are serviced internally or by passing them on, with + possible translation, to other servers. A proxy MUST implement + both the client and server requirements of this specification. A + "transparent proxy" is a proxy that does not modify the request or + response beyond what is required for proxy authentication and + identification. A "non-transparent proxy" is a proxy that modifies + the request or response in order to provide some added service to + the user agent, such as group annotation services, media type + transformation, protocol reduction, or anonymity filtering. Except + where either transparent or non-transparent behavior is explicitly + stated, the HTTP proxy requirements apply to both types of + proxies. + + gateway + A server which acts as an intermediary for some other server. + Unlike a proxy, a gateway receives requests as if it were the + origin server for the requested resource; the requesting client + may not be aware that it is communicating with a gateway. + + tunnel + An intermediary program which is acting as a blind relay between + two connections. Once active, a tunnel is not considered a party + to the HTTP communication, though the tunnel may have been + initiated by an HTTP request. The tunnel ceases to exist when both + ends of the relayed connections are closed. + + cache + A program's local store of response messages and the subsystem + that controls its message storage, retrieval, and deletion. A + cache stores cacheable responses in order to reduce the response + time and network bandwidth consumption on future, equivalent + requests. Any client or server may include a cache, though a cache + cannot be used by a server that is acting as a tunnel. + + cacheable + A response is cacheable if a cache is allowed to store a copy of + the response message for use in answering subsequent requests. The + rules for determining the cacheability of HTTP responses are + defined in section 13. Even if a resource is cacheable, there may + be additional constraints on whether a cache can use the cached + copy for a particular request. + + + + +Fielding, et al. Standards Track [Page 10] + +RFC 2616 HTTP/1.1 June 1999 + + + first-hand + A response is first-hand if it comes directly and without + unnecessary delay from the origin server, perhaps via one or more + proxies. A response is also first-hand if its validity has just + been checked directly with the origin server. + + explicit expiration time + The time at which the origin server intends that an entity should + no longer be returned by a cache without further validation. + + heuristic expiration time + An expiration time assigned by a cache when no explicit expiration + time is available. + + age + The age of a response is the time since it was sent by, or + successfully validated with, the origin server. + + freshness lifetime + The length of time between the generation of a response and its + expiration time. + + fresh + A response is fresh if its age has not yet exceeded its freshness + lifetime. + + stale + A response is stale if its age has passed its freshness lifetime. + + semantically transparent + A cache behaves in a "semantically transparent" manner, with + respect to a particular response, when its use affects neither the + requesting client nor the origin server, except to improve + performance. When a cache is semantically transparent, the client + receives exactly the same response (except for hop-by-hop headers) + that it would have received had its request been handled directly + by the origin server. + + validator + A protocol element (e.g., an entity tag or a Last-Modified time) + that is used to find out whether a cache entry is an equivalent + copy of an entity. + + upstream/downstream + Upstream and downstream describe the flow of a message: all + messages flow from upstream to downstream. + + + + + +Fielding, et al. Standards Track [Page 11] + +RFC 2616 HTTP/1.1 June 1999 + + + inbound/outbound + Inbound and outbound refer to the request and response paths for + messages: "inbound" means "traveling toward the origin server", + and "outbound" means "traveling toward the user agent" + +1.4 Overall Operation + + The HTTP protocol is a request/response protocol. A client sends a + request to the server in the form of a request method, URI, and + protocol version, followed by a MIME-like message containing request + modifiers, client information, and possible body content over a + connection with a server. The server responds with a status line, + including the message's protocol version and a success or error code, + followed by a MIME-like message containing server information, entity + metainformation, and possible entity-body content. The relationship + between HTTP and MIME is described in appendix 19.4. + + Most HTTP communication is initiated by a user agent and consists of + a request to be applied to a resource on some origin server. In the + simplest case, this may be accomplished via a single connection (v) + between the user agent (UA) and the origin server (O). + + request chain ------------------------> + UA -------------------v------------------- O + <----------------------- response chain + + A more complicated situation occurs when one or more intermediaries + are present in the request/response chain. There are three common + forms of intermediary: proxy, gateway, and tunnel. A proxy is a + forwarding agent, receiving requests for a URI in its absolute form, + rewriting all or part of the message, and forwarding the reformatted + request toward the server identified by the URI. A gateway is a + receiving agent, acting as a layer above some other server(s) and, if + necessary, translating the requests to the underlying server's + protocol. A tunnel acts as a relay point between two connections + without changing the messages; tunnels are used when the + communication needs to pass through an intermediary (such as a + firewall) even when the intermediary cannot understand the contents + of the messages. + + request chain --------------------------------------> + UA -----v----- A -----v----- B -----v----- C -----v----- O + <------------------------------------- response chain + + The figure above shows three intermediaries (A, B, and C) between the + user agent and origin server. A request or response message that + travels the whole chain will pass through four separate connections. + This distinction is important because some HTTP communication options + + + +Fielding, et al. Standards Track [Page 12] + +RFC 2616 HTTP/1.1 June 1999 + + + may apply only to the connection with the nearest, non-tunnel + neighbor, only to the end-points of the chain, or to all connections + along the chain. Although the diagram is linear, each participant may + be engaged in multiple, simultaneous communications. For example, B + may be receiving requests from many clients other than A, and/or + forwarding requests to servers other than C, at the same time that it + is handling A's request. + + Any party to the communication which is not acting as a tunnel may + employ an internal cache for handling requests. The effect of a cache + is that the request/response chain is shortened if one of the + participants along the chain has a cached response applicable to that + request. The following illustrates the resulting chain if B has a + cached copy of an earlier response from O (via C) for a request which + has not been cached by UA or A. + + request chain ----------> + UA -----v----- A -----v----- B - - - - - - C - - - - - - O + <--------- response chain + + Not all responses are usefully cacheable, and some requests may + contain modifiers which place special requirements on cache behavior. + HTTP requirements for cache behavior and cacheable responses are + defined in section 13. + + In fact, there are a wide variety of architectures and configurations + of caches and proxies currently being experimented with or deployed + across the World Wide Web. These systems include national hierarchies + of proxy caches to save transoceanic bandwidth, systems that + broadcast or multicast cache entries, organizations that distribute + subsets of cached data via CD-ROM, and so on. HTTP systems are used + in corporate intranets over high-bandwidth links, and for access via + PDAs with low-power radio links and intermittent connectivity. The + goal of HTTP/1.1 is to support the wide diversity of configurations + already deployed while introducing protocol constructs that meet the + needs of those who build web applications that require high + reliability and, failing that, at least reliable indications of + failure. + + HTTP communication usually takes place over TCP/IP connections. The + default port is TCP 80 [19], but other ports can be used. This does + not preclude HTTP from being implemented on top of any other protocol + on the Internet, or on other networks. HTTP only presumes a reliable + transport; any protocol that provides such guarantees can be used; + the mapping of the HTTP/1.1 request and response structures onto the + transport data units of the protocol in question is outside the scope + of this specification. + + + + +Fielding, et al. Standards Track [Page 13] + +RFC 2616 HTTP/1.1 June 1999 + + + In HTTP/1.0, most implementations used a new connection for each + request/response exchange. In HTTP/1.1, a connection may be used for + one or more request/response exchanges, although connections may be + closed for a variety of reasons (see section 8.1). + +2 Notational Conventions and Generic Grammar + +2.1 Augmented BNF + + All of the mechanisms specified in this document are described in + both prose and an augmented Backus-Naur Form (BNF) similar to that + used by RFC 822 [9]. Implementors will need to be familiar with the + notation in order to understand this specification. The augmented BNF + includes the following constructs: + + name = definition + The name of a rule is simply the name itself (without any + enclosing "<" and ">") and is separated from its definition by the + equal "=" character. White space is only significant in that + indentation of continuation lines is used to indicate a rule + definition that spans more than one line. Certain basic rules are + in uppercase, such as SP, LWS, HT, CRLF, DIGIT, ALPHA, etc. Angle + brackets are used within definitions whenever their presence will + facilitate discerning the use of rule names. + + "literal" + Quotation marks surround literal text. Unless stated otherwise, + the text is case-insensitive. + + rule1 | rule2 + Elements separated by a bar ("|") are alternatives, e.g., "yes | + no" will accept yes or no. + + (rule1 rule2) + Elements enclosed in parentheses are treated as a single element. + Thus, "(elem (foo | bar) elem)" allows the token sequences "elem + foo elem" and "elem bar elem". + + *rule + The character "*" preceding an element indicates repetition. The + full form is "*element" indicating at least and at most + occurrences of element. Default values are 0 and infinity so + that "*(element)" allows any number, including zero; "1*element" + requires at least one; and "1*2element" allows one or two. + + [rule] + Square brackets enclose optional elements; "[foo bar]" is + equivalent to "*1(foo bar)". + + + +Fielding, et al. Standards Track [Page 14] + +RFC 2616 HTTP/1.1 June 1999 + + + N rule + Specific repetition: "(element)" is equivalent to + "*(element)"; that is, exactly occurrences of (element). + Thus 2DIGIT is a 2-digit number, and 3ALPHA is a string of three + alphabetic characters. + + #rule + A construct "#" is defined, similar to "*", for defining lists of + elements. The full form is "#element" indicating at least + and at most elements, each separated by one or more commas + (",") and OPTIONAL linear white space (LWS). This makes the usual + form of lists very easy; a rule such as + ( *LWS element *( *LWS "," *LWS element )) + can be shown as + 1#element + Wherever this construct is used, null elements are allowed, but do + not contribute to the count of elements present. That is, + "(element), , (element) " is permitted, but counts as only two + elements. Therefore, where at least one element is required, at + least one non-null element MUST be present. Default values are 0 + and infinity so that "#element" allows any number, including zero; + "1#element" requires at least one; and "1#2element" allows one or + two. + + ; comment + A semi-colon, set off some distance to the right of rule text, + starts a comment that continues to the end of line. This is a + simple way of including useful notes in parallel with the + specifications. + + implied *LWS + The grammar described by this specification is word-based. Except + where noted otherwise, linear white space (LWS) can be included + between any two adjacent words (token or quoted-string), and + between adjacent words and separators, without changing the + interpretation of a field. At least one delimiter (LWS and/or + + separators) MUST exist between any two tokens (for the definition + of "token" below), since they would otherwise be interpreted as a + single token. + +2.2 Basic Rules + + The following rules are used throughout this specification to + describe basic parsing constructs. The US-ASCII coded character set + is defined by ANSI X3.4-1986 [21]. + + + + + +Fielding, et al. Standards Track [Page 15] + +RFC 2616 HTTP/1.1 June 1999 + + + OCTET = + CHAR = + UPALPHA = + LOALPHA = + ALPHA = UPALPHA | LOALPHA + DIGIT = + CTL = + CR = + LF = + SP = + HT = + <"> = + + HTTP/1.1 defines the sequence CR LF as the end-of-line marker for all + protocol elements except the entity-body (see appendix 19.3 for + tolerant applications). The end-of-line marker within an entity-body + is defined by its associated media type, as described in section 3.7. + + CRLF = CR LF + + HTTP/1.1 header field values can be folded onto multiple lines if the + continuation line begins with a space or horizontal tab. All linear + white space, including folding, has the same semantics as SP. A + recipient MAY replace any linear white space with a single SP before + interpreting the field value or forwarding the message downstream. + + LWS = [CRLF] 1*( SP | HT ) + + The TEXT rule is only used for descriptive field contents and values + that are not intended to be interpreted by the message parser. Words + of *TEXT MAY contain characters from character sets other than ISO- + 8859-1 [22] only when encoded according to the rules of RFC 2047 + [14]. + + TEXT = + + A CRLF is allowed in the definition of TEXT only as part of a header + field continuation. It is expected that the folding LWS will be + replaced with a single SP before interpretation of the TEXT value. + + Hexadecimal numeric characters are used in several protocol elements. + + HEX = "A" | "B" | "C" | "D" | "E" | "F" + | "a" | "b" | "c" | "d" | "e" | "f" | DIGIT + + + + + +Fielding, et al. Standards Track [Page 16] + +RFC 2616 HTTP/1.1 June 1999 + + + Many HTTP/1.1 header field values consist of words separated by LWS + or special characters. These special characters MUST be in a quoted + string to be used within a parameter value (as defined in section + 3.6). + + token = 1* + separators = "(" | ")" | "<" | ">" | "@" + | "," | ";" | ":" | "\" | <"> + | "/" | "[" | "]" | "?" | "=" + | "{" | "}" | SP | HT + + Comments can be included in some HTTP header fields by surrounding + the comment text with parentheses. Comments are only allowed in + fields containing "comment" as part of their field value definition. + In all other fields, parentheses are considered part of the field + value. + + comment = "(" *( ctext | quoted-pair | comment ) ")" + ctext = + + A string of text is parsed as a single word if it is quoted using + double-quote marks. + + quoted-string = ( <"> *(qdtext | quoted-pair ) <"> ) + qdtext = > + + The backslash character ("\") MAY be used as a single-character + quoting mechanism only within quoted-string and comment constructs. + + quoted-pair = "\" CHAR + +3 Protocol Parameters + +3.1 HTTP Version + + HTTP uses a "." numbering scheme to indicate versions + of the protocol. The protocol versioning policy is intended to allow + the sender to indicate the format of a message and its capacity for + understanding further HTTP communication, rather than the features + obtained via that communication. No change is made to the version + number for the addition of message components which do not affect + communication behavior or which only add to extensible field values. + The number is incremented when the changes made to the + protocol add features which do not change the general message parsing + algorithm, but which may add to the message semantics and imply + additional capabilities of the sender. The number is + incremented when the format of a message within the protocol is + changed. See RFC 2145 [36] for a fuller explanation. + + + +Fielding, et al. Standards Track [Page 17] + +RFC 2616 HTTP/1.1 June 1999 + + + The version of an HTTP message is indicated by an HTTP-Version field + in the first line of the message. + + HTTP-Version = "HTTP" "/" 1*DIGIT "." 1*DIGIT + + Note that the major and minor numbers MUST be treated as separate + integers and that each MAY be incremented higher than a single digit. + Thus, HTTP/2.4 is a lower version than HTTP/2.13, which in turn is + lower than HTTP/12.3. Leading zeros MUST be ignored by recipients and + MUST NOT be sent. + + An application that sends a request or response message that includes + HTTP-Version of "HTTP/1.1" MUST be at least conditionally compliant + with this specification. Applications that are at least conditionally + compliant with this specification SHOULD use an HTTP-Version of + "HTTP/1.1" in their messages, and MUST do so for any message that is + not compatible with HTTP/1.0. For more details on when to send + specific HTTP-Version values, see RFC 2145 [36]. + + The HTTP version of an application is the highest HTTP version for + which the application is at least conditionally compliant. + + Proxy and gateway applications need to be careful when forwarding + messages in protocol versions different from that of the application. + Since the protocol version indicates the protocol capability of the + sender, a proxy/gateway MUST NOT send a message with a version + indicator which is greater than its actual version. If a higher + version request is received, the proxy/gateway MUST either downgrade + the request version, or respond with an error, or switch to tunnel + behavior. + + Due to interoperability problems with HTTP/1.0 proxies discovered + since the publication of RFC 2068[33], caching proxies MUST, gateways + MAY, and tunnels MUST NOT upgrade the request to the highest version + they support. The proxy/gateway's response to that request MUST be in + the same major version as the request. + + Note: Converting between versions of HTTP may involve modification + of header fields required or forbidden by the versions involved. + +3.2 Uniform Resource Identifiers + + URIs have been known by many names: WWW addresses, Universal Document + Identifiers, Universal Resource Identifiers [3], and finally the + combination of Uniform Resource Locators (URL) [4] and Names (URN) + [20]. As far as HTTP is concerned, Uniform Resource Identifiers are + simply formatted strings which identify--via name, location, or any + other characteristic--a resource. + + + +Fielding, et al. Standards Track [Page 18] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.1 General Syntax + + URIs in HTTP can be represented in absolute form or relative to some + known base URI [11], depending upon the context of their use. The two + forms are differentiated by the fact that absolute URIs always begin + with a scheme name followed by a colon. For definitive information on + URL syntax and semantics, see "Uniform Resource Identifiers (URI): + Generic Syntax and Semantics," RFC 2396 [42] (which replaces RFCs + 1738 [4] and RFC 1808 [11]). This specification adopts the + definitions of "URI-reference", "absoluteURI", "relativeURI", "port", + "host","abs_path", "rel_path", and "authority" from that + specification. + + The HTTP protocol does not place any a priori limit on the length of + a URI. Servers MUST be able to handle the URI of any resource they + serve, and SHOULD be able to handle URIs of unbounded length if they + provide GET-based forms that could generate such URIs. A server + SHOULD return 414 (Request-URI Too Long) status if a URI is longer + than the server can handle (see section 10.4.15). + + Note: Servers ought to be cautious about depending on URI lengths + above 255 bytes, because some older client or proxy + implementations might not properly support these lengths. + +3.2.2 http URL + + The "http" scheme is used to locate network resources via the HTTP + protocol. This section defines the scheme-specific syntax and + semantics for http URLs. + + http_URL = "http:" "//" host [ ":" port ] [ abs_path [ "?" query ]] + + If the port is empty or not given, port 80 is assumed. The semantics + are that the identified resource is located at the server listening + for TCP connections on that port of that host, and the Request-URI + for the resource is abs_path (section 5.1.2). The use of IP addresses + in URLs SHOULD be avoided whenever possible (see RFC 1900 [24]). If + the abs_path is not present in the URL, it MUST be given as "/" when + used as a Request-URI for a resource (section 5.1.2). If a proxy + receives a host name which is not a fully qualified domain name, it + MAY add its domain to the host name it received. If a proxy receives + a fully qualified domain name, the proxy MUST NOT change the host + name. + + + + + + + + +Fielding, et al. Standards Track [Page 19] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.3 URI Comparison + + When comparing two URIs to decide if they match or not, a client + SHOULD use a case-sensitive octet-by-octet comparison of the entire + URIs, with these exceptions: + + - A port that is empty or not given is equivalent to the default + port for that URI-reference; + + - Comparisons of host names MUST be case-insensitive; + + - Comparisons of scheme names MUST be case-insensitive; + + - An empty abs_path is equivalent to an abs_path of "/". + + Characters other than those in the "reserved" and "unsafe" sets (see + RFC 2396 [42]) are equivalent to their ""%" HEX HEX" encoding. + + For example, the following three URIs are equivalent: + + http://abc.com:80/~smith/home.html + http://ABC.com/%7Esmith/home.html + http://ABC.com:/%7esmith/home.html + +3.3 Date/Time Formats + +3.3.1 Full Date + + HTTP applications have historically allowed three different formats + for the representation of date/time stamps: + + Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123 + Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036 + Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format + + The first format is preferred as an Internet standard and represents + a fixed-length subset of that defined by RFC 1123 [8] (an update to + RFC 822 [9]). The second format is in common use, but is based on the + obsolete RFC 850 [12] date format and lacks a four-digit year. + HTTP/1.1 clients and servers that parse the date value MUST accept + all three formats (for compatibility with HTTP/1.0), though they MUST + only generate the RFC 1123 format for representing HTTP-date values + in header fields. See section 19.3 for further information. + + Note: Recipients of date values are encouraged to be robust in + accepting date values that may have been sent by non-HTTP + applications, as is sometimes the case when retrieving or posting + messages via proxies/gateways to SMTP or NNTP. + + + +Fielding, et al. Standards Track [Page 20] + +RFC 2616 HTTP/1.1 June 1999 + + + All HTTP date/time stamps MUST be represented in Greenwich Mean Time + (GMT), without exception. For the purposes of HTTP, GMT is exactly + equal to UTC (Coordinated Universal Time). This is indicated in the + first two formats by the inclusion of "GMT" as the three-letter + abbreviation for time zone, and MUST be assumed when reading the + asctime format. HTTP-date is case sensitive and MUST NOT include + additional LWS beyond that specifically included as SP in the + grammar. + + HTTP-date = rfc1123-date | rfc850-date | asctime-date + rfc1123-date = wkday "," SP date1 SP time SP "GMT" + rfc850-date = weekday "," SP date2 SP time SP "GMT" + asctime-date = wkday SP date3 SP time SP 4DIGIT + date1 = 2DIGIT SP month SP 4DIGIT + ; day month year (e.g., 02 Jun 1982) + date2 = 2DIGIT "-" month "-" 2DIGIT + ; day-month-year (e.g., 02-Jun-82) + date3 = month SP ( 2DIGIT | ( SP 1DIGIT )) + ; month day (e.g., Jun 2) + time = 2DIGIT ":" 2DIGIT ":" 2DIGIT + ; 00:00:00 - 23:59:59 + wkday = "Mon" | "Tue" | "Wed" + | "Thu" | "Fri" | "Sat" | "Sun" + weekday = "Monday" | "Tuesday" | "Wednesday" + | "Thursday" | "Friday" | "Saturday" | "Sunday" + month = "Jan" | "Feb" | "Mar" | "Apr" + | "May" | "Jun" | "Jul" | "Aug" + | "Sep" | "Oct" | "Nov" | "Dec" + + Note: HTTP requirements for the date/time stamp format apply only + to their usage within the protocol stream. Clients and servers are + not required to use these formats for user presentation, request + logging, etc. + +3.3.2 Delta Seconds + + Some HTTP header fields allow a time value to be specified as an + integer number of seconds, represented in decimal, after the time + that the message was received. + + delta-seconds = 1*DIGIT + +3.4 Character Sets + + HTTP uses the same definition of the term "character set" as that + described for MIME: + + + + + +Fielding, et al. Standards Track [Page 21] + +RFC 2616 HTTP/1.1 June 1999 + + + The term "character set" is used in this document to refer to a + method used with one or more tables to convert a sequence of octets + into a sequence of characters. Note that unconditional conversion in + the other direction is not required, in that not all characters may + be available in a given character set and a character set may provide + more than one sequence of octets to represent a particular character. + This definition is intended to allow various kinds of character + encoding, from simple single-table mappings such as US-ASCII to + complex table switching methods such as those that use ISO-2022's + techniques. However, the definition associated with a MIME character + set name MUST fully specify the mapping to be performed from octets + to characters. In particular, use of external profiling information + to determine the exact mapping is not permitted. + + Note: This use of the term "character set" is more commonly + referred to as a "character encoding." However, since HTTP and + MIME share the same registry, it is important that the terminology + also be shared. + + HTTP character sets are identified by case-insensitive tokens. The + complete set of tokens is defined by the IANA Character Set registry + [19]. + + charset = token + + Although HTTP allows an arbitrary token to be used as a charset + value, any token that has a predefined value within the IANA + Character Set registry [19] MUST represent the character set defined + by that registry. Applications SHOULD limit their use of character + sets to those defined by the IANA registry. + + Implementors should be aware of IETF character set requirements [38] + [41]. + +3.4.1 Missing Charset + + Some HTTP/1.0 software has interpreted a Content-Type header without + charset parameter incorrectly to mean "recipient should guess." + Senders wishing to defeat this behavior MAY include a charset + parameter even when the charset is ISO-8859-1 and SHOULD do so when + it is known that it will not confuse the recipient. + + Unfortunately, some older HTTP/1.0 clients did not deal properly with + an explicit charset parameter. HTTP/1.1 recipients MUST respect the + charset label provided by the sender; and those user agents that have + a provision to "guess" a charset MUST use the charset from the + + + + + +Fielding, et al. Standards Track [Page 22] + +RFC 2616 HTTP/1.1 June 1999 + + + content-type field if they support that charset, rather than the + recipient's preference, when initially displaying a document. See + section 3.7.1. + +3.5 Content Codings + + Content coding values indicate an encoding transformation that has + been or can be applied to an entity. Content codings are primarily + used to allow a document to be compressed or otherwise usefully + transformed without losing the identity of its underlying media type + and without loss of information. Frequently, the entity is stored in + coded form, transmitted directly, and only decoded by the recipient. + + content-coding = token + + All content-coding values are case-insensitive. HTTP/1.1 uses + content-coding values in the Accept-Encoding (section 14.3) and + Content-Encoding (section 14.11) header fields. Although the value + describes the content-coding, what is more important is that it + indicates what decoding mechanism will be required to remove the + encoding. + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + content-coding value tokens. Initially, the registry contains the + following tokens: + + gzip An encoding format produced by the file compression program + "gzip" (GNU zip) as described in RFC 1952 [25]. This format is a + Lempel-Ziv coding (LZ77) with a 32 bit CRC. + + compress + The encoding format produced by the common UNIX file compression + program "compress". This format is an adaptive Lempel-Ziv-Welch + coding (LZW). + + Use of program names for the identification of encoding formats + is not desirable and is discouraged for future encodings. Their + use here is representative of historical practice, not good + design. For compatibility with previous implementations of HTTP, + applications SHOULD consider "x-gzip" and "x-compress" to be + equivalent to "gzip" and "compress" respectively. + + deflate + The "zlib" format defined in RFC 1950 [31] in combination with + the "deflate" compression mechanism described in RFC 1951 [29]. + + + + + + +Fielding, et al. Standards Track [Page 23] + +RFC 2616 HTTP/1.1 June 1999 + + + identity + The default (identity) encoding; the use of no transformation + whatsoever. This content-coding is used only in the Accept- + Encoding header, and SHOULD NOT be used in the Content-Encoding + header. + + New content-coding value tokens SHOULD be registered; to allow + interoperability between clients and servers, specifications of the + content coding algorithms needed to implement a new value SHOULD be + publicly available and adequate for independent implementation, and + conform to the purpose of content coding defined in this section. + +3.6 Transfer Codings + + Transfer-coding values are used to indicate an encoding + transformation that has been, can be, or may need to be applied to an + entity-body in order to ensure "safe transport" through the network. + This differs from a content coding in that the transfer-coding is a + property of the message, not of the original entity. + + transfer-coding = "chunked" | transfer-extension + transfer-extension = token *( ";" parameter ) + + Parameters are in the form of attribute/value pairs. + + parameter = attribute "=" value + attribute = token + value = token | quoted-string + + All transfer-coding values are case-insensitive. HTTP/1.1 uses + transfer-coding values in the TE header field (section 14.39) and in + the Transfer-Encoding header field (section 14.41). + + Whenever a transfer-coding is applied to a message-body, the set of + transfer-codings MUST include "chunked", unless the message is + terminated by closing the connection. When the "chunked" transfer- + coding is used, it MUST be the last transfer-coding applied to the + message-body. The "chunked" transfer-coding MUST NOT be applied more + than once to a message-body. These rules allow the recipient to + determine the transfer-length of the message (section 4.4). + + Transfer-codings are analogous to the Content-Transfer-Encoding + values of MIME [7], which were designed to enable safe transport of + binary data over a 7-bit transport service. However, safe transport + has a different focus for an 8bit-clean transfer protocol. In HTTP, + the only unsafe characteristic of message-bodies is the difficulty in + determining the exact body length (section 7.2.2), or the desire to + encrypt data over a shared transport. + + + +Fielding, et al. Standards Track [Page 24] + +RFC 2616 HTTP/1.1 June 1999 + + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + transfer-coding value tokens. Initially, the registry contains the + following tokens: "chunked" (section 3.6.1), "identity" (section + 3.6.2), "gzip" (section 3.5), "compress" (section 3.5), and "deflate" + (section 3.5). + + New transfer-coding value tokens SHOULD be registered in the same way + as new content-coding value tokens (section 3.5). + + A server which receives an entity-body with a transfer-coding it does + not understand SHOULD return 501 (Unimplemented), and close the + connection. A server MUST NOT send transfer-codings to an HTTP/1.0 + client. + +3.6.1 Chunked Transfer Coding + + The chunked encoding modifies the body of a message in order to + transfer it as a series of chunks, each with its own size indicator, + followed by an OPTIONAL trailer containing entity-header fields. This + allows dynamically produced content to be transferred along with the + information necessary for the recipient to verify that it has + received the full message. + + Chunked-Body = *chunk + last-chunk + trailer + CRLF + + chunk = chunk-size [ chunk-extension ] CRLF + chunk-data CRLF + chunk-size = 1*HEX + last-chunk = 1*("0") [ chunk-extension ] CRLF + + chunk-extension= *( ";" chunk-ext-name [ "=" chunk-ext-val ] ) + chunk-ext-name = token + chunk-ext-val = token | quoted-string + chunk-data = chunk-size(OCTET) + trailer = *(entity-header CRLF) + + The chunk-size field is a string of hex digits indicating the size of + the chunk. The chunked encoding is ended by any chunk whose size is + zero, followed by the trailer, which is terminated by an empty line. + + The trailer allows the sender to include additional HTTP header + fields at the end of the message. The Trailer header field can be + used to indicate which header fields are included in a trailer (see + section 14.40). + + + + +Fielding, et al. Standards Track [Page 25] + +RFC 2616 HTTP/1.1 June 1999 + + + A server using chunked transfer-coding in a response MUST NOT use the + trailer for any header fields unless at least one of the following is + true: + + a)the request included a TE header field that indicates "trailers" is + acceptable in the transfer-coding of the response, as described in + section 14.39; or, + + b)the server is the origin server for the response, the trailer + fields consist entirely of optional metadata, and the recipient + could use the message (in a manner acceptable to the origin server) + without receiving this metadata. In other words, the origin server + is willing to accept the possibility that the trailer fields might + be silently discarded along the path to the client. + + This requirement prevents an interoperability failure when the + message is being received by an HTTP/1.1 (or later) proxy and + forwarded to an HTTP/1.0 recipient. It avoids a situation where + compliance with the protocol would have necessitated a possibly + infinite buffer on the proxy. + + An example process for decoding a Chunked-Body is presented in + appendix 19.4.6. + + All HTTP/1.1 applications MUST be able to receive and decode the + "chunked" transfer-coding, and MUST ignore chunk-extension extensions + they do not understand. + +3.7 Media Types + + HTTP uses Internet Media Types [17] in the Content-Type (section + 14.17) and Accept (section 14.1) header fields in order to provide + open and extensible data typing and type negotiation. + + media-type = type "/" subtype *( ";" parameter ) + type = token + subtype = token + + Parameters MAY follow the type/subtype in the form of attribute/value + pairs (as defined in section 3.6). + + The type, subtype, and parameter attribute names are case- + insensitive. Parameter values might or might not be case-sensitive, + depending on the semantics of the parameter name. Linear white space + (LWS) MUST NOT be used between the type and subtype, nor between an + attribute and its value. The presence or absence of a parameter might + be significant to the processing of a media-type, depending on its + definition within the media type registry. + + + +Fielding, et al. Standards Track [Page 26] + +RFC 2616 HTTP/1.1 June 1999 + + + Note that some older HTTP applications do not recognize media type + parameters. When sending data to older HTTP applications, + implementations SHOULD only use media type parameters when they are + required by that type/subtype definition. + + Media-type values are registered with the Internet Assigned Number + Authority (IANA [19]). The media type registration process is + outlined in RFC 1590 [17]. Use of non-registered media types is + discouraged. + +3.7.1 Canonicalization and Text Defaults + + Internet media types are registered with a canonical form. An + entity-body transferred via HTTP messages MUST be represented in the + appropriate canonical form prior to its transmission except for + "text" types, as defined in the next paragraph. + + When in canonical form, media subtypes of the "text" type use CRLF as + the text line break. HTTP relaxes this requirement and allows the + transport of text media with plain CR or LF alone representing a line + break when it is done consistently for an entire entity-body. HTTP + applications MUST accept CRLF, bare CR, and bare LF as being + representative of a line break in text media received via HTTP. In + addition, if the text is represented in a character set that does not + use octets 13 and 10 for CR and LF respectively, as is the case for + some multi-byte character sets, HTTP allows the use of whatever octet + sequences are defined by that character set to represent the + equivalent of CR and LF for line breaks. This flexibility regarding + line breaks applies only to text media in the entity-body; a bare CR + or LF MUST NOT be substituted for CRLF within any of the HTTP control + structures (such as header fields and multipart boundaries). + + If an entity-body is encoded with a content-coding, the underlying + data MUST be in a form defined above prior to being encoded. + + The "charset" parameter is used with some media types to define the + character set (section 3.4) of the data. When no explicit charset + parameter is provided by the sender, media subtypes of the "text" + type are defined to have a default charset value of "ISO-8859-1" when + received via HTTP. Data in character sets other than "ISO-8859-1" or + its subsets MUST be labeled with an appropriate charset value. See + section 3.4.1 for compatibility problems. + +3.7.2 Multipart Types + + MIME provides for a number of "multipart" types -- encapsulations of + one or more entities within a single message-body. All multipart + types share a common syntax, as defined in section 5.1.1 of RFC 2046 + + + +Fielding, et al. Standards Track [Page 27] + +RFC 2616 HTTP/1.1 June 1999 + + + [40], and MUST include a boundary parameter as part of the media type + value. The message body is itself a protocol element and MUST + therefore use only CRLF to represent line breaks between body-parts. + Unlike in RFC 2046, the epilogue of any multipart message MUST be + empty; HTTP applications MUST NOT transmit the epilogue (even if the + original multipart contains an epilogue). These restrictions exist in + order to preserve the self-delimiting nature of a multipart message- + body, wherein the "end" of the message-body is indicated by the + ending multipart boundary. + + In general, HTTP treats a multipart message-body no differently than + any other media type: strictly as payload. The one exception is the + "multipart/byteranges" type (appendix 19.2) when it appears in a 206 + (Partial Content) response, which will be interpreted by some HTTP + caching mechanisms as described in sections 13.5.4 and 14.16. In all + other cases, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + The MIME header fields within each body-part of a multipart message- + body do not have any significance to HTTP beyond that defined by + their MIME semantics. + + In general, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + If an application receives an unrecognized multipart subtype, the + application MUST treat it as being equivalent to "multipart/mixed". + + Note: The "multipart/form-data" type has been specifically defined + for carrying form data suitable for processing via the POST + request method, as described in RFC 1867 [15]. + +3.8 Product Tokens + + Product tokens are used to allow communicating applications to + identify themselves by software name and version. Most fields using + product tokens also allow sub-products which form a significant part + of the application to be listed, separated by white space. By + convention, the products are listed in order of their significance + for identifying the application. + + product = token ["/" product-version] + product-version = token + + Examples: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + Server: Apache/0.8.4 + + + + + +Fielding, et al. Standards Track [Page 28] + +RFC 2616 HTTP/1.1 June 1999 + + + Product tokens SHOULD be short and to the point. They MUST NOT be + used for advertising or other non-essential information. Although any + token character MAY appear in a product-version, this token SHOULD + only be used for a version identifier (i.e., successive versions of + the same product SHOULD only differ in the product-version portion of + the product value). + +3.9 Quality Values + + HTTP content negotiation (section 12) uses short "floating point" + numbers to indicate the relative importance ("weight") of various + negotiable parameters. A weight is normalized to a real number in + the range 0 through 1, where 0 is the minimum and 1 the maximum + value. If a parameter has a quality value of 0, then content with + this parameter is `not acceptable' for the client. HTTP/1.1 + applications MUST NOT generate more than three digits after the + decimal point. User configuration of these values SHOULD also be + limited in this fashion. + + qvalue = ( "0" [ "." 0*3DIGIT ] ) + | ( "1" [ "." 0*3("0") ] ) + + "Quality values" is a misnomer, since these values merely represent + relative degradation in desired quality. + +3.10 Language Tags + + A language tag identifies a natural language spoken, written, or + otherwise conveyed by human beings for communication of information + to other human beings. Computer languages are explicitly excluded. + HTTP uses language tags within the Accept-Language and Content- + Language fields. + + The syntax and registry of HTTP language tags is the same as that + defined by RFC 1766 [1]. In summary, a language tag is composed of 1 + or more parts: A primary language tag and a possibly empty series of + subtags: + + language-tag = primary-tag *( "-" subtag ) + primary-tag = 1*8ALPHA + subtag = 1*8ALPHA + + White space is not allowed within the tag and all tags are case- + insensitive. The name space of language tags is administered by the + IANA. Example tags include: + + en, en-US, en-cockney, i-cherokee, x-pig-latin + + + + +Fielding, et al. Standards Track [Page 29] + +RFC 2616 HTTP/1.1 June 1999 + + + where any two-letter primary-tag is an ISO-639 language abbreviation + and any two-letter initial subtag is an ISO-3166 country code. (The + last three tags above are not registered tags; all but the last are + examples of tags which could be registered in future.) + +3.11 Entity Tags + + Entity tags are used for comparing two or more entities from the same + requested resource. HTTP/1.1 uses entity tags in the ETag (section + 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and + If-Range (section 14.27) header fields. The definition of how they + are used and compared as cache validators is in section 13.3.3. An + entity tag consists of an opaque quoted string, possibly prefixed by + a weakness indicator. + + entity-tag = [ weak ] opaque-tag + weak = "W/" + opaque-tag = quoted-string + + A "strong entity tag" MAY be shared by two entities of a resource + only if they are equivalent by octet equality. + + A "weak entity tag," indicated by the "W/" prefix, MAY be shared by + two entities of a resource only if the entities are equivalent and + could be substituted for each other with no significant change in + semantics. A weak entity tag can only be used for weak comparison. + + An entity tag MUST be unique across all versions of all entities + associated with a particular resource. A given entity tag value MAY + be used for entities obtained by requests on different URIs. The use + of the same entity tag value in conjunction with entities obtained by + requests on different URIs does not imply the equivalence of those + entities. + +3.12 Range Units + + HTTP/1.1 allows a client to request that only part (a range of) the + response entity be included within the response. HTTP/1.1 uses range + units in the Range (section 14.35) and Content-Range (section 14.16) + header fields. An entity can be broken down into subranges according + to various structural units. + + range-unit = bytes-unit | other-range-unit + bytes-unit = "bytes" + other-range-unit = token + + The only range unit defined by HTTP/1.1 is "bytes". HTTP/1.1 + implementations MAY ignore ranges specified using other units. + + + +Fielding, et al. Standards Track [Page 30] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 has been designed to allow implementations of applications + that do not depend on knowledge of ranges. + +4 HTTP Message + +4.1 Message Types + + HTTP messages consist of requests from client to server and responses + from server to client. + + HTTP-message = Request | Response ; HTTP/1.1 messages + + Request (section 5) and Response (section 6) messages use the generic + message format of RFC 822 [9] for transferring entities (the payload + of the message). Both types of message consist of a start-line, zero + or more header fields (also known as "headers"), an empty line (i.e., + a line with nothing preceding the CRLF) indicating the end of the + header fields, and possibly a message-body. + + generic-message = start-line + *(message-header CRLF) + CRLF + [ message-body ] + start-line = Request-Line | Status-Line + + In the interest of robustness, servers SHOULD ignore any empty + line(s) received where a Request-Line is expected. In other words, if + the server is reading the protocol stream at the beginning of a + message and receives a CRLF first, it should ignore the CRLF. + + Certain buggy HTTP/1.0 client implementations generate extra CRLF's + after a POST request. To restate what is explicitly forbidden by the + BNF, an HTTP/1.1 client MUST NOT preface or follow a request with an + extra CRLF. + +4.2 Message Headers + + HTTP header fields, which include general-header (section 4.5), + request-header (section 5.3), response-header (section 6.2), and + entity-header (section 7.1) fields, follow the same generic format as + that given in Section 3.1 of RFC 822 [9]. Each header field consists + of a name followed by a colon (":") and the field value. Field names + are case-insensitive. The field value MAY be preceded by any amount + of LWS, though a single SP is preferred. Header fields can be + extended over multiple lines by preceding each extra line with at + least one SP or HT. Applications ought to follow "common form", where + one is known or indicated, when generating HTTP constructs, since + there might exist some implementations that fail to accept anything + + + +Fielding, et al. Standards Track [Page 31] + +RFC 2616 HTTP/1.1 June 1999 + + + beyond the common forms. + + message-header = field-name ":" [ field-value ] + field-name = token + field-value = *( field-content | LWS ) + field-content = + + The field-content does not include any leading or trailing LWS: + linear white space occurring before the first non-whitespace + character of the field-value or after the last non-whitespace + character of the field-value. Such leading or trailing LWS MAY be + removed without changing the semantics of the field value. Any LWS + that occurs between field-content MAY be replaced with a single SP + before interpreting the field value or forwarding the message + downstream. + + The order in which header fields with differing field names are + received is not significant. However, it is "good practice" to send + general-header fields first, followed by request-header or response- + header fields, and ending with the entity-header fields. + + Multiple message-header fields with the same field-name MAY be + present in a message if and only if the entire field-value for that + header field is defined as a comma-separated list [i.e., #(values)]. + It MUST be possible to combine the multiple header fields into one + "field-name: field-value" pair, without changing the semantics of the + message, by appending each subsequent field-value to the first, each + separated by a comma. The order in which header fields with the same + field-name are received is therefore significant to the + interpretation of the combined field value, and thus a proxy MUST NOT + change the order of these field values when a message is forwarded. + +4.3 Message Body + + The message-body (if any) of an HTTP message is used to carry the + entity-body associated with the request or response. The message-body + differs from the entity-body only when a transfer-coding has been + applied, as indicated by the Transfer-Encoding header field (section + 14.41). + + message-body = entity-body + | + + Transfer-Encoding MUST be used to indicate any transfer-codings + applied by an application to ensure safe and proper transfer of the + message. Transfer-Encoding is a property of the message, not of the + + + +Fielding, et al. Standards Track [Page 32] + +RFC 2616 HTTP/1.1 June 1999 + + + entity, and thus MAY be added or removed by any application along the + request/response chain. (However, section 3.6 places restrictions on + when certain transfer-codings may be used.) + + The rules for when a message-body is allowed in a message differ for + requests and responses. + + The presence of a message-body in a request is signaled by the + inclusion of a Content-Length or Transfer-Encoding header field in + the request's message-headers. A message-body MUST NOT be included in + a request if the specification of the request method (section 5.1.1) + does not allow sending an entity-body in requests. A server SHOULD + read and forward a message-body on any request; if the request method + does not include defined semantics for an entity-body, then the + message-body SHOULD be ignored when handling the request. + + For response messages, whether or not a message-body is included with + a message is dependent on both the request method and the response + status code (section 6.1.1). All responses to the HEAD request method + MUST NOT include a message-body, even though the presence of entity- + header fields might lead one to believe they do. All 1xx + (informational), 204 (no content), and 304 (not modified) responses + MUST NOT include a message-body. All other responses do include a + message-body, although it MAY be of zero length. + +4.4 Message Length + + The transfer-length of a message is the length of the message-body as + it appears in the message; that is, after any transfer-codings have + been applied. When a message-body is included with a message, the + transfer-length of that body is determined by one of the following + (in order of precedence): + + 1.Any response message which "MUST NOT" include a message-body (such + as the 1xx, 204, and 304 responses and any response to a HEAD + request) is always terminated by the first empty line after the + header fields, regardless of the entity-header fields present in + the message. + + 2.If a Transfer-Encoding header field (section 14.41) is present and + has any value other than "identity", then the transfer-length is + defined by use of the "chunked" transfer-coding (section 3.6), + unless the message is terminated by closing the connection. + + 3.If a Content-Length header field (section 14.13) is present, its + decimal value in OCTETs represents both the entity-length and the + transfer-length. The Content-Length header field MUST NOT be sent + if these two lengths are different (i.e., if a Transfer-Encoding + + + +Fielding, et al. Standards Track [Page 33] + +RFC 2616 HTTP/1.1 June 1999 + + + header field is present). If a message is received with both a + Transfer-Encoding header field and a Content-Length header field, + the latter MUST be ignored. + + 4.If the message uses the media type "multipart/byteranges", and the + ransfer-length is not otherwise specified, then this self- + elimiting media type defines the transfer-length. This media type + UST NOT be used unless the sender knows that the recipient can arse + it; the presence in a request of a Range header with ultiple byte- + range specifiers from a 1.1 client implies that the lient can parse + multipart/byteranges responses. + + A range header might be forwarded by a 1.0 proxy that does not + understand multipart/byteranges; in this case the server MUST + delimit the message using methods defined in items 1,3 or 5 of + this section. + + 5.By the server closing the connection. (Closing the connection + cannot be used to indicate the end of a request body, since that + would leave no possibility for the server to send back a response.) + + For compatibility with HTTP/1.0 applications, HTTP/1.1 requests + containing a message-body MUST include a valid Content-Length header + field unless the server is known to be HTTP/1.1 compliant. If a + request contains a message-body and a Content-Length is not given, + the server SHOULD respond with 400 (bad request) if it cannot + determine the length of the message, or with 411 (length required) if + it wishes to insist on receiving a valid Content-Length. + + All HTTP/1.1 applications that receive entities MUST accept the + "chunked" transfer-coding (section 3.6), thus allowing this mechanism + to be used for messages when the message length cannot be determined + in advance. + + Messages MUST NOT include both a Content-Length header field and a + non-identity transfer-coding. If the message does include a non- + identity transfer-coding, the Content-Length MUST be ignored. + + When a Content-Length is given in a message where a message-body is + allowed, its field value MUST exactly match the number of OCTETs in + the message-body. HTTP/1.1 user agents MUST notify the user when an + invalid length is received and detected. + +4.5 General Header Fields + + There are a few header fields which have general applicability for + both request and response messages, but which do not apply to the + entity being transferred. These header fields apply only to the + + + +Fielding, et al. Standards Track [Page 34] + +RFC 2616 HTTP/1.1 June 1999 + + + message being transmitted. + + general-header = Cache-Control ; Section 14.9 + | Connection ; Section 14.10 + | Date ; Section 14.18 + | Pragma ; Section 14.32 + | Trailer ; Section 14.40 + | Transfer-Encoding ; Section 14.41 + | Upgrade ; Section 14.42 + | Via ; Section 14.45 + | Warning ; Section 14.46 + + General-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields may be given the semantics of general + header fields if all parties in the communication recognize them to + be general-header fields. Unrecognized header fields are treated as + entity-header fields. + +5 Request + + A request message from a client to a server includes, within the + first line of that message, the method to be applied to the resource, + the identifier of the resource, and the protocol version in use. + + Request = Request-Line ; Section 5.1 + *(( general-header ; Section 4.5 + | request-header ; Section 5.3 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 4.3 + +5.1 Request-Line + + The Request-Line begins with a method token, followed by the + Request-URI and the protocol version, and ending with CRLF. The + elements are separated by SP characters. No CR or LF is allowed + except in the final CRLF sequence. + + Request-Line = Method SP Request-URI SP HTTP-Version CRLF + + + + + + + + + + + +Fielding, et al. Standards Track [Page 35] + +RFC 2616 HTTP/1.1 June 1999 + + +5.1.1 Method + + The Method token indicates the method to be performed on the + resource identified by the Request-URI. The method is case-sensitive. + + Method = "OPTIONS" ; Section 9.2 + | "GET" ; Section 9.3 + | "HEAD" ; Section 9.4 + | "POST" ; Section 9.5 + | "PUT" ; Section 9.6 + | "DELETE" ; Section 9.7 + | "TRACE" ; Section 9.8 + | "CONNECT" ; Section 9.9 + | extension-method + extension-method = token + + The list of methods allowed by a resource can be specified in an + Allow header field (section 14.7). The return code of the response + always notifies the client whether a method is currently allowed on a + resource, since the set of allowed methods can change dynamically. An + origin server SHOULD return the status code 405 (Method Not Allowed) + if the method is known by the origin server but not allowed for the + requested resource, and 501 (Not Implemented) if the method is + unrecognized or not implemented by the origin server. The methods GET + and HEAD MUST be supported by all general-purpose servers. All other + methods are OPTIONAL; however, if the above methods are implemented, + they MUST be implemented with the same semantics as those specified + in section 9. + +5.1.2 Request-URI + + The Request-URI is a Uniform Resource Identifier (section 3.2) and + identifies the resource upon which to apply the request. + + Request-URI = "*" | absoluteURI | abs_path | authority + + The four options for Request-URI are dependent on the nature of the + request. The asterisk "*" means that the request does not apply to a + particular resource, but to the server itself, and is only allowed + when the method used does not necessarily apply to a resource. One + example would be + + OPTIONS * HTTP/1.1 + + The absoluteURI form is REQUIRED when the request is being made to a + proxy. The proxy is requested to forward the request or service it + from a valid cache, and return the response. Note that the proxy MAY + forward the request on to another proxy or directly to the server + + + +Fielding, et al. Standards Track [Page 36] + +RFC 2616 HTTP/1.1 June 1999 + + + specified by the absoluteURI. In order to avoid request loops, a + proxy MUST be able to recognize all of its server names, including + any aliases, local variations, and the numeric IP address. An example + Request-Line would be: + + GET http://www.w3.org/pub/WWW/TheProject.html HTTP/1.1 + + To allow for transition to absoluteURIs in all requests in future + versions of HTTP, all HTTP/1.1 servers MUST accept the absoluteURI + form in requests, even though HTTP/1.1 clients will only generate + them in requests to proxies. + + The authority form is only used by the CONNECT method (section 9.9). + + The most common form of Request-URI is that used to identify a + resource on an origin server or gateway. In this case the absolute + path of the URI MUST be transmitted (see section 3.2.1, abs_path) as + the Request-URI, and the network location of the URI (authority) MUST + be transmitted in a Host header field. For example, a client wishing + to retrieve the resource above directly from the origin server would + create a TCP connection to port 80 of the host "www.w3.org" and send + the lines: + + GET /pub/WWW/TheProject.html HTTP/1.1 + Host: www.w3.org + + followed by the remainder of the Request. Note that the absolute path + cannot be empty; if none is present in the original URI, it MUST be + given as "/" (the server root). + + The Request-URI is transmitted in the format specified in section + 3.2.1. If the Request-URI is encoded using the "% HEX HEX" encoding + [42], the origin server MUST decode the Request-URI in order to + properly interpret the request. Servers SHOULD respond to invalid + Request-URIs with an appropriate status code. + + A transparent proxy MUST NOT rewrite the "abs_path" part of the + received Request-URI when forwarding it to the next inbound server, + except as noted above to replace a null abs_path with "/". + + Note: The "no rewrite" rule prevents the proxy from changing the + meaning of the request when the origin server is improperly using + a non-reserved URI character for a reserved purpose. Implementors + should be aware that some pre-HTTP/1.1 proxies have been known to + rewrite the Request-URI. + + + + + + +Fielding, et al. Standards Track [Page 37] + +RFC 2616 HTTP/1.1 June 1999 + + +5.2 The Resource Identified by a Request + + The exact resource identified by an Internet request is determined by + examining both the Request-URI and the Host header field. + + An origin server that does not allow resources to differ by the + requested host MAY ignore the Host header field value when + determining the resource identified by an HTTP/1.1 request. (But see + section 19.6.1.1 for other requirements on Host support in HTTP/1.1.) + + An origin server that does differentiate resources based on the host + requested (sometimes referred to as virtual hosts or vanity host + names) MUST use the following rules for determining the requested + resource on an HTTP/1.1 request: + + 1. If Request-URI is an absoluteURI, the host is part of the + Request-URI. Any Host header field value in the request MUST be + ignored. + + 2. If the Request-URI is not an absoluteURI, and the request includes + a Host header field, the host is determined by the Host header + field value. + + 3. If the host as determined by rule 1 or 2 is not a valid host on + the server, the response MUST be a 400 (Bad Request) error message. + + Recipients of an HTTP/1.0 request that lacks a Host header field MAY + attempt to use heuristics (e.g., examination of the URI path for + something unique to a particular host) in order to determine what + exact resource is being requested. + +5.3 Request Header Fields + + The request-header fields allow the client to pass additional + information about the request, and about the client itself, to the + server. These fields act as request modifiers, with semantics + equivalent to the parameters on a programming language method + invocation. + + request-header = Accept ; Section 14.1 + | Accept-Charset ; Section 14.2 + | Accept-Encoding ; Section 14.3 + | Accept-Language ; Section 14.4 + | Authorization ; Section 14.8 + | Expect ; Section 14.20 + | From ; Section 14.22 + | Host ; Section 14.23 + | If-Match ; Section 14.24 + + + +Fielding, et al. Standards Track [Page 38] + +RFC 2616 HTTP/1.1 June 1999 + + + | If-Modified-Since ; Section 14.25 + | If-None-Match ; Section 14.26 + | If-Range ; Section 14.27 + | If-Unmodified-Since ; Section 14.28 + | Max-Forwards ; Section 14.31 + | Proxy-Authorization ; Section 14.34 + | Range ; Section 14.35 + | Referer ; Section 14.36 + | TE ; Section 14.39 + | User-Agent ; Section 14.43 + + Request-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of request- + header fields if all parties in the communication recognize them to + be request-header fields. Unrecognized header fields are treated as + entity-header fields. + +6 Response + + After receiving and interpreting a request message, a server responds + with an HTTP response message. + + Response = Status-Line ; Section 6.1 + *(( general-header ; Section 4.5 + | response-header ; Section 6.2 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 7.2 + +6.1 Status-Line + + The first line of a Response message is the Status-Line, consisting + of the protocol version followed by a numeric status code and its + associated textual phrase, with each element separated by SP + characters. No CR or LF is allowed except in the final CRLF sequence. + + Status-Line = HTTP-Version SP Status-Code SP Reason-Phrase CRLF + +6.1.1 Status Code and Reason Phrase + + The Status-Code element is a 3-digit integer result code of the + attempt to understand and satisfy the request. These codes are fully + defined in section 10. The Reason-Phrase is intended to give a short + textual description of the Status-Code. The Status-Code is intended + for use by automata and the Reason-Phrase is intended for the human + user. The client is not required to examine or display the Reason- + Phrase. + + + +Fielding, et al. Standards Track [Page 39] + +RFC 2616 HTTP/1.1 June 1999 + + + The first digit of the Status-Code defines the class of response. The + last two digits do not have any categorization role. There are 5 + values for the first digit: + + - 1xx: Informational - Request received, continuing process + + - 2xx: Success - The action was successfully received, + understood, and accepted + + - 3xx: Redirection - Further action must be taken in order to + complete the request + + - 4xx: Client Error - The request contains bad syntax or cannot + be fulfilled + + - 5xx: Server Error - The server failed to fulfill an apparently + valid request + + The individual values of the numeric status codes defined for + HTTP/1.1, and an example set of corresponding Reason-Phrase's, are + presented below. The reason phrases listed here are only + recommendations -- they MAY be replaced by local equivalents without + affecting the protocol. + + Status-Code = + "100" ; Section 10.1.1: Continue + | "101" ; Section 10.1.2: Switching Protocols + | "200" ; Section 10.2.1: OK + | "201" ; Section 10.2.2: Created + | "202" ; Section 10.2.3: Accepted + | "203" ; Section 10.2.4: Non-Authoritative Information + | "204" ; Section 10.2.5: No Content + | "205" ; Section 10.2.6: Reset Content + | "206" ; Section 10.2.7: Partial Content + | "300" ; Section 10.3.1: Multiple Choices + | "301" ; Section 10.3.2: Moved Permanently + | "302" ; Section 10.3.3: Found + | "303" ; Section 10.3.4: See Other + | "304" ; Section 10.3.5: Not Modified + | "305" ; Section 10.3.6: Use Proxy + | "307" ; Section 10.3.8: Temporary Redirect + | "400" ; Section 10.4.1: Bad Request + | "401" ; Section 10.4.2: Unauthorized + | "402" ; Section 10.4.3: Payment Required + | "403" ; Section 10.4.4: Forbidden + | "404" ; Section 10.4.5: Not Found + | "405" ; Section 10.4.6: Method Not Allowed + | "406" ; Section 10.4.7: Not Acceptable + + + +Fielding, et al. Standards Track [Page 40] + +RFC 2616 HTTP/1.1 June 1999 + + + | "407" ; Section 10.4.8: Proxy Authentication Required + | "408" ; Section 10.4.9: Request Time-out + | "409" ; Section 10.4.10: Conflict + | "410" ; Section 10.4.11: Gone + | "411" ; Section 10.4.12: Length Required + | "412" ; Section 10.4.13: Precondition Failed + | "413" ; Section 10.4.14: Request Entity Too Large + | "414" ; Section 10.4.15: Request-URI Too Large + | "415" ; Section 10.4.16: Unsupported Media Type + | "416" ; Section 10.4.17: Requested range not satisfiable + | "417" ; Section 10.4.18: Expectation Failed + | "500" ; Section 10.5.1: Internal Server Error + | "501" ; Section 10.5.2: Not Implemented + | "502" ; Section 10.5.3: Bad Gateway + | "503" ; Section 10.5.4: Service Unavailable + | "504" ; Section 10.5.5: Gateway Time-out + | "505" ; Section 10.5.6: HTTP Version not supported + | extension-code + + extension-code = 3DIGIT + Reason-Phrase = * + + HTTP status codes are extensible. HTTP applications are not required + to understand the meaning of all registered status codes, though such + understanding is obviously desirable. However, applications MUST + understand the class of any status code, as indicated by the first + digit, and treat any unrecognized response as being equivalent to the + x00 status code of that class, with the exception that an + unrecognized response MUST NOT be cached. For example, if an + unrecognized status code of 431 is received by the client, it can + safely assume that there was something wrong with its request and + treat the response as if it had received a 400 status code. In such + cases, user agents SHOULD present to the user the entity returned + with the response, since that entity is likely to include human- + readable information which will explain the unusual status. + +6.2 Response Header Fields + + The response-header fields allow the server to pass additional + information about the response which cannot be placed in the Status- + Line. These header fields give information about the server and about + further access to the resource identified by the Request-URI. + + response-header = Accept-Ranges ; Section 14.5 + | Age ; Section 14.6 + | ETag ; Section 14.19 + | Location ; Section 14.30 + | Proxy-Authenticate ; Section 14.33 + + + +Fielding, et al. Standards Track [Page 41] + +RFC 2616 HTTP/1.1 June 1999 + + + | Retry-After ; Section 14.37 + | Server ; Section 14.38 + | Vary ; Section 14.44 + | WWW-Authenticate ; Section 14.47 + + Response-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of response- + header fields if all parties in the communication recognize them to + be response-header fields. Unrecognized header fields are treated as + entity-header fields. + +7 Entity + + Request and Response messages MAY transfer an entity if not otherwise + restricted by the request method or response status code. An entity + consists of entity-header fields and an entity-body, although some + responses will only include the entity-headers. + + In this section, both sender and recipient refer to either the client + or the server, depending on who sends and who receives the entity. + +7.1 Entity Header Fields + + Entity-header fields define metainformation about the entity-body or, + if no body is present, about the resource identified by the request. + Some of this metainformation is OPTIONAL; some might be REQUIRED by + portions of this specification. + + entity-header = Allow ; Section 14.7 + | Content-Encoding ; Section 14.11 + | Content-Language ; Section 14.12 + | Content-Length ; Section 14.13 + | Content-Location ; Section 14.14 + | Content-MD5 ; Section 14.15 + | Content-Range ; Section 14.16 + | Content-Type ; Section 14.17 + | Expires ; Section 14.21 + | Last-Modified ; Section 14.29 + | extension-header + + extension-header = message-header + + The extension-header mechanism allows additional entity-header fields + to be defined without changing the protocol, but these fields cannot + be assumed to be recognizable by the recipient. Unrecognized header + fields SHOULD be ignored by the recipient and MUST be forwarded by + transparent proxies. + + + +Fielding, et al. Standards Track [Page 42] + +RFC 2616 HTTP/1.1 June 1999 + + +7.2 Entity Body + + The entity-body (if any) sent with an HTTP request or response is in + a format and encoding defined by the entity-header fields. + + entity-body = *OCTET + + An entity-body is only present in a message when a message-body is + present, as described in section 4.3. The entity-body is obtained + from the message-body by decoding any Transfer-Encoding that might + have been applied to ensure safe and proper transfer of the message. + +7.2.1 Type + + When an entity-body is included with a message, the data type of that + body is determined via the header fields Content-Type and Content- + Encoding. These define a two-layer, ordered encoding model: + + entity-body := Content-Encoding( Content-Type( data ) ) + + Content-Type specifies the media type of the underlying data. + Content-Encoding may be used to indicate any additional content + codings applied to the data, usually for the purpose of data + compression, that are a property of the requested resource. There is + no default encoding. + + Any HTTP/1.1 message containing an entity-body SHOULD include a + Content-Type header field defining the media type of that body. If + and only if the media type is not given by a Content-Type field, the + recipient MAY attempt to guess the media type via inspection of its + content and/or the name extension(s) of the URI used to identify the + resource. If the media type remains unknown, the recipient SHOULD + treat it as type "application/octet-stream". + +7.2.2 Entity Length + + The entity-length of a message is the length of the message-body + before any transfer-codings have been applied. Section 4.4 defines + how the transfer-length of a message-body is determined. + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 43] + +RFC 2616 HTTP/1.1 June 1999 + + +8 Connections + +8.1 Persistent Connections + +8.1.1 Purpose + + Prior to persistent connections, a separate TCP connection was + established to fetch each URL, increasing the load on HTTP servers + and causing congestion on the Internet. The use of inline images and + other associated data often require a client to make multiple + requests of the same server in a short amount of time. Analysis of + these performance problems and results from a prototype + implementation are available [26] [30]. Implementation experience and + measurements of actual HTTP/1.1 (RFC 2068) implementations show good + results [39]. Alternatives have also been explored, for example, + T/TCP [27]. + + Persistent HTTP connections have a number of advantages: + + - By opening and closing fewer TCP connections, CPU time is saved + in routers and hosts (clients, servers, proxies, gateways, + tunnels, or caches), and memory used for TCP protocol control + blocks can be saved in hosts. + + - HTTP requests and responses can be pipelined on a connection. + Pipelining allows a client to make multiple requests without + waiting for each response, allowing a single TCP connection to + be used much more efficiently, with much lower elapsed time. + + - Network congestion is reduced by reducing the number of packets + caused by TCP opens, and by allowing TCP sufficient time to + determine the congestion state of the network. + + - Latency on subsequent requests is reduced since there is no time + spent in TCP's connection opening handshake. + + - HTTP can evolve more gracefully, since errors can be reported + without the penalty of closing the TCP connection. Clients using + future versions of HTTP might optimistically try a new feature, + but if communicating with an older server, retry with old + semantics after an error is reported. + + HTTP implementations SHOULD implement persistent connections. + + + + + + + + +Fielding, et al. Standards Track [Page 44] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2 Overall Operation + + A significant difference between HTTP/1.1 and earlier versions of + HTTP is that persistent connections are the default behavior of any + HTTP connection. That is, unless otherwise indicated, the client + SHOULD assume that the server will maintain a persistent connection, + even after error responses from the server. + + Persistent connections provide a mechanism by which a client and a + server can signal the close of a TCP connection. This signaling takes + place using the Connection header field (section 14.10). Once a close + has been signaled, the client MUST NOT send any more requests on that + connection. + +8.1.2.1 Negotiation + + An HTTP/1.1 server MAY assume that a HTTP/1.1 client intends to + maintain a persistent connection unless a Connection header including + the connection-token "close" was sent in the request. If the server + chooses to close the connection immediately after sending the + response, it SHOULD send a Connection header including the + connection-token close. + + An HTTP/1.1 client MAY expect a connection to remain open, but would + decide to keep it open based on whether the response from a server + contains a Connection header with the connection-token close. In case + the client does not want to maintain a connection for more than that + request, it SHOULD send a Connection header including the + connection-token close. + + If either the client or the server sends the close token in the + Connection header, that request becomes the last one for the + connection. + + Clients and servers SHOULD NOT assume that a persistent connection is + maintained for HTTP versions less than 1.1 unless it is explicitly + signaled. See section 19.6.2 for more information on backward + compatibility with HTTP/1.0 clients. + + In order to remain persistent, all messages on the connection MUST + have a self-defined message length (i.e., one not defined by closure + of the connection), as described in section 4.4. + + + + + + + + + +Fielding, et al. Standards Track [Page 45] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2.2 Pipelining + + A client that supports persistent connections MAY "pipeline" its + requests (i.e., send multiple requests without waiting for each + response). A server MUST send its responses to those requests in the + same order that the requests were received. + + Clients which assume persistent connections and pipeline immediately + after connection establishment SHOULD be prepared to retry their + connection if the first pipelined attempt fails. If a client does + such a retry, it MUST NOT pipeline before it knows the connection is + persistent. Clients MUST also be prepared to resend their requests if + the server closes the connection before sending all of the + corresponding responses. + + Clients SHOULD NOT pipeline requests using non-idempotent methods or + non-idempotent sequences of methods (see section 9.1.2). Otherwise, a + premature termination of the transport connection could lead to + indeterminate results. A client wishing to send a non-idempotent + request SHOULD wait to send that request until it has received the + response status for the previous request. + +8.1.3 Proxy Servers + + It is especially important that proxies correctly implement the + properties of the Connection header field as specified in section + 14.10. + + The proxy server MUST signal persistent connections separately with + its clients and the origin servers (or other proxy servers) that it + connects to. Each persistent connection applies to only one transport + link. + + A proxy server MUST NOT establish a HTTP/1.1 persistent connection + with an HTTP/1.0 client (but see RFC 2068 [33] for information and + discussion of the problems with the Keep-Alive header implemented by + many HTTP/1.0 clients). + +8.1.4 Practical Considerations + + Servers will usually have some time-out value beyond which they will + no longer maintain an inactive connection. Proxy servers might make + this a higher value since it is likely that the client will be making + more connections through the same server. The use of persistent + connections places no requirements on the length (or existence) of + this time-out for either the client or the server. + + + + + +Fielding, et al. Standards Track [Page 46] + +RFC 2616 HTTP/1.1 June 1999 + + + When a client or server wishes to time-out it SHOULD issue a graceful + close on the transport connection. Clients and servers SHOULD both + constantly watch for the other side of the transport close, and + respond to it as appropriate. If a client or server does not detect + the other side's close promptly it could cause unnecessary resource + drain on the network. + + A client, server, or proxy MAY close the transport connection at any + time. For example, a client might have started to send a new request + at the same time that the server has decided to close the "idle" + connection. From the server's point of view, the connection is being + closed while it was idle, but from the client's point of view, a + request is in progress. + + This means that clients, servers, and proxies MUST be able to recover + from asynchronous close events. Client software SHOULD reopen the + transport connection and retransmit the aborted sequence of requests + without user interaction so long as the request sequence is + idempotent (see section 9.1.2). Non-idempotent methods or sequences + MUST NOT be automatically retried, although user agents MAY offer a + human operator the choice of retrying the request(s). Confirmation by + user-agent software with semantic understanding of the application + MAY substitute for user confirmation. The automatic retry SHOULD NOT + be repeated if the second sequence of requests fails. + + Servers SHOULD always respond to at least one request per connection, + if at all possible. Servers SHOULD NOT close a connection in the + middle of transmitting a response, unless a network or client failure + is suspected. + + Clients that use persistent connections SHOULD limit the number of + simultaneous connections that they maintain to a given server. A + single-user client SHOULD NOT maintain more than 2 connections with + any server or proxy. A proxy SHOULD use up to 2*N connections to + another server or proxy, where N is the number of simultaneously + active users. These guidelines are intended to improve HTTP response + times and avoid congestion. + +8.2 Message Transmission Requirements + +8.2.1 Persistent Connections and Flow Control + + HTTP/1.1 servers SHOULD maintain persistent connections and use TCP's + flow control mechanisms to resolve temporary overloads, rather than + terminating connections with the expectation that clients will retry. + The latter technique can exacerbate network congestion. + + + + + +Fielding, et al. Standards Track [Page 47] + +RFC 2616 HTTP/1.1 June 1999 + + +8.2.2 Monitoring Connections for Error Status Messages + + An HTTP/1.1 (or later) client sending a message-body SHOULD monitor + the network connection for an error status while it is transmitting + the request. If the client sees an error status, it SHOULD + immediately cease transmitting the body. If the body is being sent + using a "chunked" encoding (section 3.6), a zero length chunk and + empty trailer MAY be used to prematurely mark the end of the message. + If the body was preceded by a Content-Length header, the client MUST + close the connection. + +8.2.3 Use of the 100 (Continue) Status + + The purpose of the 100 (Continue) status (see section 10.1.1) is to + allow a client that is sending a request message with a request body + to determine if the origin server is willing to accept the request + (based on the request headers) before the client sends the request + body. In some cases, it might either be inappropriate or highly + inefficient for the client to send the body if the server will reject + the message without looking at the body. + + Requirements for HTTP/1.1 clients: + + - If a client will wait for a 100 (Continue) response before + sending the request body, it MUST send an Expect request-header + field (section 14.20) with the "100-continue" expectation. + + - A client MUST NOT send an Expect request-header field (section + 14.20) with the "100-continue" expectation if it does not intend + to send a request body. + + Because of the presence of older implementations, the protocol allows + ambiguous situations in which a client may send "Expect: 100- + continue" without receiving either a 417 (Expectation Failed) status + or a 100 (Continue) status. Therefore, when a client sends this + header field to an origin server (possibly via a proxy) from which it + has never seen a 100 (Continue) status, the client SHOULD NOT wait + for an indefinite period before sending the request body. + + Requirements for HTTP/1.1 origin servers: + + - Upon receiving a request which includes an Expect request-header + field with the "100-continue" expectation, an origin server MUST + either respond with 100 (Continue) status and continue to read + from the input stream, or respond with a final status code. The + origin server MUST NOT wait for the request body before sending + the 100 (Continue) response. If it responds with a final status + code, it MAY close the transport connection or it MAY continue + + + +Fielding, et al. Standards Track [Page 48] + +RFC 2616 HTTP/1.1 June 1999 + + + to read and discard the rest of the request. It MUST NOT + perform the requested method if it returns a final status code. + + - An origin server SHOULD NOT send a 100 (Continue) response if + the request message does not include an Expect request-header + field with the "100-continue" expectation, and MUST NOT send a + 100 (Continue) response if such a request comes from an HTTP/1.0 + (or earlier) client. There is an exception to this rule: for + compatibility with RFC 2068, a server MAY send a 100 (Continue) + status in response to an HTTP/1.1 PUT or POST request that does + not include an Expect request-header field with the "100- + continue" expectation. This exception, the purpose of which is + to minimize any client processing delays associated with an + undeclared wait for 100 (Continue) status, applies only to + HTTP/1.1 requests, and not to requests with any other HTTP- + version value. + + - An origin server MAY omit a 100 (Continue) response if it has + already received some or all of the request body for the + corresponding request. + + - An origin server that sends a 100 (Continue) response MUST + ultimately send a final status code, once the request body is + received and processed, unless it terminates the transport + connection prematurely. + + - If an origin server receives a request that does not include an + Expect request-header field with the "100-continue" expectation, + the request includes a request body, and the server responds + with a final status code before reading the entire request body + from the transport connection, then the server SHOULD NOT close + the transport connection until it has read the entire request, + or until the client closes the connection. Otherwise, the client + might not reliably receive the response message. However, this + requirement is not be construed as preventing a server from + defending itself against denial-of-service attacks, or from + badly broken client implementations. + + Requirements for HTTP/1.1 proxies: + + - If a proxy receives a request that includes an Expect request- + header field with the "100-continue" expectation, and the proxy + either knows that the next-hop server complies with HTTP/1.1 or + higher, or does not know the HTTP version of the next-hop + server, it MUST forward the request, including the Expect header + field. + + + + + +Fielding, et al. Standards Track [Page 49] + +RFC 2616 HTTP/1.1 June 1999 + + + - If the proxy knows that the version of the next-hop server is + HTTP/1.0 or lower, it MUST NOT forward the request, and it MUST + respond with a 417 (Expectation Failed) status. + + - Proxies SHOULD maintain a cache recording the HTTP version + numbers received from recently-referenced next-hop servers. + + - A proxy MUST NOT forward a 100 (Continue) response if the + request message was received from an HTTP/1.0 (or earlier) + client and did not include an Expect request-header field with + the "100-continue" expectation. This requirement overrides the + general rule for forwarding of 1xx responses (see section 10.1). + +8.2.4 Client Behavior if Server Prematurely Closes Connection + + If an HTTP/1.1 client sends a request which includes a request body, + but which does not include an Expect request-header field with the + "100-continue" expectation, and if the client is not directly + connected to an HTTP/1.1 origin server, and if the client sees the + connection close before receiving any status from the server, the + client SHOULD retry the request. If the client does retry this + request, it MAY use the following "binary exponential backoff" + algorithm to be assured of obtaining a reliable response: + + 1. Initiate a new connection to the server + + 2. Transmit the request-headers + + 3. Initialize a variable R to the estimated round-trip time to the + server (e.g., based on the time it took to establish the + connection), or to a constant value of 5 seconds if the round- + trip time is not available. + + 4. Compute T = R * (2**N), where N is the number of previous + retries of this request. + + 5. Wait either for an error response from the server, or for T + seconds (whichever comes first) + + 6. If no error response is received, after T seconds transmit the + body of the request. + + 7. If client sees that the connection is closed prematurely, + repeat from step 1 until the request is accepted, an error + response is received, or the user becomes impatient and + terminates the retry process. + + + + + +Fielding, et al. Standards Track [Page 50] + +RFC 2616 HTTP/1.1 June 1999 + + + If at any point an error status is received, the client + + - SHOULD NOT continue and + + - SHOULD close the connection if it has not completed sending the + request message. + +9 Method Definitions + + The set of common methods for HTTP/1.1 is defined below. Although + this set can be expanded, additional methods cannot be assumed to + share the same semantics for separately extended clients and servers. + + The Host request-header field (section 14.23) MUST accompany all + HTTP/1.1 requests. + +9.1 Safe and Idempotent Methods + +9.1.1 Safe Methods + + Implementors should be aware that the software represents the user in + their interactions over the Internet, and should be careful to allow + the user to be aware of any actions they might take which may have an + unexpected significance to themselves or others. + + In particular, the convention has been established that the GET and + HEAD methods SHOULD NOT have the significance of taking an action + other than retrieval. These methods ought to be considered "safe". + This allows user agents to represent other methods, such as POST, PUT + and DELETE, in a special way, so that the user is made aware of the + fact that a possibly unsafe action is being requested. + + Naturally, it is not possible to ensure that the server does not + generate side-effects as a result of performing a GET request; in + fact, some dynamic resources consider that a feature. The important + distinction here is that the user did not request the side-effects, + so therefore cannot be held accountable for them. + +9.1.2 Idempotent Methods + + Methods can also have the property of "idempotence" in that (aside + from error or expiration issues) the side-effects of N > 0 identical + requests is the same as for a single request. The methods GET, HEAD, + PUT and DELETE share this property. Also, the methods OPTIONS and + TRACE SHOULD NOT have side effects, and so are inherently idempotent. + + + + + + +Fielding, et al. Standards Track [Page 51] + +RFC 2616 HTTP/1.1 June 1999 + + + However, it is possible that a sequence of several requests is non- + idempotent, even if all of the methods executed in that sequence are + idempotent. (A sequence is idempotent if a single execution of the + entire sequence always yields a result that is not changed by a + reexecution of all, or part, of that sequence.) For example, a + sequence is non-idempotent if its result depends on a value that is + later modified in the same sequence. + + A sequence that never has side effects is idempotent, by definition + (provided that no concurrent operations are being executed on the + same set of resources). + +9.2 OPTIONS + + The OPTIONS method represents a request for information about the + communication options available on the request/response chain + identified by the Request-URI. This method allows the client to + determine the options and/or requirements associated with a resource, + or the capabilities of a server, without implying a resource action + or initiating a resource retrieval. + + Responses to this method are not cacheable. + + If the OPTIONS request includes an entity-body (as indicated by the + presence of Content-Length or Transfer-Encoding), then the media type + MUST be indicated by a Content-Type field. Although this + specification does not define any use for such a body, future + extensions to HTTP might use the OPTIONS body to make more detailed + queries on the server. A server that does not support such an + extension MAY discard the request body. + + If the Request-URI is an asterisk ("*"), the OPTIONS request is + intended to apply to the server in general rather than to a specific + resource. Since a server's communication options typically depend on + the resource, the "*" request is only useful as a "ping" or "no-op" + type of method; it does nothing beyond allowing the client to test + the capabilities of the server. For example, this can be used to test + a proxy for HTTP/1.1 compliance (or lack thereof). + + If the Request-URI is not an asterisk, the OPTIONS request applies + only to the options that are available when communicating with that + resource. + + A 200 response SHOULD include any header fields that indicate + optional features implemented by the server and applicable to that + resource (e.g., Allow), possibly including extensions not defined by + this specification. The response body, if any, SHOULD also include + information about the communication options. The format for such a + + + +Fielding, et al. Standards Track [Page 52] + +RFC 2616 HTTP/1.1 June 1999 + + + body is not defined by this specification, but might be defined by + future extensions to HTTP. Content negotiation MAY be used to select + the appropriate response format. If no response body is included, the + response MUST include a Content-Length field with a field-value of + "0". + + The Max-Forwards request-header field MAY be used to target a + specific proxy in the request chain. When a proxy receives an OPTIONS + request on an absoluteURI for which request forwarding is permitted, + the proxy MUST check for a Max-Forwards field. If the Max-Forwards + field-value is zero ("0"), the proxy MUST NOT forward the message; + instead, the proxy SHOULD respond with its own communication options. + If the Max-Forwards field-value is an integer greater than zero, the + proxy MUST decrement the field-value when it forwards the request. If + no Max-Forwards field is present in the request, then the forwarded + request MUST NOT include a Max-Forwards field. + +9.3 GET + + The GET method means retrieve whatever information (in the form of an + entity) is identified by the Request-URI. If the Request-URI refers + to a data-producing process, it is the produced data which shall be + returned as the entity in the response and not the source text of the + process, unless that text happens to be the output of the process. + + The semantics of the GET method change to a "conditional GET" if the + request message includes an If-Modified-Since, If-Unmodified-Since, + If-Match, If-None-Match, or If-Range header field. A conditional GET + method requests that the entity be transferred only under the + circumstances described by the conditional header field(s). The + conditional GET method is intended to reduce unnecessary network + usage by allowing cached entities to be refreshed without requiring + multiple requests or transferring data already held by the client. + + The semantics of the GET method change to a "partial GET" if the + request message includes a Range header field. A partial GET requests + that only part of the entity be transferred, as described in section + 14.35. The partial GET method is intended to reduce unnecessary + network usage by allowing partially-retrieved entities to be + completed without transferring data already held by the client. + + The response to a GET request is cacheable if and only if it meets + the requirements for HTTP caching described in section 13. + + See section 15.1.3 for security considerations when used for forms. + + + + + + +Fielding, et al. Standards Track [Page 53] + +RFC 2616 HTTP/1.1 June 1999 + + +9.4 HEAD + + The HEAD method is identical to GET except that the server MUST NOT + return a message-body in the response. The metainformation contained + in the HTTP headers in response to a HEAD request SHOULD be identical + to the information sent in response to a GET request. This method can + be used for obtaining metainformation about the entity implied by the + request without transferring the entity-body itself. This method is + often used for testing hypertext links for validity, accessibility, + and recent modification. + + The response to a HEAD request MAY be cacheable in the sense that the + information contained in the response MAY be used to update a + previously cached entity from that resource. If the new field values + indicate that the cached entity differs from the current entity (as + would be indicated by a change in Content-Length, Content-MD5, ETag + or Last-Modified), then the cache MUST treat the cache entry as + stale. + +9.5 POST + + The POST method is used to request that the origin server accept the + entity enclosed in the request as a new subordinate of the resource + identified by the Request-URI in the Request-Line. POST is designed + to allow a uniform method to cover the following functions: + + - Annotation of existing resources; + + - Posting a message to a bulletin board, newsgroup, mailing list, + or similar group of articles; + + - Providing a block of data, such as the result of submitting a + form, to a data-handling process; + + - Extending a database through an append operation. + + The actual function performed by the POST method is determined by the + server and is usually dependent on the Request-URI. The posted entity + is subordinate to that URI in the same way that a file is subordinate + to a directory containing it, a news article is subordinate to a + newsgroup to which it is posted, or a record is subordinate to a + database. + + The action performed by the POST method might not result in a + resource that can be identified by a URI. In this case, either 200 + (OK) or 204 (No Content) is the appropriate response status, + depending on whether or not the response includes an entity that + describes the result. + + + +Fielding, et al. Standards Track [Page 54] + +RFC 2616 HTTP/1.1 June 1999 + + + If a resource has been created on the origin server, the response + SHOULD be 201 (Created) and contain an entity which describes the + status of the request and refers to the new resource, and a Location + header (see section 14.30). + + Responses to this method are not cacheable, unless the response + includes appropriate Cache-Control or Expires header fields. However, + the 303 (See Other) response can be used to direct the user agent to + retrieve a cacheable resource. + + POST requests MUST obey the message transmission requirements set out + in section 8.2. + + See section 15.1.3 for security considerations. + +9.6 PUT + + The PUT method requests that the enclosed entity be stored under the + supplied Request-URI. If the Request-URI refers to an already + existing resource, the enclosed entity SHOULD be considered as a + modified version of the one residing on the origin server. If the + Request-URI does not point to an existing resource, and that URI is + capable of being defined as a new resource by the requesting user + agent, the origin server can create the resource with that URI. If a + new resource is created, the origin server MUST inform the user agent + via the 201 (Created) response. If an existing resource is modified, + either the 200 (OK) or 204 (No Content) response codes SHOULD be sent + to indicate successful completion of the request. If the resource + could not be created or modified with the Request-URI, an appropriate + error response SHOULD be given that reflects the nature of the + problem. The recipient of the entity MUST NOT ignore any Content-* + (e.g. Content-Range) headers that it does not understand or implement + and MUST return a 501 (Not Implemented) response in such cases. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + + The fundamental difference between the POST and PUT requests is + reflected in the different meaning of the Request-URI. The URI in a + POST request identifies the resource that will handle the enclosed + entity. That resource might be a data-accepting process, a gateway to + some other protocol, or a separate entity that accepts annotations. + In contrast, the URI in a PUT request identifies the entity enclosed + with the request -- the user agent knows what URI is intended and the + server MUST NOT attempt to apply the request to some other resource. + If the server desires that the request be applied to a different URI, + + + + +Fielding, et al. Standards Track [Page 55] + +RFC 2616 HTTP/1.1 June 1999 + + + it MUST send a 301 (Moved Permanently) response; the user agent MAY + then make its own decision regarding whether or not to redirect the + request. + + A single resource MAY be identified by many different URIs. For + example, an article might have a URI for identifying "the current + version" which is separate from the URI identifying each particular + version. In this case, a PUT request on a general URI might result in + several other URIs being defined by the origin server. + + HTTP/1.1 does not define how a PUT method affects the state of an + origin server. + + PUT requests MUST obey the message transmission requirements set out + in section 8.2. + + Unless otherwise specified for a particular entity-header, the + entity-headers in the PUT request SHOULD be applied to the resource + created or modified by the PUT. + +9.7 DELETE + + The DELETE method requests that the origin server delete the resource + identified by the Request-URI. This method MAY be overridden by human + intervention (or other means) on the origin server. The client cannot + be guaranteed that the operation has been carried out, even if the + status code returned from the origin server indicates that the action + has been completed successfully. However, the server SHOULD NOT + indicate success unless, at the time the response is given, it + intends to delete the resource or move it to an inaccessible + location. + + A successful response SHOULD be 200 (OK) if the response includes an + entity describing the status, 202 (Accepted) if the action has not + yet been enacted, or 204 (No Content) if the action has been enacted + but the response does not include an entity. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + +9.8 TRACE + + The TRACE method is used to invoke a remote, application-layer loop- + back of the request message. The final recipient of the request + SHOULD reflect the message received back to the client as the + entity-body of a 200 (OK) response. The final recipient is either the + + + + +Fielding, et al. Standards Track [Page 56] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server or the first proxy or gateway to receive a Max-Forwards + value of zero (0) in the request (see section 14.31). A TRACE request + MUST NOT include an entity. + + TRACE allows the client to see what is being received at the other + end of the request chain and use that data for testing or diagnostic + information. The value of the Via header field (section 14.45) is of + particular interest, since it acts as a trace of the request chain. + Use of the Max-Forwards header field allows the client to limit the + length of the request chain, which is useful for testing a chain of + proxies forwarding messages in an infinite loop. + + If the request is valid, the response SHOULD contain the entire + request message in the entity-body, with a Content-Type of + "message/http". Responses to this method MUST NOT be cached. + +9.9 CONNECT + + This specification reserves the method name CONNECT for use with a + proxy that can dynamically switch to being a tunnel (e.g. SSL + tunneling [44]). + +10 Status Code Definitions + + Each Status-Code is described below, including a description of which + method(s) it can follow and any metainformation required in the + response. + +10.1 Informational 1xx + + This class of status code indicates a provisional response, + consisting only of the Status-Line and optional headers, and is + terminated by an empty line. There are no required headers for this + class of status code. Since HTTP/1.0 did not define any 1xx status + codes, servers MUST NOT send a 1xx response to an HTTP/1.0 client + except under experimental conditions. + + A client MUST be prepared to accept one or more 1xx status responses + prior to a regular response, even if the client does not expect a 100 + (Continue) status message. Unexpected 1xx status responses MAY be + ignored by a user agent. + + Proxies MUST forward 1xx responses, unless the connection between the + proxy and its client has been closed, or unless the proxy itself + requested the generation of the 1xx response. (For example, if a + + + + + + +Fielding, et al. Standards Track [Page 57] + +RFC 2616 HTTP/1.1 June 1999 + + + proxy adds a "Expect: 100-continue" field when it forwards a request, + then it need not forward the corresponding 100 (Continue) + response(s).) + +10.1.1 100 Continue + + The client SHOULD continue with its request. This interim response is + used to inform the client that the initial part of the request has + been received and has not yet been rejected by the server. The client + SHOULD continue by sending the remainder of the request or, if the + request has already been completed, ignore this response. The server + MUST send a final response after the request has been completed. See + section 8.2.3 for detailed discussion of the use and handling of this + status code. + +10.1.2 101 Switching Protocols + + The server understands and is willing to comply with the client's + request, via the Upgrade message header field (section 14.42), for a + change in the application protocol being used on this connection. The + server will switch protocols to those defined by the response's + Upgrade header field immediately after the empty line which + terminates the 101 response. + + The protocol SHOULD be switched only when it is advantageous to do + so. For example, switching to a newer version of HTTP is advantageous + over older versions, and switching to a real-time, synchronous + protocol might be advantageous when delivering resources that use + such features. + +10.2 Successful 2xx + + This class of status code indicates that the client's request was + successfully received, understood, and accepted. + +10.2.1 200 OK + + The request has succeeded. The information returned with the response + is dependent on the method used in the request, for example: + + GET an entity corresponding to the requested resource is sent in + the response; + + HEAD the entity-header fields corresponding to the requested + resource are sent in the response without any message-body; + + POST an entity describing or containing the result of the action; + + + + +Fielding, et al. Standards Track [Page 58] + +RFC 2616 HTTP/1.1 June 1999 + + + TRACE an entity containing the request message as received by the + end server. + +10.2.2 201 Created + + The request has been fulfilled and resulted in a new resource being + created. The newly created resource can be referenced by the URI(s) + returned in the entity of the response, with the most specific URI + for the resource given by a Location header field. The response + SHOULD include an entity containing a list of resource + characteristics and location(s) from which the user or user agent can + choose the one most appropriate. The entity format is specified by + the media type given in the Content-Type header field. The origin + server MUST create the resource before returning the 201 status code. + If the action cannot be carried out immediately, the server SHOULD + respond with 202 (Accepted) response instead. + + A 201 response MAY contain an ETag response header field indicating + the current value of the entity tag for the requested variant just + created, see section 14.19. + +10.2.3 202 Accepted + + The request has been accepted for processing, but the processing has + not been completed. The request might or might not eventually be + acted upon, as it might be disallowed when processing actually takes + place. There is no facility for re-sending a status code from an + asynchronous operation such as this. + + The 202 response is intentionally non-committal. Its purpose is to + allow a server to accept a request for some other process (perhaps a + batch-oriented process that is only run once per day) without + requiring that the user agent's connection to the server persist + until the process is completed. The entity returned with this + response SHOULD include an indication of the request's current status + and either a pointer to a status monitor or some estimate of when the + user can expect the request to be fulfilled. + +10.2.4 203 Non-Authoritative Information + + The returned metainformation in the entity-header is not the + definitive set as available from the origin server, but is gathered + from a local or a third-party copy. The set presented MAY be a subset + or superset of the original version. For example, including local + annotation information about the resource might result in a superset + of the metainformation known by the origin server. Use of this + response code is not required and is only appropriate when the + response would otherwise be 200 (OK). + + + +Fielding, et al. Standards Track [Page 59] + +RFC 2616 HTTP/1.1 June 1999 + + +10.2.5 204 No Content + + The server has fulfilled the request but does not need to return an + entity-body, and might want to return updated metainformation. The + response MAY include new or updated metainformation in the form of + entity-headers, which if present SHOULD be associated with the + requested variant. + + If the client is a user agent, it SHOULD NOT change its document view + from that which caused the request to be sent. This response is + primarily intended to allow input for actions to take place without + causing a change to the user agent's active document view, although + any new or updated metainformation SHOULD be applied to the document + currently in the user agent's active view. + + The 204 response MUST NOT include a message-body, and thus is always + terminated by the first empty line after the header fields. + +10.2.6 205 Reset Content + + The server has fulfilled the request and the user agent SHOULD reset + the document view which caused the request to be sent. This response + is primarily intended to allow input for actions to take place via + user input, followed by a clearing of the form in which the input is + given so that the user can easily initiate another input action. The + response MUST NOT include an entity. + +10.2.7 206 Partial Content + + The server has fulfilled the partial GET request for the resource. + The request MUST have included a Range header field (section 14.35) + indicating the desired range, and MAY have included an If-Range + header field (section 14.27) to make the request conditional. + + The response MUST include the following header fields: + + - Either a Content-Range header field (section 14.16) indicating + the range included with this response, or a multipart/byteranges + Content-Type including Content-Range fields for each part. If a + Content-Length header field is present in the response, its + value MUST match the actual number of OCTETs transmitted in the + message-body. + + - Date + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + + + +Fielding, et al. Standards Track [Page 60] + +RFC 2616 HTTP/1.1 June 1999 + + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the 206 response is the result of an If-Range request that used a + strong cache validator (see section 13.3.3), the response SHOULD NOT + include other entity-headers. If the response is the result of an + If-Range request that used a weak validator, the response MUST NOT + include other entity-headers; this prevents inconsistencies between + cached entity-bodies and updated headers. Otherwise, the response + MUST include all of the entity-headers that would have been returned + with a 200 (OK) response to the same request. + + A cache MUST NOT combine a 206 response with other previously cached + content if the ETag or Last-Modified headers do not match exactly, + see 13.5.4. + + A cache that does not support the Range and Content-Range headers + MUST NOT cache 206 (Partial) responses. + +10.3 Redirection 3xx + + This class of status code indicates that further action needs to be + taken by the user agent in order to fulfill the request. The action + required MAY be carried out by the user agent without interaction + with the user if and only if the method used in the second request is + GET or HEAD. A client SHOULD detect infinite redirection loops, since + such loops generate network traffic for each redirection. + + Note: previous versions of this specification recommended a + maximum of five redirections. Content developers should be aware + that there might be clients that implement such a fixed + limitation. + +10.3.1 300 Multiple Choices + + The requested resource corresponds to any one of a set of + representations, each with its own specific location, and agent- + driven negotiation information (section 12) is being provided so that + the user (or user agent) can select a preferred representation and + redirect its request to that location. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of resource characteristics and location(s) from + which the user or user agent can choose the one most appropriate. The + entity format is specified by the media type given in the Content- + Type header field. Depending upon the format and the capabilities of + + + + +Fielding, et al. Standards Track [Page 61] + +RFC 2616 HTTP/1.1 June 1999 + + + the user agent, selection of the most appropriate choice MAY be + performed automatically. However, this specification does not define + any standard for such automatic selection. + + If the server has a preferred choice of representation, it SHOULD + include the specific URI for that representation in the Location + field; user agents MAY use the Location field value for automatic + redirection. This response is cacheable unless indicated otherwise. + +10.3.2 301 Moved Permanently + + The requested resource has been assigned a new permanent URI and any + future references to this resource SHOULD use one of the returned + URIs. Clients with link editing capabilities ought to automatically + re-link references to the Request-URI to one or more of the new + references returned by the server, where possible. This response is + cacheable unless indicated otherwise. + + The new permanent URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + If the 301 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: When automatically redirecting a POST request after + receiving a 301 status code, some existing HTTP/1.0 user agents + will erroneously change it into a GET request. + +10.3.3 302 Found + + The requested resource resides temporarily under a different URI. + Since the redirection might be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + + + + + + +Fielding, et al. Standards Track [Page 62] + +RFC 2616 HTTP/1.1 June 1999 + + + If the 302 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: RFC 1945 and RFC 2068 specify that the client is not allowed + to change the method on the redirected request. However, most + existing user agent implementations treat 302 as if it were a 303 + response, performing a GET on the Location field-value regardless + of the original request method. The status codes 303 and 307 have + been added for servers that wish to make unambiguously clear which + kind of reaction is expected of the client. + +10.3.4 303 See Other + + The response to the request can be found under a different URI and + SHOULD be retrieved using a GET method on that resource. This method + exists primarily to allow the output of a POST-activated script to + redirect the user agent to a selected resource. The new URI is not a + substitute reference for the originally requested resource. The 303 + response MUST NOT be cached, but the response to the second + (redirected) request might be cacheable. + + The different URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + Note: Many pre-HTTP/1.1 user agents do not understand the 303 + status. When interoperability with such clients is a concern, the + 302 status code may be used instead, since most user agents react + to a 302 response as described here for 303. + +10.3.5 304 Not Modified + + If the client has performed a conditional GET request and access is + allowed, but the document has not been modified, the server SHOULD + respond with this status code. The 304 response MUST NOT contain a + message-body, and thus is always terminated by the first empty line + after the header fields. + + The response MUST include the following header fields: + + - Date, unless its omission is required by section 14.18.1 + + + + + + + +Fielding, et al. Standards Track [Page 63] + +RFC 2616 HTTP/1.1 June 1999 + + + If a clockless origin server obeys these rules, and proxies and + clients add their own Date to any response received without one (as + already specified by [RFC 2068], section 14.19), caches will operate + correctly. + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the conditional GET used a strong cache validator (see section + 13.3.3), the response SHOULD NOT include other entity-headers. + Otherwise (i.e., the conditional GET used a weak validator), the + response MUST NOT include other entity-headers; this prevents + inconsistencies between cached entity-bodies and updated headers. + + If a 304 response indicates an entity not currently cached, then the + cache MUST disregard the response and repeat the request without the + conditional. + + If a cache uses a received 304 response to update a cache entry, the + cache MUST update the entry to reflect any new field values given in + the response. + +10.3.6 305 Use Proxy + + The requested resource MUST be accessed through the proxy given by + the Location field. The Location field gives the URI of the proxy. + The recipient is expected to repeat this single request via the + proxy. 305 responses MUST only be generated by origin servers. + + Note: RFC 2068 was not clear that 305 was intended to redirect a + single request, and to be generated by origin servers only. Not + observing these limitations has significant security consequences. + +10.3.7 306 (Unused) + + The 306 status code was used in a previous version of the + specification, is no longer used, and the code is reserved. + + + + + + + + + + +Fielding, et al. Standards Track [Page 64] + +RFC 2616 HTTP/1.1 June 1999 + + +10.3.8 307 Temporary Redirect + + The requested resource resides temporarily under a different URI. + Since the redirection MAY be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s) , since many pre-HTTP/1.1 user agents do not + understand the 307 status. Therefore, the note SHOULD contain the + information necessary for a user to repeat the original request on + the new URI. + + If the 307 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + +10.4 Client Error 4xx + + The 4xx class of status code is intended for cases in which the + client seems to have erred. Except when responding to a HEAD request, + the server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. These status codes are applicable to any request method. + User agents SHOULD display any included entity to the user. + + If the client is sending data, a server implementation using TCP + SHOULD be careful to ensure that the client acknowledges receipt of + the packet(s) containing the response, before the server closes the + input connection. If the client continues sending data to the server + after the close, the server's TCP stack will send a reset packet to + the client, which may erase the client's unacknowledged input buffers + before they can be read and interpreted by the HTTP application. + +10.4.1 400 Bad Request + + The request could not be understood by the server due to malformed + syntax. The client SHOULD NOT repeat the request without + modifications. + + + + + + + + +Fielding, et al. Standards Track [Page 65] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.2 401 Unauthorized + + The request requires user authentication. The response MUST include a + WWW-Authenticate header field (section 14.47) containing a challenge + applicable to the requested resource. The client MAY repeat the + request with a suitable Authorization header field (section 14.8). If + the request already included Authorization credentials, then the 401 + response indicates that authorization has been refused for those + credentials. If the 401 response contains the same challenge as the + prior response, and the user agent has already attempted + authentication at least once, then the user SHOULD be presented the + entity that was given in the response, since that entity might + include relevant diagnostic information. HTTP access authentication + is explained in "HTTP Authentication: Basic and Digest Access + Authentication" [43]. + +10.4.3 402 Payment Required + + This code is reserved for future use. + +10.4.4 403 Forbidden + + The server understood the request, but is refusing to fulfill it. + Authorization will not help and the request SHOULD NOT be repeated. + If the request method was not HEAD and the server wishes to make + public why the request has not been fulfilled, it SHOULD describe the + reason for the refusal in the entity. If the server does not wish to + make this information available to the client, the status code 404 + (Not Found) can be used instead. + +10.4.5 404 Not Found + + The server has not found anything matching the Request-URI. No + indication is given of whether the condition is temporary or + permanent. The 410 (Gone) status code SHOULD be used if the server + knows, through some internally configurable mechanism, that an old + resource is permanently unavailable and has no forwarding address. + This status code is commonly used when the server does not wish to + reveal exactly why the request has been refused, or when no other + response is applicable. + +10.4.6 405 Method Not Allowed + + The method specified in the Request-Line is not allowed for the + resource identified by the Request-URI. The response MUST include an + Allow header containing a list of valid methods for the requested + resource. + + + + +Fielding, et al. Standards Track [Page 66] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.7 406 Not Acceptable + + The resource identified by the request is only capable of generating + response entities which have content characteristics not acceptable + according to the accept headers sent in the request. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of available entity characteristics and location(s) + from which the user or user agent can choose the one most + appropriate. The entity format is specified by the media type given + in the Content-Type header field. Depending upon the format and the + capabilities of the user agent, selection of the most appropriate + choice MAY be performed automatically. However, this specification + does not define any standard for such automatic selection. + + Note: HTTP/1.1 servers are allowed to return responses which are + not acceptable according to the accept headers sent in the + request. In some cases, this may even be preferable to sending a + 406 response. User agents are encouraged to inspect the headers of + an incoming response to determine if it is acceptable. + + If the response could be unacceptable, a user agent SHOULD + temporarily stop receipt of more data and query the user for a + decision on further actions. + +10.4.8 407 Proxy Authentication Required + + This code is similar to 401 (Unauthorized), but indicates that the + client must first authenticate itself with the proxy. The proxy MUST + return a Proxy-Authenticate header field (section 14.33) containing a + challenge applicable to the proxy for the requested resource. The + client MAY repeat the request with a suitable Proxy-Authorization + header field (section 14.34). HTTP access authentication is explained + in "HTTP Authentication: Basic and Digest Access Authentication" + [43]. + +10.4.9 408 Request Timeout + + The client did not produce a request within the time that the server + was prepared to wait. The client MAY repeat the request without + modifications at any later time. + +10.4.10 409 Conflict + + The request could not be completed due to a conflict with the current + state of the resource. This code is only allowed in situations where + it is expected that the user might be able to resolve the conflict + and resubmit the request. The response body SHOULD include enough + + + +Fielding, et al. Standards Track [Page 67] + +RFC 2616 HTTP/1.1 June 1999 + + + information for the user to recognize the source of the conflict. + Ideally, the response entity would include enough information for the + user or user agent to fix the problem; however, that might not be + possible and is not required. + + Conflicts are most likely to occur in response to a PUT request. For + example, if versioning were being used and the entity being PUT + included changes to a resource which conflict with those made by an + earlier (third-party) request, the server might use the 409 response + to indicate that it can't complete the request. In this case, the + response entity would likely contain a list of the differences + between the two versions in a format defined by the response + Content-Type. + +10.4.11 410 Gone + + The requested resource is no longer available at the server and no + forwarding address is known. This condition is expected to be + considered permanent. Clients with link editing capabilities SHOULD + delete references to the Request-URI after user approval. If the + server does not know, or has no facility to determine, whether or not + the condition is permanent, the status code 404 (Not Found) SHOULD be + used instead. This response is cacheable unless indicated otherwise. + + The 410 response is primarily intended to assist the task of web + maintenance by notifying the recipient that the resource is + intentionally unavailable and that the server owners desire that + remote links to that resource be removed. Such an event is common for + limited-time, promotional services and for resources belonging to + individuals no longer working at the server's site. It is not + necessary to mark all permanently unavailable resources as "gone" or + to keep the mark for any length of time -- that is left to the + discretion of the server owner. + +10.4.12 411 Length Required + + The server refuses to accept the request without a defined Content- + Length. The client MAY repeat the request if it adds a valid + Content-Length header field containing the length of the message-body + in the request message. + +10.4.13 412 Precondition Failed + + The precondition given in one or more of the request-header fields + evaluated to false when it was tested on the server. This response + code allows the client to place preconditions on the current resource + metainformation (header field data) and thus prevent the requested + method from being applied to a resource other than the one intended. + + + +Fielding, et al. Standards Track [Page 68] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.14 413 Request Entity Too Large + + The server is refusing to process a request because the request + entity is larger than the server is willing or able to process. The + server MAY close the connection to prevent the client from continuing + the request. + + If the condition is temporary, the server SHOULD include a Retry- + After header field to indicate that it is temporary and after what + time the client MAY try again. + +10.4.15 414 Request-URI Too Long + + The server is refusing to service the request because the Request-URI + is longer than the server is willing to interpret. This rare + condition is only likely to occur when a client has improperly + converted a POST request to a GET request with long query + information, when the client has descended into a URI "black hole" of + redirection (e.g., a redirected URI prefix that points to a suffix of + itself), or when the server is under attack by a client attempting to + exploit security holes present in some servers using fixed-length + buffers for reading or manipulating the Request-URI. + +10.4.16 415 Unsupported Media Type + + The server is refusing to service the request because the entity of + the request is in a format not supported by the requested resource + for the requested method. + +10.4.17 416 Requested Range Not Satisfiable + + A server SHOULD return a response with this status code if a request + included a Range request-header field (section 14.35), and none of + the range-specifier values in this field overlap the current extent + of the selected resource, and the request did not include an If-Range + request-header field. (For byte-ranges, this means that the first- + byte-pos of all of the byte-range-spec values were greater than the + current length of the selected resource.) + + When this status code is returned for a byte-range request, the + response SHOULD include a Content-Range entity-header field + specifying the current length of the selected resource (see section + 14.16). This response MUST NOT use the multipart/byteranges content- + type. + + + + + + + +Fielding, et al. Standards Track [Page 69] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.18 417 Expectation Failed + + The expectation given in an Expect request-header field (see section + 14.20) could not be met by this server, or, if the server is a proxy, + the server has unambiguous evidence that the request could not be met + by the next-hop server. + +10.5 Server Error 5xx + + Response status codes beginning with the digit "5" indicate cases in + which the server is aware that it has erred or is incapable of + performing the request. Except when responding to a HEAD request, the + server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. User agents SHOULD display any included entity to the + user. These response codes are applicable to any request method. + +10.5.1 500 Internal Server Error + + The server encountered an unexpected condition which prevented it + from fulfilling the request. + +10.5.2 501 Not Implemented + + The server does not support the functionality required to fulfill the + request. This is the appropriate response when the server does not + recognize the request method and is not capable of supporting it for + any resource. + +10.5.3 502 Bad Gateway + + The server, while acting as a gateway or proxy, received an invalid + response from the upstream server it accessed in attempting to + fulfill the request. + +10.5.4 503 Service Unavailable + + The server is currently unable to handle the request due to a + temporary overloading or maintenance of the server. The implication + is that this is a temporary condition which will be alleviated after + some delay. If known, the length of the delay MAY be indicated in a + Retry-After header. If no Retry-After is given, the client SHOULD + handle the response as it would for a 500 response. + + Note: The existence of the 503 status code does not imply that a + server must use it when becoming overloaded. Some servers may wish + to simply refuse the connection. + + + + +Fielding, et al. Standards Track [Page 70] + +RFC 2616 HTTP/1.1 June 1999 + + +10.5.5 504 Gateway Timeout + + The server, while acting as a gateway or proxy, did not receive a + timely response from the upstream server specified by the URI (e.g. + HTTP, FTP, LDAP) or some other auxiliary server (e.g. DNS) it needed + to access in attempting to complete the request. + + Note: Note to implementors: some deployed proxies are known to + return 400 or 500 when DNS lookups time out. + +10.5.6 505 HTTP Version Not Supported + + The server does not support, or refuses to support, the HTTP protocol + version that was used in the request message. The server is + indicating that it is unable or unwilling to complete the request + using the same major version as the client, as described in section + 3.1, other than with this error message. The response SHOULD contain + an entity describing why that version is not supported and what other + protocols are supported by that server. + +11 Access Authentication + + HTTP provides several OPTIONAL challenge-response authentication + mechanisms which can be used by a server to challenge a client + request and by a client to provide authentication information. The + general framework for access authentication, and the specification of + "basic" and "digest" authentication, are specified in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. This + specification adopts the definitions of "challenge" and "credentials" + from that specification. + +12 Content Negotiation + + Most HTTP responses include an entity which contains information for + interpretation by a human user. Naturally, it is desirable to supply + the user with the "best available" entity corresponding to the + request. Unfortunately for servers and caches, not all users have the + same preferences for what is "best," and not all user agents are + equally capable of rendering all entity types. For that reason, HTTP + has provisions for several mechanisms for "content negotiation" -- + the process of selecting the best representation for a given response + when there are multiple representations available. + + Note: This is not called "format negotiation" because the + alternate representations may be of the same media type, but use + different capabilities of that type, be in different languages, + etc. + + + + +Fielding, et al. Standards Track [Page 71] + +RFC 2616 HTTP/1.1 June 1999 + + + Any response containing an entity-body MAY be subject to negotiation, + including error responses. + + There are two kinds of content negotiation which are possible in + HTTP: server-driven and agent-driven negotiation. These two kinds of + negotiation are orthogonal and thus may be used separately or in + combination. One method of combination, referred to as transparent + negotiation, occurs when a cache uses the agent-driven negotiation + information provided by the origin server in order to provide + server-driven negotiation for subsequent requests. + +12.1 Server-driven Negotiation + + If the selection of the best representation for a response is made by + an algorithm located at the server, it is called server-driven + negotiation. Selection is based on the available representations of + the response (the dimensions over which it can vary; e.g. language, + content-coding, etc.) and the contents of particular header fields in + the request message or on other information pertaining to the request + (such as the network address of the client). + + Server-driven negotiation is advantageous when the algorithm for + selecting from among the available representations is difficult to + describe to the user agent, or when the server desires to send its + "best guess" to the client along with the first response (hoping to + avoid the round-trip delay of a subsequent request if the "best + guess" is good enough for the user). In order to improve the server's + guess, the user agent MAY include request header fields (Accept, + Accept-Language, Accept-Encoding, etc.) which describe its + preferences for such a response. + + Server-driven negotiation has disadvantages: + + 1. It is impossible for the server to accurately determine what + might be "best" for any given user, since that would require + complete knowledge of both the capabilities of the user agent + and the intended use for the response (e.g., does the user want + to view it on screen or print it on paper?). + + 2. Having the user agent describe its capabilities in every + request can be both very inefficient (given that only a small + percentage of responses have multiple representations) and a + potential violation of the user's privacy. + + 3. It complicates the implementation of an origin server and the + algorithms for generating responses to a request. + + + + + +Fielding, et al. Standards Track [Page 72] + +RFC 2616 HTTP/1.1 June 1999 + + + 4. It may limit a public cache's ability to use the same response + for multiple user's requests. + + HTTP/1.1 includes the following request-header fields for enabling + server-driven negotiation through description of user agent + capabilities and user preferences: Accept (section 14.1), Accept- + Charset (section 14.2), Accept-Encoding (section 14.3), Accept- + Language (section 14.4), and User-Agent (section 14.43). However, an + origin server is not limited to these dimensions and MAY vary the + response based on any aspect of the request, including information + outside the request-header fields or within extension header fields + not defined by this specification. + + The Vary header field can be used to express the parameters the + server uses to select a representation that is subject to server- + driven negotiation. See section 13.6 for use of the Vary header field + by caches and section 14.44 for use of the Vary header field by + servers. + +12.2 Agent-driven Negotiation + + With agent-driven negotiation, selection of the best representation + for a response is performed by the user agent after receiving an + initial response from the origin server. Selection is based on a list + of the available representations of the response included within the + header fields or entity-body of the initial response, with each + representation identified by its own URI. Selection from among the + representations may be performed automatically (if the user agent is + capable of doing so) or manually by the user selecting from a + generated (possibly hypertext) menu. + + Agent-driven negotiation is advantageous when the response would vary + over commonly-used dimensions (such as type, language, or encoding), + when the origin server is unable to determine a user agent's + capabilities from examining the request, and generally when public + caches are used to distribute server load and reduce network usage. + + Agent-driven negotiation suffers from the disadvantage of needing a + second request to obtain the best alternate representation. This + second request is only efficient when caching is used. In addition, + this specification does not define any mechanism for supporting + automatic selection, though it also does not prevent any such + mechanism from being developed as an extension and used within + HTTP/1.1. + + + + + + + +Fielding, et al. Standards Track [Page 73] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 defines the 300 (Multiple Choices) and 406 (Not Acceptable) + status codes for enabling agent-driven negotiation when the server is + unwilling or unable to provide a varying response using server-driven + negotiation. + +12.3 Transparent Negotiation + + Transparent negotiation is a combination of both server-driven and + agent-driven negotiation. When a cache is supplied with a form of the + list of available representations of the response (as in agent-driven + negotiation) and the dimensions of variance are completely understood + by the cache, then the cache becomes capable of performing server- + driven negotiation on behalf of the origin server for subsequent + requests on that resource. + + Transparent negotiation has the advantage of distributing the + negotiation work that would otherwise be required of the origin + server and also removing the second request delay of agent-driven + negotiation when the cache is able to correctly guess the right + response. + + This specification does not define any mechanism for transparent + negotiation, though it also does not prevent any such mechanism from + being developed as an extension that could be used within HTTP/1.1. + +13 Caching in HTTP + + HTTP is typically used for distributed information systems, where + performance can be improved by the use of response caches. The + HTTP/1.1 protocol includes a number of elements intended to make + caching work as well as possible. Because these elements are + inextricable from other aspects of the protocol, and because they + interact with each other, it is useful to describe the basic caching + design of HTTP separately from the detailed descriptions of methods, + headers, response codes, etc. + + Caching would be useless if it did not significantly improve + performance. The goal of caching in HTTP/1.1 is to eliminate the need + to send requests in many cases, and to eliminate the need to send + full responses in many other cases. The former reduces the number of + network round-trips required for many operations; we use an + "expiration" mechanism for this purpose (see section 13.2). The + latter reduces network bandwidth requirements; we use a "validation" + mechanism for this purpose (see section 13.3). + + Requirements for performance, availability, and disconnected + operation require us to be able to relax the goal of semantic + transparency. The HTTP/1.1 protocol allows origin servers, caches, + + + +Fielding, et al. Standards Track [Page 74] + +RFC 2616 HTTP/1.1 June 1999 + + + and clients to explicitly reduce transparency when necessary. + However, because non-transparent operation may confuse non-expert + users, and might be incompatible with certain server applications + (such as those for ordering merchandise), the protocol requires that + transparency be relaxed + + - only by an explicit protocol-level request when relaxed by + client or origin server + + - only with an explicit warning to the end user when relaxed by + cache or client + + Therefore, the HTTP/1.1 protocol provides these important elements: + + 1. Protocol features that provide full semantic transparency when + this is required by all parties. + + 2. Protocol features that allow an origin server or user agent to + explicitly request and control non-transparent operation. + + 3. Protocol features that allow a cache to attach warnings to + responses that do not preserve the requested approximation of + semantic transparency. + + A basic principle is that it must be possible for the clients to + detect any potential relaxation of semantic transparency. + + Note: The server, cache, or client implementor might be faced with + design decisions not explicitly discussed in this specification. + If a decision might affect semantic transparency, the implementor + ought to err on the side of maintaining transparency unless a + careful and complete analysis shows significant benefits in + breaking transparency. + +13.1.1 Cache Correctness + + A correct cache MUST respond to a request with the most up-to-date + response held by the cache that is appropriate to the request (see + sections 13.2.5, 13.2.6, and 13.12) which meets one of the following + conditions: + + 1. It has been checked for equivalence with what the origin server + would have returned by revalidating the response with the + origin server (section 13.3); + + + + + + + +Fielding, et al. Standards Track [Page 75] + +RFC 2616 HTTP/1.1 June 1999 + + + 2. It is "fresh enough" (see section 13.2). In the default case, + this means it meets the least restrictive freshness requirement + of the client, origin server, and cache (see section 14.9); if + the origin server so specifies, it is the freshness requirement + of the origin server alone. + + If a stored response is not "fresh enough" by the most + restrictive freshness requirement of both the client and the + origin server, in carefully considered circumstances the cache + MAY still return the response with the appropriate Warning + header (see section 13.1.5 and 14.46), unless such a response + is prohibited (e.g., by a "no-store" cache-directive, or by a + "no-cache" cache-request-directive; see section 14.9). + + 3. It is an appropriate 304 (Not Modified), 305 (Proxy Redirect), + or error (4xx or 5xx) response message. + + If the cache can not communicate with the origin server, then a + correct cache SHOULD respond as above if the response can be + correctly served from the cache; if not it MUST return an error or + warning indicating that there was a communication failure. + + If a cache receives a response (either an entire response, or a 304 + (Not Modified) response) that it would normally forward to the + requesting client, and the received response is no longer fresh, the + cache SHOULD forward it to the requesting client without adding a new + Warning (but without removing any existing Warning headers). A cache + SHOULD NOT attempt to revalidate a response simply because that + response became stale in transit; this might lead to an infinite + loop. A user agent that receives a stale response without a Warning + MAY display a warning indication to the user. + +13.1.2 Warnings + + Whenever a cache returns a response that is neither first-hand nor + "fresh enough" (in the sense of condition 2 in section 13.1.1), it + MUST attach a warning to that effect, using a Warning general-header. + The Warning header and the currently defined warnings are described + in section 14.46. The warning allows clients to take appropriate + action. + + Warnings MAY be used for other purposes, both cache-related and + otherwise. The use of a warning, rather than an error status code, + distinguish these responses from true failures. + + Warnings are assigned three digit warn-codes. The first digit + indicates whether the Warning MUST or MUST NOT be deleted from a + stored cache entry after a successful revalidation: + + + +Fielding, et al. Standards Track [Page 76] + +RFC 2616 HTTP/1.1 June 1999 + + + 1xx Warnings that describe the freshness or revalidation status of + the response, and so MUST be deleted after a successful + revalidation. 1XX warn-codes MAY be generated by a cache only when + validating a cached entry. It MUST NOT be generated by clients. + + 2xx Warnings that describe some aspect of the entity body or entity + headers that is not rectified by a revalidation (for example, a + lossy compression of the entity bodies) and which MUST NOT be + deleted after a successful revalidation. + + See section 14.46 for the definitions of the codes themselves. + + HTTP/1.0 caches will cache all Warnings in responses, without + deleting the ones in the first category. Warnings in responses that + are passed to HTTP/1.0 caches carry an extra warning-date field, + which prevents a future HTTP/1.1 recipient from believing an + erroneously cached Warning. + + Warnings also carry a warning text. The text MAY be in any + appropriate natural language (perhaps based on the client's Accept + headers), and include an OPTIONAL indication of what character set is + used. + + Multiple warnings MAY be attached to a response (either by the origin + server or by a cache), including multiple warnings with the same code + number. For example, a server might provide the same warning with + texts in both English and Basque. + + When multiple warnings are attached to a response, it might not be + practical or reasonable to display all of them to the user. This + version of HTTP does not specify strict priority rules for deciding + which warnings to display and in what order, but does suggest some + heuristics. + +13.1.3 Cache-control Mechanisms + + The basic cache mechanisms in HTTP/1.1 (server-specified expiration + times and validators) are implicit directives to caches. In some + cases, a server or client might need to provide explicit directives + to the HTTP caches. We use the Cache-Control header for this purpose. + + The Cache-Control header allows a client or server to transmit a + variety of directives in either requests or responses. These + directives typically override the default caching algorithms. As a + general rule, if there is any apparent conflict between header + values, the most restrictive interpretation is applied (that is, the + one that is most likely to preserve semantic transparency). However, + + + + +Fielding, et al. Standards Track [Page 77] + +RFC 2616 HTTP/1.1 June 1999 + + + in some cases, cache-control directives are explicitly specified as + weakening the approximation of semantic transparency (for example, + "max-stale" or "public"). + + The cache-control directives are described in detail in section 14.9. + +13.1.4 Explicit User Agent Warnings + + Many user agents make it possible for users to override the basic + caching mechanisms. For example, the user agent might allow the user + to specify that cached entities (even explicitly stale ones) are + never validated. Or the user agent might habitually add "Cache- + Control: max-stale=3600" to every request. The user agent SHOULD NOT + default to either non-transparent behavior, or behavior that results + in abnormally ineffective caching, but MAY be explicitly configured + to do so by an explicit action of the user. + + If the user has overridden the basic caching mechanisms, the user + agent SHOULD explicitly indicate to the user whenever this results in + the display of information that might not meet the server's + transparency requirements (in particular, if the displayed entity is + known to be stale). Since the protocol normally allows the user agent + to determine if responses are stale or not, this indication need only + be displayed when this actually happens. The indication need not be a + dialog box; it could be an icon (for example, a picture of a rotting + fish) or some other indicator. + + If the user has overridden the caching mechanisms in a way that would + abnormally reduce the effectiveness of caches, the user agent SHOULD + continually indicate this state to the user (for example, by a + display of a picture of currency in flames) so that the user does not + inadvertently consume excess resources or suffer from excessive + latency. + +13.1.5 Exceptions to the Rules and Warnings + + In some cases, the operator of a cache MAY choose to configure it to + return stale responses even when not requested by clients. This + decision ought not be made lightly, but may be necessary for reasons + of availability or performance, especially when the cache is poorly + connected to the origin server. Whenever a cache returns a stale + response, it MUST mark it as such (using a Warning header) enabling + the client software to alert the user that there might be a potential + problem. + + + + + + + +Fielding, et al. Standards Track [Page 78] + +RFC 2616 HTTP/1.1 June 1999 + + + It also allows the user agent to take steps to obtain a first-hand or + fresh response. For this reason, a cache SHOULD NOT return a stale + response if the client explicitly requests a first-hand or fresh one, + unless it is impossible to comply for technical or policy reasons. + +13.1.6 Client-controlled Behavior + + While the origin server (and to a lesser extent, intermediate caches, + by their contribution to the age of a response) are the primary + source of expiration information, in some cases the client might need + to control a cache's decision about whether to return a cached + response without validating it. Clients do this using several + directives of the Cache-Control header. + + A client's request MAY specify the maximum age it is willing to + accept of an unvalidated response; specifying a value of zero forces + the cache(s) to revalidate all responses. A client MAY also specify + the minimum time remaining before a response expires. Both of these + options increase constraints on the behavior of caches, and so cannot + further relax the cache's approximation of semantic transparency. + + A client MAY also specify that it will accept stale responses, up to + some maximum amount of staleness. This loosens the constraints on the + caches, and so might violate the origin server's specified + constraints on semantic transparency, but might be necessary to + support disconnected operation, or high availability in the face of + poor connectivity. + +13.2 Expiration Model + +13.2.1 Server-Specified Expiration + + HTTP caching works best when caches can entirely avoid making + requests to the origin server. The primary mechanism for avoiding + requests is for an origin server to provide an explicit expiration + time in the future, indicating that a response MAY be used to satisfy + subsequent requests. In other words, a cache can return a fresh + response without first contacting the server. + + Our expectation is that servers will assign future explicit + expiration times to responses in the belief that the entity is not + likely to change, in a semantically significant way, before the + expiration time is reached. This normally preserves semantic + transparency, as long as the server's expiration times are carefully + chosen. + + + + + + +Fielding, et al. Standards Track [Page 79] + +RFC 2616 HTTP/1.1 June 1999 + + + The expiration mechanism applies only to responses taken from a cache + and not to first-hand responses forwarded immediately to the + requesting client. + + If an origin server wishes to force a semantically transparent cache + to validate every request, it MAY assign an explicit expiration time + in the past. This means that the response is always stale, and so the + cache SHOULD validate it before using it for subsequent requests. See + section 14.9.4 for a more restrictive way to force revalidation. + + If an origin server wishes to force any HTTP/1.1 cache, no matter how + it is configured, to validate every request, it SHOULD use the "must- + revalidate" cache-control directive (see section 14.9). + + Servers specify explicit expiration times using either the Expires + header, or the max-age directive of the Cache-Control header. + + An expiration time cannot be used to force a user agent to refresh + its display or reload a resource; its semantics apply only to caching + mechanisms, and such mechanisms need only check a resource's + expiration status when a new request for that resource is initiated. + See section 13.13 for an explanation of the difference between caches + and history mechanisms. + +13.2.2 Heuristic Expiration + + Since origin servers do not always provide explicit expiration times, + HTTP caches typically assign heuristic expiration times, employing + algorithms that use other header values (such as the Last-Modified + time) to estimate a plausible expiration time. The HTTP/1.1 + specification does not provide specific algorithms, but does impose + worst-case constraints on their results. Since heuristic expiration + times might compromise semantic transparency, they ought to used + cautiously, and we encourage origin servers to provide explicit + expiration times as much as possible. + +13.2.3 Age Calculations + + In order to know if a cached entry is fresh, a cache needs to know if + its age exceeds its freshness lifetime. We discuss how to calculate + the latter in section 13.2.4; this section describes how to calculate + the age of a response or cache entry. + + In this discussion, we use the term "now" to mean "the current value + of the clock at the host performing the calculation." Hosts that use + HTTP, but especially hosts running origin servers and caches, SHOULD + use NTP [28] or some similar protocol to synchronize their clocks to + a globally accurate time standard. + + + +Fielding, et al. Standards Track [Page 80] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 requires origin servers to send a Date header, if possible, + with every response, giving the time at which the response was + generated (see section 14.18). We use the term "date_value" to denote + the value of the Date header, in a form appropriate for arithmetic + operations. + + HTTP/1.1 uses the Age response-header to convey the estimated age of + the response message when obtained from a cache. The Age field value + is the cache's estimate of the amount of time since the response was + generated or revalidated by the origin server. + + In essence, the Age value is the sum of the time that the response + has been resident in each of the caches along the path from the + origin server, plus the amount of time it has been in transit along + network paths. + + We use the term "age_value" to denote the value of the Age header, in + a form appropriate for arithmetic operations. + + A response's age can be calculated in two entirely independent ways: + + 1. now minus date_value, if the local clock is reasonably well + synchronized to the origin server's clock. If the result is + negative, the result is replaced by zero. + + 2. age_value, if all of the caches along the response path + implement HTTP/1.1. + + Given that we have two independent ways to compute the age of a + response when it is received, we can combine these as + + corrected_received_age = max(now - date_value, age_value) + + and as long as we have either nearly synchronized clocks or all- + HTTP/1.1 paths, one gets a reliable (conservative) result. + + Because of network-imposed delays, some significant interval might + pass between the time that a server generates a response and the time + it is received at the next outbound cache or client. If uncorrected, + this delay could result in improperly low ages. + + Because the request that resulted in the returned Age value must have + been initiated prior to that Age value's generation, we can correct + for delays imposed by the network by recording the time at which the + request was initiated. Then, when an Age value is received, it MUST + be interpreted relative to the time the request was initiated, not + + + + + +Fielding, et al. Standards Track [Page 81] + +RFC 2616 HTTP/1.1 June 1999 + + + the time that the response was received. This algorithm results in + conservative behavior no matter how much delay is experienced. So, we + compute: + + corrected_initial_age = corrected_received_age + + (now - request_time) + + where "request_time" is the time (according to the local clock) when + the request that elicited this response was sent. + + Summary of age calculation algorithm, when a cache receives a + response: + + /* + * age_value + * is the value of Age: header received by the cache with + * this response. + * date_value + * is the value of the origin server's Date: header + * request_time + * is the (local) time when the cache made the request + * that resulted in this cached response + * response_time + * is the (local) time when the cache received the + * response + * now + * is the current (local) time + */ + + apparent_age = max(0, response_time - date_value); + corrected_received_age = max(apparent_age, age_value); + response_delay = response_time - request_time; + corrected_initial_age = corrected_received_age + response_delay; + resident_time = now - response_time; + current_age = corrected_initial_age + resident_time; + + The current_age of a cache entry is calculated by adding the amount + of time (in seconds) since the cache entry was last validated by the + origin server to the corrected_initial_age. When a response is + generated from a cache entry, the cache MUST include a single Age + header field in the response with a value equal to the cache entry's + current_age. + + The presence of an Age header field in a response implies that a + response is not first-hand. However, the converse is not true, since + the lack of an Age header field in a response does not imply that the + + + + + +Fielding, et al. Standards Track [Page 82] + +RFC 2616 HTTP/1.1 June 1999 + + + response is first-hand unless all caches along the request path are + compliant with HTTP/1.1 (i.e., older HTTP caches did not implement + the Age header field). + +13.2.4 Expiration Calculations + + In order to decide whether a response is fresh or stale, we need to + compare its freshness lifetime to its age. The age is calculated as + described in section 13.2.3; this section describes how to calculate + the freshness lifetime, and to determine if a response has expired. + In the discussion below, the values can be represented in any form + appropriate for arithmetic operations. + + We use the term "expires_value" to denote the value of the Expires + header. We use the term "max_age_value" to denote an appropriate + value of the number of seconds carried by the "max-age" directive of + the Cache-Control header in a response (see section 14.9.3). + + The max-age directive takes priority over Expires, so if max-age is + present in a response, the calculation is simply: + + freshness_lifetime = max_age_value + + Otherwise, if Expires is present in the response, the calculation is: + + freshness_lifetime = expires_value - date_value + + Note that neither of these calculations is vulnerable to clock skew, + since all of the information comes from the origin server. + + If none of Expires, Cache-Control: max-age, or Cache-Control: s- + maxage (see section 14.9.3) appears in the response, and the response + does not include other restrictions on caching, the cache MAY compute + a freshness lifetime using a heuristic. The cache MUST attach Warning + 113 to any response whose age is more than 24 hours if such warning + has not already been added. + + Also, if the response does have a Last-Modified time, the heuristic + expiration value SHOULD be no more than some fraction of the interval + since that time. A typical setting of this fraction might be 10%. + + The calculation to determine if a response has expired is quite + simple: + + response_is_fresh = (freshness_lifetime > current_age) + + + + + + +Fielding, et al. Standards Track [Page 83] + +RFC 2616 HTTP/1.1 June 1999 + + +13.2.5 Disambiguating Expiration Values + + Because expiration values are assigned optimistically, it is possible + for two caches to contain fresh values for the same resource that are + different. + + If a client performing a retrieval receives a non-first-hand response + for a request that was already fresh in its own cache, and the Date + header in its existing cache entry is newer than the Date on the new + response, then the client MAY ignore the response. If so, it MAY + retry the request with a "Cache-Control: max-age=0" directive (see + section 14.9), to force a check with the origin server. + + If a cache has two fresh responses for the same representation with + different validators, it MUST use the one with the more recent Date + header. This situation might arise because the cache is pooling + responses from other caches, or because a client has asked for a + reload or a revalidation of an apparently fresh cache entry. + +13.2.6 Disambiguating Multiple Responses + + Because a client might be receiving responses via multiple paths, so + that some responses flow through one set of caches and other + responses flow through a different set of caches, a client might + receive responses in an order different from that in which the origin + server sent them. We would like the client to use the most recently + generated response, even if older responses are still apparently + fresh. + + Neither the entity tag nor the expiration value can impose an + ordering on responses, since it is possible that a later response + intentionally carries an earlier expiration time. The Date values are + ordered to a granularity of one second. + + When a client tries to revalidate a cache entry, and the response it + receives contains a Date header that appears to be older than the one + for the existing entry, then the client SHOULD repeat the request + unconditionally, and include + + Cache-Control: max-age=0 + + to force any intermediate caches to validate their copies directly + with the origin server, or + + Cache-Control: no-cache + + to force any intermediate caches to obtain a new copy from the origin + server. + + + +Fielding, et al. Standards Track [Page 84] + +RFC 2616 HTTP/1.1 June 1999 + + + If the Date values are equal, then the client MAY use either response + (or MAY, if it is being extremely prudent, request a new response). + Servers MUST NOT depend on clients being able to choose + deterministically between responses generated during the same second, + if their expiration times overlap. + +13.3 Validation Model + + When a cache has a stale entry that it would like to use as a + response to a client's request, it first has to check with the origin + server (or possibly an intermediate cache with a fresh response) to + see if its cached entry is still usable. We call this "validating" + the cache entry. Since we do not want to have to pay the overhead of + retransmitting the full response if the cached entry is good, and we + do not want to pay the overhead of an extra round trip if the cached + entry is invalid, the HTTP/1.1 protocol supports the use of + conditional methods. + + The key protocol features for supporting conditional methods are + those concerned with "cache validators." When an origin server + generates a full response, it attaches some sort of validator to it, + which is kept with the cache entry. When a client (user agent or + proxy cache) makes a conditional request for a resource for which it + has a cache entry, it includes the associated validator in the + request. + + The server then checks that validator against the current validator + for the entity, and, if they match (see section 13.3.3), it responds + with a special status code (usually, 304 (Not Modified)) and no + entity-body. Otherwise, it returns a full response (including + entity-body). Thus, we avoid transmitting the full response if the + validator matches, and we avoid an extra round trip if it does not + match. + + In HTTP/1.1, a conditional request looks exactly the same as a normal + request for the same resource, except that it carries a special + header (which includes the validator) that implicitly turns the + method (usually, GET) into a conditional. + + The protocol includes both positive and negative senses of cache- + validating conditions. That is, it is possible to request either that + a method be performed if and only if a validator matches or if and + only if no validators match. + + + + + + + + +Fielding, et al. Standards Track [Page 85] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: a response that lacks a validator may still be cached, and + served from cache until it expires, unless this is explicitly + prohibited by a cache-control directive. However, a cache cannot + do a conditional retrieval if it does not have a validator for the + entity, which means it will not be refreshable after it expires. + +13.3.1 Last-Modified Dates + + The Last-Modified entity-header field value is often used as a cache + validator. In simple terms, a cache entry is considered to be valid + if the entity has not been modified since the Last-Modified value. + +13.3.2 Entity Tag Cache Validators + + The ETag response-header field value, an entity tag, provides for an + "opaque" cache validator. This might allow more reliable validation + in situations where it is inconvenient to store modification dates, + where the one-second resolution of HTTP date values is not + sufficient, or where the origin server wishes to avoid certain + paradoxes that might arise from the use of modification dates. + + Entity Tags are described in section 3.11. The headers used with + entity tags are described in sections 14.19, 14.24, 14.26 and 14.44. + +13.3.3 Weak and Strong Validators + + Since both origin servers and caches will compare two validators to + decide if they represent the same or different entities, one normally + would expect that if the entity (the entity-body or any entity- + headers) changes in any way, then the associated validator would + change as well. If this is true, then we call this validator a + "strong validator." + + However, there might be cases when a server prefers to change the + validator only on semantically significant changes, and not when + insignificant aspects of the entity change. A validator that does not + always change when the resource changes is a "weak validator." + + Entity tags are normally "strong validators," but the protocol + provides a mechanism to tag an entity tag as "weak." One can think of + a strong validator as one that changes whenever the bits of an entity + changes, while a weak value changes whenever the meaning of an entity + changes. Alternatively, one can think of a strong validator as part + of an identifier for a specific entity, while a weak validator is + part of an identifier for a set of semantically equivalent entities. + + Note: One example of a strong validator is an integer that is + incremented in stable storage every time an entity is changed. + + + +Fielding, et al. Standards Track [Page 86] + +RFC 2616 HTTP/1.1 June 1999 + + + An entity's modification time, if represented with one-second + resolution, could be a weak validator, since it is possible that + the resource might be modified twice during a single second. + + Support for weak validators is optional. However, weak validators + allow for more efficient caching of equivalent objects; for + example, a hit counter on a site is probably good enough if it is + updated every few days or weeks, and any value during that period + is likely "good enough" to be equivalent. + + A "use" of a validator is either when a client generates a request + and includes the validator in a validating header field, or when a + server compares two validators. + + Strong validators are usable in any context. Weak validators are only + usable in contexts that do not depend on exact equality of an entity. + For example, either kind is usable for a conditional GET of a full + entity. However, only a strong validator is usable for a sub-range + retrieval, since otherwise the client might end up with an internally + inconsistent entity. + + Clients MAY issue simple (non-subrange) GET requests with either weak + validators or strong validators. Clients MUST NOT use weak validators + in other forms of request. + + The only function that the HTTP/1.1 protocol defines on validators is + comparison. There are two validator comparison functions, depending + on whether the comparison context allows the use of weak validators + or not: + + - The strong comparison function: in order to be considered equal, + both validators MUST be identical in every way, and both MUST + NOT be weak. + + - The weak comparison function: in order to be considered equal, + both validators MUST be identical in every way, but either or + both of them MAY be tagged as "weak" without affecting the + result. + + An entity tag is strong unless it is explicitly tagged as weak. + Section 3.11 gives the syntax for entity tags. + + A Last-Modified time, when used as a validator in a request, is + implicitly weak unless it is possible to deduce that it is strong, + using the following rules: + + - The validator is being compared by an origin server to the + actual current validator for the entity and, + + + +Fielding, et al. Standards Track [Page 87] + +RFC 2616 HTTP/1.1 June 1999 + + + - That origin server reliably knows that the associated entity did + not change twice during the second covered by the presented + validator. + + or + + - The validator is about to be used by a client in an If- + Modified-Since or If-Unmodified-Since header, because the client + has a cache entry for the associated entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + or + + - The validator is being compared by an intermediate cache to the + validator stored in its cache entry for the entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + This method relies on the fact that if two different responses were + sent by the origin server during the same second, but both had the + same Last-Modified time, then at least one of those responses would + have a Date value equal to its Last-Modified time. The arbitrary 60- + second limit guards against the possibility that the Date and Last- + Modified values are generated from different clocks, or at somewhat + different times during the preparation of the response. An + implementation MAY use a value larger than 60 seconds, if it is + believed that 60 seconds is too short. + + If a client wishes to perform a sub-range retrieval on a value for + which it has only a Last-Modified time and no opaque validator, it + MAY do this only if the Last-Modified time is strong in the sense + described here. + + A cache or origin server receiving a conditional request, other than + a full-body GET request, MUST use the strong comparison function to + evaluate the condition. + + These rules allow HTTP/1.1 caches and clients to safely perform sub- + range retrievals on values that have been obtained from HTTP/1.0 + + + +Fielding, et al. Standards Track [Page 88] + +RFC 2616 HTTP/1.1 June 1999 + + + servers. + +13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates + + We adopt a set of rules and recommendations for origin servers, + clients, and caches regarding when various validator types ought to + be used, and for what purposes. + + HTTP/1.1 origin servers: + + - SHOULD send an entity tag validator unless it is not feasible to + generate one. + + - MAY send a weak entity tag instead of a strong entity tag, if + performance considerations support the use of weak entity tags, + or if it is unfeasible to send a strong entity tag. + + - SHOULD send a Last-Modified value if it is feasible to send one, + unless the risk of a breakdown in semantic transparency that + could result from using this date in an If-Modified-Since header + would lead to serious problems. + + In other words, the preferred behavior for an HTTP/1.1 origin server + is to send both a strong entity tag and a Last-Modified value. + + In order to be legal, a strong entity tag MUST change whenever the + associated entity value changes in any way. A weak entity tag SHOULD + change whenever the associated entity changes in a semantically + significant way. + + Note: in order to provide semantically transparent caching, an + origin server must avoid reusing a specific strong entity tag + value for two different entities, or reusing a specific weak + entity tag value for two semantically different entities. Cache + entries might persist for arbitrarily long periods, regardless of + expiration times, so it might be inappropriate to expect that a + cache will never again attempt to validate an entry using a + validator that it obtained at some point in the past. + + HTTP/1.1 clients: + + - If an entity tag has been provided by the origin server, MUST + use that entity tag in any cache-conditional request (using If- + Match or If-None-Match). + + - If only a Last-Modified value has been provided by the origin + server, SHOULD use that value in non-subrange cache-conditional + requests (using If-Modified-Since). + + + +Fielding, et al. Standards Track [Page 89] + +RFC 2616 HTTP/1.1 June 1999 + + + - If only a Last-Modified value has been provided by an HTTP/1.0 + origin server, MAY use that value in subrange cache-conditional + requests (using If-Unmodified-Since:). The user agent SHOULD + provide a way to disable this, in case of difficulty. + + - If both an entity tag and a Last-Modified value have been + provided by the origin server, SHOULD use both validators in + cache-conditional requests. This allows both HTTP/1.0 and + HTTP/1.1 caches to respond appropriately. + + An HTTP/1.1 origin server, upon receiving a conditional request that + includes both a Last-Modified date (e.g., in an If-Modified-Since or + If-Unmodified-Since header field) and one or more entity tags (e.g., + in an If-Match, If-None-Match, or If-Range header field) as cache + validators, MUST NOT return a response status of 304 (Not Modified) + unless doing so is consistent with all of the conditional header + fields in the request. + + An HTTP/1.1 caching proxy, upon receiving a conditional request that + includes both a Last-Modified date and one or more entity tags as + cache validators, MUST NOT return a locally cached response to the + client unless that cached response is consistent with all of the + conditional header fields in the request. + + Note: The general principle behind these rules is that HTTP/1.1 + servers and clients should transmit as much non-redundant + information as is available in their responses and requests. + HTTP/1.1 systems receiving this information will make the most + conservative assumptions about the validators they receive. + + HTTP/1.0 clients and caches will ignore entity tags. Generally, + last-modified values received or used by these systems will + support transparent and efficient caching, and so HTTP/1.1 origin + servers should provide Last-Modified values. In those rare cases + where the use of a Last-Modified value as a validator by an + HTTP/1.0 system could result in a serious problem, then HTTP/1.1 + origin servers should not provide one. + +13.3.5 Non-validating Conditionals + + The principle behind entity tags is that only the service author + knows the semantics of a resource well enough to select an + appropriate cache validation mechanism, and the specification of any + validator comparison function more complex than byte-equality would + open up a can of worms. Thus, comparisons of any other headers + (except Last-Modified, for compatibility with HTTP/1.0) are never + used for purposes of validating a cache entry. + + + + +Fielding, et al. Standards Track [Page 90] + +RFC 2616 HTTP/1.1 June 1999 + + +13.4 Response Cacheability + + Unless specifically constrained by a cache-control (section 14.9) + directive, a caching system MAY always store a successful response + (see section 13.8) as a cache entry, MAY return it without validation + if it is fresh, and MAY return it after successful validation. If + there is neither a cache validator nor an explicit expiration time + associated with a response, we do not expect it to be cached, but + certain caches MAY violate this expectation (for example, when little + or no network connectivity is available). A client can usually detect + that such a response was taken from a cache by comparing the Date + header to the current time. + + Note: some HTTP/1.0 caches are known to violate this expectation + without providing any Warning. + + However, in some cases it might be inappropriate for a cache to + retain an entity, or to return it in response to a subsequent + request. This might be because absolute semantic transparency is + deemed necessary by the service author, or because of security or + privacy considerations. Certain cache-control directives are + therefore provided so that the server can indicate that certain + resource entities, or portions thereof, are not to be cached + regardless of other considerations. + + Note that section 14.8 normally prevents a shared cache from saving + and returning a response to a previous request if that request + included an Authorization header. + + A response received with a status code of 200, 203, 206, 300, 301 or + 410 MAY be stored by a cache and used in reply to a subsequent + request, subject to the expiration mechanism, unless a cache-control + directive prohibits caching. However, a cache that does not support + the Range and Content-Range headers MUST NOT cache 206 (Partial + Content) responses. + + A response received with any other status code (e.g. status codes 302 + and 307) MUST NOT be returned in a reply to a subsequent request + unless there are cache-control directives or another header(s) that + explicitly allow it. For example, these include the following: an + Expires header (section 14.21); a "max-age", "s-maxage", "must- + revalidate", "proxy-revalidate", "public" or "private" cache-control + directive (section 14.9). + + + + + + + + +Fielding, et al. Standards Track [Page 91] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5 Constructing Responses From Caches + + The purpose of an HTTP cache is to store information received in + response to requests for use in responding to future requests. In + many cases, a cache simply returns the appropriate parts of a + response to the requester. However, if the cache holds a cache entry + based on a previous response, it might have to combine parts of a new + response with what is held in the cache entry. + +13.5.1 End-to-end and Hop-by-hop Headers + + For the purpose of defining the behavior of caches and non-caching + proxies, we divide HTTP headers into two categories: + + - End-to-end headers, which are transmitted to the ultimate + recipient of a request or response. End-to-end headers in + responses MUST be stored as part of a cache entry and MUST be + transmitted in any response formed from a cache entry. + + - Hop-by-hop headers, which are meaningful only for a single + transport-level connection, and are not stored by caches or + forwarded by proxies. + + The following HTTP/1.1 headers are hop-by-hop headers: + + - Connection + - Keep-Alive + - Proxy-Authenticate + - Proxy-Authorization + - TE + - Trailers + - Transfer-Encoding + - Upgrade + + All other headers defined by HTTP/1.1 are end-to-end headers. + + Other hop-by-hop headers MUST be listed in a Connection header, + (section 14.10) to be introduced into HTTP/1.1 (or later). + +13.5.2 Non-modifiable Headers + + Some features of the HTTP/1.1 protocol, such as Digest + Authentication, depend on the value of certain end-to-end headers. A + transparent proxy SHOULD NOT modify an end-to-end header unless the + definition of that header requires or specifically allows that. + + + + + + +Fielding, et al. Standards Track [Page 92] + +RFC 2616 HTTP/1.1 June 1999 + + + A transparent proxy MUST NOT modify any of the following fields in a + request or response, and it MUST NOT add any of these fields if not + already present: + + - Content-Location + + - Content-MD5 + + - ETag + + - Last-Modified + + A transparent proxy MUST NOT modify any of the following fields in a + response: + + - Expires + + but it MAY add any of these fields if not already present. If an + Expires header is added, it MUST be given a field-value identical to + that of the Date header in that response. + + A proxy MUST NOT modify or add any of the following fields in a + message that contains the no-transform cache-control directive, or in + any request: + + - Content-Encoding + + - Content-Range + + - Content-Type + + A non-transparent proxy MAY modify or add these fields to a message + that does not include no-transform, but if it does so, it MUST add a + Warning 214 (Transformation applied) if one does not already appear + in the message (see section 14.46). + + Warning: unnecessary modification of end-to-end headers might + cause authentication failures if stronger authentication + mechanisms are introduced in later versions of HTTP. Such + authentication mechanisms MAY rely on the values of header fields + not listed here. + + The Content-Length field of a request or response is added or deleted + according to the rules in section 4.4. A transparent proxy MUST + preserve the entity-length (section 7.2.2) of the entity-body, + although it MAY change the transfer-length (section 4.4). + + + + + +Fielding, et al. Standards Track [Page 93] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.3 Combining Headers + + When a cache makes a validating request to a server, and the server + provides a 304 (Not Modified) response or a 206 (Partial Content) + response, the cache then constructs a response to send to the + requesting client. + + If the status code is 304 (Not Modified), the cache uses the entity- + body stored in the cache entry as the entity-body of this outgoing + response. If the status code is 206 (Partial Content) and the ETag or + Last-Modified headers match exactly, the cache MAY combine the + contents stored in the cache entry with the new contents received in + the response and use the result as the entity-body of this outgoing + response, (see 13.5.4). + + The end-to-end headers stored in the cache entry are used for the + constructed response, except that + + - any stored Warning headers with warn-code 1xx (see section + 14.46) MUST be deleted from the cache entry and the forwarded + response. + + - any stored Warning headers with warn-code 2xx MUST be retained + in the cache entry and the forwarded response. + + - any end-to-end headers provided in the 304 or 206 response MUST + replace the corresponding headers from the cache entry. + + Unless the cache decides to remove the cache entry, it MUST also + replace the end-to-end headers stored with the cache entry with + corresponding headers received in the incoming response, except for + Warning headers as described immediately above. If a header field- + name in the incoming response matches more than one header in the + cache entry, all such old headers MUST be replaced. + + In other words, the set of end-to-end headers received in the + incoming response overrides all corresponding end-to-end headers + stored with the cache entry (except for stored Warning headers with + warn-code 1xx, which are deleted even if not overridden). + + Note: this rule allows an origin server to use a 304 (Not + Modified) or a 206 (Partial Content) response to update any header + associated with a previous response for the same entity or sub- + ranges thereof, although it might not always be meaningful or + correct to do so. This rule does not allow an origin server to use + a 304 (Not Modified) or a 206 (Partial Content) response to + entirely delete a header that it had provided with a previous + response. + + + +Fielding, et al. Standards Track [Page 94] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.4 Combining Byte Ranges + + A response might transfer only a subrange of the bytes of an entity- + body, either because the request included one or more Range + specifications, or because a connection was broken prematurely. After + several such transfers, a cache might have received several ranges of + the same entity-body. + + If a cache has a stored non-empty set of subranges for an entity, and + an incoming response transfers another subrange, the cache MAY + combine the new subrange with the existing set if both the following + conditions are met: + + - Both the incoming response and the cache entry have a cache + validator. + + - The two cache validators match using the strong comparison + function (see section 13.3.3). + + If either requirement is not met, the cache MUST use only the most + recent partial response (based on the Date values transmitted with + every response, and using the incoming response if these values are + equal or missing), and MUST discard the other partial information. + +13.6 Caching Negotiated Responses + + Use of server-driven content negotiation (section 12.1), as indicated + by the presence of a Vary header field in a response, alters the + conditions and procedure by which a cache can use the response for + subsequent requests. See section 14.44 for use of the Vary header + field by servers. + + A server SHOULD use the Vary header field to inform a cache of what + request-header fields were used to select among multiple + representations of a cacheable response subject to server-driven + negotiation. The set of header fields named by the Vary field value + is known as the "selecting" request-headers. + + When the cache receives a subsequent request whose Request-URI + specifies one or more cache entries including a Vary header field, + the cache MUST NOT use such a cache entry to construct a response to + the new request unless all of the selecting request-headers present + in the new request match the corresponding stored request-headers in + the original request. + + The selecting request-headers from two requests are defined to match + if and only if the selecting request-headers in the first request can + be transformed to the selecting request-headers in the second request + + + +Fielding, et al. Standards Track [Page 95] + +RFC 2616 HTTP/1.1 June 1999 + + + by adding or removing linear white space (LWS) at places where this + is allowed by the corresponding BNF, and/or combining multiple + message-header fields with the same field name following the rules + about message headers in section 4.2. + + A Vary header field-value of "*" always fails to match and subsequent + requests on that resource can only be properly interpreted by the + origin server. + + If the selecting request header fields for the cached entry do not + match the selecting request header fields of the new request, then + the cache MUST NOT use a cached entry to satisfy the request unless + it first relays the new request to the origin server in a conditional + request and the server responds with 304 (Not Modified), including an + entity tag or Content-Location that indicates the entity to be used. + + If an entity tag was assigned to a cached representation, the + forwarded request SHOULD be conditional and include the entity tags + in an If-None-Match header field from all its cache entries for the + resource. This conveys to the server the set of entities currently + held by the cache, so that if any one of these entities matches the + requested entity, the server can use the ETag header field in its 304 + (Not Modified) response to tell the cache which entry is appropriate. + If the entity-tag of the new response matches that of an existing + entry, the new response SHOULD be used to update the header fields of + the existing entry, and the result MUST be returned to the client. + + If any of the existing cache entries contains only partial content + for the associated entity, its entity-tag SHOULD NOT be included in + the If-None-Match header field unless the request is for a range that + would be fully satisfied by that entry. + + If a cache receives a successful response whose Content-Location + field matches that of an existing cache entry for the same Request- + ]URI, whose entity-tag differs from that of the existing entry, and + whose Date is more recent than that of the existing entry, the + existing entry SHOULD NOT be returned in response to future requests + and SHOULD be deleted from the cache. + +13.7 Shared and Non-Shared Caches + + For reasons of security and privacy, it is necessary to make a + distinction between "shared" and "non-shared" caches. A non-shared + cache is one that is accessible only to a single user. Accessibility + in this case SHOULD be enforced by appropriate security mechanisms. + All other caches are considered to be "shared." Other sections of + + + + + +Fielding, et al. Standards Track [Page 96] + +RFC 2616 HTTP/1.1 June 1999 + + + this specification place certain constraints on the operation of + shared caches in order to prevent loss of privacy or failure of + access controls. + +13.8 Errors or Incomplete Response Cache Behavior + + A cache that receives an incomplete response (for example, with fewer + bytes of data than specified in a Content-Length header) MAY store + the response. However, the cache MUST treat this as a partial + response. Partial responses MAY be combined as described in section + 13.5.4; the result might be a full response or might still be + partial. A cache MUST NOT return a partial response to a client + without explicitly marking it as such, using the 206 (Partial + Content) status code. A cache MUST NOT return a partial response + using a status code of 200 (OK). + + If a cache receives a 5xx response while attempting to revalidate an + entry, it MAY either forward this response to the requesting client, + or act as if the server failed to respond. In the latter case, it MAY + return a previously received response unless the cached entry + includes the "must-revalidate" cache-control directive (see section + 14.9). + +13.9 Side Effects of GET and HEAD + + Unless the origin server explicitly prohibits the caching of their + responses, the application of GET and HEAD methods to any resources + SHOULD NOT have side effects that would lead to erroneous behavior if + these responses are taken from a cache. They MAY still have side + effects, but a cache is not required to consider such side effects in + its caching decisions. Caches are always expected to observe an + origin server's explicit restrictions on caching. + + We note one exception to this rule: since some applications have + traditionally used GETs and HEADs with query URLs (those containing a + "?" in the rel_path part) to perform operations with significant side + effects, caches MUST NOT treat responses to such URIs as fresh unless + the server provides an explicit expiration time. This specifically + means that responses from HTTP/1.0 servers for such URIs SHOULD NOT + be taken from a cache. See section 9.1.1 for related information. + +13.10 Invalidation After Updates or Deletions + + The effect of certain methods performed on a resource at the origin + server might cause one or more existing cache entries to become non- + transparently invalid. That is, although they might continue to be + "fresh," they do not accurately reflect what the origin server would + return for a new request on that resource. + + + +Fielding, et al. Standards Track [Page 97] + +RFC 2616 HTTP/1.1 June 1999 + + + There is no way for the HTTP protocol to guarantee that all such + cache entries are marked invalid. For example, the request that + caused the change at the origin server might not have gone through + the proxy where a cache entry is stored. However, several rules help + reduce the likelihood of erroneous behavior. + + In this section, the phrase "invalidate an entity" means that the + cache will either remove all instances of that entity from its + storage, or will mark these as "invalid" and in need of a mandatory + revalidation before they can be returned in response to a subsequent + request. + + Some HTTP methods MUST cause a cache to invalidate an entity. This is + either the entity referred to by the Request-URI, or by the Location + or Content-Location headers (if present). These methods are: + + - PUT + + - DELETE + + - POST + + In order to prevent denial of service attacks, an invalidation based + on the URI in a Location or Content-Location header MUST only be + performed if the host part is the same as in the Request-URI. + + A cache that passes through requests for methods it does not + understand SHOULD invalidate any entities referred to by the + Request-URI. + +13.11 Write-Through Mandatory + + All methods that might be expected to cause modifications to the + origin server's resources MUST be written through to the origin + server. This currently includes all methods except for GET and HEAD. + A cache MUST NOT reply to such a request from a client before having + transmitted the request to the inbound server, and having received a + corresponding response from the inbound server. This does not prevent + a proxy cache from sending a 100 (Continue) response before the + inbound server has sent its final reply. + + The alternative (known as "write-back" or "copy-back" caching) is not + allowed in HTTP/1.1, due to the difficulty of providing consistent + updates and the problems arising from server, cache, or network + failure prior to write-back. + + + + + + +Fielding, et al. Standards Track [Page 98] + +RFC 2616 HTTP/1.1 June 1999 + + +13.12 Cache Replacement + + If a new cacheable (see sections 14.9.2, 13.2.5, 13.2.6 and 13.8) + response is received from a resource while any existing responses for + the same resource are cached, the cache SHOULD use the new response + to reply to the current request. It MAY insert it into cache storage + and MAY, if it meets all other requirements, use it to respond to any + future requests that would previously have caused the old response to + be returned. If it inserts the new response into cache storage the + rules in section 13.5.3 apply. + + Note: a new response that has an older Date header value than + existing cached responses is not cacheable. + +13.13 History Lists + + User agents often have history mechanisms, such as "Back" buttons and + history lists, which can be used to redisplay an entity retrieved + earlier in a session. + + History mechanisms and caches are different. In particular history + mechanisms SHOULD NOT try to show a semantically transparent view of + the current state of a resource. Rather, a history mechanism is meant + to show exactly what the user saw at the time when the resource was + retrieved. + + By default, an expiration time does not apply to history mechanisms. + If the entity is still in storage, a history mechanism SHOULD display + it even if the entity has expired, unless the user has specifically + configured the agent to refresh expired history documents. + + This is not to be construed to prohibit the history mechanism from + telling the user that a view might be stale. + + Note: if history list mechanisms unnecessarily prevent users from + viewing stale resources, this will tend to force service authors + to avoid using HTTP expiration controls and cache controls when + they would otherwise like to. Service authors may consider it + important that users not be presented with error messages or + warning messages when they use navigation controls (such as BACK) + to view previously fetched resources. Even though sometimes such + resources ought not to cached, or ought to expire quickly, user + interface considerations may force service authors to resort to + other means of preventing caching (e.g. "once-only" URLs) in order + not to suffer the effects of improperly functioning history + mechanisms. + + + + + +Fielding, et al. Standards Track [Page 99] + +RFC 2616 HTTP/1.1 June 1999 + + +14 Header Field Definitions + + This section defines the syntax and semantics of all standard + HTTP/1.1 header fields. For entity-header fields, both sender and + recipient refer to either the client or the server, depending on who + sends and who receives the entity. + +14.1 Accept + + The Accept request-header field can be used to specify certain media + types which are acceptable for the response. Accept headers can be + used to indicate that the request is specifically limited to a small + set of desired types, as in the case of a request for an in-line + image. + + Accept = "Accept" ":" + #( media-range [ accept-params ] ) + + media-range = ( "*/*" + | ( type "/" "*" ) + | ( type "/" subtype ) + ) *( ";" parameter ) + accept-params = ";" "q" "=" qvalue *( accept-extension ) + accept-extension = ";" token [ "=" ( token | quoted-string ) ] + + The asterisk "*" character is used to group media types into ranges, + with "*/*" indicating all media types and "type/*" indicating all + subtypes of that type. The media-range MAY include media type + parameters that are applicable to that range. + + Each media-range MAY be followed by one or more accept-params, + beginning with the "q" parameter for indicating a relative quality + factor. The first "q" parameter (if any) separates the media-range + parameter(s) from the accept-params. Quality factors allow the user + or user agent to indicate the relative degree of preference for that + media-range, using the qvalue scale from 0 to 1 (section 3.9). The + default value is q=1. + + Note: Use of the "q" parameter name to separate media type + parameters from Accept extension parameters is due to historical + practice. Although this prevents any media type parameter named + "q" from being used with a media range, such an event is believed + to be unlikely given the lack of any "q" parameters in the IANA + media type registry and the rare usage of any media type + parameters in Accept. Future media types are discouraged from + registering any parameter named "q". + + + + + +Fielding, et al. Standards Track [Page 100] + +RFC 2616 HTTP/1.1 June 1999 + + + The example + + Accept: audio/*; q=0.2, audio/basic + + SHOULD be interpreted as "I prefer audio/basic, but send me any audio + type if it is the best available after an 80% mark-down in quality." + + If no Accept header field is present, then it is assumed that the + client accepts all media types. If an Accept header field is present, + and if the server cannot send a response which is acceptable + according to the combined Accept field value, then the server SHOULD + send a 406 (not acceptable) response. + + A more elaborate example is + + Accept: text/plain; q=0.5, text/html, + text/x-dvi; q=0.8, text/x-c + + Verbally, this would be interpreted as "text/html and text/x-c are + the preferred media types, but if they do not exist, then send the + text/x-dvi entity, and if that does not exist, send the text/plain + entity." + + Media ranges can be overridden by more specific media ranges or + specific media types. If more than one media range applies to a given + type, the most specific reference has precedence. For example, + + Accept: text/*, text/html, text/html;level=1, */* + + have the following precedence: + + 1) text/html;level=1 + 2) text/html + 3) text/* + 4) */* + + The media type quality factor associated with a given type is + determined by finding the media range with the highest precedence + which matches that type. For example, + + Accept: text/*;q=0.3, text/html;q=0.7, text/html;level=1, + text/html;level=2;q=0.4, */*;q=0.5 + + would cause the following values to be associated: + + text/html;level=1 = 1 + text/html = 0.7 + text/plain = 0.3 + + + +Fielding, et al. Standards Track [Page 101] + +RFC 2616 HTTP/1.1 June 1999 + + + image/jpeg = 0.5 + text/html;level=2 = 0.4 + text/html;level=3 = 0.7 + + Note: A user agent might be provided with a default set of quality + values for certain media ranges. However, unless the user agent is + a closed system which cannot interact with other rendering agents, + this default set ought to be configurable by the user. + +14.2 Accept-Charset + + The Accept-Charset request-header field can be used to indicate what + character sets are acceptable for the response. This field allows + clients capable of understanding more comprehensive or special- + purpose character sets to signal that capability to a server which is + capable of representing documents in those character sets. + + Accept-Charset = "Accept-Charset" ":" + 1#( ( charset | "*" )[ ";" "q" "=" qvalue ] ) + + + Character set values are described in section 3.4. Each charset MAY + be given an associated quality value which represents the user's + preference for that charset. The default value is q=1. An example is + + Accept-Charset: iso-8859-5, unicode-1-1;q=0.8 + + The special value "*", if present in the Accept-Charset field, + matches every character set (including ISO-8859-1) which is not + mentioned elsewhere in the Accept-Charset field. If no "*" is present + in an Accept-Charset field, then all character sets not explicitly + mentioned get a quality value of 0, except for ISO-8859-1, which gets + a quality value of 1 if not explicitly mentioned. + + If no Accept-Charset header is present, the default is that any + character set is acceptable. If an Accept-Charset header is present, + and if the server cannot send a response which is acceptable + according to the Accept-Charset header, then the server SHOULD send + an error response with the 406 (not acceptable) status code, though + the sending of an unacceptable response is also allowed. + +14.3 Accept-Encoding + + The Accept-Encoding request-header field is similar to Accept, but + restricts the content-codings (section 3.5) that are acceptable in + the response. + + Accept-Encoding = "Accept-Encoding" ":" + + + +Fielding, et al. Standards Track [Page 102] + +RFC 2616 HTTP/1.1 June 1999 + + + 1#( codings [ ";" "q" "=" qvalue ] ) + codings = ( content-coding | "*" ) + + Examples of its use are: + + Accept-Encoding: compress, gzip + Accept-Encoding: + Accept-Encoding: * + Accept-Encoding: compress;q=0.5, gzip;q=1.0 + Accept-Encoding: gzip;q=1.0, identity; q=0.5, *;q=0 + + A server tests whether a content-coding is acceptable, according to + an Accept-Encoding field, using these rules: + + 1. If the content-coding is one of the content-codings listed in + the Accept-Encoding field, then it is acceptable, unless it is + accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + 2. The special "*" symbol in an Accept-Encoding field matches any + available content-coding not explicitly listed in the header + field. + + 3. If multiple content-codings are acceptable, then the acceptable + content-coding with the highest non-zero qvalue is preferred. + + 4. The "identity" content-coding is always acceptable, unless + specifically refused because the Accept-Encoding field includes + "identity;q=0", or because the field includes "*;q=0" and does + not explicitly include the "identity" content-coding. If the + Accept-Encoding field-value is empty, then only the "identity" + encoding is acceptable. + + If an Accept-Encoding field is present in a request, and if the + server cannot send a response which is acceptable according to the + Accept-Encoding header, then the server SHOULD send an error response + with the 406 (Not Acceptable) status code. + + If no Accept-Encoding field is present in a request, the server MAY + assume that the client will accept any content coding. In this case, + if "identity" is one of the available content-codings, then the + server SHOULD use the "identity" content-coding, unless it has + additional information that a different content-coding is meaningful + to the client. + + Note: If the request does not include an Accept-Encoding field, + and if the "identity" content-coding is unavailable, then + content-codings commonly understood by HTTP/1.0 clients (i.e., + + + +Fielding, et al. Standards Track [Page 103] + +RFC 2616 HTTP/1.1 June 1999 + + + "gzip" and "compress") are preferred; some older clients + improperly display messages sent with other content-codings. The + server might also make this decision based on information about + the particular user-agent or client. + + Note: Most HTTP/1.0 applications do not recognize or obey qvalues + associated with content-codings. This means that qvalues will not + work and are not permitted with x-gzip or x-compress. + +14.4 Accept-Language + + The Accept-Language request-header field is similar to Accept, but + restricts the set of natural languages that are preferred as a + response to the request. Language tags are defined in section 3.10. + + Accept-Language = "Accept-Language" ":" + 1#( language-range [ ";" "q" "=" qvalue ] ) + language-range = ( ( 1*8ALPHA *( "-" 1*8ALPHA ) ) | "*" ) + + Each language-range MAY be given an associated quality value which + represents an estimate of the user's preference for the languages + specified by that range. The quality value defaults to "q=1". For + example, + + Accept-Language: da, en-gb;q=0.8, en;q=0.7 + + would mean: "I prefer Danish, but will accept British English and + other types of English." A language-range matches a language-tag if + it exactly equals the tag, or if it exactly equals a prefix of the + tag such that the first tag character following the prefix is "-". + The special range "*", if present in the Accept-Language field, + matches every tag not matched by any other range present in the + Accept-Language field. + + Note: This use of a prefix matching rule does not imply that + language tags are assigned to languages in such a way that it is + always true that if a user understands a language with a certain + tag, then this user will also understand all languages with tags + for which this tag is a prefix. The prefix rule simply allows the + use of prefix tags if this is the case. + + The language quality factor assigned to a language-tag by the + Accept-Language field is the quality value of the longest language- + range in the field that matches the language-tag. If no language- + range in the field matches the tag, the language quality factor + assigned is 0. If no Accept-Language header is present in the + request, the server + + + + +Fielding, et al. Standards Track [Page 104] + +RFC 2616 HTTP/1.1 June 1999 + + + SHOULD assume that all languages are equally acceptable. If an + Accept-Language header is present, then all languages which are + assigned a quality factor greater than 0 are acceptable. + + It might be contrary to the privacy expectations of the user to send + an Accept-Language header with the complete linguistic preferences of + the user in every request. For a discussion of this issue, see + section 15.1.4. + + As intelligibility is highly dependent on the individual user, it is + recommended that client applications make the choice of linguistic + preference available to the user. If the choice is not made + available, then the Accept-Language header field MUST NOT be given in + the request. + + Note: When making the choice of linguistic preference available to + the user, we remind implementors of the fact that users are not + familiar with the details of language matching as described above, + and should provide appropriate guidance. As an example, users + might assume that on selecting "en-gb", they will be served any + kind of English document if British English is not available. A + user agent might suggest in such a case to add "en" to get the + best matching behavior. + +14.5 Accept-Ranges + + The Accept-Ranges response-header field allows the server to + indicate its acceptance of range requests for a resource: + + Accept-Ranges = "Accept-Ranges" ":" acceptable-ranges + acceptable-ranges = 1#range-unit | "none" + + Origin servers that accept byte-range requests MAY send + + Accept-Ranges: bytes + + but are not required to do so. Clients MAY generate byte-range + requests without having received this header for the resource + involved. Range units are defined in section 3.12. + + Servers that do not accept any kind of range request for a + resource MAY send + + Accept-Ranges: none + + to advise the client not to attempt a range request. + + + + + +Fielding, et al. Standards Track [Page 105] + +RFC 2616 HTTP/1.1 June 1999 + + +14.6 Age + + The Age response-header field conveys the sender's estimate of the + amount of time since the response (or its revalidation) was + generated at the origin server. A cached response is "fresh" if + its age does not exceed its freshness lifetime. Age values are + calculated as specified in section 13.2.3. + + Age = "Age" ":" age-value + age-value = delta-seconds + + Age values are non-negative decimal integers, representing time in + seconds. + + If a cache receives a value larger than the largest positive + integer it can represent, or if any of its age calculations + overflows, it MUST transmit an Age header with a value of + 2147483648 (2^31). An HTTP/1.1 server that includes a cache MUST + include an Age header field in every response generated from its + own cache. Caches SHOULD use an arithmetic type of at least 31 + bits of range. + +14.7 Allow + + The Allow entity-header field lists the set of methods supported + by the resource identified by the Request-URI. The purpose of this + field is strictly to inform the recipient of valid methods + associated with the resource. An Allow header field MUST be + present in a 405 (Method Not Allowed) response. + + Allow = "Allow" ":" #Method + + Example of use: + + Allow: GET, HEAD, PUT + + This field cannot prevent a client from trying other methods. + However, the indications given by the Allow header field value + SHOULD be followed. The actual set of allowed methods is defined + by the origin server at the time of each request. + + The Allow header field MAY be provided with a PUT request to + recommend the methods to be supported by the new or modified + resource. The server is not required to support these methods and + SHOULD include an Allow header in the response giving the actual + supported methods. + + + + + +Fielding, et al. Standards Track [Page 106] + +RFC 2616 HTTP/1.1 June 1999 + + + A proxy MUST NOT modify the Allow header field even if it does not + understand all the methods specified, since the user agent might + have other means of communicating with the origin server. + +14.8 Authorization + + A user agent that wishes to authenticate itself with a server-- + usually, but not necessarily, after receiving a 401 response--does + so by including an Authorization request-header field with the + request. The Authorization field value consists of credentials + containing the authentication information of the user agent for + the realm of the resource being requested. + + Authorization = "Authorization" ":" credentials + + HTTP access authentication is described in "HTTP Authentication: + Basic and Digest Access Authentication" [43]. If a request is + authenticated and a realm specified, the same credentials SHOULD + be valid for all other requests within this realm (assuming that + the authentication scheme itself does not require otherwise, such + as credentials that vary according to a challenge value or using + synchronized clocks). + + When a shared cache (see section 13.7) receives a request + containing an Authorization field, it MUST NOT return the + corresponding response as a reply to any other request, unless one + of the following specific exceptions holds: + + 1. If the response includes the "s-maxage" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But (if the specified maximum age has + passed) a proxy cache MUST first revalidate it with the origin + server, using the request-headers from the new request to allow + the origin server to authenticate the new request. (This is the + defined behavior for s-maxage.) If the response includes "s- + maxage=0", the proxy MUST always revalidate it before re-using + it. + + 2. If the response includes the "must-revalidate" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But if the response is stale, all caches + MUST first revalidate it with the origin server, using the + request-headers from the new request to allow the origin server + to authenticate the new request. + + 3. If the response includes the "public" cache-control directive, + it MAY be returned in reply to any subsequent request. + + + + +Fielding, et al. Standards Track [Page 107] + +RFC 2616 HTTP/1.1 June 1999 + + +14.9 Cache-Control + + The Cache-Control general-header field is used to specify directives + that MUST be obeyed by all caching mechanisms along the + request/response chain. The directives specify behavior intended to + prevent caches from adversely interfering with the request or + response. These directives typically override the default caching + algorithms. Cache directives are unidirectional in that the presence + of a directive in a request does not imply that the same directive is + to be given in the response. + + Note that HTTP/1.0 caches might not implement Cache-Control and + might only implement Pragma: no-cache (see section 14.32). + + Cache directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a cache- + directive for a specific cache. + + Cache-Control = "Cache-Control" ":" 1#cache-directive + + cache-directive = cache-request-directive + | cache-response-directive + + cache-request-directive = + "no-cache" ; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "max-age" "=" delta-seconds ; Section 14.9.3, 14.9.4 + | "max-stale" [ "=" delta-seconds ] ; Section 14.9.3 + | "min-fresh" "=" delta-seconds ; Section 14.9.3 + | "no-transform" ; Section 14.9.5 + | "only-if-cached" ; Section 14.9.4 + | cache-extension ; Section 14.9.6 + + cache-response-directive = + "public" ; Section 14.9.1 + | "private" [ "=" <"> 1#field-name <"> ] ; Section 14.9.1 + | "no-cache" [ "=" <"> 1#field-name <"> ]; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "no-transform" ; Section 14.9.5 + | "must-revalidate" ; Section 14.9.4 + | "proxy-revalidate" ; Section 14.9.4 + | "max-age" "=" delta-seconds ; Section 14.9.3 + | "s-maxage" "=" delta-seconds ; Section 14.9.3 + | cache-extension ; Section 14.9.6 + + cache-extension = token [ "=" ( token | quoted-string ) ] + + + +Fielding, et al. Standards Track [Page 108] + +RFC 2616 HTTP/1.1 June 1999 + + + When a directive appears without any 1#field-name parameter, the + directive applies to the entire request or response. When such a + directive appears with a 1#field-name parameter, it applies only to + the named field or fields, and not to the rest of the request or + response. This mechanism supports extensibility; implementations of + future versions of the HTTP protocol might apply these directives to + header fields not defined in HTTP/1.1. + + The cache-control directives can be broken down into these general + categories: + + - Restrictions on what are cacheable; these may only be imposed by + the origin server. + + - Restrictions on what may be stored by a cache; these may be + imposed by either the origin server or the user agent. + + - Modifications of the basic expiration mechanism; these may be + imposed by either the origin server or the user agent. + + - Controls over cache revalidation and reload; these may only be + imposed by a user agent. + + - Control over transformation of entities. + + - Extensions to the caching system. + +14.9.1 What is Cacheable + + By default, a response is cacheable if the requirements of the + request method, request header fields, and the response status + indicate that it is cacheable. Section 13.4 summarizes these defaults + for cacheability. The following Cache-Control response directives + allow an origin server to override the default cacheability of a + response: + + public + Indicates that the response MAY be cached by any cache, even if it + would normally be non-cacheable or cacheable only within a non- + shared cache. (See also Authorization, section 14.8, for + additional details.) + + private + Indicates that all or part of the response message is intended for + a single user and MUST NOT be cached by a shared cache. This + allows an origin server to state that the specified parts of the + + + + + +Fielding, et al. Standards Track [Page 109] + +RFC 2616 HTTP/1.1 June 1999 + + + response are intended for only one user and are not a valid + response for requests by other users. A private (non-shared) cache + MAY cache the response. + + Note: This usage of the word private only controls where the + response may be cached, and cannot ensure the privacy of the + message content. + + no-cache + If the no-cache directive does not specify a field-name, then a + cache MUST NOT use the response to satisfy a subsequent request + without successful revalidation with the origin server. This + allows an origin server to prevent caching even by caches that + have been configured to return stale responses to client requests. + + If the no-cache directive does specify one or more field-names, + then a cache MAY use the response to satisfy a subsequent request, + subject to any other restrictions on caching. However, the + specified field-name(s) MUST NOT be sent in the response to a + subsequent request without successful revalidation with the origin + server. This allows an origin server to prevent the re-use of + certain header fields in a response, while still allowing caching + of the rest of the response. + + Note: Most HTTP/1.0 caches will not recognize or obey this + directive. + +14.9.2 What May be Stored by Caches + + no-store + The purpose of the no-store directive is to prevent the + inadvertent release or retention of sensitive information (for + example, on backup tapes). The no-store directive applies to the + entire message, and MAY be sent either in a response or in a + request. If sent in a request, a cache MUST NOT store any part of + either this request or any response to it. If sent in a response, + a cache MUST NOT store any part of either this response or the + request that elicited it. This directive applies to both non- + shared and shared caches. "MUST NOT store" in this context means + that the cache MUST NOT intentionally store the information in + non-volatile storage, and MUST make a best-effort attempt to + remove the information from volatile storage as promptly as + possible after forwarding it. + + Even when this directive is associated with a response, users + might explicitly store such a response outside of the caching + system (e.g., with a "Save As" dialog). History buffers MAY store + such responses as part of their normal operation. + + + +Fielding, et al. Standards Track [Page 110] + +RFC 2616 HTTP/1.1 June 1999 + + + The purpose of this directive is to meet the stated requirements + of certain users and service authors who are concerned about + accidental releases of information via unanticipated accesses to + cache data structures. While the use of this directive might + improve privacy in some cases, we caution that it is NOT in any + way a reliable or sufficient mechanism for ensuring privacy. In + particular, malicious or compromised caches might not recognize or + obey this directive, and communications networks might be + vulnerable to eavesdropping. + +14.9.3 Modifications of the Basic Expiration Mechanism + + The expiration time of an entity MAY be specified by the origin + server using the Expires header (see section 14.21). Alternatively, + it MAY be specified using the max-age directive in a response. When + the max-age cache-control directive is present in a cached response, + the response is stale if its current age is greater than the age + value given (in seconds) at the time of a new request for that + resource. The max-age directive on a response implies that the + response is cacheable (i.e., "public") unless some other, more + restrictive cache directive is also present. + + If a response includes both an Expires header and a max-age + directive, the max-age directive overrides the Expires header, even + if the Expires header is more restrictive. This rule allows an origin + server to provide, for a given response, a longer expiration time to + an HTTP/1.1 (or later) cache than to an HTTP/1.0 cache. This might be + useful if certain HTTP/1.0 caches improperly calculate ages or + expiration times, perhaps due to desynchronized clocks. + + Many HTTP/1.0 cache implementations will treat an Expires value that + is less than or equal to the response Date value as being equivalent + to the Cache-Control response directive "no-cache". If an HTTP/1.1 + cache receives such a response, and the response does not include a + Cache-Control header field, it SHOULD consider the response to be + non-cacheable in order to retain compatibility with HTTP/1.0 servers. + + Note: An origin server might wish to use a relatively new HTTP + cache control feature, such as the "private" directive, on a + network including older caches that do not understand that + feature. The origin server will need to combine the new feature + with an Expires field whose value is less than or equal to the + Date value. This will prevent older caches from improperly + caching the response. + + + + + + + +Fielding, et al. Standards Track [Page 111] + +RFC 2616 HTTP/1.1 June 1999 + + + s-maxage + If a response includes an s-maxage directive, then for a shared + cache (but not for a private cache), the maximum age specified by + this directive overrides the maximum age specified by either the + max-age directive or the Expires header. The s-maxage directive + also implies the semantics of the proxy-revalidate directive (see + section 14.9.4), i.e., that the shared cache must not use the + entry after it becomes stale to respond to a subsequent request + without first revalidating it with the origin server. The s- + maxage directive is always ignored by a private cache. + + Note that most older caches, not compliant with this specification, + do not implement any cache-control directives. An origin server + wishing to use a cache-control directive that restricts, but does not + prevent, caching by an HTTP/1.1-compliant cache MAY exploit the + requirement that the max-age directive overrides the Expires header, + and the fact that pre-HTTP/1.1-compliant caches do not observe the + max-age directive. + + Other directives allow a user agent to modify the basic expiration + mechanism. These directives MAY be specified on a request: + + max-age + Indicates that the client is willing to accept a response whose + age is no greater than the specified time in seconds. Unless max- + stale directive is also included, the client is not willing to + accept a stale response. + + min-fresh + Indicates that the client is willing to accept a response whose + freshness lifetime is no less than its current age plus the + specified time in seconds. That is, the client wants a response + that will still be fresh for at least the specified number of + seconds. + + max-stale + Indicates that the client is willing to accept a response that has + exceeded its expiration time. If max-stale is assigned a value, + then the client is willing to accept a response that has exceeded + its expiration time by no more than the specified number of + seconds. If no value is assigned to max-stale, then the client is + willing to accept a stale response of any age. + + If a cache returns a stale response, either because of a max-stale + directive on a request, or because the cache is configured to + override the expiration time of a response, the cache MUST attach a + Warning header to the stale response, using Warning 110 (Response is + stale). + + + +Fielding, et al. Standards Track [Page 112] + +RFC 2616 HTTP/1.1 June 1999 + + + A cache MAY be configured to return stale responses without + validation, but only if this does not conflict with any "MUST"-level + requirements concerning cache validation (e.g., a "must-revalidate" + cache-control directive). + + If both the new request and the cached entry include "max-age" + directives, then the lesser of the two values is used for determining + the freshness of the cached entry for that request. + +14.9.4 Cache Revalidation and Reload Controls + + Sometimes a user agent might want or need to insist that a cache + revalidate its cache entry with the origin server (and not just with + the next cache along the path to the origin server), or to reload its + cache entry from the origin server. End-to-end revalidation might be + necessary if either the cache or the origin server has overestimated + the expiration time of the cached response. End-to-end reload may be + necessary if the cache entry has become corrupted for some reason. + + End-to-end revalidation may be requested either when the client does + not have its own local cached copy, in which case we call it + "unspecified end-to-end revalidation", or when the client does have a + local cached copy, in which case we call it "specific end-to-end + revalidation." + + The client can specify these three kinds of action using Cache- + Control request directives: + + End-to-end reload + The request includes a "no-cache" cache-control directive or, for + compatibility with HTTP/1.0 clients, "Pragma: no-cache". Field + names MUST NOT be included with the no-cache directive in a + request. The server MUST NOT use a cached copy when responding to + such a request. + + Specific end-to-end revalidation + The request includes a "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request includes a cache-validating conditional with + the client's current validator. + + Unspecified end-to-end revalidation + The request includes "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request does not include a cache-validating + + + + +Fielding, et al. Standards Track [Page 113] + +RFC 2616 HTTP/1.1 June 1999 + + + conditional; the first cache along the path (if any) that holds a + cache entry for this resource includes a cache-validating + conditional with its current validator. + + max-age + When an intermediate cache is forced, by means of a max-age=0 + directive, to revalidate its own cache entry, and the client has + supplied its own validator in the request, the supplied validator + might differ from the validator currently stored with the cache + entry. In this case, the cache MAY use either validator in making + its own request without affecting semantic transparency. + + However, the choice of validator might affect performance. The + best approach is for the intermediate cache to use its own + validator when making its request. If the server replies with 304 + (Not Modified), then the cache can return its now validated copy + to the client with a 200 (OK) response. If the server replies with + a new entity and cache validator, however, the intermediate cache + can compare the returned validator with the one provided in the + client's request, using the strong comparison function. If the + client's validator is equal to the origin server's, then the + intermediate cache simply returns 304 (Not Modified). Otherwise, + it returns the new entity with a 200 (OK) response. + + If a request includes the no-cache directive, it SHOULD NOT + include min-fresh, max-stale, or max-age. + + only-if-cached + In some cases, such as times of extremely poor network + connectivity, a client may want a cache to return only those + responses that it currently has stored, and not to reload or + revalidate with the origin server. To do this, the client may + include the only-if-cached directive in a request. If it receives + this directive, a cache SHOULD either respond using a cached entry + that is consistent with the other constraints of the request, or + respond with a 504 (Gateway Timeout) status. However, if a group + of caches is being operated as a unified system with good internal + connectivity, such a request MAY be forwarded within that group of + caches. + + must-revalidate + Because a cache MAY be configured to ignore a server's specified + expiration time, and because a client request MAY include a max- + stale directive (which has a similar effect), the protocol also + includes a mechanism for the origin server to require revalidation + of a cache entry on any subsequent use. When the must-revalidate + directive is present in a response received by a cache, that cache + MUST NOT use the entry after it becomes stale to respond to a + + + +Fielding, et al. Standards Track [Page 114] + +RFC 2616 HTTP/1.1 June 1999 + + + subsequent request without first revalidating it with the origin + server. (I.e., the cache MUST do an end-to-end revalidation every + time, if, based solely on the origin server's Expires or max-age + value, the cached response is stale.) + + The must-revalidate directive is necessary to support reliable + operation for certain protocol features. In all circumstances an + HTTP/1.1 cache MUST obey the must-revalidate directive; in + particular, if the cache cannot reach the origin server for any + reason, it MUST generate a 504 (Gateway Timeout) response. + + Servers SHOULD send the must-revalidate directive if and only if + failure to revalidate a request on the entity could result in + incorrect operation, such as a silently unexecuted financial + transaction. Recipients MUST NOT take any automated action that + violates this directive, and MUST NOT automatically provide an + unvalidated copy of the entity if revalidation fails. + + Although this is not recommended, user agents operating under + severe connectivity constraints MAY violate this directive but, if + so, MUST explicitly warn the user that an unvalidated response has + been provided. The warning MUST be provided on each unvalidated + access, and SHOULD require explicit user confirmation. + + proxy-revalidate + The proxy-revalidate directive has the same meaning as the must- + revalidate directive, except that it does not apply to non-shared + user agent caches. It can be used on a response to an + authenticated request to permit the user's cache to store and + later return the response without needing to revalidate it (since + it has already been authenticated once by that user), while still + requiring proxies that service many users to revalidate each time + (in order to make sure that each user has been authenticated). + Note that such authenticated responses also need the public cache + control directive in order to allow them to be cached at all. + +14.9.5 No-Transform Directive + + no-transform + Implementors of intermediate caches (proxies) have found it useful + to convert the media type of certain entity bodies. A non- + transparent proxy might, for example, convert between image + formats in order to save cache space or to reduce the amount of + traffic on a slow link. + + Serious operational problems occur, however, when these + transformations are applied to entity bodies intended for certain + kinds of applications. For example, applications for medical + + + +Fielding, et al. Standards Track [Page 115] + +RFC 2616 HTTP/1.1 June 1999 + + + imaging, scientific data analysis and those using end-to-end + authentication, all depend on receiving an entity body that is bit + for bit identical to the original entity-body. + + Therefore, if a message includes the no-transform directive, an + intermediate cache or proxy MUST NOT change those headers that are + listed in section 13.5.2 as being subject to the no-transform + directive. This implies that the cache or proxy MUST NOT change + any aspect of the entity-body that is specified by these headers, + including the value of the entity-body itself. + +14.9.6 Cache Control Extensions + + The Cache-Control header field can be extended through the use of one + or more cache-extension tokens, each with an optional assigned value. + Informational extensions (those which do not require a change in + cache behavior) MAY be added without changing the semantics of other + directives. Behavioral extensions are designed to work by acting as + modifiers to the existing base of cache directives. Both the new + directive and the standard directive are supplied, such that + applications which do not understand the new directive will default + to the behavior specified by the standard directive, and those that + understand the new directive will recognize it as modifying the + requirements associated with the standard directive. In this way, + extensions to the cache-control directives can be made without + requiring changes to the base protocol. + + This extension mechanism depends on an HTTP cache obeying all of the + cache-control directives defined for its native HTTP-version, obeying + certain extensions, and ignoring all directives that it does not + understand. + + For example, consider a hypothetical new response directive called + community which acts as a modifier to the private directive. We + define this new directive to mean that, in addition to any non-shared + cache, any cache which is shared only by members of the community + named within its value may cache the response. An origin server + wishing to allow the UCI community to use an otherwise private + response in their shared cache(s) could do so by including + + Cache-Control: private, community="UCI" + + A cache seeing this header field will act correctly even if the cache + does not understand the community cache-extension, since it will also + see and understand the private directive and thus default to the safe + behavior. + + + + + +Fielding, et al. Standards Track [Page 116] + +RFC 2616 HTTP/1.1 June 1999 + + + Unrecognized cache-directives MUST be ignored; it is assumed that any + cache-directive likely to be unrecognized by an HTTP/1.1 cache will + be combined with standard directives (or the response's default + cacheability) such that the cache behavior will remain minimally + correct even if the cache does not understand the extension(s). + +14.10 Connection + + The Connection general-header field allows the sender to specify + options that are desired for that particular connection and MUST NOT + be communicated by proxies over further connections. + + The Connection header has the following grammar: + + Connection = "Connection" ":" 1#(connection-token) + connection-token = token + + HTTP/1.1 proxies MUST parse the Connection header field before a + message is forwarded and, for each connection-token in this field, + remove any header field(s) from the message with the same name as the + connection-token. Connection options are signaled by the presence of + a connection-token in the Connection header field, not by any + corresponding additional header field(s), since the additional header + field may not be sent if there are no parameters associated with that + connection option. + + Message headers listed in the Connection header MUST NOT include + end-to-end headers, such as Cache-Control. + + HTTP/1.1 defines the "close" connection option for the sender to + signal that the connection will be closed after completion of the + response. For example, + + Connection: close + + in either the request or the response header fields indicates that + the connection SHOULD NOT be considered `persistent' (section 8.1) + after the current request/response is complete. + + HTTP/1.1 applications that do not support persistent connections MUST + include the "close" connection option in every message. + + A system receiving an HTTP/1.0 (or lower-version) message that + includes a Connection header MUST, for each connection-token in this + field, remove and ignore any header field(s) from the message with + the same name as the connection-token. This protects against mistaken + forwarding of such header fields by pre-HTTP/1.1 proxies. See section + 19.6.2. + + + +Fielding, et al. Standards Track [Page 117] + +RFC 2616 HTTP/1.1 June 1999 + + +14.11 Content-Encoding + + The Content-Encoding entity-header field is used as a modifier to the + media-type. When present, its value indicates what additional content + codings have been applied to the entity-body, and thus what decoding + mechanisms must be applied in order to obtain the media-type + referenced by the Content-Type header field. Content-Encoding is + primarily used to allow a document to be compressed without losing + the identity of its underlying media type. + + Content-Encoding = "Content-Encoding" ":" 1#content-coding + + Content codings are defined in section 3.5. An example of its use is + + Content-Encoding: gzip + + The content-coding is a characteristic of the entity identified by + the Request-URI. Typically, the entity-body is stored with this + encoding and is only decoded before rendering or analogous usage. + However, a non-transparent proxy MAY modify the content-coding if the + new coding is known to be acceptable to the recipient, unless the + "no-transform" cache-control directive is present in the message. + + If the content-coding of an entity is not "identity", then the + response MUST include a Content-Encoding entity-header (section + 14.11) that lists the non-identity content-coding(s) used. + + If the content-coding of an entity in a request message is not + acceptable to the origin server, the server SHOULD respond with a + status code of 415 (Unsupported Media Type). + + If multiple encodings have been applied to an entity, the content + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + +14.12 Content-Language + + The Content-Language entity-header field describes the natural + language(s) of the intended audience for the enclosed entity. Note + that this might not be equivalent to all the languages used within + the entity-body. + + Content-Language = "Content-Language" ":" 1#language-tag + + + + + + + +Fielding, et al. Standards Track [Page 118] + +RFC 2616 HTTP/1.1 June 1999 + + + Language tags are defined in section 3.10. The primary purpose of + Content-Language is to allow a user to identify and differentiate + entities according to the user's own preferred language. Thus, if the + body content is intended only for a Danish-literate audience, the + appropriate field is + + Content-Language: da + + If no Content-Language is specified, the default is that the content + is intended for all language audiences. This might mean that the + sender does not consider it to be specific to any natural language, + or that the sender does not know for which language it is intended. + + Multiple languages MAY be listed for content that is intended for + multiple audiences. For example, a rendition of the "Treaty of + Waitangi," presented simultaneously in the original Maori and English + versions, would call for + + Content-Language: mi, en + + However, just because multiple languages are present within an entity + does not mean that it is intended for multiple linguistic audiences. + An example would be a beginner's language primer, such as "A First + Lesson in Latin," which is clearly intended to be used by an + English-literate audience. In this case, the Content-Language would + properly only include "en". + + Content-Language MAY be applied to any media type -- it is not + limited to textual documents. + +14.13 Content-Length + + The Content-Length entity-header field indicates the size of the + entity-body, in decimal number of OCTETs, sent to the recipient or, + in the case of the HEAD method, the size of the entity-body that + would have been sent had the request been a GET. + + Content-Length = "Content-Length" ":" 1*DIGIT + + An example is + + Content-Length: 3495 + + Applications SHOULD use this field to indicate the transfer-length of + the message-body, unless this is prohibited by the rules in section + 4.4. + + + + + +Fielding, et al. Standards Track [Page 119] + +RFC 2616 HTTP/1.1 June 1999 + + + Any Content-Length greater than or equal to zero is a valid value. + Section 4.4 describes how to determine the length of a message-body + if a Content-Length is not given. + + Note that the meaning of this field is significantly different from + the corresponding definition in MIME, where it is an optional field + used within the "message/external-body" content-type. In HTTP, it + SHOULD be sent whenever the message's length can be determined prior + to being transferred, unless this is prohibited by the rules in + section 4.4. + +14.14 Content-Location + + The Content-Location entity-header field MAY be used to supply the + resource location for the entity enclosed in the message when that + entity is accessible from a location separate from the requested + resource's URI. A server SHOULD provide a Content-Location for the + variant corresponding to the response entity; especially in the case + where a resource has multiple entities associated with it, and those + entities actually have separate locations by which they might be + individually accessed, the server SHOULD provide a Content-Location + for the particular variant which is returned. + + Content-Location = "Content-Location" ":" + ( absoluteURI | relativeURI ) + + The value of Content-Location also defines the base URI for the + entity. + + The Content-Location value is not a replacement for the original + requested URI; it is only a statement of the location of the resource + corresponding to this particular entity at the time of the request. + Future requests MAY specify the Content-Location URI as the request- + URI if the desire is to identify the source of that particular + entity. + + A cache cannot assume that an entity with a Content-Location + different from the URI used to retrieve it can be used to respond to + later requests on that Content-Location URI. However, the Content- + Location can be used to differentiate between multiple entities + retrieved from a single requested resource, as described in section + 13.6. + + If the Content-Location is a relative URI, the relative URI is + interpreted relative to the Request-URI. + + The meaning of the Content-Location header in PUT or POST requests is + undefined; servers are free to ignore it in those cases. + + + +Fielding, et al. Standards Track [Page 120] + +RFC 2616 HTTP/1.1 June 1999 + + +14.15 Content-MD5 + + The Content-MD5 entity-header field, as defined in RFC 1864 [23], is + an MD5 digest of the entity-body for the purpose of providing an + end-to-end message integrity check (MIC) of the entity-body. (Note: a + MIC is good for detecting accidental modification of the entity-body + in transit, but is not proof against malicious attacks.) + + Content-MD5 = "Content-MD5" ":" md5-digest + md5-digest = + + The Content-MD5 header field MAY be generated by an origin server or + client to function as an integrity check of the entity-body. Only + origin servers or clients MAY generate the Content-MD5 header field; + proxies and gateways MUST NOT generate it, as this would defeat its + value as an end-to-end integrity check. Any recipient of the entity- + body, including gateways and proxies, MAY check that the digest value + in this header field matches that of the entity-body as received. + + The MD5 digest is computed based on the content of the entity-body, + including any content-coding that has been applied, but not including + any transfer-encoding applied to the message-body. If the message is + received with a transfer-encoding, that encoding MUST be removed + prior to checking the Content-MD5 value against the received entity. + + This has the result that the digest is computed on the octets of the + entity-body exactly as, and in the order that, they would be sent if + no transfer-encoding were being applied. + + HTTP extends RFC 1864 to permit the digest to be computed for MIME + composite media-types (e.g., multipart/* and message/rfc822), but + this does not change how the digest is computed as defined in the + preceding paragraph. + + There are several consequences of this. The entity-body for composite + types MAY contain many body-parts, each with its own MIME and HTTP + headers (including Content-MD5, Content-Transfer-Encoding, and + Content-Encoding headers). If a body-part has a Content-Transfer- + Encoding or Content-Encoding header, it is assumed that the content + of the body-part has had the encoding applied, and the body-part is + included in the Content-MD5 digest as is -- i.e., after the + application. The Transfer-Encoding header field is not allowed within + body-parts. + + Conversion of all line breaks to CRLF MUST NOT be done before + computing or checking the digest: the line break convention used in + the text actually transmitted MUST be left unaltered when computing + the digest. + + + +Fielding, et al. Standards Track [Page 121] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: while the definition of Content-MD5 is exactly the same for + HTTP as in RFC 1864 for MIME entity-bodies, there are several ways + in which the application of Content-MD5 to HTTP entity-bodies + differs from its application to MIME entity-bodies. One is that + HTTP, unlike MIME, does not use Content-Transfer-Encoding, and + does use Transfer-Encoding and Content-Encoding. Another is that + HTTP more frequently uses binary content types than MIME, so it is + worth noting that, in such cases, the byte order used to compute + the digest is the transmission byte order defined for the type. + Lastly, HTTP allows transmission of text types with any of several + line break conventions and not just the canonical form using CRLF. + +14.16 Content-Range + + The Content-Range entity-header is sent with a partial entity-body to + specify where in the full entity-body the partial body should be + applied. Range units are defined in section 3.12. + + Content-Range = "Content-Range" ":" content-range-spec + + content-range-spec = byte-content-range-spec + byte-content-range-spec = bytes-unit SP + byte-range-resp-spec "/" + ( instance-length | "*" ) + + byte-range-resp-spec = (first-byte-pos "-" last-byte-pos) + | "*" + instance-length = 1*DIGIT + + The header SHOULD indicate the total length of the full entity-body, + unless this length is unknown or difficult to determine. The asterisk + "*" character means that the instance-length is unknown at the time + when the response was generated. + + Unlike byte-ranges-specifier values (see section 14.35.1), a byte- + range-resp-spec MUST only specify one range, and MUST contain + absolute byte positions for both the first and last byte of the + range. + + A byte-content-range-spec with a byte-range-resp-spec whose last- + byte-pos value is less than its first-byte-pos value, or whose + instance-length value is less than or equal to its last-byte-pos + value, is invalid. The recipient of an invalid byte-content-range- + spec MUST ignore it and any content transferred along with it. + + A server sending a response with status code 416 (Requested range not + satisfiable) SHOULD include a Content-Range field with a byte-range- + resp-spec of "*". The instance-length specifies the current length of + + + +Fielding, et al. Standards Track [Page 122] + +RFC 2616 HTTP/1.1 June 1999 + + + the selected resource. A response with status code 206 (Partial + Content) MUST NOT include a Content-Range field with a byte-range- + resp-spec of "*". + + Examples of byte-content-range-spec values, assuming that the entity + contains a total of 1234 bytes: + + . The first 500 bytes: + bytes 0-499/1234 + + . The second 500 bytes: + bytes 500-999/1234 + + . All except for the first 500 bytes: + bytes 500-1233/1234 + + . The last 500 bytes: + bytes 734-1233/1234 + + When an HTTP message includes the content of a single range (for + example, a response to a request for a single range, or to a request + for a set of ranges that overlap without any holes), this content is + transmitted with a Content-Range header, and a Content-Length header + showing the number of bytes actually transferred. For example, + + HTTP/1.1 206 Partial content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-Range: bytes 21010-47021/47022 + Content-Length: 26012 + Content-Type: image/gif + + When an HTTP message includes the content of multiple ranges (for + example, a response to a request for multiple non-overlapping + ranges), these are transmitted as a multipart message. The multipart + media type used for this purpose is "multipart/byteranges" as defined + in appendix 19.2. See appendix 19.6.3 for a compatibility issue. + + A response to a request for a single range MUST NOT be sent using the + multipart/byteranges media type. A response to a request for + multiple ranges, whose result is a single range, MAY be sent as a + multipart/byteranges media type with one part. A client that cannot + decode a multipart/byteranges message MUST NOT ask for multiple + byte-ranges in a single request. + + When a client requests multiple byte-ranges in one request, the + server SHOULD return them in the order that they appeared in the + request. + + + +Fielding, et al. Standards Track [Page 123] + +RFC 2616 HTTP/1.1 June 1999 + + + If the server ignores a byte-range-spec because it is syntactically + invalid, the server SHOULD treat the request as if the invalid Range + header field did not exist. (Normally, this means return a 200 + response containing the full entity). + + If the server receives a request (other than one including an If- + Range request-header field) with an unsatisfiable Range request- + header field (that is, all of whose byte-range-spec values have a + first-byte-pos value greater than the current length of the selected + resource), it SHOULD return a response code of 416 (Requested range + not satisfiable) (section 10.4.17). + + Note: clients cannot depend on servers to send a 416 (Requested + range not satisfiable) response instead of a 200 (OK) response for + an unsatisfiable Range request-header, since not all servers + implement this request-header. + +14.17 Content-Type + + The Content-Type entity-header field indicates the media type of the + entity-body sent to the recipient or, in the case of the HEAD method, + the media type that would have been sent had the request been a GET. + + Content-Type = "Content-Type" ":" media-type + + Media types are defined in section 3.7. An example of the field is + + Content-Type: text/html; charset=ISO-8859-4 + + Further discussion of methods for identifying the media type of an + entity is provided in section 7.2.1. + +14.18 Date + + The Date general-header field represents the date and time at which + the message was originated, having the same semantics as orig-date in + RFC 822. The field value is an HTTP-date, as described in section + 3.3.1; it MUST be sent in RFC 1123 [8]-date format. + + Date = "Date" ":" HTTP-date + + An example is + + Date: Tue, 15 Nov 1994 08:12:31 GMT + + Origin servers MUST include a Date header field in all responses, + except in these cases: + + + + +Fielding, et al. Standards Track [Page 124] + +RFC 2616 HTTP/1.1 June 1999 + + + 1. If the response status code is 100 (Continue) or 101 (Switching + Protocols), the response MAY include a Date header field, at + the server's option. + + 2. If the response status code conveys a server error, e.g. 500 + (Internal Server Error) or 503 (Service Unavailable), and it is + inconvenient or impossible to generate a valid Date. + + 3. If the server does not have a clock that can provide a + reasonable approximation of the current time, its responses + MUST NOT include a Date header field. In this case, the rules + in section 14.18.1 MUST be followed. + + A received message that does not have a Date header field MUST be + assigned one by the recipient if the message will be cached by that + recipient or gatewayed via a protocol which requires a Date. An HTTP + implementation without a clock MUST NOT cache responses without + revalidating them on every use. An HTTP cache, especially a shared + cache, SHOULD use a mechanism, such as NTP [28], to synchronize its + clock with a reliable external standard. + + Clients SHOULD only send a Date header field in messages that include + an entity-body, as in the case of the PUT and POST requests, and even + then it is optional. A client without a clock MUST NOT send a Date + header field in a request. + + The HTTP-date sent in a Date header SHOULD NOT represent a date and + time subsequent to the generation of the message. It SHOULD represent + the best available approximation of the date and time of message + generation, unless the implementation has no means of generating a + reasonably accurate date and time. In theory, the date ought to + represent the moment just before the entity is generated. In + practice, the date can be generated at any time during the message + origination without affecting its semantic value. + +14.18.1 Clockless Origin Server Operation + + Some origin server implementations might not have a clock available. + An origin server without a clock MUST NOT assign Expires or Last- + Modified values to a response, unless these values were associated + with the resource by a system or user with a reliable clock. It MAY + assign an Expires value that is known, at or before server + configuration time, to be in the past (this allows "pre-expiration" + of responses without storing separate Expires values for each + resource). + + + + + + +Fielding, et al. Standards Track [Page 125] + +RFC 2616 HTTP/1.1 June 1999 + + +14.19 ETag + + The ETag response-header field provides the current value of the + entity tag for the requested variant. The headers used with entity + tags are described in sections 14.24, 14.26 and 14.44. The entity tag + MAY be used for comparison with other entities from the same resource + (see section 13.3.3). + + ETag = "ETag" ":" entity-tag + + Examples: + + ETag: "xyzzy" + ETag: W/"xyzzy" + ETag: "" + +14.20 Expect + + The Expect request-header field is used to indicate that particular + server behaviors are required by the client. + + Expect = "Expect" ":" 1#expectation + + expectation = "100-continue" | expectation-extension + expectation-extension = token [ "=" ( token | quoted-string ) + *expect-params ] + expect-params = ";" token [ "=" ( token | quoted-string ) ] + + + A server that does not understand or is unable to comply with any of + the expectation values in the Expect field of a request MUST respond + with appropriate error status. The server MUST respond with a 417 + (Expectation Failed) status if any of the expectations cannot be met + or, if there are other problems with the request, some other 4xx + status. + + This header field is defined with extensible syntax to allow for + future extensions. If a server receives a request containing an + Expect field that includes an expectation-extension that it does not + support, it MUST respond with a 417 (Expectation Failed) status. + + Comparison of expectation values is case-insensitive for unquoted + tokens (including the 100-continue token), and is case-sensitive for + quoted-string expectation-extensions. + + + + + + + +Fielding, et al. Standards Track [Page 126] + +RFC 2616 HTTP/1.1 June 1999 + + + The Expect mechanism is hop-by-hop: that is, an HTTP/1.1 proxy MUST + return a 417 (Expectation Failed) status if it receives a request + with an expectation that it cannot meet. However, the Expect + request-header itself is end-to-end; it MUST be forwarded if the + request is forwarded. + + Many older HTTP/1.0 and HTTP/1.1 applications do not understand the + Expect header. + + See section 8.2.3 for the use of the 100 (continue) status. + +14.21 Expires + + The Expires entity-header field gives the date/time after which the + response is considered stale. A stale cache entry may not normally be + returned by a cache (either a proxy cache or a user agent cache) + unless it is first validated with the origin server (or with an + intermediate cache that has a fresh copy of the entity). See section + 13.2 for further discussion of the expiration model. + + The presence of an Expires field does not imply that the original + resource will change or cease to exist at, before, or after that + time. + + The format is an absolute date and time as defined by HTTP-date in + section 3.3.1; it MUST be in RFC 1123 date format: + + Expires = "Expires" ":" HTTP-date + + An example of its use is + + Expires: Thu, 01 Dec 1994 16:00:00 GMT + + Note: if a response includes a Cache-Control field with the max- + age directive (see section 14.9.3), that directive overrides the + Expires field. + + HTTP/1.1 clients and caches MUST treat other invalid date formats, + especially including the value "0", as in the past (i.e., "already + expired"). + + To mark a response as "already expired," an origin server sends an + Expires date that is equal to the Date header value. (See the rules + for expiration calculations in section 13.2.4.) + + + + + + + +Fielding, et al. Standards Track [Page 127] + +RFC 2616 HTTP/1.1 June 1999 + + + To mark a response as "never expires," an origin server sends an + Expires date approximately one year from the time the response is + sent. HTTP/1.1 servers SHOULD NOT send Expires dates more than one + year in the future. + + The presence of an Expires header field with a date value of some + time in the future on a response that otherwise would by default be + non-cacheable indicates that the response is cacheable, unless + indicated otherwise by a Cache-Control header field (section 14.9). + +14.22 From + + The From request-header field, if given, SHOULD contain an Internet + e-mail address for the human user who controls the requesting user + agent. The address SHOULD be machine-usable, as defined by "mailbox" + in RFC 822 [9] as updated by RFC 1123 [8]: + + From = "From" ":" mailbox + + An example is: + + From: webmaster@w3.org + + This header field MAY be used for logging purposes and as a means for + identifying the source of invalid or unwanted requests. It SHOULD NOT + be used as an insecure form of access protection. The interpretation + of this field is that the request is being performed on behalf of the + person given, who accepts responsibility for the method performed. In + particular, robot agents SHOULD include this header so that the + person responsible for running the robot can be contacted if problems + occur on the receiving end. + + The Internet e-mail address in this field MAY be separate from the + Internet host which issued the request. For example, when a request + is passed through a proxy the original issuer's address SHOULD be + used. + + The client SHOULD NOT send the From header field without the user's + approval, as it might conflict with the user's privacy interests or + their site's security policy. It is strongly recommended that the + user be able to disable, enable, and modify the value of this field + at any time prior to a request. + +14.23 Host + + The Host request-header field specifies the Internet host and port + number of the resource being requested, as obtained from the original + URI given by the user or referring resource (generally an HTTP URL, + + + +Fielding, et al. Standards Track [Page 128] + +RFC 2616 HTTP/1.1 June 1999 + + + as described in section 3.2.2). The Host field value MUST represent + the naming authority of the origin server or gateway given by the + original URL. This allows the origin server or gateway to + differentiate between internally-ambiguous URLs, such as the root "/" + URL of a server for multiple host names on a single IP address. + + Host = "Host" ":" host [ ":" port ] ; Section 3.2.2 + + A "host" without any trailing port information implies the default + port for the service requested (e.g., "80" for an HTTP URL). For + example, a request on the origin server for + would properly include: + + GET /pub/WWW/ HTTP/1.1 + Host: www.w3.org + + A client MUST include a Host header field in all HTTP/1.1 request + messages . If the requested URI does not include an Internet host + name for the service being requested, then the Host header field MUST + be given with an empty value. An HTTP/1.1 proxy MUST ensure that any + request message it forwards does contain an appropriate Host header + field that identifies the service being requested by the proxy. All + Internet-based HTTP/1.1 servers MUST respond with a 400 (Bad Request) + status code to any HTTP/1.1 request message which lacks a Host header + field. + + See sections 5.2 and 19.6.1.1 for other requirements relating to + Host. + +14.24 If-Match + + The If-Match request-header field is used with a method to make it + conditional. A client that has one or more entities previously + obtained from the resource can verify that one of those entities is + current by including a list of their associated entity tags in the + If-Match header field. Entity tags are defined in section 3.11. The + purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. It is also + used, on updating requests, to prevent inadvertent modification of + the wrong version of a resource. As a special case, the value "*" + matches any current entity of the resource. + + If-Match = "If-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-Match header) on that resource, or if "*" is given + + + + +Fielding, et al. Standards Track [Page 129] + +RFC 2616 HTTP/1.1 June 1999 + + + and any current entity exists for that resource, then the server MAY + perform the requested method as if the If-Match header field did not + exist. + + A server MUST use the strong comparison function (see section 13.3.3) + to compare the entity tags in If-Match. + + If none of the entity tags match, or if "*" is given and no current + entity exists, the server MUST NOT perform the requested method, and + MUST return a 412 (Precondition Failed) response. This behavior is + most useful when the client wants to prevent an updating method, such + as PUT, from modifying a resource that has changed since the client + last retrieved it. + + If the request would, without the If-Match header field, result in + anything other than a 2xx or 412 status, then the If-Match header + MUST be ignored. + + The meaning of "If-Match: *" is that the method SHOULD be performed + if the representation selected by the origin server (or by a cache, + possibly using the Vary mechanism, see section 14.44) exists, and + MUST NOT be performed if the representation does not exist. + + A request intended to update a resource (e.g., a PUT) MAY include an + If-Match header field to signal that the request method MUST NOT be + applied if the entity corresponding to the If-Match value (a single + entity tag) is no longer a representation of that resource. This + allows the user to indicate that they do not wish the request to be + successful if the resource has been changed without their knowledge. + Examples: + + If-Match: "xyzzy" + If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-Match: * + + The result of a request having both an If-Match header field and + either an If-None-Match or an If-Modified-Since header fields is + undefined by this specification. + +14.25 If-Modified-Since + + The If-Modified-Since request-header field is used with a method to + make it conditional: if the requested variant has not been modified + since the time specified in this field, an entity will not be + returned from the server; instead, a 304 (not modified) response will + be returned without any message-body. + + If-Modified-Since = "If-Modified-Since" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 130] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of the field is: + + If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + A GET method with an If-Modified-Since header and no Range header + requests that the identified entity be transferred only if it has + been modified since the date given by the If-Modified-Since header. + The algorithm for determining this includes the following cases: + + a) If the request would normally result in anything other than a + 200 (OK) status, or if the passed If-Modified-Since date is + invalid, the response is exactly the same as for a normal GET. + A date which is later than the server's current time is + invalid. + + b) If the variant has been modified since the If-Modified-Since + date, the response is exactly the same as for a normal GET. + + c) If the variant has not been modified since a valid If- + Modified-Since date, the server SHOULD return a 304 (Not + Modified) response. + + The purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. + + Note: The Range request-header field modifies the meaning of If- + Modified-Since; see section 14.35 for full details. + + Note: If-Modified-Since times are interpreted by the server, whose + clock might not be synchronized with the client. + + Note: When handling an If-Modified-Since header field, some + servers will use an exact date comparison function, rather than a + less-than function, for deciding whether to send a 304 (Not + Modified) response. To get best results when sending an If- + Modified-Since header field for cache validation, clients are + advised to use the exact date string received in a previous Last- + Modified header field whenever possible. + + Note: If a client uses an arbitrary date in the If-Modified-Since + header instead of a date taken from the Last-Modified header for + the same request, the client should be aware of the fact that this + date is interpreted in the server's understanding of time. The + client should consider unsynchronized clocks and rounding problems + due to the different encodings of time between the client and + server. This includes the possibility of race conditions if the + document has changed between the time it was first requested and + the If-Modified-Since date of a subsequent request, and the + + + +Fielding, et al. Standards Track [Page 131] + +RFC 2616 HTTP/1.1 June 1999 + + + possibility of clock-skew-related problems if the If-Modified- + Since date is derived from the client's clock without correction + to the server's clock. Corrections for different time bases + between client and server are at best approximate due to network + latency. + + The result of a request having both an If-Modified-Since header field + and either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.26 If-None-Match + + The If-None-Match request-header field is used with a method to make + it conditional. A client that has one or more entities previously + obtained from the resource can verify that none of those entities is + current by including a list of their associated entity tags in the + If-None-Match header field. The purpose of this feature is to allow + efficient updates of cached information with a minimum amount of + transaction overhead. It is also used to prevent a method (e.g. PUT) + from inadvertently modifying an existing resource when the client + believes that the resource does not exist. + + As a special case, the value "*" matches any current entity of the + resource. + + If-None-Match = "If-None-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-None-Match header) on that resource, or if "*" is + given and any current entity exists for that resource, then the + server MUST NOT perform the requested method, unless required to do + so because the resource's modification date fails to match that + supplied in an If-Modified-Since header field in the request. + Instead, if the request method was GET or HEAD, the server SHOULD + respond with a 304 (Not Modified) response, including the cache- + related header fields (particularly ETag) of one of the entities that + matched. For all other request methods, the server MUST respond with + a status of 412 (Precondition Failed). + + See section 13.3.3 for rules on how to determine if two entities tags + match. The weak comparison function can only be used with GET or HEAD + requests. + + + + + + + + +Fielding, et al. Standards Track [Page 132] + +RFC 2616 HTTP/1.1 June 1999 + + + If none of the entity tags match, then the server MAY perform the + requested method as if the If-None-Match header field did not exist, + but MUST also ignore any If-Modified-Since header field(s) in the + request. That is, if no entity tags match, then the server MUST NOT + return a 304 (Not Modified) response. + + If the request would, without the If-None-Match header field, result + in anything other than a 2xx or 304 status, then the If-None-Match + header MUST be ignored. (See section 13.3.4 for a discussion of + server behavior when both If-Modified-Since and If-None-Match appear + in the same request.) + + The meaning of "If-None-Match: *" is that the method MUST NOT be + performed if the representation selected by the origin server (or by + a cache, possibly using the Vary mechanism, see section 14.44) + exists, and SHOULD be performed if the representation does not exist. + This feature is intended to be useful in preventing races between PUT + operations. + + Examples: + + If-None-Match: "xyzzy" + If-None-Match: W/"xyzzy" + If-None-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-None-Match: W/"xyzzy", W/"r2d2xxxx", W/"c3piozzzz" + If-None-Match: * + + The result of a request having both an If-None-Match header field and + either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.27 If-Range + + If a client has a partial copy of an entity in its cache, and wishes + to have an up-to-date copy of the entire entity in its cache, it + could use the Range request-header with a conditional GET (using + either or both of If-Unmodified-Since and If-Match.) However, if the + condition fails because the entity has been modified, the client + would then have to make a second request to obtain the entire current + entity-body. + + The If-Range header allows a client to "short-circuit" the second + request. Informally, its meaning is `if the entity is unchanged, send + me the part(s) that I am missing; otherwise, send me the entire new + entity'. + + If-Range = "If-Range" ":" ( entity-tag | HTTP-date ) + + + + +Fielding, et al. Standards Track [Page 133] + +RFC 2616 HTTP/1.1 June 1999 + + + If the client has no entity tag for an entity, but does have a Last- + Modified date, it MAY use that date in an If-Range header. (The + server can distinguish between a valid HTTP-date and any form of + entity-tag by examining no more than two characters.) The If-Range + header SHOULD only be used together with a Range header, and MUST be + ignored if the request does not include a Range header, or if the + server does not support the sub-range operation. + + If the entity tag given in the If-Range header matches the current + entity tag for the entity, then the server SHOULD provide the + specified sub-range of the entity using a 206 (Partial content) + response. If the entity tag does not match, then the server SHOULD + return the entire entity using a 200 (OK) response. + +14.28 If-Unmodified-Since + + The If-Unmodified-Since request-header field is used with a method to + make it conditional. If the requested resource has not been modified + since the time specified in this field, the server SHOULD perform the + requested operation as if the If-Unmodified-Since header were not + present. + + If the requested variant has been modified since the specified time, + the server MUST NOT perform the requested operation, and MUST return + a 412 (Precondition Failed). + + If-Unmodified-Since = "If-Unmodified-Since" ":" HTTP-date + + An example of the field is: + + If-Unmodified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + If the request normally (i.e., without the If-Unmodified-Since + header) would result in anything other than a 2xx or 412 status, the + If-Unmodified-Since header SHOULD be ignored. + + If the specified date is invalid, the header is ignored. + + The result of a request having both an If-Unmodified-Since header + field and either an If-None-Match or an If-Modified-Since header + fields is undefined by this specification. + +14.29 Last-Modified + + The Last-Modified entity-header field indicates the date and time at + which the origin server believes the variant was last modified. + + Last-Modified = "Last-Modified" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 134] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of its use is + + Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT + + The exact meaning of this header field depends on the implementation + of the origin server and the nature of the original resource. For + files, it may be just the file system last-modified time. For + entities with dynamically included parts, it may be the most recent + of the set of last-modify times for its component parts. For database + gateways, it may be the last-update time stamp of the record. For + virtual objects, it may be the last time the internal state changed. + + An origin server MUST NOT send a Last-Modified date which is later + than the server's time of message origination. In such cases, where + the resource's last modification would indicate some time in the + future, the server MUST replace that date with the message + origination date. + + An origin server SHOULD obtain the Last-Modified value of the entity + as close as possible to the time that it generates the Date value of + its response. This allows a recipient to make an accurate assessment + of the entity's modification time, especially if the entity changes + near the time that the response is generated. + + HTTP/1.1 servers SHOULD send Last-Modified whenever feasible. + +14.30 Location + + The Location response-header field is used to redirect the recipient + to a location other than the Request-URI for completion of the + request or identification of a new resource. For 201 (Created) + responses, the Location is that of the new resource which was created + by the request. For 3xx responses, the location SHOULD indicate the + server's preferred URI for automatic redirection to the resource. The + field value consists of a single absolute URI. + + Location = "Location" ":" absoluteURI + + An example is: + + Location: http://www.w3.org/pub/WWW/People.html + + Note: The Content-Location header field (section 14.14) differs + from Location in that the Content-Location identifies the original + location of the entity enclosed in the request. It is therefore + possible for a response to contain header fields for both Location + and Content-Location. Also see section 13.10 for cache + requirements of some methods. + + + +Fielding, et al. Standards Track [Page 135] + +RFC 2616 HTTP/1.1 June 1999 + + +14.31 Max-Forwards + + The Max-Forwards request-header field provides a mechanism with the + TRACE (section 9.8) and OPTIONS (section 9.2) methods to limit the + number of proxies or gateways that can forward the request to the + next inbound server. This can be useful when the client is attempting + to trace a request chain which appears to be failing or looping in + mid-chain. + + Max-Forwards = "Max-Forwards" ":" 1*DIGIT + + The Max-Forwards value is a decimal integer indicating the remaining + number of times this request message may be forwarded. + + Each proxy or gateway recipient of a TRACE or OPTIONS request + containing a Max-Forwards header field MUST check and update its + value prior to forwarding the request. If the received value is zero + (0), the recipient MUST NOT forward the request; instead, it MUST + respond as the final recipient. If the received Max-Forwards value is + greater than zero, then the forwarded message MUST contain an updated + Max-Forwards field with a value decremented by one (1). + + The Max-Forwards header field MAY be ignored for all other methods + defined by this specification and for any extension methods for which + it is not explicitly referred to as part of that method definition. + +14.32 Pragma + + The Pragma general-header field is used to include implementation- + specific directives that might apply to any recipient along the + request/response chain. All pragma directives specify optional + behavior from the viewpoint of the protocol; however, some systems + MAY require that behavior be consistent with the directives. + + Pragma = "Pragma" ":" 1#pragma-directive + pragma-directive = "no-cache" | extension-pragma + extension-pragma = token [ "=" ( token | quoted-string ) ] + + When the no-cache directive is present in a request message, an + application SHOULD forward the request toward the origin server even + if it has a cached copy of what is being requested. This pragma + directive has the same semantics as the no-cache cache-directive (see + section 14.9) and is defined here for backward compatibility with + HTTP/1.0. Clients SHOULD include both header fields when a no-cache + request is sent to a server not known to be HTTP/1.1 compliant. + + + + + + +Fielding, et al. Standards Track [Page 136] + +RFC 2616 HTTP/1.1 June 1999 + + + Pragma directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a pragma for a + specific recipient; however, any pragma directive not relevant to a + recipient SHOULD be ignored by that recipient. + + HTTP/1.1 caches SHOULD treat "Pragma: no-cache" as if the client had + sent "Cache-Control: no-cache". No new Pragma directives will be + defined in HTTP. + + Note: because the meaning of "Pragma: no-cache as a response + header field is not actually specified, it does not provide a + reliable replacement for "Cache-Control: no-cache" in a response + +14.33 Proxy-Authenticate + + The Proxy-Authenticate response-header field MUST be included as part + of a 407 (Proxy Authentication Required) response. The field value + consists of a challenge that indicates the authentication scheme and + parameters applicable to the proxy for this Request-URI. + + Proxy-Authenticate = "Proxy-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. Unlike + WWW-Authenticate, the Proxy-Authenticate header field applies only to + the current connection and SHOULD NOT be passed on to downstream + clients. However, an intermediate proxy might need to obtain its own + credentials by requesting them from the downstream client, which in + some circumstances will appear as if the proxy is forwarding the + Proxy-Authenticate header field. + +14.34 Proxy-Authorization + + The Proxy-Authorization request-header field allows the client to + identify itself (or its user) to a proxy which requires + authentication. The Proxy-Authorization field value consists of + credentials containing the authentication information of the user + agent for the proxy and/or realm of the resource being requested. + + Proxy-Authorization = "Proxy-Authorization" ":" credentials + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43] . Unlike + Authorization, the Proxy-Authorization header field applies only to + the next outbound proxy that demanded authentication using the Proxy- + Authenticate field. When multiple proxies are used in a chain, the + + + +Fielding, et al. Standards Track [Page 137] + +RFC 2616 HTTP/1.1 June 1999 + + + Proxy-Authorization header field is consumed by the first outbound + proxy that was expecting to receive credentials. A proxy MAY relay + the credentials from the client request to the next proxy if that is + the mechanism by which the proxies cooperatively authenticate a given + request. + +14.35 Range + +14.35.1 Byte Ranges + + Since all HTTP entities are represented in HTTP messages as sequences + of bytes, the concept of a byte range is meaningful for any HTTP + entity. (However, not all clients and servers need to support byte- + range operations.) + + Byte range specifications in HTTP apply to the sequence of bytes in + the entity-body (not necessarily the same as the message-body). + + A byte range operation MAY specify a single range of bytes, or a set + of ranges within a single entity. + + ranges-specifier = byte-ranges-specifier + byte-ranges-specifier = bytes-unit "=" byte-range-set + byte-range-set = 1#( byte-range-spec | suffix-byte-range-spec ) + byte-range-spec = first-byte-pos "-" [last-byte-pos] + first-byte-pos = 1*DIGIT + last-byte-pos = 1*DIGIT + + The first-byte-pos value in a byte-range-spec gives the byte-offset + of the first byte in a range. The last-byte-pos value gives the + byte-offset of the last byte in the range; that is, the byte + positions specified are inclusive. Byte offsets start at zero. + + If the last-byte-pos value is present, it MUST be greater than or + equal to the first-byte-pos in that byte-range-spec, or the byte- + range-spec is syntactically invalid. The recipient of a byte-range- + set that includes one or more syntactically invalid byte-range-spec + values MUST ignore the header field that includes that byte-range- + set. + + If the last-byte-pos value is absent, or if the value is greater than + or equal to the current length of the entity-body, last-byte-pos is + taken to be equal to one less than the current length of the entity- + body in bytes. + + By its choice of last-byte-pos, a client can limit the number of + bytes retrieved without knowing the size of the entity. + + + + +Fielding, et al. Standards Track [Page 138] + +RFC 2616 HTTP/1.1 June 1999 + + + suffix-byte-range-spec = "-" suffix-length + suffix-length = 1*DIGIT + + A suffix-byte-range-spec is used to specify the suffix of the + entity-body, of a length given by the suffix-length value. (That is, + this form specifies the last N bytes of an entity-body.) If the + entity is shorter than the specified suffix-length, the entire + entity-body is used. + + If a syntactically valid byte-range-set includes at least one byte- + range-spec whose first-byte-pos is less than the current length of + the entity-body, or at least one suffix-byte-range-spec with a non- + zero suffix-length, then the byte-range-set is satisfiable. + Otherwise, the byte-range-set is unsatisfiable. If the byte-range-set + is unsatisfiable, the server SHOULD return a response with a status + of 416 (Requested range not satisfiable). Otherwise, the server + SHOULD return a response with a status of 206 (Partial Content) + containing the satisfiable ranges of the entity-body. + + Examples of byte-ranges-specifier values (assuming an entity-body of + length 10000): + + - The first 500 bytes (byte offsets 0-499, inclusive): bytes=0- + 499 + + - The second 500 bytes (byte offsets 500-999, inclusive): + bytes=500-999 + + - The final 500 bytes (byte offsets 9500-9999, inclusive): + bytes=-500 + + - Or bytes=9500- + + - The first and last bytes only (bytes 0 and 9999): bytes=0-0,-1 + + - Several legal but not canonical specifications of the second 500 + bytes (byte offsets 500-999, inclusive): + bytes=500-600,601-999 + bytes=500-700,601-999 + +14.35.2 Range Retrieval Requests + + HTTP retrieval requests using conditional or unconditional GET + methods MAY request one or more sub-ranges of the entity, instead of + the entire entity, using the Range request header, which applies to + the entity returned as the result of the request: + + Range = "Range" ":" ranges-specifier + + + +Fielding, et al. Standards Track [Page 139] + +RFC 2616 HTTP/1.1 June 1999 + + + A server MAY ignore the Range header. However, HTTP/1.1 origin + servers and intermediate caches ought to support byte ranges when + possible, since Range supports efficient recovery from partially + failed transfers, and supports efficient partial retrieval of large + entities. + + If the server supports the Range header and the specified range or + ranges are appropriate for the entity: + + - The presence of a Range header in an unconditional GET modifies + what is returned if the GET is otherwise successful. In other + words, the response carries a status code of 206 (Partial + Content) instead of 200 (OK). + + - The presence of a Range header in a conditional GET (a request + using one or both of If-Modified-Since and If-None-Match, or + one or both of If-Unmodified-Since and If-Match) modifies what + is returned if the GET is otherwise successful and the + condition is true. It does not affect the 304 (Not Modified) + response returned if the conditional is false. + + In some cases, it might be more appropriate to use the If-Range + header (see section 14.27) in addition to the Range header. + + If a proxy that supports ranges receives a Range request, forwards + the request to an inbound server, and receives an entire entity in + reply, it SHOULD only return the requested range to its client. It + SHOULD store the entire received response in its cache if that is + consistent with its cache allocation policies. + +14.36 Referer + + The Referer[sic] request-header field allows the client to specify, + for the server's benefit, the address (URI) of the resource from + which the Request-URI was obtained (the "referrer", although the + header field is misspelled.) The Referer request-header allows a + server to generate lists of back-links to resources for interest, + logging, optimized caching, etc. It also allows obsolete or mistyped + links to be traced for maintenance. The Referer field MUST NOT be + sent if the Request-URI was obtained from a source that does not have + its own URI, such as input from the user keyboard. + + Referer = "Referer" ":" ( absoluteURI | relativeURI ) + + Example: + + Referer: http://www.w3.org/hypertext/DataSources/Overview.html + + + + +Fielding, et al. Standards Track [Page 140] + +RFC 2616 HTTP/1.1 June 1999 + + + If the field value is a relative URI, it SHOULD be interpreted + relative to the Request-URI. The URI MUST NOT include a fragment. See + section 15.1.3 for security considerations. + +14.37 Retry-After + + The Retry-After response-header field can be used with a 503 (Service + Unavailable) response to indicate how long the service is expected to + be unavailable to the requesting client. This field MAY also be used + with any 3xx (Redirection) response to indicate the minimum time the + user-agent is asked wait before issuing the redirected request. The + value of this field can be either an HTTP-date or an integer number + of seconds (in decimal) after the time of the response. + + Retry-After = "Retry-After" ":" ( HTTP-date | delta-seconds ) + + Two examples of its use are + + Retry-After: Fri, 31 Dec 1999 23:59:59 GMT + Retry-After: 120 + + In the latter example, the delay is 2 minutes. + +14.38 Server + + The Server response-header field contains information about the + software used by the origin server to handle the request. The field + can contain multiple product tokens (section 3.8) and comments + identifying the server and any significant subproducts. The product + tokens are listed in order of their significance for identifying the + application. + + Server = "Server" ":" 1*( product | comment ) + + Example: + + Server: CERN/3.0 libwww/2.17 + + If the response is being forwarded through a proxy, the proxy + application MUST NOT modify the Server response-header. Instead, it + SHOULD include a Via field (as described in section 14.45). + + Note: Revealing the specific software version of the server might + allow the server machine to become more vulnerable to attacks + against software that is known to contain security holes. Server + implementors are encouraged to make this field a configurable + option. + + + + +Fielding, et al. Standards Track [Page 141] + +RFC 2616 HTTP/1.1 June 1999 + + +14.39 TE + + The TE request-header field indicates what extension transfer-codings + it is willing to accept in the response and whether or not it is + willing to accept trailer fields in a chunked transfer-coding. Its + value may consist of the keyword "trailers" and/or a comma-separated + list of extension transfer-coding names with optional accept + parameters (as described in section 3.6). + + TE = "TE" ":" #( t-codings ) + t-codings = "trailers" | ( transfer-extension [ accept-params ] ) + + The presence of the keyword "trailers" indicates that the client is + willing to accept trailer fields in a chunked transfer-coding, as + defined in section 3.6.1. This keyword is reserved for use with + transfer-coding values even though it does not itself represent a + transfer-coding. + + Examples of its use are: + + TE: deflate + TE: + TE: trailers, deflate;q=0.5 + + The TE header field only applies to the immediate connection. + Therefore, the keyword MUST be supplied within a Connection header + field (section 14.10) whenever TE is present in an HTTP/1.1 message. + + A server tests whether a transfer-coding is acceptable, according to + a TE field, using these rules: + + 1. The "chunked" transfer-coding is always acceptable. If the + keyword "trailers" is listed, the client indicates that it is + willing to accept trailer fields in the chunked response on + behalf of itself and any downstream clients. The implication is + that, if given, the client is stating that either all + downstream clients are willing to accept trailer fields in the + forwarded response, or that it will attempt to buffer the + response on behalf of downstream recipients. + + Note: HTTP/1.1 does not define any means to limit the size of a + chunked response such that a client can be assured of buffering + the entire response. + + 2. If the transfer-coding being tested is one of the transfer- + codings listed in the TE field, then it is acceptable unless it + is accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + + +Fielding, et al. Standards Track [Page 142] + +RFC 2616 HTTP/1.1 June 1999 + + + 3. If multiple transfer-codings are acceptable, then the + acceptable transfer-coding with the highest non-zero qvalue is + preferred. The "chunked" transfer-coding always has a qvalue + of 1. + + If the TE field-value is empty or if no TE field is present, the only + transfer-coding is "chunked". A message with no transfer-coding is + always acceptable. + +14.40 Trailer + + The Trailer general field value indicates that the given set of + header fields is present in the trailer of a message encoded with + chunked transfer-coding. + + Trailer = "Trailer" ":" 1#field-name + + An HTTP/1.1 message SHOULD include a Trailer header field in a + message using chunked transfer-coding with a non-empty trailer. Doing + so allows the recipient to know which header fields to expect in the + trailer. + + If no Trailer header field is present, the trailer SHOULD NOT include + any header fields. See section 3.6.1 for restrictions on the use of + trailer fields in a "chunked" transfer-coding. + + Message header fields listed in the Trailer header field MUST NOT + include the following header fields: + + . Transfer-Encoding + + . Content-Length + + . Trailer + +14.41 Transfer-Encoding + + The Transfer-Encoding general-header field indicates what (if any) + type of transformation has been applied to the message body in order + to safely transfer it between the sender and the recipient. This + differs from the content-coding in that the transfer-coding is a + property of the message, not of the entity. + + Transfer-Encoding = "Transfer-Encoding" ":" 1#transfer-coding + + Transfer-codings are defined in section 3.6. An example is: + + Transfer-Encoding: chunked + + + +Fielding, et al. Standards Track [Page 143] + +RFC 2616 HTTP/1.1 June 1999 + + + If multiple encodings have been applied to an entity, the transfer- + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + + Many older HTTP/1.0 applications do not understand the Transfer- + Encoding header. + +14.42 Upgrade + + The Upgrade general-header allows the client to specify what + additional communication protocols it supports and would like to use + if the server finds it appropriate to switch protocols. The server + MUST use the Upgrade header field within a 101 (Switching Protocols) + response to indicate which protocol(s) are being switched. + + Upgrade = "Upgrade" ":" 1#product + + For example, + + Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11 + + The Upgrade header field is intended to provide a simple mechanism + for transition from HTTP/1.1 to some other, incompatible protocol. It + does so by allowing the client to advertise its desire to use another + protocol, such as a later version of HTTP with a higher major version + number, even though the current request has been made using HTTP/1.1. + This eases the difficult transition between incompatible protocols by + allowing the client to initiate a request in the more commonly + supported protocol while indicating to the server that it would like + to use a "better" protocol if available (where "better" is determined + by the server, possibly according to the nature of the method and/or + resource being requested). + + The Upgrade header field only applies to switching application-layer + protocols upon the existing transport-layer connection. Upgrade + cannot be used to insist on a protocol change; its acceptance and use + by the server is optional. The capabilities and nature of the + application-layer communication after the protocol change is entirely + dependent upon the new protocol chosen, although the first action + after changing the protocol MUST be a response to the initial HTTP + request containing the Upgrade header field. + + The Upgrade header field only applies to the immediate connection. + Therefore, the upgrade keyword MUST be supplied within a Connection + header field (section 14.10) whenever Upgrade is present in an + HTTP/1.1 message. + + + + +Fielding, et al. Standards Track [Page 144] + +RFC 2616 HTTP/1.1 June 1999 + + + The Upgrade header field cannot be used to indicate a switch to a + protocol on a different connection. For that purpose, it is more + appropriate to use a 301, 302, 303, or 305 redirection response. + + This specification only defines the protocol name "HTTP" for use by + the family of Hypertext Transfer Protocols, as defined by the HTTP + version rules of section 3.1 and future updates to this + specification. Any token can be used as a protocol name; however, it + will only be useful if both the client and server associate the name + with the same protocol. + +14.43 User-Agent + + The User-Agent request-header field contains information about the + user agent originating the request. This is for statistical purposes, + the tracing of protocol violations, and automated recognition of user + agents for the sake of tailoring responses to avoid particular user + agent limitations. User agents SHOULD include this field with + requests. The field can contain multiple product tokens (section 3.8) + and comments identifying the agent and any subproducts which form a + significant part of the user agent. By convention, the product tokens + are listed in order of their significance for identifying the + application. + + User-Agent = "User-Agent" ":" 1*( product | comment ) + + Example: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + +14.44 Vary + + The Vary field value indicates the set of request-header fields that + fully determines, while the response is fresh, whether a cache is + permitted to use the response to reply to a subsequent request + without revalidation. For uncacheable or stale responses, the Vary + field value advises the user agent about the criteria that were used + to select the representation. A Vary field value of "*" implies that + a cache cannot determine from the request headers of a subsequent + request whether this response is the appropriate representation. See + section 13.6 for use of the Vary header field by caches. + + Vary = "Vary" ":" ( "*" | 1#field-name ) + + An HTTP/1.1 server SHOULD include a Vary header field with any + cacheable response that is subject to server-driven negotiation. + Doing so allows a cache to properly interpret future requests on that + resource and informs the user agent about the presence of negotiation + + + +Fielding, et al. Standards Track [Page 145] + +RFC 2616 HTTP/1.1 June 1999 + + + on that resource. A server MAY include a Vary header field with a + non-cacheable response that is subject to server-driven negotiation, + since this might provide the user agent with useful information about + the dimensions over which the response varies at the time of the + response. + + A Vary field value consisting of a list of field-names signals that + the representation selected for the response is based on a selection + algorithm which considers ONLY the listed request-header field values + in selecting the most appropriate representation. A cache MAY assume + that the same selection will be made for future requests with the + same values for the listed field names, for the duration of time for + which the response is fresh. + + The field-names given are not limited to the set of standard + request-header fields defined by this specification. Field names are + case-insensitive. + + A Vary field value of "*" signals that unspecified parameters not + limited to the request-headers (e.g., the network address of the + client), play a role in the selection of the response representation. + The "*" value MUST NOT be generated by a proxy server; it may only be + generated by an origin server. + +14.45 Via + + The Via general-header field MUST be used by gateways and proxies to + indicate the intermediate protocols and recipients between the user + agent and the server on requests, and between the origin server and + the client on responses. It is analogous to the "Received" field of + RFC 822 [9] and is intended to be used for tracking message forwards, + avoiding request loops, and identifying the protocol capabilities of + all senders along the request/response chain. + + Via = "Via" ":" 1#( received-protocol received-by [ comment ] ) + received-protocol = [ protocol-name "/" ] protocol-version + protocol-name = token + protocol-version = token + received-by = ( host [ ":" port ] ) | pseudonym + pseudonym = token + + The received-protocol indicates the protocol version of the message + received by the server or client along each segment of the + request/response chain. The received-protocol version is appended to + the Via field value when the message is forwarded so that information + about the protocol capabilities of upstream applications remains + visible to all recipients. + + + + +Fielding, et al. Standards Track [Page 146] + +RFC 2616 HTTP/1.1 June 1999 + + + The protocol-name is optional if and only if it would be "HTTP". The + received-by field is normally the host and optional port number of a + recipient server or client that subsequently forwarded the message. + However, if the real host is considered to be sensitive information, + it MAY be replaced by a pseudonym. If the port is not given, it MAY + be assumed to be the default port of the received-protocol. + + Multiple Via field values represents each proxy or gateway that has + forwarded the message. Each recipient MUST append its information + such that the end result is ordered according to the sequence of + forwarding applications. + + Comments MAY be used in the Via header field to identify the software + of the recipient proxy or gateway, analogous to the User-Agent and + Server header fields. However, all comments in the Via field are + optional and MAY be removed by any recipient prior to forwarding the + message. + + For example, a request message could be sent from an HTTP/1.0 user + agent to an internal proxy code-named "fred", which uses HTTP/1.1 to + forward the request to a public proxy at nowhere.com, which completes + the request by forwarding it to the origin server at www.ics.uci.edu. + The request received by www.ics.uci.edu would then have the following + Via header field: + + Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1) + + Proxies and gateways used as a portal through a network firewall + SHOULD NOT, by default, forward the names and ports of hosts within + the firewall region. This information SHOULD only be propagated if + explicitly enabled. If not enabled, the received-by host of any host + behind the firewall SHOULD be replaced by an appropriate pseudonym + for that host. + + For organizations that have strong privacy requirements for hiding + internal structures, a proxy MAY combine an ordered subsequence of + Via header field entries with identical received-protocol values into + a single such entry. For example, + + Via: 1.0 ricky, 1.1 ethel, 1.1 fred, 1.0 lucy + + could be collapsed to + + Via: 1.0 ricky, 1.1 mertz, 1.0 lucy + + + + + + + +Fielding, et al. Standards Track [Page 147] + +RFC 2616 HTTP/1.1 June 1999 + + + Applications SHOULD NOT combine multiple entries unless they are all + under the same organizational control and the hosts have already been + replaced by pseudonyms. Applications MUST NOT combine entries which + have different received-protocol values. + +14.46 Warning + + The Warning general-header field is used to carry additional + information about the status or transformation of a message which + might not be reflected in the message. This information is typically + used to warn about a possible lack of semantic transparency from + caching operations or transformations applied to the entity body of + the message. + + Warning headers are sent with responses using: + + Warning = "Warning" ":" 1#warning-value + + warning-value = warn-code SP warn-agent SP warn-text + [SP warn-date] + + warn-code = 3DIGIT + warn-agent = ( host [ ":" port ] ) | pseudonym + ; the name or pseudonym of the server adding + ; the Warning header, for use in debugging + warn-text = quoted-string + warn-date = <"> HTTP-date <"> + + A response MAY carry more than one Warning header. + + The warn-text SHOULD be in a natural language and character set that + is most likely to be intelligible to the human user receiving the + response. This decision MAY be based on any available knowledge, such + as the location of the cache or user, the Accept-Language field in a + request, the Content-Language field in a response, etc. The default + language is English and the default character set is ISO-8859-1. + + If a character set other than ISO-8859-1 is used, it MUST be encoded + in the warn-text using the method described in RFC 2047 [14]. + + Warning headers can in general be applied to any message, however + some specific warn-codes are specific to caches and can only be + applied to response messages. New Warning headers SHOULD be added + after any existing Warning headers. A cache MUST NOT delete any + Warning header that it received with a message. However, if a cache + successfully validates a cache entry, it SHOULD remove any Warning + headers previously attached to that entry except as specified for + + + + +Fielding, et al. Standards Track [Page 148] + +RFC 2616 HTTP/1.1 June 1999 + + + specific Warning codes. It MUST then add any Warning headers received + in the validating response. In other words, Warning headers are those + that would be attached to the most recent relevant response. + + When multiple Warning headers are attached to a response, the user + agent ought to inform the user of as many of them as possible, in the + order that they appear in the response. If it is not possible to + inform the user of all of the warnings, the user agent SHOULD follow + these heuristics: + + - Warnings that appear early in the response take priority over + those appearing later in the response. + + - Warnings in the user's preferred character set take priority + over warnings in other character sets but with identical warn- + codes and warn-agents. + + Systems that generate multiple Warning headers SHOULD order them with + this user agent behavior in mind. + + Requirements for the behavior of caches with respect to Warnings are + stated in section 13.1.2. + + This is a list of the currently-defined warn-codes, each with a + recommended warn-text in English, and a description of its meaning. + + 110 Response is stale + MUST be included whenever the returned response is stale. + + 111 Revalidation failed + MUST be included if a cache returns a stale response because an + attempt to revalidate the response failed, due to an inability to + reach the server. + + 112 Disconnected operation + SHOULD be included if the cache is intentionally disconnected from + the rest of the network for a period of time. + + 113 Heuristic expiration + MUST be included if the cache heuristically chose a freshness + lifetime greater than 24 hours and the response's age is greater + than 24 hours. + + 199 Miscellaneous warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action, besides presenting the warning to + the user. + + + +Fielding, et al. Standards Track [Page 149] + +RFC 2616 HTTP/1.1 June 1999 + + + 214 Transformation applied + MUST be added by an intermediate cache or proxy if it applies any + transformation changing the content-coding (as specified in the + Content-Encoding header) or media-type (as specified in the + Content-Type header) of the response, or the entity-body of the + response, unless this Warning code already appears in the response. + + 299 Miscellaneous persistent warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action. + + If an implementation sends a message with one or more Warning headers + whose version is HTTP/1.0 or lower, then the sender MUST include in + each warning-value a warn-date that matches the date in the response. + + If an implementation receives a message with a warning-value that + includes a warn-date, and that warn-date is different from the Date + value in the response, then that warning-value MUST be deleted from + the message before storing, forwarding, or using it. (This prevents + bad consequences of naive caching of Warning header fields.) If all + of the warning-values are deleted for this reason, the Warning header + MUST be deleted as well. + +14.47 WWW-Authenticate + + The WWW-Authenticate response-header field MUST be included in 401 + (Unauthorized) response messages. The field value consists of at + least one challenge that indicates the authentication scheme(s) and + parameters applicable to the Request-URI. + + WWW-Authenticate = "WWW-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. User + agents are advised to take special care in parsing the WWW- + Authenticate field value as it might contain more than one challenge, + or if more than one WWW-Authenticate header field is provided, the + contents of a challenge itself can contain a comma-separated list of + authentication parameters. + +15 Security Considerations + + This section is meant to inform application developers, information + providers, and users of the security limitations in HTTP/1.1 as + described by this document. The discussion does not include + definitive solutions to the problems revealed, though it does make + some suggestions for reducing security risks. + + + +Fielding, et al. Standards Track [Page 150] + +RFC 2616 HTTP/1.1 June 1999 + + +15.1 Personal Information + + HTTP clients are often privy to large amounts of personal information + (e.g. the user's name, location, mail address, passwords, encryption + keys, etc.), and SHOULD be very careful to prevent unintentional + leakage of this information via the HTTP protocol to other sources. + We very strongly recommend that a convenient interface be provided + for the user to control dissemination of such information, and that + designers and implementors be particularly careful in this area. + History shows that errors in this area often create serious security + and/or privacy problems and generate highly adverse publicity for the + implementor's company. + +15.1.1 Abuse of Server Log Information + + A server is in the position to save personal data about a user's + requests which might identify their reading patterns or subjects of + interest. This information is clearly confidential in nature and its + handling can be constrained by law in certain countries. People using + the HTTP protocol to provide data are responsible for ensuring that + such material is not distributed without the permission of any + individuals that are identifiable by the published results. + +15.1.2 Transfer of Sensitive Information + + Like any generic data transfer protocol, HTTP cannot regulate the + content of the data that is transferred, nor is there any a priori + method of determining the sensitivity of any particular piece of + information within the context of any given request. Therefore, + applications SHOULD supply as much control over this information as + possible to the provider of that information. Four header fields are + worth special mention in this context: Server, Via, Referer and From. + + Revealing the specific software version of the server might allow the + server machine to become more vulnerable to attacks against software + that is known to contain security holes. Implementors SHOULD make the + Server header field a configurable option. + + Proxies which serve as a portal through a network firewall SHOULD + take special precautions regarding the transfer of header information + that identifies the hosts behind the firewall. In particular, they + SHOULD remove, or replace with sanitized versions, any Via fields + generated behind the firewall. + + The Referer header allows reading patterns to be studied and reverse + links drawn. Although it can be very useful, its power can be abused + if user details are not separated from the information contained in + + + + +Fielding, et al. Standards Track [Page 151] + +RFC 2616 HTTP/1.1 June 1999 + + + the Referer. Even when the personal information has been removed, the + Referer header might indicate a private document's URI whose + publication would be inappropriate. + + The information sent in the From field might conflict with the user's + privacy interests or their site's security policy, and hence it + SHOULD NOT be transmitted without the user being able to disable, + enable, and modify the contents of the field. The user MUST be able + to set the contents of this field within a user preference or + application defaults configuration. + + We suggest, though do not require, that a convenient toggle interface + be provided for the user to enable or disable the sending of From and + Referer information. + + The User-Agent (section 14.43) or Server (section 14.38) header + fields can sometimes be used to determine that a specific client or + server have a particular security hole which might be exploited. + Unfortunately, this same information is often used for other valuable + purposes for which HTTP currently has no better mechanism. + +15.1.3 Encoding Sensitive Information in URI's + + Because the source of a link might be private information or might + reveal an otherwise private information source, it is strongly + recommended that the user be able to select whether or not the + Referer field is sent. For example, a browser client could have a + toggle switch for browsing openly/anonymously, which would + respectively enable/disable the sending of Referer and From + information. + + Clients SHOULD NOT include a Referer header field in a (non-secure) + HTTP request if the referring page was transferred with a secure + protocol. + + Authors of services which use the HTTP protocol SHOULD NOT use GET + based forms for the submission of sensitive data, because this will + cause this data to be encoded in the Request-URI. Many existing + servers, proxies, and user agents will log the request URI in some + place where it might be visible to third parties. Servers can use + POST-based form submission instead + +15.1.4 Privacy Issues Connected to Accept Headers + + Accept request-headers can reveal information about the user to all + servers which are accessed. The Accept-Language header in particular + can reveal information the user would consider to be of a private + nature, because the understanding of particular languages is often + + + +Fielding, et al. Standards Track [Page 152] + +RFC 2616 HTTP/1.1 June 1999 + + + strongly correlated to the membership of a particular ethnic group. + User agents which offer the option to configure the contents of an + Accept-Language header to be sent in every request are strongly + encouraged to let the configuration process include a message which + makes the user aware of the loss of privacy involved. + + An approach that limits the loss of privacy would be for a user agent + to omit the sending of Accept-Language headers by default, and to ask + the user whether or not to start sending Accept-Language headers to a + server if it detects, by looking for any Vary response-header fields + generated by the server, that such sending could improve the quality + of service. + + Elaborate user-customized accept header fields sent in every request, + in particular if these include quality values, can be used by servers + as relatively reliable and long-lived user identifiers. Such user + identifiers would allow content providers to do click-trail tracking, + and would allow collaborating content providers to match cross-server + click-trails or form submissions of individual users. Note that for + many users not behind a proxy, the network address of the host + running the user agent will also serve as a long-lived user + identifier. In environments where proxies are used to enhance + privacy, user agents ought to be conservative in offering accept + header configuration options to end users. As an extreme privacy + measure, proxies could filter the accept headers in relayed requests. + General purpose user agents which provide a high degree of header + configurability SHOULD warn users about the loss of privacy which can + be involved. + +15.2 Attacks Based On File and Path Names + + Implementations of HTTP origin servers SHOULD be careful to restrict + the documents returned by HTTP requests to be only those that were + intended by the server administrators. If an HTTP server translates + HTTP URIs directly into file system calls, the server MUST take + special care not to serve files that were not intended to be + delivered to HTTP clients. For example, UNIX, Microsoft Windows, and + other operating systems use ".." as a path component to indicate a + directory level above the current one. On such a system, an HTTP + server MUST disallow any such construct in the Request-URI if it + would otherwise allow access to a resource outside those intended to + be accessible via the HTTP server. Similarly, files intended for + reference only internally to the server (such as access control + files, configuration files, and script code) MUST be protected from + inappropriate retrieval, since they might contain sensitive + information. Experience has shown that minor bugs in such HTTP server + implementations have turned into security risks. + + + + +Fielding, et al. Standards Track [Page 153] + +RFC 2616 HTTP/1.1 June 1999 + + +15.3 DNS Spoofing + + Clients using HTTP rely heavily on the Domain Name Service, and are + thus generally prone to security attacks based on the deliberate + mis-association of IP addresses and DNS names. Clients need to be + cautious in assuming the continuing validity of an IP number/DNS name + association. + + In particular, HTTP clients SHOULD rely on their name resolver for + confirmation of an IP number/DNS name association, rather than + caching the result of previous host name lookups. Many platforms + already can cache host name lookups locally when appropriate, and + they SHOULD be configured to do so. It is proper for these lookups to + be cached, however, only when the TTL (Time To Live) information + reported by the name server makes it likely that the cached + information will remain useful. + + If HTTP clients cache the results of host name lookups in order to + achieve a performance improvement, they MUST observe the TTL + information reported by DNS. + + If HTTP clients do not observe this rule, they could be spoofed when + a previously-accessed server's IP address changes. As network + renumbering is expected to become increasingly common [24], the + possibility of this form of attack will grow. Observing this + requirement thus reduces this potential security vulnerability. + + This requirement also improves the load-balancing behavior of clients + for replicated servers using the same DNS name and reduces the + likelihood of a user's experiencing failure in accessing sites which + use that strategy. + +15.4 Location Headers and Spoofing + + If a single server supports multiple organizations that do not trust + one another, then it MUST check the values of Location and Content- + Location headers in responses that are generated under control of + said organizations to make sure that they do not attempt to + invalidate resources over which they have no authority. + +15.5 Content-Disposition Issues + + RFC 1806 [35], from which the often implemented Content-Disposition + (see section 19.5.1) header in HTTP is derived, has a number of very + serious security considerations. Content-Disposition is not part of + the HTTP standard, but since it is widely implemented, we are + documenting its use and risks for implementors. See RFC 2183 [49] + (which updates RFC 1806) for details. + + + +Fielding, et al. Standards Track [Page 154] + +RFC 2616 HTTP/1.1 June 1999 + + +15.6 Authentication Credentials and Idle Clients + + Existing HTTP clients and user agents typically retain authentication + information indefinitely. HTTP/1.1. does not provide a method for a + server to direct clients to discard these cached credentials. This is + a significant defect that requires further extensions to HTTP. + Circumstances under which credential caching can interfere with the + application's security model include but are not limited to: + + - Clients which have been idle for an extended period following + which the server might wish to cause the client to reprompt the + user for credentials. + + - Applications which include a session termination indication + (such as a `logout' or `commit' button on a page) after which + the server side of the application `knows' that there is no + further reason for the client to retain the credentials. + + This is currently under separate study. There are a number of work- + arounds to parts of this problem, and we encourage the use of + password protection in screen savers, idle time-outs, and other + methods which mitigate the security problems inherent in this + problem. In particular, user agents which cache credentials are + encouraged to provide a readily accessible mechanism for discarding + cached credentials under user control. + +15.7 Proxies and Caching + + By their very nature, HTTP proxies are men-in-the-middle, and + represent an opportunity for man-in-the-middle attacks. Compromise of + the systems on which the proxies run can result in serious security + and privacy problems. Proxies have access to security-related + information, personal information about individual users and + organizations, and proprietary information belonging to users and + content providers. A compromised proxy, or a proxy implemented or + configured without regard to security and privacy considerations, + might be used in the commission of a wide range of potential attacks. + + Proxy operators should protect the systems on which proxies run as + they would protect any system that contains or transports sensitive + information. In particular, log information gathered at proxies often + contains highly sensitive personal information, and/or information + about organizations. Log information should be carefully guarded, and + appropriate guidelines for use developed and followed. (Section + 15.1.1). + + + + + + +Fielding, et al. Standards Track [Page 155] + +RFC 2616 HTTP/1.1 June 1999 + + + Caching proxies provide additional potential vulnerabilities, since + the contents of the cache represent an attractive target for + malicious exploitation. Because cache contents persist after an HTTP + request is complete, an attack on the cache can reveal information + long after a user believes that the information has been removed from + the network. Therefore, cache contents should be protected as + sensitive information. + + Proxy implementors should consider the privacy and security + implications of their design and coding decisions, and of the + configuration options they provide to proxy operators (especially the + default configuration). + + Users of a proxy need to be aware that they are no trustworthier than + the people who run the proxy; HTTP itself cannot solve this problem. + + The judicious use of cryptography, when appropriate, may suffice to + protect against a broad range of security and privacy attacks. Such + cryptography is beyond the scope of the HTTP/1.1 specification. + +15.7.1 Denial of Service Attacks on Proxies + + They exist. They are hard to defend against. Research continues. + Beware. + +16 Acknowledgments + + This specification makes heavy use of the augmented BNF and generic + constructs defined by David H. Crocker for RFC 822 [9]. Similarly, it + reuses many of the definitions provided by Nathaniel Borenstein and + Ned Freed for MIME [7]. We hope that their inclusion in this + specification will help reduce past confusion over the relationship + between HTTP and Internet mail message formats. + + The HTTP protocol has evolved considerably over the years. It has + benefited from a large and active developer community--the many + people who have participated on the www-talk mailing list--and it is + that community which has been most responsible for the success of + HTTP and of the World-Wide Web in general. Marc Andreessen, Robert + Cailliau, Daniel W. Connolly, Bob Denny, John Franks, Jean-Francois + Groff, Phillip M. Hallam-Baker, Hakon W. Lie, Ari Luotonen, Rob + McCool, Lou Montulli, Dave Raggett, Tony Sanders, and Marc + VanHeyningen deserve special recognition for their efforts in + defining early aspects of the protocol. + + This document has benefited greatly from the comments of all those + participating in the HTTP-WG. In addition to those already mentioned, + the following individuals have contributed to this specification: + + + +Fielding, et al. Standards Track [Page 156] + +RFC 2616 HTTP/1.1 June 1999 + + + Gary Adams Ross Patterson + Harald Tveit Alvestrand Albert Lunde + Keith Ball John C. Mallery + Brian Behlendorf Jean-Philippe Martin-Flatin + Paul Burchard Mitra + Maurizio Codogno David Morris + Mike Cowlishaw Gavin Nicol + Roman Czyborra Bill Perry + Michael A. Dolan Jeffrey Perry + David J. Fiander Scott Powers + Alan Freier Owen Rees + Marc Hedlund Luigi Rizzo + Greg Herlihy David Robinson + Koen Holtman Marc Salomon + Alex Hopmann Rich Salz + Bob Jernigan Allan M. Schiffman + Shel Kaphan Jim Seidman + Rohit Khare Chuck Shotton + John Klensin Eric W. Sink + Martijn Koster Simon E. Spero + Alexei Kosut Richard N. Taylor + David M. Kristol Robert S. Thau + Daniel LaLiberte Bill (BearHeart) Weinman + Ben Laurie Francois Yergeau + Paul J. Leach Mary Ellen Zurko + Daniel DuBois Josh Cohen + + + Much of the content and presentation of the caching design is due to + suggestions and comments from individuals including: Shel Kaphan, + Paul Leach, Koen Holtman, David Morris, and Larry Masinter. + + Most of the specification of ranges is based on work originally done + by Ari Luotonen and John Franks, with additional input from Steve + Zilles. + + Thanks to the "cave men" of Palo Alto. You know who you are. + + Jim Gettys (the current editor of this document) wishes particularly + to thank Roy Fielding, the previous editor of this document, along + with John Klensin, Jeff Mogul, Paul Leach, Dave Kristol, Koen + Holtman, John Franks, Josh Cohen, Alex Hopmann, Scott Lawrence, and + Larry Masinter for their help. And thanks go particularly to Jeff + Mogul and Scott Lawrence for performing the "MUST/MAY/SHOULD" audit. + + + + + + + +Fielding, et al. Standards Track [Page 157] + +RFC 2616 HTTP/1.1 June 1999 + + + The Apache Group, Anselm Baird-Smith, author of Jigsaw, and Henrik + Frystyk implemented RFC 2068 early, and we wish to thank them for the + discovery of many of the problems that this document attempts to + rectify. + +17 References + + [1] Alvestrand, H., "Tags for the Identification of Languages", RFC + 1766, March 1995. + + [2] Anklesaria, F., McCahill, M., Lindner, P., Johnson, D., Torrey, + D. and B. Alberti, "The Internet Gopher Protocol (a distributed + document search and retrieval protocol)", RFC 1436, March 1993. + + [3] Berners-Lee, T., "Universal Resource Identifiers in WWW", RFC + 1630, June 1994. + + [4] Berners-Lee, T., Masinter, L. and M. McCahill, "Uniform Resource + Locators (URL)", RFC 1738, December 1994. + + [5] Berners-Lee, T. and D. Connolly, "Hypertext Markup Language - + 2.0", RFC 1866, November 1995. + + [6] Berners-Lee, T., Fielding, R. and H. Frystyk, "Hypertext Transfer + Protocol -- HTTP/1.0", RFC 1945, May 1996. + + [7] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part One: Format of Internet Message Bodies", + RFC 2045, November 1996. + + [8] Braden, R., "Requirements for Internet Hosts -- Communication + Layers", STD 3, RFC 1123, October 1989. + + [9] Crocker, D., "Standard for The Format of ARPA Internet Text + Messages", STD 11, RFC 822, August 1982. + + [10] Davis, F., Kahle, B., Morris, H., Salem, J., Shen, T., Wang, R., + Sui, J., and M. Grinbaum, "WAIS Interface Protocol Prototype + Functional Specification," (v1.5), Thinking Machines + Corporation, April 1990. + + [11] Fielding, R., "Relative Uniform Resource Locators", RFC 1808, + June 1995. + + [12] Horton, M. and R. Adams, "Standard for Interchange of USENET + Messages", RFC 1036, December 1987. + + + + + +Fielding, et al. Standards Track [Page 158] + +RFC 2616 HTTP/1.1 June 1999 + + + [13] Kantor, B. and P. Lapsley, "Network News Transfer Protocol", RFC + 977, February 1986. + + [14] Moore, K., "MIME (Multipurpose Internet Mail Extensions) Part + Three: Message Header Extensions for Non-ASCII Text", RFC 2047, + November 1996. + + [15] Nebel, E. and L. Masinter, "Form-based File Upload in HTML", RFC + 1867, November 1995. + + [16] Postel, J., "Simple Mail Transfer Protocol", STD 10, RFC 821, + August 1982. + + [17] Postel, J., "Media Type Registration Procedure", RFC 1590, + November 1996. + + [18] Postel, J. and J. Reynolds, "File Transfer Protocol", STD 9, RFC + 959, October 1985. + + [19] Reynolds, J. and J. Postel, "Assigned Numbers", STD 2, RFC 1700, + October 1994. + + [20] Sollins, K. and L. Masinter, "Functional Requirements for + Uniform Resource Names", RFC 1737, December 1994. + + [21] US-ASCII. Coded Character Set - 7-Bit American Standard Code for + Information Interchange. Standard ANSI X3.4-1986, ANSI, 1986. + + [22] ISO-8859. International Standard -- Information Processing -- + 8-bit Single-Byte Coded Graphic Character Sets -- + Part 1: Latin alphabet No. 1, ISO-8859-1:1987. + Part 2: Latin alphabet No. 2, ISO-8859-2, 1987. + Part 3: Latin alphabet No. 3, ISO-8859-3, 1988. + Part 4: Latin alphabet No. 4, ISO-8859-4, 1988. + Part 5: Latin/Cyrillic alphabet, ISO-8859-5, 1988. + Part 6: Latin/Arabic alphabet, ISO-8859-6, 1987. + Part 7: Latin/Greek alphabet, ISO-8859-7, 1987. + Part 8: Latin/Hebrew alphabet, ISO-8859-8, 1988. + Part 9: Latin alphabet No. 5, ISO-8859-9, 1990. + + [23] Meyers, J. and M. Rose, "The Content-MD5 Header Field", RFC + 1864, October 1995. + + [24] Carpenter, B. and Y. Rekhter, "Renumbering Needs Work", RFC + 1900, February 1996. + + [25] Deutsch, P., "GZIP file format specification version 4.3", RFC + 1952, May 1996. + + + +Fielding, et al. Standards Track [Page 159] + +RFC 2616 HTTP/1.1 June 1999 + + + [26] Venkata N. Padmanabhan, and Jeffrey C. Mogul. "Improving HTTP + Latency", Computer Networks and ISDN Systems, v. 28, pp. 25-35, + Dec. 1995. Slightly revised version of paper in Proc. 2nd + International WWW Conference '94: Mosaic and the Web, Oct. 1994, + which is available at + http://www.ncsa.uiuc.edu/SDG/IT94/Proceedings/DDay/mogul/HTTPLat + ency.html. + + [27] Joe Touch, John Heidemann, and Katia Obraczka. "Analysis of HTTP + Performance", , + ISI Research Report ISI/RR-98-463, (original report dated Aug. + 1996), USC/Information Sciences Institute, August 1998. + + [28] Mills, D., "Network Time Protocol (Version 3) Specification, + Implementation and Analysis", RFC 1305, March 1992. + + [29] Deutsch, P., "DEFLATE Compressed Data Format Specification + version 1.3", RFC 1951, May 1996. + + [30] S. Spero, "Analysis of HTTP Performance Problems," + http://sunsite.unc.edu/mdma-release/http-prob.html. + + [31] Deutsch, P. and J. Gailly, "ZLIB Compressed Data Format + Specification version 3.3", RFC 1950, May 1996. + + [32] Franks, J., Hallam-Baker, P., Hostetler, J., Leach, P., + Luotonen, A., Sink, E. and L. Stewart, "An Extension to HTTP: + Digest Access Authentication", RFC 2069, January 1997. + + [33] Fielding, R., Gettys, J., Mogul, J., Frystyk, H. and T. + Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1", RFC + 2068, January 1997. + + [34] Bradner, S., "Key words for use in RFCs to Indicate Requirement + Levels", BCP 14, RFC 2119, March 1997. + + [35] Troost, R. and Dorner, S., "Communicating Presentation + Information in Internet Messages: The Content-Disposition + Header", RFC 1806, June 1995. + + [36] Mogul, J., Fielding, R., Gettys, J. and H. Frystyk, "Use and + Interpretation of HTTP Version Numbers", RFC 2145, May 1997. + [jg639] + + [37] Palme, J., "Common Internet Message Headers", RFC 2076, February + 1997. [jg640] + + + + + +Fielding, et al. Standards Track [Page 160] + +RFC 2616 HTTP/1.1 June 1999 + + + [38] Yergeau, F., "UTF-8, a transformation format of Unicode and + ISO-10646", RFC 2279, January 1998. [jg641] + + [39] Nielsen, H.F., Gettys, J., Baird-Smith, A., Prud'hommeaux, E., + Lie, H., and C. Lilley. "Network Performance Effects of + HTTP/1.1, CSS1, and PNG," Proceedings of ACM SIGCOMM '97, Cannes + France, September 1997.[jg642] + + [40] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Two: Media Types", RFC 2046, November + 1996. [jg643] + + [41] Alvestrand, H., "IETF Policy on Character Sets and Languages", + BCP 18, RFC 2277, January 1998. [jg644] + + [42] Berners-Lee, T., Fielding, R. and L. Masinter, "Uniform Resource + Identifiers (URI): Generic Syntax and Semantics", RFC 2396, + August 1998. [jg645] + + [43] Franks, J., Hallam-Baker, P., Hostetler, J., Lawrence, S., + Leach, P., Luotonen, A., Sink, E. and L. Stewart, "HTTP + Authentication: Basic and Digest Access Authentication", RFC + 2617, June 1999. [jg646] + + [44] Luotonen, A., "Tunneling TCP based protocols through Web proxy + servers," Work in Progress. [jg647] + + [45] Palme, J. and A. Hopmann, "MIME E-mail Encapsulation of + Aggregate Documents, such as HTML (MHTML)", RFC 2110, March + 1997. + + [46] Bradner, S., "The Internet Standards Process -- Revision 3", BCP + 9, RFC 2026, October 1996. + + [47] Masinter, L., "Hyper Text Coffee Pot Control Protocol + (HTCPCP/1.0)", RFC 2324, 1 April 1998. + + [48] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Five: Conformance Criteria and Examples", + RFC 2049, November 1996. + + [49] Troost, R., Dorner, S. and K. Moore, "Communicating Presentation + Information in Internet Messages: The Content-Disposition Header + Field", RFC 2183, August 1997. + + + + + + + +Fielding, et al. Standards Track [Page 161] + +RFC 2616 HTTP/1.1 June 1999 + + +18 Authors' Addresses + + Roy T. Fielding + Information and Computer Science + University of California, Irvine + Irvine, CA 92697-3425, USA + + Fax: +1 (949) 824-1715 + EMail: fielding@ics.uci.edu + + + James Gettys + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: jg@w3.org + + + Jeffrey C. Mogul + Western Research Laboratory + Compaq Computer Corporation + 250 University Avenue + Palo Alto, California, 94305, USA + + EMail: mogul@wrl.dec.com + + + Henrik Frystyk Nielsen + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: frystyk@w3.org + + + Larry Masinter + Xerox Corporation + 3333 Coyote Hill Road + Palo Alto, CA 94034, USA + + EMail: masinter@parc.xerox.com + + + + + +Fielding, et al. Standards Track [Page 162] + +RFC 2616 HTTP/1.1 June 1999 + + + Paul J. Leach + Microsoft Corporation + 1 Microsoft Way + Redmond, WA 98052, USA + + EMail: paulle@microsoft.com + + + Tim Berners-Lee + Director, World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: timbl@w3.org + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 163] + +RFC 2616 HTTP/1.1 June 1999 + + +19 Appendices + +19.1 Internet Media Type message/http and application/http + + In addition to defining the HTTP/1.1 protocol, this document serves + as the specification for the Internet media type "message/http" and + "application/http". The message/http type can be used to enclose a + single HTTP request or response message, provided that it obeys the + MIME restrictions for all "message" types regarding line length and + encodings. The application/http type can be used to enclose a + pipeline of one or more HTTP request or response messages (not + intermixed). The following is to be registered with IANA [17]. + + Media Type name: message + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed message + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + Media Type name: application + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed messages + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: HTTP messages enclosed by this type + are in "binary" format; use of an appropriate + Content-Transfer-Encoding is required when + transmitted via E-mail. + Security considerations: none + + + + + + + + + +Fielding, et al. Standards Track [Page 164] + +RFC 2616 HTTP/1.1 June 1999 + + +19.2 Internet Media Type multipart/byteranges + + When an HTTP 206 (Partial Content) response message includes the + content of multiple ranges (a response to a request for multiple + non-overlapping ranges), these are transmitted as a multipart + message-body. The media type for this purpose is called + "multipart/byteranges". + + The multipart/byteranges media type includes two or more parts, each + with its own Content-Type and Content-Range fields. The required + boundary parameter specifies the boundary string used to separate + each body-part. + + Media Type name: multipart + Media subtype name: byteranges + Required parameters: boundary + Optional parameters: none + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + + For example: + + HTTP/1.1 206 Partial Content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-type: multipart/byteranges; boundary=THIS_STRING_SEPARATES + + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 500-999/8000 + + ...the first range... + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 7000-7999/8000 + + ...the second range + --THIS_STRING_SEPARATES-- + + Notes: + + 1) Additional CRLFs may precede the first boundary string in the + entity. + + + + + + +Fielding, et al. Standards Track [Page 165] + +RFC 2616 HTTP/1.1 June 1999 + + + 2) Although RFC 2046 [40] permits the boundary string to be + quoted, some existing implementations handle a quoted boundary + string incorrectly. + + 3) A number of browsers and servers were coded to an early draft + of the byteranges specification to use a media type of + multipart/x-byteranges, which is almost, but not quite + compatible with the version documented in HTTP/1.1. + +19.3 Tolerant Applications + + Although this document specifies the requirements for the generation + of HTTP/1.1 messages, not all applications will be correct in their + implementation. We therefore recommend that operational applications + be tolerant of deviations whenever those deviations can be + interpreted unambiguously. + + Clients SHOULD be tolerant in parsing the Status-Line and servers + tolerant when parsing the Request-Line. In particular, they SHOULD + accept any amount of SP or HT characters between fields, even though + only a single SP is required. + + The line terminator for message-header fields is the sequence CRLF. + However, we recommend that applications, when parsing such headers, + recognize a single LF as a line terminator and ignore the leading CR. + + The character set of an entity-body SHOULD be labeled as the lowest + common denominator of the character codes used within that body, with + the exception that not labeling the entity is preferred over labeling + the entity with the labels US-ASCII or ISO-8859-1. See section 3.7.1 + and 3.4.1. + + Additional rules for requirements on parsing and encoding of dates + and other potential problems with date encodings include: + + - HTTP/1.1 clients and caches SHOULD assume that an RFC-850 date + which appears to be more than 50 years in the future is in fact + in the past (this helps solve the "year 2000" problem). + + - An HTTP/1.1 implementation MAY internally represent a parsed + Expires date as earlier than the proper value, but MUST NOT + internally represent a parsed Expires date as later than the + proper value. + + - All expiration-related calculations MUST be done in GMT. The + local time zone MUST NOT influence the calculation or comparison + of an age or expiration time. + + + + +Fielding, et al. Standards Track [Page 166] + +RFC 2616 HTTP/1.1 June 1999 + + + - If an HTTP header incorrectly carries a date value with a time + zone other than GMT, it MUST be converted into GMT using the + most conservative possible conversion. + +19.4 Differences Between HTTP Entities and RFC 2045 Entities + + HTTP/1.1 uses many of the constructs defined for Internet Mail (RFC + 822 [9]) and the Multipurpose Internet Mail Extensions (MIME [7]) to + allow entities to be transmitted in an open variety of + representations and with extensible mechanisms. However, RFC 2045 + discusses mail, and HTTP has a few features that are different from + those described in RFC 2045. These differences were carefully chosen + to optimize performance over binary connections, to allow greater + freedom in the use of new media types, to make date comparisons + easier, and to acknowledge the practice of some early HTTP servers + and clients. + + This appendix describes specific areas where HTTP differs from RFC + 2045. Proxies and gateways to strict MIME environments SHOULD be + aware of these differences and provide the appropriate conversions + where necessary. Proxies and gateways from MIME environments to HTTP + also need to be aware of the differences because some conversions + might be required. + +19.4.1 MIME-Version + + HTTP is not a MIME-compliant protocol. However, HTTP/1.1 messages MAY + include a single MIME-Version general-header field to indicate what + version of the MIME protocol was used to construct the message. Use + of the MIME-Version header field indicates that the message is in + full compliance with the MIME protocol (as defined in RFC 2045[7]). + Proxies/gateways are responsible for ensuring full compliance (where + possible) when exporting HTTP messages to strict MIME environments. + + MIME-Version = "MIME-Version" ":" 1*DIGIT "." 1*DIGIT + + MIME version "1.0" is the default for use in HTTP/1.1. However, + HTTP/1.1 message parsing and semantics are defined by this document + and not the MIME specification. + +19.4.2 Conversion to Canonical Form + + RFC 2045 [7] requires that an Internet mail entity be converted to + canonical form prior to being transferred, as described in section 4 + of RFC 2049 [48]. Section 3.7.1 of this document describes the forms + allowed for subtypes of the "text" media type when transmitted over + HTTP. RFC 2046 requires that content with a type of "text" represent + line breaks as CRLF and forbids the use of CR or LF outside of line + + + +Fielding, et al. Standards Track [Page 167] + +RFC 2616 HTTP/1.1 June 1999 + + + break sequences. HTTP allows CRLF, bare CR, and bare LF to indicate a + line break within text content when a message is transmitted over + HTTP. + + Where it is possible, a proxy or gateway from HTTP to a strict MIME + environment SHOULD translate all line breaks within the text media + types described in section 3.7.1 of this document to the RFC 2049 + canonical form of CRLF. Note, however, that this might be complicated + by the presence of a Content-Encoding and by the fact that HTTP + allows the use of some character sets which do not use octets 13 and + 10 to represent CR and LF, as is the case for some multi-byte + character sets. + + Implementors should note that conversion will break any cryptographic + checksums applied to the original content unless the original content + is already in canonical form. Therefore, the canonical form is + recommended for any content that uses such checksums in HTTP. + +19.4.3 Conversion of Date Formats + + HTTP/1.1 uses a restricted set of date formats (section 3.3.1) to + simplify the process of date comparison. Proxies and gateways from + other protocols SHOULD ensure that any Date header field present in a + message conforms to one of the HTTP/1.1 formats and rewrite the date + if necessary. + +19.4.4 Introduction of Content-Encoding + + RFC 2045 does not include any concept equivalent to HTTP/1.1's + Content-Encoding header field. Since this acts as a modifier on the + media type, proxies and gateways from HTTP to MIME-compliant + protocols MUST either change the value of the Content-Type header + field or decode the entity-body before forwarding the message. (Some + experimental applications of Content-Type for Internet mail have used + a media-type parameter of ";conversions=" to perform + a function equivalent to Content-Encoding. However, this parameter is + not part of RFC 2045.) + +19.4.5 No Content-Transfer-Encoding + + HTTP does not use the Content-Transfer-Encoding (CTE) field of RFC + 2045. Proxies and gateways from MIME-compliant protocols to HTTP MUST + remove any non-identity CTE ("quoted-printable" or "base64") encoding + prior to delivering the response message to an HTTP client. + + Proxies and gateways from HTTP to MIME-compliant protocols are + responsible for ensuring that the message is in the correct format + and encoding for safe transport on that protocol, where "safe + + + +Fielding, et al. Standards Track [Page 168] + +RFC 2616 HTTP/1.1 June 1999 + + + transport" is defined by the limitations of the protocol being used. + Such a proxy or gateway SHOULD label the data with an appropriate + Content-Transfer-Encoding if doing so will improve the likelihood of + safe transport over the destination protocol. + +19.4.6 Introduction of Transfer-Encoding + + HTTP/1.1 introduces the Transfer-Encoding header field (section + 14.41). Proxies/gateways MUST remove any transfer-coding prior to + forwarding a message via a MIME-compliant protocol. + + A process for decoding the "chunked" transfer-coding (section 3.6) + can be represented in pseudo-code as: + + length := 0 + read chunk-size, chunk-extension (if any) and CRLF + while (chunk-size > 0) { + read chunk-data and CRLF + append chunk-data to entity-body + length := length + chunk-size + read chunk-size and CRLF + } + read entity-header + while (entity-header not empty) { + append entity-header to existing header fields + read entity-header + } + Content-Length := length + Remove "chunked" from Transfer-Encoding + +19.4.7 MHTML and Line Length Limitations + + HTTP implementations which share code with MHTML [45] implementations + need to be aware of MIME line length limitations. Since HTTP does not + have this limitation, HTTP does not fold long lines. MHTML messages + being transported by HTTP follow all conventions of MHTML, including + line length limitations and folding, canonicalization, etc., since + HTTP transports all message-bodies as payload (see section 3.7.2) and + does not interpret the content or any MIME header lines that might be + contained therein. + +19.5 Additional Features + + RFC 1945 and RFC 2068 document protocol elements used by some + existing HTTP implementations, but not consistently and correctly + across most HTTP/1.1 applications. Implementors are advised to be + aware of these features, but cannot rely upon their presence in, or + interoperability with, other HTTP/1.1 applications. Some of these + + + +Fielding, et al. Standards Track [Page 169] + +RFC 2616 HTTP/1.1 June 1999 + + + describe proposed experimental features, and some describe features + that experimental deployment found lacking that are now addressed in + the base HTTP/1.1 specification. + + A number of other headers, such as Content-Disposition and Title, + from SMTP and MIME are also often implemented (see RFC 2076 [37]). + +19.5.1 Content-Disposition + + The Content-Disposition response-header field has been proposed as a + means for the origin server to suggest a default filename if the user + requests that the content is saved to a file. This usage is derived + from the definition of Content-Disposition in RFC 1806 [35]. + + content-disposition = "Content-Disposition" ":" + disposition-type *( ";" disposition-parm ) + disposition-type = "attachment" | disp-extension-token + disposition-parm = filename-parm | disp-extension-parm + filename-parm = "filename" "=" quoted-string + disp-extension-token = token + disp-extension-parm = token "=" ( token | quoted-string ) + + An example is + + Content-Disposition: attachment; filename="fname.ext" + + The receiving user agent SHOULD NOT respect any directory path + information present in the filename-parm parameter, which is the only + parameter believed to apply to HTTP implementations at this time. The + filename SHOULD be treated as a terminal component only. + + If this header is used in a response with the application/octet- + stream content-type, the implied suggestion is that the user agent + should not display the response, but directly enter a `save response + as...' dialog. + + See section 15.5 for Content-Disposition security issues. + +19.6 Compatibility with Previous Versions + + It is beyond the scope of a protocol specification to mandate + compliance with previous versions. HTTP/1.1 was deliberately + designed, however, to make supporting previous versions easy. It is + worth noting that, at the time of composing this specification + (1996), we would expect commercial HTTP/1.1 servers to: + + - recognize the format of the Request-Line for HTTP/0.9, 1.0, and + 1.1 requests; + + + +Fielding, et al. Standards Track [Page 170] + +RFC 2616 HTTP/1.1 June 1999 + + + - understand any valid request in the format of HTTP/0.9, 1.0, or + 1.1; + + - respond appropriately with a message in the same major version + used by the client. + + And we would expect HTTP/1.1 clients to: + + - recognize the format of the Status-Line for HTTP/1.0 and 1.1 + responses; + + - understand any valid response in the format of HTTP/0.9, 1.0, or + 1.1. + + For most implementations of HTTP/1.0, each connection is established + by the client prior to the request and closed by the server after + sending the response. Some implementations implement the Keep-Alive + version of persistent connections described in section 19.7.1 of RFC + 2068 [33]. + +19.6.1 Changes from HTTP/1.0 + + This section summarizes major differences between versions HTTP/1.0 + and HTTP/1.1. + +19.6.1.1 Changes to Simplify Multi-homed Web Servers and Conserve IP + Addresses + + The requirements that clients and servers support the Host request- + header, report an error if the Host request-header (section 14.23) is + missing from an HTTP/1.1 request, and accept absolute URIs (section + 5.1.2) are among the most important changes defined by this + specification. + + Older HTTP/1.0 clients assumed a one-to-one relationship of IP + addresses and servers; there was no other established mechanism for + distinguishing the intended server of a request than the IP address + to which that request was directed. The changes outlined above will + allow the Internet, once older HTTP clients are no longer common, to + support multiple Web sites from a single IP address, greatly + simplifying large operational Web servers, where allocation of many + IP addresses to a single host has created serious problems. The + Internet will also be able to recover the IP addresses that have been + allocated for the sole purpose of allowing special-purpose domain + names to be used in root-level HTTP URLs. Given the rate of growth of + the Web, and the number of servers already deployed, it is extremely + + + + + +Fielding, et al. Standards Track [Page 171] + +RFC 2616 HTTP/1.1 June 1999 + + + important that all implementations of HTTP (including updates to + existing HTTP/1.0 applications) correctly implement these + requirements: + + - Both clients and servers MUST support the Host request-header. + + - A client that sends an HTTP/1.1 request MUST send a Host header. + + - Servers MUST report a 400 (Bad Request) error if an HTTP/1.1 + request does not include a Host request-header. + + - Servers MUST accept absolute URIs. + +19.6.2 Compatibility with HTTP/1.0 Persistent Connections + + Some clients and servers might wish to be compatible with some + previous implementations of persistent connections in HTTP/1.0 + clients and servers. Persistent connections in HTTP/1.0 are + explicitly negotiated as they are not the default behavior. HTTP/1.0 + experimental implementations of persistent connections are faulty, + and the new facilities in HTTP/1.1 are designed to rectify these + problems. The problem was that some existing 1.0 clients may be + sending Keep-Alive to a proxy server that doesn't understand + Connection, which would then erroneously forward it to the next + inbound server, which would establish the Keep-Alive connection and + result in a hung HTTP/1.0 proxy waiting for the close on the + response. The result is that HTTP/1.0 clients must be prevented from + using Keep-Alive when talking to proxies. + + However, talking to proxies is the most important use of persistent + connections, so that prohibition is clearly unacceptable. Therefore, + we need some other mechanism for indicating a persistent connection + is desired, which is safe to use even when talking to an old proxy + that ignores Connection. Persistent connections are the default for + HTTP/1.1 messages; we introduce a new keyword (Connection: close) for + declaring non-persistence. See section 14.10. + + The original HTTP/1.0 form of persistent connections (the Connection: + Keep-Alive and Keep-Alive header) is documented in RFC 2068. [33] + +19.6.3 Changes from RFC 2068 + + This specification has been carefully audited to correct and + disambiguate key word usage; RFC 2068 had many problems in respect to + the conventions laid out in RFC 2119 [34]. + + Clarified which error code should be used for inbound server failures + (e.g. DNS failures). (Section 10.5.5). + + + +Fielding, et al. Standards Track [Page 172] + +RFC 2616 HTTP/1.1 June 1999 + + + CREATE had a race that required an Etag be sent when a resource is + first created. (Section 10.2.2). + + Content-Base was deleted from the specification: it was not + implemented widely, and there is no simple, safe way to introduce it + without a robust extension mechanism. In addition, it is used in a + similar, but not identical fashion in MHTML [45]. + + Transfer-coding and message lengths all interact in ways that + required fixing exactly when chunked encoding is used (to allow for + transfer encoding that may not be self delimiting); it was important + to straighten out exactly how message lengths are computed. (Sections + 3.6, 4.4, 7.2.2, 13.5.2, 14.13, 14.16) + + A content-coding of "identity" was introduced, to solve problems + discovered in caching. (section 3.5) + + Quality Values of zero should indicate that "I don't want something" + to allow clients to refuse a representation. (Section 3.9) + + The use and interpretation of HTTP version numbers has been clarified + by RFC 2145. Require proxies to upgrade requests to highest protocol + version they support to deal with problems discovered in HTTP/1.0 + implementations (Section 3.1) + + Charset wildcarding is introduced to avoid explosion of character set + names in accept headers. (Section 14.2) + + A case was missed in the Cache-Control model of HTTP/1.1; s-maxage + was introduced to add this missing case. (Sections 13.4, 14.8, 14.9, + 14.9.3) + + The Cache-Control: max-age directive was not properly defined for + responses. (Section 14.9.3) + + There are situations where a server (especially a proxy) does not + know the full length of a response but is capable of serving a + byterange request. We therefore need a mechanism to allow byteranges + with a content-range not indicating the full length of the message. + (Section 14.16) + + Range request responses would become very verbose if all meta-data + were always returned; by allowing the server to only send needed + headers in a 206 response, this problem can be avoided. (Section + 10.2.7, 13.5.3, and 14.27) + + + + + + +Fielding, et al. Standards Track [Page 173] + +RFC 2616 HTTP/1.1 June 1999 + + + Fix problem with unsatisfiable range requests; there are two cases: + syntactic problems, and range doesn't exist in the document. The 416 + status code was needed to resolve this ambiguity needed to indicate + an error for a byte range request that falls outside of the actual + contents of a document. (Section 10.4.17, 14.16) + + Rewrite of message transmission requirements to make it much harder + for implementors to get it wrong, as the consequences of errors here + can have significant impact on the Internet, and to deal with the + following problems: + + 1. Changing "HTTP/1.1 or later" to "HTTP/1.1", in contexts where + this was incorrectly placing a requirement on the behavior of + an implementation of a future version of HTTP/1.x + + 2. Made it clear that user-agents should retry requests, not + "clients" in general. + + 3. Converted requirements for clients to ignore unexpected 100 + (Continue) responses, and for proxies to forward 100 responses, + into a general requirement for 1xx responses. + + 4. Modified some TCP-specific language, to make it clearer that + non-TCP transports are possible for HTTP. + + 5. Require that the origin server MUST NOT wait for the request + body before it sends a required 100 (Continue) response. + + 6. Allow, rather than require, a server to omit 100 (Continue) if + it has already seen some of the request body. + + 7. Allow servers to defend against denial-of-service attacks and + broken clients. + + This change adds the Expect header and 417 status code. The message + transmission requirements fixes are in sections 8.2, 10.4.18, + 8.1.2.2, 13.11, and 14.20. + + Proxies should be able to add Content-Length when appropriate. + (Section 13.5.2) + + Clean up confusion between 403 and 404 responses. (Section 10.4.4, + 10.4.5, and 10.4.11) + + Warnings could be cached incorrectly, or not updated appropriately. + (Section 13.1.2, 13.2.4, 13.5.2, 13.5.3, 14.9.3, and 14.46) Warning + also needed to be a general header, as PUT or other methods may have + need for it in requests. + + + +Fielding, et al. Standards Track [Page 174] + +RFC 2616 HTTP/1.1 June 1999 + + + Transfer-coding had significant problems, particularly with + interactions with chunked encoding. The solution is that transfer- + codings become as full fledged as content-codings. This involves + adding an IANA registry for transfer-codings (separate from content + codings), a new header field (TE) and enabling trailer headers in the + future. Transfer encoding is a major performance benefit, so it was + worth fixing [39]. TE also solves another, obscure, downward + interoperability problem that could have occurred due to interactions + between authentication trailers, chunked encoding and HTTP/1.0 + clients.(Section 3.6, 3.6.1, and 14.39) + + The PATCH, LINK, UNLINK methods were defined but not commonly + implemented in previous versions of this specification. See RFC 2068 + [33]. + + The Alternates, Content-Version, Derived-From, Link, URI, Public and + Content-Base header fields were defined in previous versions of this + specification, but not commonly implemented. See RFC 2068 [33]. + +20 Index + + Please see the PostScript version of this RFC for the INDEX. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 175] + +RFC 2616 HTTP/1.1 June 1999 + + +21. Full Copyright Statement + + Copyright (C) The Internet Society (1999). All Rights Reserved. + + This document and translations of it may be copied and furnished to + others, and derivative works that comment on or otherwise explain it + or assist in its implementation may be prepared, copied, published + and distributed, in whole or in part, without restriction of any + kind, provided that the above copyright notice and this paragraph are + included on all such copies and derivative works. However, this + document itself may not be modified in any way, such as by removing + the copyright notice or references to the Internet Society or other + Internet organizations, except as needed for the purpose of + developing Internet standards in which case the procedures for + copyrights defined in the Internet Standards process must be + followed, or as required to translate it into languages other than + English. + + The limited permissions granted above are perpetual and will not be + revoked by the Internet Society or its successors or assigns. + + This document and the information contained herein is provided on an + "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING + TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING + BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION + HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF + MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + +Acknowledgement + + Funding for the RFC Editor function is currently provided by the + Internet Society. + + Network Working Group R. Fielding +Request for Comments: 2616 UC Irvine +Obsoletes: 2068 J. Gettys +Category: Standards Track Compaq/W3C + J. Mogul + Compaq + H. Frystyk + W3C/MIT + L. Masinter + Xerox + P. Leach + Microsoft + T. Berners-Lee + W3C/MIT + June 1999 + + + Hypertext Transfer Protocol -- HTTP/1.1 + +Status of this Memo + + This document specifies an Internet standards track protocol for the + Internet community, and requests discussion and suggestions for + improvements. Please refer to the current edition of the "Internet + Official Protocol Standards" (STD 1) for the standardization state + and status of this protocol. Distribution of this memo is unlimited. + +Copyright Notice + + Copyright (C) The Internet Society (1999). All Rights Reserved. + +Abstract + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. It is a generic, stateless, protocol which can be used for + many tasks beyond its use for hypertext, such as name servers and + distributed object management systems, through extension of its + request methods, error codes and headers [47]. A feature of HTTP is + the typing and negotiation of data representation, allowing systems + to be built independently of the data being transferred. + + HTTP has been in use by the World-Wide Web global information + initiative since 1990. This specification defines the protocol + referred to as "HTTP/1.1", and is an update to RFC 2068 [33]. + + + + + + +Fielding, et al. Standards Track [Page 1] + +RFC 2616 HTTP/1.1 June 1999 + + +Table of Contents + + 1 Introduction ...................................................7 + 1.1 Purpose......................................................7 + 1.2 Requirements .................................................8 + 1.3 Terminology ..................................................8 + 1.4 Overall Operation ...........................................12 + 2 Notational Conventions and Generic Grammar ....................14 + 2.1 Augmented BNF ...............................................14 + 2.2 Basic Rules .................................................15 + 3 Protocol Parameters ...........................................17 + 3.1 HTTP Version ................................................17 + 3.2 Uniform Resource Identifiers ................................18 + 3.2.1 General Syntax ...........................................19 + 3.2.2 http URL .................................................19 + 3.2.3 URI Comparison ...........................................20 + 3.3 Date/Time Formats ...........................................20 + 3.3.1 Full Date ................................................20 + 3.3.2 Delta Seconds ............................................21 + 3.4 Character Sets ..............................................21 + 3.4.1 Missing Charset ..........................................22 + 3.5 Content Codings .............................................23 + 3.6 Transfer Codings ............................................24 + 3.6.1 Chunked Transfer Coding ..................................25 + 3.7 Media Types .................................................26 + 3.7.1 Canonicalization and Text Defaults .......................27 + 3.7.2 Multipart Types ..........................................27 + 3.8 Product Tokens ..............................................28 + 3.9 Quality Values ..............................................29 + 3.10 Language Tags ...............................................29 + 3.11 Entity Tags .................................................30 + 3.12 Range Units .................................................30 + 4 HTTP Message ..................................................31 + 4.1 Message Types ...............................................31 + 4.2 Message Headers .............................................31 + 4.3 Message Body ................................................32 + 4.4 Message Length ..............................................33 + 4.5 General Header Fields .......................................34 + 5 Request .......................................................35 + 5.1 Request-Line ................................................35 + 5.1.1 Method ...................................................36 + 5.1.2 Request-URI ..............................................36 + 5.2 The Resource Identified by a Request ........................38 + 5.3 Request Header Fields .......................................38 + 6 Response ......................................................39 + 6.1 Status-Line .................................................39 + 6.1.1 Status Code and Reason Phrase ............................39 + 6.2 Response Header Fields ......................................41 + + + +Fielding, et al. Standards Track [Page 2] + +RFC 2616 HTTP/1.1 June 1999 + + + 7 Entity ........................................................42 + 7.1 Entity Header Fields ........................................42 + 7.2 Entity Body .................................................43 + 7.2.1 Type .....................................................43 + 7.2.2 Entity Length ............................................43 + 8 Connections ...................................................44 + 8.1 Persistent Connections ......................................44 + 8.1.1 Purpose ..................................................44 + 8.1.2 Overall Operation ........................................45 + 8.1.3 Proxy Servers ............................................46 + 8.1.4 Practical Considerations .................................46 + 8.2 Message Transmission Requirements ...........................47 + 8.2.1 Persistent Connections and Flow Control ..................47 + 8.2.2 Monitoring Connections for Error Status Messages .........48 + 8.2.3 Use of the 100 (Continue) Status .........................48 + 8.2.4 Client Behavior if Server Prematurely Closes Connection ..50 + 9 Method Definitions ............................................51 + 9.1 Safe and Idempotent Methods .................................51 + 9.1.1 Safe Methods .............................................51 + 9.1.2 Idempotent Methods .......................................51 + 9.2 OPTIONS .....................................................52 + 9.3 GET .........................................................53 + 9.4 HEAD ........................................................54 + 9.5 POST ........................................................54 + 9.6 PUT .........................................................55 + 9.7 DELETE ......................................................56 + 9.8 TRACE .......................................................56 + 9.9 CONNECT .....................................................57 + 10 Status Code Definitions ......................................57 + 10.1 Informational 1xx ...........................................57 + 10.1.1 100 Continue .............................................58 + 10.1.2 101 Switching Protocols ..................................58 + 10.2 Successful 2xx ..............................................58 + 10.2.1 200 OK ...................................................58 + 10.2.2 201 Created ..............................................59 + 10.2.3 202 Accepted .............................................59 + 10.2.4 203 Non-Authoritative Information ........................59 + 10.2.5 204 No Content ...........................................60 + 10.2.6 205 Reset Content ........................................60 + 10.2.7 206 Partial Content ......................................60 + 10.3 Redirection 3xx .............................................61 + 10.3.1 300 Multiple Choices .....................................61 + 10.3.2 301 Moved Permanently ....................................62 + 10.3.3 302 Found ................................................62 + 10.3.4 303 See Other ............................................63 + 10.3.5 304 Not Modified .........................................63 + 10.3.6 305 Use Proxy ............................................64 + 10.3.7 306 (Unused) .............................................64 + + + +Fielding, et al. Standards Track [Page 3] + +RFC 2616 HTTP/1.1 June 1999 + + + 10.3.8 307 Temporary Redirect ...................................65 + 10.4 Client Error 4xx ............................................65 + 10.4.1 400 Bad Request .........................................65 + 10.4.2 401 Unauthorized ........................................66 + 10.4.3 402 Payment Required ....................................66 + 10.4.4 403 Forbidden ...........................................66 + 10.4.5 404 Not Found ...........................................66 + 10.4.6 405 Method Not Allowed ..................................66 + 10.4.7 406 Not Acceptable ......................................67 + 10.4.8 407 Proxy Authentication Required .......................67 + 10.4.9 408 Request Timeout .....................................67 + 10.4.10 409 Conflict ............................................67 + 10.4.11 410 Gone ................................................68 + 10.4.12 411 Length Required .....................................68 + 10.4.13 412 Precondition Failed .................................68 + 10.4.14 413 Request Entity Too Large ............................69 + 10.4.15 414 Request-URI Too Long ................................69 + 10.4.16 415 Unsupported Media Type ..............................69 + 10.4.17 416 Requested Range Not Satisfiable .....................69 + 10.4.18 417 Expectation Failed ..................................70 + 10.5 Server Error 5xx ............................................70 + 10.5.1 500 Internal Server Error ................................70 + 10.5.2 501 Not Implemented ......................................70 + 10.5.3 502 Bad Gateway ..........................................70 + 10.5.4 503 Service Unavailable ..................................70 + 10.5.5 504 Gateway Timeout ......................................71 + 10.5.6 505 HTTP Version Not Supported ...........................71 + 11 Access Authentication ........................................71 + 12 Content Negotiation ..........................................71 + 12.1 Server-driven Negotiation ...................................72 + 12.2 Agent-driven Negotiation ....................................73 + 12.3 Transparent Negotiation .....................................74 + 13 Caching in HTTP ..............................................74 + 13.1.1 Cache Correctness ........................................75 + 13.1.2 Warnings .................................................76 + 13.1.3 Cache-control Mechanisms .................................77 + 13.1.4 Explicit User Agent Warnings .............................78 + 13.1.5 Exceptions to the Rules and Warnings .....................78 + 13.1.6 Client-controlled Behavior ...............................79 + 13.2 Expiration Model ............................................79 + 13.2.1 Server-Specified Expiration ..............................79 + 13.2.2 Heuristic Expiration .....................................80 + 13.2.3 Age Calculations .........................................80 + 13.2.4 Expiration Calculations ..................................83 + 13.2.5 Disambiguating Expiration Values .........................84 + 13.2.6 Disambiguating Multiple Responses ........................84 + 13.3 Validation Model ............................................85 + 13.3.1 Last-Modified Dates ......................................86 + + + +Fielding, et al. Standards Track [Page 4] + +RFC 2616 HTTP/1.1 June 1999 + + + 13.3.2 Entity Tag Cache Validators ..............................86 + 13.3.3 Weak and Strong Validators ...............................86 + 13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates.89 + 13.3.5 Non-validating Conditionals ..............................90 + 13.4 Response Cacheability .......................................91 + 13.5 Constructing Responses From Caches ..........................92 + 13.5.1 End-to-end and Hop-by-hop Headers ........................92 + 13.5.2 Non-modifiable Headers ...................................92 + 13.5.3 Combining Headers ........................................94 + 13.5.4 Combining Byte Ranges ....................................95 + 13.6 Caching Negotiated Responses ................................95 + 13.7 Shared and Non-Shared Caches ................................96 + 13.8 Errors or Incomplete Response Cache Behavior ................97 + 13.9 Side Effects of GET and HEAD ................................97 + 13.10 Invalidation After Updates or Deletions ...................97 + 13.11 Write-Through Mandatory ...................................98 + 13.12 Cache Replacement .........................................99 + 13.13 History Lists .............................................99 + 14 Header Field Definitions ....................................100 + 14.1 Accept .....................................................100 + 14.2 Accept-Charset .............................................102 + 14.3 Accept-Encoding ............................................102 + 14.4 Accept-Language ............................................104 + 14.5 Accept-Ranges ..............................................105 + 14.6 Age ........................................................106 + 14.7 Allow ......................................................106 + 14.8 Authorization ..............................................107 + 14.9 Cache-Control ..............................................108 + 14.9.1 What is Cacheable .......................................109 + 14.9.2 What May be Stored by Caches ............................110 + 14.9.3 Modifications of the Basic Expiration Mechanism .........111 + 14.9.4 Cache Revalidation and Reload Controls ..................113 + 14.9.5 No-Transform Directive ..................................115 + 14.9.6 Cache Control Extensions ................................116 + 14.10 Connection ...............................................117 + 14.11 Content-Encoding .........................................118 + 14.12 Content-Language .........................................118 + 14.13 Content-Length ...........................................119 + 14.14 Content-Location .........................................120 + 14.15 Content-MD5 ..............................................121 + 14.16 Content-Range ............................................122 + 14.17 Content-Type .............................................124 + 14.18 Date .....................................................124 + 14.18.1 Clockless Origin Server Operation ......................125 + 14.19 ETag .....................................................126 + 14.20 Expect ...................................................126 + 14.21 Expires ..................................................127 + 14.22 From .....................................................128 + + + +Fielding, et al. Standards Track [Page 5] + +RFC 2616 HTTP/1.1 June 1999 + + + 14.23 Host .....................................................128 + 14.24 If-Match .................................................129 + 14.25 If-Modified-Since ........................................130 + 14.26 If-None-Match ............................................132 + 14.27 If-Range .................................................133 + 14.28 If-Unmodified-Since ......................................134 + 14.29 Last-Modified ............................................134 + 14.30 Location .................................................135 + 14.31 Max-Forwards .............................................136 + 14.32 Pragma ...................................................136 + 14.33 Proxy-Authenticate .......................................137 + 14.34 Proxy-Authorization ......................................137 + 14.35 Range ....................................................138 + 14.35.1 Byte Ranges ...........................................138 + 14.35.2 Range Retrieval Requests ..............................139 + 14.36 Referer ..................................................140 + 14.37 Retry-After ..............................................141 + 14.38 Server ...................................................141 + 14.39 TE .......................................................142 + 14.40 Trailer ..................................................143 + 14.41 Transfer-Encoding..........................................143 + 14.42 Upgrade ..................................................144 + 14.43 User-Agent ...............................................145 + 14.44 Vary .....................................................145 + 14.45 Via ......................................................146 + 14.46 Warning ..................................................148 + 14.47 WWW-Authenticate .........................................150 + 15 Security Considerations .......................................150 + 15.1 Personal Information....................................151 + 15.1.1 Abuse of Server Log Information .........................151 + 15.1.2 Transfer of Sensitive Information .......................151 + 15.1.3 Encoding Sensitive Information in URI's .................152 + 15.1.4 Privacy Issues Connected to Accept Headers ..............152 + 15.2 Attacks Based On File and Path Names .......................153 + 15.3 DNS Spoofing ...............................................154 + 15.4 Location Headers and Spoofing ..............................154 + 15.5 Content-Disposition Issues .................................154 + 15.6 Authentication Credentials and Idle Clients ................155 + 15.7 Proxies and Caching ........................................155 + 15.7.1 Denial of Service Attacks on Proxies....................156 + 16 Acknowledgments .............................................156 + 17 References ..................................................158 + 18 Authors' Addresses ..........................................162 + 19 Appendices ..................................................164 + 19.1 Internet Media Type message/http and application/http ......164 + 19.2 Internet Media Type multipart/byteranges ...................165 + 19.3 Tolerant Applications ......................................166 + 19.4 Differences Between HTTP Entities and RFC 2045 Entities ....167 + + + +Fielding, et al. Standards Track [Page 6] + +RFC 2616 HTTP/1.1 June 1999 + + + 19.4.1 MIME-Version ............................................167 + 19.4.2 Conversion to Canonical Form ............................167 + 19.4.3 Conversion of Date Formats ..............................168 + 19.4.4 Introduction of Content-Encoding ........................168 + 19.4.5 No Content-Transfer-Encoding ............................168 + 19.4.6 Introduction of Transfer-Encoding .......................169 + 19.4.7 MHTML and Line Length Limitations .......................169 + 19.5 Additional Features ........................................169 + 19.5.1 Content-Disposition .....................................170 + 19.6 Compatibility with Previous Versions .......................170 + 19.6.1 Changes from HTTP/1.0 ...................................171 + 19.6.2 Compatibility with HTTP/1.0 Persistent Connections ......172 + 19.6.3 Changes from RFC 2068 ...................................172 + 20 Index .......................................................175 + 21 Full Copyright Statement ....................................176 + +1 Introduction + +1.1 Purpose + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. HTTP has been in use by the World-Wide Web global + information initiative since 1990. The first version of HTTP, + referred to as HTTP/0.9, was a simple protocol for raw data transfer + across the Internet. HTTP/1.0, as defined by RFC 1945 [6], improved + the protocol by allowing messages to be in the format of MIME-like + messages, containing metainformation about the data transferred and + modifiers on the request/response semantics. However, HTTP/1.0 does + not sufficiently take into consideration the effects of hierarchical + proxies, caching, the need for persistent connections, or virtual + hosts. In addition, the proliferation of incompletely-implemented + applications calling themselves "HTTP/1.0" has necessitated a + protocol version change in order for two communicating applications + to determine each other's true capabilities. + + This specification defines the protocol referred to as "HTTP/1.1". + This protocol includes more stringent requirements than HTTP/1.0 in + order to ensure reliable implementation of its features. + + Practical information systems require more functionality than simple + retrieval, including search, front-end update, and annotation. HTTP + allows an open-ended set of methods and headers that indicate the + purpose of a request [47]. It builds on the discipline of reference + provided by the Uniform Resource Identifier (URI) [3], as a location + (URL) [4] or name (URN) [20], for indicating the resource to which a + + + + + +Fielding, et al. Standards Track [Page 7] + +RFC 2616 HTTP/1.1 June 1999 + + + method is to be applied. Messages are passed in a format similar to + that used by Internet mail [9] as defined by the Multipurpose + Internet Mail Extensions (MIME) [7]. + + HTTP is also used as a generic protocol for communication between + user agents and proxies/gateways to other Internet systems, including + those supported by the SMTP [16], NNTP [13], FTP [18], Gopher [2], + and WAIS [10] protocols. In this way, HTTP allows basic hypermedia + access to resources available from diverse applications. + +1.2 Requirements + + The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", + "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this + document are to be interpreted as described in RFC 2119 [34]. + + An implementation is not compliant if it fails to satisfy one or more + of the MUST or REQUIRED level requirements for the protocols it + implements. An implementation that satisfies all the MUST or REQUIRED + level and all the SHOULD level requirements for its protocols is said + to be "unconditionally compliant"; one that satisfies all the MUST + level requirements but not all the SHOULD level requirements for its + protocols is said to be "conditionally compliant." + +1.3 Terminology + + This specification uses a number of terms to refer to the roles + played by participants in, and objects of, the HTTP communication. + + connection + A transport layer virtual circuit established between two programs + for the purpose of communication. + + message + The basic unit of HTTP communication, consisting of a structured + sequence of octets matching the syntax defined in section 4 and + transmitted via the connection. + + request + An HTTP request message, as defined in section 5. + + response + An HTTP response message, as defined in section 6. + + + + + + + + +Fielding, et al. Standards Track [Page 8] + +RFC 2616 HTTP/1.1 June 1999 + + + resource + A network data object or service that can be identified by a URI, + as defined in section 3.2. Resources may be available in multiple + representations (e.g. multiple languages, data formats, size, and + resolutions) or vary in other ways. + + entity + The information transferred as the payload of a request or + response. An entity consists of metainformation in the form of + entity-header fields and content in the form of an entity-body, as + described in section 7. + + representation + An entity included with a response that is subject to content + negotiation, as described in section 12. There may exist multiple + representations associated with a particular response status. + + content negotiation + The mechanism for selecting the appropriate representation when + servicing a request, as described in section 12. The + representation of entities in any response can be negotiated + (including error responses). + + variant + A resource may have one, or more than one, representation(s) + associated with it at any given instant. Each of these + representations is termed a `varriant'. Use of the term `variant' + does not necessarily imply that the resource is subject to content + negotiation. + + client + A program that establishes connections for the purpose of sending + requests. + + user agent + The client which initiates a request. These are often browsers, + editors, spiders (web-traversing robots), or other end user tools. + + server + An application program that accepts connections in order to + service requests by sending back responses. Any given program may + be capable of being both a client and a server; our use of these + terms refers only to the role being performed by the program for a + particular connection, rather than to the program's capabilities + in general. Likewise, any server may act as an origin server, + proxy, gateway, or tunnel, switching behavior based on the nature + of each request. + + + + +Fielding, et al. Standards Track [Page 9] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server + The server on which a given resource resides or is to be created. + + proxy + An intermediary program which acts as both a server and a client + for the purpose of making requests on behalf of other clients. + Requests are serviced internally or by passing them on, with + possible translation, to other servers. A proxy MUST implement + both the client and server requirements of this specification. A + "transparent proxy" is a proxy that does not modify the request or + response beyond what is required for proxy authentication and + identification. A "non-transparent proxy" is a proxy that modifies + the request or response in order to provide some added service to + the user agent, such as group annotation services, media type + transformation, protocol reduction, or anonymity filtering. Except + where either transparent or non-transparent behavior is explicitly + stated, the HTTP proxy requirements apply to both types of + proxies. + + gateway + A server which acts as an intermediary for some other server. + Unlike a proxy, a gateway receives requests as if it were the + origin server for the requested resource; the requesting client + may not be aware that it is communicating with a gateway. + + tunnel + An intermediary program which is acting as a blind relay between + two connections. Once active, a tunnel is not considered a party + to the HTTP communication, though the tunnel may have been + initiated by an HTTP request. The tunnel ceases to exist when both + ends of the relayed connections are closed. + + cache + A program's local store of response messages and the subsystem + that controls its message storage, retrieval, and deletion. A + cache stores cacheable responses in order to reduce the response + time and network bandwidth consumption on future, equivalent + requests. Any client or server may include a cache, though a cache + cannot be used by a server that is acting as a tunnel. + + cacheable + A response is cacheable if a cache is allowed to store a copy of + the response message for use in answering subsequent requests. The + rules for determining the cacheability of HTTP responses are + defined in section 13. Even if a resource is cacheable, there may + be additional constraints on whether a cache can use the cached + copy for a particular request. + + + + +Fielding, et al. Standards Track [Page 10] + +RFC 2616 HTTP/1.1 June 1999 + + + first-hand + A response is first-hand if it comes directly and without + unnecessary delay from the origin server, perhaps via one or more + proxies. A response is also first-hand if its validity has just + been checked directly with the origin server. + + explicit expiration time + The time at which the origin server intends that an entity should + no longer be returned by a cache without further validation. + + heuristic expiration time + An expiration time assigned by a cache when no explicit expiration + time is available. + + age + The age of a response is the time since it was sent by, or + successfully validated with, the origin server. + + freshness lifetime + The length of time between the generation of a response and its + expiration time. + + fresh + A response is fresh if its age has not yet exceeded its freshness + lifetime. + + stale + A response is stale if its age has passed its freshness lifetime. + + semantically transparent + A cache behaves in a "semantically transparent" manner, with + respect to a particular response, when its use affects neither the + requesting client nor the origin server, except to improve + performance. When a cache is semantically transparent, the client + receives exactly the same response (except for hop-by-hop headers) + that it would have received had its request been handled directly + by the origin server. + + validator + A protocol element (e.g., an entity tag or a Last-Modified time) + that is used to find out whether a cache entry is an equivalent + copy of an entity. + + upstream/downstream + Upstream and downstream describe the flow of a message: all + messages flow from upstream to downstream. + + + + + +Fielding, et al. Standards Track [Page 11] + +RFC 2616 HTTP/1.1 June 1999 + + + inbound/outbound + Inbound and outbound refer to the request and response paths for + messages: "inbound" means "traveling toward the origin server", + and "outbound" means "traveling toward the user agent" + +1.4 Overall Operation + + The HTTP protocol is a request/response protocol. A client sends a + request to the server in the form of a request method, URI, and + protocol version, followed by a MIME-like message containing request + modifiers, client information, and possible body content over a + connection with a server. The server responds with a status line, + including the message's protocol version and a success or error code, + followed by a MIME-like message containing server information, entity + metainformation, and possible entity-body content. The relationship + between HTTP and MIME is described in appendix 19.4. + + Most HTTP communication is initiated by a user agent and consists of + a request to be applied to a resource on some origin server. In the + simplest case, this may be accomplished via a single connection (v) + between the user agent (UA) and the origin server (O). + + request chain ------------------------> + UA -------------------v------------------- O + <----------------------- response chain + + A more complicated situation occurs when one or more intermediaries + are present in the request/response chain. There are three common + forms of intermediary: proxy, gateway, and tunnel. A proxy is a + forwarding agent, receiving requests for a URI in its absolute form, + rewriting all or part of the message, and forwarding the reformatted + request toward the server identified by the URI. A gateway is a + receiving agent, acting as a layer above some other server(s) and, if + necessary, translating the requests to the underlying server's + protocol. A tunnel acts as a relay point between two connections + without changing the messages; tunnels are used when the + communication needs to pass through an intermediary (such as a + firewall) even when the intermediary cannot understand the contents + of the messages. + + request chain --------------------------------------> + UA -----v----- A -----v----- B -----v----- C -----v----- O + <------------------------------------- response chain + + The figure above shows three intermediaries (A, B, and C) between the + user agent and origin server. A request or response message that + travels the whole chain will pass through four separate connections. + This distinction is important because some HTTP communication options + + + +Fielding, et al. Standards Track [Page 12] + +RFC 2616 HTTP/1.1 June 1999 + + + may apply only to the connection with the nearest, non-tunnel + neighbor, only to the end-points of the chain, or to all connections + along the chain. Although the diagram is linear, each participant may + be engaged in multiple, simultaneous communications. For example, B + may be receiving requests from many clients other than A, and/or + forwarding requests to servers other than C, at the same time that it + is handling A's request. + + Any party to the communication which is not acting as a tunnel may + employ an internal cache for handling requests. The effect of a cache + is that the request/response chain is shortened if one of the + participants along the chain has a cached response applicable to that + request. The following illustrates the resulting chain if B has a + cached copy of an earlier response from O (via C) for a request which + has not been cached by UA or A. + + request chain ----------> + UA -----v----- A -----v----- B - - - - - - C - - - - - - O + <--------- response chain + + Not all responses are usefully cacheable, and some requests may + contain modifiers which place special requirements on cache behavior. + HTTP requirements for cache behavior and cacheable responses are + defined in section 13. + + In fact, there are a wide variety of architectures and configurations + of caches and proxies currently being experimented with or deployed + across the World Wide Web. These systems include national hierarchies + of proxy caches to save transoceanic bandwidth, systems that + broadcast or multicast cache entries, organizations that distribute + subsets of cached data via CD-ROM, and so on. HTTP systems are used + in corporate intranets over high-bandwidth links, and for access via + PDAs with low-power radio links and intermittent connectivity. The + goal of HTTP/1.1 is to support the wide diversity of configurations + already deployed while introducing protocol constructs that meet the + needs of those who build web applications that require high + reliability and, failing that, at least reliable indications of + failure. + + HTTP communication usually takes place over TCP/IP connections. The + default port is TCP 80 [19], but other ports can be used. This does + not preclude HTTP from being implemented on top of any other protocol + on the Internet, or on other networks. HTTP only presumes a reliable + transport; any protocol that provides such guarantees can be used; + the mapping of the HTTP/1.1 request and response structures onto the + transport data units of the protocol in question is outside the scope + of this specification. + + + + +Fielding, et al. Standards Track [Page 13] + +RFC 2616 HTTP/1.1 June 1999 + + + In HTTP/1.0, most implementations used a new connection for each + request/response exchange. In HTTP/1.1, a connection may be used for + one or more request/response exchanges, although connections may be + closed for a variety of reasons (see section 8.1). + +2 Notational Conventions and Generic Grammar + +2.1 Augmented BNF + + All of the mechanisms specified in this document are described in + both prose and an augmented Backus-Naur Form (BNF) similar to that + used by RFC 822 [9]. Implementors will need to be familiar with the + notation in order to understand this specification. The augmented BNF + includes the following constructs: + + name = definition + The name of a rule is simply the name itself (without any + enclosing "<" and ">") and is separated from its definition by the + equal "=" character. White space is only significant in that + indentation of continuation lines is used to indicate a rule + definition that spans more than one line. Certain basic rules are + in uppercase, such as SP, LWS, HT, CRLF, DIGIT, ALPHA, etc. Angle + brackets are used within definitions whenever their presence will + facilitate discerning the use of rule names. + + "literal" + Quotation marks surround literal text. Unless stated otherwise, + the text is case-insensitive. + + rule1 | rule2 + Elements separated by a bar ("|") are alternatives, e.g., "yes | + no" will accept yes or no. + + (rule1 rule2) + Elements enclosed in parentheses are treated as a single element. + Thus, "(elem (foo | bar) elem)" allows the token sequences "elem + foo elem" and "elem bar elem". + + *rule + The character "*" preceding an element indicates repetition. The + full form is "*element" indicating at least and at most + occurrences of element. Default values are 0 and infinity so + that "*(element)" allows any number, including zero; "1*element" + requires at least one; and "1*2element" allows one or two. + + [rule] + Square brackets enclose optional elements; "[foo bar]" is + equivalent to "*1(foo bar)". + + + +Fielding, et al. Standards Track [Page 14] + +RFC 2616 HTTP/1.1 June 1999 + + + N rule + Specific repetition: "(element)" is equivalent to + "*(element)"; that is, exactly occurrences of (element). + Thus 2DIGIT is a 2-digit number, and 3ALPHA is a string of three + alphabetic characters. + + #rule + A construct "#" is defined, similar to "*", for defining lists of + elements. The full form is "#element" indicating at least + and at most elements, each separated by one or more commas + (",") and OPTIONAL linear white space (LWS). This makes the usual + form of lists very easy; a rule such as + ( *LWS element *( *LWS "," *LWS element )) + can be shown as + 1#element + Wherever this construct is used, null elements are allowed, but do + not contribute to the count of elements present. That is, + "(element), , (element) " is permitted, but counts as only two + elements. Therefore, where at least one element is required, at + least one non-null element MUST be present. Default values are 0 + and infinity so that "#element" allows any number, including zero; + "1#element" requires at least one; and "1#2element" allows one or + two. + + ; comment + A semi-colon, set off some distance to the right of rule text, + starts a comment that continues to the end of line. This is a + simple way of including useful notes in parallel with the + specifications. + + implied *LWS + The grammar described by this specification is word-based. Except + where noted otherwise, linear white space (LWS) can be included + between any two adjacent words (token or quoted-string), and + between adjacent words and separators, without changing the + interpretation of a field. At least one delimiter (LWS and/or + + separators) MUST exist between any two tokens (for the definition + of "token" below), since they would otherwise be interpreted as a + single token. + +2.2 Basic Rules + + The following rules are used throughout this specification to + describe basic parsing constructs. The US-ASCII coded character set + is defined by ANSI X3.4-1986 [21]. + + + + + +Fielding, et al. Standards Track [Page 15] + +RFC 2616 HTTP/1.1 June 1999 + + + OCTET = + CHAR = + UPALPHA = + LOALPHA = + ALPHA = UPALPHA | LOALPHA + DIGIT = + CTL = + CR = + LF = + SP = + HT = + <"> = + + HTTP/1.1 defines the sequence CR LF as the end-of-line marker for all + protocol elements except the entity-body (see appendix 19.3 for + tolerant applications). The end-of-line marker within an entity-body + is defined by its associated media type, as described in section 3.7. + + CRLF = CR LF + + HTTP/1.1 header field values can be folded onto multiple lines if the + continuation line begins with a space or horizontal tab. All linear + white space, including folding, has the same semantics as SP. A + recipient MAY replace any linear white space with a single SP before + interpreting the field value or forwarding the message downstream. + + LWS = [CRLF] 1*( SP | HT ) + + The TEXT rule is only used for descriptive field contents and values + that are not intended to be interpreted by the message parser. Words + of *TEXT MAY contain characters from character sets other than ISO- + 8859-1 [22] only when encoded according to the rules of RFC 2047 + [14]. + + TEXT = + + A CRLF is allowed in the definition of TEXT only as part of a header + field continuation. It is expected that the folding LWS will be + replaced with a single SP before interpretation of the TEXT value. + + Hexadecimal numeric characters are used in several protocol elements. + + HEX = "A" | "B" | "C" | "D" | "E" | "F" + | "a" | "b" | "c" | "d" | "e" | "f" | DIGIT + + + + + +Fielding, et al. Standards Track [Page 16] + +RFC 2616 HTTP/1.1 June 1999 + + + Many HTTP/1.1 header field values consist of words separated by LWS + or special characters. These special characters MUST be in a quoted + string to be used within a parameter value (as defined in section + 3.6). + + token = 1* + separators = "(" | ")" | "<" | ">" | "@" + | "," | ";" | ":" | "\" | <"> + | "/" | "[" | "]" | "?" | "=" + | "{" | "}" | SP | HT + + Comments can be included in some HTTP header fields by surrounding + the comment text with parentheses. Comments are only allowed in + fields containing "comment" as part of their field value definition. + In all other fields, parentheses are considered part of the field + value. + + comment = "(" *( ctext | quoted-pair | comment ) ")" + ctext = + + A string of text is parsed as a single word if it is quoted using + double-quote marks. + + quoted-string = ( <"> *(qdtext | quoted-pair ) <"> ) + qdtext = > + + The backslash character ("\") MAY be used as a single-character + quoting mechanism only within quoted-string and comment constructs. + + quoted-pair = "\" CHAR + +3 Protocol Parameters + +3.1 HTTP Version + + HTTP uses a "." numbering scheme to indicate versions + of the protocol. The protocol versioning policy is intended to allow + the sender to indicate the format of a message and its capacity for + understanding further HTTP communication, rather than the features + obtained via that communication. No change is made to the version + number for the addition of message components which do not affect + communication behavior or which only add to extensible field values. + The number is incremented when the changes made to the + protocol add features which do not change the general message parsing + algorithm, but which may add to the message semantics and imply + additional capabilities of the sender. The number is + incremented when the format of a message within the protocol is + changed. See RFC 2145 [36] for a fuller explanation. + + + +Fielding, et al. Standards Track [Page 17] + +RFC 2616 HTTP/1.1 June 1999 + + + The version of an HTTP message is indicated by an HTTP-Version field + in the first line of the message. + + HTTP-Version = "HTTP" "/" 1*DIGIT "." 1*DIGIT + + Note that the major and minor numbers MUST be treated as separate + integers and that each MAY be incremented higher than a single digit. + Thus, HTTP/2.4 is a lower version than HTTP/2.13, which in turn is + lower than HTTP/12.3. Leading zeros MUST be ignored by recipients and + MUST NOT be sent. + + An application that sends a request or response message that includes + HTTP-Version of "HTTP/1.1" MUST be at least conditionally compliant + with this specification. Applications that are at least conditionally + compliant with this specification SHOULD use an HTTP-Version of + "HTTP/1.1" in their messages, and MUST do so for any message that is + not compatible with HTTP/1.0. For more details on when to send + specific HTTP-Version values, see RFC 2145 [36]. + + The HTTP version of an application is the highest HTTP version for + which the application is at least conditionally compliant. + + Proxy and gateway applications need to be careful when forwarding + messages in protocol versions different from that of the application. + Since the protocol version indicates the protocol capability of the + sender, a proxy/gateway MUST NOT send a message with a version + indicator which is greater than its actual version. If a higher + version request is received, the proxy/gateway MUST either downgrade + the request version, or respond with an error, or switch to tunnel + behavior. + + Due to interoperability problems with HTTP/1.0 proxies discovered + since the publication of RFC 2068[33], caching proxies MUST, gateways + MAY, and tunnels MUST NOT upgrade the request to the highest version + they support. The proxy/gateway's response to that request MUST be in + the same major version as the request. + + Note: Converting between versions of HTTP may involve modification + of header fields required or forbidden by the versions involved. + +3.2 Uniform Resource Identifiers + + URIs have been known by many names: WWW addresses, Universal Document + Identifiers, Universal Resource Identifiers [3], and finally the + combination of Uniform Resource Locators (URL) [4] and Names (URN) + [20]. As far as HTTP is concerned, Uniform Resource Identifiers are + simply formatted strings which identify--via name, location, or any + other characteristic--a resource. + + + +Fielding, et al. Standards Track [Page 18] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.1 General Syntax + + URIs in HTTP can be represented in absolute form or relative to some + known base URI [11], depending upon the context of their use. The two + forms are differentiated by the fact that absolute URIs always begin + with a scheme name followed by a colon. For definitive information on + URL syntax and semantics, see "Uniform Resource Identifiers (URI): + Generic Syntax and Semantics," RFC 2396 [42] (which replaces RFCs + 1738 [4] and RFC 1808 [11]). This specification adopts the + definitions of "URI-reference", "absoluteURI", "relativeURI", "port", + "host","abs_path", "rel_path", and "authority" from that + specification. + + The HTTP protocol does not place any a priori limit on the length of + a URI. Servers MUST be able to handle the URI of any resource they + serve, and SHOULD be able to handle URIs of unbounded length if they + provide GET-based forms that could generate such URIs. A server + SHOULD return 414 (Request-URI Too Long) status if a URI is longer + than the server can handle (see section 10.4.15). + + Note: Servers ought to be cautious about depending on URI lengths + above 255 bytes, because some older client or proxy + implementations might not properly support these lengths. + +3.2.2 http URL + + The "http" scheme is used to locate network resources via the HTTP + protocol. This section defines the scheme-specific syntax and + semantics for http URLs. + + http_URL = "http:" "//" host [ ":" port ] [ abs_path [ "?" query ]] + + If the port is empty or not given, port 80 is assumed. The semantics + are that the identified resource is located at the server listening + for TCP connections on that port of that host, and the Request-URI + for the resource is abs_path (section 5.1.2). The use of IP addresses + in URLs SHOULD be avoided whenever possible (see RFC 1900 [24]). If + the abs_path is not present in the URL, it MUST be given as "/" when + used as a Request-URI for a resource (section 5.1.2). If a proxy + receives a host name which is not a fully qualified domain name, it + MAY add its domain to the host name it received. If a proxy receives + a fully qualified domain name, the proxy MUST NOT change the host + name. + + + + + + + + +Fielding, et al. Standards Track [Page 19] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.3 URI Comparison + + When comparing two URIs to decide if they match or not, a client + SHOULD use a case-sensitive octet-by-octet comparison of the entire + URIs, with these exceptions: + + - A port that is empty or not given is equivalent to the default + port for that URI-reference; + + - Comparisons of host names MUST be case-insensitive; + + - Comparisons of scheme names MUST be case-insensitive; + + - An empty abs_path is equivalent to an abs_path of "/". + + Characters other than those in the "reserved" and "unsafe" sets (see + RFC 2396 [42]) are equivalent to their ""%" HEX HEX" encoding. + + For example, the following three URIs are equivalent: + + http://abc.com:80/~smith/home.html + http://ABC.com/%7Esmith/home.html + http://ABC.com:/%7esmith/home.html + +3.3 Date/Time Formats + +3.3.1 Full Date + + HTTP applications have historically allowed three different formats + for the representation of date/time stamps: + + Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123 + Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036 + Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format + + The first format is preferred as an Internet standard and represents + a fixed-length subset of that defined by RFC 1123 [8] (an update to + RFC 822 [9]). The second format is in common use, but is based on the + obsolete RFC 850 [12] date format and lacks a four-digit year. + HTTP/1.1 clients and servers that parse the date value MUST accept + all three formats (for compatibility with HTTP/1.0), though they MUST + only generate the RFC 1123 format for representing HTTP-date values + in header fields. See section 19.3 for further information. + + Note: Recipients of date values are encouraged to be robust in + accepting date values that may have been sent by non-HTTP + applications, as is sometimes the case when retrieving or posting + messages via proxies/gateways to SMTP or NNTP. + + + +Fielding, et al. Standards Track [Page 20] + +RFC 2616 HTTP/1.1 June 1999 + + + All HTTP date/time stamps MUST be represented in Greenwich Mean Time + (GMT), without exception. For the purposes of HTTP, GMT is exactly + equal to UTC (Coordinated Universal Time). This is indicated in the + first two formats by the inclusion of "GMT" as the three-letter + abbreviation for time zone, and MUST be assumed when reading the + asctime format. HTTP-date is case sensitive and MUST NOT include + additional LWS beyond that specifically included as SP in the + grammar. + + HTTP-date = rfc1123-date | rfc850-date | asctime-date + rfc1123-date = wkday "," SP date1 SP time SP "GMT" + rfc850-date = weekday "," SP date2 SP time SP "GMT" + asctime-date = wkday SP date3 SP time SP 4DIGIT + date1 = 2DIGIT SP month SP 4DIGIT + ; day month year (e.g., 02 Jun 1982) + date2 = 2DIGIT "-" month "-" 2DIGIT + ; day-month-year (e.g., 02-Jun-82) + date3 = month SP ( 2DIGIT | ( SP 1DIGIT )) + ; month day (e.g., Jun 2) + time = 2DIGIT ":" 2DIGIT ":" 2DIGIT + ; 00:00:00 - 23:59:59 + wkday = "Mon" | "Tue" | "Wed" + | "Thu" | "Fri" | "Sat" | "Sun" + weekday = "Monday" | "Tuesday" | "Wednesday" + | "Thursday" | "Friday" | "Saturday" | "Sunday" + month = "Jan" | "Feb" | "Mar" | "Apr" + | "May" | "Jun" | "Jul" | "Aug" + | "Sep" | "Oct" | "Nov" | "Dec" + + Note: HTTP requirements for the date/time stamp format apply only + to their usage within the protocol stream. Clients and servers are + not required to use these formats for user presentation, request + logging, etc. + +3.3.2 Delta Seconds + + Some HTTP header fields allow a time value to be specified as an + integer number of seconds, represented in decimal, after the time + that the message was received. + + delta-seconds = 1*DIGIT + +3.4 Character Sets + + HTTP uses the same definition of the term "character set" as that + described for MIME: + + + + + +Fielding, et al. Standards Track [Page 21] + +RFC 2616 HTTP/1.1 June 1999 + + + The term "character set" is used in this document to refer to a + method used with one or more tables to convert a sequence of octets + into a sequence of characters. Note that unconditional conversion in + the other direction is not required, in that not all characters may + be available in a given character set and a character set may provide + more than one sequence of octets to represent a particular character. + This definition is intended to allow various kinds of character + encoding, from simple single-table mappings such as US-ASCII to + complex table switching methods such as those that use ISO-2022's + techniques. However, the definition associated with a MIME character + set name MUST fully specify the mapping to be performed from octets + to characters. In particular, use of external profiling information + to determine the exact mapping is not permitted. + + Note: This use of the term "character set" is more commonly + referred to as a "character encoding." However, since HTTP and + MIME share the same registry, it is important that the terminology + also be shared. + + HTTP character sets are identified by case-insensitive tokens. The + complete set of tokens is defined by the IANA Character Set registry + [19]. + + charset = token + + Although HTTP allows an arbitrary token to be used as a charset + value, any token that has a predefined value within the IANA + Character Set registry [19] MUST represent the character set defined + by that registry. Applications SHOULD limit their use of character + sets to those defined by the IANA registry. + + Implementors should be aware of IETF character set requirements [38] + [41]. + +3.4.1 Missing Charset + + Some HTTP/1.0 software has interpreted a Content-Type header without + charset parameter incorrectly to mean "recipient should guess." + Senders wishing to defeat this behavior MAY include a charset + parameter even when the charset is ISO-8859-1 and SHOULD do so when + it is known that it will not confuse the recipient. + + Unfortunately, some older HTTP/1.0 clients did not deal properly with + an explicit charset parameter. HTTP/1.1 recipients MUST respect the + charset label provided by the sender; and those user agents that have + a provision to "guess" a charset MUST use the charset from the + + + + + +Fielding, et al. Standards Track [Page 22] + +RFC 2616 HTTP/1.1 June 1999 + + + content-type field if they support that charset, rather than the + recipient's preference, when initially displaying a document. See + section 3.7.1. + +3.5 Content Codings + + Content coding values indicate an encoding transformation that has + been or can be applied to an entity. Content codings are primarily + used to allow a document to be compressed or otherwise usefully + transformed without losing the identity of its underlying media type + and without loss of information. Frequently, the entity is stored in + coded form, transmitted directly, and only decoded by the recipient. + + content-coding = token + + All content-coding values are case-insensitive. HTTP/1.1 uses + content-coding values in the Accept-Encoding (section 14.3) and + Content-Encoding (section 14.11) header fields. Although the value + describes the content-coding, what is more important is that it + indicates what decoding mechanism will be required to remove the + encoding. + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + content-coding value tokens. Initially, the registry contains the + following tokens: + + gzip An encoding format produced by the file compression program + "gzip" (GNU zip) as described in RFC 1952 [25]. This format is a + Lempel-Ziv coding (LZ77) with a 32 bit CRC. + + compress + The encoding format produced by the common UNIX file compression + program "compress". This format is an adaptive Lempel-Ziv-Welch + coding (LZW). + + Use of program names for the identification of encoding formats + is not desirable and is discouraged for future encodings. Their + use here is representative of historical practice, not good + design. For compatibility with previous implementations of HTTP, + applications SHOULD consider "x-gzip" and "x-compress" to be + equivalent to "gzip" and "compress" respectively. + + deflate + The "zlib" format defined in RFC 1950 [31] in combination with + the "deflate" compression mechanism described in RFC 1951 [29]. + + + + + + +Fielding, et al. Standards Track [Page 23] + +RFC 2616 HTTP/1.1 June 1999 + + + identity + The default (identity) encoding; the use of no transformation + whatsoever. This content-coding is used only in the Accept- + Encoding header, and SHOULD NOT be used in the Content-Encoding + header. + + New content-coding value tokens SHOULD be registered; to allow + interoperability between clients and servers, specifications of the + content coding algorithms needed to implement a new value SHOULD be + publicly available and adequate for independent implementation, and + conform to the purpose of content coding defined in this section. + +3.6 Transfer Codings + + Transfer-coding values are used to indicate an encoding + transformation that has been, can be, or may need to be applied to an + entity-body in order to ensure "safe transport" through the network. + This differs from a content coding in that the transfer-coding is a + property of the message, not of the original entity. + + transfer-coding = "chunked" | transfer-extension + transfer-extension = token *( ";" parameter ) + + Parameters are in the form of attribute/value pairs. + + parameter = attribute "=" value + attribute = token + value = token | quoted-string + + All transfer-coding values are case-insensitive. HTTP/1.1 uses + transfer-coding values in the TE header field (section 14.39) and in + the Transfer-Encoding header field (section 14.41). + + Whenever a transfer-coding is applied to a message-body, the set of + transfer-codings MUST include "chunked", unless the message is + terminated by closing the connection. When the "chunked" transfer- + coding is used, it MUST be the last transfer-coding applied to the + message-body. The "chunked" transfer-coding MUST NOT be applied more + than once to a message-body. These rules allow the recipient to + determine the transfer-length of the message (section 4.4). + + Transfer-codings are analogous to the Content-Transfer-Encoding + values of MIME [7], which were designed to enable safe transport of + binary data over a 7-bit transport service. However, safe transport + has a different focus for an 8bit-clean transfer protocol. In HTTP, + the only unsafe characteristic of message-bodies is the difficulty in + determining the exact body length (section 7.2.2), or the desire to + encrypt data over a shared transport. + + + +Fielding, et al. Standards Track [Page 24] + +RFC 2616 HTTP/1.1 June 1999 + + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + transfer-coding value tokens. Initially, the registry contains the + following tokens: "chunked" (section 3.6.1), "identity" (section + 3.6.2), "gzip" (section 3.5), "compress" (section 3.5), and "deflate" + (section 3.5). + + New transfer-coding value tokens SHOULD be registered in the same way + as new content-coding value tokens (section 3.5). + + A server which receives an entity-body with a transfer-coding it does + not understand SHOULD return 501 (Unimplemented), and close the + connection. A server MUST NOT send transfer-codings to an HTTP/1.0 + client. + +3.6.1 Chunked Transfer Coding + + The chunked encoding modifies the body of a message in order to + transfer it as a series of chunks, each with its own size indicator, + followed by an OPTIONAL trailer containing entity-header fields. This + allows dynamically produced content to be transferred along with the + information necessary for the recipient to verify that it has + received the full message. + + Chunked-Body = *chunk + last-chunk + trailer + CRLF + + chunk = chunk-size [ chunk-extension ] CRLF + chunk-data CRLF + chunk-size = 1*HEX + last-chunk = 1*("0") [ chunk-extension ] CRLF + + chunk-extension= *( ";" chunk-ext-name [ "=" chunk-ext-val ] ) + chunk-ext-name = token + chunk-ext-val = token | quoted-string + chunk-data = chunk-size(OCTET) + trailer = *(entity-header CRLF) + + The chunk-size field is a string of hex digits indicating the size of + the chunk. The chunked encoding is ended by any chunk whose size is + zero, followed by the trailer, which is terminated by an empty line. + + The trailer allows the sender to include additional HTTP header + fields at the end of the message. The Trailer header field can be + used to indicate which header fields are included in a trailer (see + section 14.40). + + + + +Fielding, et al. Standards Track [Page 25] + +RFC 2616 HTTP/1.1 June 1999 + + + A server using chunked transfer-coding in a response MUST NOT use the + trailer for any header fields unless at least one of the following is + true: + + a)the request included a TE header field that indicates "trailers" is + acceptable in the transfer-coding of the response, as described in + section 14.39; or, + + b)the server is the origin server for the response, the trailer + fields consist entirely of optional metadata, and the recipient + could use the message (in a manner acceptable to the origin server) + without receiving this metadata. In other words, the origin server + is willing to accept the possibility that the trailer fields might + be silently discarded along the path to the client. + + This requirement prevents an interoperability failure when the + message is being received by an HTTP/1.1 (or later) proxy and + forwarded to an HTTP/1.0 recipient. It avoids a situation where + compliance with the protocol would have necessitated a possibly + infinite buffer on the proxy. + + An example process for decoding a Chunked-Body is presented in + appendix 19.4.6. + + All HTTP/1.1 applications MUST be able to receive and decode the + "chunked" transfer-coding, and MUST ignore chunk-extension extensions + they do not understand. + +3.7 Media Types + + HTTP uses Internet Media Types [17] in the Content-Type (section + 14.17) and Accept (section 14.1) header fields in order to provide + open and extensible data typing and type negotiation. + + media-type = type "/" subtype *( ";" parameter ) + type = token + subtype = token + + Parameters MAY follow the type/subtype in the form of attribute/value + pairs (as defined in section 3.6). + + The type, subtype, and parameter attribute names are case- + insensitive. Parameter values might or might not be case-sensitive, + depending on the semantics of the parameter name. Linear white space + (LWS) MUST NOT be used between the type and subtype, nor between an + attribute and its value. The presence or absence of a parameter might + be significant to the processing of a media-type, depending on its + definition within the media type registry. + + + +Fielding, et al. Standards Track [Page 26] + +RFC 2616 HTTP/1.1 June 1999 + + + Note that some older HTTP applications do not recognize media type + parameters. When sending data to older HTTP applications, + implementations SHOULD only use media type parameters when they are + required by that type/subtype definition. + + Media-type values are registered with the Internet Assigned Number + Authority (IANA [19]). The media type registration process is + outlined in RFC 1590 [17]. Use of non-registered media types is + discouraged. + +3.7.1 Canonicalization and Text Defaults + + Internet media types are registered with a canonical form. An + entity-body transferred via HTTP messages MUST be represented in the + appropriate canonical form prior to its transmission except for + "text" types, as defined in the next paragraph. + + When in canonical form, media subtypes of the "text" type use CRLF as + the text line break. HTTP relaxes this requirement and allows the + transport of text media with plain CR or LF alone representing a line + break when it is done consistently for an entire entity-body. HTTP + applications MUST accept CRLF, bare CR, and bare LF as being + representative of a line break in text media received via HTTP. In + addition, if the text is represented in a character set that does not + use octets 13 and 10 for CR and LF respectively, as is the case for + some multi-byte character sets, HTTP allows the use of whatever octet + sequences are defined by that character set to represent the + equivalent of CR and LF for line breaks. This flexibility regarding + line breaks applies only to text media in the entity-body; a bare CR + or LF MUST NOT be substituted for CRLF within any of the HTTP control + structures (such as header fields and multipart boundaries). + + If an entity-body is encoded with a content-coding, the underlying + data MUST be in a form defined above prior to being encoded. + + The "charset" parameter is used with some media types to define the + character set (section 3.4) of the data. When no explicit charset + parameter is provided by the sender, media subtypes of the "text" + type are defined to have a default charset value of "ISO-8859-1" when + received via HTTP. Data in character sets other than "ISO-8859-1" or + its subsets MUST be labeled with an appropriate charset value. See + section 3.4.1 for compatibility problems. + +3.7.2 Multipart Types + + MIME provides for a number of "multipart" types -- encapsulations of + one or more entities within a single message-body. All multipart + types share a common syntax, as defined in section 5.1.1 of RFC 2046 + + + +Fielding, et al. Standards Track [Page 27] + +RFC 2616 HTTP/1.1 June 1999 + + + [40], and MUST include a boundary parameter as part of the media type + value. The message body is itself a protocol element and MUST + therefore use only CRLF to represent line breaks between body-parts. + Unlike in RFC 2046, the epilogue of any multipart message MUST be + empty; HTTP applications MUST NOT transmit the epilogue (even if the + original multipart contains an epilogue). These restrictions exist in + order to preserve the self-delimiting nature of a multipart message- + body, wherein the "end" of the message-body is indicated by the + ending multipart boundary. + + In general, HTTP treats a multipart message-body no differently than + any other media type: strictly as payload. The one exception is the + "multipart/byteranges" type (appendix 19.2) when it appears in a 206 + (Partial Content) response, which will be interpreted by some HTTP + caching mechanisms as described in sections 13.5.4 and 14.16. In all + other cases, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + The MIME header fields within each body-part of a multipart message- + body do not have any significance to HTTP beyond that defined by + their MIME semantics. + + In general, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + If an application receives an unrecognized multipart subtype, the + application MUST treat it as being equivalent to "multipart/mixed". + + Note: The "multipart/form-data" type has been specifically defined + for carrying form data suitable for processing via the POST + request method, as described in RFC 1867 [15]. + +3.8 Product Tokens + + Product tokens are used to allow communicating applications to + identify themselves by software name and version. Most fields using + product tokens also allow sub-products which form a significant part + of the application to be listed, separated by white space. By + convention, the products are listed in order of their significance + for identifying the application. + + product = token ["/" product-version] + product-version = token + + Examples: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + Server: Apache/0.8.4 + + + + + +Fielding, et al. Standards Track [Page 28] + +RFC 2616 HTTP/1.1 June 1999 + + + Product tokens SHOULD be short and to the point. They MUST NOT be + used for advertising or other non-essential information. Although any + token character MAY appear in a product-version, this token SHOULD + only be used for a version identifier (i.e., successive versions of + the same product SHOULD only differ in the product-version portion of + the product value). + +3.9 Quality Values + + HTTP content negotiation (section 12) uses short "floating point" + numbers to indicate the relative importance ("weight") of various + negotiable parameters. A weight is normalized to a real number in + the range 0 through 1, where 0 is the minimum and 1 the maximum + value. If a parameter has a quality value of 0, then content with + this parameter is `not acceptable' for the client. HTTP/1.1 + applications MUST NOT generate more than three digits after the + decimal point. User configuration of these values SHOULD also be + limited in this fashion. + + qvalue = ( "0" [ "." 0*3DIGIT ] ) + | ( "1" [ "." 0*3("0") ] ) + + "Quality values" is a misnomer, since these values merely represent + relative degradation in desired quality. + +3.10 Language Tags + + A language tag identifies a natural language spoken, written, or + otherwise conveyed by human beings for communication of information + to other human beings. Computer languages are explicitly excluded. + HTTP uses language tags within the Accept-Language and Content- + Language fields. + + The syntax and registry of HTTP language tags is the same as that + defined by RFC 1766 [1]. In summary, a language tag is composed of 1 + or more parts: A primary language tag and a possibly empty series of + subtags: + + language-tag = primary-tag *( "-" subtag ) + primary-tag = 1*8ALPHA + subtag = 1*8ALPHA + + White space is not allowed within the tag and all tags are case- + insensitive. The name space of language tags is administered by the + IANA. Example tags include: + + en, en-US, en-cockney, i-cherokee, x-pig-latin + + + + +Fielding, et al. Standards Track [Page 29] + +RFC 2616 HTTP/1.1 June 1999 + + + where any two-letter primary-tag is an ISO-639 language abbreviation + and any two-letter initial subtag is an ISO-3166 country code. (The + last three tags above are not registered tags; all but the last are + examples of tags which could be registered in future.) + +3.11 Entity Tags + + Entity tags are used for comparing two or more entities from the same + requested resource. HTTP/1.1 uses entity tags in the ETag (section + 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and + If-Range (section 14.27) header fields. The definition of how they + are used and compared as cache validators is in section 13.3.3. An + entity tag consists of an opaque quoted string, possibly prefixed by + a weakness indicator. + + entity-tag = [ weak ] opaque-tag + weak = "W/" + opaque-tag = quoted-string + + A "strong entity tag" MAY be shared by two entities of a resource + only if they are equivalent by octet equality. + + A "weak entity tag," indicated by the "W/" prefix, MAY be shared by + two entities of a resource only if the entities are equivalent and + could be substituted for each other with no significant change in + semantics. A weak entity tag can only be used for weak comparison. + + An entity tag MUST be unique across all versions of all entities + associated with a particular resource. A given entity tag value MAY + be used for entities obtained by requests on different URIs. The use + of the same entity tag value in conjunction with entities obtained by + requests on different URIs does not imply the equivalence of those + entities. + +3.12 Range Units + + HTTP/1.1 allows a client to request that only part (a range of) the + response entity be included within the response. HTTP/1.1 uses range + units in the Range (section 14.35) and Content-Range (section 14.16) + header fields. An entity can be broken down into subranges according + to various structural units. + + range-unit = bytes-unit | other-range-unit + bytes-unit = "bytes" + other-range-unit = token + + The only range unit defined by HTTP/1.1 is "bytes". HTTP/1.1 + implementations MAY ignore ranges specified using other units. + + + +Fielding, et al. Standards Track [Page 30] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 has been designed to allow implementations of applications + that do not depend on knowledge of ranges. + +4 HTTP Message + +4.1 Message Types + + HTTP messages consist of requests from client to server and responses + from server to client. + + HTTP-message = Request | Response ; HTTP/1.1 messages + + Request (section 5) and Response (section 6) messages use the generic + message format of RFC 822 [9] for transferring entities (the payload + of the message). Both types of message consist of a start-line, zero + or more header fields (also known as "headers"), an empty line (i.e., + a line with nothing preceding the CRLF) indicating the end of the + header fields, and possibly a message-body. + + generic-message = start-line + *(message-header CRLF) + CRLF + [ message-body ] + start-line = Request-Line | Status-Line + + In the interest of robustness, servers SHOULD ignore any empty + line(s) received where a Request-Line is expected. In other words, if + the server is reading the protocol stream at the beginning of a + message and receives a CRLF first, it should ignore the CRLF. + + Certain buggy HTTP/1.0 client implementations generate extra CRLF's + after a POST request. To restate what is explicitly forbidden by the + BNF, an HTTP/1.1 client MUST NOT preface or follow a request with an + extra CRLF. + +4.2 Message Headers + + HTTP header fields, which include general-header (section 4.5), + request-header (section 5.3), response-header (section 6.2), and + entity-header (section 7.1) fields, follow the same generic format as + that given in Section 3.1 of RFC 822 [9]. Each header field consists + of a name followed by a colon (":") and the field value. Field names + are case-insensitive. The field value MAY be preceded by any amount + of LWS, though a single SP is preferred. Header fields can be + extended over multiple lines by preceding each extra line with at + least one SP or HT. Applications ought to follow "common form", where + one is known or indicated, when generating HTTP constructs, since + there might exist some implementations that fail to accept anything + + + +Fielding, et al. Standards Track [Page 31] + +RFC 2616 HTTP/1.1 June 1999 + + + beyond the common forms. + + message-header = field-name ":" [ field-value ] + field-name = token + field-value = *( field-content | LWS ) + field-content = + + The field-content does not include any leading or trailing LWS: + linear white space occurring before the first non-whitespace + character of the field-value or after the last non-whitespace + character of the field-value. Such leading or trailing LWS MAY be + removed without changing the semantics of the field value. Any LWS + that occurs between field-content MAY be replaced with a single SP + before interpreting the field value or forwarding the message + downstream. + + The order in which header fields with differing field names are + received is not significant. However, it is "good practice" to send + general-header fields first, followed by request-header or response- + header fields, and ending with the entity-header fields. + + Multiple message-header fields with the same field-name MAY be + present in a message if and only if the entire field-value for that + header field is defined as a comma-separated list [i.e., #(values)]. + It MUST be possible to combine the multiple header fields into one + "field-name: field-value" pair, without changing the semantics of the + message, by appending each subsequent field-value to the first, each + separated by a comma. The order in which header fields with the same + field-name are received is therefore significant to the + interpretation of the combined field value, and thus a proxy MUST NOT + change the order of these field values when a message is forwarded. + +4.3 Message Body + + The message-body (if any) of an HTTP message is used to carry the + entity-body associated with the request or response. The message-body + differs from the entity-body only when a transfer-coding has been + applied, as indicated by the Transfer-Encoding header field (section + 14.41). + + message-body = entity-body + | + + Transfer-Encoding MUST be used to indicate any transfer-codings + applied by an application to ensure safe and proper transfer of the + message. Transfer-Encoding is a property of the message, not of the + + + +Fielding, et al. Standards Track [Page 32] + +RFC 2616 HTTP/1.1 June 1999 + + + entity, and thus MAY be added or removed by any application along the + request/response chain. (However, section 3.6 places restrictions on + when certain transfer-codings may be used.) + + The rules for when a message-body is allowed in a message differ for + requests and responses. + + The presence of a message-body in a request is signaled by the + inclusion of a Content-Length or Transfer-Encoding header field in + the request's message-headers. A message-body MUST NOT be included in + a request if the specification of the request method (section 5.1.1) + does not allow sending an entity-body in requests. A server SHOULD + read and forward a message-body on any request; if the request method + does not include defined semantics for an entity-body, then the + message-body SHOULD be ignored when handling the request. + + For response messages, whether or not a message-body is included with + a message is dependent on both the request method and the response + status code (section 6.1.1). All responses to the HEAD request method + MUST NOT include a message-body, even though the presence of entity- + header fields might lead one to believe they do. All 1xx + (informational), 204 (no content), and 304 (not modified) responses + MUST NOT include a message-body. All other responses do include a + message-body, although it MAY be of zero length. + +4.4 Message Length + + The transfer-length of a message is the length of the message-body as + it appears in the message; that is, after any transfer-codings have + been applied. When a message-body is included with a message, the + transfer-length of that body is determined by one of the following + (in order of precedence): + + 1.Any response message which "MUST NOT" include a message-body (such + as the 1xx, 204, and 304 responses and any response to a HEAD + request) is always terminated by the first empty line after the + header fields, regardless of the entity-header fields present in + the message. + + 2.If a Transfer-Encoding header field (section 14.41) is present and + has any value other than "identity", then the transfer-length is + defined by use of the "chunked" transfer-coding (section 3.6), + unless the message is terminated by closing the connection. + + 3.If a Content-Length header field (section 14.13) is present, its + decimal value in OCTETs represents both the entity-length and the + transfer-length. The Content-Length header field MUST NOT be sent + if these two lengths are different (i.e., if a Transfer-Encoding + + + +Fielding, et al. Standards Track [Page 33] + +RFC 2616 HTTP/1.1 June 1999 + + + header field is present). If a message is received with both a + Transfer-Encoding header field and a Content-Length header field, + the latter MUST be ignored. + + 4.If the message uses the media type "multipart/byteranges", and the + ransfer-length is not otherwise specified, then this self- + elimiting media type defines the transfer-length. This media type + UST NOT be used unless the sender knows that the recipient can arse + it; the presence in a request of a Range header with ultiple byte- + range specifiers from a 1.1 client implies that the lient can parse + multipart/byteranges responses. + + A range header might be forwarded by a 1.0 proxy that does not + understand multipart/byteranges; in this case the server MUST + delimit the message using methods defined in items 1,3 or 5 of + this section. + + 5.By the server closing the connection. (Closing the connection + cannot be used to indicate the end of a request body, since that + would leave no possibility for the server to send back a response.) + + For compatibility with HTTP/1.0 applications, HTTP/1.1 requests + containing a message-body MUST include a valid Content-Length header + field unless the server is known to be HTTP/1.1 compliant. If a + request contains a message-body and a Content-Length is not given, + the server SHOULD respond with 400 (bad request) if it cannot + determine the length of the message, or with 411 (length required) if + it wishes to insist on receiving a valid Content-Length. + + All HTTP/1.1 applications that receive entities MUST accept the + "chunked" transfer-coding (section 3.6), thus allowing this mechanism + to be used for messages when the message length cannot be determined + in advance. + + Messages MUST NOT include both a Content-Length header field and a + non-identity transfer-coding. If the message does include a non- + identity transfer-coding, the Content-Length MUST be ignored. + + When a Content-Length is given in a message where a message-body is + allowed, its field value MUST exactly match the number of OCTETs in + the message-body. HTTP/1.1 user agents MUST notify the user when an + invalid length is received and detected. + +4.5 General Header Fields + + There are a few header fields which have general applicability for + both request and response messages, but which do not apply to the + entity being transferred. These header fields apply only to the + + + +Fielding, et al. Standards Track [Page 34] + +RFC 2616 HTTP/1.1 June 1999 + + + message being transmitted. + + general-header = Cache-Control ; Section 14.9 + | Connection ; Section 14.10 + | Date ; Section 14.18 + | Pragma ; Section 14.32 + | Trailer ; Section 14.40 + | Transfer-Encoding ; Section 14.41 + | Upgrade ; Section 14.42 + | Via ; Section 14.45 + | Warning ; Section 14.46 + + General-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields may be given the semantics of general + header fields if all parties in the communication recognize them to + be general-header fields. Unrecognized header fields are treated as + entity-header fields. + +5 Request + + A request message from a client to a server includes, within the + first line of that message, the method to be applied to the resource, + the identifier of the resource, and the protocol version in use. + + Request = Request-Line ; Section 5.1 + *(( general-header ; Section 4.5 + | request-header ; Section 5.3 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 4.3 + +5.1 Request-Line + + The Request-Line begins with a method token, followed by the + Request-URI and the protocol version, and ending with CRLF. The + elements are separated by SP characters. No CR or LF is allowed + except in the final CRLF sequence. + + Request-Line = Method SP Request-URI SP HTTP-Version CRLF + + + + + + + + + + + +Fielding, et al. Standards Track [Page 35] + +RFC 2616 HTTP/1.1 June 1999 + + +5.1.1 Method + + The Method token indicates the method to be performed on the + resource identified by the Request-URI. The method is case-sensitive. + + Method = "OPTIONS" ; Section 9.2 + | "GET" ; Section 9.3 + | "HEAD" ; Section 9.4 + | "POST" ; Section 9.5 + | "PUT" ; Section 9.6 + | "DELETE" ; Section 9.7 + | "TRACE" ; Section 9.8 + | "CONNECT" ; Section 9.9 + | extension-method + extension-method = token + + The list of methods allowed by a resource can be specified in an + Allow header field (section 14.7). The return code of the response + always notifies the client whether a method is currently allowed on a + resource, since the set of allowed methods can change dynamically. An + origin server SHOULD return the status code 405 (Method Not Allowed) + if the method is known by the origin server but not allowed for the + requested resource, and 501 (Not Implemented) if the method is + unrecognized or not implemented by the origin server. The methods GET + and HEAD MUST be supported by all general-purpose servers. All other + methods are OPTIONAL; however, if the above methods are implemented, + they MUST be implemented with the same semantics as those specified + in section 9. + +5.1.2 Request-URI + + The Request-URI is a Uniform Resource Identifier (section 3.2) and + identifies the resource upon which to apply the request. + + Request-URI = "*" | absoluteURI | abs_path | authority + + The four options for Request-URI are dependent on the nature of the + request. The asterisk "*" means that the request does not apply to a + particular resource, but to the server itself, and is only allowed + when the method used does not necessarily apply to a resource. One + example would be + + OPTIONS * HTTP/1.1 + + The absoluteURI form is REQUIRED when the request is being made to a + proxy. The proxy is requested to forward the request or service it + from a valid cache, and return the response. Note that the proxy MAY + forward the request on to another proxy or directly to the server + + + +Fielding, et al. Standards Track [Page 36] + +RFC 2616 HTTP/1.1 June 1999 + + + specified by the absoluteURI. In order to avoid request loops, a + proxy MUST be able to recognize all of its server names, including + any aliases, local variations, and the numeric IP address. An example + Request-Line would be: + + GET http://www.w3.org/pub/WWW/TheProject.html HTTP/1.1 + + To allow for transition to absoluteURIs in all requests in future + versions of HTTP, all HTTP/1.1 servers MUST accept the absoluteURI + form in requests, even though HTTP/1.1 clients will only generate + them in requests to proxies. + + The authority form is only used by the CONNECT method (section 9.9). + + The most common form of Request-URI is that used to identify a + resource on an origin server or gateway. In this case the absolute + path of the URI MUST be transmitted (see section 3.2.1, abs_path) as + the Request-URI, and the network location of the URI (authority) MUST + be transmitted in a Host header field. For example, a client wishing + to retrieve the resource above directly from the origin server would + create a TCP connection to port 80 of the host "www.w3.org" and send + the lines: + + GET /pub/WWW/TheProject.html HTTP/1.1 + Host: www.w3.org + + followed by the remainder of the Request. Note that the absolute path + cannot be empty; if none is present in the original URI, it MUST be + given as "/" (the server root). + + The Request-URI is transmitted in the format specified in section + 3.2.1. If the Request-URI is encoded using the "% HEX HEX" encoding + [42], the origin server MUST decode the Request-URI in order to + properly interpret the request. Servers SHOULD respond to invalid + Request-URIs with an appropriate status code. + + A transparent proxy MUST NOT rewrite the "abs_path" part of the + received Request-URI when forwarding it to the next inbound server, + except as noted above to replace a null abs_path with "/". + + Note: The "no rewrite" rule prevents the proxy from changing the + meaning of the request when the origin server is improperly using + a non-reserved URI character for a reserved purpose. Implementors + should be aware that some pre-HTTP/1.1 proxies have been known to + rewrite the Request-URI. + + + + + + +Fielding, et al. Standards Track [Page 37] + +RFC 2616 HTTP/1.1 June 1999 + + +5.2 The Resource Identified by a Request + + The exact resource identified by an Internet request is determined by + examining both the Request-URI and the Host header field. + + An origin server that does not allow resources to differ by the + requested host MAY ignore the Host header field value when + determining the resource identified by an HTTP/1.1 request. (But see + section 19.6.1.1 for other requirements on Host support in HTTP/1.1.) + + An origin server that does differentiate resources based on the host + requested (sometimes referred to as virtual hosts or vanity host + names) MUST use the following rules for determining the requested + resource on an HTTP/1.1 request: + + 1. If Request-URI is an absoluteURI, the host is part of the + Request-URI. Any Host header field value in the request MUST be + ignored. + + 2. If the Request-URI is not an absoluteURI, and the request includes + a Host header field, the host is determined by the Host header + field value. + + 3. If the host as determined by rule 1 or 2 is not a valid host on + the server, the response MUST be a 400 (Bad Request) error message. + + Recipients of an HTTP/1.0 request that lacks a Host header field MAY + attempt to use heuristics (e.g., examination of the URI path for + something unique to a particular host) in order to determine what + exact resource is being requested. + +5.3 Request Header Fields + + The request-header fields allow the client to pass additional + information about the request, and about the client itself, to the + server. These fields act as request modifiers, with semantics + equivalent to the parameters on a programming language method + invocation. + + request-header = Accept ; Section 14.1 + | Accept-Charset ; Section 14.2 + | Accept-Encoding ; Section 14.3 + | Accept-Language ; Section 14.4 + | Authorization ; Section 14.8 + | Expect ; Section 14.20 + | From ; Section 14.22 + | Host ; Section 14.23 + | If-Match ; Section 14.24 + + + +Fielding, et al. Standards Track [Page 38] + +RFC 2616 HTTP/1.1 June 1999 + + + | If-Modified-Since ; Section 14.25 + | If-None-Match ; Section 14.26 + | If-Range ; Section 14.27 + | If-Unmodified-Since ; Section 14.28 + | Max-Forwards ; Section 14.31 + | Proxy-Authorization ; Section 14.34 + | Range ; Section 14.35 + | Referer ; Section 14.36 + | TE ; Section 14.39 + | User-Agent ; Section 14.43 + + Request-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of request- + header fields if all parties in the communication recognize them to + be request-header fields. Unrecognized header fields are treated as + entity-header fields. + +6 Response + + After receiving and interpreting a request message, a server responds + with an HTTP response message. + + Response = Status-Line ; Section 6.1 + *(( general-header ; Section 4.5 + | response-header ; Section 6.2 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 7.2 + +6.1 Status-Line + + The first line of a Response message is the Status-Line, consisting + of the protocol version followed by a numeric status code and its + associated textual phrase, with each element separated by SP + characters. No CR or LF is allowed except in the final CRLF sequence. + + Status-Line = HTTP-Version SP Status-Code SP Reason-Phrase CRLF + +6.1.1 Status Code and Reason Phrase + + The Status-Code element is a 3-digit integer result code of the + attempt to understand and satisfy the request. These codes are fully + defined in section 10. The Reason-Phrase is intended to give a short + textual description of the Status-Code. The Status-Code is intended + for use by automata and the Reason-Phrase is intended for the human + user. The client is not required to examine or display the Reason- + Phrase. + + + +Fielding, et al. Standards Track [Page 39] + +RFC 2616 HTTP/1.1 June 1999 + + + The first digit of the Status-Code defines the class of response. The + last two digits do not have any categorization role. There are 5 + values for the first digit: + + - 1xx: Informational - Request received, continuing process + + - 2xx: Success - The action was successfully received, + understood, and accepted + + - 3xx: Redirection - Further action must be taken in order to + complete the request + + - 4xx: Client Error - The request contains bad syntax or cannot + be fulfilled + + - 5xx: Server Error - The server failed to fulfill an apparently + valid request + + The individual values of the numeric status codes defined for + HTTP/1.1, and an example set of corresponding Reason-Phrase's, are + presented below. The reason phrases listed here are only + recommendations -- they MAY be replaced by local equivalents without + affecting the protocol. + + Status-Code = + "100" ; Section 10.1.1: Continue + | "101" ; Section 10.1.2: Switching Protocols + | "200" ; Section 10.2.1: OK + | "201" ; Section 10.2.2: Created + | "202" ; Section 10.2.3: Accepted + | "203" ; Section 10.2.4: Non-Authoritative Information + | "204" ; Section 10.2.5: No Content + | "205" ; Section 10.2.6: Reset Content + | "206" ; Section 10.2.7: Partial Content + | "300" ; Section 10.3.1: Multiple Choices + | "301" ; Section 10.3.2: Moved Permanently + | "302" ; Section 10.3.3: Found + | "303" ; Section 10.3.4: See Other + | "304" ; Section 10.3.5: Not Modified + | "305" ; Section 10.3.6: Use Proxy + | "307" ; Section 10.3.8: Temporary Redirect + | "400" ; Section 10.4.1: Bad Request + | "401" ; Section 10.4.2: Unauthorized + | "402" ; Section 10.4.3: Payment Required + | "403" ; Section 10.4.4: Forbidden + | "404" ; Section 10.4.5: Not Found + | "405" ; Section 10.4.6: Method Not Allowed + | "406" ; Section 10.4.7: Not Acceptable + + + +Fielding, et al. Standards Track [Page 40] + +RFC 2616 HTTP/1.1 June 1999 + + + | "407" ; Section 10.4.8: Proxy Authentication Required + | "408" ; Section 10.4.9: Request Time-out + | "409" ; Section 10.4.10: Conflict + | "410" ; Section 10.4.11: Gone + | "411" ; Section 10.4.12: Length Required + | "412" ; Section 10.4.13: Precondition Failed + | "413" ; Section 10.4.14: Request Entity Too Large + | "414" ; Section 10.4.15: Request-URI Too Large + | "415" ; Section 10.4.16: Unsupported Media Type + | "416" ; Section 10.4.17: Requested range not satisfiable + | "417" ; Section 10.4.18: Expectation Failed + | "500" ; Section 10.5.1: Internal Server Error + | "501" ; Section 10.5.2: Not Implemented + | "502" ; Section 10.5.3: Bad Gateway + | "503" ; Section 10.5.4: Service Unavailable + | "504" ; Section 10.5.5: Gateway Time-out + | "505" ; Section 10.5.6: HTTP Version not supported + | extension-code + + extension-code = 3DIGIT + Reason-Phrase = * + + HTTP status codes are extensible. HTTP applications are not required + to understand the meaning of all registered status codes, though such + understanding is obviously desirable. However, applications MUST + understand the class of any status code, as indicated by the first + digit, and treat any unrecognized response as being equivalent to the + x00 status code of that class, with the exception that an + unrecognized response MUST NOT be cached. For example, if an + unrecognized status code of 431 is received by the client, it can + safely assume that there was something wrong with its request and + treat the response as if it had received a 400 status code. In such + cases, user agents SHOULD present to the user the entity returned + with the response, since that entity is likely to include human- + readable information which will explain the unusual status. + +6.2 Response Header Fields + + The response-header fields allow the server to pass additional + information about the response which cannot be placed in the Status- + Line. These header fields give information about the server and about + further access to the resource identified by the Request-URI. + + response-header = Accept-Ranges ; Section 14.5 + | Age ; Section 14.6 + | ETag ; Section 14.19 + | Location ; Section 14.30 + | Proxy-Authenticate ; Section 14.33 + + + +Fielding, et al. Standards Track [Page 41] + +RFC 2616 HTTP/1.1 June 1999 + + + | Retry-After ; Section 14.37 + | Server ; Section 14.38 + | Vary ; Section 14.44 + | WWW-Authenticate ; Section 14.47 + + Response-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of response- + header fields if all parties in the communication recognize them to + be response-header fields. Unrecognized header fields are treated as + entity-header fields. + +7 Entity + + Request and Response messages MAY transfer an entity if not otherwise + restricted by the request method or response status code. An entity + consists of entity-header fields and an entity-body, although some + responses will only include the entity-headers. + + In this section, both sender and recipient refer to either the client + or the server, depending on who sends and who receives the entity. + +7.1 Entity Header Fields + + Entity-header fields define metainformation about the entity-body or, + if no body is present, about the resource identified by the request. + Some of this metainformation is OPTIONAL; some might be REQUIRED by + portions of this specification. + + entity-header = Allow ; Section 14.7 + | Content-Encoding ; Section 14.11 + | Content-Language ; Section 14.12 + | Content-Length ; Section 14.13 + | Content-Location ; Section 14.14 + | Content-MD5 ; Section 14.15 + | Content-Range ; Section 14.16 + | Content-Type ; Section 14.17 + | Expires ; Section 14.21 + | Last-Modified ; Section 14.29 + | extension-header + + extension-header = message-header + + The extension-header mechanism allows additional entity-header fields + to be defined without changing the protocol, but these fields cannot + be assumed to be recognizable by the recipient. Unrecognized header + fields SHOULD be ignored by the recipient and MUST be forwarded by + transparent proxies. + + + +Fielding, et al. Standards Track [Page 42] + +RFC 2616 HTTP/1.1 June 1999 + + +7.2 Entity Body + + The entity-body (if any) sent with an HTTP request or response is in + a format and encoding defined by the entity-header fields. + + entity-body = *OCTET + + An entity-body is only present in a message when a message-body is + present, as described in section 4.3. The entity-body is obtained + from the message-body by decoding any Transfer-Encoding that might + have been applied to ensure safe and proper transfer of the message. + +7.2.1 Type + + When an entity-body is included with a message, the data type of that + body is determined via the header fields Content-Type and Content- + Encoding. These define a two-layer, ordered encoding model: + + entity-body := Content-Encoding( Content-Type( data ) ) + + Content-Type specifies the media type of the underlying data. + Content-Encoding may be used to indicate any additional content + codings applied to the data, usually for the purpose of data + compression, that are a property of the requested resource. There is + no default encoding. + + Any HTTP/1.1 message containing an entity-body SHOULD include a + Content-Type header field defining the media type of that body. If + and only if the media type is not given by a Content-Type field, the + recipient MAY attempt to guess the media type via inspection of its + content and/or the name extension(s) of the URI used to identify the + resource. If the media type remains unknown, the recipient SHOULD + treat it as type "application/octet-stream". + +7.2.2 Entity Length + + The entity-length of a message is the length of the message-body + before any transfer-codings have been applied. Section 4.4 defines + how the transfer-length of a message-body is determined. + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 43] + +RFC 2616 HTTP/1.1 June 1999 + + +8 Connections + +8.1 Persistent Connections + +8.1.1 Purpose + + Prior to persistent connections, a separate TCP connection was + established to fetch each URL, increasing the load on HTTP servers + and causing congestion on the Internet. The use of inline images and + other associated data often require a client to make multiple + requests of the same server in a short amount of time. Analysis of + these performance problems and results from a prototype + implementation are available [26] [30]. Implementation experience and + measurements of actual HTTP/1.1 (RFC 2068) implementations show good + results [39]. Alternatives have also been explored, for example, + T/TCP [27]. + + Persistent HTTP connections have a number of advantages: + + - By opening and closing fewer TCP connections, CPU time is saved + in routers and hosts (clients, servers, proxies, gateways, + tunnels, or caches), and memory used for TCP protocol control + blocks can be saved in hosts. + + - HTTP requests and responses can be pipelined on a connection. + Pipelining allows a client to make multiple requests without + waiting for each response, allowing a single TCP connection to + be used much more efficiently, with much lower elapsed time. + + - Network congestion is reduced by reducing the number of packets + caused by TCP opens, and by allowing TCP sufficient time to + determine the congestion state of the network. + + - Latency on subsequent requests is reduced since there is no time + spent in TCP's connection opening handshake. + + - HTTP can evolve more gracefully, since errors can be reported + without the penalty of closing the TCP connection. Clients using + future versions of HTTP might optimistically try a new feature, + but if communicating with an older server, retry with old + semantics after an error is reported. + + HTTP implementations SHOULD implement persistent connections. + + + + + + + + +Fielding, et al. Standards Track [Page 44] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2 Overall Operation + + A significant difference between HTTP/1.1 and earlier versions of + HTTP is that persistent connections are the default behavior of any + HTTP connection. That is, unless otherwise indicated, the client + SHOULD assume that the server will maintain a persistent connection, + even after error responses from the server. + + Persistent connections provide a mechanism by which a client and a + server can signal the close of a TCP connection. This signaling takes + place using the Connection header field (section 14.10). Once a close + has been signaled, the client MUST NOT send any more requests on that + connection. + +8.1.2.1 Negotiation + + An HTTP/1.1 server MAY assume that a HTTP/1.1 client intends to + maintain a persistent connection unless a Connection header including + the connection-token "close" was sent in the request. If the server + chooses to close the connection immediately after sending the + response, it SHOULD send a Connection header including the + connection-token close. + + An HTTP/1.1 client MAY expect a connection to remain open, but would + decide to keep it open based on whether the response from a server + contains a Connection header with the connection-token close. In case + the client does not want to maintain a connection for more than that + request, it SHOULD send a Connection header including the + connection-token close. + + If either the client or the server sends the close token in the + Connection header, that request becomes the last one for the + connection. + + Clients and servers SHOULD NOT assume that a persistent connection is + maintained for HTTP versions less than 1.1 unless it is explicitly + signaled. See section 19.6.2 for more information on backward + compatibility with HTTP/1.0 clients. + + In order to remain persistent, all messages on the connection MUST + have a self-defined message length (i.e., one not defined by closure + of the connection), as described in section 4.4. + + + + + + + + + +Fielding, et al. Standards Track [Page 45] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2.2 Pipelining + + A client that supports persistent connections MAY "pipeline" its + requests (i.e., send multiple requests without waiting for each + response). A server MUST send its responses to those requests in the + same order that the requests were received. + + Clients which assume persistent connections and pipeline immediately + after connection establishment SHOULD be prepared to retry their + connection if the first pipelined attempt fails. If a client does + such a retry, it MUST NOT pipeline before it knows the connection is + persistent. Clients MUST also be prepared to resend their requests if + the server closes the connection before sending all of the + corresponding responses. + + Clients SHOULD NOT pipeline requests using non-idempotent methods or + non-idempotent sequences of methods (see section 9.1.2). Otherwise, a + premature termination of the transport connection could lead to + indeterminate results. A client wishing to send a non-idempotent + request SHOULD wait to send that request until it has received the + response status for the previous request. + +8.1.3 Proxy Servers + + It is especially important that proxies correctly implement the + properties of the Connection header field as specified in section + 14.10. + + The proxy server MUST signal persistent connections separately with + its clients and the origin servers (or other proxy servers) that it + connects to. Each persistent connection applies to only one transport + link. + + A proxy server MUST NOT establish a HTTP/1.1 persistent connection + with an HTTP/1.0 client (but see RFC 2068 [33] for information and + discussion of the problems with the Keep-Alive header implemented by + many HTTP/1.0 clients). + +8.1.4 Practical Considerations + + Servers will usually have some time-out value beyond which they will + no longer maintain an inactive connection. Proxy servers might make + this a higher value since it is likely that the client will be making + more connections through the same server. The use of persistent + connections places no requirements on the length (or existence) of + this time-out for either the client or the server. + + + + + +Fielding, et al. Standards Track [Page 46] + +RFC 2616 HTTP/1.1 June 1999 + + + When a client or server wishes to time-out it SHOULD issue a graceful + close on the transport connection. Clients and servers SHOULD both + constantly watch for the other side of the transport close, and + respond to it as appropriate. If a client or server does not detect + the other side's close promptly it could cause unnecessary resource + drain on the network. + + A client, server, or proxy MAY close the transport connection at any + time. For example, a client might have started to send a new request + at the same time that the server has decided to close the "idle" + connection. From the server's point of view, the connection is being + closed while it was idle, but from the client's point of view, a + request is in progress. + + This means that clients, servers, and proxies MUST be able to recover + from asynchronous close events. Client software SHOULD reopen the + transport connection and retransmit the aborted sequence of requests + without user interaction so long as the request sequence is + idempotent (see section 9.1.2). Non-idempotent methods or sequences + MUST NOT be automatically retried, although user agents MAY offer a + human operator the choice of retrying the request(s). Confirmation by + user-agent software with semantic understanding of the application + MAY substitute for user confirmation. The automatic retry SHOULD NOT + be repeated if the second sequence of requests fails. + + Servers SHOULD always respond to at least one request per connection, + if at all possible. Servers SHOULD NOT close a connection in the + middle of transmitting a response, unless a network or client failure + is suspected. + + Clients that use persistent connections SHOULD limit the number of + simultaneous connections that they maintain to a given server. A + single-user client SHOULD NOT maintain more than 2 connections with + any server or proxy. A proxy SHOULD use up to 2*N connections to + another server or proxy, where N is the number of simultaneously + active users. These guidelines are intended to improve HTTP response + times and avoid congestion. + +8.2 Message Transmission Requirements + +8.2.1 Persistent Connections and Flow Control + + HTTP/1.1 servers SHOULD maintain persistent connections and use TCP's + flow control mechanisms to resolve temporary overloads, rather than + terminating connections with the expectation that clients will retry. + The latter technique can exacerbate network congestion. + + + + + +Fielding, et al. Standards Track [Page 47] + +RFC 2616 HTTP/1.1 June 1999 + + +8.2.2 Monitoring Connections for Error Status Messages + + An HTTP/1.1 (or later) client sending a message-body SHOULD monitor + the network connection for an error status while it is transmitting + the request. If the client sees an error status, it SHOULD + immediately cease transmitting the body. If the body is being sent + using a "chunked" encoding (section 3.6), a zero length chunk and + empty trailer MAY be used to prematurely mark the end of the message. + If the body was preceded by a Content-Length header, the client MUST + close the connection. + +8.2.3 Use of the 100 (Continue) Status + + The purpose of the 100 (Continue) status (see section 10.1.1) is to + allow a client that is sending a request message with a request body + to determine if the origin server is willing to accept the request + (based on the request headers) before the client sends the request + body. In some cases, it might either be inappropriate or highly + inefficient for the client to send the body if the server will reject + the message without looking at the body. + + Requirements for HTTP/1.1 clients: + + - If a client will wait for a 100 (Continue) response before + sending the request body, it MUST send an Expect request-header + field (section 14.20) with the "100-continue" expectation. + + - A client MUST NOT send an Expect request-header field (section + 14.20) with the "100-continue" expectation if it does not intend + to send a request body. + + Because of the presence of older implementations, the protocol allows + ambiguous situations in which a client may send "Expect: 100- + continue" without receiving either a 417 (Expectation Failed) status + or a 100 (Continue) status. Therefore, when a client sends this + header field to an origin server (possibly via a proxy) from which it + has never seen a 100 (Continue) status, the client SHOULD NOT wait + for an indefinite period before sending the request body. + + Requirements for HTTP/1.1 origin servers: + + - Upon receiving a request which includes an Expect request-header + field with the "100-continue" expectation, an origin server MUST + either respond with 100 (Continue) status and continue to read + from the input stream, or respond with a final status code. The + origin server MUST NOT wait for the request body before sending + the 100 (Continue) response. If it responds with a final status + code, it MAY close the transport connection or it MAY continue + + + +Fielding, et al. Standards Track [Page 48] + +RFC 2616 HTTP/1.1 June 1999 + + + to read and discard the rest of the request. It MUST NOT + perform the requested method if it returns a final status code. + + - An origin server SHOULD NOT send a 100 (Continue) response if + the request message does not include an Expect request-header + field with the "100-continue" expectation, and MUST NOT send a + 100 (Continue) response if such a request comes from an HTTP/1.0 + (or earlier) client. There is an exception to this rule: for + compatibility with RFC 2068, a server MAY send a 100 (Continue) + status in response to an HTTP/1.1 PUT or POST request that does + not include an Expect request-header field with the "100- + continue" expectation. This exception, the purpose of which is + to minimize any client processing delays associated with an + undeclared wait for 100 (Continue) status, applies only to + HTTP/1.1 requests, and not to requests with any other HTTP- + version value. + + - An origin server MAY omit a 100 (Continue) response if it has + already received some or all of the request body for the + corresponding request. + + - An origin server that sends a 100 (Continue) response MUST + ultimately send a final status code, once the request body is + received and processed, unless it terminates the transport + connection prematurely. + + - If an origin server receives a request that does not include an + Expect request-header field with the "100-continue" expectation, + the request includes a request body, and the server responds + with a final status code before reading the entire request body + from the transport connection, then the server SHOULD NOT close + the transport connection until it has read the entire request, + or until the client closes the connection. Otherwise, the client + might not reliably receive the response message. However, this + requirement is not be construed as preventing a server from + defending itself against denial-of-service attacks, or from + badly broken client implementations. + + Requirements for HTTP/1.1 proxies: + + - If a proxy receives a request that includes an Expect request- + header field with the "100-continue" expectation, and the proxy + either knows that the next-hop server complies with HTTP/1.1 or + higher, or does not know the HTTP version of the next-hop + server, it MUST forward the request, including the Expect header + field. + + + + + +Fielding, et al. Standards Track [Page 49] + +RFC 2616 HTTP/1.1 June 1999 + + + - If the proxy knows that the version of the next-hop server is + HTTP/1.0 or lower, it MUST NOT forward the request, and it MUST + respond with a 417 (Expectation Failed) status. + + - Proxies SHOULD maintain a cache recording the HTTP version + numbers received from recently-referenced next-hop servers. + + - A proxy MUST NOT forward a 100 (Continue) response if the + request message was received from an HTTP/1.0 (or earlier) + client and did not include an Expect request-header field with + the "100-continue" expectation. This requirement overrides the + general rule for forwarding of 1xx responses (see section 10.1). + +8.2.4 Client Behavior if Server Prematurely Closes Connection + + If an HTTP/1.1 client sends a request which includes a request body, + but which does not include an Expect request-header field with the + "100-continue" expectation, and if the client is not directly + connected to an HTTP/1.1 origin server, and if the client sees the + connection close before receiving any status from the server, the + client SHOULD retry the request. If the client does retry this + request, it MAY use the following "binary exponential backoff" + algorithm to be assured of obtaining a reliable response: + + 1. Initiate a new connection to the server + + 2. Transmit the request-headers + + 3. Initialize a variable R to the estimated round-trip time to the + server (e.g., based on the time it took to establish the + connection), or to a constant value of 5 seconds if the round- + trip time is not available. + + 4. Compute T = R * (2**N), where N is the number of previous + retries of this request. + + 5. Wait either for an error response from the server, or for T + seconds (whichever comes first) + + 6. If no error response is received, after T seconds transmit the + body of the request. + + 7. If client sees that the connection is closed prematurely, + repeat from step 1 until the request is accepted, an error + response is received, or the user becomes impatient and + terminates the retry process. + + + + + +Fielding, et al. Standards Track [Page 50] + +RFC 2616 HTTP/1.1 June 1999 + + + If at any point an error status is received, the client + + - SHOULD NOT continue and + + - SHOULD close the connection if it has not completed sending the + request message. + +9 Method Definitions + + The set of common methods for HTTP/1.1 is defined below. Although + this set can be expanded, additional methods cannot be assumed to + share the same semantics for separately extended clients and servers. + + The Host request-header field (section 14.23) MUST accompany all + HTTP/1.1 requests. + +9.1 Safe and Idempotent Methods + +9.1.1 Safe Methods + + Implementors should be aware that the software represents the user in + their interactions over the Internet, and should be careful to allow + the user to be aware of any actions they might take which may have an + unexpected significance to themselves or others. + + In particular, the convention has been established that the GET and + HEAD methods SHOULD NOT have the significance of taking an action + other than retrieval. These methods ought to be considered "safe". + This allows user agents to represent other methods, such as POST, PUT + and DELETE, in a special way, so that the user is made aware of the + fact that a possibly unsafe action is being requested. + + Naturally, it is not possible to ensure that the server does not + generate side-effects as a result of performing a GET request; in + fact, some dynamic resources consider that a feature. The important + distinction here is that the user did not request the side-effects, + so therefore cannot be held accountable for them. + +9.1.2 Idempotent Methods + + Methods can also have the property of "idempotence" in that (aside + from error or expiration issues) the side-effects of N > 0 identical + requests is the same as for a single request. The methods GET, HEAD, + PUT and DELETE share this property. Also, the methods OPTIONS and + TRACE SHOULD NOT have side effects, and so are inherently idempotent. + + + + + + +Fielding, et al. Standards Track [Page 51] + +RFC 2616 HTTP/1.1 June 1999 + + + However, it is possible that a sequence of several requests is non- + idempotent, even if all of the methods executed in that sequence are + idempotent. (A sequence is idempotent if a single execution of the + entire sequence always yields a result that is not changed by a + reexecution of all, or part, of that sequence.) For example, a + sequence is non-idempotent if its result depends on a value that is + later modified in the same sequence. + + A sequence that never has side effects is idempotent, by definition + (provided that no concurrent operations are being executed on the + same set of resources). + +9.2 OPTIONS + + The OPTIONS method represents a request for information about the + communication options available on the request/response chain + identified by the Request-URI. This method allows the client to + determine the options and/or requirements associated with a resource, + or the capabilities of a server, without implying a resource action + or initiating a resource retrieval. + + Responses to this method are not cacheable. + + If the OPTIONS request includes an entity-body (as indicated by the + presence of Content-Length or Transfer-Encoding), then the media type + MUST be indicated by a Content-Type field. Although this + specification does not define any use for such a body, future + extensions to HTTP might use the OPTIONS body to make more detailed + queries on the server. A server that does not support such an + extension MAY discard the request body. + + If the Request-URI is an asterisk ("*"), the OPTIONS request is + intended to apply to the server in general rather than to a specific + resource. Since a server's communication options typically depend on + the resource, the "*" request is only useful as a "ping" or "no-op" + type of method; it does nothing beyond allowing the client to test + the capabilities of the server. For example, this can be used to test + a proxy for HTTP/1.1 compliance (or lack thereof). + + If the Request-URI is not an asterisk, the OPTIONS request applies + only to the options that are available when communicating with that + resource. + + A 200 response SHOULD include any header fields that indicate + optional features implemented by the server and applicable to that + resource (e.g., Allow), possibly including extensions not defined by + this specification. The response body, if any, SHOULD also include + information about the communication options. The format for such a + + + +Fielding, et al. Standards Track [Page 52] + +RFC 2616 HTTP/1.1 June 1999 + + + body is not defined by this specification, but might be defined by + future extensions to HTTP. Content negotiation MAY be used to select + the appropriate response format. If no response body is included, the + response MUST include a Content-Length field with a field-value of + "0". + + The Max-Forwards request-header field MAY be used to target a + specific proxy in the request chain. When a proxy receives an OPTIONS + request on an absoluteURI for which request forwarding is permitted, + the proxy MUST check for a Max-Forwards field. If the Max-Forwards + field-value is zero ("0"), the proxy MUST NOT forward the message; + instead, the proxy SHOULD respond with its own communication options. + If the Max-Forwards field-value is an integer greater than zero, the + proxy MUST decrement the field-value when it forwards the request. If + no Max-Forwards field is present in the request, then the forwarded + request MUST NOT include a Max-Forwards field. + +9.3 GET + + The GET method means retrieve whatever information (in the form of an + entity) is identified by the Request-URI. If the Request-URI refers + to a data-producing process, it is the produced data which shall be + returned as the entity in the response and not the source text of the + process, unless that text happens to be the output of the process. + + The semantics of the GET method change to a "conditional GET" if the + request message includes an If-Modified-Since, If-Unmodified-Since, + If-Match, If-None-Match, or If-Range header field. A conditional GET + method requests that the entity be transferred only under the + circumstances described by the conditional header field(s). The + conditional GET method is intended to reduce unnecessary network + usage by allowing cached entities to be refreshed without requiring + multiple requests or transferring data already held by the client. + + The semantics of the GET method change to a "partial GET" if the + request message includes a Range header field. A partial GET requests + that only part of the entity be transferred, as described in section + 14.35. The partial GET method is intended to reduce unnecessary + network usage by allowing partially-retrieved entities to be + completed without transferring data already held by the client. + + The response to a GET request is cacheable if and only if it meets + the requirements for HTTP caching described in section 13. + + See section 15.1.3 for security considerations when used for forms. + + + + + + +Fielding, et al. Standards Track [Page 53] + +RFC 2616 HTTP/1.1 June 1999 + + +9.4 HEAD + + The HEAD method is identical to GET except that the server MUST NOT + return a message-body in the response. The metainformation contained + in the HTTP headers in response to a HEAD request SHOULD be identical + to the information sent in response to a GET request. This method can + be used for obtaining metainformation about the entity implied by the + request without transferring the entity-body itself. This method is + often used for testing hypertext links for validity, accessibility, + and recent modification. + + The response to a HEAD request MAY be cacheable in the sense that the + information contained in the response MAY be used to update a + previously cached entity from that resource. If the new field values + indicate that the cached entity differs from the current entity (as + would be indicated by a change in Content-Length, Content-MD5, ETag + or Last-Modified), then the cache MUST treat the cache entry as + stale. + +9.5 POST + + The POST method is used to request that the origin server accept the + entity enclosed in the request as a new subordinate of the resource + identified by the Request-URI in the Request-Line. POST is designed + to allow a uniform method to cover the following functions: + + - Annotation of existing resources; + + - Posting a message to a bulletin board, newsgroup, mailing list, + or similar group of articles; + + - Providing a block of data, such as the result of submitting a + form, to a data-handling process; + + - Extending a database through an append operation. + + The actual function performed by the POST method is determined by the + server and is usually dependent on the Request-URI. The posted entity + is subordinate to that URI in the same way that a file is subordinate + to a directory containing it, a news article is subordinate to a + newsgroup to which it is posted, or a record is subordinate to a + database. + + The action performed by the POST method might not result in a + resource that can be identified by a URI. In this case, either 200 + (OK) or 204 (No Content) is the appropriate response status, + depending on whether or not the response includes an entity that + describes the result. + + + +Fielding, et al. Standards Track [Page 54] + +RFC 2616 HTTP/1.1 June 1999 + + + If a resource has been created on the origin server, the response + SHOULD be 201 (Created) and contain an entity which describes the + status of the request and refers to the new resource, and a Location + header (see section 14.30). + + Responses to this method are not cacheable, unless the response + includes appropriate Cache-Control or Expires header fields. However, + the 303 (See Other) response can be used to direct the user agent to + retrieve a cacheable resource. + + POST requests MUST obey the message transmission requirements set out + in section 8.2. + + See section 15.1.3 for security considerations. + +9.6 PUT + + The PUT method requests that the enclosed entity be stored under the + supplied Request-URI. If the Request-URI refers to an already + existing resource, the enclosed entity SHOULD be considered as a + modified version of the one residing on the origin server. If the + Request-URI does not point to an existing resource, and that URI is + capable of being defined as a new resource by the requesting user + agent, the origin server can create the resource with that URI. If a + new resource is created, the origin server MUST inform the user agent + via the 201 (Created) response. If an existing resource is modified, + either the 200 (OK) or 204 (No Content) response codes SHOULD be sent + to indicate successful completion of the request. If the resource + could not be created or modified with the Request-URI, an appropriate + error response SHOULD be given that reflects the nature of the + problem. The recipient of the entity MUST NOT ignore any Content-* + (e.g. Content-Range) headers that it does not understand or implement + and MUST return a 501 (Not Implemented) response in such cases. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + + The fundamental difference between the POST and PUT requests is + reflected in the different meaning of the Request-URI. The URI in a + POST request identifies the resource that will handle the enclosed + entity. That resource might be a data-accepting process, a gateway to + some other protocol, or a separate entity that accepts annotations. + In contrast, the URI in a PUT request identifies the entity enclosed + with the request -- the user agent knows what URI is intended and the + server MUST NOT attempt to apply the request to some other resource. + If the server desires that the request be applied to a different URI, + + + + +Fielding, et al. Standards Track [Page 55] + +RFC 2616 HTTP/1.1 June 1999 + + + it MUST send a 301 (Moved Permanently) response; the user agent MAY + then make its own decision regarding whether or not to redirect the + request. + + A single resource MAY be identified by many different URIs. For + example, an article might have a URI for identifying "the current + version" which is separate from the URI identifying each particular + version. In this case, a PUT request on a general URI might result in + several other URIs being defined by the origin server. + + HTTP/1.1 does not define how a PUT method affects the state of an + origin server. + + PUT requests MUST obey the message transmission requirements set out + in section 8.2. + + Unless otherwise specified for a particular entity-header, the + entity-headers in the PUT request SHOULD be applied to the resource + created or modified by the PUT. + +9.7 DELETE + + The DELETE method requests that the origin server delete the resource + identified by the Request-URI. This method MAY be overridden by human + intervention (or other means) on the origin server. The client cannot + be guaranteed that the operation has been carried out, even if the + status code returned from the origin server indicates that the action + has been completed successfully. However, the server SHOULD NOT + indicate success unless, at the time the response is given, it + intends to delete the resource or move it to an inaccessible + location. + + A successful response SHOULD be 200 (OK) if the response includes an + entity describing the status, 202 (Accepted) if the action has not + yet been enacted, or 204 (No Content) if the action has been enacted + but the response does not include an entity. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + +9.8 TRACE + + The TRACE method is used to invoke a remote, application-layer loop- + back of the request message. The final recipient of the request + SHOULD reflect the message received back to the client as the + entity-body of a 200 (OK) response. The final recipient is either the + + + + +Fielding, et al. Standards Track [Page 56] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server or the first proxy or gateway to receive a Max-Forwards + value of zero (0) in the request (see section 14.31). A TRACE request + MUST NOT include an entity. + + TRACE allows the client to see what is being received at the other + end of the request chain and use that data for testing or diagnostic + information. The value of the Via header field (section 14.45) is of + particular interest, since it acts as a trace of the request chain. + Use of the Max-Forwards header field allows the client to limit the + length of the request chain, which is useful for testing a chain of + proxies forwarding messages in an infinite loop. + + If the request is valid, the response SHOULD contain the entire + request message in the entity-body, with a Content-Type of + "message/http". Responses to this method MUST NOT be cached. + +9.9 CONNECT + + This specification reserves the method name CONNECT for use with a + proxy that can dynamically switch to being a tunnel (e.g. SSL + tunneling [44]). + +10 Status Code Definitions + + Each Status-Code is described below, including a description of which + method(s) it can follow and any metainformation required in the + response. + +10.1 Informational 1xx + + This class of status code indicates a provisional response, + consisting only of the Status-Line and optional headers, and is + terminated by an empty line. There are no required headers for this + class of status code. Since HTTP/1.0 did not define any 1xx status + codes, servers MUST NOT send a 1xx response to an HTTP/1.0 client + except under experimental conditions. + + A client MUST be prepared to accept one or more 1xx status responses + prior to a regular response, even if the client does not expect a 100 + (Continue) status message. Unexpected 1xx status responses MAY be + ignored by a user agent. + + Proxies MUST forward 1xx responses, unless the connection between the + proxy and its client has been closed, or unless the proxy itself + requested the generation of the 1xx response. (For example, if a + + + + + + +Fielding, et al. Standards Track [Page 57] + +RFC 2616 HTTP/1.1 June 1999 + + + proxy adds a "Expect: 100-continue" field when it forwards a request, + then it need not forward the corresponding 100 (Continue) + response(s).) + +10.1.1 100 Continue + + The client SHOULD continue with its request. This interim response is + used to inform the client that the initial part of the request has + been received and has not yet been rejected by the server. The client + SHOULD continue by sending the remainder of the request or, if the + request has already been completed, ignore this response. The server + MUST send a final response after the request has been completed. See + section 8.2.3 for detailed discussion of the use and handling of this + status code. + +10.1.2 101 Switching Protocols + + The server understands and is willing to comply with the client's + request, via the Upgrade message header field (section 14.42), for a + change in the application protocol being used on this connection. The + server will switch protocols to those defined by the response's + Upgrade header field immediately after the empty line which + terminates the 101 response. + + The protocol SHOULD be switched only when it is advantageous to do + so. For example, switching to a newer version of HTTP is advantageous + over older versions, and switching to a real-time, synchronous + protocol might be advantageous when delivering resources that use + such features. + +10.2 Successful 2xx + + This class of status code indicates that the client's request was + successfully received, understood, and accepted. + +10.2.1 200 OK + + The request has succeeded. The information returned with the response + is dependent on the method used in the request, for example: + + GET an entity corresponding to the requested resource is sent in + the response; + + HEAD the entity-header fields corresponding to the requested + resource are sent in the response without any message-body; + + POST an entity describing or containing the result of the action; + + + + +Fielding, et al. Standards Track [Page 58] + +RFC 2616 HTTP/1.1 June 1999 + + + TRACE an entity containing the request message as received by the + end server. + +10.2.2 201 Created + + The request has been fulfilled and resulted in a new resource being + created. The newly created resource can be referenced by the URI(s) + returned in the entity of the response, with the most specific URI + for the resource given by a Location header field. The response + SHOULD include an entity containing a list of resource + characteristics and location(s) from which the user or user agent can + choose the one most appropriate. The entity format is specified by + the media type given in the Content-Type header field. The origin + server MUST create the resource before returning the 201 status code. + If the action cannot be carried out immediately, the server SHOULD + respond with 202 (Accepted) response instead. + + A 201 response MAY contain an ETag response header field indicating + the current value of the entity tag for the requested variant just + created, see section 14.19. + +10.2.3 202 Accepted + + The request has been accepted for processing, but the processing has + not been completed. The request might or might not eventually be + acted upon, as it might be disallowed when processing actually takes + place. There is no facility for re-sending a status code from an + asynchronous operation such as this. + + The 202 response is intentionally non-committal. Its purpose is to + allow a server to accept a request for some other process (perhaps a + batch-oriented process that is only run once per day) without + requiring that the user agent's connection to the server persist + until the process is completed. The entity returned with this + response SHOULD include an indication of the request's current status + and either a pointer to a status monitor or some estimate of when the + user can expect the request to be fulfilled. + +10.2.4 203 Non-Authoritative Information + + The returned metainformation in the entity-header is not the + definitive set as available from the origin server, but is gathered + from a local or a third-party copy. The set presented MAY be a subset + or superset of the original version. For example, including local + annotation information about the resource might result in a superset + of the metainformation known by the origin server. Use of this + response code is not required and is only appropriate when the + response would otherwise be 200 (OK). + + + +Fielding, et al. Standards Track [Page 59] + +RFC 2616 HTTP/1.1 June 1999 + + +10.2.5 204 No Content + + The server has fulfilled the request but does not need to return an + entity-body, and might want to return updated metainformation. The + response MAY include new or updated metainformation in the form of + entity-headers, which if present SHOULD be associated with the + requested variant. + + If the client is a user agent, it SHOULD NOT change its document view + from that which caused the request to be sent. This response is + primarily intended to allow input for actions to take place without + causing a change to the user agent's active document view, although + any new or updated metainformation SHOULD be applied to the document + currently in the user agent's active view. + + The 204 response MUST NOT include a message-body, and thus is always + terminated by the first empty line after the header fields. + +10.2.6 205 Reset Content + + The server has fulfilled the request and the user agent SHOULD reset + the document view which caused the request to be sent. This response + is primarily intended to allow input for actions to take place via + user input, followed by a clearing of the form in which the input is + given so that the user can easily initiate another input action. The + response MUST NOT include an entity. + +10.2.7 206 Partial Content + + The server has fulfilled the partial GET request for the resource. + The request MUST have included a Range header field (section 14.35) + indicating the desired range, and MAY have included an If-Range + header field (section 14.27) to make the request conditional. + + The response MUST include the following header fields: + + - Either a Content-Range header field (section 14.16) indicating + the range included with this response, or a multipart/byteranges + Content-Type including Content-Range fields for each part. If a + Content-Length header field is present in the response, its + value MUST match the actual number of OCTETs transmitted in the + message-body. + + - Date + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + + + +Fielding, et al. Standards Track [Page 60] + +RFC 2616 HTTP/1.1 June 1999 + + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the 206 response is the result of an If-Range request that used a + strong cache validator (see section 13.3.3), the response SHOULD NOT + include other entity-headers. If the response is the result of an + If-Range request that used a weak validator, the response MUST NOT + include other entity-headers; this prevents inconsistencies between + cached entity-bodies and updated headers. Otherwise, the response + MUST include all of the entity-headers that would have been returned + with a 200 (OK) response to the same request. + + A cache MUST NOT combine a 206 response with other previously cached + content if the ETag or Last-Modified headers do not match exactly, + see 13.5.4. + + A cache that does not support the Range and Content-Range headers + MUST NOT cache 206 (Partial) responses. + +10.3 Redirection 3xx + + This class of status code indicates that further action needs to be + taken by the user agent in order to fulfill the request. The action + required MAY be carried out by the user agent without interaction + with the user if and only if the method used in the second request is + GET or HEAD. A client SHOULD detect infinite redirection loops, since + such loops generate network traffic for each redirection. + + Note: previous versions of this specification recommended a + maximum of five redirections. Content developers should be aware + that there might be clients that implement such a fixed + limitation. + +10.3.1 300 Multiple Choices + + The requested resource corresponds to any one of a set of + representations, each with its own specific location, and agent- + driven negotiation information (section 12) is being provided so that + the user (or user agent) can select a preferred representation and + redirect its request to that location. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of resource characteristics and location(s) from + which the user or user agent can choose the one most appropriate. The + entity format is specified by the media type given in the Content- + Type header field. Depending upon the format and the capabilities of + + + + +Fielding, et al. Standards Track [Page 61] + +RFC 2616 HTTP/1.1 June 1999 + + + the user agent, selection of the most appropriate choice MAY be + performed automatically. However, this specification does not define + any standard for such automatic selection. + + If the server has a preferred choice of representation, it SHOULD + include the specific URI for that representation in the Location + field; user agents MAY use the Location field value for automatic + redirection. This response is cacheable unless indicated otherwise. + +10.3.2 301 Moved Permanently + + The requested resource has been assigned a new permanent URI and any + future references to this resource SHOULD use one of the returned + URIs. Clients with link editing capabilities ought to automatically + re-link references to the Request-URI to one or more of the new + references returned by the server, where possible. This response is + cacheable unless indicated otherwise. + + The new permanent URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + If the 301 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: When automatically redirecting a POST request after + receiving a 301 status code, some existing HTTP/1.0 user agents + will erroneously change it into a GET request. + +10.3.3 302 Found + + The requested resource resides temporarily under a different URI. + Since the redirection might be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + + + + + + +Fielding, et al. Standards Track [Page 62] + +RFC 2616 HTTP/1.1 June 1999 + + + If the 302 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: RFC 1945 and RFC 2068 specify that the client is not allowed + to change the method on the redirected request. However, most + existing user agent implementations treat 302 as if it were a 303 + response, performing a GET on the Location field-value regardless + of the original request method. The status codes 303 and 307 have + been added for servers that wish to make unambiguously clear which + kind of reaction is expected of the client. + +10.3.4 303 See Other + + The response to the request can be found under a different URI and + SHOULD be retrieved using a GET method on that resource. This method + exists primarily to allow the output of a POST-activated script to + redirect the user agent to a selected resource. The new URI is not a + substitute reference for the originally requested resource. The 303 + response MUST NOT be cached, but the response to the second + (redirected) request might be cacheable. + + The different URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + Note: Many pre-HTTP/1.1 user agents do not understand the 303 + status. When interoperability with such clients is a concern, the + 302 status code may be used instead, since most user agents react + to a 302 response as described here for 303. + +10.3.5 304 Not Modified + + If the client has performed a conditional GET request and access is + allowed, but the document has not been modified, the server SHOULD + respond with this status code. The 304 response MUST NOT contain a + message-body, and thus is always terminated by the first empty line + after the header fields. + + The response MUST include the following header fields: + + - Date, unless its omission is required by section 14.18.1 + + + + + + + +Fielding, et al. Standards Track [Page 63] + +RFC 2616 HTTP/1.1 June 1999 + + + If a clockless origin server obeys these rules, and proxies and + clients add their own Date to any response received without one (as + already specified by [RFC 2068], section 14.19), caches will operate + correctly. + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the conditional GET used a strong cache validator (see section + 13.3.3), the response SHOULD NOT include other entity-headers. + Otherwise (i.e., the conditional GET used a weak validator), the + response MUST NOT include other entity-headers; this prevents + inconsistencies between cached entity-bodies and updated headers. + + If a 304 response indicates an entity not currently cached, then the + cache MUST disregard the response and repeat the request without the + conditional. + + If a cache uses a received 304 response to update a cache entry, the + cache MUST update the entry to reflect any new field values given in + the response. + +10.3.6 305 Use Proxy + + The requested resource MUST be accessed through the proxy given by + the Location field. The Location field gives the URI of the proxy. + The recipient is expected to repeat this single request via the + proxy. 305 responses MUST only be generated by origin servers. + + Note: RFC 2068 was not clear that 305 was intended to redirect a + single request, and to be generated by origin servers only. Not + observing these limitations has significant security consequences. + +10.3.7 306 (Unused) + + The 306 status code was used in a previous version of the + specification, is no longer used, and the code is reserved. + + + + + + + + + + +Fielding, et al. Standards Track [Page 64] + +RFC 2616 HTTP/1.1 June 1999 + + +10.3.8 307 Temporary Redirect + + The requested resource resides temporarily under a different URI. + Since the redirection MAY be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s) , since many pre-HTTP/1.1 user agents do not + understand the 307 status. Therefore, the note SHOULD contain the + information necessary for a user to repeat the original request on + the new URI. + + If the 307 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + +10.4 Client Error 4xx + + The 4xx class of status code is intended for cases in which the + client seems to have erred. Except when responding to a HEAD request, + the server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. These status codes are applicable to any request method. + User agents SHOULD display any included entity to the user. + + If the client is sending data, a server implementation using TCP + SHOULD be careful to ensure that the client acknowledges receipt of + the packet(s) containing the response, before the server closes the + input connection. If the client continues sending data to the server + after the close, the server's TCP stack will send a reset packet to + the client, which may erase the client's unacknowledged input buffers + before they can be read and interpreted by the HTTP application. + +10.4.1 400 Bad Request + + The request could not be understood by the server due to malformed + syntax. The client SHOULD NOT repeat the request without + modifications. + + + + + + + + +Fielding, et al. Standards Track [Page 65] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.2 401 Unauthorized + + The request requires user authentication. The response MUST include a + WWW-Authenticate header field (section 14.47) containing a challenge + applicable to the requested resource. The client MAY repeat the + request with a suitable Authorization header field (section 14.8). If + the request already included Authorization credentials, then the 401 + response indicates that authorization has been refused for those + credentials. If the 401 response contains the same challenge as the + prior response, and the user agent has already attempted + authentication at least once, then the user SHOULD be presented the + entity that was given in the response, since that entity might + include relevant diagnostic information. HTTP access authentication + is explained in "HTTP Authentication: Basic and Digest Access + Authentication" [43]. + +10.4.3 402 Payment Required + + This code is reserved for future use. + +10.4.4 403 Forbidden + + The server understood the request, but is refusing to fulfill it. + Authorization will not help and the request SHOULD NOT be repeated. + If the request method was not HEAD and the server wishes to make + public why the request has not been fulfilled, it SHOULD describe the + reason for the refusal in the entity. If the server does not wish to + make this information available to the client, the status code 404 + (Not Found) can be used instead. + +10.4.5 404 Not Found + + The server has not found anything matching the Request-URI. No + indication is given of whether the condition is temporary or + permanent. The 410 (Gone) status code SHOULD be used if the server + knows, through some internally configurable mechanism, that an old + resource is permanently unavailable and has no forwarding address. + This status code is commonly used when the server does not wish to + reveal exactly why the request has been refused, or when no other + response is applicable. + +10.4.6 405 Method Not Allowed + + The method specified in the Request-Line is not allowed for the + resource identified by the Request-URI. The response MUST include an + Allow header containing a list of valid methods for the requested + resource. + + + + +Fielding, et al. Standards Track [Page 66] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.7 406 Not Acceptable + + The resource identified by the request is only capable of generating + response entities which have content characteristics not acceptable + according to the accept headers sent in the request. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of available entity characteristics and location(s) + from which the user or user agent can choose the one most + appropriate. The entity format is specified by the media type given + in the Content-Type header field. Depending upon the format and the + capabilities of the user agent, selection of the most appropriate + choice MAY be performed automatically. However, this specification + does not define any standard for such automatic selection. + + Note: HTTP/1.1 servers are allowed to return responses which are + not acceptable according to the accept headers sent in the + request. In some cases, this may even be preferable to sending a + 406 response. User agents are encouraged to inspect the headers of + an incoming response to determine if it is acceptable. + + If the response could be unacceptable, a user agent SHOULD + temporarily stop receipt of more data and query the user for a + decision on further actions. + +10.4.8 407 Proxy Authentication Required + + This code is similar to 401 (Unauthorized), but indicates that the + client must first authenticate itself with the proxy. The proxy MUST + return a Proxy-Authenticate header field (section 14.33) containing a + challenge applicable to the proxy for the requested resource. The + client MAY repeat the request with a suitable Proxy-Authorization + header field (section 14.34). HTTP access authentication is explained + in "HTTP Authentication: Basic and Digest Access Authentication" + [43]. + +10.4.9 408 Request Timeout + + The client did not produce a request within the time that the server + was prepared to wait. The client MAY repeat the request without + modifications at any later time. + +10.4.10 409 Conflict + + The request could not be completed due to a conflict with the current + state of the resource. This code is only allowed in situations where + it is expected that the user might be able to resolve the conflict + and resubmit the request. The response body SHOULD include enough + + + +Fielding, et al. Standards Track [Page 67] + +RFC 2616 HTTP/1.1 June 1999 + + + information for the user to recognize the source of the conflict. + Ideally, the response entity would include enough information for the + user or user agent to fix the problem; however, that might not be + possible and is not required. + + Conflicts are most likely to occur in response to a PUT request. For + example, if versioning were being used and the entity being PUT + included changes to a resource which conflict with those made by an + earlier (third-party) request, the server might use the 409 response + to indicate that it can't complete the request. In this case, the + response entity would likely contain a list of the differences + between the two versions in a format defined by the response + Content-Type. + +10.4.11 410 Gone + + The requested resource is no longer available at the server and no + forwarding address is known. This condition is expected to be + considered permanent. Clients with link editing capabilities SHOULD + delete references to the Request-URI after user approval. If the + server does not know, or has no facility to determine, whether or not + the condition is permanent, the status code 404 (Not Found) SHOULD be + used instead. This response is cacheable unless indicated otherwise. + + The 410 response is primarily intended to assist the task of web + maintenance by notifying the recipient that the resource is + intentionally unavailable and that the server owners desire that + remote links to that resource be removed. Such an event is common for + limited-time, promotional services and for resources belonging to + individuals no longer working at the server's site. It is not + necessary to mark all permanently unavailable resources as "gone" or + to keep the mark for any length of time -- that is left to the + discretion of the server owner. + +10.4.12 411 Length Required + + The server refuses to accept the request without a defined Content- + Length. The client MAY repeat the request if it adds a valid + Content-Length header field containing the length of the message-body + in the request message. + +10.4.13 412 Precondition Failed + + The precondition given in one or more of the request-header fields + evaluated to false when it was tested on the server. This response + code allows the client to place preconditions on the current resource + metainformation (header field data) and thus prevent the requested + method from being applied to a resource other than the one intended. + + + +Fielding, et al. Standards Track [Page 68] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.14 413 Request Entity Too Large + + The server is refusing to process a request because the request + entity is larger than the server is willing or able to process. The + server MAY close the connection to prevent the client from continuing + the request. + + If the condition is temporary, the server SHOULD include a Retry- + After header field to indicate that it is temporary and after what + time the client MAY try again. + +10.4.15 414 Request-URI Too Long + + The server is refusing to service the request because the Request-URI + is longer than the server is willing to interpret. This rare + condition is only likely to occur when a client has improperly + converted a POST request to a GET request with long query + information, when the client has descended into a URI "black hole" of + redirection (e.g., a redirected URI prefix that points to a suffix of + itself), or when the server is under attack by a client attempting to + exploit security holes present in some servers using fixed-length + buffers for reading or manipulating the Request-URI. + +10.4.16 415 Unsupported Media Type + + The server is refusing to service the request because the entity of + the request is in a format not supported by the requested resource + for the requested method. + +10.4.17 416 Requested Range Not Satisfiable + + A server SHOULD return a response with this status code if a request + included a Range request-header field (section 14.35), and none of + the range-specifier values in this field overlap the current extent + of the selected resource, and the request did not include an If-Range + request-header field. (For byte-ranges, this means that the first- + byte-pos of all of the byte-range-spec values were greater than the + current length of the selected resource.) + + When this status code is returned for a byte-range request, the + response SHOULD include a Content-Range entity-header field + specifying the current length of the selected resource (see section + 14.16). This response MUST NOT use the multipart/byteranges content- + type. + + + + + + + +Fielding, et al. Standards Track [Page 69] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.18 417 Expectation Failed + + The expectation given in an Expect request-header field (see section + 14.20) could not be met by this server, or, if the server is a proxy, + the server has unambiguous evidence that the request could not be met + by the next-hop server. + +10.5 Server Error 5xx + + Response status codes beginning with the digit "5" indicate cases in + which the server is aware that it has erred or is incapable of + performing the request. Except when responding to a HEAD request, the + server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. User agents SHOULD display any included entity to the + user. These response codes are applicable to any request method. + +10.5.1 500 Internal Server Error + + The server encountered an unexpected condition which prevented it + from fulfilling the request. + +10.5.2 501 Not Implemented + + The server does not support the functionality required to fulfill the + request. This is the appropriate response when the server does not + recognize the request method and is not capable of supporting it for + any resource. + +10.5.3 502 Bad Gateway + + The server, while acting as a gateway or proxy, received an invalid + response from the upstream server it accessed in attempting to + fulfill the request. + +10.5.4 503 Service Unavailable + + The server is currently unable to handle the request due to a + temporary overloading or maintenance of the server. The implication + is that this is a temporary condition which will be alleviated after + some delay. If known, the length of the delay MAY be indicated in a + Retry-After header. If no Retry-After is given, the client SHOULD + handle the response as it would for a 500 response. + + Note: The existence of the 503 status code does not imply that a + server must use it when becoming overloaded. Some servers may wish + to simply refuse the connection. + + + + +Fielding, et al. Standards Track [Page 70] + +RFC 2616 HTTP/1.1 June 1999 + + +10.5.5 504 Gateway Timeout + + The server, while acting as a gateway or proxy, did not receive a + timely response from the upstream server specified by the URI (e.g. + HTTP, FTP, LDAP) or some other auxiliary server (e.g. DNS) it needed + to access in attempting to complete the request. + + Note: Note to implementors: some deployed proxies are known to + return 400 or 500 when DNS lookups time out. + +10.5.6 505 HTTP Version Not Supported + + The server does not support, or refuses to support, the HTTP protocol + version that was used in the request message. The server is + indicating that it is unable or unwilling to complete the request + using the same major version as the client, as described in section + 3.1, other than with this error message. The response SHOULD contain + an entity describing why that version is not supported and what other + protocols are supported by that server. + +11 Access Authentication + + HTTP provides several OPTIONAL challenge-response authentication + mechanisms which can be used by a server to challenge a client + request and by a client to provide authentication information. The + general framework for access authentication, and the specification of + "basic" and "digest" authentication, are specified in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. This + specification adopts the definitions of "challenge" and "credentials" + from that specification. + +12 Content Negotiation + + Most HTTP responses include an entity which contains information for + interpretation by a human user. Naturally, it is desirable to supply + the user with the "best available" entity corresponding to the + request. Unfortunately for servers and caches, not all users have the + same preferences for what is "best," and not all user agents are + equally capable of rendering all entity types. For that reason, HTTP + has provisions for several mechanisms for "content negotiation" -- + the process of selecting the best representation for a given response + when there are multiple representations available. + + Note: This is not called "format negotiation" because the + alternate representations may be of the same media type, but use + different capabilities of that type, be in different languages, + etc. + + + + +Fielding, et al. Standards Track [Page 71] + +RFC 2616 HTTP/1.1 June 1999 + + + Any response containing an entity-body MAY be subject to negotiation, + including error responses. + + There are two kinds of content negotiation which are possible in + HTTP: server-driven and agent-driven negotiation. These two kinds of + negotiation are orthogonal and thus may be used separately or in + combination. One method of combination, referred to as transparent + negotiation, occurs when a cache uses the agent-driven negotiation + information provided by the origin server in order to provide + server-driven negotiation for subsequent requests. + +12.1 Server-driven Negotiation + + If the selection of the best representation for a response is made by + an algorithm located at the server, it is called server-driven + negotiation. Selection is based on the available representations of + the response (the dimensions over which it can vary; e.g. language, + content-coding, etc.) and the contents of particular header fields in + the request message or on other information pertaining to the request + (such as the network address of the client). + + Server-driven negotiation is advantageous when the algorithm for + selecting from among the available representations is difficult to + describe to the user agent, or when the server desires to send its + "best guess" to the client along with the first response (hoping to + avoid the round-trip delay of a subsequent request if the "best + guess" is good enough for the user). In order to improve the server's + guess, the user agent MAY include request header fields (Accept, + Accept-Language, Accept-Encoding, etc.) which describe its + preferences for such a response. + + Server-driven negotiation has disadvantages: + + 1. It is impossible for the server to accurately determine what + might be "best" for any given user, since that would require + complete knowledge of both the capabilities of the user agent + and the intended use for the response (e.g., does the user want + to view it on screen or print it on paper?). + + 2. Having the user agent describe its capabilities in every + request can be both very inefficient (given that only a small + percentage of responses have multiple representations) and a + potential violation of the user's privacy. + + 3. It complicates the implementation of an origin server and the + algorithms for generating responses to a request. + + + + + +Fielding, et al. Standards Track [Page 72] + +RFC 2616 HTTP/1.1 June 1999 + + + 4. It may limit a public cache's ability to use the same response + for multiple user's requests. + + HTTP/1.1 includes the following request-header fields for enabling + server-driven negotiation through description of user agent + capabilities and user preferences: Accept (section 14.1), Accept- + Charset (section 14.2), Accept-Encoding (section 14.3), Accept- + Language (section 14.4), and User-Agent (section 14.43). However, an + origin server is not limited to these dimensions and MAY vary the + response based on any aspect of the request, including information + outside the request-header fields or within extension header fields + not defined by this specification. + + The Vary header field can be used to express the parameters the + server uses to select a representation that is subject to server- + driven negotiation. See section 13.6 for use of the Vary header field + by caches and section 14.44 for use of the Vary header field by + servers. + +12.2 Agent-driven Negotiation + + With agent-driven negotiation, selection of the best representation + for a response is performed by the user agent after receiving an + initial response from the origin server. Selection is based on a list + of the available representations of the response included within the + header fields or entity-body of the initial response, with each + representation identified by its own URI. Selection from among the + representations may be performed automatically (if the user agent is + capable of doing so) or manually by the user selecting from a + generated (possibly hypertext) menu. + + Agent-driven negotiation is advantageous when the response would vary + over commonly-used dimensions (such as type, language, or encoding), + when the origin server is unable to determine a user agent's + capabilities from examining the request, and generally when public + caches are used to distribute server load and reduce network usage. + + Agent-driven negotiation suffers from the disadvantage of needing a + second request to obtain the best alternate representation. This + second request is only efficient when caching is used. In addition, + this specification does not define any mechanism for supporting + automatic selection, though it also does not prevent any such + mechanism from being developed as an extension and used within + HTTP/1.1. + + + + + + + +Fielding, et al. Standards Track [Page 73] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 defines the 300 (Multiple Choices) and 406 (Not Acceptable) + status codes for enabling agent-driven negotiation when the server is + unwilling or unable to provide a varying response using server-driven + negotiation. + +12.3 Transparent Negotiation + + Transparent negotiation is a combination of both server-driven and + agent-driven negotiation. When a cache is supplied with a form of the + list of available representations of the response (as in agent-driven + negotiation) and the dimensions of variance are completely understood + by the cache, then the cache becomes capable of performing server- + driven negotiation on behalf of the origin server for subsequent + requests on that resource. + + Transparent negotiation has the advantage of distributing the + negotiation work that would otherwise be required of the origin + server and also removing the second request delay of agent-driven + negotiation when the cache is able to correctly guess the right + response. + + This specification does not define any mechanism for transparent + negotiation, though it also does not prevent any such mechanism from + being developed as an extension that could be used within HTTP/1.1. + +13 Caching in HTTP + + HTTP is typically used for distributed information systems, where + performance can be improved by the use of response caches. The + HTTP/1.1 protocol includes a number of elements intended to make + caching work as well as possible. Because these elements are + inextricable from other aspects of the protocol, and because they + interact with each other, it is useful to describe the basic caching + design of HTTP separately from the detailed descriptions of methods, + headers, response codes, etc. + + Caching would be useless if it did not significantly improve + performance. The goal of caching in HTTP/1.1 is to eliminate the need + to send requests in many cases, and to eliminate the need to send + full responses in many other cases. The former reduces the number of + network round-trips required for many operations; we use an + "expiration" mechanism for this purpose (see section 13.2). The + latter reduces network bandwidth requirements; we use a "validation" + mechanism for this purpose (see section 13.3). + + Requirements for performance, availability, and disconnected + operation require us to be able to relax the goal of semantic + transparency. The HTTP/1.1 protocol allows origin servers, caches, + + + +Fielding, et al. Standards Track [Page 74] + +RFC 2616 HTTP/1.1 June 1999 + + + and clients to explicitly reduce transparency when necessary. + However, because non-transparent operation may confuse non-expert + users, and might be incompatible with certain server applications + (such as those for ordering merchandise), the protocol requires that + transparency be relaxed + + - only by an explicit protocol-level request when relaxed by + client or origin server + + - only with an explicit warning to the end user when relaxed by + cache or client + + Therefore, the HTTP/1.1 protocol provides these important elements: + + 1. Protocol features that provide full semantic transparency when + this is required by all parties. + + 2. Protocol features that allow an origin server or user agent to + explicitly request and control non-transparent operation. + + 3. Protocol features that allow a cache to attach warnings to + responses that do not preserve the requested approximation of + semantic transparency. + + A basic principle is that it must be possible for the clients to + detect any potential relaxation of semantic transparency. + + Note: The server, cache, or client implementor might be faced with + design decisions not explicitly discussed in this specification. + If a decision might affect semantic transparency, the implementor + ought to err on the side of maintaining transparency unless a + careful and complete analysis shows significant benefits in + breaking transparency. + +13.1.1 Cache Correctness + + A correct cache MUST respond to a request with the most up-to-date + response held by the cache that is appropriate to the request (see + sections 13.2.5, 13.2.6, and 13.12) which meets one of the following + conditions: + + 1. It has been checked for equivalence with what the origin server + would have returned by revalidating the response with the + origin server (section 13.3); + + + + + + + +Fielding, et al. Standards Track [Page 75] + +RFC 2616 HTTP/1.1 June 1999 + + + 2. It is "fresh enough" (see section 13.2). In the default case, + this means it meets the least restrictive freshness requirement + of the client, origin server, and cache (see section 14.9); if + the origin server so specifies, it is the freshness requirement + of the origin server alone. + + If a stored response is not "fresh enough" by the most + restrictive freshness requirement of both the client and the + origin server, in carefully considered circumstances the cache + MAY still return the response with the appropriate Warning + header (see section 13.1.5 and 14.46), unless such a response + is prohibited (e.g., by a "no-store" cache-directive, or by a + "no-cache" cache-request-directive; see section 14.9). + + 3. It is an appropriate 304 (Not Modified), 305 (Proxy Redirect), + or error (4xx or 5xx) response message. + + If the cache can not communicate with the origin server, then a + correct cache SHOULD respond as above if the response can be + correctly served from the cache; if not it MUST return an error or + warning indicating that there was a communication failure. + + If a cache receives a response (either an entire response, or a 304 + (Not Modified) response) that it would normally forward to the + requesting client, and the received response is no longer fresh, the + cache SHOULD forward it to the requesting client without adding a new + Warning (but without removing any existing Warning headers). A cache + SHOULD NOT attempt to revalidate a response simply because that + response became stale in transit; this might lead to an infinite + loop. A user agent that receives a stale response without a Warning + MAY display a warning indication to the user. + +13.1.2 Warnings + + Whenever a cache returns a response that is neither first-hand nor + "fresh enough" (in the sense of condition 2 in section 13.1.1), it + MUST attach a warning to that effect, using a Warning general-header. + The Warning header and the currently defined warnings are described + in section 14.46. The warning allows clients to take appropriate + action. + + Warnings MAY be used for other purposes, both cache-related and + otherwise. The use of a warning, rather than an error status code, + distinguish these responses from true failures. + + Warnings are assigned three digit warn-codes. The first digit + indicates whether the Warning MUST or MUST NOT be deleted from a + stored cache entry after a successful revalidation: + + + +Fielding, et al. Standards Track [Page 76] + +RFC 2616 HTTP/1.1 June 1999 + + + 1xx Warnings that describe the freshness or revalidation status of + the response, and so MUST be deleted after a successful + revalidation. 1XX warn-codes MAY be generated by a cache only when + validating a cached entry. It MUST NOT be generated by clients. + + 2xx Warnings that describe some aspect of the entity body or entity + headers that is not rectified by a revalidation (for example, a + lossy compression of the entity bodies) and which MUST NOT be + deleted after a successful revalidation. + + See section 14.46 for the definitions of the codes themselves. + + HTTP/1.0 caches will cache all Warnings in responses, without + deleting the ones in the first category. Warnings in responses that + are passed to HTTP/1.0 caches carry an extra warning-date field, + which prevents a future HTTP/1.1 recipient from believing an + erroneously cached Warning. + + Warnings also carry a warning text. The text MAY be in any + appropriate natural language (perhaps based on the client's Accept + headers), and include an OPTIONAL indication of what character set is + used. + + Multiple warnings MAY be attached to a response (either by the origin + server or by a cache), including multiple warnings with the same code + number. For example, a server might provide the same warning with + texts in both English and Basque. + + When multiple warnings are attached to a response, it might not be + practical or reasonable to display all of them to the user. This + version of HTTP does not specify strict priority rules for deciding + which warnings to display and in what order, but does suggest some + heuristics. + +13.1.3 Cache-control Mechanisms + + The basic cache mechanisms in HTTP/1.1 (server-specified expiration + times and validators) are implicit directives to caches. In some + cases, a server or client might need to provide explicit directives + to the HTTP caches. We use the Cache-Control header for this purpose. + + The Cache-Control header allows a client or server to transmit a + variety of directives in either requests or responses. These + directives typically override the default caching algorithms. As a + general rule, if there is any apparent conflict between header + values, the most restrictive interpretation is applied (that is, the + one that is most likely to preserve semantic transparency). However, + + + + +Fielding, et al. Standards Track [Page 77] + +RFC 2616 HTTP/1.1 June 1999 + + + in some cases, cache-control directives are explicitly specified as + weakening the approximation of semantic transparency (for example, + "max-stale" or "public"). + + The cache-control directives are described in detail in section 14.9. + +13.1.4 Explicit User Agent Warnings + + Many user agents make it possible for users to override the basic + caching mechanisms. For example, the user agent might allow the user + to specify that cached entities (even explicitly stale ones) are + never validated. Or the user agent might habitually add "Cache- + Control: max-stale=3600" to every request. The user agent SHOULD NOT + default to either non-transparent behavior, or behavior that results + in abnormally ineffective caching, but MAY be explicitly configured + to do so by an explicit action of the user. + + If the user has overridden the basic caching mechanisms, the user + agent SHOULD explicitly indicate to the user whenever this results in + the display of information that might not meet the server's + transparency requirements (in particular, if the displayed entity is + known to be stale). Since the protocol normally allows the user agent + to determine if responses are stale or not, this indication need only + be displayed when this actually happens. The indication need not be a + dialog box; it could be an icon (for example, a picture of a rotting + fish) or some other indicator. + + If the user has overridden the caching mechanisms in a way that would + abnormally reduce the effectiveness of caches, the user agent SHOULD + continually indicate this state to the user (for example, by a + display of a picture of currency in flames) so that the user does not + inadvertently consume excess resources or suffer from excessive + latency. + +13.1.5 Exceptions to the Rules and Warnings + + In some cases, the operator of a cache MAY choose to configure it to + return stale responses even when not requested by clients. This + decision ought not be made lightly, but may be necessary for reasons + of availability or performance, especially when the cache is poorly + connected to the origin server. Whenever a cache returns a stale + response, it MUST mark it as such (using a Warning header) enabling + the client software to alert the user that there might be a potential + problem. + + + + + + + +Fielding, et al. Standards Track [Page 78] + +RFC 2616 HTTP/1.1 June 1999 + + + It also allows the user agent to take steps to obtain a first-hand or + fresh response. For this reason, a cache SHOULD NOT return a stale + response if the client explicitly requests a first-hand or fresh one, + unless it is impossible to comply for technical or policy reasons. + +13.1.6 Client-controlled Behavior + + While the origin server (and to a lesser extent, intermediate caches, + by their contribution to the age of a response) are the primary + source of expiration information, in some cases the client might need + to control a cache's decision about whether to return a cached + response without validating it. Clients do this using several + directives of the Cache-Control header. + + A client's request MAY specify the maximum age it is willing to + accept of an unvalidated response; specifying a value of zero forces + the cache(s) to revalidate all responses. A client MAY also specify + the minimum time remaining before a response expires. Both of these + options increase constraints on the behavior of caches, and so cannot + further relax the cache's approximation of semantic transparency. + + A client MAY also specify that it will accept stale responses, up to + some maximum amount of staleness. This loosens the constraints on the + caches, and so might violate the origin server's specified + constraints on semantic transparency, but might be necessary to + support disconnected operation, or high availability in the face of + poor connectivity. + +13.2 Expiration Model + +13.2.1 Server-Specified Expiration + + HTTP caching works best when caches can entirely avoid making + requests to the origin server. The primary mechanism for avoiding + requests is for an origin server to provide an explicit expiration + time in the future, indicating that a response MAY be used to satisfy + subsequent requests. In other words, a cache can return a fresh + response without first contacting the server. + + Our expectation is that servers will assign future explicit + expiration times to responses in the belief that the entity is not + likely to change, in a semantically significant way, before the + expiration time is reached. This normally preserves semantic + transparency, as long as the server's expiration times are carefully + chosen. + + + + + + +Fielding, et al. Standards Track [Page 79] + +RFC 2616 HTTP/1.1 June 1999 + + + The expiration mechanism applies only to responses taken from a cache + and not to first-hand responses forwarded immediately to the + requesting client. + + If an origin server wishes to force a semantically transparent cache + to validate every request, it MAY assign an explicit expiration time + in the past. This means that the response is always stale, and so the + cache SHOULD validate it before using it for subsequent requests. See + section 14.9.4 for a more restrictive way to force revalidation. + + If an origin server wishes to force any HTTP/1.1 cache, no matter how + it is configured, to validate every request, it SHOULD use the "must- + revalidate" cache-control directive (see section 14.9). + + Servers specify explicit expiration times using either the Expires + header, or the max-age directive of the Cache-Control header. + + An expiration time cannot be used to force a user agent to refresh + its display or reload a resource; its semantics apply only to caching + mechanisms, and such mechanisms need only check a resource's + expiration status when a new request for that resource is initiated. + See section 13.13 for an explanation of the difference between caches + and history mechanisms. + +13.2.2 Heuristic Expiration + + Since origin servers do not always provide explicit expiration times, + HTTP caches typically assign heuristic expiration times, employing + algorithms that use other header values (such as the Last-Modified + time) to estimate a plausible expiration time. The HTTP/1.1 + specification does not provide specific algorithms, but does impose + worst-case constraints on their results. Since heuristic expiration + times might compromise semantic transparency, they ought to used + cautiously, and we encourage origin servers to provide explicit + expiration times as much as possible. + +13.2.3 Age Calculations + + In order to know if a cached entry is fresh, a cache needs to know if + its age exceeds its freshness lifetime. We discuss how to calculate + the latter in section 13.2.4; this section describes how to calculate + the age of a response or cache entry. + + In this discussion, we use the term "now" to mean "the current value + of the clock at the host performing the calculation." Hosts that use + HTTP, but especially hosts running origin servers and caches, SHOULD + use NTP [28] or some similar protocol to synchronize their clocks to + a globally accurate time standard. + + + +Fielding, et al. Standards Track [Page 80] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 requires origin servers to send a Date header, if possible, + with every response, giving the time at which the response was + generated (see section 14.18). We use the term "date_value" to denote + the value of the Date header, in a form appropriate for arithmetic + operations. + + HTTP/1.1 uses the Age response-header to convey the estimated age of + the response message when obtained from a cache. The Age field value + is the cache's estimate of the amount of time since the response was + generated or revalidated by the origin server. + + In essence, the Age value is the sum of the time that the response + has been resident in each of the caches along the path from the + origin server, plus the amount of time it has been in transit along + network paths. + + We use the term "age_value" to denote the value of the Age header, in + a form appropriate for arithmetic operations. + + A response's age can be calculated in two entirely independent ways: + + 1. now minus date_value, if the local clock is reasonably well + synchronized to the origin server's clock. If the result is + negative, the result is replaced by zero. + + 2. age_value, if all of the caches along the response path + implement HTTP/1.1. + + Given that we have two independent ways to compute the age of a + response when it is received, we can combine these as + + corrected_received_age = max(now - date_value, age_value) + + and as long as we have either nearly synchronized clocks or all- + HTTP/1.1 paths, one gets a reliable (conservative) result. + + Because of network-imposed delays, some significant interval might + pass between the time that a server generates a response and the time + it is received at the next outbound cache or client. If uncorrected, + this delay could result in improperly low ages. + + Because the request that resulted in the returned Age value must have + been initiated prior to that Age value's generation, we can correct + for delays imposed by the network by recording the time at which the + request was initiated. Then, when an Age value is received, it MUST + be interpreted relative to the time the request was initiated, not + + + + + +Fielding, et al. Standards Track [Page 81] + +RFC 2616 HTTP/1.1 June 1999 + + + the time that the response was received. This algorithm results in + conservative behavior no matter how much delay is experienced. So, we + compute: + + corrected_initial_age = corrected_received_age + + (now - request_time) + + where "request_time" is the time (according to the local clock) when + the request that elicited this response was sent. + + Summary of age calculation algorithm, when a cache receives a + response: + + /* + * age_value + * is the value of Age: header received by the cache with + * this response. + * date_value + * is the value of the origin server's Date: header + * request_time + * is the (local) time when the cache made the request + * that resulted in this cached response + * response_time + * is the (local) time when the cache received the + * response + * now + * is the current (local) time + */ + + apparent_age = max(0, response_time - date_value); + corrected_received_age = max(apparent_age, age_value); + response_delay = response_time - request_time; + corrected_initial_age = corrected_received_age + response_delay; + resident_time = now - response_time; + current_age = corrected_initial_age + resident_time; + + The current_age of a cache entry is calculated by adding the amount + of time (in seconds) since the cache entry was last validated by the + origin server to the corrected_initial_age. When a response is + generated from a cache entry, the cache MUST include a single Age + header field in the response with a value equal to the cache entry's + current_age. + + The presence of an Age header field in a response implies that a + response is not first-hand. However, the converse is not true, since + the lack of an Age header field in a response does not imply that the + + + + + +Fielding, et al. Standards Track [Page 82] + +RFC 2616 HTTP/1.1 June 1999 + + + response is first-hand unless all caches along the request path are + compliant with HTTP/1.1 (i.e., older HTTP caches did not implement + the Age header field). + +13.2.4 Expiration Calculations + + In order to decide whether a response is fresh or stale, we need to + compare its freshness lifetime to its age. The age is calculated as + described in section 13.2.3; this section describes how to calculate + the freshness lifetime, and to determine if a response has expired. + In the discussion below, the values can be represented in any form + appropriate for arithmetic operations. + + We use the term "expires_value" to denote the value of the Expires + header. We use the term "max_age_value" to denote an appropriate + value of the number of seconds carried by the "max-age" directive of + the Cache-Control header in a response (see section 14.9.3). + + The max-age directive takes priority over Expires, so if max-age is + present in a response, the calculation is simply: + + freshness_lifetime = max_age_value + + Otherwise, if Expires is present in the response, the calculation is: + + freshness_lifetime = expires_value - date_value + + Note that neither of these calculations is vulnerable to clock skew, + since all of the information comes from the origin server. + + If none of Expires, Cache-Control: max-age, or Cache-Control: s- + maxage (see section 14.9.3) appears in the response, and the response + does not include other restrictions on caching, the cache MAY compute + a freshness lifetime using a heuristic. The cache MUST attach Warning + 113 to any response whose age is more than 24 hours if such warning + has not already been added. + + Also, if the response does have a Last-Modified time, the heuristic + expiration value SHOULD be no more than some fraction of the interval + since that time. A typical setting of this fraction might be 10%. + + The calculation to determine if a response has expired is quite + simple: + + response_is_fresh = (freshness_lifetime > current_age) + + + + + + +Fielding, et al. Standards Track [Page 83] + +RFC 2616 HTTP/1.1 June 1999 + + +13.2.5 Disambiguating Expiration Values + + Because expiration values are assigned optimistically, it is possible + for two caches to contain fresh values for the same resource that are + different. + + If a client performing a retrieval receives a non-first-hand response + for a request that was already fresh in its own cache, and the Date + header in its existing cache entry is newer than the Date on the new + response, then the client MAY ignore the response. If so, it MAY + retry the request with a "Cache-Control: max-age=0" directive (see + section 14.9), to force a check with the origin server. + + If a cache has two fresh responses for the same representation with + different validators, it MUST use the one with the more recent Date + header. This situation might arise because the cache is pooling + responses from other caches, or because a client has asked for a + reload or a revalidation of an apparently fresh cache entry. + +13.2.6 Disambiguating Multiple Responses + + Because a client might be receiving responses via multiple paths, so + that some responses flow through one set of caches and other + responses flow through a different set of caches, a client might + receive responses in an order different from that in which the origin + server sent them. We would like the client to use the most recently + generated response, even if older responses are still apparently + fresh. + + Neither the entity tag nor the expiration value can impose an + ordering on responses, since it is possible that a later response + intentionally carries an earlier expiration time. The Date values are + ordered to a granularity of one second. + + When a client tries to revalidate a cache entry, and the response it + receives contains a Date header that appears to be older than the one + for the existing entry, then the client SHOULD repeat the request + unconditionally, and include + + Cache-Control: max-age=0 + + to force any intermediate caches to validate their copies directly + with the origin server, or + + Cache-Control: no-cache + + to force any intermediate caches to obtain a new copy from the origin + server. + + + +Fielding, et al. Standards Track [Page 84] + +RFC 2616 HTTP/1.1 June 1999 + + + If the Date values are equal, then the client MAY use either response + (or MAY, if it is being extremely prudent, request a new response). + Servers MUST NOT depend on clients being able to choose + deterministically between responses generated during the same second, + if their expiration times overlap. + +13.3 Validation Model + + When a cache has a stale entry that it would like to use as a + response to a client's request, it first has to check with the origin + server (or possibly an intermediate cache with a fresh response) to + see if its cached entry is still usable. We call this "validating" + the cache entry. Since we do not want to have to pay the overhead of + retransmitting the full response if the cached entry is good, and we + do not want to pay the overhead of an extra round trip if the cached + entry is invalid, the HTTP/1.1 protocol supports the use of + conditional methods. + + The key protocol features for supporting conditional methods are + those concerned with "cache validators." When an origin server + generates a full response, it attaches some sort of validator to it, + which is kept with the cache entry. When a client (user agent or + proxy cache) makes a conditional request for a resource for which it + has a cache entry, it includes the associated validator in the + request. + + The server then checks that validator against the current validator + for the entity, and, if they match (see section 13.3.3), it responds + with a special status code (usually, 304 (Not Modified)) and no + entity-body. Otherwise, it returns a full response (including + entity-body). Thus, we avoid transmitting the full response if the + validator matches, and we avoid an extra round trip if it does not + match. + + In HTTP/1.1, a conditional request looks exactly the same as a normal + request for the same resource, except that it carries a special + header (which includes the validator) that implicitly turns the + method (usually, GET) into a conditional. + + The protocol includes both positive and negative senses of cache- + validating conditions. That is, it is possible to request either that + a method be performed if and only if a validator matches or if and + only if no validators match. + + + + + + + + +Fielding, et al. Standards Track [Page 85] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: a response that lacks a validator may still be cached, and + served from cache until it expires, unless this is explicitly + prohibited by a cache-control directive. However, a cache cannot + do a conditional retrieval if it does not have a validator for the + entity, which means it will not be refreshable after it expires. + +13.3.1 Last-Modified Dates + + The Last-Modified entity-header field value is often used as a cache + validator. In simple terms, a cache entry is considered to be valid + if the entity has not been modified since the Last-Modified value. + +13.3.2 Entity Tag Cache Validators + + The ETag response-header field value, an entity tag, provides for an + "opaque" cache validator. This might allow more reliable validation + in situations where it is inconvenient to store modification dates, + where the one-second resolution of HTTP date values is not + sufficient, or where the origin server wishes to avoid certain + paradoxes that might arise from the use of modification dates. + + Entity Tags are described in section 3.11. The headers used with + entity tags are described in sections 14.19, 14.24, 14.26 and 14.44. + +13.3.3 Weak and Strong Validators + + Since both origin servers and caches will compare two validators to + decide if they represent the same or different entities, one normally + would expect that if the entity (the entity-body or any entity- + headers) changes in any way, then the associated validator would + change as well. If this is true, then we call this validator a + "strong validator." + + However, there might be cases when a server prefers to change the + validator only on semantically significant changes, and not when + insignificant aspects of the entity change. A validator that does not + always change when the resource changes is a "weak validator." + + Entity tags are normally "strong validators," but the protocol + provides a mechanism to tag an entity tag as "weak." One can think of + a strong validator as one that changes whenever the bits of an entity + changes, while a weak value changes whenever the meaning of an entity + changes. Alternatively, one can think of a strong validator as part + of an identifier for a specific entity, while a weak validator is + part of an identifier for a set of semantically equivalent entities. + + Note: One example of a strong validator is an integer that is + incremented in stable storage every time an entity is changed. + + + +Fielding, et al. Standards Track [Page 86] + +RFC 2616 HTTP/1.1 June 1999 + + + An entity's modification time, if represented with one-second + resolution, could be a weak validator, since it is possible that + the resource might be modified twice during a single second. + + Support for weak validators is optional. However, weak validators + allow for more efficient caching of equivalent objects; for + example, a hit counter on a site is probably good enough if it is + updated every few days or weeks, and any value during that period + is likely "good enough" to be equivalent. + + A "use" of a validator is either when a client generates a request + and includes the validator in a validating header field, or when a + server compares two validators. + + Strong validators are usable in any context. Weak validators are only + usable in contexts that do not depend on exact equality of an entity. + For example, either kind is usable for a conditional GET of a full + entity. However, only a strong validator is usable for a sub-range + retrieval, since otherwise the client might end up with an internally + inconsistent entity. + + Clients MAY issue simple (non-subrange) GET requests with either weak + validators or strong validators. Clients MUST NOT use weak validators + in other forms of request. + + The only function that the HTTP/1.1 protocol defines on validators is + comparison. There are two validator comparison functions, depending + on whether the comparison context allows the use of weak validators + or not: + + - The strong comparison function: in order to be considered equal, + both validators MUST be identical in every way, and both MUST + NOT be weak. + + - The weak comparison function: in order to be considered equal, + both validators MUST be identical in every way, but either or + both of them MAY be tagged as "weak" without affecting the + result. + + An entity tag is strong unless it is explicitly tagged as weak. + Section 3.11 gives the syntax for entity tags. + + A Last-Modified time, when used as a validator in a request, is + implicitly weak unless it is possible to deduce that it is strong, + using the following rules: + + - The validator is being compared by an origin server to the + actual current validator for the entity and, + + + +Fielding, et al. Standards Track [Page 87] + +RFC 2616 HTTP/1.1 June 1999 + + + - That origin server reliably knows that the associated entity did + not change twice during the second covered by the presented + validator. + + or + + - The validator is about to be used by a client in an If- + Modified-Since or If-Unmodified-Since header, because the client + has a cache entry for the associated entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + or + + - The validator is being compared by an intermediate cache to the + validator stored in its cache entry for the entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + This method relies on the fact that if two different responses were + sent by the origin server during the same second, but both had the + same Last-Modified time, then at least one of those responses would + have a Date value equal to its Last-Modified time. The arbitrary 60- + second limit guards against the possibility that the Date and Last- + Modified values are generated from different clocks, or at somewhat + different times during the preparation of the response. An + implementation MAY use a value larger than 60 seconds, if it is + believed that 60 seconds is too short. + + If a client wishes to perform a sub-range retrieval on a value for + which it has only a Last-Modified time and no opaque validator, it + MAY do this only if the Last-Modified time is strong in the sense + described here. + + A cache or origin server receiving a conditional request, other than + a full-body GET request, MUST use the strong comparison function to + evaluate the condition. + + These rules allow HTTP/1.1 caches and clients to safely perform sub- + range retrievals on values that have been obtained from HTTP/1.0 + + + +Fielding, et al. Standards Track [Page 88] + +RFC 2616 HTTP/1.1 June 1999 + + + servers. + +13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates + + We adopt a set of rules and recommendations for origin servers, + clients, and caches regarding when various validator types ought to + be used, and for what purposes. + + HTTP/1.1 origin servers: + + - SHOULD send an entity tag validator unless it is not feasible to + generate one. + + - MAY send a weak entity tag instead of a strong entity tag, if + performance considerations support the use of weak entity tags, + or if it is unfeasible to send a strong entity tag. + + - SHOULD send a Last-Modified value if it is feasible to send one, + unless the risk of a breakdown in semantic transparency that + could result from using this date in an If-Modified-Since header + would lead to serious problems. + + In other words, the preferred behavior for an HTTP/1.1 origin server + is to send both a strong entity tag and a Last-Modified value. + + In order to be legal, a strong entity tag MUST change whenever the + associated entity value changes in any way. A weak entity tag SHOULD + change whenever the associated entity changes in a semantically + significant way. + + Note: in order to provide semantically transparent caching, an + origin server must avoid reusing a specific strong entity tag + value for two different entities, or reusing a specific weak + entity tag value for two semantically different entities. Cache + entries might persist for arbitrarily long periods, regardless of + expiration times, so it might be inappropriate to expect that a + cache will never again attempt to validate an entry using a + validator that it obtained at some point in the past. + + HTTP/1.1 clients: + + - If an entity tag has been provided by the origin server, MUST + use that entity tag in any cache-conditional request (using If- + Match or If-None-Match). + + - If only a Last-Modified value has been provided by the origin + server, SHOULD use that value in non-subrange cache-conditional + requests (using If-Modified-Since). + + + +Fielding, et al. Standards Track [Page 89] + +RFC 2616 HTTP/1.1 June 1999 + + + - If only a Last-Modified value has been provided by an HTTP/1.0 + origin server, MAY use that value in subrange cache-conditional + requests (using If-Unmodified-Since:). The user agent SHOULD + provide a way to disable this, in case of difficulty. + + - If both an entity tag and a Last-Modified value have been + provided by the origin server, SHOULD use both validators in + cache-conditional requests. This allows both HTTP/1.0 and + HTTP/1.1 caches to respond appropriately. + + An HTTP/1.1 origin server, upon receiving a conditional request that + includes both a Last-Modified date (e.g., in an If-Modified-Since or + If-Unmodified-Since header field) and one or more entity tags (e.g., + in an If-Match, If-None-Match, or If-Range header field) as cache + validators, MUST NOT return a response status of 304 (Not Modified) + unless doing so is consistent with all of the conditional header + fields in the request. + + An HTTP/1.1 caching proxy, upon receiving a conditional request that + includes both a Last-Modified date and one or more entity tags as + cache validators, MUST NOT return a locally cached response to the + client unless that cached response is consistent with all of the + conditional header fields in the request. + + Note: The general principle behind these rules is that HTTP/1.1 + servers and clients should transmit as much non-redundant + information as is available in their responses and requests. + HTTP/1.1 systems receiving this information will make the most + conservative assumptions about the validators they receive. + + HTTP/1.0 clients and caches will ignore entity tags. Generally, + last-modified values received or used by these systems will + support transparent and efficient caching, and so HTTP/1.1 origin + servers should provide Last-Modified values. In those rare cases + where the use of a Last-Modified value as a validator by an + HTTP/1.0 system could result in a serious problem, then HTTP/1.1 + origin servers should not provide one. + +13.3.5 Non-validating Conditionals + + The principle behind entity tags is that only the service author + knows the semantics of a resource well enough to select an + appropriate cache validation mechanism, and the specification of any + validator comparison function more complex than byte-equality would + open up a can of worms. Thus, comparisons of any other headers + (except Last-Modified, for compatibility with HTTP/1.0) are never + used for purposes of validating a cache entry. + + + + +Fielding, et al. Standards Track [Page 90] + +RFC 2616 HTTP/1.1 June 1999 + + +13.4 Response Cacheability + + Unless specifically constrained by a cache-control (section 14.9) + directive, a caching system MAY always store a successful response + (see section 13.8) as a cache entry, MAY return it without validation + if it is fresh, and MAY return it after successful validation. If + there is neither a cache validator nor an explicit expiration time + associated with a response, we do not expect it to be cached, but + certain caches MAY violate this expectation (for example, when little + or no network connectivity is available). A client can usually detect + that such a response was taken from a cache by comparing the Date + header to the current time. + + Note: some HTTP/1.0 caches are known to violate this expectation + without providing any Warning. + + However, in some cases it might be inappropriate for a cache to + retain an entity, or to return it in response to a subsequent + request. This might be because absolute semantic transparency is + deemed necessary by the service author, or because of security or + privacy considerations. Certain cache-control directives are + therefore provided so that the server can indicate that certain + resource entities, or portions thereof, are not to be cached + regardless of other considerations. + + Note that section 14.8 normally prevents a shared cache from saving + and returning a response to a previous request if that request + included an Authorization header. + + A response received with a status code of 200, 203, 206, 300, 301 or + 410 MAY be stored by a cache and used in reply to a subsequent + request, subject to the expiration mechanism, unless a cache-control + directive prohibits caching. However, a cache that does not support + the Range and Content-Range headers MUST NOT cache 206 (Partial + Content) responses. + + A response received with any other status code (e.g. status codes 302 + and 307) MUST NOT be returned in a reply to a subsequent request + unless there are cache-control directives or another header(s) that + explicitly allow it. For example, these include the following: an + Expires header (section 14.21); a "max-age", "s-maxage", "must- + revalidate", "proxy-revalidate", "public" or "private" cache-control + directive (section 14.9). + + + + + + + + +Fielding, et al. Standards Track [Page 91] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5 Constructing Responses From Caches + + The purpose of an HTTP cache is to store information received in + response to requests for use in responding to future requests. In + many cases, a cache simply returns the appropriate parts of a + response to the requester. However, if the cache holds a cache entry + based on a previous response, it might have to combine parts of a new + response with what is held in the cache entry. + +13.5.1 End-to-end and Hop-by-hop Headers + + For the purpose of defining the behavior of caches and non-caching + proxies, we divide HTTP headers into two categories: + + - End-to-end headers, which are transmitted to the ultimate + recipient of a request or response. End-to-end headers in + responses MUST be stored as part of a cache entry and MUST be + transmitted in any response formed from a cache entry. + + - Hop-by-hop headers, which are meaningful only for a single + transport-level connection, and are not stored by caches or + forwarded by proxies. + + The following HTTP/1.1 headers are hop-by-hop headers: + + - Connection + - Keep-Alive + - Proxy-Authenticate + - Proxy-Authorization + - TE + - Trailers + - Transfer-Encoding + - Upgrade + + All other headers defined by HTTP/1.1 are end-to-end headers. + + Other hop-by-hop headers MUST be listed in a Connection header, + (section 14.10) to be introduced into HTTP/1.1 (or later). + +13.5.2 Non-modifiable Headers + + Some features of the HTTP/1.1 protocol, such as Digest + Authentication, depend on the value of certain end-to-end headers. A + transparent proxy SHOULD NOT modify an end-to-end header unless the + definition of that header requires or specifically allows that. + + + + + + +Fielding, et al. Standards Track [Page 92] + +RFC 2616 HTTP/1.1 June 1999 + + + A transparent proxy MUST NOT modify any of the following fields in a + request or response, and it MUST NOT add any of these fields if not + already present: + + - Content-Location + + - Content-MD5 + + - ETag + + - Last-Modified + + A transparent proxy MUST NOT modify any of the following fields in a + response: + + - Expires + + but it MAY add any of these fields if not already present. If an + Expires header is added, it MUST be given a field-value identical to + that of the Date header in that response. + + A proxy MUST NOT modify or add any of the following fields in a + message that contains the no-transform cache-control directive, or in + any request: + + - Content-Encoding + + - Content-Range + + - Content-Type + + A non-transparent proxy MAY modify or add these fields to a message + that does not include no-transform, but if it does so, it MUST add a + Warning 214 (Transformation applied) if one does not already appear + in the message (see section 14.46). + + Warning: unnecessary modification of end-to-end headers might + cause authentication failures if stronger authentication + mechanisms are introduced in later versions of HTTP. Such + authentication mechanisms MAY rely on the values of header fields + not listed here. + + The Content-Length field of a request or response is added or deleted + according to the rules in section 4.4. A transparent proxy MUST + preserve the entity-length (section 7.2.2) of the entity-body, + although it MAY change the transfer-length (section 4.4). + + + + + +Fielding, et al. Standards Track [Page 93] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.3 Combining Headers + + When a cache makes a validating request to a server, and the server + provides a 304 (Not Modified) response or a 206 (Partial Content) + response, the cache then constructs a response to send to the + requesting client. + + If the status code is 304 (Not Modified), the cache uses the entity- + body stored in the cache entry as the entity-body of this outgoing + response. If the status code is 206 (Partial Content) and the ETag or + Last-Modified headers match exactly, the cache MAY combine the + contents stored in the cache entry with the new contents received in + the response and use the result as the entity-body of this outgoing + response, (see 13.5.4). + + The end-to-end headers stored in the cache entry are used for the + constructed response, except that + + - any stored Warning headers with warn-code 1xx (see section + 14.46) MUST be deleted from the cache entry and the forwarded + response. + + - any stored Warning headers with warn-code 2xx MUST be retained + in the cache entry and the forwarded response. + + - any end-to-end headers provided in the 304 or 206 response MUST + replace the corresponding headers from the cache entry. + + Unless the cache decides to remove the cache entry, it MUST also + replace the end-to-end headers stored with the cache entry with + corresponding headers received in the incoming response, except for + Warning headers as described immediately above. If a header field- + name in the incoming response matches more than one header in the + cache entry, all such old headers MUST be replaced. + + In other words, the set of end-to-end headers received in the + incoming response overrides all corresponding end-to-end headers + stored with the cache entry (except for stored Warning headers with + warn-code 1xx, which are deleted even if not overridden). + + Note: this rule allows an origin server to use a 304 (Not + Modified) or a 206 (Partial Content) response to update any header + associated with a previous response for the same entity or sub- + ranges thereof, although it might not always be meaningful or + correct to do so. This rule does not allow an origin server to use + a 304 (Not Modified) or a 206 (Partial Content) response to + entirely delete a header that it had provided with a previous + response. + + + +Fielding, et al. Standards Track [Page 94] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.4 Combining Byte Ranges + + A response might transfer only a subrange of the bytes of an entity- + body, either because the request included one or more Range + specifications, or because a connection was broken prematurely. After + several such transfers, a cache might have received several ranges of + the same entity-body. + + If a cache has a stored non-empty set of subranges for an entity, and + an incoming response transfers another subrange, the cache MAY + combine the new subrange with the existing set if both the following + conditions are met: + + - Both the incoming response and the cache entry have a cache + validator. + + - The two cache validators match using the strong comparison + function (see section 13.3.3). + + If either requirement is not met, the cache MUST use only the most + recent partial response (based on the Date values transmitted with + every response, and using the incoming response if these values are + equal or missing), and MUST discard the other partial information. + +13.6 Caching Negotiated Responses + + Use of server-driven content negotiation (section 12.1), as indicated + by the presence of a Vary header field in a response, alters the + conditions and procedure by which a cache can use the response for + subsequent requests. See section 14.44 for use of the Vary header + field by servers. + + A server SHOULD use the Vary header field to inform a cache of what + request-header fields were used to select among multiple + representations of a cacheable response subject to server-driven + negotiation. The set of header fields named by the Vary field value + is known as the "selecting" request-headers. + + When the cache receives a subsequent request whose Request-URI + specifies one or more cache entries including a Vary header field, + the cache MUST NOT use such a cache entry to construct a response to + the new request unless all of the selecting request-headers present + in the new request match the corresponding stored request-headers in + the original request. + + The selecting request-headers from two requests are defined to match + if and only if the selecting request-headers in the first request can + be transformed to the selecting request-headers in the second request + + + +Fielding, et al. Standards Track [Page 95] + +RFC 2616 HTTP/1.1 June 1999 + + + by adding or removing linear white space (LWS) at places where this + is allowed by the corresponding BNF, and/or combining multiple + message-header fields with the same field name following the rules + about message headers in section 4.2. + + A Vary header field-value of "*" always fails to match and subsequent + requests on that resource can only be properly interpreted by the + origin server. + + If the selecting request header fields for the cached entry do not + match the selecting request header fields of the new request, then + the cache MUST NOT use a cached entry to satisfy the request unless + it first relays the new request to the origin server in a conditional + request and the server responds with 304 (Not Modified), including an + entity tag or Content-Location that indicates the entity to be used. + + If an entity tag was assigned to a cached representation, the + forwarded request SHOULD be conditional and include the entity tags + in an If-None-Match header field from all its cache entries for the + resource. This conveys to the server the set of entities currently + held by the cache, so that if any one of these entities matches the + requested entity, the server can use the ETag header field in its 304 + (Not Modified) response to tell the cache which entry is appropriate. + If the entity-tag of the new response matches that of an existing + entry, the new response SHOULD be used to update the header fields of + the existing entry, and the result MUST be returned to the client. + + If any of the existing cache entries contains only partial content + for the associated entity, its entity-tag SHOULD NOT be included in + the If-None-Match header field unless the request is for a range that + would be fully satisfied by that entry. + + If a cache receives a successful response whose Content-Location + field matches that of an existing cache entry for the same Request- + ]URI, whose entity-tag differs from that of the existing entry, and + whose Date is more recent than that of the existing entry, the + existing entry SHOULD NOT be returned in response to future requests + and SHOULD be deleted from the cache. + +13.7 Shared and Non-Shared Caches + + For reasons of security and privacy, it is necessary to make a + distinction between "shared" and "non-shared" caches. A non-shared + cache is one that is accessible only to a single user. Accessibility + in this case SHOULD be enforced by appropriate security mechanisms. + All other caches are considered to be "shared." Other sections of + + + + + +Fielding, et al. Standards Track [Page 96] + +RFC 2616 HTTP/1.1 June 1999 + + + this specification place certain constraints on the operation of + shared caches in order to prevent loss of privacy or failure of + access controls. + +13.8 Errors or Incomplete Response Cache Behavior + + A cache that receives an incomplete response (for example, with fewer + bytes of data than specified in a Content-Length header) MAY store + the response. However, the cache MUST treat this as a partial + response. Partial responses MAY be combined as described in section + 13.5.4; the result might be a full response or might still be + partial. A cache MUST NOT return a partial response to a client + without explicitly marking it as such, using the 206 (Partial + Content) status code. A cache MUST NOT return a partial response + using a status code of 200 (OK). + + If a cache receives a 5xx response while attempting to revalidate an + entry, it MAY either forward this response to the requesting client, + or act as if the server failed to respond. In the latter case, it MAY + return a previously received response unless the cached entry + includes the "must-revalidate" cache-control directive (see section + 14.9). + +13.9 Side Effects of GET and HEAD + + Unless the origin server explicitly prohibits the caching of their + responses, the application of GET and HEAD methods to any resources + SHOULD NOT have side effects that would lead to erroneous behavior if + these responses are taken from a cache. They MAY still have side + effects, but a cache is not required to consider such side effects in + its caching decisions. Caches are always expected to observe an + origin server's explicit restrictions on caching. + + We note one exception to this rule: since some applications have + traditionally used GETs and HEADs with query URLs (those containing a + "?" in the rel_path part) to perform operations with significant side + effects, caches MUST NOT treat responses to such URIs as fresh unless + the server provides an explicit expiration time. This specifically + means that responses from HTTP/1.0 servers for such URIs SHOULD NOT + be taken from a cache. See section 9.1.1 for related information. + +13.10 Invalidation After Updates or Deletions + + The effect of certain methods performed on a resource at the origin + server might cause one or more existing cache entries to become non- + transparently invalid. That is, although they might continue to be + "fresh," they do not accurately reflect what the origin server would + return for a new request on that resource. + + + +Fielding, et al. Standards Track [Page 97] + +RFC 2616 HTTP/1.1 June 1999 + + + There is no way for the HTTP protocol to guarantee that all such + cache entries are marked invalid. For example, the request that + caused the change at the origin server might not have gone through + the proxy where a cache entry is stored. However, several rules help + reduce the likelihood of erroneous behavior. + + In this section, the phrase "invalidate an entity" means that the + cache will either remove all instances of that entity from its + storage, or will mark these as "invalid" and in need of a mandatory + revalidation before they can be returned in response to a subsequent + request. + + Some HTTP methods MUST cause a cache to invalidate an entity. This is + either the entity referred to by the Request-URI, or by the Location + or Content-Location headers (if present). These methods are: + + - PUT + + - DELETE + + - POST + + In order to prevent denial of service attacks, an invalidation based + on the URI in a Location or Content-Location header MUST only be + performed if the host part is the same as in the Request-URI. + + A cache that passes through requests for methods it does not + understand SHOULD invalidate any entities referred to by the + Request-URI. + +13.11 Write-Through Mandatory + + All methods that might be expected to cause modifications to the + origin server's resources MUST be written through to the origin + server. This currently includes all methods except for GET and HEAD. + A cache MUST NOT reply to such a request from a client before having + transmitted the request to the inbound server, and having received a + corresponding response from the inbound server. This does not prevent + a proxy cache from sending a 100 (Continue) response before the + inbound server has sent its final reply. + + The alternative (known as "write-back" or "copy-back" caching) is not + allowed in HTTP/1.1, due to the difficulty of providing consistent + updates and the problems arising from server, cache, or network + failure prior to write-back. + + + + + + +Fielding, et al. Standards Track [Page 98] + +RFC 2616 HTTP/1.1 June 1999 + + +13.12 Cache Replacement + + If a new cacheable (see sections 14.9.2, 13.2.5, 13.2.6 and 13.8) + response is received from a resource while any existing responses for + the same resource are cached, the cache SHOULD use the new response + to reply to the current request. It MAY insert it into cache storage + and MAY, if it meets all other requirements, use it to respond to any + future requests that would previously have caused the old response to + be returned. If it inserts the new response into cache storage the + rules in section 13.5.3 apply. + + Note: a new response that has an older Date header value than + existing cached responses is not cacheable. + +13.13 History Lists + + User agents often have history mechanisms, such as "Back" buttons and + history lists, which can be used to redisplay an entity retrieved + earlier in a session. + + History mechanisms and caches are different. In particular history + mechanisms SHOULD NOT try to show a semantically transparent view of + the current state of a resource. Rather, a history mechanism is meant + to show exactly what the user saw at the time when the resource was + retrieved. + + By default, an expiration time does not apply to history mechanisms. + If the entity is still in storage, a history mechanism SHOULD display + it even if the entity has expired, unless the user has specifically + configured the agent to refresh expired history documents. + + This is not to be construed to prohibit the history mechanism from + telling the user that a view might be stale. + + Note: if history list mechanisms unnecessarily prevent users from + viewing stale resources, this will tend to force service authors + to avoid using HTTP expiration controls and cache controls when + they would otherwise like to. Service authors may consider it + important that users not be presented with error messages or + warning messages when they use navigation controls (such as BACK) + to view previously fetched resources. Even though sometimes such + resources ought not to cached, or ought to expire quickly, user + interface considerations may force service authors to resort to + other means of preventing caching (e.g. "once-only" URLs) in order + not to suffer the effects of improperly functioning history + mechanisms. + + + + + +Fielding, et al. Standards Track [Page 99] + +RFC 2616 HTTP/1.1 June 1999 + + +14 Header Field Definitions + + This section defines the syntax and semantics of all standard + HTTP/1.1 header fields. For entity-header fields, both sender and + recipient refer to either the client or the server, depending on who + sends and who receives the entity. + +14.1 Accept + + The Accept request-header field can be used to specify certain media + types which are acceptable for the response. Accept headers can be + used to indicate that the request is specifically limited to a small + set of desired types, as in the case of a request for an in-line + image. + + Accept = "Accept" ":" + #( media-range [ accept-params ] ) + + media-range = ( "*/*" + | ( type "/" "*" ) + | ( type "/" subtype ) + ) *( ";" parameter ) + accept-params = ";" "q" "=" qvalue *( accept-extension ) + accept-extension = ";" token [ "=" ( token | quoted-string ) ] + + The asterisk "*" character is used to group media types into ranges, + with "*/*" indicating all media types and "type/*" indicating all + subtypes of that type. The media-range MAY include media type + parameters that are applicable to that range. + + Each media-range MAY be followed by one or more accept-params, + beginning with the "q" parameter for indicating a relative quality + factor. The first "q" parameter (if any) separates the media-range + parameter(s) from the accept-params. Quality factors allow the user + or user agent to indicate the relative degree of preference for that + media-range, using the qvalue scale from 0 to 1 (section 3.9). The + default value is q=1. + + Note: Use of the "q" parameter name to separate media type + parameters from Accept extension parameters is due to historical + practice. Although this prevents any media type parameter named + "q" from being used with a media range, such an event is believed + to be unlikely given the lack of any "q" parameters in the IANA + media type registry and the rare usage of any media type + parameters in Accept. Future media types are discouraged from + registering any parameter named "q". + + + + + +Fielding, et al. Standards Track [Page 100] + +RFC 2616 HTTP/1.1 June 1999 + + + The example + + Accept: audio/*; q=0.2, audio/basic + + SHOULD be interpreted as "I prefer audio/basic, but send me any audio + type if it is the best available after an 80% mark-down in quality." + + If no Accept header field is present, then it is assumed that the + client accepts all media types. If an Accept header field is present, + and if the server cannot send a response which is acceptable + according to the combined Accept field value, then the server SHOULD + send a 406 (not acceptable) response. + + A more elaborate example is + + Accept: text/plain; q=0.5, text/html, + text/x-dvi; q=0.8, text/x-c + + Verbally, this would be interpreted as "text/html and text/x-c are + the preferred media types, but if they do not exist, then send the + text/x-dvi entity, and if that does not exist, send the text/plain + entity." + + Media ranges can be overridden by more specific media ranges or + specific media types. If more than one media range applies to a given + type, the most specific reference has precedence. For example, + + Accept: text/*, text/html, text/html;level=1, */* + + have the following precedence: + + 1) text/html;level=1 + 2) text/html + 3) text/* + 4) */* + + The media type quality factor associated with a given type is + determined by finding the media range with the highest precedence + which matches that type. For example, + + Accept: text/*;q=0.3, text/html;q=0.7, text/html;level=1, + text/html;level=2;q=0.4, */*;q=0.5 + + would cause the following values to be associated: + + text/html;level=1 = 1 + text/html = 0.7 + text/plain = 0.3 + + + +Fielding, et al. Standards Track [Page 101] + +RFC 2616 HTTP/1.1 June 1999 + + + image/jpeg = 0.5 + text/html;level=2 = 0.4 + text/html;level=3 = 0.7 + + Note: A user agent might be provided with a default set of quality + values for certain media ranges. However, unless the user agent is + a closed system which cannot interact with other rendering agents, + this default set ought to be configurable by the user. + +14.2 Accept-Charset + + The Accept-Charset request-header field can be used to indicate what + character sets are acceptable for the response. This field allows + clients capable of understanding more comprehensive or special- + purpose character sets to signal that capability to a server which is + capable of representing documents in those character sets. + + Accept-Charset = "Accept-Charset" ":" + 1#( ( charset | "*" )[ ";" "q" "=" qvalue ] ) + + + Character set values are described in section 3.4. Each charset MAY + be given an associated quality value which represents the user's + preference for that charset. The default value is q=1. An example is + + Accept-Charset: iso-8859-5, unicode-1-1;q=0.8 + + The special value "*", if present in the Accept-Charset field, + matches every character set (including ISO-8859-1) which is not + mentioned elsewhere in the Accept-Charset field. If no "*" is present + in an Accept-Charset field, then all character sets not explicitly + mentioned get a quality value of 0, except for ISO-8859-1, which gets + a quality value of 1 if not explicitly mentioned. + + If no Accept-Charset header is present, the default is that any + character set is acceptable. If an Accept-Charset header is present, + and if the server cannot send a response which is acceptable + according to the Accept-Charset header, then the server SHOULD send + an error response with the 406 (not acceptable) status code, though + the sending of an unacceptable response is also allowed. + +14.3 Accept-Encoding + + The Accept-Encoding request-header field is similar to Accept, but + restricts the content-codings (section 3.5) that are acceptable in + the response. + + Accept-Encoding = "Accept-Encoding" ":" + + + +Fielding, et al. Standards Track [Page 102] + +RFC 2616 HTTP/1.1 June 1999 + + + 1#( codings [ ";" "q" "=" qvalue ] ) + codings = ( content-coding | "*" ) + + Examples of its use are: + + Accept-Encoding: compress, gzip + Accept-Encoding: + Accept-Encoding: * + Accept-Encoding: compress;q=0.5, gzip;q=1.0 + Accept-Encoding: gzip;q=1.0, identity; q=0.5, *;q=0 + + A server tests whether a content-coding is acceptable, according to + an Accept-Encoding field, using these rules: + + 1. If the content-coding is one of the content-codings listed in + the Accept-Encoding field, then it is acceptable, unless it is + accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + 2. The special "*" symbol in an Accept-Encoding field matches any + available content-coding not explicitly listed in the header + field. + + 3. If multiple content-codings are acceptable, then the acceptable + content-coding with the highest non-zero qvalue is preferred. + + 4. The "identity" content-coding is always acceptable, unless + specifically refused because the Accept-Encoding field includes + "identity;q=0", or because the field includes "*;q=0" and does + not explicitly include the "identity" content-coding. If the + Accept-Encoding field-value is empty, then only the "identity" + encoding is acceptable. + + If an Accept-Encoding field is present in a request, and if the + server cannot send a response which is acceptable according to the + Accept-Encoding header, then the server SHOULD send an error response + with the 406 (Not Acceptable) status code. + + If no Accept-Encoding field is present in a request, the server MAY + assume that the client will accept any content coding. In this case, + if "identity" is one of the available content-codings, then the + server SHOULD use the "identity" content-coding, unless it has + additional information that a different content-coding is meaningful + to the client. + + Note: If the request does not include an Accept-Encoding field, + and if the "identity" content-coding is unavailable, then + content-codings commonly understood by HTTP/1.0 clients (i.e., + + + +Fielding, et al. Standards Track [Page 103] + +RFC 2616 HTTP/1.1 June 1999 + + + "gzip" and "compress") are preferred; some older clients + improperly display messages sent with other content-codings. The + server might also make this decision based on information about + the particular user-agent or client. + + Note: Most HTTP/1.0 applications do not recognize or obey qvalues + associated with content-codings. This means that qvalues will not + work and are not permitted with x-gzip or x-compress. + +14.4 Accept-Language + + The Accept-Language request-header field is similar to Accept, but + restricts the set of natural languages that are preferred as a + response to the request. Language tags are defined in section 3.10. + + Accept-Language = "Accept-Language" ":" + 1#( language-range [ ";" "q" "=" qvalue ] ) + language-range = ( ( 1*8ALPHA *( "-" 1*8ALPHA ) ) | "*" ) + + Each language-range MAY be given an associated quality value which + represents an estimate of the user's preference for the languages + specified by that range. The quality value defaults to "q=1". For + example, + + Accept-Language: da, en-gb;q=0.8, en;q=0.7 + + would mean: "I prefer Danish, but will accept British English and + other types of English." A language-range matches a language-tag if + it exactly equals the tag, or if it exactly equals a prefix of the + tag such that the first tag character following the prefix is "-". + The special range "*", if present in the Accept-Language field, + matches every tag not matched by any other range present in the + Accept-Language field. + + Note: This use of a prefix matching rule does not imply that + language tags are assigned to languages in such a way that it is + always true that if a user understands a language with a certain + tag, then this user will also understand all languages with tags + for which this tag is a prefix. The prefix rule simply allows the + use of prefix tags if this is the case. + + The language quality factor assigned to a language-tag by the + Accept-Language field is the quality value of the longest language- + range in the field that matches the language-tag. If no language- + range in the field matches the tag, the language quality factor + assigned is 0. If no Accept-Language header is present in the + request, the server + + + + +Fielding, et al. Standards Track [Page 104] + +RFC 2616 HTTP/1.1 June 1999 + + + SHOULD assume that all languages are equally acceptable. If an + Accept-Language header is present, then all languages which are + assigned a quality factor greater than 0 are acceptable. + + It might be contrary to the privacy expectations of the user to send + an Accept-Language header with the complete linguistic preferences of + the user in every request. For a discussion of this issue, see + section 15.1.4. + + As intelligibility is highly dependent on the individual user, it is + recommended that client applications make the choice of linguistic + preference available to the user. If the choice is not made + available, then the Accept-Language header field MUST NOT be given in + the request. + + Note: When making the choice of linguistic preference available to + the user, we remind implementors of the fact that users are not + familiar with the details of language matching as described above, + and should provide appropriate guidance. As an example, users + might assume that on selecting "en-gb", they will be served any + kind of English document if British English is not available. A + user agent might suggest in such a case to add "en" to get the + best matching behavior. + +14.5 Accept-Ranges + + The Accept-Ranges response-header field allows the server to + indicate its acceptance of range requests for a resource: + + Accept-Ranges = "Accept-Ranges" ":" acceptable-ranges + acceptable-ranges = 1#range-unit | "none" + + Origin servers that accept byte-range requests MAY send + + Accept-Ranges: bytes + + but are not required to do so. Clients MAY generate byte-range + requests without having received this header for the resource + involved. Range units are defined in section 3.12. + + Servers that do not accept any kind of range request for a + resource MAY send + + Accept-Ranges: none + + to advise the client not to attempt a range request. + + + + + +Fielding, et al. Standards Track [Page 105] + +RFC 2616 HTTP/1.1 June 1999 + + +14.6 Age + + The Age response-header field conveys the sender's estimate of the + amount of time since the response (or its revalidation) was + generated at the origin server. A cached response is "fresh" if + its age does not exceed its freshness lifetime. Age values are + calculated as specified in section 13.2.3. + + Age = "Age" ":" age-value + age-value = delta-seconds + + Age values are non-negative decimal integers, representing time in + seconds. + + If a cache receives a value larger than the largest positive + integer it can represent, or if any of its age calculations + overflows, it MUST transmit an Age header with a value of + 2147483648 (2^31). An HTTP/1.1 server that includes a cache MUST + include an Age header field in every response generated from its + own cache. Caches SHOULD use an arithmetic type of at least 31 + bits of range. + +14.7 Allow + + The Allow entity-header field lists the set of methods supported + by the resource identified by the Request-URI. The purpose of this + field is strictly to inform the recipient of valid methods + associated with the resource. An Allow header field MUST be + present in a 405 (Method Not Allowed) response. + + Allow = "Allow" ":" #Method + + Example of use: + + Allow: GET, HEAD, PUT + + This field cannot prevent a client from trying other methods. + However, the indications given by the Allow header field value + SHOULD be followed. The actual set of allowed methods is defined + by the origin server at the time of each request. + + The Allow header field MAY be provided with a PUT request to + recommend the methods to be supported by the new or modified + resource. The server is not required to support these methods and + SHOULD include an Allow header in the response giving the actual + supported methods. + + + + + +Fielding, et al. Standards Track [Page 106] + +RFC 2616 HTTP/1.1 June 1999 + + + A proxy MUST NOT modify the Allow header field even if it does not + understand all the methods specified, since the user agent might + have other means of communicating with the origin server. + +14.8 Authorization + + A user agent that wishes to authenticate itself with a server-- + usually, but not necessarily, after receiving a 401 response--does + so by including an Authorization request-header field with the + request. The Authorization field value consists of credentials + containing the authentication information of the user agent for + the realm of the resource being requested. + + Authorization = "Authorization" ":" credentials + + HTTP access authentication is described in "HTTP Authentication: + Basic and Digest Access Authentication" [43]. If a request is + authenticated and a realm specified, the same credentials SHOULD + be valid for all other requests within this realm (assuming that + the authentication scheme itself does not require otherwise, such + as credentials that vary according to a challenge value or using + synchronized clocks). + + When a shared cache (see section 13.7) receives a request + containing an Authorization field, it MUST NOT return the + corresponding response as a reply to any other request, unless one + of the following specific exceptions holds: + + 1. If the response includes the "s-maxage" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But (if the specified maximum age has + passed) a proxy cache MUST first revalidate it with the origin + server, using the request-headers from the new request to allow + the origin server to authenticate the new request. (This is the + defined behavior for s-maxage.) If the response includes "s- + maxage=0", the proxy MUST always revalidate it before re-using + it. + + 2. If the response includes the "must-revalidate" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But if the response is stale, all caches + MUST first revalidate it with the origin server, using the + request-headers from the new request to allow the origin server + to authenticate the new request. + + 3. If the response includes the "public" cache-control directive, + it MAY be returned in reply to any subsequent request. + + + + +Fielding, et al. Standards Track [Page 107] + +RFC 2616 HTTP/1.1 June 1999 + + +14.9 Cache-Control + + The Cache-Control general-header field is used to specify directives + that MUST be obeyed by all caching mechanisms along the + request/response chain. The directives specify behavior intended to + prevent caches from adversely interfering with the request or + response. These directives typically override the default caching + algorithms. Cache directives are unidirectional in that the presence + of a directive in a request does not imply that the same directive is + to be given in the response. + + Note that HTTP/1.0 caches might not implement Cache-Control and + might only implement Pragma: no-cache (see section 14.32). + + Cache directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a cache- + directive for a specific cache. + + Cache-Control = "Cache-Control" ":" 1#cache-directive + + cache-directive = cache-request-directive + | cache-response-directive + + cache-request-directive = + "no-cache" ; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "max-age" "=" delta-seconds ; Section 14.9.3, 14.9.4 + | "max-stale" [ "=" delta-seconds ] ; Section 14.9.3 + | "min-fresh" "=" delta-seconds ; Section 14.9.3 + | "no-transform" ; Section 14.9.5 + | "only-if-cached" ; Section 14.9.4 + | cache-extension ; Section 14.9.6 + + cache-response-directive = + "public" ; Section 14.9.1 + | "private" [ "=" <"> 1#field-name <"> ] ; Section 14.9.1 + | "no-cache" [ "=" <"> 1#field-name <"> ]; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "no-transform" ; Section 14.9.5 + | "must-revalidate" ; Section 14.9.4 + | "proxy-revalidate" ; Section 14.9.4 + | "max-age" "=" delta-seconds ; Section 14.9.3 + | "s-maxage" "=" delta-seconds ; Section 14.9.3 + | cache-extension ; Section 14.9.6 + + cache-extension = token [ "=" ( token | quoted-string ) ] + + + +Fielding, et al. Standards Track [Page 108] + +RFC 2616 HTTP/1.1 June 1999 + + + When a directive appears without any 1#field-name parameter, the + directive applies to the entire request or response. When such a + directive appears with a 1#field-name parameter, it applies only to + the named field or fields, and not to the rest of the request or + response. This mechanism supports extensibility; implementations of + future versions of the HTTP protocol might apply these directives to + header fields not defined in HTTP/1.1. + + The cache-control directives can be broken down into these general + categories: + + - Restrictions on what are cacheable; these may only be imposed by + the origin server. + + - Restrictions on what may be stored by a cache; these may be + imposed by either the origin server or the user agent. + + - Modifications of the basic expiration mechanism; these may be + imposed by either the origin server or the user agent. + + - Controls over cache revalidation and reload; these may only be + imposed by a user agent. + + - Control over transformation of entities. + + - Extensions to the caching system. + +14.9.1 What is Cacheable + + By default, a response is cacheable if the requirements of the + request method, request header fields, and the response status + indicate that it is cacheable. Section 13.4 summarizes these defaults + for cacheability. The following Cache-Control response directives + allow an origin server to override the default cacheability of a + response: + + public + Indicates that the response MAY be cached by any cache, even if it + would normally be non-cacheable or cacheable only within a non- + shared cache. (See also Authorization, section 14.8, for + additional details.) + + private + Indicates that all or part of the response message is intended for + a single user and MUST NOT be cached by a shared cache. This + allows an origin server to state that the specified parts of the + + + + + +Fielding, et al. Standards Track [Page 109] + +RFC 2616 HTTP/1.1 June 1999 + + + response are intended for only one user and are not a valid + response for requests by other users. A private (non-shared) cache + MAY cache the response. + + Note: This usage of the word private only controls where the + response may be cached, and cannot ensure the privacy of the + message content. + + no-cache + If the no-cache directive does not specify a field-name, then a + cache MUST NOT use the response to satisfy a subsequent request + without successful revalidation with the origin server. This + allows an origin server to prevent caching even by caches that + have been configured to return stale responses to client requests. + + If the no-cache directive does specify one or more field-names, + then a cache MAY use the response to satisfy a subsequent request, + subject to any other restrictions on caching. However, the + specified field-name(s) MUST NOT be sent in the response to a + subsequent request without successful revalidation with the origin + server. This allows an origin server to prevent the re-use of + certain header fields in a response, while still allowing caching + of the rest of the response. + + Note: Most HTTP/1.0 caches will not recognize or obey this + directive. + +14.9.2 What May be Stored by Caches + + no-store + The purpose of the no-store directive is to prevent the + inadvertent release or retention of sensitive information (for + example, on backup tapes). The no-store directive applies to the + entire message, and MAY be sent either in a response or in a + request. If sent in a request, a cache MUST NOT store any part of + either this request or any response to it. If sent in a response, + a cache MUST NOT store any part of either this response or the + request that elicited it. This directive applies to both non- + shared and shared caches. "MUST NOT store" in this context means + that the cache MUST NOT intentionally store the information in + non-volatile storage, and MUST make a best-effort attempt to + remove the information from volatile storage as promptly as + possible after forwarding it. + + Even when this directive is associated with a response, users + might explicitly store such a response outside of the caching + system (e.g., with a "Save As" dialog). History buffers MAY store + such responses as part of their normal operation. + + + +Fielding, et al. Standards Track [Page 110] + +RFC 2616 HTTP/1.1 June 1999 + + + The purpose of this directive is to meet the stated requirements + of certain users and service authors who are concerned about + accidental releases of information via unanticipated accesses to + cache data structures. While the use of this directive might + improve privacy in some cases, we caution that it is NOT in any + way a reliable or sufficient mechanism for ensuring privacy. In + particular, malicious or compromised caches might not recognize or + obey this directive, and communications networks might be + vulnerable to eavesdropping. + +14.9.3 Modifications of the Basic Expiration Mechanism + + The expiration time of an entity MAY be specified by the origin + server using the Expires header (see section 14.21). Alternatively, + it MAY be specified using the max-age directive in a response. When + the max-age cache-control directive is present in a cached response, + the response is stale if its current age is greater than the age + value given (in seconds) at the time of a new request for that + resource. The max-age directive on a response implies that the + response is cacheable (i.e., "public") unless some other, more + restrictive cache directive is also present. + + If a response includes both an Expires header and a max-age + directive, the max-age directive overrides the Expires header, even + if the Expires header is more restrictive. This rule allows an origin + server to provide, for a given response, a longer expiration time to + an HTTP/1.1 (or later) cache than to an HTTP/1.0 cache. This might be + useful if certain HTTP/1.0 caches improperly calculate ages or + expiration times, perhaps due to desynchronized clocks. + + Many HTTP/1.0 cache implementations will treat an Expires value that + is less than or equal to the response Date value as being equivalent + to the Cache-Control response directive "no-cache". If an HTTP/1.1 + cache receives such a response, and the response does not include a + Cache-Control header field, it SHOULD consider the response to be + non-cacheable in order to retain compatibility with HTTP/1.0 servers. + + Note: An origin server might wish to use a relatively new HTTP + cache control feature, such as the "private" directive, on a + network including older caches that do not understand that + feature. The origin server will need to combine the new feature + with an Expires field whose value is less than or equal to the + Date value. This will prevent older caches from improperly + caching the response. + + + + + + + +Fielding, et al. Standards Track [Page 111] + +RFC 2616 HTTP/1.1 June 1999 + + + s-maxage + If a response includes an s-maxage directive, then for a shared + cache (but not for a private cache), the maximum age specified by + this directive overrides the maximum age specified by either the + max-age directive or the Expires header. The s-maxage directive + also implies the semantics of the proxy-revalidate directive (see + section 14.9.4), i.e., that the shared cache must not use the + entry after it becomes stale to respond to a subsequent request + without first revalidating it with the origin server. The s- + maxage directive is always ignored by a private cache. + + Note that most older caches, not compliant with this specification, + do not implement any cache-control directives. An origin server + wishing to use a cache-control directive that restricts, but does not + prevent, caching by an HTTP/1.1-compliant cache MAY exploit the + requirement that the max-age directive overrides the Expires header, + and the fact that pre-HTTP/1.1-compliant caches do not observe the + max-age directive. + + Other directives allow a user agent to modify the basic expiration + mechanism. These directives MAY be specified on a request: + + max-age + Indicates that the client is willing to accept a response whose + age is no greater than the specified time in seconds. Unless max- + stale directive is also included, the client is not willing to + accept a stale response. + + min-fresh + Indicates that the client is willing to accept a response whose + freshness lifetime is no less than its current age plus the + specified time in seconds. That is, the client wants a response + that will still be fresh for at least the specified number of + seconds. + + max-stale + Indicates that the client is willing to accept a response that has + exceeded its expiration time. If max-stale is assigned a value, + then the client is willing to accept a response that has exceeded + its expiration time by no more than the specified number of + seconds. If no value is assigned to max-stale, then the client is + willing to accept a stale response of any age. + + If a cache returns a stale response, either because of a max-stale + directive on a request, or because the cache is configured to + override the expiration time of a response, the cache MUST attach a + Warning header to the stale response, using Warning 110 (Response is + stale). + + + +Fielding, et al. Standards Track [Page 112] + +RFC 2616 HTTP/1.1 June 1999 + + + A cache MAY be configured to return stale responses without + validation, but only if this does not conflict with any "MUST"-level + requirements concerning cache validation (e.g., a "must-revalidate" + cache-control directive). + + If both the new request and the cached entry include "max-age" + directives, then the lesser of the two values is used for determining + the freshness of the cached entry for that request. + +14.9.4 Cache Revalidation and Reload Controls + + Sometimes a user agent might want or need to insist that a cache + revalidate its cache entry with the origin server (and not just with + the next cache along the path to the origin server), or to reload its + cache entry from the origin server. End-to-end revalidation might be + necessary if either the cache or the origin server has overestimated + the expiration time of the cached response. End-to-end reload may be + necessary if the cache entry has become corrupted for some reason. + + End-to-end revalidation may be requested either when the client does + not have its own local cached copy, in which case we call it + "unspecified end-to-end revalidation", or when the client does have a + local cached copy, in which case we call it "specific end-to-end + revalidation." + + The client can specify these three kinds of action using Cache- + Control request directives: + + End-to-end reload + The request includes a "no-cache" cache-control directive or, for + compatibility with HTTP/1.0 clients, "Pragma: no-cache". Field + names MUST NOT be included with the no-cache directive in a + request. The server MUST NOT use a cached copy when responding to + such a request. + + Specific end-to-end revalidation + The request includes a "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request includes a cache-validating conditional with + the client's current validator. + + Unspecified end-to-end revalidation + The request includes "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request does not include a cache-validating + + + + +Fielding, et al. Standards Track [Page 113] + +RFC 2616 HTTP/1.1 June 1999 + + + conditional; the first cache along the path (if any) that holds a + cache entry for this resource includes a cache-validating + conditional with its current validator. + + max-age + When an intermediate cache is forced, by means of a max-age=0 + directive, to revalidate its own cache entry, and the client has + supplied its own validator in the request, the supplied validator + might differ from the validator currently stored with the cache + entry. In this case, the cache MAY use either validator in making + its own request without affecting semantic transparency. + + However, the choice of validator might affect performance. The + best approach is for the intermediate cache to use its own + validator when making its request. If the server replies with 304 + (Not Modified), then the cache can return its now validated copy + to the client with a 200 (OK) response. If the server replies with + a new entity and cache validator, however, the intermediate cache + can compare the returned validator with the one provided in the + client's request, using the strong comparison function. If the + client's validator is equal to the origin server's, then the + intermediate cache simply returns 304 (Not Modified). Otherwise, + it returns the new entity with a 200 (OK) response. + + If a request includes the no-cache directive, it SHOULD NOT + include min-fresh, max-stale, or max-age. + + only-if-cached + In some cases, such as times of extremely poor network + connectivity, a client may want a cache to return only those + responses that it currently has stored, and not to reload or + revalidate with the origin server. To do this, the client may + include the only-if-cached directive in a request. If it receives + this directive, a cache SHOULD either respond using a cached entry + that is consistent with the other constraints of the request, or + respond with a 504 (Gateway Timeout) status. However, if a group + of caches is being operated as a unified system with good internal + connectivity, such a request MAY be forwarded within that group of + caches. + + must-revalidate + Because a cache MAY be configured to ignore a server's specified + expiration time, and because a client request MAY include a max- + stale directive (which has a similar effect), the protocol also + includes a mechanism for the origin server to require revalidation + of a cache entry on any subsequent use. When the must-revalidate + directive is present in a response received by a cache, that cache + MUST NOT use the entry after it becomes stale to respond to a + + + +Fielding, et al. Standards Track [Page 114] + +RFC 2616 HTTP/1.1 June 1999 + + + subsequent request without first revalidating it with the origin + server. (I.e., the cache MUST do an end-to-end revalidation every + time, if, based solely on the origin server's Expires or max-age + value, the cached response is stale.) + + The must-revalidate directive is necessary to support reliable + operation for certain protocol features. In all circumstances an + HTTP/1.1 cache MUST obey the must-revalidate directive; in + particular, if the cache cannot reach the origin server for any + reason, it MUST generate a 504 (Gateway Timeout) response. + + Servers SHOULD send the must-revalidate directive if and only if + failure to revalidate a request on the entity could result in + incorrect operation, such as a silently unexecuted financial + transaction. Recipients MUST NOT take any automated action that + violates this directive, and MUST NOT automatically provide an + unvalidated copy of the entity if revalidation fails. + + Although this is not recommended, user agents operating under + severe connectivity constraints MAY violate this directive but, if + so, MUST explicitly warn the user that an unvalidated response has + been provided. The warning MUST be provided on each unvalidated + access, and SHOULD require explicit user confirmation. + + proxy-revalidate + The proxy-revalidate directive has the same meaning as the must- + revalidate directive, except that it does not apply to non-shared + user agent caches. It can be used on a response to an + authenticated request to permit the user's cache to store and + later return the response without needing to revalidate it (since + it has already been authenticated once by that user), while still + requiring proxies that service many users to revalidate each time + (in order to make sure that each user has been authenticated). + Note that such authenticated responses also need the public cache + control directive in order to allow them to be cached at all. + +14.9.5 No-Transform Directive + + no-transform + Implementors of intermediate caches (proxies) have found it useful + to convert the media type of certain entity bodies. A non- + transparent proxy might, for example, convert between image + formats in order to save cache space or to reduce the amount of + traffic on a slow link. + + Serious operational problems occur, however, when these + transformations are applied to entity bodies intended for certain + kinds of applications. For example, applications for medical + + + +Fielding, et al. Standards Track [Page 115] + +RFC 2616 HTTP/1.1 June 1999 + + + imaging, scientific data analysis and those using end-to-end + authentication, all depend on receiving an entity body that is bit + for bit identical to the original entity-body. + + Therefore, if a message includes the no-transform directive, an + intermediate cache or proxy MUST NOT change those headers that are + listed in section 13.5.2 as being subject to the no-transform + directive. This implies that the cache or proxy MUST NOT change + any aspect of the entity-body that is specified by these headers, + including the value of the entity-body itself. + +14.9.6 Cache Control Extensions + + The Cache-Control header field can be extended through the use of one + or more cache-extension tokens, each with an optional assigned value. + Informational extensions (those which do not require a change in + cache behavior) MAY be added without changing the semantics of other + directives. Behavioral extensions are designed to work by acting as + modifiers to the existing base of cache directives. Both the new + directive and the standard directive are supplied, such that + applications which do not understand the new directive will default + to the behavior specified by the standard directive, and those that + understand the new directive will recognize it as modifying the + requirements associated with the standard directive. In this way, + extensions to the cache-control directives can be made without + requiring changes to the base protocol. + + This extension mechanism depends on an HTTP cache obeying all of the + cache-control directives defined for its native HTTP-version, obeying + certain extensions, and ignoring all directives that it does not + understand. + + For example, consider a hypothetical new response directive called + community which acts as a modifier to the private directive. We + define this new directive to mean that, in addition to any non-shared + cache, any cache which is shared only by members of the community + named within its value may cache the response. An origin server + wishing to allow the UCI community to use an otherwise private + response in their shared cache(s) could do so by including + + Cache-Control: private, community="UCI" + + A cache seeing this header field will act correctly even if the cache + does not understand the community cache-extension, since it will also + see and understand the private directive and thus default to the safe + behavior. + + + + + +Fielding, et al. Standards Track [Page 116] + +RFC 2616 HTTP/1.1 June 1999 + + + Unrecognized cache-directives MUST be ignored; it is assumed that any + cache-directive likely to be unrecognized by an HTTP/1.1 cache will + be combined with standard directives (or the response's default + cacheability) such that the cache behavior will remain minimally + correct even if the cache does not understand the extension(s). + +14.10 Connection + + The Connection general-header field allows the sender to specify + options that are desired for that particular connection and MUST NOT + be communicated by proxies over further connections. + + The Connection header has the following grammar: + + Connection = "Connection" ":" 1#(connection-token) + connection-token = token + + HTTP/1.1 proxies MUST parse the Connection header field before a + message is forwarded and, for each connection-token in this field, + remove any header field(s) from the message with the same name as the + connection-token. Connection options are signaled by the presence of + a connection-token in the Connection header field, not by any + corresponding additional header field(s), since the additional header + field may not be sent if there are no parameters associated with that + connection option. + + Message headers listed in the Connection header MUST NOT include + end-to-end headers, such as Cache-Control. + + HTTP/1.1 defines the "close" connection option for the sender to + signal that the connection will be closed after completion of the + response. For example, + + Connection: close + + in either the request or the response header fields indicates that + the connection SHOULD NOT be considered `persistent' (section 8.1) + after the current request/response is complete. + + HTTP/1.1 applications that do not support persistent connections MUST + include the "close" connection option in every message. + + A system receiving an HTTP/1.0 (or lower-version) message that + includes a Connection header MUST, for each connection-token in this + field, remove and ignore any header field(s) from the message with + the same name as the connection-token. This protects against mistaken + forwarding of such header fields by pre-HTTP/1.1 proxies. See section + 19.6.2. + + + +Fielding, et al. Standards Track [Page 117] + +RFC 2616 HTTP/1.1 June 1999 + + +14.11 Content-Encoding + + The Content-Encoding entity-header field is used as a modifier to the + media-type. When present, its value indicates what additional content + codings have been applied to the entity-body, and thus what decoding + mechanisms must be applied in order to obtain the media-type + referenced by the Content-Type header field. Content-Encoding is + primarily used to allow a document to be compressed without losing + the identity of its underlying media type. + + Content-Encoding = "Content-Encoding" ":" 1#content-coding + + Content codings are defined in section 3.5. An example of its use is + + Content-Encoding: gzip + + The content-coding is a characteristic of the entity identified by + the Request-URI. Typically, the entity-body is stored with this + encoding and is only decoded before rendering or analogous usage. + However, a non-transparent proxy MAY modify the content-coding if the + new coding is known to be acceptable to the recipient, unless the + "no-transform" cache-control directive is present in the message. + + If the content-coding of an entity is not "identity", then the + response MUST include a Content-Encoding entity-header (section + 14.11) that lists the non-identity content-coding(s) used. + + If the content-coding of an entity in a request message is not + acceptable to the origin server, the server SHOULD respond with a + status code of 415 (Unsupported Media Type). + + If multiple encodings have been applied to an entity, the content + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + +14.12 Content-Language + + The Content-Language entity-header field describes the natural + language(s) of the intended audience for the enclosed entity. Note + that this might not be equivalent to all the languages used within + the entity-body. + + Content-Language = "Content-Language" ":" 1#language-tag + + + + + + + +Fielding, et al. Standards Track [Page 118] + +RFC 2616 HTTP/1.1 June 1999 + + + Language tags are defined in section 3.10. The primary purpose of + Content-Language is to allow a user to identify and differentiate + entities according to the user's own preferred language. Thus, if the + body content is intended only for a Danish-literate audience, the + appropriate field is + + Content-Language: da + + If no Content-Language is specified, the default is that the content + is intended for all language audiences. This might mean that the + sender does not consider it to be specific to any natural language, + or that the sender does not know for which language it is intended. + + Multiple languages MAY be listed for content that is intended for + multiple audiences. For example, a rendition of the "Treaty of + Waitangi," presented simultaneously in the original Maori and English + versions, would call for + + Content-Language: mi, en + + However, just because multiple languages are present within an entity + does not mean that it is intended for multiple linguistic audiences. + An example would be a beginner's language primer, such as "A First + Lesson in Latin," which is clearly intended to be used by an + English-literate audience. In this case, the Content-Language would + properly only include "en". + + Content-Language MAY be applied to any media type -- it is not + limited to textual documents. + +14.13 Content-Length + + The Content-Length entity-header field indicates the size of the + entity-body, in decimal number of OCTETs, sent to the recipient or, + in the case of the HEAD method, the size of the entity-body that + would have been sent had the request been a GET. + + Content-Length = "Content-Length" ":" 1*DIGIT + + An example is + + Content-Length: 3495 + + Applications SHOULD use this field to indicate the transfer-length of + the message-body, unless this is prohibited by the rules in section + 4.4. + + + + + +Fielding, et al. Standards Track [Page 119] + +RFC 2616 HTTP/1.1 June 1999 + + + Any Content-Length greater than or equal to zero is a valid value. + Section 4.4 describes how to determine the length of a message-body + if a Content-Length is not given. + + Note that the meaning of this field is significantly different from + the corresponding definition in MIME, where it is an optional field + used within the "message/external-body" content-type. In HTTP, it + SHOULD be sent whenever the message's length can be determined prior + to being transferred, unless this is prohibited by the rules in + section 4.4. + +14.14 Content-Location + + The Content-Location entity-header field MAY be used to supply the + resource location for the entity enclosed in the message when that + entity is accessible from a location separate from the requested + resource's URI. A server SHOULD provide a Content-Location for the + variant corresponding to the response entity; especially in the case + where a resource has multiple entities associated with it, and those + entities actually have separate locations by which they might be + individually accessed, the server SHOULD provide a Content-Location + for the particular variant which is returned. + + Content-Location = "Content-Location" ":" + ( absoluteURI | relativeURI ) + + The value of Content-Location also defines the base URI for the + entity. + + The Content-Location value is not a replacement for the original + requested URI; it is only a statement of the location of the resource + corresponding to this particular entity at the time of the request. + Future requests MAY specify the Content-Location URI as the request- + URI if the desire is to identify the source of that particular + entity. + + A cache cannot assume that an entity with a Content-Location + different from the URI used to retrieve it can be used to respond to + later requests on that Content-Location URI. However, the Content- + Location can be used to differentiate between multiple entities + retrieved from a single requested resource, as described in section + 13.6. + + If the Content-Location is a relative URI, the relative URI is + interpreted relative to the Request-URI. + + The meaning of the Content-Location header in PUT or POST requests is + undefined; servers are free to ignore it in those cases. + + + +Fielding, et al. Standards Track [Page 120] + +RFC 2616 HTTP/1.1 June 1999 + + +14.15 Content-MD5 + + The Content-MD5 entity-header field, as defined in RFC 1864 [23], is + an MD5 digest of the entity-body for the purpose of providing an + end-to-end message integrity check (MIC) of the entity-body. (Note: a + MIC is good for detecting accidental modification of the entity-body + in transit, but is not proof against malicious attacks.) + + Content-MD5 = "Content-MD5" ":" md5-digest + md5-digest = + + The Content-MD5 header field MAY be generated by an origin server or + client to function as an integrity check of the entity-body. Only + origin servers or clients MAY generate the Content-MD5 header field; + proxies and gateways MUST NOT generate it, as this would defeat its + value as an end-to-end integrity check. Any recipient of the entity- + body, including gateways and proxies, MAY check that the digest value + in this header field matches that of the entity-body as received. + + The MD5 digest is computed based on the content of the entity-body, + including any content-coding that has been applied, but not including + any transfer-encoding applied to the message-body. If the message is + received with a transfer-encoding, that encoding MUST be removed + prior to checking the Content-MD5 value against the received entity. + + This has the result that the digest is computed on the octets of the + entity-body exactly as, and in the order that, they would be sent if + no transfer-encoding were being applied. + + HTTP extends RFC 1864 to permit the digest to be computed for MIME + composite media-types (e.g., multipart/* and message/rfc822), but + this does not change how the digest is computed as defined in the + preceding paragraph. + + There are several consequences of this. The entity-body for composite + types MAY contain many body-parts, each with its own MIME and HTTP + headers (including Content-MD5, Content-Transfer-Encoding, and + Content-Encoding headers). If a body-part has a Content-Transfer- + Encoding or Content-Encoding header, it is assumed that the content + of the body-part has had the encoding applied, and the body-part is + included in the Content-MD5 digest as is -- i.e., after the + application. The Transfer-Encoding header field is not allowed within + body-parts. + + Conversion of all line breaks to CRLF MUST NOT be done before + computing or checking the digest: the line break convention used in + the text actually transmitted MUST be left unaltered when computing + the digest. + + + +Fielding, et al. Standards Track [Page 121] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: while the definition of Content-MD5 is exactly the same for + HTTP as in RFC 1864 for MIME entity-bodies, there are several ways + in which the application of Content-MD5 to HTTP entity-bodies + differs from its application to MIME entity-bodies. One is that + HTTP, unlike MIME, does not use Content-Transfer-Encoding, and + does use Transfer-Encoding and Content-Encoding. Another is that + HTTP more frequently uses binary content types than MIME, so it is + worth noting that, in such cases, the byte order used to compute + the digest is the transmission byte order defined for the type. + Lastly, HTTP allows transmission of text types with any of several + line break conventions and not just the canonical form using CRLF. + +14.16 Content-Range + + The Content-Range entity-header is sent with a partial entity-body to + specify where in the full entity-body the partial body should be + applied. Range units are defined in section 3.12. + + Content-Range = "Content-Range" ":" content-range-spec + + content-range-spec = byte-content-range-spec + byte-content-range-spec = bytes-unit SP + byte-range-resp-spec "/" + ( instance-length | "*" ) + + byte-range-resp-spec = (first-byte-pos "-" last-byte-pos) + | "*" + instance-length = 1*DIGIT + + The header SHOULD indicate the total length of the full entity-body, + unless this length is unknown or difficult to determine. The asterisk + "*" character means that the instance-length is unknown at the time + when the response was generated. + + Unlike byte-ranges-specifier values (see section 14.35.1), a byte- + range-resp-spec MUST only specify one range, and MUST contain + absolute byte positions for both the first and last byte of the + range. + + A byte-content-range-spec with a byte-range-resp-spec whose last- + byte-pos value is less than its first-byte-pos value, or whose + instance-length value is less than or equal to its last-byte-pos + value, is invalid. The recipient of an invalid byte-content-range- + spec MUST ignore it and any content transferred along with it. + + A server sending a response with status code 416 (Requested range not + satisfiable) SHOULD include a Content-Range field with a byte-range- + resp-spec of "*". The instance-length specifies the current length of + + + +Fielding, et al. Standards Track [Page 122] + +RFC 2616 HTTP/1.1 June 1999 + + + the selected resource. A response with status code 206 (Partial + Content) MUST NOT include a Content-Range field with a byte-range- + resp-spec of "*". + + Examples of byte-content-range-spec values, assuming that the entity + contains a total of 1234 bytes: + + . The first 500 bytes: + bytes 0-499/1234 + + . The second 500 bytes: + bytes 500-999/1234 + + . All except for the first 500 bytes: + bytes 500-1233/1234 + + . The last 500 bytes: + bytes 734-1233/1234 + + When an HTTP message includes the content of a single range (for + example, a response to a request for a single range, or to a request + for a set of ranges that overlap without any holes), this content is + transmitted with a Content-Range header, and a Content-Length header + showing the number of bytes actually transferred. For example, + + HTTP/1.1 206 Partial content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-Range: bytes 21010-47021/47022 + Content-Length: 26012 + Content-Type: image/gif + + When an HTTP message includes the content of multiple ranges (for + example, a response to a request for multiple non-overlapping + ranges), these are transmitted as a multipart message. The multipart + media type used for this purpose is "multipart/byteranges" as defined + in appendix 19.2. See appendix 19.6.3 for a compatibility issue. + + A response to a request for a single range MUST NOT be sent using the + multipart/byteranges media type. A response to a request for + multiple ranges, whose result is a single range, MAY be sent as a + multipart/byteranges media type with one part. A client that cannot + decode a multipart/byteranges message MUST NOT ask for multiple + byte-ranges in a single request. + + When a client requests multiple byte-ranges in one request, the + server SHOULD return them in the order that they appeared in the + request. + + + +Fielding, et al. Standards Track [Page 123] + +RFC 2616 HTTP/1.1 June 1999 + + + If the server ignores a byte-range-spec because it is syntactically + invalid, the server SHOULD treat the request as if the invalid Range + header field did not exist. (Normally, this means return a 200 + response containing the full entity). + + If the server receives a request (other than one including an If- + Range request-header field) with an unsatisfiable Range request- + header field (that is, all of whose byte-range-spec values have a + first-byte-pos value greater than the current length of the selected + resource), it SHOULD return a response code of 416 (Requested range + not satisfiable) (section 10.4.17). + + Note: clients cannot depend on servers to send a 416 (Requested + range not satisfiable) response instead of a 200 (OK) response for + an unsatisfiable Range request-header, since not all servers + implement this request-header. + +14.17 Content-Type + + The Content-Type entity-header field indicates the media type of the + entity-body sent to the recipient or, in the case of the HEAD method, + the media type that would have been sent had the request been a GET. + + Content-Type = "Content-Type" ":" media-type + + Media types are defined in section 3.7. An example of the field is + + Content-Type: text/html; charset=ISO-8859-4 + + Further discussion of methods for identifying the media type of an + entity is provided in section 7.2.1. + +14.18 Date + + The Date general-header field represents the date and time at which + the message was originated, having the same semantics as orig-date in + RFC 822. The field value is an HTTP-date, as described in section + 3.3.1; it MUST be sent in RFC 1123 [8]-date format. + + Date = "Date" ":" HTTP-date + + An example is + + Date: Tue, 15 Nov 1994 08:12:31 GMT + + Origin servers MUST include a Date header field in all responses, + except in these cases: + + + + +Fielding, et al. Standards Track [Page 124] + +RFC 2616 HTTP/1.1 June 1999 + + + 1. If the response status code is 100 (Continue) or 101 (Switching + Protocols), the response MAY include a Date header field, at + the server's option. + + 2. If the response status code conveys a server error, e.g. 500 + (Internal Server Error) or 503 (Service Unavailable), and it is + inconvenient or impossible to generate a valid Date. + + 3. If the server does not have a clock that can provide a + reasonable approximation of the current time, its responses + MUST NOT include a Date header field. In this case, the rules + in section 14.18.1 MUST be followed. + + A received message that does not have a Date header field MUST be + assigned one by the recipient if the message will be cached by that + recipient or gatewayed via a protocol which requires a Date. An HTTP + implementation without a clock MUST NOT cache responses without + revalidating them on every use. An HTTP cache, especially a shared + cache, SHOULD use a mechanism, such as NTP [28], to synchronize its + clock with a reliable external standard. + + Clients SHOULD only send a Date header field in messages that include + an entity-body, as in the case of the PUT and POST requests, and even + then it is optional. A client without a clock MUST NOT send a Date + header field in a request. + + The HTTP-date sent in a Date header SHOULD NOT represent a date and + time subsequent to the generation of the message. It SHOULD represent + the best available approximation of the date and time of message + generation, unless the implementation has no means of generating a + reasonably accurate date and time. In theory, the date ought to + represent the moment just before the entity is generated. In + practice, the date can be generated at any time during the message + origination without affecting its semantic value. + +14.18.1 Clockless Origin Server Operation + + Some origin server implementations might not have a clock available. + An origin server without a clock MUST NOT assign Expires or Last- + Modified values to a response, unless these values were associated + with the resource by a system or user with a reliable clock. It MAY + assign an Expires value that is known, at or before server + configuration time, to be in the past (this allows "pre-expiration" + of responses without storing separate Expires values for each + resource). + + + + + + +Fielding, et al. Standards Track [Page 125] + +RFC 2616 HTTP/1.1 June 1999 + + +14.19 ETag + + The ETag response-header field provides the current value of the + entity tag for the requested variant. The headers used with entity + tags are described in sections 14.24, 14.26 and 14.44. The entity tag + MAY be used for comparison with other entities from the same resource + (see section 13.3.3). + + ETag = "ETag" ":" entity-tag + + Examples: + + ETag: "xyzzy" + ETag: W/"xyzzy" + ETag: "" + +14.20 Expect + + The Expect request-header field is used to indicate that particular + server behaviors are required by the client. + + Expect = "Expect" ":" 1#expectation + + expectation = "100-continue" | expectation-extension + expectation-extension = token [ "=" ( token | quoted-string ) + *expect-params ] + expect-params = ";" token [ "=" ( token | quoted-string ) ] + + + A server that does not understand or is unable to comply with any of + the expectation values in the Expect field of a request MUST respond + with appropriate error status. The server MUST respond with a 417 + (Expectation Failed) status if any of the expectations cannot be met + or, if there are other problems with the request, some other 4xx + status. + + This header field is defined with extensible syntax to allow for + future extensions. If a server receives a request containing an + Expect field that includes an expectation-extension that it does not + support, it MUST respond with a 417 (Expectation Failed) status. + + Comparison of expectation values is case-insensitive for unquoted + tokens (including the 100-continue token), and is case-sensitive for + quoted-string expectation-extensions. + + + + + + + +Fielding, et al. Standards Track [Page 126] + +RFC 2616 HTTP/1.1 June 1999 + + + The Expect mechanism is hop-by-hop: that is, an HTTP/1.1 proxy MUST + return a 417 (Expectation Failed) status if it receives a request + with an expectation that it cannot meet. However, the Expect + request-header itself is end-to-end; it MUST be forwarded if the + request is forwarded. + + Many older HTTP/1.0 and HTTP/1.1 applications do not understand the + Expect header. + + See section 8.2.3 for the use of the 100 (continue) status. + +14.21 Expires + + The Expires entity-header field gives the date/time after which the + response is considered stale. A stale cache entry may not normally be + returned by a cache (either a proxy cache or a user agent cache) + unless it is first validated with the origin server (or with an + intermediate cache that has a fresh copy of the entity). See section + 13.2 for further discussion of the expiration model. + + The presence of an Expires field does not imply that the original + resource will change or cease to exist at, before, or after that + time. + + The format is an absolute date and time as defined by HTTP-date in + section 3.3.1; it MUST be in RFC 1123 date format: + + Expires = "Expires" ":" HTTP-date + + An example of its use is + + Expires: Thu, 01 Dec 1994 16:00:00 GMT + + Note: if a response includes a Cache-Control field with the max- + age directive (see section 14.9.3), that directive overrides the + Expires field. + + HTTP/1.1 clients and caches MUST treat other invalid date formats, + especially including the value "0", as in the past (i.e., "already + expired"). + + To mark a response as "already expired," an origin server sends an + Expires date that is equal to the Date header value. (See the rules + for expiration calculations in section 13.2.4.) + + + + + + + +Fielding, et al. Standards Track [Page 127] + +RFC 2616 HTTP/1.1 June 1999 + + + To mark a response as "never expires," an origin server sends an + Expires date approximately one year from the time the response is + sent. HTTP/1.1 servers SHOULD NOT send Expires dates more than one + year in the future. + + The presence of an Expires header field with a date value of some + time in the future on a response that otherwise would by default be + non-cacheable indicates that the response is cacheable, unless + indicated otherwise by a Cache-Control header field (section 14.9). + +14.22 From + + The From request-header field, if given, SHOULD contain an Internet + e-mail address for the human user who controls the requesting user + agent. The address SHOULD be machine-usable, as defined by "mailbox" + in RFC 822 [9] as updated by RFC 1123 [8]: + + From = "From" ":" mailbox + + An example is: + + From: webmaster@w3.org + + This header field MAY be used for logging purposes and as a means for + identifying the source of invalid or unwanted requests. It SHOULD NOT + be used as an insecure form of access protection. The interpretation + of this field is that the request is being performed on behalf of the + person given, who accepts responsibility for the method performed. In + particular, robot agents SHOULD include this header so that the + person responsible for running the robot can be contacted if problems + occur on the receiving end. + + The Internet e-mail address in this field MAY be separate from the + Internet host which issued the request. For example, when a request + is passed through a proxy the original issuer's address SHOULD be + used. + + The client SHOULD NOT send the From header field without the user's + approval, as it might conflict with the user's privacy interests or + their site's security policy. It is strongly recommended that the + user be able to disable, enable, and modify the value of this field + at any time prior to a request. + +14.23 Host + + The Host request-header field specifies the Internet host and port + number of the resource being requested, as obtained from the original + URI given by the user or referring resource (generally an HTTP URL, + + + +Fielding, et al. Standards Track [Page 128] + +RFC 2616 HTTP/1.1 June 1999 + + + as described in section 3.2.2). The Host field value MUST represent + the naming authority of the origin server or gateway given by the + original URL. This allows the origin server or gateway to + differentiate between internally-ambiguous URLs, such as the root "/" + URL of a server for multiple host names on a single IP address. + + Host = "Host" ":" host [ ":" port ] ; Section 3.2.2 + + A "host" without any trailing port information implies the default + port for the service requested (e.g., "80" for an HTTP URL). For + example, a request on the origin server for + would properly include: + + GET /pub/WWW/ HTTP/1.1 + Host: www.w3.org + + A client MUST include a Host header field in all HTTP/1.1 request + messages . If the requested URI does not include an Internet host + name for the service being requested, then the Host header field MUST + be given with an empty value. An HTTP/1.1 proxy MUST ensure that any + request message it forwards does contain an appropriate Host header + field that identifies the service being requested by the proxy. All + Internet-based HTTP/1.1 servers MUST respond with a 400 (Bad Request) + status code to any HTTP/1.1 request message which lacks a Host header + field. + + See sections 5.2 and 19.6.1.1 for other requirements relating to + Host. + +14.24 If-Match + + The If-Match request-header field is used with a method to make it + conditional. A client that has one or more entities previously + obtained from the resource can verify that one of those entities is + current by including a list of their associated entity tags in the + If-Match header field. Entity tags are defined in section 3.11. The + purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. It is also + used, on updating requests, to prevent inadvertent modification of + the wrong version of a resource. As a special case, the value "*" + matches any current entity of the resource. + + If-Match = "If-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-Match header) on that resource, or if "*" is given + + + + +Fielding, et al. Standards Track [Page 129] + +RFC 2616 HTTP/1.1 June 1999 + + + and any current entity exists for that resource, then the server MAY + perform the requested method as if the If-Match header field did not + exist. + + A server MUST use the strong comparison function (see section 13.3.3) + to compare the entity tags in If-Match. + + If none of the entity tags match, or if "*" is given and no current + entity exists, the server MUST NOT perform the requested method, and + MUST return a 412 (Precondition Failed) response. This behavior is + most useful when the client wants to prevent an updating method, such + as PUT, from modifying a resource that has changed since the client + last retrieved it. + + If the request would, without the If-Match header field, result in + anything other than a 2xx or 412 status, then the If-Match header + MUST be ignored. + + The meaning of "If-Match: *" is that the method SHOULD be performed + if the representation selected by the origin server (or by a cache, + possibly using the Vary mechanism, see section 14.44) exists, and + MUST NOT be performed if the representation does not exist. + + A request intended to update a resource (e.g., a PUT) MAY include an + If-Match header field to signal that the request method MUST NOT be + applied if the entity corresponding to the If-Match value (a single + entity tag) is no longer a representation of that resource. This + allows the user to indicate that they do not wish the request to be + successful if the resource has been changed without their knowledge. + Examples: + + If-Match: "xyzzy" + If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-Match: * + + The result of a request having both an If-Match header field and + either an If-None-Match or an If-Modified-Since header fields is + undefined by this specification. + +14.25 If-Modified-Since + + The If-Modified-Since request-header field is used with a method to + make it conditional: if the requested variant has not been modified + since the time specified in this field, an entity will not be + returned from the server; instead, a 304 (not modified) response will + be returned without any message-body. + + If-Modified-Since = "If-Modified-Since" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 130] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of the field is: + + If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + A GET method with an If-Modified-Since header and no Range header + requests that the identified entity be transferred only if it has + been modified since the date given by the If-Modified-Since header. + The algorithm for determining this includes the following cases: + + a) If the request would normally result in anything other than a + 200 (OK) status, or if the passed If-Modified-Since date is + invalid, the response is exactly the same as for a normal GET. + A date which is later than the server's current time is + invalid. + + b) If the variant has been modified since the If-Modified-Since + date, the response is exactly the same as for a normal GET. + + c) If the variant has not been modified since a valid If- + Modified-Since date, the server SHOULD return a 304 (Not + Modified) response. + + The purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. + + Note: The Range request-header field modifies the meaning of If- + Modified-Since; see section 14.35 for full details. + + Note: If-Modified-Since times are interpreted by the server, whose + clock might not be synchronized with the client. + + Note: When handling an If-Modified-Since header field, some + servers will use an exact date comparison function, rather than a + less-than function, for deciding whether to send a 304 (Not + Modified) response. To get best results when sending an If- + Modified-Since header field for cache validation, clients are + advised to use the exact date string received in a previous Last- + Modified header field whenever possible. + + Note: If a client uses an arbitrary date in the If-Modified-Since + header instead of a date taken from the Last-Modified header for + the same request, the client should be aware of the fact that this + date is interpreted in the server's understanding of time. The + client should consider unsynchronized clocks and rounding problems + due to the different encodings of time between the client and + server. This includes the possibility of race conditions if the + document has changed between the time it was first requested and + the If-Modified-Since date of a subsequent request, and the + + + +Fielding, et al. Standards Track [Page 131] + +RFC 2616 HTTP/1.1 June 1999 + + + possibility of clock-skew-related problems if the If-Modified- + Since date is derived from the client's clock without correction + to the server's clock. Corrections for different time bases + between client and server are at best approximate due to network + latency. + + The result of a request having both an If-Modified-Since header field + and either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.26 If-None-Match + + The If-None-Match request-header field is used with a method to make + it conditional. A client that has one or more entities previously + obtained from the resource can verify that none of those entities is + current by including a list of their associated entity tags in the + If-None-Match header field. The purpose of this feature is to allow + efficient updates of cached information with a minimum amount of + transaction overhead. It is also used to prevent a method (e.g. PUT) + from inadvertently modifying an existing resource when the client + believes that the resource does not exist. + + As a special case, the value "*" matches any current entity of the + resource. + + If-None-Match = "If-None-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-None-Match header) on that resource, or if "*" is + given and any current entity exists for that resource, then the + server MUST NOT perform the requested method, unless required to do + so because the resource's modification date fails to match that + supplied in an If-Modified-Since header field in the request. + Instead, if the request method was GET or HEAD, the server SHOULD + respond with a 304 (Not Modified) response, including the cache- + related header fields (particularly ETag) of one of the entities that + matched. For all other request methods, the server MUST respond with + a status of 412 (Precondition Failed). + + See section 13.3.3 for rules on how to determine if two entities tags + match. The weak comparison function can only be used with GET or HEAD + requests. + + + + + + + + +Fielding, et al. Standards Track [Page 132] + +RFC 2616 HTTP/1.1 June 1999 + + + If none of the entity tags match, then the server MAY perform the + requested method as if the If-None-Match header field did not exist, + but MUST also ignore any If-Modified-Since header field(s) in the + request. That is, if no entity tags match, then the server MUST NOT + return a 304 (Not Modified) response. + + If the request would, without the If-None-Match header field, result + in anything other than a 2xx or 304 status, then the If-None-Match + header MUST be ignored. (See section 13.3.4 for a discussion of + server behavior when both If-Modified-Since and If-None-Match appear + in the same request.) + + The meaning of "If-None-Match: *" is that the method MUST NOT be + performed if the representation selected by the origin server (or by + a cache, possibly using the Vary mechanism, see section 14.44) + exists, and SHOULD be performed if the representation does not exist. + This feature is intended to be useful in preventing races between PUT + operations. + + Examples: + + If-None-Match: "xyzzy" + If-None-Match: W/"xyzzy" + If-None-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-None-Match: W/"xyzzy", W/"r2d2xxxx", W/"c3piozzzz" + If-None-Match: * + + The result of a request having both an If-None-Match header field and + either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.27 If-Range + + If a client has a partial copy of an entity in its cache, and wishes + to have an up-to-date copy of the entire entity in its cache, it + could use the Range request-header with a conditional GET (using + either or both of If-Unmodified-Since and If-Match.) However, if the + condition fails because the entity has been modified, the client + would then have to make a second request to obtain the entire current + entity-body. + + The If-Range header allows a client to "short-circuit" the second + request. Informally, its meaning is `if the entity is unchanged, send + me the part(s) that I am missing; otherwise, send me the entire new + entity'. + + If-Range = "If-Range" ":" ( entity-tag | HTTP-date ) + + + + +Fielding, et al. Standards Track [Page 133] + +RFC 2616 HTTP/1.1 June 1999 + + + If the client has no entity tag for an entity, but does have a Last- + Modified date, it MAY use that date in an If-Range header. (The + server can distinguish between a valid HTTP-date and any form of + entity-tag by examining no more than two characters.) The If-Range + header SHOULD only be used together with a Range header, and MUST be + ignored if the request does not include a Range header, or if the + server does not support the sub-range operation. + + If the entity tag given in the If-Range header matches the current + entity tag for the entity, then the server SHOULD provide the + specified sub-range of the entity using a 206 (Partial content) + response. If the entity tag does not match, then the server SHOULD + return the entire entity using a 200 (OK) response. + +14.28 If-Unmodified-Since + + The If-Unmodified-Since request-header field is used with a method to + make it conditional. If the requested resource has not been modified + since the time specified in this field, the server SHOULD perform the + requested operation as if the If-Unmodified-Since header were not + present. + + If the requested variant has been modified since the specified time, + the server MUST NOT perform the requested operation, and MUST return + a 412 (Precondition Failed). + + If-Unmodified-Since = "If-Unmodified-Since" ":" HTTP-date + + An example of the field is: + + If-Unmodified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + If the request normally (i.e., without the If-Unmodified-Since + header) would result in anything other than a 2xx or 412 status, the + If-Unmodified-Since header SHOULD be ignored. + + If the specified date is invalid, the header is ignored. + + The result of a request having both an If-Unmodified-Since header + field and either an If-None-Match or an If-Modified-Since header + fields is undefined by this specification. + +14.29 Last-Modified + + The Last-Modified entity-header field indicates the date and time at + which the origin server believes the variant was last modified. + + Last-Modified = "Last-Modified" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 134] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of its use is + + Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT + + The exact meaning of this header field depends on the implementation + of the origin server and the nature of the original resource. For + files, it may be just the file system last-modified time. For + entities with dynamically included parts, it may be the most recent + of the set of last-modify times for its component parts. For database + gateways, it may be the last-update time stamp of the record. For + virtual objects, it may be the last time the internal state changed. + + An origin server MUST NOT send a Last-Modified date which is later + than the server's time of message origination. In such cases, where + the resource's last modification would indicate some time in the + future, the server MUST replace that date with the message + origination date. + + An origin server SHOULD obtain the Last-Modified value of the entity + as close as possible to the time that it generates the Date value of + its response. This allows a recipient to make an accurate assessment + of the entity's modification time, especially if the entity changes + near the time that the response is generated. + + HTTP/1.1 servers SHOULD send Last-Modified whenever feasible. + +14.30 Location + + The Location response-header field is used to redirect the recipient + to a location other than the Request-URI for completion of the + request or identification of a new resource. For 201 (Created) + responses, the Location is that of the new resource which was created + by the request. For 3xx responses, the location SHOULD indicate the + server's preferred URI for automatic redirection to the resource. The + field value consists of a single absolute URI. + + Location = "Location" ":" absoluteURI + + An example is: + + Location: http://www.w3.org/pub/WWW/People.html + + Note: The Content-Location header field (section 14.14) differs + from Location in that the Content-Location identifies the original + location of the entity enclosed in the request. It is therefore + possible for a response to contain header fields for both Location + and Content-Location. Also see section 13.10 for cache + requirements of some methods. + + + +Fielding, et al. Standards Track [Page 135] + +RFC 2616 HTTP/1.1 June 1999 + + +14.31 Max-Forwards + + The Max-Forwards request-header field provides a mechanism with the + TRACE (section 9.8) and OPTIONS (section 9.2) methods to limit the + number of proxies or gateways that can forward the request to the + next inbound server. This can be useful when the client is attempting + to trace a request chain which appears to be failing or looping in + mid-chain. + + Max-Forwards = "Max-Forwards" ":" 1*DIGIT + + The Max-Forwards value is a decimal integer indicating the remaining + number of times this request message may be forwarded. + + Each proxy or gateway recipient of a TRACE or OPTIONS request + containing a Max-Forwards header field MUST check and update its + value prior to forwarding the request. If the received value is zero + (0), the recipient MUST NOT forward the request; instead, it MUST + respond as the final recipient. If the received Max-Forwards value is + greater than zero, then the forwarded message MUST contain an updated + Max-Forwards field with a value decremented by one (1). + + The Max-Forwards header field MAY be ignored for all other methods + defined by this specification and for any extension methods for which + it is not explicitly referred to as part of that method definition. + +14.32 Pragma + + The Pragma general-header field is used to include implementation- + specific directives that might apply to any recipient along the + request/response chain. All pragma directives specify optional + behavior from the viewpoint of the protocol; however, some systems + MAY require that behavior be consistent with the directives. + + Pragma = "Pragma" ":" 1#pragma-directive + pragma-directive = "no-cache" | extension-pragma + extension-pragma = token [ "=" ( token | quoted-string ) ] + + When the no-cache directive is present in a request message, an + application SHOULD forward the request toward the origin server even + if it has a cached copy of what is being requested. This pragma + directive has the same semantics as the no-cache cache-directive (see + section 14.9) and is defined here for backward compatibility with + HTTP/1.0. Clients SHOULD include both header fields when a no-cache + request is sent to a server not known to be HTTP/1.1 compliant. + + + + + + +Fielding, et al. Standards Track [Page 136] + +RFC 2616 HTTP/1.1 June 1999 + + + Pragma directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a pragma for a + specific recipient; however, any pragma directive not relevant to a + recipient SHOULD be ignored by that recipient. + + HTTP/1.1 caches SHOULD treat "Pragma: no-cache" as if the client had + sent "Cache-Control: no-cache". No new Pragma directives will be + defined in HTTP. + + Note: because the meaning of "Pragma: no-cache as a response + header field is not actually specified, it does not provide a + reliable replacement for "Cache-Control: no-cache" in a response + +14.33 Proxy-Authenticate + + The Proxy-Authenticate response-header field MUST be included as part + of a 407 (Proxy Authentication Required) response. The field value + consists of a challenge that indicates the authentication scheme and + parameters applicable to the proxy for this Request-URI. + + Proxy-Authenticate = "Proxy-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. Unlike + WWW-Authenticate, the Proxy-Authenticate header field applies only to + the current connection and SHOULD NOT be passed on to downstream + clients. However, an intermediate proxy might need to obtain its own + credentials by requesting them from the downstream client, which in + some circumstances will appear as if the proxy is forwarding the + Proxy-Authenticate header field. + +14.34 Proxy-Authorization + + The Proxy-Authorization request-header field allows the client to + identify itself (or its user) to a proxy which requires + authentication. The Proxy-Authorization field value consists of + credentials containing the authentication information of the user + agent for the proxy and/or realm of the resource being requested. + + Proxy-Authorization = "Proxy-Authorization" ":" credentials + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43] . Unlike + Authorization, the Proxy-Authorization header field applies only to + the next outbound proxy that demanded authentication using the Proxy- + Authenticate field. When multiple proxies are used in a chain, the + + + +Fielding, et al. Standards Track [Page 137] + +RFC 2616 HTTP/1.1 June 1999 + + + Proxy-Authorization header field is consumed by the first outbound + proxy that was expecting to receive credentials. A proxy MAY relay + the credentials from the client request to the next proxy if that is + the mechanism by which the proxies cooperatively authenticate a given + request. + +14.35 Range + +14.35.1 Byte Ranges + + Since all HTTP entities are represented in HTTP messages as sequences + of bytes, the concept of a byte range is meaningful for any HTTP + entity. (However, not all clients and servers need to support byte- + range operations.) + + Byte range specifications in HTTP apply to the sequence of bytes in + the entity-body (not necessarily the same as the message-body). + + A byte range operation MAY specify a single range of bytes, or a set + of ranges within a single entity. + + ranges-specifier = byte-ranges-specifier + byte-ranges-specifier = bytes-unit "=" byte-range-set + byte-range-set = 1#( byte-range-spec | suffix-byte-range-spec ) + byte-range-spec = first-byte-pos "-" [last-byte-pos] + first-byte-pos = 1*DIGIT + last-byte-pos = 1*DIGIT + + The first-byte-pos value in a byte-range-spec gives the byte-offset + of the first byte in a range. The last-byte-pos value gives the + byte-offset of the last byte in the range; that is, the byte + positions specified are inclusive. Byte offsets start at zero. + + If the last-byte-pos value is present, it MUST be greater than or + equal to the first-byte-pos in that byte-range-spec, or the byte- + range-spec is syntactically invalid. The recipient of a byte-range- + set that includes one or more syntactically invalid byte-range-spec + values MUST ignore the header field that includes that byte-range- + set. + + If the last-byte-pos value is absent, or if the value is greater than + or equal to the current length of the entity-body, last-byte-pos is + taken to be equal to one less than the current length of the entity- + body in bytes. + + By its choice of last-byte-pos, a client can limit the number of + bytes retrieved without knowing the size of the entity. + + + + +Fielding, et al. Standards Track [Page 138] + +RFC 2616 HTTP/1.1 June 1999 + + + suffix-byte-range-spec = "-" suffix-length + suffix-length = 1*DIGIT + + A suffix-byte-range-spec is used to specify the suffix of the + entity-body, of a length given by the suffix-length value. (That is, + this form specifies the last N bytes of an entity-body.) If the + entity is shorter than the specified suffix-length, the entire + entity-body is used. + + If a syntactically valid byte-range-set includes at least one byte- + range-spec whose first-byte-pos is less than the current length of + the entity-body, or at least one suffix-byte-range-spec with a non- + zero suffix-length, then the byte-range-set is satisfiable. + Otherwise, the byte-range-set is unsatisfiable. If the byte-range-set + is unsatisfiable, the server SHOULD return a response with a status + of 416 (Requested range not satisfiable). Otherwise, the server + SHOULD return a response with a status of 206 (Partial Content) + containing the satisfiable ranges of the entity-body. + + Examples of byte-ranges-specifier values (assuming an entity-body of + length 10000): + + - The first 500 bytes (byte offsets 0-499, inclusive): bytes=0- + 499 + + - The second 500 bytes (byte offsets 500-999, inclusive): + bytes=500-999 + + - The final 500 bytes (byte offsets 9500-9999, inclusive): + bytes=-500 + + - Or bytes=9500- + + - The first and last bytes only (bytes 0 and 9999): bytes=0-0,-1 + + - Several legal but not canonical specifications of the second 500 + bytes (byte offsets 500-999, inclusive): + bytes=500-600,601-999 + bytes=500-700,601-999 + +14.35.2 Range Retrieval Requests + + HTTP retrieval requests using conditional or unconditional GET + methods MAY request one or more sub-ranges of the entity, instead of + the entire entity, using the Range request header, which applies to + the entity returned as the result of the request: + + Range = "Range" ":" ranges-specifier + + + +Fielding, et al. Standards Track [Page 139] + +RFC 2616 HTTP/1.1 June 1999 + + + A server MAY ignore the Range header. However, HTTP/1.1 origin + servers and intermediate caches ought to support byte ranges when + possible, since Range supports efficient recovery from partially + failed transfers, and supports efficient partial retrieval of large + entities. + + If the server supports the Range header and the specified range or + ranges are appropriate for the entity: + + - The presence of a Range header in an unconditional GET modifies + what is returned if the GET is otherwise successful. In other + words, the response carries a status code of 206 (Partial + Content) instead of 200 (OK). + + - The presence of a Range header in a conditional GET (a request + using one or both of If-Modified-Since and If-None-Match, or + one or both of If-Unmodified-Since and If-Match) modifies what + is returned if the GET is otherwise successful and the + condition is true. It does not affect the 304 (Not Modified) + response returned if the conditional is false. + + In some cases, it might be more appropriate to use the If-Range + header (see section 14.27) in addition to the Range header. + + If a proxy that supports ranges receives a Range request, forwards + the request to an inbound server, and receives an entire entity in + reply, it SHOULD only return the requested range to its client. It + SHOULD store the entire received response in its cache if that is + consistent with its cache allocation policies. + +14.36 Referer + + The Referer[sic] request-header field allows the client to specify, + for the server's benefit, the address (URI) of the resource from + which the Request-URI was obtained (the "referrer", although the + header field is misspelled.) The Referer request-header allows a + server to generate lists of back-links to resources for interest, + logging, optimized caching, etc. It also allows obsolete or mistyped + links to be traced for maintenance. The Referer field MUST NOT be + sent if the Request-URI was obtained from a source that does not have + its own URI, such as input from the user keyboard. + + Referer = "Referer" ":" ( absoluteURI | relativeURI ) + + Example: + + Referer: http://www.w3.org/hypertext/DataSources/Overview.html + + + + +Fielding, et al. Standards Track [Page 140] + +RFC 2616 HTTP/1.1 June 1999 + + + If the field value is a relative URI, it SHOULD be interpreted + relative to the Request-URI. The URI MUST NOT include a fragment. See + section 15.1.3 for security considerations. + +14.37 Retry-After + + The Retry-After response-header field can be used with a 503 (Service + Unavailable) response to indicate how long the service is expected to + be unavailable to the requesting client. This field MAY also be used + with any 3xx (Redirection) response to indicate the minimum time the + user-agent is asked wait before issuing the redirected request. The + value of this field can be either an HTTP-date or an integer number + of seconds (in decimal) after the time of the response. + + Retry-After = "Retry-After" ":" ( HTTP-date | delta-seconds ) + + Two examples of its use are + + Retry-After: Fri, 31 Dec 1999 23:59:59 GMT + Retry-After: 120 + + In the latter example, the delay is 2 minutes. + +14.38 Server + + The Server response-header field contains information about the + software used by the origin server to handle the request. The field + can contain multiple product tokens (section 3.8) and comments + identifying the server and any significant subproducts. The product + tokens are listed in order of their significance for identifying the + application. + + Server = "Server" ":" 1*( product | comment ) + + Example: + + Server: CERN/3.0 libwww/2.17 + + If the response is being forwarded through a proxy, the proxy + application MUST NOT modify the Server response-header. Instead, it + SHOULD include a Via field (as described in section 14.45). + + Note: Revealing the specific software version of the server might + allow the server machine to become more vulnerable to attacks + against software that is known to contain security holes. Server + implementors are encouraged to make this field a configurable + option. + + + + +Fielding, et al. Standards Track [Page 141] + +RFC 2616 HTTP/1.1 June 1999 + + +14.39 TE + + The TE request-header field indicates what extension transfer-codings + it is willing to accept in the response and whether or not it is + willing to accept trailer fields in a chunked transfer-coding. Its + value may consist of the keyword "trailers" and/or a comma-separated + list of extension transfer-coding names with optional accept + parameters (as described in section 3.6). + + TE = "TE" ":" #( t-codings ) + t-codings = "trailers" | ( transfer-extension [ accept-params ] ) + + The presence of the keyword "trailers" indicates that the client is + willing to accept trailer fields in a chunked transfer-coding, as + defined in section 3.6.1. This keyword is reserved for use with + transfer-coding values even though it does not itself represent a + transfer-coding. + + Examples of its use are: + + TE: deflate + TE: + TE: trailers, deflate;q=0.5 + + The TE header field only applies to the immediate connection. + Therefore, the keyword MUST be supplied within a Connection header + field (section 14.10) whenever TE is present in an HTTP/1.1 message. + + A server tests whether a transfer-coding is acceptable, according to + a TE field, using these rules: + + 1. The "chunked" transfer-coding is always acceptable. If the + keyword "trailers" is listed, the client indicates that it is + willing to accept trailer fields in the chunked response on + behalf of itself and any downstream clients. The implication is + that, if given, the client is stating that either all + downstream clients are willing to accept trailer fields in the + forwarded response, or that it will attempt to buffer the + response on behalf of downstream recipients. + + Note: HTTP/1.1 does not define any means to limit the size of a + chunked response such that a client can be assured of buffering + the entire response. + + 2. If the transfer-coding being tested is one of the transfer- + codings listed in the TE field, then it is acceptable unless it + is accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + + +Fielding, et al. Standards Track [Page 142] + +RFC 2616 HTTP/1.1 June 1999 + + + 3. If multiple transfer-codings are acceptable, then the + acceptable transfer-coding with the highest non-zero qvalue is + preferred. The "chunked" transfer-coding always has a qvalue + of 1. + + If the TE field-value is empty or if no TE field is present, the only + transfer-coding is "chunked". A message with no transfer-coding is + always acceptable. + +14.40 Trailer + + The Trailer general field value indicates that the given set of + header fields is present in the trailer of a message encoded with + chunked transfer-coding. + + Trailer = "Trailer" ":" 1#field-name + + An HTTP/1.1 message SHOULD include a Trailer header field in a + message using chunked transfer-coding with a non-empty trailer. Doing + so allows the recipient to know which header fields to expect in the + trailer. + + If no Trailer header field is present, the trailer SHOULD NOT include + any header fields. See section 3.6.1 for restrictions on the use of + trailer fields in a "chunked" transfer-coding. + + Message header fields listed in the Trailer header field MUST NOT + include the following header fields: + + . Transfer-Encoding + + . Content-Length + + . Trailer + +14.41 Transfer-Encoding + + The Transfer-Encoding general-header field indicates what (if any) + type of transformation has been applied to the message body in order + to safely transfer it between the sender and the recipient. This + differs from the content-coding in that the transfer-coding is a + property of the message, not of the entity. + + Transfer-Encoding = "Transfer-Encoding" ":" 1#transfer-coding + + Transfer-codings are defined in section 3.6. An example is: + + Transfer-Encoding: chunked + + + +Fielding, et al. Standards Track [Page 143] + +RFC 2616 HTTP/1.1 June 1999 + + + If multiple encodings have been applied to an entity, the transfer- + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + + Many older HTTP/1.0 applications do not understand the Transfer- + Encoding header. + +14.42 Upgrade + + The Upgrade general-header allows the client to specify what + additional communication protocols it supports and would like to use + if the server finds it appropriate to switch protocols. The server + MUST use the Upgrade header field within a 101 (Switching Protocols) + response to indicate which protocol(s) are being switched. + + Upgrade = "Upgrade" ":" 1#product + + For example, + + Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11 + + The Upgrade header field is intended to provide a simple mechanism + for transition from HTTP/1.1 to some other, incompatible protocol. It + does so by allowing the client to advertise its desire to use another + protocol, such as a later version of HTTP with a higher major version + number, even though the current request has been made using HTTP/1.1. + This eases the difficult transition between incompatible protocols by + allowing the client to initiate a request in the more commonly + supported protocol while indicating to the server that it would like + to use a "better" protocol if available (where "better" is determined + by the server, possibly according to the nature of the method and/or + resource being requested). + + The Upgrade header field only applies to switching application-layer + protocols upon the existing transport-layer connection. Upgrade + cannot be used to insist on a protocol change; its acceptance and use + by the server is optional. The capabilities and nature of the + application-layer communication after the protocol change is entirely + dependent upon the new protocol chosen, although the first action + after changing the protocol MUST be a response to the initial HTTP + request containing the Upgrade header field. + + The Upgrade header field only applies to the immediate connection. + Therefore, the upgrade keyword MUST be supplied within a Connection + header field (section 14.10) whenever Upgrade is present in an + HTTP/1.1 message. + + + + +Fielding, et al. Standards Track [Page 144] + +RFC 2616 HTTP/1.1 June 1999 + + + The Upgrade header field cannot be used to indicate a switch to a + protocol on a different connection. For that purpose, it is more + appropriate to use a 301, 302, 303, or 305 redirection response. + + This specification only defines the protocol name "HTTP" for use by + the family of Hypertext Transfer Protocols, as defined by the HTTP + version rules of section 3.1 and future updates to this + specification. Any token can be used as a protocol name; however, it + will only be useful if both the client and server associate the name + with the same protocol. + +14.43 User-Agent + + The User-Agent request-header field contains information about the + user agent originating the request. This is for statistical purposes, + the tracing of protocol violations, and automated recognition of user + agents for the sake of tailoring responses to avoid particular user + agent limitations. User agents SHOULD include this field with + requests. The field can contain multiple product tokens (section 3.8) + and comments identifying the agent and any subproducts which form a + significant part of the user agent. By convention, the product tokens + are listed in order of their significance for identifying the + application. + + User-Agent = "User-Agent" ":" 1*( product | comment ) + + Example: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + +14.44 Vary + + The Vary field value indicates the set of request-header fields that + fully determines, while the response is fresh, whether a cache is + permitted to use the response to reply to a subsequent request + without revalidation. For uncacheable or stale responses, the Vary + field value advises the user agent about the criteria that were used + to select the representation. A Vary field value of "*" implies that + a cache cannot determine from the request headers of a subsequent + request whether this response is the appropriate representation. See + section 13.6 for use of the Vary header field by caches. + + Vary = "Vary" ":" ( "*" | 1#field-name ) + + An HTTP/1.1 server SHOULD include a Vary header field with any + cacheable response that is subject to server-driven negotiation. + Doing so allows a cache to properly interpret future requests on that + resource and informs the user agent about the presence of negotiation + + + +Fielding, et al. Standards Track [Page 145] + +RFC 2616 HTTP/1.1 June 1999 + + + on that resource. A server MAY include a Vary header field with a + non-cacheable response that is subject to server-driven negotiation, + since this might provide the user agent with useful information about + the dimensions over which the response varies at the time of the + response. + + A Vary field value consisting of a list of field-names signals that + the representation selected for the response is based on a selection + algorithm which considers ONLY the listed request-header field values + in selecting the most appropriate representation. A cache MAY assume + that the same selection will be made for future requests with the + same values for the listed field names, for the duration of time for + which the response is fresh. + + The field-names given are not limited to the set of standard + request-header fields defined by this specification. Field names are + case-insensitive. + + A Vary field value of "*" signals that unspecified parameters not + limited to the request-headers (e.g., the network address of the + client), play a role in the selection of the response representation. + The "*" value MUST NOT be generated by a proxy server; it may only be + generated by an origin server. + +14.45 Via + + The Via general-header field MUST be used by gateways and proxies to + indicate the intermediate protocols and recipients between the user + agent and the server on requests, and between the origin server and + the client on responses. It is analogous to the "Received" field of + RFC 822 [9] and is intended to be used for tracking message forwards, + avoiding request loops, and identifying the protocol capabilities of + all senders along the request/response chain. + + Via = "Via" ":" 1#( received-protocol received-by [ comment ] ) + received-protocol = [ protocol-name "/" ] protocol-version + protocol-name = token + protocol-version = token + received-by = ( host [ ":" port ] ) | pseudonym + pseudonym = token + + The received-protocol indicates the protocol version of the message + received by the server or client along each segment of the + request/response chain. The received-protocol version is appended to + the Via field value when the message is forwarded so that information + about the protocol capabilities of upstream applications remains + visible to all recipients. + + + + +Fielding, et al. Standards Track [Page 146] + +RFC 2616 HTTP/1.1 June 1999 + + + The protocol-name is optional if and only if it would be "HTTP". The + received-by field is normally the host and optional port number of a + recipient server or client that subsequently forwarded the message. + However, if the real host is considered to be sensitive information, + it MAY be replaced by a pseudonym. If the port is not given, it MAY + be assumed to be the default port of the received-protocol. + + Multiple Via field values represents each proxy or gateway that has + forwarded the message. Each recipient MUST append its information + such that the end result is ordered according to the sequence of + forwarding applications. + + Comments MAY be used in the Via header field to identify the software + of the recipient proxy or gateway, analogous to the User-Agent and + Server header fields. However, all comments in the Via field are + optional and MAY be removed by any recipient prior to forwarding the + message. + + For example, a request message could be sent from an HTTP/1.0 user + agent to an internal proxy code-named "fred", which uses HTTP/1.1 to + forward the request to a public proxy at nowhere.com, which completes + the request by forwarding it to the origin server at www.ics.uci.edu. + The request received by www.ics.uci.edu would then have the following + Via header field: + + Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1) + + Proxies and gateways used as a portal through a network firewall + SHOULD NOT, by default, forward the names and ports of hosts within + the firewall region. This information SHOULD only be propagated if + explicitly enabled. If not enabled, the received-by host of any host + behind the firewall SHOULD be replaced by an appropriate pseudonym + for that host. + + For organizations that have strong privacy requirements for hiding + internal structures, a proxy MAY combine an ordered subsequence of + Via header field entries with identical received-protocol values into + a single such entry. For example, + + Via: 1.0 ricky, 1.1 ethel, 1.1 fred, 1.0 lucy + + could be collapsed to + + Via: 1.0 ricky, 1.1 mertz, 1.0 lucy + + + + + + + +Fielding, et al. Standards Track [Page 147] + +RFC 2616 HTTP/1.1 June 1999 + + + Applications SHOULD NOT combine multiple entries unless they are all + under the same organizational control and the hosts have already been + replaced by pseudonyms. Applications MUST NOT combine entries which + have different received-protocol values. + +14.46 Warning + + The Warning general-header field is used to carry additional + information about the status or transformation of a message which + might not be reflected in the message. This information is typically + used to warn about a possible lack of semantic transparency from + caching operations or transformations applied to the entity body of + the message. + + Warning headers are sent with responses using: + + Warning = "Warning" ":" 1#warning-value + + warning-value = warn-code SP warn-agent SP warn-text + [SP warn-date] + + warn-code = 3DIGIT + warn-agent = ( host [ ":" port ] ) | pseudonym + ; the name or pseudonym of the server adding + ; the Warning header, for use in debugging + warn-text = quoted-string + warn-date = <"> HTTP-date <"> + + A response MAY carry more than one Warning header. + + The warn-text SHOULD be in a natural language and character set that + is most likely to be intelligible to the human user receiving the + response. This decision MAY be based on any available knowledge, such + as the location of the cache or user, the Accept-Language field in a + request, the Content-Language field in a response, etc. The default + language is English and the default character set is ISO-8859-1. + + If a character set other than ISO-8859-1 is used, it MUST be encoded + in the warn-text using the method described in RFC 2047 [14]. + + Warning headers can in general be applied to any message, however + some specific warn-codes are specific to caches and can only be + applied to response messages. New Warning headers SHOULD be added + after any existing Warning headers. A cache MUST NOT delete any + Warning header that it received with a message. However, if a cache + successfully validates a cache entry, it SHOULD remove any Warning + headers previously attached to that entry except as specified for + + + + +Fielding, et al. Standards Track [Page 148] + +RFC 2616 HTTP/1.1 June 1999 + + + specific Warning codes. It MUST then add any Warning headers received + in the validating response. In other words, Warning headers are those + that would be attached to the most recent relevant response. + + When multiple Warning headers are attached to a response, the user + agent ought to inform the user of as many of them as possible, in the + order that they appear in the response. If it is not possible to + inform the user of all of the warnings, the user agent SHOULD follow + these heuristics: + + - Warnings that appear early in the response take priority over + those appearing later in the response. + + - Warnings in the user's preferred character set take priority + over warnings in other character sets but with identical warn- + codes and warn-agents. + + Systems that generate multiple Warning headers SHOULD order them with + this user agent behavior in mind. + + Requirements for the behavior of caches with respect to Warnings are + stated in section 13.1.2. + + This is a list of the currently-defined warn-codes, each with a + recommended warn-text in English, and a description of its meaning. + + 110 Response is stale + MUST be included whenever the returned response is stale. + + 111 Revalidation failed + MUST be included if a cache returns a stale response because an + attempt to revalidate the response failed, due to an inability to + reach the server. + + 112 Disconnected operation + SHOULD be included if the cache is intentionally disconnected from + the rest of the network for a period of time. + + 113 Heuristic expiration + MUST be included if the cache heuristically chose a freshness + lifetime greater than 24 hours and the response's age is greater + than 24 hours. + + 199 Miscellaneous warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action, besides presenting the warning to + the user. + + + +Fielding, et al. Standards Track [Page 149] + +RFC 2616 HTTP/1.1 June 1999 + + + 214 Transformation applied + MUST be added by an intermediate cache or proxy if it applies any + transformation changing the content-coding (as specified in the + Content-Encoding header) or media-type (as specified in the + Content-Type header) of the response, or the entity-body of the + response, unless this Warning code already appears in the response. + + 299 Miscellaneous persistent warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action. + + If an implementation sends a message with one or more Warning headers + whose version is HTTP/1.0 or lower, then the sender MUST include in + each warning-value a warn-date that matches the date in the response. + + If an implementation receives a message with a warning-value that + includes a warn-date, and that warn-date is different from the Date + value in the response, then that warning-value MUST be deleted from + the message before storing, forwarding, or using it. (This prevents + bad consequences of naive caching of Warning header fields.) If all + of the warning-values are deleted for this reason, the Warning header + MUST be deleted as well. + +14.47 WWW-Authenticate + + The WWW-Authenticate response-header field MUST be included in 401 + (Unauthorized) response messages. The field value consists of at + least one challenge that indicates the authentication scheme(s) and + parameters applicable to the Request-URI. + + WWW-Authenticate = "WWW-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. User + agents are advised to take special care in parsing the WWW- + Authenticate field value as it might contain more than one challenge, + or if more than one WWW-Authenticate header field is provided, the + contents of a challenge itself can contain a comma-separated list of + authentication parameters. + +15 Security Considerations + + This section is meant to inform application developers, information + providers, and users of the security limitations in HTTP/1.1 as + described by this document. The discussion does not include + definitive solutions to the problems revealed, though it does make + some suggestions for reducing security risks. + + + +Fielding, et al. Standards Track [Page 150] + +RFC 2616 HTTP/1.1 June 1999 + + +15.1 Personal Information + + HTTP clients are often privy to large amounts of personal information + (e.g. the user's name, location, mail address, passwords, encryption + keys, etc.), and SHOULD be very careful to prevent unintentional + leakage of this information via the HTTP protocol to other sources. + We very strongly recommend that a convenient interface be provided + for the user to control dissemination of such information, and that + designers and implementors be particularly careful in this area. + History shows that errors in this area often create serious security + and/or privacy problems and generate highly adverse publicity for the + implementor's company. + +15.1.1 Abuse of Server Log Information + + A server is in the position to save personal data about a user's + requests which might identify their reading patterns or subjects of + interest. This information is clearly confidential in nature and its + handling can be constrained by law in certain countries. People using + the HTTP protocol to provide data are responsible for ensuring that + such material is not distributed without the permission of any + individuals that are identifiable by the published results. + +15.1.2 Transfer of Sensitive Information + + Like any generic data transfer protocol, HTTP cannot regulate the + content of the data that is transferred, nor is there any a priori + method of determining the sensitivity of any particular piece of + information within the context of any given request. Therefore, + applications SHOULD supply as much control over this information as + possible to the provider of that information. Four header fields are + worth special mention in this context: Server, Via, Referer and From. + + Revealing the specific software version of the server might allow the + server machine to become more vulnerable to attacks against software + that is known to contain security holes. Implementors SHOULD make the + Server header field a configurable option. + + Proxies which serve as a portal through a network firewall SHOULD + take special precautions regarding the transfer of header information + that identifies the hosts behind the firewall. In particular, they + SHOULD remove, or replace with sanitized versions, any Via fields + generated behind the firewall. + + The Referer header allows reading patterns to be studied and reverse + links drawn. Although it can be very useful, its power can be abused + if user details are not separated from the information contained in + + + + +Fielding, et al. Standards Track [Page 151] + +RFC 2616 HTTP/1.1 June 1999 + + + the Referer. Even when the personal information has been removed, the + Referer header might indicate a private document's URI whose + publication would be inappropriate. + + The information sent in the From field might conflict with the user's + privacy interests or their site's security policy, and hence it + SHOULD NOT be transmitted without the user being able to disable, + enable, and modify the contents of the field. The user MUST be able + to set the contents of this field within a user preference or + application defaults configuration. + + We suggest, though do not require, that a convenient toggle interface + be provided for the user to enable or disable the sending of From and + Referer information. + + The User-Agent (section 14.43) or Server (section 14.38) header + fields can sometimes be used to determine that a specific client or + server have a particular security hole which might be exploited. + Unfortunately, this same information is often used for other valuable + purposes for which HTTP currently has no better mechanism. + +15.1.3 Encoding Sensitive Information in URI's + + Because the source of a link might be private information or might + reveal an otherwise private information source, it is strongly + recommended that the user be able to select whether or not the + Referer field is sent. For example, a browser client could have a + toggle switch for browsing openly/anonymously, which would + respectively enable/disable the sending of Referer and From + information. + + Clients SHOULD NOT include a Referer header field in a (non-secure) + HTTP request if the referring page was transferred with a secure + protocol. + + Authors of services which use the HTTP protocol SHOULD NOT use GET + based forms for the submission of sensitive data, because this will + cause this data to be encoded in the Request-URI. Many existing + servers, proxies, and user agents will log the request URI in some + place where it might be visible to third parties. Servers can use + POST-based form submission instead + +15.1.4 Privacy Issues Connected to Accept Headers + + Accept request-headers can reveal information about the user to all + servers which are accessed. The Accept-Language header in particular + can reveal information the user would consider to be of a private + nature, because the understanding of particular languages is often + + + +Fielding, et al. Standards Track [Page 152] + +RFC 2616 HTTP/1.1 June 1999 + + + strongly correlated to the membership of a particular ethnic group. + User agents which offer the option to configure the contents of an + Accept-Language header to be sent in every request are strongly + encouraged to let the configuration process include a message which + makes the user aware of the loss of privacy involved. + + An approach that limits the loss of privacy would be for a user agent + to omit the sending of Accept-Language headers by default, and to ask + the user whether or not to start sending Accept-Language headers to a + server if it detects, by looking for any Vary response-header fields + generated by the server, that such sending could improve the quality + of service. + + Elaborate user-customized accept header fields sent in every request, + in particular if these include quality values, can be used by servers + as relatively reliable and long-lived user identifiers. Such user + identifiers would allow content providers to do click-trail tracking, + and would allow collaborating content providers to match cross-server + click-trails or form submissions of individual users. Note that for + many users not behind a proxy, the network address of the host + running the user agent will also serve as a long-lived user + identifier. In environments where proxies are used to enhance + privacy, user agents ought to be conservative in offering accept + header configuration options to end users. As an extreme privacy + measure, proxies could filter the accept headers in relayed requests. + General purpose user agents which provide a high degree of header + configurability SHOULD warn users about the loss of privacy which can + be involved. + +15.2 Attacks Based On File and Path Names + + Implementations of HTTP origin servers SHOULD be careful to restrict + the documents returned by HTTP requests to be only those that were + intended by the server administrators. If an HTTP server translates + HTTP URIs directly into file system calls, the server MUST take + special care not to serve files that were not intended to be + delivered to HTTP clients. For example, UNIX, Microsoft Windows, and + other operating systems use ".." as a path component to indicate a + directory level above the current one. On such a system, an HTTP + server MUST disallow any such construct in the Request-URI if it + would otherwise allow access to a resource outside those intended to + be accessible via the HTTP server. Similarly, files intended for + reference only internally to the server (such as access control + files, configuration files, and script code) MUST be protected from + inappropriate retrieval, since they might contain sensitive + information. Experience has shown that minor bugs in such HTTP server + implementations have turned into security risks. + + + + +Fielding, et al. Standards Track [Page 153] + +RFC 2616 HTTP/1.1 June 1999 + + +15.3 DNS Spoofing + + Clients using HTTP rely heavily on the Domain Name Service, and are + thus generally prone to security attacks based on the deliberate + mis-association of IP addresses and DNS names. Clients need to be + cautious in assuming the continuing validity of an IP number/DNS name + association. + + In particular, HTTP clients SHOULD rely on their name resolver for + confirmation of an IP number/DNS name association, rather than + caching the result of previous host name lookups. Many platforms + already can cache host name lookups locally when appropriate, and + they SHOULD be configured to do so. It is proper for these lookups to + be cached, however, only when the TTL (Time To Live) information + reported by the name server makes it likely that the cached + information will remain useful. + + If HTTP clients cache the results of host name lookups in order to + achieve a performance improvement, they MUST observe the TTL + information reported by DNS. + + If HTTP clients do not observe this rule, they could be spoofed when + a previously-accessed server's IP address changes. As network + renumbering is expected to become increasingly common [24], the + possibility of this form of attack will grow. Observing this + requirement thus reduces this potential security vulnerability. + + This requirement also improves the load-balancing behavior of clients + for replicated servers using the same DNS name and reduces the + likelihood of a user's experiencing failure in accessing sites which + use that strategy. + +15.4 Location Headers and Spoofing + + If a single server supports multiple organizations that do not trust + one another, then it MUST check the values of Location and Content- + Location headers in responses that are generated under control of + said organizations to make sure that they do not attempt to + invalidate resources over which they have no authority. + +15.5 Content-Disposition Issues + + RFC 1806 [35], from which the often implemented Content-Disposition + (see section 19.5.1) header in HTTP is derived, has a number of very + serious security considerations. Content-Disposition is not part of + the HTTP standard, but since it is widely implemented, we are + documenting its use and risks for implementors. See RFC 2183 [49] + (which updates RFC 1806) for details. + + + +Fielding, et al. Standards Track [Page 154] + +RFC 2616 HTTP/1.1 June 1999 + + +15.6 Authentication Credentials and Idle Clients + + Existing HTTP clients and user agents typically retain authentication + information indefinitely. HTTP/1.1. does not provide a method for a + server to direct clients to discard these cached credentials. This is + a significant defect that requires further extensions to HTTP. + Circumstances under which credential caching can interfere with the + application's security model include but are not limited to: + + - Clients which have been idle for an extended period following + which the server might wish to cause the client to reprompt the + user for credentials. + + - Applications which include a session termination indication + (such as a `logout' or `commit' button on a page) after which + the server side of the application `knows' that there is no + further reason for the client to retain the credentials. + + This is currently under separate study. There are a number of work- + arounds to parts of this problem, and we encourage the use of + password protection in screen savers, idle time-outs, and other + methods which mitigate the security problems inherent in this + problem. In particular, user agents which cache credentials are + encouraged to provide a readily accessible mechanism for discarding + cached credentials under user control. + +15.7 Proxies and Caching + + By their very nature, HTTP proxies are men-in-the-middle, and + represent an opportunity for man-in-the-middle attacks. Compromise of + the systems on which the proxies run can result in serious security + and privacy problems. Proxies have access to security-related + information, personal information about individual users and + organizations, and proprietary information belonging to users and + content providers. A compromised proxy, or a proxy implemented or + configured without regard to security and privacy considerations, + might be used in the commission of a wide range of potential attacks. + + Proxy operators should protect the systems on which proxies run as + they would protect any system that contains or transports sensitive + information. In particular, log information gathered at proxies often + contains highly sensitive personal information, and/or information + about organizations. Log information should be carefully guarded, and + appropriate guidelines for use developed and followed. (Section + 15.1.1). + + + + + + +Fielding, et al. Standards Track [Page 155] + +RFC 2616 HTTP/1.1 June 1999 + + + Caching proxies provide additional potential vulnerabilities, since + the contents of the cache represent an attractive target for + malicious exploitation. Because cache contents persist after an HTTP + request is complete, an attack on the cache can reveal information + long after a user believes that the information has been removed from + the network. Therefore, cache contents should be protected as + sensitive information. + + Proxy implementors should consider the privacy and security + implications of their design and coding decisions, and of the + configuration options they provide to proxy operators (especially the + default configuration). + + Users of a proxy need to be aware that they are no trustworthier than + the people who run the proxy; HTTP itself cannot solve this problem. + + The judicious use of cryptography, when appropriate, may suffice to + protect against a broad range of security and privacy attacks. Such + cryptography is beyond the scope of the HTTP/1.1 specification. + +15.7.1 Denial of Service Attacks on Proxies + + They exist. They are hard to defend against. Research continues. + Beware. + +16 Acknowledgments + + This specification makes heavy use of the augmented BNF and generic + constructs defined by David H. Crocker for RFC 822 [9]. Similarly, it + reuses many of the definitions provided by Nathaniel Borenstein and + Ned Freed for MIME [7]. We hope that their inclusion in this + specification will help reduce past confusion over the relationship + between HTTP and Internet mail message formats. + + The HTTP protocol has evolved considerably over the years. It has + benefited from a large and active developer community--the many + people who have participated on the www-talk mailing list--and it is + that community which has been most responsible for the success of + HTTP and of the World-Wide Web in general. Marc Andreessen, Robert + Cailliau, Daniel W. Connolly, Bob Denny, John Franks, Jean-Francois + Groff, Phillip M. Hallam-Baker, Hakon W. Lie, Ari Luotonen, Rob + McCool, Lou Montulli, Dave Raggett, Tony Sanders, and Marc + VanHeyningen deserve special recognition for their efforts in + defining early aspects of the protocol. + + This document has benefited greatly from the comments of all those + participating in the HTTP-WG. In addition to those already mentioned, + the following individuals have contributed to this specification: + + + +Fielding, et al. Standards Track [Page 156] + +RFC 2616 HTTP/1.1 June 1999 + + + Gary Adams Ross Patterson + Harald Tveit Alvestrand Albert Lunde + Keith Ball John C. Mallery + Brian Behlendorf Jean-Philippe Martin-Flatin + Paul Burchard Mitra + Maurizio Codogno David Morris + Mike Cowlishaw Gavin Nicol + Roman Czyborra Bill Perry + Michael A. Dolan Jeffrey Perry + David J. Fiander Scott Powers + Alan Freier Owen Rees + Marc Hedlund Luigi Rizzo + Greg Herlihy David Robinson + Koen Holtman Marc Salomon + Alex Hopmann Rich Salz + Bob Jernigan Allan M. Schiffman + Shel Kaphan Jim Seidman + Rohit Khare Chuck Shotton + John Klensin Eric W. Sink + Martijn Koster Simon E. Spero + Alexei Kosut Richard N. Taylor + David M. Kristol Robert S. Thau + Daniel LaLiberte Bill (BearHeart) Weinman + Ben Laurie Francois Yergeau + Paul J. Leach Mary Ellen Zurko + Daniel DuBois Josh Cohen + + + Much of the content and presentation of the caching design is due to + suggestions and comments from individuals including: Shel Kaphan, + Paul Leach, Koen Holtman, David Morris, and Larry Masinter. + + Most of the specification of ranges is based on work originally done + by Ari Luotonen and John Franks, with additional input from Steve + Zilles. + + Thanks to the "cave men" of Palo Alto. You know who you are. + + Jim Gettys (the current editor of this document) wishes particularly + to thank Roy Fielding, the previous editor of this document, along + with John Klensin, Jeff Mogul, Paul Leach, Dave Kristol, Koen + Holtman, John Franks, Josh Cohen, Alex Hopmann, Scott Lawrence, and + Larry Masinter for their help. And thanks go particularly to Jeff + Mogul and Scott Lawrence for performing the "MUST/MAY/SHOULD" audit. + + + + + + + +Fielding, et al. Standards Track [Page 157] + +RFC 2616 HTTP/1.1 June 1999 + + + The Apache Group, Anselm Baird-Smith, author of Jigsaw, and Henrik + Frystyk implemented RFC 2068 early, and we wish to thank them for the + discovery of many of the problems that this document attempts to + rectify. + +17 References + + [1] Alvestrand, H., "Tags for the Identification of Languages", RFC + 1766, March 1995. + + [2] Anklesaria, F., McCahill, M., Lindner, P., Johnson, D., Torrey, + D. and B. Alberti, "The Internet Gopher Protocol (a distributed + document search and retrieval protocol)", RFC 1436, March 1993. + + [3] Berners-Lee, T., "Universal Resource Identifiers in WWW", RFC + 1630, June 1994. + + [4] Berners-Lee, T., Masinter, L. and M. McCahill, "Uniform Resource + Locators (URL)", RFC 1738, December 1994. + + [5] Berners-Lee, T. and D. Connolly, "Hypertext Markup Language - + 2.0", RFC 1866, November 1995. + + [6] Berners-Lee, T., Fielding, R. and H. Frystyk, "Hypertext Transfer + Protocol -- HTTP/1.0", RFC 1945, May 1996. + + [7] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part One: Format of Internet Message Bodies", + RFC 2045, November 1996. + + [8] Braden, R., "Requirements for Internet Hosts -- Communication + Layers", STD 3, RFC 1123, October 1989. + + [9] Crocker, D., "Standard for The Format of ARPA Internet Text + Messages", STD 11, RFC 822, August 1982. + + [10] Davis, F., Kahle, B., Morris, H., Salem, J., Shen, T., Wang, R., + Sui, J., and M. Grinbaum, "WAIS Interface Protocol Prototype + Functional Specification," (v1.5), Thinking Machines + Corporation, April 1990. + + [11] Fielding, R., "Relative Uniform Resource Locators", RFC 1808, + June 1995. + + [12] Horton, M. and R. Adams, "Standard for Interchange of USENET + Messages", RFC 1036, December 1987. + + + + + +Fielding, et al. Standards Track [Page 158] + +RFC 2616 HTTP/1.1 June 1999 + + + [13] Kantor, B. and P. Lapsley, "Network News Transfer Protocol", RFC + 977, February 1986. + + [14] Moore, K., "MIME (Multipurpose Internet Mail Extensions) Part + Three: Message Header Extensions for Non-ASCII Text", RFC 2047, + November 1996. + + [15] Nebel, E. and L. Masinter, "Form-based File Upload in HTML", RFC + 1867, November 1995. + + [16] Postel, J., "Simple Mail Transfer Protocol", STD 10, RFC 821, + August 1982. + + [17] Postel, J., "Media Type Registration Procedure", RFC 1590, + November 1996. + + [18] Postel, J. and J. Reynolds, "File Transfer Protocol", STD 9, RFC + 959, October 1985. + + [19] Reynolds, J. and J. Postel, "Assigned Numbers", STD 2, RFC 1700, + October 1994. + + [20] Sollins, K. and L. Masinter, "Functional Requirements for + Uniform Resource Names", RFC 1737, December 1994. + + [21] US-ASCII. Coded Character Set - 7-Bit American Standard Code for + Information Interchange. Standard ANSI X3.4-1986, ANSI, 1986. + + [22] ISO-8859. International Standard -- Information Processing -- + 8-bit Single-Byte Coded Graphic Character Sets -- + Part 1: Latin alphabet No. 1, ISO-8859-1:1987. + Part 2: Latin alphabet No. 2, ISO-8859-2, 1987. + Part 3: Latin alphabet No. 3, ISO-8859-3, 1988. + Part 4: Latin alphabet No. 4, ISO-8859-4, 1988. + Part 5: Latin/Cyrillic alphabet, ISO-8859-5, 1988. + Part 6: Latin/Arabic alphabet, ISO-8859-6, 1987. + Part 7: Latin/Greek alphabet, ISO-8859-7, 1987. + Part 8: Latin/Hebrew alphabet, ISO-8859-8, 1988. + Part 9: Latin alphabet No. 5, ISO-8859-9, 1990. + + [23] Meyers, J. and M. Rose, "The Content-MD5 Header Field", RFC + 1864, October 1995. + + [24] Carpenter, B. and Y. Rekhter, "Renumbering Needs Work", RFC + 1900, February 1996. + + [25] Deutsch, P., "GZIP file format specification version 4.3", RFC + 1952, May 1996. + + + +Fielding, et al. Standards Track [Page 159] + +RFC 2616 HTTP/1.1 June 1999 + + + [26] Venkata N. Padmanabhan, and Jeffrey C. Mogul. "Improving HTTP + Latency", Computer Networks and ISDN Systems, v. 28, pp. 25-35, + Dec. 1995. Slightly revised version of paper in Proc. 2nd + International WWW Conference '94: Mosaic and the Web, Oct. 1994, + which is available at + http://www.ncsa.uiuc.edu/SDG/IT94/Proceedings/DDay/mogul/HTTPLat + ency.html. + + [27] Joe Touch, John Heidemann, and Katia Obraczka. "Analysis of HTTP + Performance", , + ISI Research Report ISI/RR-98-463, (original report dated Aug. + 1996), USC/Information Sciences Institute, August 1998. + + [28] Mills, D., "Network Time Protocol (Version 3) Specification, + Implementation and Analysis", RFC 1305, March 1992. + + [29] Deutsch, P., "DEFLATE Compressed Data Format Specification + version 1.3", RFC 1951, May 1996. + + [30] S. Spero, "Analysis of HTTP Performance Problems," + http://sunsite.unc.edu/mdma-release/http-prob.html. + + [31] Deutsch, P. and J. Gailly, "ZLIB Compressed Data Format + Specification version 3.3", RFC 1950, May 1996. + + [32] Franks, J., Hallam-Baker, P., Hostetler, J., Leach, P., + Luotonen, A., Sink, E. and L. Stewart, "An Extension to HTTP: + Digest Access Authentication", RFC 2069, January 1997. + + [33] Fielding, R., Gettys, J., Mogul, J., Frystyk, H. and T. + Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1", RFC + 2068, January 1997. + + [34] Bradner, S., "Key words for use in RFCs to Indicate Requirement + Levels", BCP 14, RFC 2119, March 1997. + + [35] Troost, R. and Dorner, S., "Communicating Presentation + Information in Internet Messages: The Content-Disposition + Header", RFC 1806, June 1995. + + [36] Mogul, J., Fielding, R., Gettys, J. and H. Frystyk, "Use and + Interpretation of HTTP Version Numbers", RFC 2145, May 1997. + [jg639] + + [37] Palme, J., "Common Internet Message Headers", RFC 2076, February + 1997. [jg640] + + + + + +Fielding, et al. Standards Track [Page 160] + +RFC 2616 HTTP/1.1 June 1999 + + + [38] Yergeau, F., "UTF-8, a transformation format of Unicode and + ISO-10646", RFC 2279, January 1998. [jg641] + + [39] Nielsen, H.F., Gettys, J., Baird-Smith, A., Prud'hommeaux, E., + Lie, H., and C. Lilley. "Network Performance Effects of + HTTP/1.1, CSS1, and PNG," Proceedings of ACM SIGCOMM '97, Cannes + France, September 1997.[jg642] + + [40] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Two: Media Types", RFC 2046, November + 1996. [jg643] + + [41] Alvestrand, H., "IETF Policy on Character Sets and Languages", + BCP 18, RFC 2277, January 1998. [jg644] + + [42] Berners-Lee, T., Fielding, R. and L. Masinter, "Uniform Resource + Identifiers (URI): Generic Syntax and Semantics", RFC 2396, + August 1998. [jg645] + + [43] Franks, J., Hallam-Baker, P., Hostetler, J., Lawrence, S., + Leach, P., Luotonen, A., Sink, E. and L. Stewart, "HTTP + Authentication: Basic and Digest Access Authentication", RFC + 2617, June 1999. [jg646] + + [44] Luotonen, A., "Tunneling TCP based protocols through Web proxy + servers," Work in Progress. [jg647] + + [45] Palme, J. and A. Hopmann, "MIME E-mail Encapsulation of + Aggregate Documents, such as HTML (MHTML)", RFC 2110, March + 1997. + + [46] Bradner, S., "The Internet Standards Process -- Revision 3", BCP + 9, RFC 2026, October 1996. + + [47] Masinter, L., "Hyper Text Coffee Pot Control Protocol + (HTCPCP/1.0)", RFC 2324, 1 April 1998. + + [48] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Five: Conformance Criteria and Examples", + RFC 2049, November 1996. + + [49] Troost, R., Dorner, S. and K. Moore, "Communicating Presentation + Information in Internet Messages: The Content-Disposition Header + Field", RFC 2183, August 1997. + + + + + + + +Fielding, et al. Standards Track [Page 161] + +RFC 2616 HTTP/1.1 June 1999 + + +18 Authors' Addresses + + Roy T. Fielding + Information and Computer Science + University of California, Irvine + Irvine, CA 92697-3425, USA + + Fax: +1 (949) 824-1715 + EMail: fielding@ics.uci.edu + + + James Gettys + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: jg@w3.org + + + Jeffrey C. Mogul + Western Research Laboratory + Compaq Computer Corporation + 250 University Avenue + Palo Alto, California, 94305, USA + + EMail: mogul@wrl.dec.com + + + Henrik Frystyk Nielsen + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: frystyk@w3.org + + + Larry Masinter + Xerox Corporation + 3333 Coyote Hill Road + Palo Alto, CA 94034, USA + + EMail: masinter@parc.xerox.com + + + + + +Fielding, et al. Standards Track [Page 162] + +RFC 2616 HTTP/1.1 June 1999 + + + Paul J. Leach + Microsoft Corporation + 1 Microsoft Way + Redmond, WA 98052, USA + + EMail: paulle@microsoft.com + + + Tim Berners-Lee + Director, World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: timbl@w3.org + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 163] + +RFC 2616 HTTP/1.1 June 1999 + + +19 Appendices + +19.1 Internet Media Type message/http and application/http + + In addition to defining the HTTP/1.1 protocol, this document serves + as the specification for the Internet media type "message/http" and + "application/http". The message/http type can be used to enclose a + single HTTP request or response message, provided that it obeys the + MIME restrictions for all "message" types regarding line length and + encodings. The application/http type can be used to enclose a + pipeline of one or more HTTP request or response messages (not + intermixed). The following is to be registered with IANA [17]. + + Media Type name: message + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed message + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + Media Type name: application + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed messages + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: HTTP messages enclosed by this type + are in "binary" format; use of an appropriate + Content-Transfer-Encoding is required when + transmitted via E-mail. + Security considerations: none + + + + + + + + + +Fielding, et al. Standards Track [Page 164] + +RFC 2616 HTTP/1.1 June 1999 + + +19.2 Internet Media Type multipart/byteranges + + When an HTTP 206 (Partial Content) response message includes the + content of multiple ranges (a response to a request for multiple + non-overlapping ranges), these are transmitted as a multipart + message-body. The media type for this purpose is called + "multipart/byteranges". + + The multipart/byteranges media type includes two or more parts, each + with its own Content-Type and Content-Range fields. The required + boundary parameter specifies the boundary string used to separate + each body-part. + + Media Type name: multipart + Media subtype name: byteranges + Required parameters: boundary + Optional parameters: none + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + + For example: + + HTTP/1.1 206 Partial Content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-type: multipart/byteranges; boundary=THIS_STRING_SEPARATES + + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 500-999/8000 + + ...the first range... + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 7000-7999/8000 + + ...the second range + --THIS_STRING_SEPARATES-- + + Notes: + + 1) Additional CRLFs may precede the first boundary string in the + entity. + + + + + + +Fielding, et al. Standards Track [Page 165] + +RFC 2616 HTTP/1.1 June 1999 + + + 2) Although RFC 2046 [40] permits the boundary string to be + quoted, some existing implementations handle a quoted boundary + string incorrectly. + + 3) A number of browsers and servers were coded to an early draft + of the byteranges specification to use a media type of + multipart/x-byteranges, which is almost, but not quite + compatible with the version documented in HTTP/1.1. + +19.3 Tolerant Applications + + Although this document specifies the requirements for the generation + of HTTP/1.1 messages, not all applications will be correct in their + implementation. We therefore recommend that operational applications + be tolerant of deviations whenever those deviations can be + interpreted unambiguously. + + Clients SHOULD be tolerant in parsing the Status-Line and servers + tolerant when parsing the Request-Line. In particular, they SHOULD + accept any amount of SP or HT characters between fields, even though + only a single SP is required. + + The line terminator for message-header fields is the sequence CRLF. + However, we recommend that applications, when parsing such headers, + recognize a single LF as a line terminator and ignore the leading CR. + + The character set of an entity-body SHOULD be labeled as the lowest + common denominator of the character codes used within that body, with + the exception that not labeling the entity is preferred over labeling + the entity with the labels US-ASCII or ISO-8859-1. See section 3.7.1 + and 3.4.1. + + Additional rules for requirements on parsing and encoding of dates + and other potential problems with date encodings include: + + - HTTP/1.1 clients and caches SHOULD assume that an RFC-850 date + which appears to be more than 50 years in the future is in fact + in the past (this helps solve the "year 2000" problem). + + - An HTTP/1.1 implementation MAY internally represent a parsed + Expires date as earlier than the proper value, but MUST NOT + internally represent a parsed Expires date as later than the + proper value. + + - All expiration-related calculations MUST be done in GMT. The + local time zone MUST NOT influence the calculation or comparison + of an age or expiration time. + + + + +Fielding, et al. Standards Track [Page 166] + +RFC 2616 HTTP/1.1 June 1999 + + + - If an HTTP header incorrectly carries a date value with a time + zone other than GMT, it MUST be converted into GMT using the + most conservative possible conversion. + +19.4 Differences Between HTTP Entities and RFC 2045 Entities + + HTTP/1.1 uses many of the constructs defined for Internet Mail (RFC + 822 [9]) and the Multipurpose Internet Mail Extensions (MIME [7]) to + allow entities to be transmitted in an open variety of + representations and with extensible mechanisms. However, RFC 2045 + discusses mail, and HTTP has a few features that are different from + those described in RFC 2045. These differences were carefully chosen + to optimize performance over binary connections, to allow greater + freedom in the use of new media types, to make date comparisons + easier, and to acknowledge the practice of some early HTTP servers + and clients. + + This appendix describes specific areas where HTTP differs from RFC + 2045. Proxies and gateways to strict MIME environments SHOULD be + aware of these differences and provide the appropriate conversions + where necessary. Proxies and gateways from MIME environments to HTTP + also need to be aware of the differences because some conversions + might be required. + +19.4.1 MIME-Version + + HTTP is not a MIME-compliant protocol. However, HTTP/1.1 messages MAY + include a single MIME-Version general-header field to indicate what + version of the MIME protocol was used to construct the message. Use + of the MIME-Version header field indicates that the message is in + full compliance with the MIME protocol (as defined in RFC 2045[7]). + Proxies/gateways are responsible for ensuring full compliance (where + possible) when exporting HTTP messages to strict MIME environments. + + MIME-Version = "MIME-Version" ":" 1*DIGIT "." 1*DIGIT + + MIME version "1.0" is the default for use in HTTP/1.1. However, + HTTP/1.1 message parsing and semantics are defined by this document + and not the MIME specification. + +19.4.2 Conversion to Canonical Form + + RFC 2045 [7] requires that an Internet mail entity be converted to + canonical form prior to being transferred, as described in section 4 + of RFC 2049 [48]. Section 3.7.1 of this document describes the forms + allowed for subtypes of the "text" media type when transmitted over + HTTP. RFC 2046 requires that content with a type of "text" represent + line breaks as CRLF and forbids the use of CR or LF outside of line + + + +Fielding, et al. Standards Track [Page 167] + +RFC 2616 HTTP/1.1 June 1999 + + + break sequences. HTTP allows CRLF, bare CR, and bare LF to indicate a + line break within text content when a message is transmitted over + HTTP. + + Where it is possible, a proxy or gateway from HTTP to a strict MIME + environment SHOULD translate all line breaks within the text media + types described in section 3.7.1 of this document to the RFC 2049 + canonical form of CRLF. Note, however, that this might be complicated + by the presence of a Content-Encoding and by the fact that HTTP + allows the use of some character sets which do not use octets 13 and + 10 to represent CR and LF, as is the case for some multi-byte + character sets. + + Implementors should note that conversion will break any cryptographic + checksums applied to the original content unless the original content + is already in canonical form. Therefore, the canonical form is + recommended for any content that uses such checksums in HTTP. + +19.4.3 Conversion of Date Formats + + HTTP/1.1 uses a restricted set of date formats (section 3.3.1) to + simplify the process of date comparison. Proxies and gateways from + other protocols SHOULD ensure that any Date header field present in a + message conforms to one of the HTTP/1.1 formats and rewrite the date + if necessary. + +19.4.4 Introduction of Content-Encoding + + RFC 2045 does not include any concept equivalent to HTTP/1.1's + Content-Encoding header field. Since this acts as a modifier on the + media type, proxies and gateways from HTTP to MIME-compliant + protocols MUST either change the value of the Content-Type header + field or decode the entity-body before forwarding the message. (Some + experimental applications of Content-Type for Internet mail have used + a media-type parameter of ";conversions=" to perform + a function equivalent to Content-Encoding. However, this parameter is + not part of RFC 2045.) + +19.4.5 No Content-Transfer-Encoding + + HTTP does not use the Content-Transfer-Encoding (CTE) field of RFC + 2045. Proxies and gateways from MIME-compliant protocols to HTTP MUST + remove any non-identity CTE ("quoted-printable" or "base64") encoding + prior to delivering the response message to an HTTP client. + + Proxies and gateways from HTTP to MIME-compliant protocols are + responsible for ensuring that the message is in the correct format + and encoding for safe transport on that protocol, where "safe + + + +Fielding, et al. Standards Track [Page 168] + +RFC 2616 HTTP/1.1 June 1999 + + + transport" is defined by the limitations of the protocol being used. + Such a proxy or gateway SHOULD label the data with an appropriate + Content-Transfer-Encoding if doing so will improve the likelihood of + safe transport over the destination protocol. + +19.4.6 Introduction of Transfer-Encoding + + HTTP/1.1 introduces the Transfer-Encoding header field (section + 14.41). Proxies/gateways MUST remove any transfer-coding prior to + forwarding a message via a MIME-compliant protocol. + + A process for decoding the "chunked" transfer-coding (section 3.6) + can be represented in pseudo-code as: + + length := 0 + read chunk-size, chunk-extension (if any) and CRLF + while (chunk-size > 0) { + read chunk-data and CRLF + append chunk-data to entity-body + length := length + chunk-size + read chunk-size and CRLF + } + read entity-header + while (entity-header not empty) { + append entity-header to existing header fields + read entity-header + } + Content-Length := length + Remove "chunked" from Transfer-Encoding + +19.4.7 MHTML and Line Length Limitations + + HTTP implementations which share code with MHTML [45] implementations + need to be aware of MIME line length limitations. Since HTTP does not + have this limitation, HTTP does not fold long lines. MHTML messages + being transported by HTTP follow all conventions of MHTML, including + line length limitations and folding, canonicalization, etc., since + HTTP transports all message-bodies as payload (see section 3.7.2) and + does not interpret the content or any MIME header lines that might be + contained therein. + +19.5 Additional Features + + RFC 1945 and RFC 2068 document protocol elements used by some + existing HTTP implementations, but not consistently and correctly + across most HTTP/1.1 applications. Implementors are advised to be + aware of these features, but cannot rely upon their presence in, or + interoperability with, other HTTP/1.1 applications. Some of these + + + +Fielding, et al. Standards Track [Page 169] + +RFC 2616 HTTP/1.1 June 1999 + + + describe proposed experimental features, and some describe features + that experimental deployment found lacking that are now addressed in + the base HTTP/1.1 specification. + + A number of other headers, such as Content-Disposition and Title, + from SMTP and MIME are also often implemented (see RFC 2076 [37]). + +19.5.1 Content-Disposition + + The Content-Disposition response-header field has been proposed as a + means for the origin server to suggest a default filename if the user + requests that the content is saved to a file. This usage is derived + from the definition of Content-Disposition in RFC 1806 [35]. + + content-disposition = "Content-Disposition" ":" + disposition-type *( ";" disposition-parm ) + disposition-type = "attachment" | disp-extension-token + disposition-parm = filename-parm | disp-extension-parm + filename-parm = "filename" "=" quoted-string + disp-extension-token = token + disp-extension-parm = token "=" ( token | quoted-string ) + + An example is + + Content-Disposition: attachment; filename="fname.ext" + + The receiving user agent SHOULD NOT respect any directory path + information present in the filename-parm parameter, which is the only + parameter believed to apply to HTTP implementations at this time. The + filename SHOULD be treated as a terminal component only. + + If this header is used in a response with the application/octet- + stream content-type, the implied suggestion is that the user agent + should not display the response, but directly enter a `save response + as...' dialog. + + See section 15.5 for Content-Disposition security issues. + +19.6 Compatibility with Previous Versions + + It is beyond the scope of a protocol specification to mandate + compliance with previous versions. HTTP/1.1 was deliberately + designed, however, to make supporting previous versions easy. It is + worth noting that, at the time of composing this specification + (1996), we would expect commercial HTTP/1.1 servers to: + + - recognize the format of the Request-Line for HTTP/0.9, 1.0, and + 1.1 requests; + + + +Fielding, et al. Standards Track [Page 170] + +RFC 2616 HTTP/1.1 June 1999 + + + - understand any valid request in the format of HTTP/0.9, 1.0, or + 1.1; + + - respond appropriately with a message in the same major version + used by the client. + + And we would expect HTTP/1.1 clients to: + + - recognize the format of the Status-Line for HTTP/1.0 and 1.1 + responses; + + - understand any valid response in the format of HTTP/0.9, 1.0, or + 1.1. + + For most implementations of HTTP/1.0, each connection is established + by the client prior to the request and closed by the server after + sending the response. Some implementations implement the Keep-Alive + version of persistent connections described in section 19.7.1 of RFC + 2068 [33]. + +19.6.1 Changes from HTTP/1.0 + + This section summarizes major differences between versions HTTP/1.0 + and HTTP/1.1. + +19.6.1.1 Changes to Simplify Multi-homed Web Servers and Conserve IP + Addresses + + The requirements that clients and servers support the Host request- + header, report an error if the Host request-header (section 14.23) is + missing from an HTTP/1.1 request, and accept absolute URIs (section + 5.1.2) are among the most important changes defined by this + specification. + + Older HTTP/1.0 clients assumed a one-to-one relationship of IP + addresses and servers; there was no other established mechanism for + distinguishing the intended server of a request than the IP address + to which that request was directed. The changes outlined above will + allow the Internet, once older HTTP clients are no longer common, to + support multiple Web sites from a single IP address, greatly + simplifying large operational Web servers, where allocation of many + IP addresses to a single host has created serious problems. The + Internet will also be able to recover the IP addresses that have been + allocated for the sole purpose of allowing special-purpose domain + names to be used in root-level HTTP URLs. Given the rate of growth of + the Web, and the number of servers already deployed, it is extremely + + + + + +Fielding, et al. Standards Track [Page 171] + +RFC 2616 HTTP/1.1 June 1999 + + + important that all implementations of HTTP (including updates to + existing HTTP/1.0 applications) correctly implement these + requirements: + + - Both clients and servers MUST support the Host request-header. + + - A client that sends an HTTP/1.1 request MUST send a Host header. + + - Servers MUST report a 400 (Bad Request) error if an HTTP/1.1 + request does not include a Host request-header. + + - Servers MUST accept absolute URIs. + +19.6.2 Compatibility with HTTP/1.0 Persistent Connections + + Some clients and servers might wish to be compatible with some + previous implementations of persistent connections in HTTP/1.0 + clients and servers. Persistent connections in HTTP/1.0 are + explicitly negotiated as they are not the default behavior. HTTP/1.0 + experimental implementations of persistent connections are faulty, + and the new facilities in HTTP/1.1 are designed to rectify these + problems. The problem was that some existing 1.0 clients may be + sending Keep-Alive to a proxy server that doesn't understand + Connection, which would then erroneously forward it to the next + inbound server, which would establish the Keep-Alive connection and + result in a hung HTTP/1.0 proxy waiting for the close on the + response. The result is that HTTP/1.0 clients must be prevented from + using Keep-Alive when talking to proxies. + + However, talking to proxies is the most important use of persistent + connections, so that prohibition is clearly unacceptable. Therefore, + we need some other mechanism for indicating a persistent connection + is desired, which is safe to use even when talking to an old proxy + that ignores Connection. Persistent connections are the default for + HTTP/1.1 messages; we introduce a new keyword (Connection: close) for + declaring non-persistence. See section 14.10. + + The original HTTP/1.0 form of persistent connections (the Connection: + Keep-Alive and Keep-Alive header) is documented in RFC 2068. [33] + +19.6.3 Changes from RFC 2068 + + This specification has been carefully audited to correct and + disambiguate key word usage; RFC 2068 had many problems in respect to + the conventions laid out in RFC 2119 [34]. + + Clarified which error code should be used for inbound server failures + (e.g. DNS failures). (Section 10.5.5). + + + +Fielding, et al. Standards Track [Page 172] + +RFC 2616 HTTP/1.1 June 1999 + + + CREATE had a race that required an Etag be sent when a resource is + first created. (Section 10.2.2). + + Content-Base was deleted from the specification: it was not + implemented widely, and there is no simple, safe way to introduce it + without a robust extension mechanism. In addition, it is used in a + similar, but not identical fashion in MHTML [45]. + + Transfer-coding and message lengths all interact in ways that + required fixing exactly when chunked encoding is used (to allow for + transfer encoding that may not be self delimiting); it was important + to straighten out exactly how message lengths are computed. (Sections + 3.6, 4.4, 7.2.2, 13.5.2, 14.13, 14.16) + + A content-coding of "identity" was introduced, to solve problems + discovered in caching. (section 3.5) + + Quality Values of zero should indicate that "I don't want something" + to allow clients to refuse a representation. (Section 3.9) + + The use and interpretation of HTTP version numbers has been clarified + by RFC 2145. Require proxies to upgrade requests to highest protocol + version they support to deal with problems discovered in HTTP/1.0 + implementations (Section 3.1) + + Charset wildcarding is introduced to avoid explosion of character set + names in accept headers. (Section 14.2) + + A case was missed in the Cache-Control model of HTTP/1.1; s-maxage + was introduced to add this missing case. (Sections 13.4, 14.8, 14.9, + 14.9.3) + + The Cache-Control: max-age directive was not properly defined for + responses. (Section 14.9.3) + + There are situations where a server (especially a proxy) does not + know the full length of a response but is capable of serving a + byterange request. We therefore need a mechanism to allow byteranges + with a content-range not indicating the full length of the message. + (Section 14.16) + + Range request responses would become very verbose if all meta-data + were always returned; by allowing the server to only send needed + headers in a 206 response, this problem can be avoided. (Section + 10.2.7, 13.5.3, and 14.27) + + + + + + +Fielding, et al. Standards Track [Page 173] + +RFC 2616 HTTP/1.1 June 1999 + + + Fix problem with unsatisfiable range requests; there are two cases: + syntactic problems, and range doesn't exist in the document. The 416 + status code was needed to resolve this ambiguity needed to indicate + an error for a byte range request that falls outside of the actual + contents of a document. (Section 10.4.17, 14.16) + + Rewrite of message transmission requirements to make it much harder + for implementors to get it wrong, as the consequences of errors here + can have significant impact on the Internet, and to deal with the + following problems: + + 1. Changing "HTTP/1.1 or later" to "HTTP/1.1", in contexts where + this was incorrectly placing a requirement on the behavior of + an implementation of a future version of HTTP/1.x + + 2. Made it clear that user-agents should retry requests, not + "clients" in general. + + 3. Converted requirements for clients to ignore unexpected 100 + (Continue) responses, and for proxies to forward 100 responses, + into a general requirement for 1xx responses. + + 4. Modified some TCP-specific language, to make it clearer that + non-TCP transports are possible for HTTP. + + 5. Require that the origin server MUST NOT wait for the request + body before it sends a required 100 (Continue) response. + + 6. Allow, rather than require, a server to omit 100 (Continue) if + it has already seen some of the request body. + + 7. Allow servers to defend against denial-of-service attacks and + broken clients. + + This change adds the Expect header and 417 status code. The message + transmission requirements fixes are in sections 8.2, 10.4.18, + 8.1.2.2, 13.11, and 14.20. + + Proxies should be able to add Content-Length when appropriate. + (Section 13.5.2) + + Clean up confusion between 403 and 404 responses. (Section 10.4.4, + 10.4.5, and 10.4.11) + + Warnings could be cached incorrectly, or not updated appropriately. + (Section 13.1.2, 13.2.4, 13.5.2, 13.5.3, 14.9.3, and 14.46) Warning + also needed to be a general header, as PUT or other methods may have + need for it in requests. + + + +Fielding, et al. Standards Track [Page 174] + +RFC 2616 HTTP/1.1 June 1999 + + + Transfer-coding had significant problems, particularly with + interactions with chunked encoding. The solution is that transfer- + codings become as full fledged as content-codings. This involves + adding an IANA registry for transfer-codings (separate from content + codings), a new header field (TE) and enabling trailer headers in the + future. Transfer encoding is a major performance benefit, so it was + worth fixing [39]. TE also solves another, obscure, downward + interoperability problem that could have occurred due to interactions + between authentication trailers, chunked encoding and HTTP/1.0 + clients.(Section 3.6, 3.6.1, and 14.39) + + The PATCH, LINK, UNLINK methods were defined but not commonly + implemented in previous versions of this specification. See RFC 2068 + [33]. + + The Alternates, Content-Version, Derived-From, Link, URI, Public and + Content-Base header fields were defined in previous versions of this + specification, but not commonly implemented. See RFC 2068 [33]. + +20 Index + + Please see the PostScript version of this RFC for the INDEX. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 175] + +RFC 2616 HTTP/1.1 June 1999 + + +21. Full Copyright Statement + + Copyright (C) The Internet Society (1999). All Rights Reserved. + + This document and translations of it may be copied and furnished to + others, and derivative works that comment on or otherwise explain it + or assist in its implementation may be prepared, copied, published + and distributed, in whole or in part, without restriction of any + kind, provided that the above copyright notice and this paragraph are + included on all such copies and derivative works. However, this + document itself may not be modified in any way, such as by removing + the copyright notice or references to the Internet Society or other + Internet organizations, except as needed for the purpose of + developing Internet standards in which case the procedures for + copyrights defined in the Internet Standards process must be + followed, or as required to translate it into languages other than + English. + + The limited permissions granted above are perpetual and will not be + revoked by the Internet Society or its successors or assigns. + + This document and the information contained herein is provided on an + "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING + TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING + BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION + HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF + MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + +Acknowledgement + + Funding for the RFC Editor function is currently provided by the + Internet Society. + + Network Working Group R. Fielding +Request for Comments: 2616 UC Irvine +Obsoletes: 2068 J. Gettys +Category: Standards Track Compaq/W3C + J. Mogul + Compaq + H. Frystyk + W3C/MIT + L. Masinter + Xerox + P. Leach + Microsoft + T. Berners-Lee + W3C/MIT + June 1999 + + + Hypertext Transfer Protocol -- HTTP/1.1 + +Status of this Memo + + This document specifies an Internet standards track protocol for the + Internet community, and requests discussion and suggestions for + improvements. Please refer to the current edition of the "Internet + Official Protocol Standards" (STD 1) for the standardization state + and status of this protocol. Distribution of this memo is unlimited. + +Copyright Notice + + Copyright (C) The Internet Society (1999). All Rights Reserved. + +Abstract + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. It is a generic, stateless, protocol which can be used for + many tasks beyond its use for hypertext, such as name servers and + distributed object management systems, through extension of its + request methods, error codes and headers [47]. A feature of HTTP is + the typing and negotiation of data representation, allowing systems + to be built independently of the data being transferred. + + HTTP has been in use by the World-Wide Web global information + initiative since 1990. This specification defines the protocol + referred to as "HTTP/1.1", and is an update to RFC 2068 [33]. + + + + + + +Fielding, et al. Standards Track [Page 1] + +RFC 2616 HTTP/1.1 June 1999 + + +Table of Contents + + 1 Introduction ...................................................7 + 1.1 Purpose......................................................7 + 1.2 Requirements .................................................8 + 1.3 Terminology ..................................................8 + 1.4 Overall Operation ...........................................12 + 2 Notational Conventions and Generic Grammar ....................14 + 2.1 Augmented BNF ...............................................14 + 2.2 Basic Rules .................................................15 + 3 Protocol Parameters ...........................................17 + 3.1 HTTP Version ................................................17 + 3.2 Uniform Resource Identifiers ................................18 + 3.2.1 General Syntax ...........................................19 + 3.2.2 http URL .................................................19 + 3.2.3 URI Comparison ...........................................20 + 3.3 Date/Time Formats ...........................................20 + 3.3.1 Full Date ................................................20 + 3.3.2 Delta Seconds ............................................21 + 3.4 Character Sets ..............................................21 + 3.4.1 Missing Charset ..........................................22 + 3.5 Content Codings .............................................23 + 3.6 Transfer Codings ............................................24 + 3.6.1 Chunked Transfer Coding ..................................25 + 3.7 Media Types .................................................26 + 3.7.1 Canonicalization and Text Defaults .......................27 + 3.7.2 Multipart Types ..........................................27 + 3.8 Product Tokens ..............................................28 + 3.9 Quality Values ..............................................29 + 3.10 Language Tags ...............................................29 + 3.11 Entity Tags .................................................30 + 3.12 Range Units .................................................30 + 4 HTTP Message ..................................................31 + 4.1 Message Types ...............................................31 + 4.2 Message Headers .............................................31 + 4.3 Message Body ................................................32 + 4.4 Message Length ..............................................33 + 4.5 General Header Fields .......................................34 + 5 Request .......................................................35 + 5.1 Request-Line ................................................35 + 5.1.1 Method ...................................................36 + 5.1.2 Request-URI ..............................................36 + 5.2 The Resource Identified by a Request ........................38 + 5.3 Request Header Fields .......................................38 + 6 Response ......................................................39 + 6.1 Status-Line .................................................39 + 6.1.1 Status Code and Reason Phrase ............................39 + 6.2 Response Header Fields ......................................41 + + + +Fielding, et al. Standards Track [Page 2] + +RFC 2616 HTTP/1.1 June 1999 + + + 7 Entity ........................................................42 + 7.1 Entity Header Fields ........................................42 + 7.2 Entity Body .................................................43 + 7.2.1 Type .....................................................43 + 7.2.2 Entity Length ............................................43 + 8 Connections ...................................................44 + 8.1 Persistent Connections ......................................44 + 8.1.1 Purpose ..................................................44 + 8.1.2 Overall Operation ........................................45 + 8.1.3 Proxy Servers ............................................46 + 8.1.4 Practical Considerations .................................46 + 8.2 Message Transmission Requirements ...........................47 + 8.2.1 Persistent Connections and Flow Control ..................47 + 8.2.2 Monitoring Connections for Error Status Messages .........48 + 8.2.3 Use of the 100 (Continue) Status .........................48 + 8.2.4 Client Behavior if Server Prematurely Closes Connection ..50 + 9 Method Definitions ............................................51 + 9.1 Safe and Idempotent Methods .................................51 + 9.1.1 Safe Methods .............................................51 + 9.1.2 Idempotent Methods .......................................51 + 9.2 OPTIONS .....................................................52 + 9.3 GET .........................................................53 + 9.4 HEAD ........................................................54 + 9.5 POST ........................................................54 + 9.6 PUT .........................................................55 + 9.7 DELETE ......................................................56 + 9.8 TRACE .......................................................56 + 9.9 CONNECT .....................................................57 + 10 Status Code Definitions ......................................57 + 10.1 Informational 1xx ...........................................57 + 10.1.1 100 Continue .............................................58 + 10.1.2 101 Switching Protocols ..................................58 + 10.2 Successful 2xx ..............................................58 + 10.2.1 200 OK ...................................................58 + 10.2.2 201 Created ..............................................59 + 10.2.3 202 Accepted .............................................59 + 10.2.4 203 Non-Authoritative Information ........................59 + 10.2.5 204 No Content ...........................................60 + 10.2.6 205 Reset Content ........................................60 + 10.2.7 206 Partial Content ......................................60 + 10.3 Redirection 3xx .............................................61 + 10.3.1 300 Multiple Choices .....................................61 + 10.3.2 301 Moved Permanently ....................................62 + 10.3.3 302 Found ................................................62 + 10.3.4 303 See Other ............................................63 + 10.3.5 304 Not Modified .........................................63 + 10.3.6 305 Use Proxy ............................................64 + 10.3.7 306 (Unused) .............................................64 + + + +Fielding, et al. Standards Track [Page 3] + +RFC 2616 HTTP/1.1 June 1999 + + + 10.3.8 307 Temporary Redirect ...................................65 + 10.4 Client Error 4xx ............................................65 + 10.4.1 400 Bad Request .........................................65 + 10.4.2 401 Unauthorized ........................................66 + 10.4.3 402 Payment Required ....................................66 + 10.4.4 403 Forbidden ...........................................66 + 10.4.5 404 Not Found ...........................................66 + 10.4.6 405 Method Not Allowed ..................................66 + 10.4.7 406 Not Acceptable ......................................67 + 10.4.8 407 Proxy Authentication Required .......................67 + 10.4.9 408 Request Timeout .....................................67 + 10.4.10 409 Conflict ............................................67 + 10.4.11 410 Gone ................................................68 + 10.4.12 411 Length Required .....................................68 + 10.4.13 412 Precondition Failed .................................68 + 10.4.14 413 Request Entity Too Large ............................69 + 10.4.15 414 Request-URI Too Long ................................69 + 10.4.16 415 Unsupported Media Type ..............................69 + 10.4.17 416 Requested Range Not Satisfiable .....................69 + 10.4.18 417 Expectation Failed ..................................70 + 10.5 Server Error 5xx ............................................70 + 10.5.1 500 Internal Server Error ................................70 + 10.5.2 501 Not Implemented ......................................70 + 10.5.3 502 Bad Gateway ..........................................70 + 10.5.4 503 Service Unavailable ..................................70 + 10.5.5 504 Gateway Timeout ......................................71 + 10.5.6 505 HTTP Version Not Supported ...........................71 + 11 Access Authentication ........................................71 + 12 Content Negotiation ..........................................71 + 12.1 Server-driven Negotiation ...................................72 + 12.2 Agent-driven Negotiation ....................................73 + 12.3 Transparent Negotiation .....................................74 + 13 Caching in HTTP ..............................................74 + 13.1.1 Cache Correctness ........................................75 + 13.1.2 Warnings .................................................76 + 13.1.3 Cache-control Mechanisms .................................77 + 13.1.4 Explicit User Agent Warnings .............................78 + 13.1.5 Exceptions to the Rules and Warnings .....................78 + 13.1.6 Client-controlled Behavior ...............................79 + 13.2 Expiration Model ............................................79 + 13.2.1 Server-Specified Expiration ..............................79 + 13.2.2 Heuristic Expiration .....................................80 + 13.2.3 Age Calculations .........................................80 + 13.2.4 Expiration Calculations ..................................83 + 13.2.5 Disambiguating Expiration Values .........................84 + 13.2.6 Disambiguating Multiple Responses ........................84 + 13.3 Validation Model ............................................85 + 13.3.1 Last-Modified Dates ......................................86 + + + +Fielding, et al. Standards Track [Page 4] + +RFC 2616 HTTP/1.1 June 1999 + + + 13.3.2 Entity Tag Cache Validators ..............................86 + 13.3.3 Weak and Strong Validators ...............................86 + 13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates.89 + 13.3.5 Non-validating Conditionals ..............................90 + 13.4 Response Cacheability .......................................91 + 13.5 Constructing Responses From Caches ..........................92 + 13.5.1 End-to-end and Hop-by-hop Headers ........................92 + 13.5.2 Non-modifiable Headers ...................................92 + 13.5.3 Combining Headers ........................................94 + 13.5.4 Combining Byte Ranges ....................................95 + 13.6 Caching Negotiated Responses ................................95 + 13.7 Shared and Non-Shared Caches ................................96 + 13.8 Errors or Incomplete Response Cache Behavior ................97 + 13.9 Side Effects of GET and HEAD ................................97 + 13.10 Invalidation After Updates or Deletions ...................97 + 13.11 Write-Through Mandatory ...................................98 + 13.12 Cache Replacement .........................................99 + 13.13 History Lists .............................................99 + 14 Header Field Definitions ....................................100 + 14.1 Accept .....................................................100 + 14.2 Accept-Charset .............................................102 + 14.3 Accept-Encoding ............................................102 + 14.4 Accept-Language ............................................104 + 14.5 Accept-Ranges ..............................................105 + 14.6 Age ........................................................106 + 14.7 Allow ......................................................106 + 14.8 Authorization ..............................................107 + 14.9 Cache-Control ..............................................108 + 14.9.1 What is Cacheable .......................................109 + 14.9.2 What May be Stored by Caches ............................110 + 14.9.3 Modifications of the Basic Expiration Mechanism .........111 + 14.9.4 Cache Revalidation and Reload Controls ..................113 + 14.9.5 No-Transform Directive ..................................115 + 14.9.6 Cache Control Extensions ................................116 + 14.10 Connection ...............................................117 + 14.11 Content-Encoding .........................................118 + 14.12 Content-Language .........................................118 + 14.13 Content-Length ...........................................119 + 14.14 Content-Location .........................................120 + 14.15 Content-MD5 ..............................................121 + 14.16 Content-Range ............................................122 + 14.17 Content-Type .............................................124 + 14.18 Date .....................................................124 + 14.18.1 Clockless Origin Server Operation ......................125 + 14.19 ETag .....................................................126 + 14.20 Expect ...................................................126 + 14.21 Expires ..................................................127 + 14.22 From .....................................................128 + + + +Fielding, et al. Standards Track [Page 5] + +RFC 2616 HTTP/1.1 June 1999 + + + 14.23 Host .....................................................128 + 14.24 If-Match .................................................129 + 14.25 If-Modified-Since ........................................130 + 14.26 If-None-Match ............................................132 + 14.27 If-Range .................................................133 + 14.28 If-Unmodified-Since ......................................134 + 14.29 Last-Modified ............................................134 + 14.30 Location .................................................135 + 14.31 Max-Forwards .............................................136 + 14.32 Pragma ...................................................136 + 14.33 Proxy-Authenticate .......................................137 + 14.34 Proxy-Authorization ......................................137 + 14.35 Range ....................................................138 + 14.35.1 Byte Ranges ...........................................138 + 14.35.2 Range Retrieval Requests ..............................139 + 14.36 Referer ..................................................140 + 14.37 Retry-After ..............................................141 + 14.38 Server ...................................................141 + 14.39 TE .......................................................142 + 14.40 Trailer ..................................................143 + 14.41 Transfer-Encoding..........................................143 + 14.42 Upgrade ..................................................144 + 14.43 User-Agent ...............................................145 + 14.44 Vary .....................................................145 + 14.45 Via ......................................................146 + 14.46 Warning ..................................................148 + 14.47 WWW-Authenticate .........................................150 + 15 Security Considerations .......................................150 + 15.1 Personal Information....................................151 + 15.1.1 Abuse of Server Log Information .........................151 + 15.1.2 Transfer of Sensitive Information .......................151 + 15.1.3 Encoding Sensitive Information in URI's .................152 + 15.1.4 Privacy Issues Connected to Accept Headers ..............152 + 15.2 Attacks Based On File and Path Names .......................153 + 15.3 DNS Spoofing ...............................................154 + 15.4 Location Headers and Spoofing ..............................154 + 15.5 Content-Disposition Issues .................................154 + 15.6 Authentication Credentials and Idle Clients ................155 + 15.7 Proxies and Caching ........................................155 + 15.7.1 Denial of Service Attacks on Proxies....................156 + 16 Acknowledgments .............................................156 + 17 References ..................................................158 + 18 Authors' Addresses ..........................................162 + 19 Appendices ..................................................164 + 19.1 Internet Media Type message/http and application/http ......164 + 19.2 Internet Media Type multipart/byteranges ...................165 + 19.3 Tolerant Applications ......................................166 + 19.4 Differences Between HTTP Entities and RFC 2045 Entities ....167 + + + +Fielding, et al. Standards Track [Page 6] + +RFC 2616 HTTP/1.1 June 1999 + + + 19.4.1 MIME-Version ............................................167 + 19.4.2 Conversion to Canonical Form ............................167 + 19.4.3 Conversion of Date Formats ..............................168 + 19.4.4 Introduction of Content-Encoding ........................168 + 19.4.5 No Content-Transfer-Encoding ............................168 + 19.4.6 Introduction of Transfer-Encoding .......................169 + 19.4.7 MHTML and Line Length Limitations .......................169 + 19.5 Additional Features ........................................169 + 19.5.1 Content-Disposition .....................................170 + 19.6 Compatibility with Previous Versions .......................170 + 19.6.1 Changes from HTTP/1.0 ...................................171 + 19.6.2 Compatibility with HTTP/1.0 Persistent Connections ......172 + 19.6.3 Changes from RFC 2068 ...................................172 + 20 Index .......................................................175 + 21 Full Copyright Statement ....................................176 + +1 Introduction + +1.1 Purpose + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. HTTP has been in use by the World-Wide Web global + information initiative since 1990. The first version of HTTP, + referred to as HTTP/0.9, was a simple protocol for raw data transfer + across the Internet. HTTP/1.0, as defined by RFC 1945 [6], improved + the protocol by allowing messages to be in the format of MIME-like + messages, containing metainformation about the data transferred and + modifiers on the request/response semantics. However, HTTP/1.0 does + not sufficiently take into consideration the effects of hierarchical + proxies, caching, the need for persistent connections, or virtual + hosts. In addition, the proliferation of incompletely-implemented + applications calling themselves "HTTP/1.0" has necessitated a + protocol version change in order for two communicating applications + to determine each other's true capabilities. + + This specification defines the protocol referred to as "HTTP/1.1". + This protocol includes more stringent requirements than HTTP/1.0 in + order to ensure reliable implementation of its features. + + Practical information systems require more functionality than simple + retrieval, including search, front-end update, and annotation. HTTP + allows an open-ended set of methods and headers that indicate the + purpose of a request [47]. It builds on the discipline of reference + provided by the Uniform Resource Identifier (URI) [3], as a location + (URL) [4] or name (URN) [20], for indicating the resource to which a + + + + + +Fielding, et al. Standards Track [Page 7] + +RFC 2616 HTTP/1.1 June 1999 + + + method is to be applied. Messages are passed in a format similar to + that used by Internet mail [9] as defined by the Multipurpose + Internet Mail Extensions (MIME) [7]. + + HTTP is also used as a generic protocol for communication between + user agents and proxies/gateways to other Internet systems, including + those supported by the SMTP [16], NNTP [13], FTP [18], Gopher [2], + and WAIS [10] protocols. In this way, HTTP allows basic hypermedia + access to resources available from diverse applications. + +1.2 Requirements + + The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", + "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this + document are to be interpreted as described in RFC 2119 [34]. + + An implementation is not compliant if it fails to satisfy one or more + of the MUST or REQUIRED level requirements for the protocols it + implements. An implementation that satisfies all the MUST or REQUIRED + level and all the SHOULD level requirements for its protocols is said + to be "unconditionally compliant"; one that satisfies all the MUST + level requirements but not all the SHOULD level requirements for its + protocols is said to be "conditionally compliant." + +1.3 Terminology + + This specification uses a number of terms to refer to the roles + played by participants in, and objects of, the HTTP communication. + + connection + A transport layer virtual circuit established between two programs + for the purpose of communication. + + message + The basic unit of HTTP communication, consisting of a structured + sequence of octets matching the syntax defined in section 4 and + transmitted via the connection. + + request + An HTTP request message, as defined in section 5. + + response + An HTTP response message, as defined in section 6. + + + + + + + + +Fielding, et al. Standards Track [Page 8] + +RFC 2616 HTTP/1.1 June 1999 + + + resource + A network data object or service that can be identified by a URI, + as defined in section 3.2. Resources may be available in multiple + representations (e.g. multiple languages, data formats, size, and + resolutions) or vary in other ways. + + entity + The information transferred as the payload of a request or + response. An entity consists of metainformation in the form of + entity-header fields and content in the form of an entity-body, as + described in section 7. + + representation + An entity included with a response that is subject to content + negotiation, as described in section 12. There may exist multiple + representations associated with a particular response status. + + content negotiation + The mechanism for selecting the appropriate representation when + servicing a request, as described in section 12. The + representation of entities in any response can be negotiated + (including error responses). + + variant + A resource may have one, or more than one, representation(s) + associated with it at any given instant. Each of these + representations is termed a `varriant'. Use of the term `variant' + does not necessarily imply that the resource is subject to content + negotiation. + + client + A program that establishes connections for the purpose of sending + requests. + + user agent + The client which initiates a request. These are often browsers, + editors, spiders (web-traversing robots), or other end user tools. + + server + An application program that accepts connections in order to + service requests by sending back responses. Any given program may + be capable of being both a client and a server; our use of these + terms refers only to the role being performed by the program for a + particular connection, rather than to the program's capabilities + in general. Likewise, any server may act as an origin server, + proxy, gateway, or tunnel, switching behavior based on the nature + of each request. + + + + +Fielding, et al. Standards Track [Page 9] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server + The server on which a given resource resides or is to be created. + + proxy + An intermediary program which acts as both a server and a client + for the purpose of making requests on behalf of other clients. + Requests are serviced internally or by passing them on, with + possible translation, to other servers. A proxy MUST implement + both the client and server requirements of this specification. A + "transparent proxy" is a proxy that does not modify the request or + response beyond what is required for proxy authentication and + identification. A "non-transparent proxy" is a proxy that modifies + the request or response in order to provide some added service to + the user agent, such as group annotation services, media type + transformation, protocol reduction, or anonymity filtering. Except + where either transparent or non-transparent behavior is explicitly + stated, the HTTP proxy requirements apply to both types of + proxies. + + gateway + A server which acts as an intermediary for some other server. + Unlike a proxy, a gateway receives requests as if it were the + origin server for the requested resource; the requesting client + may not be aware that it is communicating with a gateway. + + tunnel + An intermediary program which is acting as a blind relay between + two connections. Once active, a tunnel is not considered a party + to the HTTP communication, though the tunnel may have been + initiated by an HTTP request. The tunnel ceases to exist when both + ends of the relayed connections are closed. + + cache + A program's local store of response messages and the subsystem + that controls its message storage, retrieval, and deletion. A + cache stores cacheable responses in order to reduce the response + time and network bandwidth consumption on future, equivalent + requests. Any client or server may include a cache, though a cache + cannot be used by a server that is acting as a tunnel. + + cacheable + A response is cacheable if a cache is allowed to store a copy of + the response message for use in answering subsequent requests. The + rules for determining the cacheability of HTTP responses are + defined in section 13. Even if a resource is cacheable, there may + be additional constraints on whether a cache can use the cached + copy for a particular request. + + + + +Fielding, et al. Standards Track [Page 10] + +RFC 2616 HTTP/1.1 June 1999 + + + first-hand + A response is first-hand if it comes directly and without + unnecessary delay from the origin server, perhaps via one or more + proxies. A response is also first-hand if its validity has just + been checked directly with the origin server. + + explicit expiration time + The time at which the origin server intends that an entity should + no longer be returned by a cache without further validation. + + heuristic expiration time + An expiration time assigned by a cache when no explicit expiration + time is available. + + age + The age of a response is the time since it was sent by, or + successfully validated with, the origin server. + + freshness lifetime + The length of time between the generation of a response and its + expiration time. + + fresh + A response is fresh if its age has not yet exceeded its freshness + lifetime. + + stale + A response is stale if its age has passed its freshness lifetime. + + semantically transparent + A cache behaves in a "semantically transparent" manner, with + respect to a particular response, when its use affects neither the + requesting client nor the origin server, except to improve + performance. When a cache is semantically transparent, the client + receives exactly the same response (except for hop-by-hop headers) + that it would have received had its request been handled directly + by the origin server. + + validator + A protocol element (e.g., an entity tag or a Last-Modified time) + that is used to find out whether a cache entry is an equivalent + copy of an entity. + + upstream/downstream + Upstream and downstream describe the flow of a message: all + messages flow from upstream to downstream. + + + + + +Fielding, et al. Standards Track [Page 11] + +RFC 2616 HTTP/1.1 June 1999 + + + inbound/outbound + Inbound and outbound refer to the request and response paths for + messages: "inbound" means "traveling toward the origin server", + and "outbound" means "traveling toward the user agent" + +1.4 Overall Operation + + The HTTP protocol is a request/response protocol. A client sends a + request to the server in the form of a request method, URI, and + protocol version, followed by a MIME-like message containing request + modifiers, client information, and possible body content over a + connection with a server. The server responds with a status line, + including the message's protocol version and a success or error code, + followed by a MIME-like message containing server information, entity + metainformation, and possible entity-body content. The relationship + between HTTP and MIME is described in appendix 19.4. + + Most HTTP communication is initiated by a user agent and consists of + a request to be applied to a resource on some origin server. In the + simplest case, this may be accomplished via a single connection (v) + between the user agent (UA) and the origin server (O). + + request chain ------------------------> + UA -------------------v------------------- O + <----------------------- response chain + + A more complicated situation occurs when one or more intermediaries + are present in the request/response chain. There are three common + forms of intermediary: proxy, gateway, and tunnel. A proxy is a + forwarding agent, receiving requests for a URI in its absolute form, + rewriting all or part of the message, and forwarding the reformatted + request toward the server identified by the URI. A gateway is a + receiving agent, acting as a layer above some other server(s) and, if + necessary, translating the requests to the underlying server's + protocol. A tunnel acts as a relay point between two connections + without changing the messages; tunnels are used when the + communication needs to pass through an intermediary (such as a + firewall) even when the intermediary cannot understand the contents + of the messages. + + request chain --------------------------------------> + UA -----v----- A -----v----- B -----v----- C -----v----- O + <------------------------------------- response chain + + The figure above shows three intermediaries (A, B, and C) between the + user agent and origin server. A request or response message that + travels the whole chain will pass through four separate connections. + This distinction is important because some HTTP communication options + + + +Fielding, et al. Standards Track [Page 12] + +RFC 2616 HTTP/1.1 June 1999 + + + may apply only to the connection with the nearest, non-tunnel + neighbor, only to the end-points of the chain, or to all connections + along the chain. Although the diagram is linear, each participant may + be engaged in multiple, simultaneous communications. For example, B + may be receiving requests from many clients other than A, and/or + forwarding requests to servers other than C, at the same time that it + is handling A's request. + + Any party to the communication which is not acting as a tunnel may + employ an internal cache for handling requests. The effect of a cache + is that the request/response chain is shortened if one of the + participants along the chain has a cached response applicable to that + request. The following illustrates the resulting chain if B has a + cached copy of an earlier response from O (via C) for a request which + has not been cached by UA or A. + + request chain ----------> + UA -----v----- A -----v----- B - - - - - - C - - - - - - O + <--------- response chain + + Not all responses are usefully cacheable, and some requests may + contain modifiers which place special requirements on cache behavior. + HTTP requirements for cache behavior and cacheable responses are + defined in section 13. + + In fact, there are a wide variety of architectures and configurations + of caches and proxies currently being experimented with or deployed + across the World Wide Web. These systems include national hierarchies + of proxy caches to save transoceanic bandwidth, systems that + broadcast or multicast cache entries, organizations that distribute + subsets of cached data via CD-ROM, and so on. HTTP systems are used + in corporate intranets over high-bandwidth links, and for access via + PDAs with low-power radio links and intermittent connectivity. The + goal of HTTP/1.1 is to support the wide diversity of configurations + already deployed while introducing protocol constructs that meet the + needs of those who build web applications that require high + reliability and, failing that, at least reliable indications of + failure. + + HTTP communication usually takes place over TCP/IP connections. The + default port is TCP 80 [19], but other ports can be used. This does + not preclude HTTP from being implemented on top of any other protocol + on the Internet, or on other networks. HTTP only presumes a reliable + transport; any protocol that provides such guarantees can be used; + the mapping of the HTTP/1.1 request and response structures onto the + transport data units of the protocol in question is outside the scope + of this specification. + + + + +Fielding, et al. Standards Track [Page 13] + +RFC 2616 HTTP/1.1 June 1999 + + + In HTTP/1.0, most implementations used a new connection for each + request/response exchange. In HTTP/1.1, a connection may be used for + one or more request/response exchanges, although connections may be + closed for a variety of reasons (see section 8.1). + +2 Notational Conventions and Generic Grammar + +2.1 Augmented BNF + + All of the mechanisms specified in this document are described in + both prose and an augmented Backus-Naur Form (BNF) similar to that + used by RFC 822 [9]. Implementors will need to be familiar with the + notation in order to understand this specification. The augmented BNF + includes the following constructs: + + name = definition + The name of a rule is simply the name itself (without any + enclosing "<" and ">") and is separated from its definition by the + equal "=" character. White space is only significant in that + indentation of continuation lines is used to indicate a rule + definition that spans more than one line. Certain basic rules are + in uppercase, such as SP, LWS, HT, CRLF, DIGIT, ALPHA, etc. Angle + brackets are used within definitions whenever their presence will + facilitate discerning the use of rule names. + + "literal" + Quotation marks surround literal text. Unless stated otherwise, + the text is case-insensitive. + + rule1 | rule2 + Elements separated by a bar ("|") are alternatives, e.g., "yes | + no" will accept yes or no. + + (rule1 rule2) + Elements enclosed in parentheses are treated as a single element. + Thus, "(elem (foo | bar) elem)" allows the token sequences "elem + foo elem" and "elem bar elem". + + *rule + The character "*" preceding an element indicates repetition. The + full form is "*element" indicating at least and at most + occurrences of element. Default values are 0 and infinity so + that "*(element)" allows any number, including zero; "1*element" + requires at least one; and "1*2element" allows one or two. + + [rule] + Square brackets enclose optional elements; "[foo bar]" is + equivalent to "*1(foo bar)". + + + +Fielding, et al. Standards Track [Page 14] + +RFC 2616 HTTP/1.1 June 1999 + + + N rule + Specific repetition: "(element)" is equivalent to + "*(element)"; that is, exactly occurrences of (element). + Thus 2DIGIT is a 2-digit number, and 3ALPHA is a string of three + alphabetic characters. + + #rule + A construct "#" is defined, similar to "*", for defining lists of + elements. The full form is "#element" indicating at least + and at most elements, each separated by one or more commas + (",") and OPTIONAL linear white space (LWS). This makes the usual + form of lists very easy; a rule such as + ( *LWS element *( *LWS "," *LWS element )) + can be shown as + 1#element + Wherever this construct is used, null elements are allowed, but do + not contribute to the count of elements present. That is, + "(element), , (element) " is permitted, but counts as only two + elements. Therefore, where at least one element is required, at + least one non-null element MUST be present. Default values are 0 + and infinity so that "#element" allows any number, including zero; + "1#element" requires at least one; and "1#2element" allows one or + two. + + ; comment + A semi-colon, set off some distance to the right of rule text, + starts a comment that continues to the end of line. This is a + simple way of including useful notes in parallel with the + specifications. + + implied *LWS + The grammar described by this specification is word-based. Except + where noted otherwise, linear white space (LWS) can be included + between any two adjacent words (token or quoted-string), and + between adjacent words and separators, without changing the + interpretation of a field. At least one delimiter (LWS and/or + + separators) MUST exist between any two tokens (for the definition + of "token" below), since they would otherwise be interpreted as a + single token. + +2.2 Basic Rules + + The following rules are used throughout this specification to + describe basic parsing constructs. The US-ASCII coded character set + is defined by ANSI X3.4-1986 [21]. + + + + + +Fielding, et al. Standards Track [Page 15] + +RFC 2616 HTTP/1.1 June 1999 + + + OCTET = + CHAR = + UPALPHA = + LOALPHA = + ALPHA = UPALPHA | LOALPHA + DIGIT = + CTL = + CR = + LF = + SP = + HT = + <"> = + + HTTP/1.1 defines the sequence CR LF as the end-of-line marker for all + protocol elements except the entity-body (see appendix 19.3 for + tolerant applications). The end-of-line marker within an entity-body + is defined by its associated media type, as described in section 3.7. + + CRLF = CR LF + + HTTP/1.1 header field values can be folded onto multiple lines if the + continuation line begins with a space or horizontal tab. All linear + white space, including folding, has the same semantics as SP. A + recipient MAY replace any linear white space with a single SP before + interpreting the field value or forwarding the message downstream. + + LWS = [CRLF] 1*( SP | HT ) + + The TEXT rule is only used for descriptive field contents and values + that are not intended to be interpreted by the message parser. Words + of *TEXT MAY contain characters from character sets other than ISO- + 8859-1 [22] only when encoded according to the rules of RFC 2047 + [14]. + + TEXT = + + A CRLF is allowed in the definition of TEXT only as part of a header + field continuation. It is expected that the folding LWS will be + replaced with a single SP before interpretation of the TEXT value. + + Hexadecimal numeric characters are used in several protocol elements. + + HEX = "A" | "B" | "C" | "D" | "E" | "F" + | "a" | "b" | "c" | "d" | "e" | "f" | DIGIT + + + + + +Fielding, et al. Standards Track [Page 16] + +RFC 2616 HTTP/1.1 June 1999 + + + Many HTTP/1.1 header field values consist of words separated by LWS + or special characters. These special characters MUST be in a quoted + string to be used within a parameter value (as defined in section + 3.6). + + token = 1* + separators = "(" | ")" | "<" | ">" | "@" + | "," | ";" | ":" | "\" | <"> + | "/" | "[" | "]" | "?" | "=" + | "{" | "}" | SP | HT + + Comments can be included in some HTTP header fields by surrounding + the comment text with parentheses. Comments are only allowed in + fields containing "comment" as part of their field value definition. + In all other fields, parentheses are considered part of the field + value. + + comment = "(" *( ctext | quoted-pair | comment ) ")" + ctext = + + A string of text is parsed as a single word if it is quoted using + double-quote marks. + + quoted-string = ( <"> *(qdtext | quoted-pair ) <"> ) + qdtext = > + + The backslash character ("\") MAY be used as a single-character + quoting mechanism only within quoted-string and comment constructs. + + quoted-pair = "\" CHAR + +3 Protocol Parameters + +3.1 HTTP Version + + HTTP uses a "." numbering scheme to indicate versions + of the protocol. The protocol versioning policy is intended to allow + the sender to indicate the format of a message and its capacity for + understanding further HTTP communication, rather than the features + obtained via that communication. No change is made to the version + number for the addition of message components which do not affect + communication behavior or which only add to extensible field values. + The number is incremented when the changes made to the + protocol add features which do not change the general message parsing + algorithm, but which may add to the message semantics and imply + additional capabilities of the sender. The number is + incremented when the format of a message within the protocol is + changed. See RFC 2145 [36] for a fuller explanation. + + + +Fielding, et al. Standards Track [Page 17] + +RFC 2616 HTTP/1.1 June 1999 + + + The version of an HTTP message is indicated by an HTTP-Version field + in the first line of the message. + + HTTP-Version = "HTTP" "/" 1*DIGIT "." 1*DIGIT + + Note that the major and minor numbers MUST be treated as separate + integers and that each MAY be incremented higher than a single digit. + Thus, HTTP/2.4 is a lower version than HTTP/2.13, which in turn is + lower than HTTP/12.3. Leading zeros MUST be ignored by recipients and + MUST NOT be sent. + + An application that sends a request or response message that includes + HTTP-Version of "HTTP/1.1" MUST be at least conditionally compliant + with this specification. Applications that are at least conditionally + compliant with this specification SHOULD use an HTTP-Version of + "HTTP/1.1" in their messages, and MUST do so for any message that is + not compatible with HTTP/1.0. For more details on when to send + specific HTTP-Version values, see RFC 2145 [36]. + + The HTTP version of an application is the highest HTTP version for + which the application is at least conditionally compliant. + + Proxy and gateway applications need to be careful when forwarding + messages in protocol versions different from that of the application. + Since the protocol version indicates the protocol capability of the + sender, a proxy/gateway MUST NOT send a message with a version + indicator which is greater than its actual version. If a higher + version request is received, the proxy/gateway MUST either downgrade + the request version, or respond with an error, or switch to tunnel + behavior. + + Due to interoperability problems with HTTP/1.0 proxies discovered + since the publication of RFC 2068[33], caching proxies MUST, gateways + MAY, and tunnels MUST NOT upgrade the request to the highest version + they support. The proxy/gateway's response to that request MUST be in + the same major version as the request. + + Note: Converting between versions of HTTP may involve modification + of header fields required or forbidden by the versions involved. + +3.2 Uniform Resource Identifiers + + URIs have been known by many names: WWW addresses, Universal Document + Identifiers, Universal Resource Identifiers [3], and finally the + combination of Uniform Resource Locators (URL) [4] and Names (URN) + [20]. As far as HTTP is concerned, Uniform Resource Identifiers are + simply formatted strings which identify--via name, location, or any + other characteristic--a resource. + + + +Fielding, et al. Standards Track [Page 18] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.1 General Syntax + + URIs in HTTP can be represented in absolute form or relative to some + known base URI [11], depending upon the context of their use. The two + forms are differentiated by the fact that absolute URIs always begin + with a scheme name followed by a colon. For definitive information on + URL syntax and semantics, see "Uniform Resource Identifiers (URI): + Generic Syntax and Semantics," RFC 2396 [42] (which replaces RFCs + 1738 [4] and RFC 1808 [11]). This specification adopts the + definitions of "URI-reference", "absoluteURI", "relativeURI", "port", + "host","abs_path", "rel_path", and "authority" from that + specification. + + The HTTP protocol does not place any a priori limit on the length of + a URI. Servers MUST be able to handle the URI of any resource they + serve, and SHOULD be able to handle URIs of unbounded length if they + provide GET-based forms that could generate such URIs. A server + SHOULD return 414 (Request-URI Too Long) status if a URI is longer + than the server can handle (see section 10.4.15). + + Note: Servers ought to be cautious about depending on URI lengths + above 255 bytes, because some older client or proxy + implementations might not properly support these lengths. + +3.2.2 http URL + + The "http" scheme is used to locate network resources via the HTTP + protocol. This section defines the scheme-specific syntax and + semantics for http URLs. + + http_URL = "http:" "//" host [ ":" port ] [ abs_path [ "?" query ]] + + If the port is empty or not given, port 80 is assumed. The semantics + are that the identified resource is located at the server listening + for TCP connections on that port of that host, and the Request-URI + for the resource is abs_path (section 5.1.2). The use of IP addresses + in URLs SHOULD be avoided whenever possible (see RFC 1900 [24]). If + the abs_path is not present in the URL, it MUST be given as "/" when + used as a Request-URI for a resource (section 5.1.2). If a proxy + receives a host name which is not a fully qualified domain name, it + MAY add its domain to the host name it received. If a proxy receives + a fully qualified domain name, the proxy MUST NOT change the host + name. + + + + + + + + +Fielding, et al. Standards Track [Page 19] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.3 URI Comparison + + When comparing two URIs to decide if they match or not, a client + SHOULD use a case-sensitive octet-by-octet comparison of the entire + URIs, with these exceptions: + + - A port that is empty or not given is equivalent to the default + port for that URI-reference; + + - Comparisons of host names MUST be case-insensitive; + + - Comparisons of scheme names MUST be case-insensitive; + + - An empty abs_path is equivalent to an abs_path of "/". + + Characters other than those in the "reserved" and "unsafe" sets (see + RFC 2396 [42]) are equivalent to their ""%" HEX HEX" encoding. + + For example, the following three URIs are equivalent: + + http://abc.com:80/~smith/home.html + http://ABC.com/%7Esmith/home.html + http://ABC.com:/%7esmith/home.html + +3.3 Date/Time Formats + +3.3.1 Full Date + + HTTP applications have historically allowed three different formats + for the representation of date/time stamps: + + Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123 + Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036 + Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format + + The first format is preferred as an Internet standard and represents + a fixed-length subset of that defined by RFC 1123 [8] (an update to + RFC 822 [9]). The second format is in common use, but is based on the + obsolete RFC 850 [12] date format and lacks a four-digit year. + HTTP/1.1 clients and servers that parse the date value MUST accept + all three formats (for compatibility with HTTP/1.0), though they MUST + only generate the RFC 1123 format for representing HTTP-date values + in header fields. See section 19.3 for further information. + + Note: Recipients of date values are encouraged to be robust in + accepting date values that may have been sent by non-HTTP + applications, as is sometimes the case when retrieving or posting + messages via proxies/gateways to SMTP or NNTP. + + + +Fielding, et al. Standards Track [Page 20] + +RFC 2616 HTTP/1.1 June 1999 + + + All HTTP date/time stamps MUST be represented in Greenwich Mean Time + (GMT), without exception. For the purposes of HTTP, GMT is exactly + equal to UTC (Coordinated Universal Time). This is indicated in the + first two formats by the inclusion of "GMT" as the three-letter + abbreviation for time zone, and MUST be assumed when reading the + asctime format. HTTP-date is case sensitive and MUST NOT include + additional LWS beyond that specifically included as SP in the + grammar. + + HTTP-date = rfc1123-date | rfc850-date | asctime-date + rfc1123-date = wkday "," SP date1 SP time SP "GMT" + rfc850-date = weekday "," SP date2 SP time SP "GMT" + asctime-date = wkday SP date3 SP time SP 4DIGIT + date1 = 2DIGIT SP month SP 4DIGIT + ; day month year (e.g., 02 Jun 1982) + date2 = 2DIGIT "-" month "-" 2DIGIT + ; day-month-year (e.g., 02-Jun-82) + date3 = month SP ( 2DIGIT | ( SP 1DIGIT )) + ; month day (e.g., Jun 2) + time = 2DIGIT ":" 2DIGIT ":" 2DIGIT + ; 00:00:00 - 23:59:59 + wkday = "Mon" | "Tue" | "Wed" + | "Thu" | "Fri" | "Sat" | "Sun" + weekday = "Monday" | "Tuesday" | "Wednesday" + | "Thursday" | "Friday" | "Saturday" | "Sunday" + month = "Jan" | "Feb" | "Mar" | "Apr" + | "May" | "Jun" | "Jul" | "Aug" + | "Sep" | "Oct" | "Nov" | "Dec" + + Note: HTTP requirements for the date/time stamp format apply only + to their usage within the protocol stream. Clients and servers are + not required to use these formats for user presentation, request + logging, etc. + +3.3.2 Delta Seconds + + Some HTTP header fields allow a time value to be specified as an + integer number of seconds, represented in decimal, after the time + that the message was received. + + delta-seconds = 1*DIGIT + +3.4 Character Sets + + HTTP uses the same definition of the term "character set" as that + described for MIME: + + + + + +Fielding, et al. Standards Track [Page 21] + +RFC 2616 HTTP/1.1 June 1999 + + + The term "character set" is used in this document to refer to a + method used with one or more tables to convert a sequence of octets + into a sequence of characters. Note that unconditional conversion in + the other direction is not required, in that not all characters may + be available in a given character set and a character set may provide + more than one sequence of octets to represent a particular character. + This definition is intended to allow various kinds of character + encoding, from simple single-table mappings such as US-ASCII to + complex table switching methods such as those that use ISO-2022's + techniques. However, the definition associated with a MIME character + set name MUST fully specify the mapping to be performed from octets + to characters. In particular, use of external profiling information + to determine the exact mapping is not permitted. + + Note: This use of the term "character set" is more commonly + referred to as a "character encoding." However, since HTTP and + MIME share the same registry, it is important that the terminology + also be shared. + + HTTP character sets are identified by case-insensitive tokens. The + complete set of tokens is defined by the IANA Character Set registry + [19]. + + charset = token + + Although HTTP allows an arbitrary token to be used as a charset + value, any token that has a predefined value within the IANA + Character Set registry [19] MUST represent the character set defined + by that registry. Applications SHOULD limit their use of character + sets to those defined by the IANA registry. + + Implementors should be aware of IETF character set requirements [38] + [41]. + +3.4.1 Missing Charset + + Some HTTP/1.0 software has interpreted a Content-Type header without + charset parameter incorrectly to mean "recipient should guess." + Senders wishing to defeat this behavior MAY include a charset + parameter even when the charset is ISO-8859-1 and SHOULD do so when + it is known that it will not confuse the recipient. + + Unfortunately, some older HTTP/1.0 clients did not deal properly with + an explicit charset parameter. HTTP/1.1 recipients MUST respect the + charset label provided by the sender; and those user agents that have + a provision to "guess" a charset MUST use the charset from the + + + + + +Fielding, et al. Standards Track [Page 22] + +RFC 2616 HTTP/1.1 June 1999 + + + content-type field if they support that charset, rather than the + recipient's preference, when initially displaying a document. See + section 3.7.1. + +3.5 Content Codings + + Content coding values indicate an encoding transformation that has + been or can be applied to an entity. Content codings are primarily + used to allow a document to be compressed or otherwise usefully + transformed without losing the identity of its underlying media type + and without loss of information. Frequently, the entity is stored in + coded form, transmitted directly, and only decoded by the recipient. + + content-coding = token + + All content-coding values are case-insensitive. HTTP/1.1 uses + content-coding values in the Accept-Encoding (section 14.3) and + Content-Encoding (section 14.11) header fields. Although the value + describes the content-coding, what is more important is that it + indicates what decoding mechanism will be required to remove the + encoding. + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + content-coding value tokens. Initially, the registry contains the + following tokens: + + gzip An encoding format produced by the file compression program + "gzip" (GNU zip) as described in RFC 1952 [25]. This format is a + Lempel-Ziv coding (LZ77) with a 32 bit CRC. + + compress + The encoding format produced by the common UNIX file compression + program "compress". This format is an adaptive Lempel-Ziv-Welch + coding (LZW). + + Use of program names for the identification of encoding formats + is not desirable and is discouraged for future encodings. Their + use here is representative of historical practice, not good + design. For compatibility with previous implementations of HTTP, + applications SHOULD consider "x-gzip" and "x-compress" to be + equivalent to "gzip" and "compress" respectively. + + deflate + The "zlib" format defined in RFC 1950 [31] in combination with + the "deflate" compression mechanism described in RFC 1951 [29]. + + + + + + +Fielding, et al. Standards Track [Page 23] + +RFC 2616 HTTP/1.1 June 1999 + + + identity + The default (identity) encoding; the use of no transformation + whatsoever. This content-coding is used only in the Accept- + Encoding header, and SHOULD NOT be used in the Content-Encoding + header. + + New content-coding value tokens SHOULD be registered; to allow + interoperability between clients and servers, specifications of the + content coding algorithms needed to implement a new value SHOULD be + publicly available and adequate for independent implementation, and + conform to the purpose of content coding defined in this section. + +3.6 Transfer Codings + + Transfer-coding values are used to indicate an encoding + transformation that has been, can be, or may need to be applied to an + entity-body in order to ensure "safe transport" through the network. + This differs from a content coding in that the transfer-coding is a + property of the message, not of the original entity. + + transfer-coding = "chunked" | transfer-extension + transfer-extension = token *( ";" parameter ) + + Parameters are in the form of attribute/value pairs. + + parameter = attribute "=" value + attribute = token + value = token | quoted-string + + All transfer-coding values are case-insensitive. HTTP/1.1 uses + transfer-coding values in the TE header field (section 14.39) and in + the Transfer-Encoding header field (section 14.41). + + Whenever a transfer-coding is applied to a message-body, the set of + transfer-codings MUST include "chunked", unless the message is + terminated by closing the connection. When the "chunked" transfer- + coding is used, it MUST be the last transfer-coding applied to the + message-body. The "chunked" transfer-coding MUST NOT be applied more + than once to a message-body. These rules allow the recipient to + determine the transfer-length of the message (section 4.4). + + Transfer-codings are analogous to the Content-Transfer-Encoding + values of MIME [7], which were designed to enable safe transport of + binary data over a 7-bit transport service. However, safe transport + has a different focus for an 8bit-clean transfer protocol. In HTTP, + the only unsafe characteristic of message-bodies is the difficulty in + determining the exact body length (section 7.2.2), or the desire to + encrypt data over a shared transport. + + + +Fielding, et al. Standards Track [Page 24] + +RFC 2616 HTTP/1.1 June 1999 + + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + transfer-coding value tokens. Initially, the registry contains the + following tokens: "chunked" (section 3.6.1), "identity" (section + 3.6.2), "gzip" (section 3.5), "compress" (section 3.5), and "deflate" + (section 3.5). + + New transfer-coding value tokens SHOULD be registered in the same way + as new content-coding value tokens (section 3.5). + + A server which receives an entity-body with a transfer-coding it does + not understand SHOULD return 501 (Unimplemented), and close the + connection. A server MUST NOT send transfer-codings to an HTTP/1.0 + client. + +3.6.1 Chunked Transfer Coding + + The chunked encoding modifies the body of a message in order to + transfer it as a series of chunks, each with its own size indicator, + followed by an OPTIONAL trailer containing entity-header fields. This + allows dynamically produced content to be transferred along with the + information necessary for the recipient to verify that it has + received the full message. + + Chunked-Body = *chunk + last-chunk + trailer + CRLF + + chunk = chunk-size [ chunk-extension ] CRLF + chunk-data CRLF + chunk-size = 1*HEX + last-chunk = 1*("0") [ chunk-extension ] CRLF + + chunk-extension= *( ";" chunk-ext-name [ "=" chunk-ext-val ] ) + chunk-ext-name = token + chunk-ext-val = token | quoted-string + chunk-data = chunk-size(OCTET) + trailer = *(entity-header CRLF) + + The chunk-size field is a string of hex digits indicating the size of + the chunk. The chunked encoding is ended by any chunk whose size is + zero, followed by the trailer, which is terminated by an empty line. + + The trailer allows the sender to include additional HTTP header + fields at the end of the message. The Trailer header field can be + used to indicate which header fields are included in a trailer (see + section 14.40). + + + + +Fielding, et al. Standards Track [Page 25] + +RFC 2616 HTTP/1.1 June 1999 + + + A server using chunked transfer-coding in a response MUST NOT use the + trailer for any header fields unless at least one of the following is + true: + + a)the request included a TE header field that indicates "trailers" is + acceptable in the transfer-coding of the response, as described in + section 14.39; or, + + b)the server is the origin server for the response, the trailer + fields consist entirely of optional metadata, and the recipient + could use the message (in a manner acceptable to the origin server) + without receiving this metadata. In other words, the origin server + is willing to accept the possibility that the trailer fields might + be silently discarded along the path to the client. + + This requirement prevents an interoperability failure when the + message is being received by an HTTP/1.1 (or later) proxy and + forwarded to an HTTP/1.0 recipient. It avoids a situation where + compliance with the protocol would have necessitated a possibly + infinite buffer on the proxy. + + An example process for decoding a Chunked-Body is presented in + appendix 19.4.6. + + All HTTP/1.1 applications MUST be able to receive and decode the + "chunked" transfer-coding, and MUST ignore chunk-extension extensions + they do not understand. + +3.7 Media Types + + HTTP uses Internet Media Types [17] in the Content-Type (section + 14.17) and Accept (section 14.1) header fields in order to provide + open and extensible data typing and type negotiation. + + media-type = type "/" subtype *( ";" parameter ) + type = token + subtype = token + + Parameters MAY follow the type/subtype in the form of attribute/value + pairs (as defined in section 3.6). + + The type, subtype, and parameter attribute names are case- + insensitive. Parameter values might or might not be case-sensitive, + depending on the semantics of the parameter name. Linear white space + (LWS) MUST NOT be used between the type and subtype, nor between an + attribute and its value. The presence or absence of a parameter might + be significant to the processing of a media-type, depending on its + definition within the media type registry. + + + +Fielding, et al. Standards Track [Page 26] + +RFC 2616 HTTP/1.1 June 1999 + + + Note that some older HTTP applications do not recognize media type + parameters. When sending data to older HTTP applications, + implementations SHOULD only use media type parameters when they are + required by that type/subtype definition. + + Media-type values are registered with the Internet Assigned Number + Authority (IANA [19]). The media type registration process is + outlined in RFC 1590 [17]. Use of non-registered media types is + discouraged. + +3.7.1 Canonicalization and Text Defaults + + Internet media types are registered with a canonical form. An + entity-body transferred via HTTP messages MUST be represented in the + appropriate canonical form prior to its transmission except for + "text" types, as defined in the next paragraph. + + When in canonical form, media subtypes of the "text" type use CRLF as + the text line break. HTTP relaxes this requirement and allows the + transport of text media with plain CR or LF alone representing a line + break when it is done consistently for an entire entity-body. HTTP + applications MUST accept CRLF, bare CR, and bare LF as being + representative of a line break in text media received via HTTP. In + addition, if the text is represented in a character set that does not + use octets 13 and 10 for CR and LF respectively, as is the case for + some multi-byte character sets, HTTP allows the use of whatever octet + sequences are defined by that character set to represent the + equivalent of CR and LF for line breaks. This flexibility regarding + line breaks applies only to text media in the entity-body; a bare CR + or LF MUST NOT be substituted for CRLF within any of the HTTP control + structures (such as header fields and multipart boundaries). + + If an entity-body is encoded with a content-coding, the underlying + data MUST be in a form defined above prior to being encoded. + + The "charset" parameter is used with some media types to define the + character set (section 3.4) of the data. When no explicit charset + parameter is provided by the sender, media subtypes of the "text" + type are defined to have a default charset value of "ISO-8859-1" when + received via HTTP. Data in character sets other than "ISO-8859-1" or + its subsets MUST be labeled with an appropriate charset value. See + section 3.4.1 for compatibility problems. + +3.7.2 Multipart Types + + MIME provides for a number of "multipart" types -- encapsulations of + one or more entities within a single message-body. All multipart + types share a common syntax, as defined in section 5.1.1 of RFC 2046 + + + +Fielding, et al. Standards Track [Page 27] + +RFC 2616 HTTP/1.1 June 1999 + + + [40], and MUST include a boundary parameter as part of the media type + value. The message body is itself a protocol element and MUST + therefore use only CRLF to represent line breaks between body-parts. + Unlike in RFC 2046, the epilogue of any multipart message MUST be + empty; HTTP applications MUST NOT transmit the epilogue (even if the + original multipart contains an epilogue). These restrictions exist in + order to preserve the self-delimiting nature of a multipart message- + body, wherein the "end" of the message-body is indicated by the + ending multipart boundary. + + In general, HTTP treats a multipart message-body no differently than + any other media type: strictly as payload. The one exception is the + "multipart/byteranges" type (appendix 19.2) when it appears in a 206 + (Partial Content) response, which will be interpreted by some HTTP + caching mechanisms as described in sections 13.5.4 and 14.16. In all + other cases, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + The MIME header fields within each body-part of a multipart message- + body do not have any significance to HTTP beyond that defined by + their MIME semantics. + + In general, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + If an application receives an unrecognized multipart subtype, the + application MUST treat it as being equivalent to "multipart/mixed". + + Note: The "multipart/form-data" type has been specifically defined + for carrying form data suitable for processing via the POST + request method, as described in RFC 1867 [15]. + +3.8 Product Tokens + + Product tokens are used to allow communicating applications to + identify themselves by software name and version. Most fields using + product tokens also allow sub-products which form a significant part + of the application to be listed, separated by white space. By + convention, the products are listed in order of their significance + for identifying the application. + + product = token ["/" product-version] + product-version = token + + Examples: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + Server: Apache/0.8.4 + + + + + +Fielding, et al. Standards Track [Page 28] + +RFC 2616 HTTP/1.1 June 1999 + + + Product tokens SHOULD be short and to the point. They MUST NOT be + used for advertising or other non-essential information. Although any + token character MAY appear in a product-version, this token SHOULD + only be used for a version identifier (i.e., successive versions of + the same product SHOULD only differ in the product-version portion of + the product value). + +3.9 Quality Values + + HTTP content negotiation (section 12) uses short "floating point" + numbers to indicate the relative importance ("weight") of various + negotiable parameters. A weight is normalized to a real number in + the range 0 through 1, where 0 is the minimum and 1 the maximum + value. If a parameter has a quality value of 0, then content with + this parameter is `not acceptable' for the client. HTTP/1.1 + applications MUST NOT generate more than three digits after the + decimal point. User configuration of these values SHOULD also be + limited in this fashion. + + qvalue = ( "0" [ "." 0*3DIGIT ] ) + | ( "1" [ "." 0*3("0") ] ) + + "Quality values" is a misnomer, since these values merely represent + relative degradation in desired quality. + +3.10 Language Tags + + A language tag identifies a natural language spoken, written, or + otherwise conveyed by human beings for communication of information + to other human beings. Computer languages are explicitly excluded. + HTTP uses language tags within the Accept-Language and Content- + Language fields. + + The syntax and registry of HTTP language tags is the same as that + defined by RFC 1766 [1]. In summary, a language tag is composed of 1 + or more parts: A primary language tag and a possibly empty series of + subtags: + + language-tag = primary-tag *( "-" subtag ) + primary-tag = 1*8ALPHA + subtag = 1*8ALPHA + + White space is not allowed within the tag and all tags are case- + insensitive. The name space of language tags is administered by the + IANA. Example tags include: + + en, en-US, en-cockney, i-cherokee, x-pig-latin + + + + +Fielding, et al. Standards Track [Page 29] + +RFC 2616 HTTP/1.1 June 1999 + + + where any two-letter primary-tag is an ISO-639 language abbreviation + and any two-letter initial subtag is an ISO-3166 country code. (The + last three tags above are not registered tags; all but the last are + examples of tags which could be registered in future.) + +3.11 Entity Tags + + Entity tags are used for comparing two or more entities from the same + requested resource. HTTP/1.1 uses entity tags in the ETag (section + 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and + If-Range (section 14.27) header fields. The definition of how they + are used and compared as cache validators is in section 13.3.3. An + entity tag consists of an opaque quoted string, possibly prefixed by + a weakness indicator. + + entity-tag = [ weak ] opaque-tag + weak = "W/" + opaque-tag = quoted-string + + A "strong entity tag" MAY be shared by two entities of a resource + only if they are equivalent by octet equality. + + A "weak entity tag," indicated by the "W/" prefix, MAY be shared by + two entities of a resource only if the entities are equivalent and + could be substituted for each other with no significant change in + semantics. A weak entity tag can only be used for weak comparison. + + An entity tag MUST be unique across all versions of all entities + associated with a particular resource. A given entity tag value MAY + be used for entities obtained by requests on different URIs. The use + of the same entity tag value in conjunction with entities obtained by + requests on different URIs does not imply the equivalence of those + entities. + +3.12 Range Units + + HTTP/1.1 allows a client to request that only part (a range of) the + response entity be included within the response. HTTP/1.1 uses range + units in the Range (section 14.35) and Content-Range (section 14.16) + header fields. An entity can be broken down into subranges according + to various structural units. + + range-unit = bytes-unit | other-range-unit + bytes-unit = "bytes" + other-range-unit = token + + The only range unit defined by HTTP/1.1 is "bytes". HTTP/1.1 + implementations MAY ignore ranges specified using other units. + + + +Fielding, et al. Standards Track [Page 30] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 has been designed to allow implementations of applications + that do not depend on knowledge of ranges. + +4 HTTP Message + +4.1 Message Types + + HTTP messages consist of requests from client to server and responses + from server to client. + + HTTP-message = Request | Response ; HTTP/1.1 messages + + Request (section 5) and Response (section 6) messages use the generic + message format of RFC 822 [9] for transferring entities (the payload + of the message). Both types of message consist of a start-line, zero + or more header fields (also known as "headers"), an empty line (i.e., + a line with nothing preceding the CRLF) indicating the end of the + header fields, and possibly a message-body. + + generic-message = start-line + *(message-header CRLF) + CRLF + [ message-body ] + start-line = Request-Line | Status-Line + + In the interest of robustness, servers SHOULD ignore any empty + line(s) received where a Request-Line is expected. In other words, if + the server is reading the protocol stream at the beginning of a + message and receives a CRLF first, it should ignore the CRLF. + + Certain buggy HTTP/1.0 client implementations generate extra CRLF's + after a POST request. To restate what is explicitly forbidden by the + BNF, an HTTP/1.1 client MUST NOT preface or follow a request with an + extra CRLF. + +4.2 Message Headers + + HTTP header fields, which include general-header (section 4.5), + request-header (section 5.3), response-header (section 6.2), and + entity-header (section 7.1) fields, follow the same generic format as + that given in Section 3.1 of RFC 822 [9]. Each header field consists + of a name followed by a colon (":") and the field value. Field names + are case-insensitive. The field value MAY be preceded by any amount + of LWS, though a single SP is preferred. Header fields can be + extended over multiple lines by preceding each extra line with at + least one SP or HT. Applications ought to follow "common form", where + one is known or indicated, when generating HTTP constructs, since + there might exist some implementations that fail to accept anything + + + +Fielding, et al. Standards Track [Page 31] + +RFC 2616 HTTP/1.1 June 1999 + + + beyond the common forms. + + message-header = field-name ":" [ field-value ] + field-name = token + field-value = *( field-content | LWS ) + field-content = + + The field-content does not include any leading or trailing LWS: + linear white space occurring before the first non-whitespace + character of the field-value or after the last non-whitespace + character of the field-value. Such leading or trailing LWS MAY be + removed without changing the semantics of the field value. Any LWS + that occurs between field-content MAY be replaced with a single SP + before interpreting the field value or forwarding the message + downstream. + + The order in which header fields with differing field names are + received is not significant. However, it is "good practice" to send + general-header fields first, followed by request-header or response- + header fields, and ending with the entity-header fields. + + Multiple message-header fields with the same field-name MAY be + present in a message if and only if the entire field-value for that + header field is defined as a comma-separated list [i.e., #(values)]. + It MUST be possible to combine the multiple header fields into one + "field-name: field-value" pair, without changing the semantics of the + message, by appending each subsequent field-value to the first, each + separated by a comma. The order in which header fields with the same + field-name are received is therefore significant to the + interpretation of the combined field value, and thus a proxy MUST NOT + change the order of these field values when a message is forwarded. + +4.3 Message Body + + The message-body (if any) of an HTTP message is used to carry the + entity-body associated with the request or response. The message-body + differs from the entity-body only when a transfer-coding has been + applied, as indicated by the Transfer-Encoding header field (section + 14.41). + + message-body = entity-body + | + + Transfer-Encoding MUST be used to indicate any transfer-codings + applied by an application to ensure safe and proper transfer of the + message. Transfer-Encoding is a property of the message, not of the + + + +Fielding, et al. Standards Track [Page 32] + +RFC 2616 HTTP/1.1 June 1999 + + + entity, and thus MAY be added or removed by any application along the + request/response chain. (However, section 3.6 places restrictions on + when certain transfer-codings may be used.) + + The rules for when a message-body is allowed in a message differ for + requests and responses. + + The presence of a message-body in a request is signaled by the + inclusion of a Content-Length or Transfer-Encoding header field in + the request's message-headers. A message-body MUST NOT be included in + a request if the specification of the request method (section 5.1.1) + does not allow sending an entity-body in requests. A server SHOULD + read and forward a message-body on any request; if the request method + does not include defined semantics for an entity-body, then the + message-body SHOULD be ignored when handling the request. + + For response messages, whether or not a message-body is included with + a message is dependent on both the request method and the response + status code (section 6.1.1). All responses to the HEAD request method + MUST NOT include a message-body, even though the presence of entity- + header fields might lead one to believe they do. All 1xx + (informational), 204 (no content), and 304 (not modified) responses + MUST NOT include a message-body. All other responses do include a + message-body, although it MAY be of zero length. + +4.4 Message Length + + The transfer-length of a message is the length of the message-body as + it appears in the message; that is, after any transfer-codings have + been applied. When a message-body is included with a message, the + transfer-length of that body is determined by one of the following + (in order of precedence): + + 1.Any response message which "MUST NOT" include a message-body (such + as the 1xx, 204, and 304 responses and any response to a HEAD + request) is always terminated by the first empty line after the + header fields, regardless of the entity-header fields present in + the message. + + 2.If a Transfer-Encoding header field (section 14.41) is present and + has any value other than "identity", then the transfer-length is + defined by use of the "chunked" transfer-coding (section 3.6), + unless the message is terminated by closing the connection. + + 3.If a Content-Length header field (section 14.13) is present, its + decimal value in OCTETs represents both the entity-length and the + transfer-length. The Content-Length header field MUST NOT be sent + if these two lengths are different (i.e., if a Transfer-Encoding + + + +Fielding, et al. Standards Track [Page 33] + +RFC 2616 HTTP/1.1 June 1999 + + + header field is present). If a message is received with both a + Transfer-Encoding header field and a Content-Length header field, + the latter MUST be ignored. + + 4.If the message uses the media type "multipart/byteranges", and the + ransfer-length is not otherwise specified, then this self- + elimiting media type defines the transfer-length. This media type + UST NOT be used unless the sender knows that the recipient can arse + it; the presence in a request of a Range header with ultiple byte- + range specifiers from a 1.1 client implies that the lient can parse + multipart/byteranges responses. + + A range header might be forwarded by a 1.0 proxy that does not + understand multipart/byteranges; in this case the server MUST + delimit the message using methods defined in items 1,3 or 5 of + this section. + + 5.By the server closing the connection. (Closing the connection + cannot be used to indicate the end of a request body, since that + would leave no possibility for the server to send back a response.) + + For compatibility with HTTP/1.0 applications, HTTP/1.1 requests + containing a message-body MUST include a valid Content-Length header + field unless the server is known to be HTTP/1.1 compliant. If a + request contains a message-body and a Content-Length is not given, + the server SHOULD respond with 400 (bad request) if it cannot + determine the length of the message, or with 411 (length required) if + it wishes to insist on receiving a valid Content-Length. + + All HTTP/1.1 applications that receive entities MUST accept the + "chunked" transfer-coding (section 3.6), thus allowing this mechanism + to be used for messages when the message length cannot be determined + in advance. + + Messages MUST NOT include both a Content-Length header field and a + non-identity transfer-coding. If the message does include a non- + identity transfer-coding, the Content-Length MUST be ignored. + + When a Content-Length is given in a message where a message-body is + allowed, its field value MUST exactly match the number of OCTETs in + the message-body. HTTP/1.1 user agents MUST notify the user when an + invalid length is received and detected. + +4.5 General Header Fields + + There are a few header fields which have general applicability for + both request and response messages, but which do not apply to the + entity being transferred. These header fields apply only to the + + + +Fielding, et al. Standards Track [Page 34] + +RFC 2616 HTTP/1.1 June 1999 + + + message being transmitted. + + general-header = Cache-Control ; Section 14.9 + | Connection ; Section 14.10 + | Date ; Section 14.18 + | Pragma ; Section 14.32 + | Trailer ; Section 14.40 + | Transfer-Encoding ; Section 14.41 + | Upgrade ; Section 14.42 + | Via ; Section 14.45 + | Warning ; Section 14.46 + + General-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields may be given the semantics of general + header fields if all parties in the communication recognize them to + be general-header fields. Unrecognized header fields are treated as + entity-header fields. + +5 Request + + A request message from a client to a server includes, within the + first line of that message, the method to be applied to the resource, + the identifier of the resource, and the protocol version in use. + + Request = Request-Line ; Section 5.1 + *(( general-header ; Section 4.5 + | request-header ; Section 5.3 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 4.3 + +5.1 Request-Line + + The Request-Line begins with a method token, followed by the + Request-URI and the protocol version, and ending with CRLF. The + elements are separated by SP characters. No CR or LF is allowed + except in the final CRLF sequence. + + Request-Line = Method SP Request-URI SP HTTP-Version CRLF + + + + + + + + + + + +Fielding, et al. Standards Track [Page 35] + +RFC 2616 HTTP/1.1 June 1999 + + +5.1.1 Method + + The Method token indicates the method to be performed on the + resource identified by the Request-URI. The method is case-sensitive. + + Method = "OPTIONS" ; Section 9.2 + | "GET" ; Section 9.3 + | "HEAD" ; Section 9.4 + | "POST" ; Section 9.5 + | "PUT" ; Section 9.6 + | "DELETE" ; Section 9.7 + | "TRACE" ; Section 9.8 + | "CONNECT" ; Section 9.9 + | extension-method + extension-method = token + + The list of methods allowed by a resource can be specified in an + Allow header field (section 14.7). The return code of the response + always notifies the client whether a method is currently allowed on a + resource, since the set of allowed methods can change dynamically. An + origin server SHOULD return the status code 405 (Method Not Allowed) + if the method is known by the origin server but not allowed for the + requested resource, and 501 (Not Implemented) if the method is + unrecognized or not implemented by the origin server. The methods GET + and HEAD MUST be supported by all general-purpose servers. All other + methods are OPTIONAL; however, if the above methods are implemented, + they MUST be implemented with the same semantics as those specified + in section 9. + +5.1.2 Request-URI + + The Request-URI is a Uniform Resource Identifier (section 3.2) and + identifies the resource upon which to apply the request. + + Request-URI = "*" | absoluteURI | abs_path | authority + + The four options for Request-URI are dependent on the nature of the + request. The asterisk "*" means that the request does not apply to a + particular resource, but to the server itself, and is only allowed + when the method used does not necessarily apply to a resource. One + example would be + + OPTIONS * HTTP/1.1 + + The absoluteURI form is REQUIRED when the request is being made to a + proxy. The proxy is requested to forward the request or service it + from a valid cache, and return the response. Note that the proxy MAY + forward the request on to another proxy or directly to the server + + + +Fielding, et al. Standards Track [Page 36] + +RFC 2616 HTTP/1.1 June 1999 + + + specified by the absoluteURI. In order to avoid request loops, a + proxy MUST be able to recognize all of its server names, including + any aliases, local variations, and the numeric IP address. An example + Request-Line would be: + + GET http://www.w3.org/pub/WWW/TheProject.html HTTP/1.1 + + To allow for transition to absoluteURIs in all requests in future + versions of HTTP, all HTTP/1.1 servers MUST accept the absoluteURI + form in requests, even though HTTP/1.1 clients will only generate + them in requests to proxies. + + The authority form is only used by the CONNECT method (section 9.9). + + The most common form of Request-URI is that used to identify a + resource on an origin server or gateway. In this case the absolute + path of the URI MUST be transmitted (see section 3.2.1, abs_path) as + the Request-URI, and the network location of the URI (authority) MUST + be transmitted in a Host header field. For example, a client wishing + to retrieve the resource above directly from the origin server would + create a TCP connection to port 80 of the host "www.w3.org" and send + the lines: + + GET /pub/WWW/TheProject.html HTTP/1.1 + Host: www.w3.org + + followed by the remainder of the Request. Note that the absolute path + cannot be empty; if none is present in the original URI, it MUST be + given as "/" (the server root). + + The Request-URI is transmitted in the format specified in section + 3.2.1. If the Request-URI is encoded using the "% HEX HEX" encoding + [42], the origin server MUST decode the Request-URI in order to + properly interpret the request. Servers SHOULD respond to invalid + Request-URIs with an appropriate status code. + + A transparent proxy MUST NOT rewrite the "abs_path" part of the + received Request-URI when forwarding it to the next inbound server, + except as noted above to replace a null abs_path with "/". + + Note: The "no rewrite" rule prevents the proxy from changing the + meaning of the request when the origin server is improperly using + a non-reserved URI character for a reserved purpose. Implementors + should be aware that some pre-HTTP/1.1 proxies have been known to + rewrite the Request-URI. + + + + + + +Fielding, et al. Standards Track [Page 37] + +RFC 2616 HTTP/1.1 June 1999 + + +5.2 The Resource Identified by a Request + + The exact resource identified by an Internet request is determined by + examining both the Request-URI and the Host header field. + + An origin server that does not allow resources to differ by the + requested host MAY ignore the Host header field value when + determining the resource identified by an HTTP/1.1 request. (But see + section 19.6.1.1 for other requirements on Host support in HTTP/1.1.) + + An origin server that does differentiate resources based on the host + requested (sometimes referred to as virtual hosts or vanity host + names) MUST use the following rules for determining the requested + resource on an HTTP/1.1 request: + + 1. If Request-URI is an absoluteURI, the host is part of the + Request-URI. Any Host header field value in the request MUST be + ignored. + + 2. If the Request-URI is not an absoluteURI, and the request includes + a Host header field, the host is determined by the Host header + field value. + + 3. If the host as determined by rule 1 or 2 is not a valid host on + the server, the response MUST be a 400 (Bad Request) error message. + + Recipients of an HTTP/1.0 request that lacks a Host header field MAY + attempt to use heuristics (e.g., examination of the URI path for + something unique to a particular host) in order to determine what + exact resource is being requested. + +5.3 Request Header Fields + + The request-header fields allow the client to pass additional + information about the request, and about the client itself, to the + server. These fields act as request modifiers, with semantics + equivalent to the parameters on a programming language method + invocation. + + request-header = Accept ; Section 14.1 + | Accept-Charset ; Section 14.2 + | Accept-Encoding ; Section 14.3 + | Accept-Language ; Section 14.4 + | Authorization ; Section 14.8 + | Expect ; Section 14.20 + | From ; Section 14.22 + | Host ; Section 14.23 + | If-Match ; Section 14.24 + + + +Fielding, et al. Standards Track [Page 38] + +RFC 2616 HTTP/1.1 June 1999 + + + | If-Modified-Since ; Section 14.25 + | If-None-Match ; Section 14.26 + | If-Range ; Section 14.27 + | If-Unmodified-Since ; Section 14.28 + | Max-Forwards ; Section 14.31 + | Proxy-Authorization ; Section 14.34 + | Range ; Section 14.35 + | Referer ; Section 14.36 + | TE ; Section 14.39 + | User-Agent ; Section 14.43 + + Request-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of request- + header fields if all parties in the communication recognize them to + be request-header fields. Unrecognized header fields are treated as + entity-header fields. + +6 Response + + After receiving and interpreting a request message, a server responds + with an HTTP response message. + + Response = Status-Line ; Section 6.1 + *(( general-header ; Section 4.5 + | response-header ; Section 6.2 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 7.2 + +6.1 Status-Line + + The first line of a Response message is the Status-Line, consisting + of the protocol version followed by a numeric status code and its + associated textual phrase, with each element separated by SP + characters. No CR or LF is allowed except in the final CRLF sequence. + + Status-Line = HTTP-Version SP Status-Code SP Reason-Phrase CRLF + +6.1.1 Status Code and Reason Phrase + + The Status-Code element is a 3-digit integer result code of the + attempt to understand and satisfy the request. These codes are fully + defined in section 10. The Reason-Phrase is intended to give a short + textual description of the Status-Code. The Status-Code is intended + for use by automata and the Reason-Phrase is intended for the human + user. The client is not required to examine or display the Reason- + Phrase. + + + +Fielding, et al. Standards Track [Page 39] + +RFC 2616 HTTP/1.1 June 1999 + + + The first digit of the Status-Code defines the class of response. The + last two digits do not have any categorization role. There are 5 + values for the first digit: + + - 1xx: Informational - Request received, continuing process + + - 2xx: Success - The action was successfully received, + understood, and accepted + + - 3xx: Redirection - Further action must be taken in order to + complete the request + + - 4xx: Client Error - The request contains bad syntax or cannot + be fulfilled + + - 5xx: Server Error - The server failed to fulfill an apparently + valid request + + The individual values of the numeric status codes defined for + HTTP/1.1, and an example set of corresponding Reason-Phrase's, are + presented below. The reason phrases listed here are only + recommendations -- they MAY be replaced by local equivalents without + affecting the protocol. + + Status-Code = + "100" ; Section 10.1.1: Continue + | "101" ; Section 10.1.2: Switching Protocols + | "200" ; Section 10.2.1: OK + | "201" ; Section 10.2.2: Created + | "202" ; Section 10.2.3: Accepted + | "203" ; Section 10.2.4: Non-Authoritative Information + | "204" ; Section 10.2.5: No Content + | "205" ; Section 10.2.6: Reset Content + | "206" ; Section 10.2.7: Partial Content + | "300" ; Section 10.3.1: Multiple Choices + | "301" ; Section 10.3.2: Moved Permanently + | "302" ; Section 10.3.3: Found + | "303" ; Section 10.3.4: See Other + | "304" ; Section 10.3.5: Not Modified + | "305" ; Section 10.3.6: Use Proxy + | "307" ; Section 10.3.8: Temporary Redirect + | "400" ; Section 10.4.1: Bad Request + | "401" ; Section 10.4.2: Unauthorized + | "402" ; Section 10.4.3: Payment Required + | "403" ; Section 10.4.4: Forbidden + | "404" ; Section 10.4.5: Not Found + | "405" ; Section 10.4.6: Method Not Allowed + | "406" ; Section 10.4.7: Not Acceptable + + + +Fielding, et al. Standards Track [Page 40] + +RFC 2616 HTTP/1.1 June 1999 + + + | "407" ; Section 10.4.8: Proxy Authentication Required + | "408" ; Section 10.4.9: Request Time-out + | "409" ; Section 10.4.10: Conflict + | "410" ; Section 10.4.11: Gone + | "411" ; Section 10.4.12: Length Required + | "412" ; Section 10.4.13: Precondition Failed + | "413" ; Section 10.4.14: Request Entity Too Large + | "414" ; Section 10.4.15: Request-URI Too Large + | "415" ; Section 10.4.16: Unsupported Media Type + | "416" ; Section 10.4.17: Requested range not satisfiable + | "417" ; Section 10.4.18: Expectation Failed + | "500" ; Section 10.5.1: Internal Server Error + | "501" ; Section 10.5.2: Not Implemented + | "502" ; Section 10.5.3: Bad Gateway + | "503" ; Section 10.5.4: Service Unavailable + | "504" ; Section 10.5.5: Gateway Time-out + | "505" ; Section 10.5.6: HTTP Version not supported + | extension-code + + extension-code = 3DIGIT + Reason-Phrase = * + + HTTP status codes are extensible. HTTP applications are not required + to understand the meaning of all registered status codes, though such + understanding is obviously desirable. However, applications MUST + understand the class of any status code, as indicated by the first + digit, and treat any unrecognized response as being equivalent to the + x00 status code of that class, with the exception that an + unrecognized response MUST NOT be cached. For example, if an + unrecognized status code of 431 is received by the client, it can + safely assume that there was something wrong with its request and + treat the response as if it had received a 400 status code. In such + cases, user agents SHOULD present to the user the entity returned + with the response, since that entity is likely to include human- + readable information which will explain the unusual status. + +6.2 Response Header Fields + + The response-header fields allow the server to pass additional + information about the response which cannot be placed in the Status- + Line. These header fields give information about the server and about + further access to the resource identified by the Request-URI. + + response-header = Accept-Ranges ; Section 14.5 + | Age ; Section 14.6 + | ETag ; Section 14.19 + | Location ; Section 14.30 + | Proxy-Authenticate ; Section 14.33 + + + +Fielding, et al. Standards Track [Page 41] + +RFC 2616 HTTP/1.1 June 1999 + + + | Retry-After ; Section 14.37 + | Server ; Section 14.38 + | Vary ; Section 14.44 + | WWW-Authenticate ; Section 14.47 + + Response-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of response- + header fields if all parties in the communication recognize them to + be response-header fields. Unrecognized header fields are treated as + entity-header fields. + +7 Entity + + Request and Response messages MAY transfer an entity if not otherwise + restricted by the request method or response status code. An entity + consists of entity-header fields and an entity-body, although some + responses will only include the entity-headers. + + In this section, both sender and recipient refer to either the client + or the server, depending on who sends and who receives the entity. + +7.1 Entity Header Fields + + Entity-header fields define metainformation about the entity-body or, + if no body is present, about the resource identified by the request. + Some of this metainformation is OPTIONAL; some might be REQUIRED by + portions of this specification. + + entity-header = Allow ; Section 14.7 + | Content-Encoding ; Section 14.11 + | Content-Language ; Section 14.12 + | Content-Length ; Section 14.13 + | Content-Location ; Section 14.14 + | Content-MD5 ; Section 14.15 + | Content-Range ; Section 14.16 + | Content-Type ; Section 14.17 + | Expires ; Section 14.21 + | Last-Modified ; Section 14.29 + | extension-header + + extension-header = message-header + + The extension-header mechanism allows additional entity-header fields + to be defined without changing the protocol, but these fields cannot + be assumed to be recognizable by the recipient. Unrecognized header + fields SHOULD be ignored by the recipient and MUST be forwarded by + transparent proxies. + + + +Fielding, et al. Standards Track [Page 42] + +RFC 2616 HTTP/1.1 June 1999 + + +7.2 Entity Body + + The entity-body (if any) sent with an HTTP request or response is in + a format and encoding defined by the entity-header fields. + + entity-body = *OCTET + + An entity-body is only present in a message when a message-body is + present, as described in section 4.3. The entity-body is obtained + from the message-body by decoding any Transfer-Encoding that might + have been applied to ensure safe and proper transfer of the message. + +7.2.1 Type + + When an entity-body is included with a message, the data type of that + body is determined via the header fields Content-Type and Content- + Encoding. These define a two-layer, ordered encoding model: + + entity-body := Content-Encoding( Content-Type( data ) ) + + Content-Type specifies the media type of the underlying data. + Content-Encoding may be used to indicate any additional content + codings applied to the data, usually for the purpose of data + compression, that are a property of the requested resource. There is + no default encoding. + + Any HTTP/1.1 message containing an entity-body SHOULD include a + Content-Type header field defining the media type of that body. If + and only if the media type is not given by a Content-Type field, the + recipient MAY attempt to guess the media type via inspection of its + content and/or the name extension(s) of the URI used to identify the + resource. If the media type remains unknown, the recipient SHOULD + treat it as type "application/octet-stream". + +7.2.2 Entity Length + + The entity-length of a message is the length of the message-body + before any transfer-codings have been applied. Section 4.4 defines + how the transfer-length of a message-body is determined. + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 43] + +RFC 2616 HTTP/1.1 June 1999 + + +8 Connections + +8.1 Persistent Connections + +8.1.1 Purpose + + Prior to persistent connections, a separate TCP connection was + established to fetch each URL, increasing the load on HTTP servers + and causing congestion on the Internet. The use of inline images and + other associated data often require a client to make multiple + requests of the same server in a short amount of time. Analysis of + these performance problems and results from a prototype + implementation are available [26] [30]. Implementation experience and + measurements of actual HTTP/1.1 (RFC 2068) implementations show good + results [39]. Alternatives have also been explored, for example, + T/TCP [27]. + + Persistent HTTP connections have a number of advantages: + + - By opening and closing fewer TCP connections, CPU time is saved + in routers and hosts (clients, servers, proxies, gateways, + tunnels, or caches), and memory used for TCP protocol control + blocks can be saved in hosts. + + - HTTP requests and responses can be pipelined on a connection. + Pipelining allows a client to make multiple requests without + waiting for each response, allowing a single TCP connection to + be used much more efficiently, with much lower elapsed time. + + - Network congestion is reduced by reducing the number of packets + caused by TCP opens, and by allowing TCP sufficient time to + determine the congestion state of the network. + + - Latency on subsequent requests is reduced since there is no time + spent in TCP's connection opening handshake. + + - HTTP can evolve more gracefully, since errors can be reported + without the penalty of closing the TCP connection. Clients using + future versions of HTTP might optimistically try a new feature, + but if communicating with an older server, retry with old + semantics after an error is reported. + + HTTP implementations SHOULD implement persistent connections. + + + + + + + + +Fielding, et al. Standards Track [Page 44] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2 Overall Operation + + A significant difference between HTTP/1.1 and earlier versions of + HTTP is that persistent connections are the default behavior of any + HTTP connection. That is, unless otherwise indicated, the client + SHOULD assume that the server will maintain a persistent connection, + even after error responses from the server. + + Persistent connections provide a mechanism by which a client and a + server can signal the close of a TCP connection. This signaling takes + place using the Connection header field (section 14.10). Once a close + has been signaled, the client MUST NOT send any more requests on that + connection. + +8.1.2.1 Negotiation + + An HTTP/1.1 server MAY assume that a HTTP/1.1 client intends to + maintain a persistent connection unless a Connection header including + the connection-token "close" was sent in the request. If the server + chooses to close the connection immediately after sending the + response, it SHOULD send a Connection header including the + connection-token close. + + An HTTP/1.1 client MAY expect a connection to remain open, but would + decide to keep it open based on whether the response from a server + contains a Connection header with the connection-token close. In case + the client does not want to maintain a connection for more than that + request, it SHOULD send a Connection header including the + connection-token close. + + If either the client or the server sends the close token in the + Connection header, that request becomes the last one for the + connection. + + Clients and servers SHOULD NOT assume that a persistent connection is + maintained for HTTP versions less than 1.1 unless it is explicitly + signaled. See section 19.6.2 for more information on backward + compatibility with HTTP/1.0 clients. + + In order to remain persistent, all messages on the connection MUST + have a self-defined message length (i.e., one not defined by closure + of the connection), as described in section 4.4. + + + + + + + + + +Fielding, et al. Standards Track [Page 45] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2.2 Pipelining + + A client that supports persistent connections MAY "pipeline" its + requests (i.e., send multiple requests without waiting for each + response). A server MUST send its responses to those requests in the + same order that the requests were received. + + Clients which assume persistent connections and pipeline immediately + after connection establishment SHOULD be prepared to retry their + connection if the first pipelined attempt fails. If a client does + such a retry, it MUST NOT pipeline before it knows the connection is + persistent. Clients MUST also be prepared to resend their requests if + the server closes the connection before sending all of the + corresponding responses. + + Clients SHOULD NOT pipeline requests using non-idempotent methods or + non-idempotent sequences of methods (see section 9.1.2). Otherwise, a + premature termination of the transport connection could lead to + indeterminate results. A client wishing to send a non-idempotent + request SHOULD wait to send that request until it has received the + response status for the previous request. + +8.1.3 Proxy Servers + + It is especially important that proxies correctly implement the + properties of the Connection header field as specified in section + 14.10. + + The proxy server MUST signal persistent connections separately with + its clients and the origin servers (or other proxy servers) that it + connects to. Each persistent connection applies to only one transport + link. + + A proxy server MUST NOT establish a HTTP/1.1 persistent connection + with an HTTP/1.0 client (but see RFC 2068 [33] for information and + discussion of the problems with the Keep-Alive header implemented by + many HTTP/1.0 clients). + +8.1.4 Practical Considerations + + Servers will usually have some time-out value beyond which they will + no longer maintain an inactive connection. Proxy servers might make + this a higher value since it is likely that the client will be making + more connections through the same server. The use of persistent + connections places no requirements on the length (or existence) of + this time-out for either the client or the server. + + + + + +Fielding, et al. Standards Track [Page 46] + +RFC 2616 HTTP/1.1 June 1999 + + + When a client or server wishes to time-out it SHOULD issue a graceful + close on the transport connection. Clients and servers SHOULD both + constantly watch for the other side of the transport close, and + respond to it as appropriate. If a client or server does not detect + the other side's close promptly it could cause unnecessary resource + drain on the network. + + A client, server, or proxy MAY close the transport connection at any + time. For example, a client might have started to send a new request + at the same time that the server has decided to close the "idle" + connection. From the server's point of view, the connection is being + closed while it was idle, but from the client's point of view, a + request is in progress. + + This means that clients, servers, and proxies MUST be able to recover + from asynchronous close events. Client software SHOULD reopen the + transport connection and retransmit the aborted sequence of requests + without user interaction so long as the request sequence is + idempotent (see section 9.1.2). Non-idempotent methods or sequences + MUST NOT be automatically retried, although user agents MAY offer a + human operator the choice of retrying the request(s). Confirmation by + user-agent software with semantic understanding of the application + MAY substitute for user confirmation. The automatic retry SHOULD NOT + be repeated if the second sequence of requests fails. + + Servers SHOULD always respond to at least one request per connection, + if at all possible. Servers SHOULD NOT close a connection in the + middle of transmitting a response, unless a network or client failure + is suspected. + + Clients that use persistent connections SHOULD limit the number of + simultaneous connections that they maintain to a given server. A + single-user client SHOULD NOT maintain more than 2 connections with + any server or proxy. A proxy SHOULD use up to 2*N connections to + another server or proxy, where N is the number of simultaneously + active users. These guidelines are intended to improve HTTP response + times and avoid congestion. + +8.2 Message Transmission Requirements + +8.2.1 Persistent Connections and Flow Control + + HTTP/1.1 servers SHOULD maintain persistent connections and use TCP's + flow control mechanisms to resolve temporary overloads, rather than + terminating connections with the expectation that clients will retry. + The latter technique can exacerbate network congestion. + + + + + +Fielding, et al. Standards Track [Page 47] + +RFC 2616 HTTP/1.1 June 1999 + + +8.2.2 Monitoring Connections for Error Status Messages + + An HTTP/1.1 (or later) client sending a message-body SHOULD monitor + the network connection for an error status while it is transmitting + the request. If the client sees an error status, it SHOULD + immediately cease transmitting the body. If the body is being sent + using a "chunked" encoding (section 3.6), a zero length chunk and + empty trailer MAY be used to prematurely mark the end of the message. + If the body was preceded by a Content-Length header, the client MUST + close the connection. + +8.2.3 Use of the 100 (Continue) Status + + The purpose of the 100 (Continue) status (see section 10.1.1) is to + allow a client that is sending a request message with a request body + to determine if the origin server is willing to accept the request + (based on the request headers) before the client sends the request + body. In some cases, it might either be inappropriate or highly + inefficient for the client to send the body if the server will reject + the message without looking at the body. + + Requirements for HTTP/1.1 clients: + + - If a client will wait for a 100 (Continue) response before + sending the request body, it MUST send an Expect request-header + field (section 14.20) with the "100-continue" expectation. + + - A client MUST NOT send an Expect request-header field (section + 14.20) with the "100-continue" expectation if it does not intend + to send a request body. + + Because of the presence of older implementations, the protocol allows + ambiguous situations in which a client may send "Expect: 100- + continue" without receiving either a 417 (Expectation Failed) status + or a 100 (Continue) status. Therefore, when a client sends this + header field to an origin server (possibly via a proxy) from which it + has never seen a 100 (Continue) status, the client SHOULD NOT wait + for an indefinite period before sending the request body. + + Requirements for HTTP/1.1 origin servers: + + - Upon receiving a request which includes an Expect request-header + field with the "100-continue" expectation, an origin server MUST + either respond with 100 (Continue) status and continue to read + from the input stream, or respond with a final status code. The + origin server MUST NOT wait for the request body before sending + the 100 (Continue) response. If it responds with a final status + code, it MAY close the transport connection or it MAY continue + + + +Fielding, et al. Standards Track [Page 48] + +RFC 2616 HTTP/1.1 June 1999 + + + to read and discard the rest of the request. It MUST NOT + perform the requested method if it returns a final status code. + + - An origin server SHOULD NOT send a 100 (Continue) response if + the request message does not include an Expect request-header + field with the "100-continue" expectation, and MUST NOT send a + 100 (Continue) response if such a request comes from an HTTP/1.0 + (or earlier) client. There is an exception to this rule: for + compatibility with RFC 2068, a server MAY send a 100 (Continue) + status in response to an HTTP/1.1 PUT or POST request that does + not include an Expect request-header field with the "100- + continue" expectation. This exception, the purpose of which is + to minimize any client processing delays associated with an + undeclared wait for 100 (Continue) status, applies only to + HTTP/1.1 requests, and not to requests with any other HTTP- + version value. + + - An origin server MAY omit a 100 (Continue) response if it has + already received some or all of the request body for the + corresponding request. + + - An origin server that sends a 100 (Continue) response MUST + ultimately send a final status code, once the request body is + received and processed, unless it terminates the transport + connection prematurely. + + - If an origin server receives a request that does not include an + Expect request-header field with the "100-continue" expectation, + the request includes a request body, and the server responds + with a final status code before reading the entire request body + from the transport connection, then the server SHOULD NOT close + the transport connection until it has read the entire request, + or until the client closes the connection. Otherwise, the client + might not reliably receive the response message. However, this + requirement is not be construed as preventing a server from + defending itself against denial-of-service attacks, or from + badly broken client implementations. + + Requirements for HTTP/1.1 proxies: + + - If a proxy receives a request that includes an Expect request- + header field with the "100-continue" expectation, and the proxy + either knows that the next-hop server complies with HTTP/1.1 or + higher, or does not know the HTTP version of the next-hop + server, it MUST forward the request, including the Expect header + field. + + + + + +Fielding, et al. Standards Track [Page 49] + +RFC 2616 HTTP/1.1 June 1999 + + + - If the proxy knows that the version of the next-hop server is + HTTP/1.0 or lower, it MUST NOT forward the request, and it MUST + respond with a 417 (Expectation Failed) status. + + - Proxies SHOULD maintain a cache recording the HTTP version + numbers received from recently-referenced next-hop servers. + + - A proxy MUST NOT forward a 100 (Continue) response if the + request message was received from an HTTP/1.0 (or earlier) + client and did not include an Expect request-header field with + the "100-continue" expectation. This requirement overrides the + general rule for forwarding of 1xx responses (see section 10.1). + +8.2.4 Client Behavior if Server Prematurely Closes Connection + + If an HTTP/1.1 client sends a request which includes a request body, + but which does not include an Expect request-header field with the + "100-continue" expectation, and if the client is not directly + connected to an HTTP/1.1 origin server, and if the client sees the + connection close before receiving any status from the server, the + client SHOULD retry the request. If the client does retry this + request, it MAY use the following "binary exponential backoff" + algorithm to be assured of obtaining a reliable response: + + 1. Initiate a new connection to the server + + 2. Transmit the request-headers + + 3. Initialize a variable R to the estimated round-trip time to the + server (e.g., based on the time it took to establish the + connection), or to a constant value of 5 seconds if the round- + trip time is not available. + + 4. Compute T = R * (2**N), where N is the number of previous + retries of this request. + + 5. Wait either for an error response from the server, or for T + seconds (whichever comes first) + + 6. If no error response is received, after T seconds transmit the + body of the request. + + 7. If client sees that the connection is closed prematurely, + repeat from step 1 until the request is accepted, an error + response is received, or the user becomes impatient and + terminates the retry process. + + + + + +Fielding, et al. Standards Track [Page 50] + +RFC 2616 HTTP/1.1 June 1999 + + + If at any point an error status is received, the client + + - SHOULD NOT continue and + + - SHOULD close the connection if it has not completed sending the + request message. + +9 Method Definitions + + The set of common methods for HTTP/1.1 is defined below. Although + this set can be expanded, additional methods cannot be assumed to + share the same semantics for separately extended clients and servers. + + The Host request-header field (section 14.23) MUST accompany all + HTTP/1.1 requests. + +9.1 Safe and Idempotent Methods + +9.1.1 Safe Methods + + Implementors should be aware that the software represents the user in + their interactions over the Internet, and should be careful to allow + the user to be aware of any actions they might take which may have an + unexpected significance to themselves or others. + + In particular, the convention has been established that the GET and + HEAD methods SHOULD NOT have the significance of taking an action + other than retrieval. These methods ought to be considered "safe". + This allows user agents to represent other methods, such as POST, PUT + and DELETE, in a special way, so that the user is made aware of the + fact that a possibly unsafe action is being requested. + + Naturally, it is not possible to ensure that the server does not + generate side-effects as a result of performing a GET request; in + fact, some dynamic resources consider that a feature. The important + distinction here is that the user did not request the side-effects, + so therefore cannot be held accountable for them. + +9.1.2 Idempotent Methods + + Methods can also have the property of "idempotence" in that (aside + from error or expiration issues) the side-effects of N > 0 identical + requests is the same as for a single request. The methods GET, HEAD, + PUT and DELETE share this property. Also, the methods OPTIONS and + TRACE SHOULD NOT have side effects, and so are inherently idempotent. + + + + + + +Fielding, et al. Standards Track [Page 51] + +RFC 2616 HTTP/1.1 June 1999 + + + However, it is possible that a sequence of several requests is non- + idempotent, even if all of the methods executed in that sequence are + idempotent. (A sequence is idempotent if a single execution of the + entire sequence always yields a result that is not changed by a + reexecution of all, or part, of that sequence.) For example, a + sequence is non-idempotent if its result depends on a value that is + later modified in the same sequence. + + A sequence that never has side effects is idempotent, by definition + (provided that no concurrent operations are being executed on the + same set of resources). + +9.2 OPTIONS + + The OPTIONS method represents a request for information about the + communication options available on the request/response chain + identified by the Request-URI. This method allows the client to + determine the options and/or requirements associated with a resource, + or the capabilities of a server, without implying a resource action + or initiating a resource retrieval. + + Responses to this method are not cacheable. + + If the OPTIONS request includes an entity-body (as indicated by the + presence of Content-Length or Transfer-Encoding), then the media type + MUST be indicated by a Content-Type field. Although this + specification does not define any use for such a body, future + extensions to HTTP might use the OPTIONS body to make more detailed + queries on the server. A server that does not support such an + extension MAY discard the request body. + + If the Request-URI is an asterisk ("*"), the OPTIONS request is + intended to apply to the server in general rather than to a specific + resource. Since a server's communication options typically depend on + the resource, the "*" request is only useful as a "ping" or "no-op" + type of method; it does nothing beyond allowing the client to test + the capabilities of the server. For example, this can be used to test + a proxy for HTTP/1.1 compliance (or lack thereof). + + If the Request-URI is not an asterisk, the OPTIONS request applies + only to the options that are available when communicating with that + resource. + + A 200 response SHOULD include any header fields that indicate + optional features implemented by the server and applicable to that + resource (e.g., Allow), possibly including extensions not defined by + this specification. The response body, if any, SHOULD also include + information about the communication options. The format for such a + + + +Fielding, et al. Standards Track [Page 52] + +RFC 2616 HTTP/1.1 June 1999 + + + body is not defined by this specification, but might be defined by + future extensions to HTTP. Content negotiation MAY be used to select + the appropriate response format. If no response body is included, the + response MUST include a Content-Length field with a field-value of + "0". + + The Max-Forwards request-header field MAY be used to target a + specific proxy in the request chain. When a proxy receives an OPTIONS + request on an absoluteURI for which request forwarding is permitted, + the proxy MUST check for a Max-Forwards field. If the Max-Forwards + field-value is zero ("0"), the proxy MUST NOT forward the message; + instead, the proxy SHOULD respond with its own communication options. + If the Max-Forwards field-value is an integer greater than zero, the + proxy MUST decrement the field-value when it forwards the request. If + no Max-Forwards field is present in the request, then the forwarded + request MUST NOT include a Max-Forwards field. + +9.3 GET + + The GET method means retrieve whatever information (in the form of an + entity) is identified by the Request-URI. If the Request-URI refers + to a data-producing process, it is the produced data which shall be + returned as the entity in the response and not the source text of the + process, unless that text happens to be the output of the process. + + The semantics of the GET method change to a "conditional GET" if the + request message includes an If-Modified-Since, If-Unmodified-Since, + If-Match, If-None-Match, or If-Range header field. A conditional GET + method requests that the entity be transferred only under the + circumstances described by the conditional header field(s). The + conditional GET method is intended to reduce unnecessary network + usage by allowing cached entities to be refreshed without requiring + multiple requests or transferring data already held by the client. + + The semantics of the GET method change to a "partial GET" if the + request message includes a Range header field. A partial GET requests + that only part of the entity be transferred, as described in section + 14.35. The partial GET method is intended to reduce unnecessary + network usage by allowing partially-retrieved entities to be + completed without transferring data already held by the client. + + The response to a GET request is cacheable if and only if it meets + the requirements for HTTP caching described in section 13. + + See section 15.1.3 for security considerations when used for forms. + + + + + + +Fielding, et al. Standards Track [Page 53] + +RFC 2616 HTTP/1.1 June 1999 + + +9.4 HEAD + + The HEAD method is identical to GET except that the server MUST NOT + return a message-body in the response. The metainformation contained + in the HTTP headers in response to a HEAD request SHOULD be identical + to the information sent in response to a GET request. This method can + be used for obtaining metainformation about the entity implied by the + request without transferring the entity-body itself. This method is + often used for testing hypertext links for validity, accessibility, + and recent modification. + + The response to a HEAD request MAY be cacheable in the sense that the + information contained in the response MAY be used to update a + previously cached entity from that resource. If the new field values + indicate that the cached entity differs from the current entity (as + would be indicated by a change in Content-Length, Content-MD5, ETag + or Last-Modified), then the cache MUST treat the cache entry as + stale. + +9.5 POST + + The POST method is used to request that the origin server accept the + entity enclosed in the request as a new subordinate of the resource + identified by the Request-URI in the Request-Line. POST is designed + to allow a uniform method to cover the following functions: + + - Annotation of existing resources; + + - Posting a message to a bulletin board, newsgroup, mailing list, + or similar group of articles; + + - Providing a block of data, such as the result of submitting a + form, to a data-handling process; + + - Extending a database through an append operation. + + The actual function performed by the POST method is determined by the + server and is usually dependent on the Request-URI. The posted entity + is subordinate to that URI in the same way that a file is subordinate + to a directory containing it, a news article is subordinate to a + newsgroup to which it is posted, or a record is subordinate to a + database. + + The action performed by the POST method might not result in a + resource that can be identified by a URI. In this case, either 200 + (OK) or 204 (No Content) is the appropriate response status, + depending on whether or not the response includes an entity that + describes the result. + + + +Fielding, et al. Standards Track [Page 54] + +RFC 2616 HTTP/1.1 June 1999 + + + If a resource has been created on the origin server, the response + SHOULD be 201 (Created) and contain an entity which describes the + status of the request and refers to the new resource, and a Location + header (see section 14.30). + + Responses to this method are not cacheable, unless the response + includes appropriate Cache-Control or Expires header fields. However, + the 303 (See Other) response can be used to direct the user agent to + retrieve a cacheable resource. + + POST requests MUST obey the message transmission requirements set out + in section 8.2. + + See section 15.1.3 for security considerations. + +9.6 PUT + + The PUT method requests that the enclosed entity be stored under the + supplied Request-URI. If the Request-URI refers to an already + existing resource, the enclosed entity SHOULD be considered as a + modified version of the one residing on the origin server. If the + Request-URI does not point to an existing resource, and that URI is + capable of being defined as a new resource by the requesting user + agent, the origin server can create the resource with that URI. If a + new resource is created, the origin server MUST inform the user agent + via the 201 (Created) response. If an existing resource is modified, + either the 200 (OK) or 204 (No Content) response codes SHOULD be sent + to indicate successful completion of the request. If the resource + could not be created or modified with the Request-URI, an appropriate + error response SHOULD be given that reflects the nature of the + problem. The recipient of the entity MUST NOT ignore any Content-* + (e.g. Content-Range) headers that it does not understand or implement + and MUST return a 501 (Not Implemented) response in such cases. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + + The fundamental difference between the POST and PUT requests is + reflected in the different meaning of the Request-URI. The URI in a + POST request identifies the resource that will handle the enclosed + entity. That resource might be a data-accepting process, a gateway to + some other protocol, or a separate entity that accepts annotations. + In contrast, the URI in a PUT request identifies the entity enclosed + with the request -- the user agent knows what URI is intended and the + server MUST NOT attempt to apply the request to some other resource. + If the server desires that the request be applied to a different URI, + + + + +Fielding, et al. Standards Track [Page 55] + +RFC 2616 HTTP/1.1 June 1999 + + + it MUST send a 301 (Moved Permanently) response; the user agent MAY + then make its own decision regarding whether or not to redirect the + request. + + A single resource MAY be identified by many different URIs. For + example, an article might have a URI for identifying "the current + version" which is separate from the URI identifying each particular + version. In this case, a PUT request on a general URI might result in + several other URIs being defined by the origin server. + + HTTP/1.1 does not define how a PUT method affects the state of an + origin server. + + PUT requests MUST obey the message transmission requirements set out + in section 8.2. + + Unless otherwise specified for a particular entity-header, the + entity-headers in the PUT request SHOULD be applied to the resource + created or modified by the PUT. + +9.7 DELETE + + The DELETE method requests that the origin server delete the resource + identified by the Request-URI. This method MAY be overridden by human + intervention (or other means) on the origin server. The client cannot + be guaranteed that the operation has been carried out, even if the + status code returned from the origin server indicates that the action + has been completed successfully. However, the server SHOULD NOT + indicate success unless, at the time the response is given, it + intends to delete the resource or move it to an inaccessible + location. + + A successful response SHOULD be 200 (OK) if the response includes an + entity describing the status, 202 (Accepted) if the action has not + yet been enacted, or 204 (No Content) if the action has been enacted + but the response does not include an entity. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + +9.8 TRACE + + The TRACE method is used to invoke a remote, application-layer loop- + back of the request message. The final recipient of the request + SHOULD reflect the message received back to the client as the + entity-body of a 200 (OK) response. The final recipient is either the + + + + +Fielding, et al. Standards Track [Page 56] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server or the first proxy or gateway to receive a Max-Forwards + value of zero (0) in the request (see section 14.31). A TRACE request + MUST NOT include an entity. + + TRACE allows the client to see what is being received at the other + end of the request chain and use that data for testing or diagnostic + information. The value of the Via header field (section 14.45) is of + particular interest, since it acts as a trace of the request chain. + Use of the Max-Forwards header field allows the client to limit the + length of the request chain, which is useful for testing a chain of + proxies forwarding messages in an infinite loop. + + If the request is valid, the response SHOULD contain the entire + request message in the entity-body, with a Content-Type of + "message/http". Responses to this method MUST NOT be cached. + +9.9 CONNECT + + This specification reserves the method name CONNECT for use with a + proxy that can dynamically switch to being a tunnel (e.g. SSL + tunneling [44]). + +10 Status Code Definitions + + Each Status-Code is described below, including a description of which + method(s) it can follow and any metainformation required in the + response. + +10.1 Informational 1xx + + This class of status code indicates a provisional response, + consisting only of the Status-Line and optional headers, and is + terminated by an empty line. There are no required headers for this + class of status code. Since HTTP/1.0 did not define any 1xx status + codes, servers MUST NOT send a 1xx response to an HTTP/1.0 client + except under experimental conditions. + + A client MUST be prepared to accept one or more 1xx status responses + prior to a regular response, even if the client does not expect a 100 + (Continue) status message. Unexpected 1xx status responses MAY be + ignored by a user agent. + + Proxies MUST forward 1xx responses, unless the connection between the + proxy and its client has been closed, or unless the proxy itself + requested the generation of the 1xx response. (For example, if a + + + + + + +Fielding, et al. Standards Track [Page 57] + +RFC 2616 HTTP/1.1 June 1999 + + + proxy adds a "Expect: 100-continue" field when it forwards a request, + then it need not forward the corresponding 100 (Continue) + response(s).) + +10.1.1 100 Continue + + The client SHOULD continue with its request. This interim response is + used to inform the client that the initial part of the request has + been received and has not yet been rejected by the server. The client + SHOULD continue by sending the remainder of the request or, if the + request has already been completed, ignore this response. The server + MUST send a final response after the request has been completed. See + section 8.2.3 for detailed discussion of the use and handling of this + status code. + +10.1.2 101 Switching Protocols + + The server understands and is willing to comply with the client's + request, via the Upgrade message header field (section 14.42), for a + change in the application protocol being used on this connection. The + server will switch protocols to those defined by the response's + Upgrade header field immediately after the empty line which + terminates the 101 response. + + The protocol SHOULD be switched only when it is advantageous to do + so. For example, switching to a newer version of HTTP is advantageous + over older versions, and switching to a real-time, synchronous + protocol might be advantageous when delivering resources that use + such features. + +10.2 Successful 2xx + + This class of status code indicates that the client's request was + successfully received, understood, and accepted. + +10.2.1 200 OK + + The request has succeeded. The information returned with the response + is dependent on the method used in the request, for example: + + GET an entity corresponding to the requested resource is sent in + the response; + + HEAD the entity-header fields corresponding to the requested + resource are sent in the response without any message-body; + + POST an entity describing or containing the result of the action; + + + + +Fielding, et al. Standards Track [Page 58] + +RFC 2616 HTTP/1.1 June 1999 + + + TRACE an entity containing the request message as received by the + end server. + +10.2.2 201 Created + + The request has been fulfilled and resulted in a new resource being + created. The newly created resource can be referenced by the URI(s) + returned in the entity of the response, with the most specific URI + for the resource given by a Location header field. The response + SHOULD include an entity containing a list of resource + characteristics and location(s) from which the user or user agent can + choose the one most appropriate. The entity format is specified by + the media type given in the Content-Type header field. The origin + server MUST create the resource before returning the 201 status code. + If the action cannot be carried out immediately, the server SHOULD + respond with 202 (Accepted) response instead. + + A 201 response MAY contain an ETag response header field indicating + the current value of the entity tag for the requested variant just + created, see section 14.19. + +10.2.3 202 Accepted + + The request has been accepted for processing, but the processing has + not been completed. The request might or might not eventually be + acted upon, as it might be disallowed when processing actually takes + place. There is no facility for re-sending a status code from an + asynchronous operation such as this. + + The 202 response is intentionally non-committal. Its purpose is to + allow a server to accept a request for some other process (perhaps a + batch-oriented process that is only run once per day) without + requiring that the user agent's connection to the server persist + until the process is completed. The entity returned with this + response SHOULD include an indication of the request's current status + and either a pointer to a status monitor or some estimate of when the + user can expect the request to be fulfilled. + +10.2.4 203 Non-Authoritative Information + + The returned metainformation in the entity-header is not the + definitive set as available from the origin server, but is gathered + from a local or a third-party copy. The set presented MAY be a subset + or superset of the original version. For example, including local + annotation information about the resource might result in a superset + of the metainformation known by the origin server. Use of this + response code is not required and is only appropriate when the + response would otherwise be 200 (OK). + + + +Fielding, et al. Standards Track [Page 59] + +RFC 2616 HTTP/1.1 June 1999 + + +10.2.5 204 No Content + + The server has fulfilled the request but does not need to return an + entity-body, and might want to return updated metainformation. The + response MAY include new or updated metainformation in the form of + entity-headers, which if present SHOULD be associated with the + requested variant. + + If the client is a user agent, it SHOULD NOT change its document view + from that which caused the request to be sent. This response is + primarily intended to allow input for actions to take place without + causing a change to the user agent's active document view, although + any new or updated metainformation SHOULD be applied to the document + currently in the user agent's active view. + + The 204 response MUST NOT include a message-body, and thus is always + terminated by the first empty line after the header fields. + +10.2.6 205 Reset Content + + The server has fulfilled the request and the user agent SHOULD reset + the document view which caused the request to be sent. This response + is primarily intended to allow input for actions to take place via + user input, followed by a clearing of the form in which the input is + given so that the user can easily initiate another input action. The + response MUST NOT include an entity. + +10.2.7 206 Partial Content + + The server has fulfilled the partial GET request for the resource. + The request MUST have included a Range header field (section 14.35) + indicating the desired range, and MAY have included an If-Range + header field (section 14.27) to make the request conditional. + + The response MUST include the following header fields: + + - Either a Content-Range header field (section 14.16) indicating + the range included with this response, or a multipart/byteranges + Content-Type including Content-Range fields for each part. If a + Content-Length header field is present in the response, its + value MUST match the actual number of OCTETs transmitted in the + message-body. + + - Date + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + + + +Fielding, et al. Standards Track [Page 60] + +RFC 2616 HTTP/1.1 June 1999 + + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the 206 response is the result of an If-Range request that used a + strong cache validator (see section 13.3.3), the response SHOULD NOT + include other entity-headers. If the response is the result of an + If-Range request that used a weak validator, the response MUST NOT + include other entity-headers; this prevents inconsistencies between + cached entity-bodies and updated headers. Otherwise, the response + MUST include all of the entity-headers that would have been returned + with a 200 (OK) response to the same request. + + A cache MUST NOT combine a 206 response with other previously cached + content if the ETag or Last-Modified headers do not match exactly, + see 13.5.4. + + A cache that does not support the Range and Content-Range headers + MUST NOT cache 206 (Partial) responses. + +10.3 Redirection 3xx + + This class of status code indicates that further action needs to be + taken by the user agent in order to fulfill the request. The action + required MAY be carried out by the user agent without interaction + with the user if and only if the method used in the second request is + GET or HEAD. A client SHOULD detect infinite redirection loops, since + such loops generate network traffic for each redirection. + + Note: previous versions of this specification recommended a + maximum of five redirections. Content developers should be aware + that there might be clients that implement such a fixed + limitation. + +10.3.1 300 Multiple Choices + + The requested resource corresponds to any one of a set of + representations, each with its own specific location, and agent- + driven negotiation information (section 12) is being provided so that + the user (or user agent) can select a preferred representation and + redirect its request to that location. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of resource characteristics and location(s) from + which the user or user agent can choose the one most appropriate. The + entity format is specified by the media type given in the Content- + Type header field. Depending upon the format and the capabilities of + + + + +Fielding, et al. Standards Track [Page 61] + +RFC 2616 HTTP/1.1 June 1999 + + + the user agent, selection of the most appropriate choice MAY be + performed automatically. However, this specification does not define + any standard for such automatic selection. + + If the server has a preferred choice of representation, it SHOULD + include the specific URI for that representation in the Location + field; user agents MAY use the Location field value for automatic + redirection. This response is cacheable unless indicated otherwise. + +10.3.2 301 Moved Permanently + + The requested resource has been assigned a new permanent URI and any + future references to this resource SHOULD use one of the returned + URIs. Clients with link editing capabilities ought to automatically + re-link references to the Request-URI to one or more of the new + references returned by the server, where possible. This response is + cacheable unless indicated otherwise. + + The new permanent URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + If the 301 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: When automatically redirecting a POST request after + receiving a 301 status code, some existing HTTP/1.0 user agents + will erroneously change it into a GET request. + +10.3.3 302 Found + + The requested resource resides temporarily under a different URI. + Since the redirection might be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + + + + + + +Fielding, et al. Standards Track [Page 62] + +RFC 2616 HTTP/1.1 June 1999 + + + If the 302 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: RFC 1945 and RFC 2068 specify that the client is not allowed + to change the method on the redirected request. However, most + existing user agent implementations treat 302 as if it were a 303 + response, performing a GET on the Location field-value regardless + of the original request method. The status codes 303 and 307 have + been added for servers that wish to make unambiguously clear which + kind of reaction is expected of the client. + +10.3.4 303 See Other + + The response to the request can be found under a different URI and + SHOULD be retrieved using a GET method on that resource. This method + exists primarily to allow the output of a POST-activated script to + redirect the user agent to a selected resource. The new URI is not a + substitute reference for the originally requested resource. The 303 + response MUST NOT be cached, but the response to the second + (redirected) request might be cacheable. + + The different URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + Note: Many pre-HTTP/1.1 user agents do not understand the 303 + status. When interoperability with such clients is a concern, the + 302 status code may be used instead, since most user agents react + to a 302 response as described here for 303. + +10.3.5 304 Not Modified + + If the client has performed a conditional GET request and access is + allowed, but the document has not been modified, the server SHOULD + respond with this status code. The 304 response MUST NOT contain a + message-body, and thus is always terminated by the first empty line + after the header fields. + + The response MUST include the following header fields: + + - Date, unless its omission is required by section 14.18.1 + + + + + + + +Fielding, et al. Standards Track [Page 63] + +RFC 2616 HTTP/1.1 June 1999 + + + If a clockless origin server obeys these rules, and proxies and + clients add their own Date to any response received without one (as + already specified by [RFC 2068], section 14.19), caches will operate + correctly. + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the conditional GET used a strong cache validator (see section + 13.3.3), the response SHOULD NOT include other entity-headers. + Otherwise (i.e., the conditional GET used a weak validator), the + response MUST NOT include other entity-headers; this prevents + inconsistencies between cached entity-bodies and updated headers. + + If a 304 response indicates an entity not currently cached, then the + cache MUST disregard the response and repeat the request without the + conditional. + + If a cache uses a received 304 response to update a cache entry, the + cache MUST update the entry to reflect any new field values given in + the response. + +10.3.6 305 Use Proxy + + The requested resource MUST be accessed through the proxy given by + the Location field. The Location field gives the URI of the proxy. + The recipient is expected to repeat this single request via the + proxy. 305 responses MUST only be generated by origin servers. + + Note: RFC 2068 was not clear that 305 was intended to redirect a + single request, and to be generated by origin servers only. Not + observing these limitations has significant security consequences. + +10.3.7 306 (Unused) + + The 306 status code was used in a previous version of the + specification, is no longer used, and the code is reserved. + + + + + + + + + + +Fielding, et al. Standards Track [Page 64] + +RFC 2616 HTTP/1.1 June 1999 + + +10.3.8 307 Temporary Redirect + + The requested resource resides temporarily under a different URI. + Since the redirection MAY be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s) , since many pre-HTTP/1.1 user agents do not + understand the 307 status. Therefore, the note SHOULD contain the + information necessary for a user to repeat the original request on + the new URI. + + If the 307 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + +10.4 Client Error 4xx + + The 4xx class of status code is intended for cases in which the + client seems to have erred. Except when responding to a HEAD request, + the server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. These status codes are applicable to any request method. + User agents SHOULD display any included entity to the user. + + If the client is sending data, a server implementation using TCP + SHOULD be careful to ensure that the client acknowledges receipt of + the packet(s) containing the response, before the server closes the + input connection. If the client continues sending data to the server + after the close, the server's TCP stack will send a reset packet to + the client, which may erase the client's unacknowledged input buffers + before they can be read and interpreted by the HTTP application. + +10.4.1 400 Bad Request + + The request could not be understood by the server due to malformed + syntax. The client SHOULD NOT repeat the request without + modifications. + + + + + + + + +Fielding, et al. Standards Track [Page 65] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.2 401 Unauthorized + + The request requires user authentication. The response MUST include a + WWW-Authenticate header field (section 14.47) containing a challenge + applicable to the requested resource. The client MAY repeat the + request with a suitable Authorization header field (section 14.8). If + the request already included Authorization credentials, then the 401 + response indicates that authorization has been refused for those + credentials. If the 401 response contains the same challenge as the + prior response, and the user agent has already attempted + authentication at least once, then the user SHOULD be presented the + entity that was given in the response, since that entity might + include relevant diagnostic information. HTTP access authentication + is explained in "HTTP Authentication: Basic and Digest Access + Authentication" [43]. + +10.4.3 402 Payment Required + + This code is reserved for future use. + +10.4.4 403 Forbidden + + The server understood the request, but is refusing to fulfill it. + Authorization will not help and the request SHOULD NOT be repeated. + If the request method was not HEAD and the server wishes to make + public why the request has not been fulfilled, it SHOULD describe the + reason for the refusal in the entity. If the server does not wish to + make this information available to the client, the status code 404 + (Not Found) can be used instead. + +10.4.5 404 Not Found + + The server has not found anything matching the Request-URI. No + indication is given of whether the condition is temporary or + permanent. The 410 (Gone) status code SHOULD be used if the server + knows, through some internally configurable mechanism, that an old + resource is permanently unavailable and has no forwarding address. + This status code is commonly used when the server does not wish to + reveal exactly why the request has been refused, or when no other + response is applicable. + +10.4.6 405 Method Not Allowed + + The method specified in the Request-Line is not allowed for the + resource identified by the Request-URI. The response MUST include an + Allow header containing a list of valid methods for the requested + resource. + + + + +Fielding, et al. Standards Track [Page 66] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.7 406 Not Acceptable + + The resource identified by the request is only capable of generating + response entities which have content characteristics not acceptable + according to the accept headers sent in the request. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of available entity characteristics and location(s) + from which the user or user agent can choose the one most + appropriate. The entity format is specified by the media type given + in the Content-Type header field. Depending upon the format and the + capabilities of the user agent, selection of the most appropriate + choice MAY be performed automatically. However, this specification + does not define any standard for such automatic selection. + + Note: HTTP/1.1 servers are allowed to return responses which are + not acceptable according to the accept headers sent in the + request. In some cases, this may even be preferable to sending a + 406 response. User agents are encouraged to inspect the headers of + an incoming response to determine if it is acceptable. + + If the response could be unacceptable, a user agent SHOULD + temporarily stop receipt of more data and query the user for a + decision on further actions. + +10.4.8 407 Proxy Authentication Required + + This code is similar to 401 (Unauthorized), but indicates that the + client must first authenticate itself with the proxy. The proxy MUST + return a Proxy-Authenticate header field (section 14.33) containing a + challenge applicable to the proxy for the requested resource. The + client MAY repeat the request with a suitable Proxy-Authorization + header field (section 14.34). HTTP access authentication is explained + in "HTTP Authentication: Basic and Digest Access Authentication" + [43]. + +10.4.9 408 Request Timeout + + The client did not produce a request within the time that the server + was prepared to wait. The client MAY repeat the request without + modifications at any later time. + +10.4.10 409 Conflict + + The request could not be completed due to a conflict with the current + state of the resource. This code is only allowed in situations where + it is expected that the user might be able to resolve the conflict + and resubmit the request. The response body SHOULD include enough + + + +Fielding, et al. Standards Track [Page 67] + +RFC 2616 HTTP/1.1 June 1999 + + + information for the user to recognize the source of the conflict. + Ideally, the response entity would include enough information for the + user or user agent to fix the problem; however, that might not be + possible and is not required. + + Conflicts are most likely to occur in response to a PUT request. For + example, if versioning were being used and the entity being PUT + included changes to a resource which conflict with those made by an + earlier (third-party) request, the server might use the 409 response + to indicate that it can't complete the request. In this case, the + response entity would likely contain a list of the differences + between the two versions in a format defined by the response + Content-Type. + +10.4.11 410 Gone + + The requested resource is no longer available at the server and no + forwarding address is known. This condition is expected to be + considered permanent. Clients with link editing capabilities SHOULD + delete references to the Request-URI after user approval. If the + server does not know, or has no facility to determine, whether or not + the condition is permanent, the status code 404 (Not Found) SHOULD be + used instead. This response is cacheable unless indicated otherwise. + + The 410 response is primarily intended to assist the task of web + maintenance by notifying the recipient that the resource is + intentionally unavailable and that the server owners desire that + remote links to that resource be removed. Such an event is common for + limited-time, promotional services and for resources belonging to + individuals no longer working at the server's site. It is not + necessary to mark all permanently unavailable resources as "gone" or + to keep the mark for any length of time -- that is left to the + discretion of the server owner. + +10.4.12 411 Length Required + + The server refuses to accept the request without a defined Content- + Length. The client MAY repeat the request if it adds a valid + Content-Length header field containing the length of the message-body + in the request message. + +10.4.13 412 Precondition Failed + + The precondition given in one or more of the request-header fields + evaluated to false when it was tested on the server. This response + code allows the client to place preconditions on the current resource + metainformation (header field data) and thus prevent the requested + method from being applied to a resource other than the one intended. + + + +Fielding, et al. Standards Track [Page 68] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.14 413 Request Entity Too Large + + The server is refusing to process a request because the request + entity is larger than the server is willing or able to process. The + server MAY close the connection to prevent the client from continuing + the request. + + If the condition is temporary, the server SHOULD include a Retry- + After header field to indicate that it is temporary and after what + time the client MAY try again. + +10.4.15 414 Request-URI Too Long + + The server is refusing to service the request because the Request-URI + is longer than the server is willing to interpret. This rare + condition is only likely to occur when a client has improperly + converted a POST request to a GET request with long query + information, when the client has descended into a URI "black hole" of + redirection (e.g., a redirected URI prefix that points to a suffix of + itself), or when the server is under attack by a client attempting to + exploit security holes present in some servers using fixed-length + buffers for reading or manipulating the Request-URI. + +10.4.16 415 Unsupported Media Type + + The server is refusing to service the request because the entity of + the request is in a format not supported by the requested resource + for the requested method. + +10.4.17 416 Requested Range Not Satisfiable + + A server SHOULD return a response with this status code if a request + included a Range request-header field (section 14.35), and none of + the range-specifier values in this field overlap the current extent + of the selected resource, and the request did not include an If-Range + request-header field. (For byte-ranges, this means that the first- + byte-pos of all of the byte-range-spec values were greater than the + current length of the selected resource.) + + When this status code is returned for a byte-range request, the + response SHOULD include a Content-Range entity-header field + specifying the current length of the selected resource (see section + 14.16). This response MUST NOT use the multipart/byteranges content- + type. + + + + + + + +Fielding, et al. Standards Track [Page 69] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.18 417 Expectation Failed + + The expectation given in an Expect request-header field (see section + 14.20) could not be met by this server, or, if the server is a proxy, + the server has unambiguous evidence that the request could not be met + by the next-hop server. + +10.5 Server Error 5xx + + Response status codes beginning with the digit "5" indicate cases in + which the server is aware that it has erred or is incapable of + performing the request. Except when responding to a HEAD request, the + server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. User agents SHOULD display any included entity to the + user. These response codes are applicable to any request method. + +10.5.1 500 Internal Server Error + + The server encountered an unexpected condition which prevented it + from fulfilling the request. + +10.5.2 501 Not Implemented + + The server does not support the functionality required to fulfill the + request. This is the appropriate response when the server does not + recognize the request method and is not capable of supporting it for + any resource. + +10.5.3 502 Bad Gateway + + The server, while acting as a gateway or proxy, received an invalid + response from the upstream server it accessed in attempting to + fulfill the request. + +10.5.4 503 Service Unavailable + + The server is currently unable to handle the request due to a + temporary overloading or maintenance of the server. The implication + is that this is a temporary condition which will be alleviated after + some delay. If known, the length of the delay MAY be indicated in a + Retry-After header. If no Retry-After is given, the client SHOULD + handle the response as it would for a 500 response. + + Note: The existence of the 503 status code does not imply that a + server must use it when becoming overloaded. Some servers may wish + to simply refuse the connection. + + + + +Fielding, et al. Standards Track [Page 70] + +RFC 2616 HTTP/1.1 June 1999 + + +10.5.5 504 Gateway Timeout + + The server, while acting as a gateway or proxy, did not receive a + timely response from the upstream server specified by the URI (e.g. + HTTP, FTP, LDAP) or some other auxiliary server (e.g. DNS) it needed + to access in attempting to complete the request. + + Note: Note to implementors: some deployed proxies are known to + return 400 or 500 when DNS lookups time out. + +10.5.6 505 HTTP Version Not Supported + + The server does not support, or refuses to support, the HTTP protocol + version that was used in the request message. The server is + indicating that it is unable or unwilling to complete the request + using the same major version as the client, as described in section + 3.1, other than with this error message. The response SHOULD contain + an entity describing why that version is not supported and what other + protocols are supported by that server. + +11 Access Authentication + + HTTP provides several OPTIONAL challenge-response authentication + mechanisms which can be used by a server to challenge a client + request and by a client to provide authentication information. The + general framework for access authentication, and the specification of + "basic" and "digest" authentication, are specified in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. This + specification adopts the definitions of "challenge" and "credentials" + from that specification. + +12 Content Negotiation + + Most HTTP responses include an entity which contains information for + interpretation by a human user. Naturally, it is desirable to supply + the user with the "best available" entity corresponding to the + request. Unfortunately for servers and caches, not all users have the + same preferences for what is "best," and not all user agents are + equally capable of rendering all entity types. For that reason, HTTP + has provisions for several mechanisms for "content negotiation" -- + the process of selecting the best representation for a given response + when there are multiple representations available. + + Note: This is not called "format negotiation" because the + alternate representations may be of the same media type, but use + different capabilities of that type, be in different languages, + etc. + + + + +Fielding, et al. Standards Track [Page 71] + +RFC 2616 HTTP/1.1 June 1999 + + + Any response containing an entity-body MAY be subject to negotiation, + including error responses. + + There are two kinds of content negotiation which are possible in + HTTP: server-driven and agent-driven negotiation. These two kinds of + negotiation are orthogonal and thus may be used separately or in + combination. One method of combination, referred to as transparent + negotiation, occurs when a cache uses the agent-driven negotiation + information provided by the origin server in order to provide + server-driven negotiation for subsequent requests. + +12.1 Server-driven Negotiation + + If the selection of the best representation for a response is made by + an algorithm located at the server, it is called server-driven + negotiation. Selection is based on the available representations of + the response (the dimensions over which it can vary; e.g. language, + content-coding, etc.) and the contents of particular header fields in + the request message or on other information pertaining to the request + (such as the network address of the client). + + Server-driven negotiation is advantageous when the algorithm for + selecting from among the available representations is difficult to + describe to the user agent, or when the server desires to send its + "best guess" to the client along with the first response (hoping to + avoid the round-trip delay of a subsequent request if the "best + guess" is good enough for the user). In order to improve the server's + guess, the user agent MAY include request header fields (Accept, + Accept-Language, Accept-Encoding, etc.) which describe its + preferences for such a response. + + Server-driven negotiation has disadvantages: + + 1. It is impossible for the server to accurately determine what + might be "best" for any given user, since that would require + complete knowledge of both the capabilities of the user agent + and the intended use for the response (e.g., does the user want + to view it on screen or print it on paper?). + + 2. Having the user agent describe its capabilities in every + request can be both very inefficient (given that only a small + percentage of responses have multiple representations) and a + potential violation of the user's privacy. + + 3. It complicates the implementation of an origin server and the + algorithms for generating responses to a request. + + + + + +Fielding, et al. Standards Track [Page 72] + +RFC 2616 HTTP/1.1 June 1999 + + + 4. It may limit a public cache's ability to use the same response + for multiple user's requests. + + HTTP/1.1 includes the following request-header fields for enabling + server-driven negotiation through description of user agent + capabilities and user preferences: Accept (section 14.1), Accept- + Charset (section 14.2), Accept-Encoding (section 14.3), Accept- + Language (section 14.4), and User-Agent (section 14.43). However, an + origin server is not limited to these dimensions and MAY vary the + response based on any aspect of the request, including information + outside the request-header fields or within extension header fields + not defined by this specification. + + The Vary header field can be used to express the parameters the + server uses to select a representation that is subject to server- + driven negotiation. See section 13.6 for use of the Vary header field + by caches and section 14.44 for use of the Vary header field by + servers. + +12.2 Agent-driven Negotiation + + With agent-driven negotiation, selection of the best representation + for a response is performed by the user agent after receiving an + initial response from the origin server. Selection is based on a list + of the available representations of the response included within the + header fields or entity-body of the initial response, with each + representation identified by its own URI. Selection from among the + representations may be performed automatically (if the user agent is + capable of doing so) or manually by the user selecting from a + generated (possibly hypertext) menu. + + Agent-driven negotiation is advantageous when the response would vary + over commonly-used dimensions (such as type, language, or encoding), + when the origin server is unable to determine a user agent's + capabilities from examining the request, and generally when public + caches are used to distribute server load and reduce network usage. + + Agent-driven negotiation suffers from the disadvantage of needing a + second request to obtain the best alternate representation. This + second request is only efficient when caching is used. In addition, + this specification does not define any mechanism for supporting + automatic selection, though it also does not prevent any such + mechanism from being developed as an extension and used within + HTTP/1.1. + + + + + + + +Fielding, et al. Standards Track [Page 73] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 defines the 300 (Multiple Choices) and 406 (Not Acceptable) + status codes for enabling agent-driven negotiation when the server is + unwilling or unable to provide a varying response using server-driven + negotiation. + +12.3 Transparent Negotiation + + Transparent negotiation is a combination of both server-driven and + agent-driven negotiation. When a cache is supplied with a form of the + list of available representations of the response (as in agent-driven + negotiation) and the dimensions of variance are completely understood + by the cache, then the cache becomes capable of performing server- + driven negotiation on behalf of the origin server for subsequent + requests on that resource. + + Transparent negotiation has the advantage of distributing the + negotiation work that would otherwise be required of the origin + server and also removing the second request delay of agent-driven + negotiation when the cache is able to correctly guess the right + response. + + This specification does not define any mechanism for transparent + negotiation, though it also does not prevent any such mechanism from + being developed as an extension that could be used within HTTP/1.1. + +13 Caching in HTTP + + HTTP is typically used for distributed information systems, where + performance can be improved by the use of response caches. The + HTTP/1.1 protocol includes a number of elements intended to make + caching work as well as possible. Because these elements are + inextricable from other aspects of the protocol, and because they + interact with each other, it is useful to describe the basic caching + design of HTTP separately from the detailed descriptions of methods, + headers, response codes, etc. + + Caching would be useless if it did not significantly improve + performance. The goal of caching in HTTP/1.1 is to eliminate the need + to send requests in many cases, and to eliminate the need to send + full responses in many other cases. The former reduces the number of + network round-trips required for many operations; we use an + "expiration" mechanism for this purpose (see section 13.2). The + latter reduces network bandwidth requirements; we use a "validation" + mechanism for this purpose (see section 13.3). + + Requirements for performance, availability, and disconnected + operation require us to be able to relax the goal of semantic + transparency. The HTTP/1.1 protocol allows origin servers, caches, + + + +Fielding, et al. Standards Track [Page 74] + +RFC 2616 HTTP/1.1 June 1999 + + + and clients to explicitly reduce transparency when necessary. + However, because non-transparent operation may confuse non-expert + users, and might be incompatible with certain server applications + (such as those for ordering merchandise), the protocol requires that + transparency be relaxed + + - only by an explicit protocol-level request when relaxed by + client or origin server + + - only with an explicit warning to the end user when relaxed by + cache or client + + Therefore, the HTTP/1.1 protocol provides these important elements: + + 1. Protocol features that provide full semantic transparency when + this is required by all parties. + + 2. Protocol features that allow an origin server or user agent to + explicitly request and control non-transparent operation. + + 3. Protocol features that allow a cache to attach warnings to + responses that do not preserve the requested approximation of + semantic transparency. + + A basic principle is that it must be possible for the clients to + detect any potential relaxation of semantic transparency. + + Note: The server, cache, or client implementor might be faced with + design decisions not explicitly discussed in this specification. + If a decision might affect semantic transparency, the implementor + ought to err on the side of maintaining transparency unless a + careful and complete analysis shows significant benefits in + breaking transparency. + +13.1.1 Cache Correctness + + A correct cache MUST respond to a request with the most up-to-date + response held by the cache that is appropriate to the request (see + sections 13.2.5, 13.2.6, and 13.12) which meets one of the following + conditions: + + 1. It has been checked for equivalence with what the origin server + would have returned by revalidating the response with the + origin server (section 13.3); + + + + + + + +Fielding, et al. Standards Track [Page 75] + +RFC 2616 HTTP/1.1 June 1999 + + + 2. It is "fresh enough" (see section 13.2). In the default case, + this means it meets the least restrictive freshness requirement + of the client, origin server, and cache (see section 14.9); if + the origin server so specifies, it is the freshness requirement + of the origin server alone. + + If a stored response is not "fresh enough" by the most + restrictive freshness requirement of both the client and the + origin server, in carefully considered circumstances the cache + MAY still return the response with the appropriate Warning + header (see section 13.1.5 and 14.46), unless such a response + is prohibited (e.g., by a "no-store" cache-directive, or by a + "no-cache" cache-request-directive; see section 14.9). + + 3. It is an appropriate 304 (Not Modified), 305 (Proxy Redirect), + or error (4xx or 5xx) response message. + + If the cache can not communicate with the origin server, then a + correct cache SHOULD respond as above if the response can be + correctly served from the cache; if not it MUST return an error or + warning indicating that there was a communication failure. + + If a cache receives a response (either an entire response, or a 304 + (Not Modified) response) that it would normally forward to the + requesting client, and the received response is no longer fresh, the + cache SHOULD forward it to the requesting client without adding a new + Warning (but without removing any existing Warning headers). A cache + SHOULD NOT attempt to revalidate a response simply because that + response became stale in transit; this might lead to an infinite + loop. A user agent that receives a stale response without a Warning + MAY display a warning indication to the user. + +13.1.2 Warnings + + Whenever a cache returns a response that is neither first-hand nor + "fresh enough" (in the sense of condition 2 in section 13.1.1), it + MUST attach a warning to that effect, using a Warning general-header. + The Warning header and the currently defined warnings are described + in section 14.46. The warning allows clients to take appropriate + action. + + Warnings MAY be used for other purposes, both cache-related and + otherwise. The use of a warning, rather than an error status code, + distinguish these responses from true failures. + + Warnings are assigned three digit warn-codes. The first digit + indicates whether the Warning MUST or MUST NOT be deleted from a + stored cache entry after a successful revalidation: + + + +Fielding, et al. Standards Track [Page 76] + +RFC 2616 HTTP/1.1 June 1999 + + + 1xx Warnings that describe the freshness or revalidation status of + the response, and so MUST be deleted after a successful + revalidation. 1XX warn-codes MAY be generated by a cache only when + validating a cached entry. It MUST NOT be generated by clients. + + 2xx Warnings that describe some aspect of the entity body or entity + headers that is not rectified by a revalidation (for example, a + lossy compression of the entity bodies) and which MUST NOT be + deleted after a successful revalidation. + + See section 14.46 for the definitions of the codes themselves. + + HTTP/1.0 caches will cache all Warnings in responses, without + deleting the ones in the first category. Warnings in responses that + are passed to HTTP/1.0 caches carry an extra warning-date field, + which prevents a future HTTP/1.1 recipient from believing an + erroneously cached Warning. + + Warnings also carry a warning text. The text MAY be in any + appropriate natural language (perhaps based on the client's Accept + headers), and include an OPTIONAL indication of what character set is + used. + + Multiple warnings MAY be attached to a response (either by the origin + server or by a cache), including multiple warnings with the same code + number. For example, a server might provide the same warning with + texts in both English and Basque. + + When multiple warnings are attached to a response, it might not be + practical or reasonable to display all of them to the user. This + version of HTTP does not specify strict priority rules for deciding + which warnings to display and in what order, but does suggest some + heuristics. + +13.1.3 Cache-control Mechanisms + + The basic cache mechanisms in HTTP/1.1 (server-specified expiration + times and validators) are implicit directives to caches. In some + cases, a server or client might need to provide explicit directives + to the HTTP caches. We use the Cache-Control header for this purpose. + + The Cache-Control header allows a client or server to transmit a + variety of directives in either requests or responses. These + directives typically override the default caching algorithms. As a + general rule, if there is any apparent conflict between header + values, the most restrictive interpretation is applied (that is, the + one that is most likely to preserve semantic transparency). However, + + + + +Fielding, et al. Standards Track [Page 77] + +RFC 2616 HTTP/1.1 June 1999 + + + in some cases, cache-control directives are explicitly specified as + weakening the approximation of semantic transparency (for example, + "max-stale" or "public"). + + The cache-control directives are described in detail in section 14.9. + +13.1.4 Explicit User Agent Warnings + + Many user agents make it possible for users to override the basic + caching mechanisms. For example, the user agent might allow the user + to specify that cached entities (even explicitly stale ones) are + never validated. Or the user agent might habitually add "Cache- + Control: max-stale=3600" to every request. The user agent SHOULD NOT + default to either non-transparent behavior, or behavior that results + in abnormally ineffective caching, but MAY be explicitly configured + to do so by an explicit action of the user. + + If the user has overridden the basic caching mechanisms, the user + agent SHOULD explicitly indicate to the user whenever this results in + the display of information that might not meet the server's + transparency requirements (in particular, if the displayed entity is + known to be stale). Since the protocol normally allows the user agent + to determine if responses are stale or not, this indication need only + be displayed when this actually happens. The indication need not be a + dialog box; it could be an icon (for example, a picture of a rotting + fish) or some other indicator. + + If the user has overridden the caching mechanisms in a way that would + abnormally reduce the effectiveness of caches, the user agent SHOULD + continually indicate this state to the user (for example, by a + display of a picture of currency in flames) so that the user does not + inadvertently consume excess resources or suffer from excessive + latency. + +13.1.5 Exceptions to the Rules and Warnings + + In some cases, the operator of a cache MAY choose to configure it to + return stale responses even when not requested by clients. This + decision ought not be made lightly, but may be necessary for reasons + of availability or performance, especially when the cache is poorly + connected to the origin server. Whenever a cache returns a stale + response, it MUST mark it as such (using a Warning header) enabling + the client software to alert the user that there might be a potential + problem. + + + + + + + +Fielding, et al. Standards Track [Page 78] + +RFC 2616 HTTP/1.1 June 1999 + + + It also allows the user agent to take steps to obtain a first-hand or + fresh response. For this reason, a cache SHOULD NOT return a stale + response if the client explicitly requests a first-hand or fresh one, + unless it is impossible to comply for technical or policy reasons. + +13.1.6 Client-controlled Behavior + + While the origin server (and to a lesser extent, intermediate caches, + by their contribution to the age of a response) are the primary + source of expiration information, in some cases the client might need + to control a cache's decision about whether to return a cached + response without validating it. Clients do this using several + directives of the Cache-Control header. + + A client's request MAY specify the maximum age it is willing to + accept of an unvalidated response; specifying a value of zero forces + the cache(s) to revalidate all responses. A client MAY also specify + the minimum time remaining before a response expires. Both of these + options increase constraints on the behavior of caches, and so cannot + further relax the cache's approximation of semantic transparency. + + A client MAY also specify that it will accept stale responses, up to + some maximum amount of staleness. This loosens the constraints on the + caches, and so might violate the origin server's specified + constraints on semantic transparency, but might be necessary to + support disconnected operation, or high availability in the face of + poor connectivity. + +13.2 Expiration Model + +13.2.1 Server-Specified Expiration + + HTTP caching works best when caches can entirely avoid making + requests to the origin server. The primary mechanism for avoiding + requests is for an origin server to provide an explicit expiration + time in the future, indicating that a response MAY be used to satisfy + subsequent requests. In other words, a cache can return a fresh + response without first contacting the server. + + Our expectation is that servers will assign future explicit + expiration times to responses in the belief that the entity is not + likely to change, in a semantically significant way, before the + expiration time is reached. This normally preserves semantic + transparency, as long as the server's expiration times are carefully + chosen. + + + + + + +Fielding, et al. Standards Track [Page 79] + +RFC 2616 HTTP/1.1 June 1999 + + + The expiration mechanism applies only to responses taken from a cache + and not to first-hand responses forwarded immediately to the + requesting client. + + If an origin server wishes to force a semantically transparent cache + to validate every request, it MAY assign an explicit expiration time + in the past. This means that the response is always stale, and so the + cache SHOULD validate it before using it for subsequent requests. See + section 14.9.4 for a more restrictive way to force revalidation. + + If an origin server wishes to force any HTTP/1.1 cache, no matter how + it is configured, to validate every request, it SHOULD use the "must- + revalidate" cache-control directive (see section 14.9). + + Servers specify explicit expiration times using either the Expires + header, or the max-age directive of the Cache-Control header. + + An expiration time cannot be used to force a user agent to refresh + its display or reload a resource; its semantics apply only to caching + mechanisms, and such mechanisms need only check a resource's + expiration status when a new request for that resource is initiated. + See section 13.13 for an explanation of the difference between caches + and history mechanisms. + +13.2.2 Heuristic Expiration + + Since origin servers do not always provide explicit expiration times, + HTTP caches typically assign heuristic expiration times, employing + algorithms that use other header values (such as the Last-Modified + time) to estimate a plausible expiration time. The HTTP/1.1 + specification does not provide specific algorithms, but does impose + worst-case constraints on their results. Since heuristic expiration + times might compromise semantic transparency, they ought to used + cautiously, and we encourage origin servers to provide explicit + expiration times as much as possible. + +13.2.3 Age Calculations + + In order to know if a cached entry is fresh, a cache needs to know if + its age exceeds its freshness lifetime. We discuss how to calculate + the latter in section 13.2.4; this section describes how to calculate + the age of a response or cache entry. + + In this discussion, we use the term "now" to mean "the current value + of the clock at the host performing the calculation." Hosts that use + HTTP, but especially hosts running origin servers and caches, SHOULD + use NTP [28] or some similar protocol to synchronize their clocks to + a globally accurate time standard. + + + +Fielding, et al. Standards Track [Page 80] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 requires origin servers to send a Date header, if possible, + with every response, giving the time at which the response was + generated (see section 14.18). We use the term "date_value" to denote + the value of the Date header, in a form appropriate for arithmetic + operations. + + HTTP/1.1 uses the Age response-header to convey the estimated age of + the response message when obtained from a cache. The Age field value + is the cache's estimate of the amount of time since the response was + generated or revalidated by the origin server. + + In essence, the Age value is the sum of the time that the response + has been resident in each of the caches along the path from the + origin server, plus the amount of time it has been in transit along + network paths. + + We use the term "age_value" to denote the value of the Age header, in + a form appropriate for arithmetic operations. + + A response's age can be calculated in two entirely independent ways: + + 1. now minus date_value, if the local clock is reasonably well + synchronized to the origin server's clock. If the result is + negative, the result is replaced by zero. + + 2. age_value, if all of the caches along the response path + implement HTTP/1.1. + + Given that we have two independent ways to compute the age of a + response when it is received, we can combine these as + + corrected_received_age = max(now - date_value, age_value) + + and as long as we have either nearly synchronized clocks or all- + HTTP/1.1 paths, one gets a reliable (conservative) result. + + Because of network-imposed delays, some significant interval might + pass between the time that a server generates a response and the time + it is received at the next outbound cache or client. If uncorrected, + this delay could result in improperly low ages. + + Because the request that resulted in the returned Age value must have + been initiated prior to that Age value's generation, we can correct + for delays imposed by the network by recording the time at which the + request was initiated. Then, when an Age value is received, it MUST + be interpreted relative to the time the request was initiated, not + + + + + +Fielding, et al. Standards Track [Page 81] + +RFC 2616 HTTP/1.1 June 1999 + + + the time that the response was received. This algorithm results in + conservative behavior no matter how much delay is experienced. So, we + compute: + + corrected_initial_age = corrected_received_age + + (now - request_time) + + where "request_time" is the time (according to the local clock) when + the request that elicited this response was sent. + + Summary of age calculation algorithm, when a cache receives a + response: + + /* + * age_value + * is the value of Age: header received by the cache with + * this response. + * date_value + * is the value of the origin server's Date: header + * request_time + * is the (local) time when the cache made the request + * that resulted in this cached response + * response_time + * is the (local) time when the cache received the + * response + * now + * is the current (local) time + */ + + apparent_age = max(0, response_time - date_value); + corrected_received_age = max(apparent_age, age_value); + response_delay = response_time - request_time; + corrected_initial_age = corrected_received_age + response_delay; + resident_time = now - response_time; + current_age = corrected_initial_age + resident_time; + + The current_age of a cache entry is calculated by adding the amount + of time (in seconds) since the cache entry was last validated by the + origin server to the corrected_initial_age. When a response is + generated from a cache entry, the cache MUST include a single Age + header field in the response with a value equal to the cache entry's + current_age. + + The presence of an Age header field in a response implies that a + response is not first-hand. However, the converse is not true, since + the lack of an Age header field in a response does not imply that the + + + + + +Fielding, et al. Standards Track [Page 82] + +RFC 2616 HTTP/1.1 June 1999 + + + response is first-hand unless all caches along the request path are + compliant with HTTP/1.1 (i.e., older HTTP caches did not implement + the Age header field). + +13.2.4 Expiration Calculations + + In order to decide whether a response is fresh or stale, we need to + compare its freshness lifetime to its age. The age is calculated as + described in section 13.2.3; this section describes how to calculate + the freshness lifetime, and to determine if a response has expired. + In the discussion below, the values can be represented in any form + appropriate for arithmetic operations. + + We use the term "expires_value" to denote the value of the Expires + header. We use the term "max_age_value" to denote an appropriate + value of the number of seconds carried by the "max-age" directive of + the Cache-Control header in a response (see section 14.9.3). + + The max-age directive takes priority over Expires, so if max-age is + present in a response, the calculation is simply: + + freshness_lifetime = max_age_value + + Otherwise, if Expires is present in the response, the calculation is: + + freshness_lifetime = expires_value - date_value + + Note that neither of these calculations is vulnerable to clock skew, + since all of the information comes from the origin server. + + If none of Expires, Cache-Control: max-age, or Cache-Control: s- + maxage (see section 14.9.3) appears in the response, and the response + does not include other restrictions on caching, the cache MAY compute + a freshness lifetime using a heuristic. The cache MUST attach Warning + 113 to any response whose age is more than 24 hours if such warning + has not already been added. + + Also, if the response does have a Last-Modified time, the heuristic + expiration value SHOULD be no more than some fraction of the interval + since that time. A typical setting of this fraction might be 10%. + + The calculation to determine if a response has expired is quite + simple: + + response_is_fresh = (freshness_lifetime > current_age) + + + + + + +Fielding, et al. Standards Track [Page 83] + +RFC 2616 HTTP/1.1 June 1999 + + +13.2.5 Disambiguating Expiration Values + + Because expiration values are assigned optimistically, it is possible + for two caches to contain fresh values for the same resource that are + different. + + If a client performing a retrieval receives a non-first-hand response + for a request that was already fresh in its own cache, and the Date + header in its existing cache entry is newer than the Date on the new + response, then the client MAY ignore the response. If so, it MAY + retry the request with a "Cache-Control: max-age=0" directive (see + section 14.9), to force a check with the origin server. + + If a cache has two fresh responses for the same representation with + different validators, it MUST use the one with the more recent Date + header. This situation might arise because the cache is pooling + responses from other caches, or because a client has asked for a + reload or a revalidation of an apparently fresh cache entry. + +13.2.6 Disambiguating Multiple Responses + + Because a client might be receiving responses via multiple paths, so + that some responses flow through one set of caches and other + responses flow through a different set of caches, a client might + receive responses in an order different from that in which the origin + server sent them. We would like the client to use the most recently + generated response, even if older responses are still apparently + fresh. + + Neither the entity tag nor the expiration value can impose an + ordering on responses, since it is possible that a later response + intentionally carries an earlier expiration time. The Date values are + ordered to a granularity of one second. + + When a client tries to revalidate a cache entry, and the response it + receives contains a Date header that appears to be older than the one + for the existing entry, then the client SHOULD repeat the request + unconditionally, and include + + Cache-Control: max-age=0 + + to force any intermediate caches to validate their copies directly + with the origin server, or + + Cache-Control: no-cache + + to force any intermediate caches to obtain a new copy from the origin + server. + + + +Fielding, et al. Standards Track [Page 84] + +RFC 2616 HTTP/1.1 June 1999 + + + If the Date values are equal, then the client MAY use either response + (or MAY, if it is being extremely prudent, request a new response). + Servers MUST NOT depend on clients being able to choose + deterministically between responses generated during the same second, + if their expiration times overlap. + +13.3 Validation Model + + When a cache has a stale entry that it would like to use as a + response to a client's request, it first has to check with the origin + server (or possibly an intermediate cache with a fresh response) to + see if its cached entry is still usable. We call this "validating" + the cache entry. Since we do not want to have to pay the overhead of + retransmitting the full response if the cached entry is good, and we + do not want to pay the overhead of an extra round trip if the cached + entry is invalid, the HTTP/1.1 protocol supports the use of + conditional methods. + + The key protocol features for supporting conditional methods are + those concerned with "cache validators." When an origin server + generates a full response, it attaches some sort of validator to it, + which is kept with the cache entry. When a client (user agent or + proxy cache) makes a conditional request for a resource for which it + has a cache entry, it includes the associated validator in the + request. + + The server then checks that validator against the current validator + for the entity, and, if they match (see section 13.3.3), it responds + with a special status code (usually, 304 (Not Modified)) and no + entity-body. Otherwise, it returns a full response (including + entity-body). Thus, we avoid transmitting the full response if the + validator matches, and we avoid an extra round trip if it does not + match. + + In HTTP/1.1, a conditional request looks exactly the same as a normal + request for the same resource, except that it carries a special + header (which includes the validator) that implicitly turns the + method (usually, GET) into a conditional. + + The protocol includes both positive and negative senses of cache- + validating conditions. That is, it is possible to request either that + a method be performed if and only if a validator matches or if and + only if no validators match. + + + + + + + + +Fielding, et al. Standards Track [Page 85] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: a response that lacks a validator may still be cached, and + served from cache until it expires, unless this is explicitly + prohibited by a cache-control directive. However, a cache cannot + do a conditional retrieval if it does not have a validator for the + entity, which means it will not be refreshable after it expires. + +13.3.1 Last-Modified Dates + + The Last-Modified entity-header field value is often used as a cache + validator. In simple terms, a cache entry is considered to be valid + if the entity has not been modified since the Last-Modified value. + +13.3.2 Entity Tag Cache Validators + + The ETag response-header field value, an entity tag, provides for an + "opaque" cache validator. This might allow more reliable validation + in situations where it is inconvenient to store modification dates, + where the one-second resolution of HTTP date values is not + sufficient, or where the origin server wishes to avoid certain + paradoxes that might arise from the use of modification dates. + + Entity Tags are described in section 3.11. The headers used with + entity tags are described in sections 14.19, 14.24, 14.26 and 14.44. + +13.3.3 Weak and Strong Validators + + Since both origin servers and caches will compare two validators to + decide if they represent the same or different entities, one normally + would expect that if the entity (the entity-body or any entity- + headers) changes in any way, then the associated validator would + change as well. If this is true, then we call this validator a + "strong validator." + + However, there might be cases when a server prefers to change the + validator only on semantically significant changes, and not when + insignificant aspects of the entity change. A validator that does not + always change when the resource changes is a "weak validator." + + Entity tags are normally "strong validators," but the protocol + provides a mechanism to tag an entity tag as "weak." One can think of + a strong validator as one that changes whenever the bits of an entity + changes, while a weak value changes whenever the meaning of an entity + changes. Alternatively, one can think of a strong validator as part + of an identifier for a specific entity, while a weak validator is + part of an identifier for a set of semantically equivalent entities. + + Note: One example of a strong validator is an integer that is + incremented in stable storage every time an entity is changed. + + + +Fielding, et al. Standards Track [Page 86] + +RFC 2616 HTTP/1.1 June 1999 + + + An entity's modification time, if represented with one-second + resolution, could be a weak validator, since it is possible that + the resource might be modified twice during a single second. + + Support for weak validators is optional. However, weak validators + allow for more efficient caching of equivalent objects; for + example, a hit counter on a site is probably good enough if it is + updated every few days or weeks, and any value during that period + is likely "good enough" to be equivalent. + + A "use" of a validator is either when a client generates a request + and includes the validator in a validating header field, or when a + server compares two validators. + + Strong validators are usable in any context. Weak validators are only + usable in contexts that do not depend on exact equality of an entity. + For example, either kind is usable for a conditional GET of a full + entity. However, only a strong validator is usable for a sub-range + retrieval, since otherwise the client might end up with an internally + inconsistent entity. + + Clients MAY issue simple (non-subrange) GET requests with either weak + validators or strong validators. Clients MUST NOT use weak validators + in other forms of request. + + The only function that the HTTP/1.1 protocol defines on validators is + comparison. There are two validator comparison functions, depending + on whether the comparison context allows the use of weak validators + or not: + + - The strong comparison function: in order to be considered equal, + both validators MUST be identical in every way, and both MUST + NOT be weak. + + - The weak comparison function: in order to be considered equal, + both validators MUST be identical in every way, but either or + both of them MAY be tagged as "weak" without affecting the + result. + + An entity tag is strong unless it is explicitly tagged as weak. + Section 3.11 gives the syntax for entity tags. + + A Last-Modified time, when used as a validator in a request, is + implicitly weak unless it is possible to deduce that it is strong, + using the following rules: + + - The validator is being compared by an origin server to the + actual current validator for the entity and, + + + +Fielding, et al. Standards Track [Page 87] + +RFC 2616 HTTP/1.1 June 1999 + + + - That origin server reliably knows that the associated entity did + not change twice during the second covered by the presented + validator. + + or + + - The validator is about to be used by a client in an If- + Modified-Since or If-Unmodified-Since header, because the client + has a cache entry for the associated entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + or + + - The validator is being compared by an intermediate cache to the + validator stored in its cache entry for the entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + This method relies on the fact that if two different responses were + sent by the origin server during the same second, but both had the + same Last-Modified time, then at least one of those responses would + have a Date value equal to its Last-Modified time. The arbitrary 60- + second limit guards against the possibility that the Date and Last- + Modified values are generated from different clocks, or at somewhat + different times during the preparation of the response. An + implementation MAY use a value larger than 60 seconds, if it is + believed that 60 seconds is too short. + + If a client wishes to perform a sub-range retrieval on a value for + which it has only a Last-Modified time and no opaque validator, it + MAY do this only if the Last-Modified time is strong in the sense + described here. + + A cache or origin server receiving a conditional request, other than + a full-body GET request, MUST use the strong comparison function to + evaluate the condition. + + These rules allow HTTP/1.1 caches and clients to safely perform sub- + range retrievals on values that have been obtained from HTTP/1.0 + + + +Fielding, et al. Standards Track [Page 88] + +RFC 2616 HTTP/1.1 June 1999 + + + servers. + +13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates + + We adopt a set of rules and recommendations for origin servers, + clients, and caches regarding when various validator types ought to + be used, and for what purposes. + + HTTP/1.1 origin servers: + + - SHOULD send an entity tag validator unless it is not feasible to + generate one. + + - MAY send a weak entity tag instead of a strong entity tag, if + performance considerations support the use of weak entity tags, + or if it is unfeasible to send a strong entity tag. + + - SHOULD send a Last-Modified value if it is feasible to send one, + unless the risk of a breakdown in semantic transparency that + could result from using this date in an If-Modified-Since header + would lead to serious problems. + + In other words, the preferred behavior for an HTTP/1.1 origin server + is to send both a strong entity tag and a Last-Modified value. + + In order to be legal, a strong entity tag MUST change whenever the + associated entity value changes in any way. A weak entity tag SHOULD + change whenever the associated entity changes in a semantically + significant way. + + Note: in order to provide semantically transparent caching, an + origin server must avoid reusing a specific strong entity tag + value for two different entities, or reusing a specific weak + entity tag value for two semantically different entities. Cache + entries might persist for arbitrarily long periods, regardless of + expiration times, so it might be inappropriate to expect that a + cache will never again attempt to validate an entry using a + validator that it obtained at some point in the past. + + HTTP/1.1 clients: + + - If an entity tag has been provided by the origin server, MUST + use that entity tag in any cache-conditional request (using If- + Match or If-None-Match). + + - If only a Last-Modified value has been provided by the origin + server, SHOULD use that value in non-subrange cache-conditional + requests (using If-Modified-Since). + + + +Fielding, et al. Standards Track [Page 89] + +RFC 2616 HTTP/1.1 June 1999 + + + - If only a Last-Modified value has been provided by an HTTP/1.0 + origin server, MAY use that value in subrange cache-conditional + requests (using If-Unmodified-Since:). The user agent SHOULD + provide a way to disable this, in case of difficulty. + + - If both an entity tag and a Last-Modified value have been + provided by the origin server, SHOULD use both validators in + cache-conditional requests. This allows both HTTP/1.0 and + HTTP/1.1 caches to respond appropriately. + + An HTTP/1.1 origin server, upon receiving a conditional request that + includes both a Last-Modified date (e.g., in an If-Modified-Since or + If-Unmodified-Since header field) and one or more entity tags (e.g., + in an If-Match, If-None-Match, or If-Range header field) as cache + validators, MUST NOT return a response status of 304 (Not Modified) + unless doing so is consistent with all of the conditional header + fields in the request. + + An HTTP/1.1 caching proxy, upon receiving a conditional request that + includes both a Last-Modified date and one or more entity tags as + cache validators, MUST NOT return a locally cached response to the + client unless that cached response is consistent with all of the + conditional header fields in the request. + + Note: The general principle behind these rules is that HTTP/1.1 + servers and clients should transmit as much non-redundant + information as is available in their responses and requests. + HTTP/1.1 systems receiving this information will make the most + conservative assumptions about the validators they receive. + + HTTP/1.0 clients and caches will ignore entity tags. Generally, + last-modified values received or used by these systems will + support transparent and efficient caching, and so HTTP/1.1 origin + servers should provide Last-Modified values. In those rare cases + where the use of a Last-Modified value as a validator by an + HTTP/1.0 system could result in a serious problem, then HTTP/1.1 + origin servers should not provide one. + +13.3.5 Non-validating Conditionals + + The principle behind entity tags is that only the service author + knows the semantics of a resource well enough to select an + appropriate cache validation mechanism, and the specification of any + validator comparison function more complex than byte-equality would + open up a can of worms. Thus, comparisons of any other headers + (except Last-Modified, for compatibility with HTTP/1.0) are never + used for purposes of validating a cache entry. + + + + +Fielding, et al. Standards Track [Page 90] + +RFC 2616 HTTP/1.1 June 1999 + + +13.4 Response Cacheability + + Unless specifically constrained by a cache-control (section 14.9) + directive, a caching system MAY always store a successful response + (see section 13.8) as a cache entry, MAY return it without validation + if it is fresh, and MAY return it after successful validation. If + there is neither a cache validator nor an explicit expiration time + associated with a response, we do not expect it to be cached, but + certain caches MAY violate this expectation (for example, when little + or no network connectivity is available). A client can usually detect + that such a response was taken from a cache by comparing the Date + header to the current time. + + Note: some HTTP/1.0 caches are known to violate this expectation + without providing any Warning. + + However, in some cases it might be inappropriate for a cache to + retain an entity, or to return it in response to a subsequent + request. This might be because absolute semantic transparency is + deemed necessary by the service author, or because of security or + privacy considerations. Certain cache-control directives are + therefore provided so that the server can indicate that certain + resource entities, or portions thereof, are not to be cached + regardless of other considerations. + + Note that section 14.8 normally prevents a shared cache from saving + and returning a response to a previous request if that request + included an Authorization header. + + A response received with a status code of 200, 203, 206, 300, 301 or + 410 MAY be stored by a cache and used in reply to a subsequent + request, subject to the expiration mechanism, unless a cache-control + directive prohibits caching. However, a cache that does not support + the Range and Content-Range headers MUST NOT cache 206 (Partial + Content) responses. + + A response received with any other status code (e.g. status codes 302 + and 307) MUST NOT be returned in a reply to a subsequent request + unless there are cache-control directives or another header(s) that + explicitly allow it. For example, these include the following: an + Expires header (section 14.21); a "max-age", "s-maxage", "must- + revalidate", "proxy-revalidate", "public" or "private" cache-control + directive (section 14.9). + + + + + + + + +Fielding, et al. Standards Track [Page 91] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5 Constructing Responses From Caches + + The purpose of an HTTP cache is to store information received in + response to requests for use in responding to future requests. In + many cases, a cache simply returns the appropriate parts of a + response to the requester. However, if the cache holds a cache entry + based on a previous response, it might have to combine parts of a new + response with what is held in the cache entry. + +13.5.1 End-to-end and Hop-by-hop Headers + + For the purpose of defining the behavior of caches and non-caching + proxies, we divide HTTP headers into two categories: + + - End-to-end headers, which are transmitted to the ultimate + recipient of a request or response. End-to-end headers in + responses MUST be stored as part of a cache entry and MUST be + transmitted in any response formed from a cache entry. + + - Hop-by-hop headers, which are meaningful only for a single + transport-level connection, and are not stored by caches or + forwarded by proxies. + + The following HTTP/1.1 headers are hop-by-hop headers: + + - Connection + - Keep-Alive + - Proxy-Authenticate + - Proxy-Authorization + - TE + - Trailers + - Transfer-Encoding + - Upgrade + + All other headers defined by HTTP/1.1 are end-to-end headers. + + Other hop-by-hop headers MUST be listed in a Connection header, + (section 14.10) to be introduced into HTTP/1.1 (or later). + +13.5.2 Non-modifiable Headers + + Some features of the HTTP/1.1 protocol, such as Digest + Authentication, depend on the value of certain end-to-end headers. A + transparent proxy SHOULD NOT modify an end-to-end header unless the + definition of that header requires or specifically allows that. + + + + + + +Fielding, et al. Standards Track [Page 92] + +RFC 2616 HTTP/1.1 June 1999 + + + A transparent proxy MUST NOT modify any of the following fields in a + request or response, and it MUST NOT add any of these fields if not + already present: + + - Content-Location + + - Content-MD5 + + - ETag + + - Last-Modified + + A transparent proxy MUST NOT modify any of the following fields in a + response: + + - Expires + + but it MAY add any of these fields if not already present. If an + Expires header is added, it MUST be given a field-value identical to + that of the Date header in that response. + + A proxy MUST NOT modify or add any of the following fields in a + message that contains the no-transform cache-control directive, or in + any request: + + - Content-Encoding + + - Content-Range + + - Content-Type + + A non-transparent proxy MAY modify or add these fields to a message + that does not include no-transform, but if it does so, it MUST add a + Warning 214 (Transformation applied) if one does not already appear + in the message (see section 14.46). + + Warning: unnecessary modification of end-to-end headers might + cause authentication failures if stronger authentication + mechanisms are introduced in later versions of HTTP. Such + authentication mechanisms MAY rely on the values of header fields + not listed here. + + The Content-Length field of a request or response is added or deleted + according to the rules in section 4.4. A transparent proxy MUST + preserve the entity-length (section 7.2.2) of the entity-body, + although it MAY change the transfer-length (section 4.4). + + + + + +Fielding, et al. Standards Track [Page 93] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.3 Combining Headers + + When a cache makes a validating request to a server, and the server + provides a 304 (Not Modified) response or a 206 (Partial Content) + response, the cache then constructs a response to send to the + requesting client. + + If the status code is 304 (Not Modified), the cache uses the entity- + body stored in the cache entry as the entity-body of this outgoing + response. If the status code is 206 (Partial Content) and the ETag or + Last-Modified headers match exactly, the cache MAY combine the + contents stored in the cache entry with the new contents received in + the response and use the result as the entity-body of this outgoing + response, (see 13.5.4). + + The end-to-end headers stored in the cache entry are used for the + constructed response, except that + + - any stored Warning headers with warn-code 1xx (see section + 14.46) MUST be deleted from the cache entry and the forwarded + response. + + - any stored Warning headers with warn-code 2xx MUST be retained + in the cache entry and the forwarded response. + + - any end-to-end headers provided in the 304 or 206 response MUST + replace the corresponding headers from the cache entry. + + Unless the cache decides to remove the cache entry, it MUST also + replace the end-to-end headers stored with the cache entry with + corresponding headers received in the incoming response, except for + Warning headers as described immediately above. If a header field- + name in the incoming response matches more than one header in the + cache entry, all such old headers MUST be replaced. + + In other words, the set of end-to-end headers received in the + incoming response overrides all corresponding end-to-end headers + stored with the cache entry (except for stored Warning headers with + warn-code 1xx, which are deleted even if not overridden). + + Note: this rule allows an origin server to use a 304 (Not + Modified) or a 206 (Partial Content) response to update any header + associated with a previous response for the same entity or sub- + ranges thereof, although it might not always be meaningful or + correct to do so. This rule does not allow an origin server to use + a 304 (Not Modified) or a 206 (Partial Content) response to + entirely delete a header that it had provided with a previous + response. + + + +Fielding, et al. Standards Track [Page 94] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.4 Combining Byte Ranges + + A response might transfer only a subrange of the bytes of an entity- + body, either because the request included one or more Range + specifications, or because a connection was broken prematurely. After + several such transfers, a cache might have received several ranges of + the same entity-body. + + If a cache has a stored non-empty set of subranges for an entity, and + an incoming response transfers another subrange, the cache MAY + combine the new subrange with the existing set if both the following + conditions are met: + + - Both the incoming response and the cache entry have a cache + validator. + + - The two cache validators match using the strong comparison + function (see section 13.3.3). + + If either requirement is not met, the cache MUST use only the most + recent partial response (based on the Date values transmitted with + every response, and using the incoming response if these values are + equal or missing), and MUST discard the other partial information. + +13.6 Caching Negotiated Responses + + Use of server-driven content negotiation (section 12.1), as indicated + by the presence of a Vary header field in a response, alters the + conditions and procedure by which a cache can use the response for + subsequent requests. See section 14.44 for use of the Vary header + field by servers. + + A server SHOULD use the Vary header field to inform a cache of what + request-header fields were used to select among multiple + representations of a cacheable response subject to server-driven + negotiation. The set of header fields named by the Vary field value + is known as the "selecting" request-headers. + + When the cache receives a subsequent request whose Request-URI + specifies one or more cache entries including a Vary header field, + the cache MUST NOT use such a cache entry to construct a response to + the new request unless all of the selecting request-headers present + in the new request match the corresponding stored request-headers in + the original request. + + The selecting request-headers from two requests are defined to match + if and only if the selecting request-headers in the first request can + be transformed to the selecting request-headers in the second request + + + +Fielding, et al. Standards Track [Page 95] + +RFC 2616 HTTP/1.1 June 1999 + + + by adding or removing linear white space (LWS) at places where this + is allowed by the corresponding BNF, and/or combining multiple + message-header fields with the same field name following the rules + about message headers in section 4.2. + + A Vary header field-value of "*" always fails to match and subsequent + requests on that resource can only be properly interpreted by the + origin server. + + If the selecting request header fields for the cached entry do not + match the selecting request header fields of the new request, then + the cache MUST NOT use a cached entry to satisfy the request unless + it first relays the new request to the origin server in a conditional + request and the server responds with 304 (Not Modified), including an + entity tag or Content-Location that indicates the entity to be used. + + If an entity tag was assigned to a cached representation, the + forwarded request SHOULD be conditional and include the entity tags + in an If-None-Match header field from all its cache entries for the + resource. This conveys to the server the set of entities currently + held by the cache, so that if any one of these entities matches the + requested entity, the server can use the ETag header field in its 304 + (Not Modified) response to tell the cache which entry is appropriate. + If the entity-tag of the new response matches that of an existing + entry, the new response SHOULD be used to update the header fields of + the existing entry, and the result MUST be returned to the client. + + If any of the existing cache entries contains only partial content + for the associated entity, its entity-tag SHOULD NOT be included in + the If-None-Match header field unless the request is for a range that + would be fully satisfied by that entry. + + If a cache receives a successful response whose Content-Location + field matches that of an existing cache entry for the same Request- + ]URI, whose entity-tag differs from that of the existing entry, and + whose Date is more recent than that of the existing entry, the + existing entry SHOULD NOT be returned in response to future requests + and SHOULD be deleted from the cache. + +13.7 Shared and Non-Shared Caches + + For reasons of security and privacy, it is necessary to make a + distinction between "shared" and "non-shared" caches. A non-shared + cache is one that is accessible only to a single user. Accessibility + in this case SHOULD be enforced by appropriate security mechanisms. + All other caches are considered to be "shared." Other sections of + + + + + +Fielding, et al. Standards Track [Page 96] + +RFC 2616 HTTP/1.1 June 1999 + + + this specification place certain constraints on the operation of + shared caches in order to prevent loss of privacy or failure of + access controls. + +13.8 Errors or Incomplete Response Cache Behavior + + A cache that receives an incomplete response (for example, with fewer + bytes of data than specified in a Content-Length header) MAY store + the response. However, the cache MUST treat this as a partial + response. Partial responses MAY be combined as described in section + 13.5.4; the result might be a full response or might still be + partial. A cache MUST NOT return a partial response to a client + without explicitly marking it as such, using the 206 (Partial + Content) status code. A cache MUST NOT return a partial response + using a status code of 200 (OK). + + If a cache receives a 5xx response while attempting to revalidate an + entry, it MAY either forward this response to the requesting client, + or act as if the server failed to respond. In the latter case, it MAY + return a previously received response unless the cached entry + includes the "must-revalidate" cache-control directive (see section + 14.9). + +13.9 Side Effects of GET and HEAD + + Unless the origin server explicitly prohibits the caching of their + responses, the application of GET and HEAD methods to any resources + SHOULD NOT have side effects that would lead to erroneous behavior if + these responses are taken from a cache. They MAY still have side + effects, but a cache is not required to consider such side effects in + its caching decisions. Caches are always expected to observe an + origin server's explicit restrictions on caching. + + We note one exception to this rule: since some applications have + traditionally used GETs and HEADs with query URLs (those containing a + "?" in the rel_path part) to perform operations with significant side + effects, caches MUST NOT treat responses to such URIs as fresh unless + the server provides an explicit expiration time. This specifically + means that responses from HTTP/1.0 servers for such URIs SHOULD NOT + be taken from a cache. See section 9.1.1 for related information. + +13.10 Invalidation After Updates or Deletions + + The effect of certain methods performed on a resource at the origin + server might cause one or more existing cache entries to become non- + transparently invalid. That is, although they might continue to be + "fresh," they do not accurately reflect what the origin server would + return for a new request on that resource. + + + +Fielding, et al. Standards Track [Page 97] + +RFC 2616 HTTP/1.1 June 1999 + + + There is no way for the HTTP protocol to guarantee that all such + cache entries are marked invalid. For example, the request that + caused the change at the origin server might not have gone through + the proxy where a cache entry is stored. However, several rules help + reduce the likelihood of erroneous behavior. + + In this section, the phrase "invalidate an entity" means that the + cache will either remove all instances of that entity from its + storage, or will mark these as "invalid" and in need of a mandatory + revalidation before they can be returned in response to a subsequent + request. + + Some HTTP methods MUST cause a cache to invalidate an entity. This is + either the entity referred to by the Request-URI, or by the Location + or Content-Location headers (if present). These methods are: + + - PUT + + - DELETE + + - POST + + In order to prevent denial of service attacks, an invalidation based + on the URI in a Location or Content-Location header MUST only be + performed if the host part is the same as in the Request-URI. + + A cache that passes through requests for methods it does not + understand SHOULD invalidate any entities referred to by the + Request-URI. + +13.11 Write-Through Mandatory + + All methods that might be expected to cause modifications to the + origin server's resources MUST be written through to the origin + server. This currently includes all methods except for GET and HEAD. + A cache MUST NOT reply to such a request from a client before having + transmitted the request to the inbound server, and having received a + corresponding response from the inbound server. This does not prevent + a proxy cache from sending a 100 (Continue) response before the + inbound server has sent its final reply. + + The alternative (known as "write-back" or "copy-back" caching) is not + allowed in HTTP/1.1, due to the difficulty of providing consistent + updates and the problems arising from server, cache, or network + failure prior to write-back. + + + + + + +Fielding, et al. Standards Track [Page 98] + +RFC 2616 HTTP/1.1 June 1999 + + +13.12 Cache Replacement + + If a new cacheable (see sections 14.9.2, 13.2.5, 13.2.6 and 13.8) + response is received from a resource while any existing responses for + the same resource are cached, the cache SHOULD use the new response + to reply to the current request. It MAY insert it into cache storage + and MAY, if it meets all other requirements, use it to respond to any + future requests that would previously have caused the old response to + be returned. If it inserts the new response into cache storage the + rules in section 13.5.3 apply. + + Note: a new response that has an older Date header value than + existing cached responses is not cacheable. + +13.13 History Lists + + User agents often have history mechanisms, such as "Back" buttons and + history lists, which can be used to redisplay an entity retrieved + earlier in a session. + + History mechanisms and caches are different. In particular history + mechanisms SHOULD NOT try to show a semantically transparent view of + the current state of a resource. Rather, a history mechanism is meant + to show exactly what the user saw at the time when the resource was + retrieved. + + By default, an expiration time does not apply to history mechanisms. + If the entity is still in storage, a history mechanism SHOULD display + it even if the entity has expired, unless the user has specifically + configured the agent to refresh expired history documents. + + This is not to be construed to prohibit the history mechanism from + telling the user that a view might be stale. + + Note: if history list mechanisms unnecessarily prevent users from + viewing stale resources, this will tend to force service authors + to avoid using HTTP expiration controls and cache controls when + they would otherwise like to. Service authors may consider it + important that users not be presented with error messages or + warning messages when they use navigation controls (such as BACK) + to view previously fetched resources. Even though sometimes such + resources ought not to cached, or ought to expire quickly, user + interface considerations may force service authors to resort to + other means of preventing caching (e.g. "once-only" URLs) in order + not to suffer the effects of improperly functioning history + mechanisms. + + + + + +Fielding, et al. Standards Track [Page 99] + +RFC 2616 HTTP/1.1 June 1999 + + +14 Header Field Definitions + + This section defines the syntax and semantics of all standard + HTTP/1.1 header fields. For entity-header fields, both sender and + recipient refer to either the client or the server, depending on who + sends and who receives the entity. + +14.1 Accept + + The Accept request-header field can be used to specify certain media + types which are acceptable for the response. Accept headers can be + used to indicate that the request is specifically limited to a small + set of desired types, as in the case of a request for an in-line + image. + + Accept = "Accept" ":" + #( media-range [ accept-params ] ) + + media-range = ( "*/*" + | ( type "/" "*" ) + | ( type "/" subtype ) + ) *( ";" parameter ) + accept-params = ";" "q" "=" qvalue *( accept-extension ) + accept-extension = ";" token [ "=" ( token | quoted-string ) ] + + The asterisk "*" character is used to group media types into ranges, + with "*/*" indicating all media types and "type/*" indicating all + subtypes of that type. The media-range MAY include media type + parameters that are applicable to that range. + + Each media-range MAY be followed by one or more accept-params, + beginning with the "q" parameter for indicating a relative quality + factor. The first "q" parameter (if any) separates the media-range + parameter(s) from the accept-params. Quality factors allow the user + or user agent to indicate the relative degree of preference for that + media-range, using the qvalue scale from 0 to 1 (section 3.9). The + default value is q=1. + + Note: Use of the "q" parameter name to separate media type + parameters from Accept extension parameters is due to historical + practice. Although this prevents any media type parameter named + "q" from being used with a media range, such an event is believed + to be unlikely given the lack of any "q" parameters in the IANA + media type registry and the rare usage of any media type + parameters in Accept. Future media types are discouraged from + registering any parameter named "q". + + + + + +Fielding, et al. Standards Track [Page 100] + +RFC 2616 HTTP/1.1 June 1999 + + + The example + + Accept: audio/*; q=0.2, audio/basic + + SHOULD be interpreted as "I prefer audio/basic, but send me any audio + type if it is the best available after an 80% mark-down in quality." + + If no Accept header field is present, then it is assumed that the + client accepts all media types. If an Accept header field is present, + and if the server cannot send a response which is acceptable + according to the combined Accept field value, then the server SHOULD + send a 406 (not acceptable) response. + + A more elaborate example is + + Accept: text/plain; q=0.5, text/html, + text/x-dvi; q=0.8, text/x-c + + Verbally, this would be interpreted as "text/html and text/x-c are + the preferred media types, but if they do not exist, then send the + text/x-dvi entity, and if that does not exist, send the text/plain + entity." + + Media ranges can be overridden by more specific media ranges or + specific media types. If more than one media range applies to a given + type, the most specific reference has precedence. For example, + + Accept: text/*, text/html, text/html;level=1, */* + + have the following precedence: + + 1) text/html;level=1 + 2) text/html + 3) text/* + 4) */* + + The media type quality factor associated with a given type is + determined by finding the media range with the highest precedence + which matches that type. For example, + + Accept: text/*;q=0.3, text/html;q=0.7, text/html;level=1, + text/html;level=2;q=0.4, */*;q=0.5 + + would cause the following values to be associated: + + text/html;level=1 = 1 + text/html = 0.7 + text/plain = 0.3 + + + +Fielding, et al. Standards Track [Page 101] + +RFC 2616 HTTP/1.1 June 1999 + + + image/jpeg = 0.5 + text/html;level=2 = 0.4 + text/html;level=3 = 0.7 + + Note: A user agent might be provided with a default set of quality + values for certain media ranges. However, unless the user agent is + a closed system which cannot interact with other rendering agents, + this default set ought to be configurable by the user. + +14.2 Accept-Charset + + The Accept-Charset request-header field can be used to indicate what + character sets are acceptable for the response. This field allows + clients capable of understanding more comprehensive or special- + purpose character sets to signal that capability to a server which is + capable of representing documents in those character sets. + + Accept-Charset = "Accept-Charset" ":" + 1#( ( charset | "*" )[ ";" "q" "=" qvalue ] ) + + + Character set values are described in section 3.4. Each charset MAY + be given an associated quality value which represents the user's + preference for that charset. The default value is q=1. An example is + + Accept-Charset: iso-8859-5, unicode-1-1;q=0.8 + + The special value "*", if present in the Accept-Charset field, + matches every character set (including ISO-8859-1) which is not + mentioned elsewhere in the Accept-Charset field. If no "*" is present + in an Accept-Charset field, then all character sets not explicitly + mentioned get a quality value of 0, except for ISO-8859-1, which gets + a quality value of 1 if not explicitly mentioned. + + If no Accept-Charset header is present, the default is that any + character set is acceptable. If an Accept-Charset header is present, + and if the server cannot send a response which is acceptable + according to the Accept-Charset header, then the server SHOULD send + an error response with the 406 (not acceptable) status code, though + the sending of an unacceptable response is also allowed. + +14.3 Accept-Encoding + + The Accept-Encoding request-header field is similar to Accept, but + restricts the content-codings (section 3.5) that are acceptable in + the response. + + Accept-Encoding = "Accept-Encoding" ":" + + + +Fielding, et al. Standards Track [Page 102] + +RFC 2616 HTTP/1.1 June 1999 + + + 1#( codings [ ";" "q" "=" qvalue ] ) + codings = ( content-coding | "*" ) + + Examples of its use are: + + Accept-Encoding: compress, gzip + Accept-Encoding: + Accept-Encoding: * + Accept-Encoding: compress;q=0.5, gzip;q=1.0 + Accept-Encoding: gzip;q=1.0, identity; q=0.5, *;q=0 + + A server tests whether a content-coding is acceptable, according to + an Accept-Encoding field, using these rules: + + 1. If the content-coding is one of the content-codings listed in + the Accept-Encoding field, then it is acceptable, unless it is + accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + 2. The special "*" symbol in an Accept-Encoding field matches any + available content-coding not explicitly listed in the header + field. + + 3. If multiple content-codings are acceptable, then the acceptable + content-coding with the highest non-zero qvalue is preferred. + + 4. The "identity" content-coding is always acceptable, unless + specifically refused because the Accept-Encoding field includes + "identity;q=0", or because the field includes "*;q=0" and does + not explicitly include the "identity" content-coding. If the + Accept-Encoding field-value is empty, then only the "identity" + encoding is acceptable. + + If an Accept-Encoding field is present in a request, and if the + server cannot send a response which is acceptable according to the + Accept-Encoding header, then the server SHOULD send an error response + with the 406 (Not Acceptable) status code. + + If no Accept-Encoding field is present in a request, the server MAY + assume that the client will accept any content coding. In this case, + if "identity" is one of the available content-codings, then the + server SHOULD use the "identity" content-coding, unless it has + additional information that a different content-coding is meaningful + to the client. + + Note: If the request does not include an Accept-Encoding field, + and if the "identity" content-coding is unavailable, then + content-codings commonly understood by HTTP/1.0 clients (i.e., + + + +Fielding, et al. Standards Track [Page 103] + +RFC 2616 HTTP/1.1 June 1999 + + + "gzip" and "compress") are preferred; some older clients + improperly display messages sent with other content-codings. The + server might also make this decision based on information about + the particular user-agent or client. + + Note: Most HTTP/1.0 applications do not recognize or obey qvalues + associated with content-codings. This means that qvalues will not + work and are not permitted with x-gzip or x-compress. + +14.4 Accept-Language + + The Accept-Language request-header field is similar to Accept, but + restricts the set of natural languages that are preferred as a + response to the request. Language tags are defined in section 3.10. + + Accept-Language = "Accept-Language" ":" + 1#( language-range [ ";" "q" "=" qvalue ] ) + language-range = ( ( 1*8ALPHA *( "-" 1*8ALPHA ) ) | "*" ) + + Each language-range MAY be given an associated quality value which + represents an estimate of the user's preference for the languages + specified by that range. The quality value defaults to "q=1". For + example, + + Accept-Language: da, en-gb;q=0.8, en;q=0.7 + + would mean: "I prefer Danish, but will accept British English and + other types of English." A language-range matches a language-tag if + it exactly equals the tag, or if it exactly equals a prefix of the + tag such that the first tag character following the prefix is "-". + The special range "*", if present in the Accept-Language field, + matches every tag not matched by any other range present in the + Accept-Language field. + + Note: This use of a prefix matching rule does not imply that + language tags are assigned to languages in such a way that it is + always true that if a user understands a language with a certain + tag, then this user will also understand all languages with tags + for which this tag is a prefix. The prefix rule simply allows the + use of prefix tags if this is the case. + + The language quality factor assigned to a language-tag by the + Accept-Language field is the quality value of the longest language- + range in the field that matches the language-tag. If no language- + range in the field matches the tag, the language quality factor + assigned is 0. If no Accept-Language header is present in the + request, the server + + + + +Fielding, et al. Standards Track [Page 104] + +RFC 2616 HTTP/1.1 June 1999 + + + SHOULD assume that all languages are equally acceptable. If an + Accept-Language header is present, then all languages which are + assigned a quality factor greater than 0 are acceptable. + + It might be contrary to the privacy expectations of the user to send + an Accept-Language header with the complete linguistic preferences of + the user in every request. For a discussion of this issue, see + section 15.1.4. + + As intelligibility is highly dependent on the individual user, it is + recommended that client applications make the choice of linguistic + preference available to the user. If the choice is not made + available, then the Accept-Language header field MUST NOT be given in + the request. + + Note: When making the choice of linguistic preference available to + the user, we remind implementors of the fact that users are not + familiar with the details of language matching as described above, + and should provide appropriate guidance. As an example, users + might assume that on selecting "en-gb", they will be served any + kind of English document if British English is not available. A + user agent might suggest in such a case to add "en" to get the + best matching behavior. + +14.5 Accept-Ranges + + The Accept-Ranges response-header field allows the server to + indicate its acceptance of range requests for a resource: + + Accept-Ranges = "Accept-Ranges" ":" acceptable-ranges + acceptable-ranges = 1#range-unit | "none" + + Origin servers that accept byte-range requests MAY send + + Accept-Ranges: bytes + + but are not required to do so. Clients MAY generate byte-range + requests without having received this header for the resource + involved. Range units are defined in section 3.12. + + Servers that do not accept any kind of range request for a + resource MAY send + + Accept-Ranges: none + + to advise the client not to attempt a range request. + + + + + +Fielding, et al. Standards Track [Page 105] + +RFC 2616 HTTP/1.1 June 1999 + + +14.6 Age + + The Age response-header field conveys the sender's estimate of the + amount of time since the response (or its revalidation) was + generated at the origin server. A cached response is "fresh" if + its age does not exceed its freshness lifetime. Age values are + calculated as specified in section 13.2.3. + + Age = "Age" ":" age-value + age-value = delta-seconds + + Age values are non-negative decimal integers, representing time in + seconds. + + If a cache receives a value larger than the largest positive + integer it can represent, or if any of its age calculations + overflows, it MUST transmit an Age header with a value of + 2147483648 (2^31). An HTTP/1.1 server that includes a cache MUST + include an Age header field in every response generated from its + own cache. Caches SHOULD use an arithmetic type of at least 31 + bits of range. + +14.7 Allow + + The Allow entity-header field lists the set of methods supported + by the resource identified by the Request-URI. The purpose of this + field is strictly to inform the recipient of valid methods + associated with the resource. An Allow header field MUST be + present in a 405 (Method Not Allowed) response. + + Allow = "Allow" ":" #Method + + Example of use: + + Allow: GET, HEAD, PUT + + This field cannot prevent a client from trying other methods. + However, the indications given by the Allow header field value + SHOULD be followed. The actual set of allowed methods is defined + by the origin server at the time of each request. + + The Allow header field MAY be provided with a PUT request to + recommend the methods to be supported by the new or modified + resource. The server is not required to support these methods and + SHOULD include an Allow header in the response giving the actual + supported methods. + + + + + +Fielding, et al. Standards Track [Page 106] + +RFC 2616 HTTP/1.1 June 1999 + + + A proxy MUST NOT modify the Allow header field even if it does not + understand all the methods specified, since the user agent might + have other means of communicating with the origin server. + +14.8 Authorization + + A user agent that wishes to authenticate itself with a server-- + usually, but not necessarily, after receiving a 401 response--does + so by including an Authorization request-header field with the + request. The Authorization field value consists of credentials + containing the authentication information of the user agent for + the realm of the resource being requested. + + Authorization = "Authorization" ":" credentials + + HTTP access authentication is described in "HTTP Authentication: + Basic and Digest Access Authentication" [43]. If a request is + authenticated and a realm specified, the same credentials SHOULD + be valid for all other requests within this realm (assuming that + the authentication scheme itself does not require otherwise, such + as credentials that vary according to a challenge value or using + synchronized clocks). + + When a shared cache (see section 13.7) receives a request + containing an Authorization field, it MUST NOT return the + corresponding response as a reply to any other request, unless one + of the following specific exceptions holds: + + 1. If the response includes the "s-maxage" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But (if the specified maximum age has + passed) a proxy cache MUST first revalidate it with the origin + server, using the request-headers from the new request to allow + the origin server to authenticate the new request. (This is the + defined behavior for s-maxage.) If the response includes "s- + maxage=0", the proxy MUST always revalidate it before re-using + it. + + 2. If the response includes the "must-revalidate" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But if the response is stale, all caches + MUST first revalidate it with the origin server, using the + request-headers from the new request to allow the origin server + to authenticate the new request. + + 3. If the response includes the "public" cache-control directive, + it MAY be returned in reply to any subsequent request. + + + + +Fielding, et al. Standards Track [Page 107] + +RFC 2616 HTTP/1.1 June 1999 + + +14.9 Cache-Control + + The Cache-Control general-header field is used to specify directives + that MUST be obeyed by all caching mechanisms along the + request/response chain. The directives specify behavior intended to + prevent caches from adversely interfering with the request or + response. These directives typically override the default caching + algorithms. Cache directives are unidirectional in that the presence + of a directive in a request does not imply that the same directive is + to be given in the response. + + Note that HTTP/1.0 caches might not implement Cache-Control and + might only implement Pragma: no-cache (see section 14.32). + + Cache directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a cache- + directive for a specific cache. + + Cache-Control = "Cache-Control" ":" 1#cache-directive + + cache-directive = cache-request-directive + | cache-response-directive + + cache-request-directive = + "no-cache" ; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "max-age" "=" delta-seconds ; Section 14.9.3, 14.9.4 + | "max-stale" [ "=" delta-seconds ] ; Section 14.9.3 + | "min-fresh" "=" delta-seconds ; Section 14.9.3 + | "no-transform" ; Section 14.9.5 + | "only-if-cached" ; Section 14.9.4 + | cache-extension ; Section 14.9.6 + + cache-response-directive = + "public" ; Section 14.9.1 + | "private" [ "=" <"> 1#field-name <"> ] ; Section 14.9.1 + | "no-cache" [ "=" <"> 1#field-name <"> ]; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "no-transform" ; Section 14.9.5 + | "must-revalidate" ; Section 14.9.4 + | "proxy-revalidate" ; Section 14.9.4 + | "max-age" "=" delta-seconds ; Section 14.9.3 + | "s-maxage" "=" delta-seconds ; Section 14.9.3 + | cache-extension ; Section 14.9.6 + + cache-extension = token [ "=" ( token | quoted-string ) ] + + + +Fielding, et al. Standards Track [Page 108] + +RFC 2616 HTTP/1.1 June 1999 + + + When a directive appears without any 1#field-name parameter, the + directive applies to the entire request or response. When such a + directive appears with a 1#field-name parameter, it applies only to + the named field or fields, and not to the rest of the request or + response. This mechanism supports extensibility; implementations of + future versions of the HTTP protocol might apply these directives to + header fields not defined in HTTP/1.1. + + The cache-control directives can be broken down into these general + categories: + + - Restrictions on what are cacheable; these may only be imposed by + the origin server. + + - Restrictions on what may be stored by a cache; these may be + imposed by either the origin server or the user agent. + + - Modifications of the basic expiration mechanism; these may be + imposed by either the origin server or the user agent. + + - Controls over cache revalidation and reload; these may only be + imposed by a user agent. + + - Control over transformation of entities. + + - Extensions to the caching system. + +14.9.1 What is Cacheable + + By default, a response is cacheable if the requirements of the + request method, request header fields, and the response status + indicate that it is cacheable. Section 13.4 summarizes these defaults + for cacheability. The following Cache-Control response directives + allow an origin server to override the default cacheability of a + response: + + public + Indicates that the response MAY be cached by any cache, even if it + would normally be non-cacheable or cacheable only within a non- + shared cache. (See also Authorization, section 14.8, for + additional details.) + + private + Indicates that all or part of the response message is intended for + a single user and MUST NOT be cached by a shared cache. This + allows an origin server to state that the specified parts of the + + + + + +Fielding, et al. Standards Track [Page 109] + +RFC 2616 HTTP/1.1 June 1999 + + + response are intended for only one user and are not a valid + response for requests by other users. A private (non-shared) cache + MAY cache the response. + + Note: This usage of the word private only controls where the + response may be cached, and cannot ensure the privacy of the + message content. + + no-cache + If the no-cache directive does not specify a field-name, then a + cache MUST NOT use the response to satisfy a subsequent request + without successful revalidation with the origin server. This + allows an origin server to prevent caching even by caches that + have been configured to return stale responses to client requests. + + If the no-cache directive does specify one or more field-names, + then a cache MAY use the response to satisfy a subsequent request, + subject to any other restrictions on caching. However, the + specified field-name(s) MUST NOT be sent in the response to a + subsequent request without successful revalidation with the origin + server. This allows an origin server to prevent the re-use of + certain header fields in a response, while still allowing caching + of the rest of the response. + + Note: Most HTTP/1.0 caches will not recognize or obey this + directive. + +14.9.2 What May be Stored by Caches + + no-store + The purpose of the no-store directive is to prevent the + inadvertent release or retention of sensitive information (for + example, on backup tapes). The no-store directive applies to the + entire message, and MAY be sent either in a response or in a + request. If sent in a request, a cache MUST NOT store any part of + either this request or any response to it. If sent in a response, + a cache MUST NOT store any part of either this response or the + request that elicited it. This directive applies to both non- + shared and shared caches. "MUST NOT store" in this context means + that the cache MUST NOT intentionally store the information in + non-volatile storage, and MUST make a best-effort attempt to + remove the information from volatile storage as promptly as + possible after forwarding it. + + Even when this directive is associated with a response, users + might explicitly store such a response outside of the caching + system (e.g., with a "Save As" dialog). History buffers MAY store + such responses as part of their normal operation. + + + +Fielding, et al. Standards Track [Page 110] + +RFC 2616 HTTP/1.1 June 1999 + + + The purpose of this directive is to meet the stated requirements + of certain users and service authors who are concerned about + accidental releases of information via unanticipated accesses to + cache data structures. While the use of this directive might + improve privacy in some cases, we caution that it is NOT in any + way a reliable or sufficient mechanism for ensuring privacy. In + particular, malicious or compromised caches might not recognize or + obey this directive, and communications networks might be + vulnerable to eavesdropping. + +14.9.3 Modifications of the Basic Expiration Mechanism + + The expiration time of an entity MAY be specified by the origin + server using the Expires header (see section 14.21). Alternatively, + it MAY be specified using the max-age directive in a response. When + the max-age cache-control directive is present in a cached response, + the response is stale if its current age is greater than the age + value given (in seconds) at the time of a new request for that + resource. The max-age directive on a response implies that the + response is cacheable (i.e., "public") unless some other, more + restrictive cache directive is also present. + + If a response includes both an Expires header and a max-age + directive, the max-age directive overrides the Expires header, even + if the Expires header is more restrictive. This rule allows an origin + server to provide, for a given response, a longer expiration time to + an HTTP/1.1 (or later) cache than to an HTTP/1.0 cache. This might be + useful if certain HTTP/1.0 caches improperly calculate ages or + expiration times, perhaps due to desynchronized clocks. + + Many HTTP/1.0 cache implementations will treat an Expires value that + is less than or equal to the response Date value as being equivalent + to the Cache-Control response directive "no-cache". If an HTTP/1.1 + cache receives such a response, and the response does not include a + Cache-Control header field, it SHOULD consider the response to be + non-cacheable in order to retain compatibility with HTTP/1.0 servers. + + Note: An origin server might wish to use a relatively new HTTP + cache control feature, such as the "private" directive, on a + network including older caches that do not understand that + feature. The origin server will need to combine the new feature + with an Expires field whose value is less than or equal to the + Date value. This will prevent older caches from improperly + caching the response. + + + + + + + +Fielding, et al. Standards Track [Page 111] + +RFC 2616 HTTP/1.1 June 1999 + + + s-maxage + If a response includes an s-maxage directive, then for a shared + cache (but not for a private cache), the maximum age specified by + this directive overrides the maximum age specified by either the + max-age directive or the Expires header. The s-maxage directive + also implies the semantics of the proxy-revalidate directive (see + section 14.9.4), i.e., that the shared cache must not use the + entry after it becomes stale to respond to a subsequent request + without first revalidating it with the origin server. The s- + maxage directive is always ignored by a private cache. + + Note that most older caches, not compliant with this specification, + do not implement any cache-control directives. An origin server + wishing to use a cache-control directive that restricts, but does not + prevent, caching by an HTTP/1.1-compliant cache MAY exploit the + requirement that the max-age directive overrides the Expires header, + and the fact that pre-HTTP/1.1-compliant caches do not observe the + max-age directive. + + Other directives allow a user agent to modify the basic expiration + mechanism. These directives MAY be specified on a request: + + max-age + Indicates that the client is willing to accept a response whose + age is no greater than the specified time in seconds. Unless max- + stale directive is also included, the client is not willing to + accept a stale response. + + min-fresh + Indicates that the client is willing to accept a response whose + freshness lifetime is no less than its current age plus the + specified time in seconds. That is, the client wants a response + that will still be fresh for at least the specified number of + seconds. + + max-stale + Indicates that the client is willing to accept a response that has + exceeded its expiration time. If max-stale is assigned a value, + then the client is willing to accept a response that has exceeded + its expiration time by no more than the specified number of + seconds. If no value is assigned to max-stale, then the client is + willing to accept a stale response of any age. + + If a cache returns a stale response, either because of a max-stale + directive on a request, or because the cache is configured to + override the expiration time of a response, the cache MUST attach a + Warning header to the stale response, using Warning 110 (Response is + stale). + + + +Fielding, et al. Standards Track [Page 112] + +RFC 2616 HTTP/1.1 June 1999 + + + A cache MAY be configured to return stale responses without + validation, but only if this does not conflict with any "MUST"-level + requirements concerning cache validation (e.g., a "must-revalidate" + cache-control directive). + + If both the new request and the cached entry include "max-age" + directives, then the lesser of the two values is used for determining + the freshness of the cached entry for that request. + +14.9.4 Cache Revalidation and Reload Controls + + Sometimes a user agent might want or need to insist that a cache + revalidate its cache entry with the origin server (and not just with + the next cache along the path to the origin server), or to reload its + cache entry from the origin server. End-to-end revalidation might be + necessary if either the cache or the origin server has overestimated + the expiration time of the cached response. End-to-end reload may be + necessary if the cache entry has become corrupted for some reason. + + End-to-end revalidation may be requested either when the client does + not have its own local cached copy, in which case we call it + "unspecified end-to-end revalidation", or when the client does have a + local cached copy, in which case we call it "specific end-to-end + revalidation." + + The client can specify these three kinds of action using Cache- + Control request directives: + + End-to-end reload + The request includes a "no-cache" cache-control directive or, for + compatibility with HTTP/1.0 clients, "Pragma: no-cache". Field + names MUST NOT be included with the no-cache directive in a + request. The server MUST NOT use a cached copy when responding to + such a request. + + Specific end-to-end revalidation + The request includes a "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request includes a cache-validating conditional with + the client's current validator. + + Unspecified end-to-end revalidation + The request includes "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request does not include a cache-validating + + + + +Fielding, et al. Standards Track [Page 113] + +RFC 2616 HTTP/1.1 June 1999 + + + conditional; the first cache along the path (if any) that holds a + cache entry for this resource includes a cache-validating + conditional with its current validator. + + max-age + When an intermediate cache is forced, by means of a max-age=0 + directive, to revalidate its own cache entry, and the client has + supplied its own validator in the request, the supplied validator + might differ from the validator currently stored with the cache + entry. In this case, the cache MAY use either validator in making + its own request without affecting semantic transparency. + + However, the choice of validator might affect performance. The + best approach is for the intermediate cache to use its own + validator when making its request. If the server replies with 304 + (Not Modified), then the cache can return its now validated copy + to the client with a 200 (OK) response. If the server replies with + a new entity and cache validator, however, the intermediate cache + can compare the returned validator with the one provided in the + client's request, using the strong comparison function. If the + client's validator is equal to the origin server's, then the + intermediate cache simply returns 304 (Not Modified). Otherwise, + it returns the new entity with a 200 (OK) response. + + If a request includes the no-cache directive, it SHOULD NOT + include min-fresh, max-stale, or max-age. + + only-if-cached + In some cases, such as times of extremely poor network + connectivity, a client may want a cache to return only those + responses that it currently has stored, and not to reload or + revalidate with the origin server. To do this, the client may + include the only-if-cached directive in a request. If it receives + this directive, a cache SHOULD either respond using a cached entry + that is consistent with the other constraints of the request, or + respond with a 504 (Gateway Timeout) status. However, if a group + of caches is being operated as a unified system with good internal + connectivity, such a request MAY be forwarded within that group of + caches. + + must-revalidate + Because a cache MAY be configured to ignore a server's specified + expiration time, and because a client request MAY include a max- + stale directive (which has a similar effect), the protocol also + includes a mechanism for the origin server to require revalidation + of a cache entry on any subsequent use. When the must-revalidate + directive is present in a response received by a cache, that cache + MUST NOT use the entry after it becomes stale to respond to a + + + +Fielding, et al. Standards Track [Page 114] + +RFC 2616 HTTP/1.1 June 1999 + + + subsequent request without first revalidating it with the origin + server. (I.e., the cache MUST do an end-to-end revalidation every + time, if, based solely on the origin server's Expires or max-age + value, the cached response is stale.) + + The must-revalidate directive is necessary to support reliable + operation for certain protocol features. In all circumstances an + HTTP/1.1 cache MUST obey the must-revalidate directive; in + particular, if the cache cannot reach the origin server for any + reason, it MUST generate a 504 (Gateway Timeout) response. + + Servers SHOULD send the must-revalidate directive if and only if + failure to revalidate a request on the entity could result in + incorrect operation, such as a silently unexecuted financial + transaction. Recipients MUST NOT take any automated action that + violates this directive, and MUST NOT automatically provide an + unvalidated copy of the entity if revalidation fails. + + Although this is not recommended, user agents operating under + severe connectivity constraints MAY violate this directive but, if + so, MUST explicitly warn the user that an unvalidated response has + been provided. The warning MUST be provided on each unvalidated + access, and SHOULD require explicit user confirmation. + + proxy-revalidate + The proxy-revalidate directive has the same meaning as the must- + revalidate directive, except that it does not apply to non-shared + user agent caches. It can be used on a response to an + authenticated request to permit the user's cache to store and + later return the response without needing to revalidate it (since + it has already been authenticated once by that user), while still + requiring proxies that service many users to revalidate each time + (in order to make sure that each user has been authenticated). + Note that such authenticated responses also need the public cache + control directive in order to allow them to be cached at all. + +14.9.5 No-Transform Directive + + no-transform + Implementors of intermediate caches (proxies) have found it useful + to convert the media type of certain entity bodies. A non- + transparent proxy might, for example, convert between image + formats in order to save cache space or to reduce the amount of + traffic on a slow link. + + Serious operational problems occur, however, when these + transformations are applied to entity bodies intended for certain + kinds of applications. For example, applications for medical + + + +Fielding, et al. Standards Track [Page 115] + +RFC 2616 HTTP/1.1 June 1999 + + + imaging, scientific data analysis and those using end-to-end + authentication, all depend on receiving an entity body that is bit + for bit identical to the original entity-body. + + Therefore, if a message includes the no-transform directive, an + intermediate cache or proxy MUST NOT change those headers that are + listed in section 13.5.2 as being subject to the no-transform + directive. This implies that the cache or proxy MUST NOT change + any aspect of the entity-body that is specified by these headers, + including the value of the entity-body itself. + +14.9.6 Cache Control Extensions + + The Cache-Control header field can be extended through the use of one + or more cache-extension tokens, each with an optional assigned value. + Informational extensions (those which do not require a change in + cache behavior) MAY be added without changing the semantics of other + directives. Behavioral extensions are designed to work by acting as + modifiers to the existing base of cache directives. Both the new + directive and the standard directive are supplied, such that + applications which do not understand the new directive will default + to the behavior specified by the standard directive, and those that + understand the new directive will recognize it as modifying the + requirements associated with the standard directive. In this way, + extensions to the cache-control directives can be made without + requiring changes to the base protocol. + + This extension mechanism depends on an HTTP cache obeying all of the + cache-control directives defined for its native HTTP-version, obeying + certain extensions, and ignoring all directives that it does not + understand. + + For example, consider a hypothetical new response directive called + community which acts as a modifier to the private directive. We + define this new directive to mean that, in addition to any non-shared + cache, any cache which is shared only by members of the community + named within its value may cache the response. An origin server + wishing to allow the UCI community to use an otherwise private + response in their shared cache(s) could do so by including + + Cache-Control: private, community="UCI" + + A cache seeing this header field will act correctly even if the cache + does not understand the community cache-extension, since it will also + see and understand the private directive and thus default to the safe + behavior. + + + + + +Fielding, et al. Standards Track [Page 116] + +RFC 2616 HTTP/1.1 June 1999 + + + Unrecognized cache-directives MUST be ignored; it is assumed that any + cache-directive likely to be unrecognized by an HTTP/1.1 cache will + be combined with standard directives (or the response's default + cacheability) such that the cache behavior will remain minimally + correct even if the cache does not understand the extension(s). + +14.10 Connection + + The Connection general-header field allows the sender to specify + options that are desired for that particular connection and MUST NOT + be communicated by proxies over further connections. + + The Connection header has the following grammar: + + Connection = "Connection" ":" 1#(connection-token) + connection-token = token + + HTTP/1.1 proxies MUST parse the Connection header field before a + message is forwarded and, for each connection-token in this field, + remove any header field(s) from the message with the same name as the + connection-token. Connection options are signaled by the presence of + a connection-token in the Connection header field, not by any + corresponding additional header field(s), since the additional header + field may not be sent if there are no parameters associated with that + connection option. + + Message headers listed in the Connection header MUST NOT include + end-to-end headers, such as Cache-Control. + + HTTP/1.1 defines the "close" connection option for the sender to + signal that the connection will be closed after completion of the + response. For example, + + Connection: close + + in either the request or the response header fields indicates that + the connection SHOULD NOT be considered `persistent' (section 8.1) + after the current request/response is complete. + + HTTP/1.1 applications that do not support persistent connections MUST + include the "close" connection option in every message. + + A system receiving an HTTP/1.0 (or lower-version) message that + includes a Connection header MUST, for each connection-token in this + field, remove and ignore any header field(s) from the message with + the same name as the connection-token. This protects against mistaken + forwarding of such header fields by pre-HTTP/1.1 proxies. See section + 19.6.2. + + + +Fielding, et al. Standards Track [Page 117] + +RFC 2616 HTTP/1.1 June 1999 + + +14.11 Content-Encoding + + The Content-Encoding entity-header field is used as a modifier to the + media-type. When present, its value indicates what additional content + codings have been applied to the entity-body, and thus what decoding + mechanisms must be applied in order to obtain the media-type + referenced by the Content-Type header field. Content-Encoding is + primarily used to allow a document to be compressed without losing + the identity of its underlying media type. + + Content-Encoding = "Content-Encoding" ":" 1#content-coding + + Content codings are defined in section 3.5. An example of its use is + + Content-Encoding: gzip + + The content-coding is a characteristic of the entity identified by + the Request-URI. Typically, the entity-body is stored with this + encoding and is only decoded before rendering or analogous usage. + However, a non-transparent proxy MAY modify the content-coding if the + new coding is known to be acceptable to the recipient, unless the + "no-transform" cache-control directive is present in the message. + + If the content-coding of an entity is not "identity", then the + response MUST include a Content-Encoding entity-header (section + 14.11) that lists the non-identity content-coding(s) used. + + If the content-coding of an entity in a request message is not + acceptable to the origin server, the server SHOULD respond with a + status code of 415 (Unsupported Media Type). + + If multiple encodings have been applied to an entity, the content + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + +14.12 Content-Language + + The Content-Language entity-header field describes the natural + language(s) of the intended audience for the enclosed entity. Note + that this might not be equivalent to all the languages used within + the entity-body. + + Content-Language = "Content-Language" ":" 1#language-tag + + + + + + + +Fielding, et al. Standards Track [Page 118] + +RFC 2616 HTTP/1.1 June 1999 + + + Language tags are defined in section 3.10. The primary purpose of + Content-Language is to allow a user to identify and differentiate + entities according to the user's own preferred language. Thus, if the + body content is intended only for a Danish-literate audience, the + appropriate field is + + Content-Language: da + + If no Content-Language is specified, the default is that the content + is intended for all language audiences. This might mean that the + sender does not consider it to be specific to any natural language, + or that the sender does not know for which language it is intended. + + Multiple languages MAY be listed for content that is intended for + multiple audiences. For example, a rendition of the "Treaty of + Waitangi," presented simultaneously in the original Maori and English + versions, would call for + + Content-Language: mi, en + + However, just because multiple languages are present within an entity + does not mean that it is intended for multiple linguistic audiences. + An example would be a beginner's language primer, such as "A First + Lesson in Latin," which is clearly intended to be used by an + English-literate audience. In this case, the Content-Language would + properly only include "en". + + Content-Language MAY be applied to any media type -- it is not + limited to textual documents. + +14.13 Content-Length + + The Content-Length entity-header field indicates the size of the + entity-body, in decimal number of OCTETs, sent to the recipient or, + in the case of the HEAD method, the size of the entity-body that + would have been sent had the request been a GET. + + Content-Length = "Content-Length" ":" 1*DIGIT + + An example is + + Content-Length: 3495 + + Applications SHOULD use this field to indicate the transfer-length of + the message-body, unless this is prohibited by the rules in section + 4.4. + + + + + +Fielding, et al. Standards Track [Page 119] + +RFC 2616 HTTP/1.1 June 1999 + + + Any Content-Length greater than or equal to zero is a valid value. + Section 4.4 describes how to determine the length of a message-body + if a Content-Length is not given. + + Note that the meaning of this field is significantly different from + the corresponding definition in MIME, where it is an optional field + used within the "message/external-body" content-type. In HTTP, it + SHOULD be sent whenever the message's length can be determined prior + to being transferred, unless this is prohibited by the rules in + section 4.4. + +14.14 Content-Location + + The Content-Location entity-header field MAY be used to supply the + resource location for the entity enclosed in the message when that + entity is accessible from a location separate from the requested + resource's URI. A server SHOULD provide a Content-Location for the + variant corresponding to the response entity; especially in the case + where a resource has multiple entities associated with it, and those + entities actually have separate locations by which they might be + individually accessed, the server SHOULD provide a Content-Location + for the particular variant which is returned. + + Content-Location = "Content-Location" ":" + ( absoluteURI | relativeURI ) + + The value of Content-Location also defines the base URI for the + entity. + + The Content-Location value is not a replacement for the original + requested URI; it is only a statement of the location of the resource + corresponding to this particular entity at the time of the request. + Future requests MAY specify the Content-Location URI as the request- + URI if the desire is to identify the source of that particular + entity. + + A cache cannot assume that an entity with a Content-Location + different from the URI used to retrieve it can be used to respond to + later requests on that Content-Location URI. However, the Content- + Location can be used to differentiate between multiple entities + retrieved from a single requested resource, as described in section + 13.6. + + If the Content-Location is a relative URI, the relative URI is + interpreted relative to the Request-URI. + + The meaning of the Content-Location header in PUT or POST requests is + undefined; servers are free to ignore it in those cases. + + + +Fielding, et al. Standards Track [Page 120] + +RFC 2616 HTTP/1.1 June 1999 + + +14.15 Content-MD5 + + The Content-MD5 entity-header field, as defined in RFC 1864 [23], is + an MD5 digest of the entity-body for the purpose of providing an + end-to-end message integrity check (MIC) of the entity-body. (Note: a + MIC is good for detecting accidental modification of the entity-body + in transit, but is not proof against malicious attacks.) + + Content-MD5 = "Content-MD5" ":" md5-digest + md5-digest = + + The Content-MD5 header field MAY be generated by an origin server or + client to function as an integrity check of the entity-body. Only + origin servers or clients MAY generate the Content-MD5 header field; + proxies and gateways MUST NOT generate it, as this would defeat its + value as an end-to-end integrity check. Any recipient of the entity- + body, including gateways and proxies, MAY check that the digest value + in this header field matches that of the entity-body as received. + + The MD5 digest is computed based on the content of the entity-body, + including any content-coding that has been applied, but not including + any transfer-encoding applied to the message-body. If the message is + received with a transfer-encoding, that encoding MUST be removed + prior to checking the Content-MD5 value against the received entity. + + This has the result that the digest is computed on the octets of the + entity-body exactly as, and in the order that, they would be sent if + no transfer-encoding were being applied. + + HTTP extends RFC 1864 to permit the digest to be computed for MIME + composite media-types (e.g., multipart/* and message/rfc822), but + this does not change how the digest is computed as defined in the + preceding paragraph. + + There are several consequences of this. The entity-body for composite + types MAY contain many body-parts, each with its own MIME and HTTP + headers (including Content-MD5, Content-Transfer-Encoding, and + Content-Encoding headers). If a body-part has a Content-Transfer- + Encoding or Content-Encoding header, it is assumed that the content + of the body-part has had the encoding applied, and the body-part is + included in the Content-MD5 digest as is -- i.e., after the + application. The Transfer-Encoding header field is not allowed within + body-parts. + + Conversion of all line breaks to CRLF MUST NOT be done before + computing or checking the digest: the line break convention used in + the text actually transmitted MUST be left unaltered when computing + the digest. + + + +Fielding, et al. Standards Track [Page 121] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: while the definition of Content-MD5 is exactly the same for + HTTP as in RFC 1864 for MIME entity-bodies, there are several ways + in which the application of Content-MD5 to HTTP entity-bodies + differs from its application to MIME entity-bodies. One is that + HTTP, unlike MIME, does not use Content-Transfer-Encoding, and + does use Transfer-Encoding and Content-Encoding. Another is that + HTTP more frequently uses binary content types than MIME, so it is + worth noting that, in such cases, the byte order used to compute + the digest is the transmission byte order defined for the type. + Lastly, HTTP allows transmission of text types with any of several + line break conventions and not just the canonical form using CRLF. + +14.16 Content-Range + + The Content-Range entity-header is sent with a partial entity-body to + specify where in the full entity-body the partial body should be + applied. Range units are defined in section 3.12. + + Content-Range = "Content-Range" ":" content-range-spec + + content-range-spec = byte-content-range-spec + byte-content-range-spec = bytes-unit SP + byte-range-resp-spec "/" + ( instance-length | "*" ) + + byte-range-resp-spec = (first-byte-pos "-" last-byte-pos) + | "*" + instance-length = 1*DIGIT + + The header SHOULD indicate the total length of the full entity-body, + unless this length is unknown or difficult to determine. The asterisk + "*" character means that the instance-length is unknown at the time + when the response was generated. + + Unlike byte-ranges-specifier values (see section 14.35.1), a byte- + range-resp-spec MUST only specify one range, and MUST contain + absolute byte positions for both the first and last byte of the + range. + + A byte-content-range-spec with a byte-range-resp-spec whose last- + byte-pos value is less than its first-byte-pos value, or whose + instance-length value is less than or equal to its last-byte-pos + value, is invalid. The recipient of an invalid byte-content-range- + spec MUST ignore it and any content transferred along with it. + + A server sending a response with status code 416 (Requested range not + satisfiable) SHOULD include a Content-Range field with a byte-range- + resp-spec of "*". The instance-length specifies the current length of + + + +Fielding, et al. Standards Track [Page 122] + +RFC 2616 HTTP/1.1 June 1999 + + + the selected resource. A response with status code 206 (Partial + Content) MUST NOT include a Content-Range field with a byte-range- + resp-spec of "*". + + Examples of byte-content-range-spec values, assuming that the entity + contains a total of 1234 bytes: + + . The first 500 bytes: + bytes 0-499/1234 + + . The second 500 bytes: + bytes 500-999/1234 + + . All except for the first 500 bytes: + bytes 500-1233/1234 + + . The last 500 bytes: + bytes 734-1233/1234 + + When an HTTP message includes the content of a single range (for + example, a response to a request for a single range, or to a request + for a set of ranges that overlap without any holes), this content is + transmitted with a Content-Range header, and a Content-Length header + showing the number of bytes actually transferred. For example, + + HTTP/1.1 206 Partial content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-Range: bytes 21010-47021/47022 + Content-Length: 26012 + Content-Type: image/gif + + When an HTTP message includes the content of multiple ranges (for + example, a response to a request for multiple non-overlapping + ranges), these are transmitted as a multipart message. The multipart + media type used for this purpose is "multipart/byteranges" as defined + in appendix 19.2. See appendix 19.6.3 for a compatibility issue. + + A response to a request for a single range MUST NOT be sent using the + multipart/byteranges media type. A response to a request for + multiple ranges, whose result is a single range, MAY be sent as a + multipart/byteranges media type with one part. A client that cannot + decode a multipart/byteranges message MUST NOT ask for multiple + byte-ranges in a single request. + + When a client requests multiple byte-ranges in one request, the + server SHOULD return them in the order that they appeared in the + request. + + + +Fielding, et al. Standards Track [Page 123] + +RFC 2616 HTTP/1.1 June 1999 + + + If the server ignores a byte-range-spec because it is syntactically + invalid, the server SHOULD treat the request as if the invalid Range + header field did not exist. (Normally, this means return a 200 + response containing the full entity). + + If the server receives a request (other than one including an If- + Range request-header field) with an unsatisfiable Range request- + header field (that is, all of whose byte-range-spec values have a + first-byte-pos value greater than the current length of the selected + resource), it SHOULD return a response code of 416 (Requested range + not satisfiable) (section 10.4.17). + + Note: clients cannot depend on servers to send a 416 (Requested + range not satisfiable) response instead of a 200 (OK) response for + an unsatisfiable Range request-header, since not all servers + implement this request-header. + +14.17 Content-Type + + The Content-Type entity-header field indicates the media type of the + entity-body sent to the recipient or, in the case of the HEAD method, + the media type that would have been sent had the request been a GET. + + Content-Type = "Content-Type" ":" media-type + + Media types are defined in section 3.7. An example of the field is + + Content-Type: text/html; charset=ISO-8859-4 + + Further discussion of methods for identifying the media type of an + entity is provided in section 7.2.1. + +14.18 Date + + The Date general-header field represents the date and time at which + the message was originated, having the same semantics as orig-date in + RFC 822. The field value is an HTTP-date, as described in section + 3.3.1; it MUST be sent in RFC 1123 [8]-date format. + + Date = "Date" ":" HTTP-date + + An example is + + Date: Tue, 15 Nov 1994 08:12:31 GMT + + Origin servers MUST include a Date header field in all responses, + except in these cases: + + + + +Fielding, et al. Standards Track [Page 124] + +RFC 2616 HTTP/1.1 June 1999 + + + 1. If the response status code is 100 (Continue) or 101 (Switching + Protocols), the response MAY include a Date header field, at + the server's option. + + 2. If the response status code conveys a server error, e.g. 500 + (Internal Server Error) or 503 (Service Unavailable), and it is + inconvenient or impossible to generate a valid Date. + + 3. If the server does not have a clock that can provide a + reasonable approximation of the current time, its responses + MUST NOT include a Date header field. In this case, the rules + in section 14.18.1 MUST be followed. + + A received message that does not have a Date header field MUST be + assigned one by the recipient if the message will be cached by that + recipient or gatewayed via a protocol which requires a Date. An HTTP + implementation without a clock MUST NOT cache responses without + revalidating them on every use. An HTTP cache, especially a shared + cache, SHOULD use a mechanism, such as NTP [28], to synchronize its + clock with a reliable external standard. + + Clients SHOULD only send a Date header field in messages that include + an entity-body, as in the case of the PUT and POST requests, and even + then it is optional. A client without a clock MUST NOT send a Date + header field in a request. + + The HTTP-date sent in a Date header SHOULD NOT represent a date and + time subsequent to the generation of the message. It SHOULD represent + the best available approximation of the date and time of message + generation, unless the implementation has no means of generating a + reasonably accurate date and time. In theory, the date ought to + represent the moment just before the entity is generated. In + practice, the date can be generated at any time during the message + origination without affecting its semantic value. + +14.18.1 Clockless Origin Server Operation + + Some origin server implementations might not have a clock available. + An origin server without a clock MUST NOT assign Expires or Last- + Modified values to a response, unless these values were associated + with the resource by a system or user with a reliable clock. It MAY + assign an Expires value that is known, at or before server + configuration time, to be in the past (this allows "pre-expiration" + of responses without storing separate Expires values for each + resource). + + + + + + +Fielding, et al. Standards Track [Page 125] + +RFC 2616 HTTP/1.1 June 1999 + + +14.19 ETag + + The ETag response-header field provides the current value of the + entity tag for the requested variant. The headers used with entity + tags are described in sections 14.24, 14.26 and 14.44. The entity tag + MAY be used for comparison with other entities from the same resource + (see section 13.3.3). + + ETag = "ETag" ":" entity-tag + + Examples: + + ETag: "xyzzy" + ETag: W/"xyzzy" + ETag: "" + +14.20 Expect + + The Expect request-header field is used to indicate that particular + server behaviors are required by the client. + + Expect = "Expect" ":" 1#expectation + + expectation = "100-continue" | expectation-extension + expectation-extension = token [ "=" ( token | quoted-string ) + *expect-params ] + expect-params = ";" token [ "=" ( token | quoted-string ) ] + + + A server that does not understand or is unable to comply with any of + the expectation values in the Expect field of a request MUST respond + with appropriate error status. The server MUST respond with a 417 + (Expectation Failed) status if any of the expectations cannot be met + or, if there are other problems with the request, some other 4xx + status. + + This header field is defined with extensible syntax to allow for + future extensions. If a server receives a request containing an + Expect field that includes an expectation-extension that it does not + support, it MUST respond with a 417 (Expectation Failed) status. + + Comparison of expectation values is case-insensitive for unquoted + tokens (including the 100-continue token), and is case-sensitive for + quoted-string expectation-extensions. + + + + + + + +Fielding, et al. Standards Track [Page 126] + +RFC 2616 HTTP/1.1 June 1999 + + + The Expect mechanism is hop-by-hop: that is, an HTTP/1.1 proxy MUST + return a 417 (Expectation Failed) status if it receives a request + with an expectation that it cannot meet. However, the Expect + request-header itself is end-to-end; it MUST be forwarded if the + request is forwarded. + + Many older HTTP/1.0 and HTTP/1.1 applications do not understand the + Expect header. + + See section 8.2.3 for the use of the 100 (continue) status. + +14.21 Expires + + The Expires entity-header field gives the date/time after which the + response is considered stale. A stale cache entry may not normally be + returned by a cache (either a proxy cache or a user agent cache) + unless it is first validated with the origin server (or with an + intermediate cache that has a fresh copy of the entity). See section + 13.2 for further discussion of the expiration model. + + The presence of an Expires field does not imply that the original + resource will change or cease to exist at, before, or after that + time. + + The format is an absolute date and time as defined by HTTP-date in + section 3.3.1; it MUST be in RFC 1123 date format: + + Expires = "Expires" ":" HTTP-date + + An example of its use is + + Expires: Thu, 01 Dec 1994 16:00:00 GMT + + Note: if a response includes a Cache-Control field with the max- + age directive (see section 14.9.3), that directive overrides the + Expires field. + + HTTP/1.1 clients and caches MUST treat other invalid date formats, + especially including the value "0", as in the past (i.e., "already + expired"). + + To mark a response as "already expired," an origin server sends an + Expires date that is equal to the Date header value. (See the rules + for expiration calculations in section 13.2.4.) + + + + + + + +Fielding, et al. Standards Track [Page 127] + +RFC 2616 HTTP/1.1 June 1999 + + + To mark a response as "never expires," an origin server sends an + Expires date approximately one year from the time the response is + sent. HTTP/1.1 servers SHOULD NOT send Expires dates more than one + year in the future. + + The presence of an Expires header field with a date value of some + time in the future on a response that otherwise would by default be + non-cacheable indicates that the response is cacheable, unless + indicated otherwise by a Cache-Control header field (section 14.9). + +14.22 From + + The From request-header field, if given, SHOULD contain an Internet + e-mail address for the human user who controls the requesting user + agent. The address SHOULD be machine-usable, as defined by "mailbox" + in RFC 822 [9] as updated by RFC 1123 [8]: + + From = "From" ":" mailbox + + An example is: + + From: webmaster@w3.org + + This header field MAY be used for logging purposes and as a means for + identifying the source of invalid or unwanted requests. It SHOULD NOT + be used as an insecure form of access protection. The interpretation + of this field is that the request is being performed on behalf of the + person given, who accepts responsibility for the method performed. In + particular, robot agents SHOULD include this header so that the + person responsible for running the robot can be contacted if problems + occur on the receiving end. + + The Internet e-mail address in this field MAY be separate from the + Internet host which issued the request. For example, when a request + is passed through a proxy the original issuer's address SHOULD be + used. + + The client SHOULD NOT send the From header field without the user's + approval, as it might conflict with the user's privacy interests or + their site's security policy. It is strongly recommended that the + user be able to disable, enable, and modify the value of this field + at any time prior to a request. + +14.23 Host + + The Host request-header field specifies the Internet host and port + number of the resource being requested, as obtained from the original + URI given by the user or referring resource (generally an HTTP URL, + + + +Fielding, et al. Standards Track [Page 128] + +RFC 2616 HTTP/1.1 June 1999 + + + as described in section 3.2.2). The Host field value MUST represent + the naming authority of the origin server or gateway given by the + original URL. This allows the origin server or gateway to + differentiate between internally-ambiguous URLs, such as the root "/" + URL of a server for multiple host names on a single IP address. + + Host = "Host" ":" host [ ":" port ] ; Section 3.2.2 + + A "host" without any trailing port information implies the default + port for the service requested (e.g., "80" for an HTTP URL). For + example, a request on the origin server for + would properly include: + + GET /pub/WWW/ HTTP/1.1 + Host: www.w3.org + + A client MUST include a Host header field in all HTTP/1.1 request + messages . If the requested URI does not include an Internet host + name for the service being requested, then the Host header field MUST + be given with an empty value. An HTTP/1.1 proxy MUST ensure that any + request message it forwards does contain an appropriate Host header + field that identifies the service being requested by the proxy. All + Internet-based HTTP/1.1 servers MUST respond with a 400 (Bad Request) + status code to any HTTP/1.1 request message which lacks a Host header + field. + + See sections 5.2 and 19.6.1.1 for other requirements relating to + Host. + +14.24 If-Match + + The If-Match request-header field is used with a method to make it + conditional. A client that has one or more entities previously + obtained from the resource can verify that one of those entities is + current by including a list of their associated entity tags in the + If-Match header field. Entity tags are defined in section 3.11. The + purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. It is also + used, on updating requests, to prevent inadvertent modification of + the wrong version of a resource. As a special case, the value "*" + matches any current entity of the resource. + + If-Match = "If-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-Match header) on that resource, or if "*" is given + + + + +Fielding, et al. Standards Track [Page 129] + +RFC 2616 HTTP/1.1 June 1999 + + + and any current entity exists for that resource, then the server MAY + perform the requested method as if the If-Match header field did not + exist. + + A server MUST use the strong comparison function (see section 13.3.3) + to compare the entity tags in If-Match. + + If none of the entity tags match, or if "*" is given and no current + entity exists, the server MUST NOT perform the requested method, and + MUST return a 412 (Precondition Failed) response. This behavior is + most useful when the client wants to prevent an updating method, such + as PUT, from modifying a resource that has changed since the client + last retrieved it. + + If the request would, without the If-Match header field, result in + anything other than a 2xx or 412 status, then the If-Match header + MUST be ignored. + + The meaning of "If-Match: *" is that the method SHOULD be performed + if the representation selected by the origin server (or by a cache, + possibly using the Vary mechanism, see section 14.44) exists, and + MUST NOT be performed if the representation does not exist. + + A request intended to update a resource (e.g., a PUT) MAY include an + If-Match header field to signal that the request method MUST NOT be + applied if the entity corresponding to the If-Match value (a single + entity tag) is no longer a representation of that resource. This + allows the user to indicate that they do not wish the request to be + successful if the resource has been changed without their knowledge. + Examples: + + If-Match: "xyzzy" + If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-Match: * + + The result of a request having both an If-Match header field and + either an If-None-Match or an If-Modified-Since header fields is + undefined by this specification. + +14.25 If-Modified-Since + + The If-Modified-Since request-header field is used with a method to + make it conditional: if the requested variant has not been modified + since the time specified in this field, an entity will not be + returned from the server; instead, a 304 (not modified) response will + be returned without any message-body. + + If-Modified-Since = "If-Modified-Since" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 130] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of the field is: + + If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + A GET method with an If-Modified-Since header and no Range header + requests that the identified entity be transferred only if it has + been modified since the date given by the If-Modified-Since header. + The algorithm for determining this includes the following cases: + + a) If the request would normally result in anything other than a + 200 (OK) status, or if the passed If-Modified-Since date is + invalid, the response is exactly the same as for a normal GET. + A date which is later than the server's current time is + invalid. + + b) If the variant has been modified since the If-Modified-Since + date, the response is exactly the same as for a normal GET. + + c) If the variant has not been modified since a valid If- + Modified-Since date, the server SHOULD return a 304 (Not + Modified) response. + + The purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. + + Note: The Range request-header field modifies the meaning of If- + Modified-Since; see section 14.35 for full details. + + Note: If-Modified-Since times are interpreted by the server, whose + clock might not be synchronized with the client. + + Note: When handling an If-Modified-Since header field, some + servers will use an exact date comparison function, rather than a + less-than function, for deciding whether to send a 304 (Not + Modified) response. To get best results when sending an If- + Modified-Since header field for cache validation, clients are + advised to use the exact date string received in a previous Last- + Modified header field whenever possible. + + Note: If a client uses an arbitrary date in the If-Modified-Since + header instead of a date taken from the Last-Modified header for + the same request, the client should be aware of the fact that this + date is interpreted in the server's understanding of time. The + client should consider unsynchronized clocks and rounding problems + due to the different encodings of time between the client and + server. This includes the possibility of race conditions if the + document has changed between the time it was first requested and + the If-Modified-Since date of a subsequent request, and the + + + +Fielding, et al. Standards Track [Page 131] + +RFC 2616 HTTP/1.1 June 1999 + + + possibility of clock-skew-related problems if the If-Modified- + Since date is derived from the client's clock without correction + to the server's clock. Corrections for different time bases + between client and server are at best approximate due to network + latency. + + The result of a request having both an If-Modified-Since header field + and either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.26 If-None-Match + + The If-None-Match request-header field is used with a method to make + it conditional. A client that has one or more entities previously + obtained from the resource can verify that none of those entities is + current by including a list of their associated entity tags in the + If-None-Match header field. The purpose of this feature is to allow + efficient updates of cached information with a minimum amount of + transaction overhead. It is also used to prevent a method (e.g. PUT) + from inadvertently modifying an existing resource when the client + believes that the resource does not exist. + + As a special case, the value "*" matches any current entity of the + resource. + + If-None-Match = "If-None-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-None-Match header) on that resource, or if "*" is + given and any current entity exists for that resource, then the + server MUST NOT perform the requested method, unless required to do + so because the resource's modification date fails to match that + supplied in an If-Modified-Since header field in the request. + Instead, if the request method was GET or HEAD, the server SHOULD + respond with a 304 (Not Modified) response, including the cache- + related header fields (particularly ETag) of one of the entities that + matched. For all other request methods, the server MUST respond with + a status of 412 (Precondition Failed). + + See section 13.3.3 for rules on how to determine if two entities tags + match. The weak comparison function can only be used with GET or HEAD + requests. + + + + + + + + +Fielding, et al. Standards Track [Page 132] + +RFC 2616 HTTP/1.1 June 1999 + + + If none of the entity tags match, then the server MAY perform the + requested method as if the If-None-Match header field did not exist, + but MUST also ignore any If-Modified-Since header field(s) in the + request. That is, if no entity tags match, then the server MUST NOT + return a 304 (Not Modified) response. + + If the request would, without the If-None-Match header field, result + in anything other than a 2xx or 304 status, then the If-None-Match + header MUST be ignored. (See section 13.3.4 for a discussion of + server behavior when both If-Modified-Since and If-None-Match appear + in the same request.) + + The meaning of "If-None-Match: *" is that the method MUST NOT be + performed if the representation selected by the origin server (or by + a cache, possibly using the Vary mechanism, see section 14.44) + exists, and SHOULD be performed if the representation does not exist. + This feature is intended to be useful in preventing races between PUT + operations. + + Examples: + + If-None-Match: "xyzzy" + If-None-Match: W/"xyzzy" + If-None-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-None-Match: W/"xyzzy", W/"r2d2xxxx", W/"c3piozzzz" + If-None-Match: * + + The result of a request having both an If-None-Match header field and + either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.27 If-Range + + If a client has a partial copy of an entity in its cache, and wishes + to have an up-to-date copy of the entire entity in its cache, it + could use the Range request-header with a conditional GET (using + either or both of If-Unmodified-Since and If-Match.) However, if the + condition fails because the entity has been modified, the client + would then have to make a second request to obtain the entire current + entity-body. + + The If-Range header allows a client to "short-circuit" the second + request. Informally, its meaning is `if the entity is unchanged, send + me the part(s) that I am missing; otherwise, send me the entire new + entity'. + + If-Range = "If-Range" ":" ( entity-tag | HTTP-date ) + + + + +Fielding, et al. Standards Track [Page 133] + +RFC 2616 HTTP/1.1 June 1999 + + + If the client has no entity tag for an entity, but does have a Last- + Modified date, it MAY use that date in an If-Range header. (The + server can distinguish between a valid HTTP-date and any form of + entity-tag by examining no more than two characters.) The If-Range + header SHOULD only be used together with a Range header, and MUST be + ignored if the request does not include a Range header, or if the + server does not support the sub-range operation. + + If the entity tag given in the If-Range header matches the current + entity tag for the entity, then the server SHOULD provide the + specified sub-range of the entity using a 206 (Partial content) + response. If the entity tag does not match, then the server SHOULD + return the entire entity using a 200 (OK) response. + +14.28 If-Unmodified-Since + + The If-Unmodified-Since request-header field is used with a method to + make it conditional. If the requested resource has not been modified + since the time specified in this field, the server SHOULD perform the + requested operation as if the If-Unmodified-Since header were not + present. + + If the requested variant has been modified since the specified time, + the server MUST NOT perform the requested operation, and MUST return + a 412 (Precondition Failed). + + If-Unmodified-Since = "If-Unmodified-Since" ":" HTTP-date + + An example of the field is: + + If-Unmodified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + If the request normally (i.e., without the If-Unmodified-Since + header) would result in anything other than a 2xx or 412 status, the + If-Unmodified-Since header SHOULD be ignored. + + If the specified date is invalid, the header is ignored. + + The result of a request having both an If-Unmodified-Since header + field and either an If-None-Match or an If-Modified-Since header + fields is undefined by this specification. + +14.29 Last-Modified + + The Last-Modified entity-header field indicates the date and time at + which the origin server believes the variant was last modified. + + Last-Modified = "Last-Modified" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 134] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of its use is + + Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT + + The exact meaning of this header field depends on the implementation + of the origin server and the nature of the original resource. For + files, it may be just the file system last-modified time. For + entities with dynamically included parts, it may be the most recent + of the set of last-modify times for its component parts. For database + gateways, it may be the last-update time stamp of the record. For + virtual objects, it may be the last time the internal state changed. + + An origin server MUST NOT send a Last-Modified date which is later + than the server's time of message origination. In such cases, where + the resource's last modification would indicate some time in the + future, the server MUST replace that date with the message + origination date. + + An origin server SHOULD obtain the Last-Modified value of the entity + as close as possible to the time that it generates the Date value of + its response. This allows a recipient to make an accurate assessment + of the entity's modification time, especially if the entity changes + near the time that the response is generated. + + HTTP/1.1 servers SHOULD send Last-Modified whenever feasible. + +14.30 Location + + The Location response-header field is used to redirect the recipient + to a location other than the Request-URI for completion of the + request or identification of a new resource. For 201 (Created) + responses, the Location is that of the new resource which was created + by the request. For 3xx responses, the location SHOULD indicate the + server's preferred URI for automatic redirection to the resource. The + field value consists of a single absolute URI. + + Location = "Location" ":" absoluteURI + + An example is: + + Location: http://www.w3.org/pub/WWW/People.html + + Note: The Content-Location header field (section 14.14) differs + from Location in that the Content-Location identifies the original + location of the entity enclosed in the request. It is therefore + possible for a response to contain header fields for both Location + and Content-Location. Also see section 13.10 for cache + requirements of some methods. + + + +Fielding, et al. Standards Track [Page 135] + +RFC 2616 HTTP/1.1 June 1999 + + +14.31 Max-Forwards + + The Max-Forwards request-header field provides a mechanism with the + TRACE (section 9.8) and OPTIONS (section 9.2) methods to limit the + number of proxies or gateways that can forward the request to the + next inbound server. This can be useful when the client is attempting + to trace a request chain which appears to be failing or looping in + mid-chain. + + Max-Forwards = "Max-Forwards" ":" 1*DIGIT + + The Max-Forwards value is a decimal integer indicating the remaining + number of times this request message may be forwarded. + + Each proxy or gateway recipient of a TRACE or OPTIONS request + containing a Max-Forwards header field MUST check and update its + value prior to forwarding the request. If the received value is zero + (0), the recipient MUST NOT forward the request; instead, it MUST + respond as the final recipient. If the received Max-Forwards value is + greater than zero, then the forwarded message MUST contain an updated + Max-Forwards field with a value decremented by one (1). + + The Max-Forwards header field MAY be ignored for all other methods + defined by this specification and for any extension methods for which + it is not explicitly referred to as part of that method definition. + +14.32 Pragma + + The Pragma general-header field is used to include implementation- + specific directives that might apply to any recipient along the + request/response chain. All pragma directives specify optional + behavior from the viewpoint of the protocol; however, some systems + MAY require that behavior be consistent with the directives. + + Pragma = "Pragma" ":" 1#pragma-directive + pragma-directive = "no-cache" | extension-pragma + extension-pragma = token [ "=" ( token | quoted-string ) ] + + When the no-cache directive is present in a request message, an + application SHOULD forward the request toward the origin server even + if it has a cached copy of what is being requested. This pragma + directive has the same semantics as the no-cache cache-directive (see + section 14.9) and is defined here for backward compatibility with + HTTP/1.0. Clients SHOULD include both header fields when a no-cache + request is sent to a server not known to be HTTP/1.1 compliant. + + + + + + +Fielding, et al. Standards Track [Page 136] + +RFC 2616 HTTP/1.1 June 1999 + + + Pragma directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a pragma for a + specific recipient; however, any pragma directive not relevant to a + recipient SHOULD be ignored by that recipient. + + HTTP/1.1 caches SHOULD treat "Pragma: no-cache" as if the client had + sent "Cache-Control: no-cache". No new Pragma directives will be + defined in HTTP. + + Note: because the meaning of "Pragma: no-cache as a response + header field is not actually specified, it does not provide a + reliable replacement for "Cache-Control: no-cache" in a response + +14.33 Proxy-Authenticate + + The Proxy-Authenticate response-header field MUST be included as part + of a 407 (Proxy Authentication Required) response. The field value + consists of a challenge that indicates the authentication scheme and + parameters applicable to the proxy for this Request-URI. + + Proxy-Authenticate = "Proxy-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. Unlike + WWW-Authenticate, the Proxy-Authenticate header field applies only to + the current connection and SHOULD NOT be passed on to downstream + clients. However, an intermediate proxy might need to obtain its own + credentials by requesting them from the downstream client, which in + some circumstances will appear as if the proxy is forwarding the + Proxy-Authenticate header field. + +14.34 Proxy-Authorization + + The Proxy-Authorization request-header field allows the client to + identify itself (or its user) to a proxy which requires + authentication. The Proxy-Authorization field value consists of + credentials containing the authentication information of the user + agent for the proxy and/or realm of the resource being requested. + + Proxy-Authorization = "Proxy-Authorization" ":" credentials + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43] . Unlike + Authorization, the Proxy-Authorization header field applies only to + the next outbound proxy that demanded authentication using the Proxy- + Authenticate field. When multiple proxies are used in a chain, the + + + +Fielding, et al. Standards Track [Page 137] + +RFC 2616 HTTP/1.1 June 1999 + + + Proxy-Authorization header field is consumed by the first outbound + proxy that was expecting to receive credentials. A proxy MAY relay + the credentials from the client request to the next proxy if that is + the mechanism by which the proxies cooperatively authenticate a given + request. + +14.35 Range + +14.35.1 Byte Ranges + + Since all HTTP entities are represented in HTTP messages as sequences + of bytes, the concept of a byte range is meaningful for any HTTP + entity. (However, not all clients and servers need to support byte- + range operations.) + + Byte range specifications in HTTP apply to the sequence of bytes in + the entity-body (not necessarily the same as the message-body). + + A byte range operation MAY specify a single range of bytes, or a set + of ranges within a single entity. + + ranges-specifier = byte-ranges-specifier + byte-ranges-specifier = bytes-unit "=" byte-range-set + byte-range-set = 1#( byte-range-spec | suffix-byte-range-spec ) + byte-range-spec = first-byte-pos "-" [last-byte-pos] + first-byte-pos = 1*DIGIT + last-byte-pos = 1*DIGIT + + The first-byte-pos value in a byte-range-spec gives the byte-offset + of the first byte in a range. The last-byte-pos value gives the + byte-offset of the last byte in the range; that is, the byte + positions specified are inclusive. Byte offsets start at zero. + + If the last-byte-pos value is present, it MUST be greater than or + equal to the first-byte-pos in that byte-range-spec, or the byte- + range-spec is syntactically invalid. The recipient of a byte-range- + set that includes one or more syntactically invalid byte-range-spec + values MUST ignore the header field that includes that byte-range- + set. + + If the last-byte-pos value is absent, or if the value is greater than + or equal to the current length of the entity-body, last-byte-pos is + taken to be equal to one less than the current length of the entity- + body in bytes. + + By its choice of last-byte-pos, a client can limit the number of + bytes retrieved without knowing the size of the entity. + + + + +Fielding, et al. Standards Track [Page 138] + +RFC 2616 HTTP/1.1 June 1999 + + + suffix-byte-range-spec = "-" suffix-length + suffix-length = 1*DIGIT + + A suffix-byte-range-spec is used to specify the suffix of the + entity-body, of a length given by the suffix-length value. (That is, + this form specifies the last N bytes of an entity-body.) If the + entity is shorter than the specified suffix-length, the entire + entity-body is used. + + If a syntactically valid byte-range-set includes at least one byte- + range-spec whose first-byte-pos is less than the current length of + the entity-body, or at least one suffix-byte-range-spec with a non- + zero suffix-length, then the byte-range-set is satisfiable. + Otherwise, the byte-range-set is unsatisfiable. If the byte-range-set + is unsatisfiable, the server SHOULD return a response with a status + of 416 (Requested range not satisfiable). Otherwise, the server + SHOULD return a response with a status of 206 (Partial Content) + containing the satisfiable ranges of the entity-body. + + Examples of byte-ranges-specifier values (assuming an entity-body of + length 10000): + + - The first 500 bytes (byte offsets 0-499, inclusive): bytes=0- + 499 + + - The second 500 bytes (byte offsets 500-999, inclusive): + bytes=500-999 + + - The final 500 bytes (byte offsets 9500-9999, inclusive): + bytes=-500 + + - Or bytes=9500- + + - The first and last bytes only (bytes 0 and 9999): bytes=0-0,-1 + + - Several legal but not canonical specifications of the second 500 + bytes (byte offsets 500-999, inclusive): + bytes=500-600,601-999 + bytes=500-700,601-999 + +14.35.2 Range Retrieval Requests + + HTTP retrieval requests using conditional or unconditional GET + methods MAY request one or more sub-ranges of the entity, instead of + the entire entity, using the Range request header, which applies to + the entity returned as the result of the request: + + Range = "Range" ":" ranges-specifier + + + +Fielding, et al. Standards Track [Page 139] + +RFC 2616 HTTP/1.1 June 1999 + + + A server MAY ignore the Range header. However, HTTP/1.1 origin + servers and intermediate caches ought to support byte ranges when + possible, since Range supports efficient recovery from partially + failed transfers, and supports efficient partial retrieval of large + entities. + + If the server supports the Range header and the specified range or + ranges are appropriate for the entity: + + - The presence of a Range header in an unconditional GET modifies + what is returned if the GET is otherwise successful. In other + words, the response carries a status code of 206 (Partial + Content) instead of 200 (OK). + + - The presence of a Range header in a conditional GET (a request + using one or both of If-Modified-Since and If-None-Match, or + one or both of If-Unmodified-Since and If-Match) modifies what + is returned if the GET is otherwise successful and the + condition is true. It does not affect the 304 (Not Modified) + response returned if the conditional is false. + + In some cases, it might be more appropriate to use the If-Range + header (see section 14.27) in addition to the Range header. + + If a proxy that supports ranges receives a Range request, forwards + the request to an inbound server, and receives an entire entity in + reply, it SHOULD only return the requested range to its client. It + SHOULD store the entire received response in its cache if that is + consistent with its cache allocation policies. + +14.36 Referer + + The Referer[sic] request-header field allows the client to specify, + for the server's benefit, the address (URI) of the resource from + which the Request-URI was obtained (the "referrer", although the + header field is misspelled.) The Referer request-header allows a + server to generate lists of back-links to resources for interest, + logging, optimized caching, etc. It also allows obsolete or mistyped + links to be traced for maintenance. The Referer field MUST NOT be + sent if the Request-URI was obtained from a source that does not have + its own URI, such as input from the user keyboard. + + Referer = "Referer" ":" ( absoluteURI | relativeURI ) + + Example: + + Referer: http://www.w3.org/hypertext/DataSources/Overview.html + + + + +Fielding, et al. Standards Track [Page 140] + +RFC 2616 HTTP/1.1 June 1999 + + + If the field value is a relative URI, it SHOULD be interpreted + relative to the Request-URI. The URI MUST NOT include a fragment. See + section 15.1.3 for security considerations. + +14.37 Retry-After + + The Retry-After response-header field can be used with a 503 (Service + Unavailable) response to indicate how long the service is expected to + be unavailable to the requesting client. This field MAY also be used + with any 3xx (Redirection) response to indicate the minimum time the + user-agent is asked wait before issuing the redirected request. The + value of this field can be either an HTTP-date or an integer number + of seconds (in decimal) after the time of the response. + + Retry-After = "Retry-After" ":" ( HTTP-date | delta-seconds ) + + Two examples of its use are + + Retry-After: Fri, 31 Dec 1999 23:59:59 GMT + Retry-After: 120 + + In the latter example, the delay is 2 minutes. + +14.38 Server + + The Server response-header field contains information about the + software used by the origin server to handle the request. The field + can contain multiple product tokens (section 3.8) and comments + identifying the server and any significant subproducts. The product + tokens are listed in order of their significance for identifying the + application. + + Server = "Server" ":" 1*( product | comment ) + + Example: + + Server: CERN/3.0 libwww/2.17 + + If the response is being forwarded through a proxy, the proxy + application MUST NOT modify the Server response-header. Instead, it + SHOULD include a Via field (as described in section 14.45). + + Note: Revealing the specific software version of the server might + allow the server machine to become more vulnerable to attacks + against software that is known to contain security holes. Server + implementors are encouraged to make this field a configurable + option. + + + + +Fielding, et al. Standards Track [Page 141] + +RFC 2616 HTTP/1.1 June 1999 + + +14.39 TE + + The TE request-header field indicates what extension transfer-codings + it is willing to accept in the response and whether or not it is + willing to accept trailer fields in a chunked transfer-coding. Its + value may consist of the keyword "trailers" and/or a comma-separated + list of extension transfer-coding names with optional accept + parameters (as described in section 3.6). + + TE = "TE" ":" #( t-codings ) + t-codings = "trailers" | ( transfer-extension [ accept-params ] ) + + The presence of the keyword "trailers" indicates that the client is + willing to accept trailer fields in a chunked transfer-coding, as + defined in section 3.6.1. This keyword is reserved for use with + transfer-coding values even though it does not itself represent a + transfer-coding. + + Examples of its use are: + + TE: deflate + TE: + TE: trailers, deflate;q=0.5 + + The TE header field only applies to the immediate connection. + Therefore, the keyword MUST be supplied within a Connection header + field (section 14.10) whenever TE is present in an HTTP/1.1 message. + + A server tests whether a transfer-coding is acceptable, according to + a TE field, using these rules: + + 1. The "chunked" transfer-coding is always acceptable. If the + keyword "trailers" is listed, the client indicates that it is + willing to accept trailer fields in the chunked response on + behalf of itself and any downstream clients. The implication is + that, if given, the client is stating that either all + downstream clients are willing to accept trailer fields in the + forwarded response, or that it will attempt to buffer the + response on behalf of downstream recipients. + + Note: HTTP/1.1 does not define any means to limit the size of a + chunked response such that a client can be assured of buffering + the entire response. + + 2. If the transfer-coding being tested is one of the transfer- + codings listed in the TE field, then it is acceptable unless it + is accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + + +Fielding, et al. Standards Track [Page 142] + +RFC 2616 HTTP/1.1 June 1999 + + + 3. If multiple transfer-codings are acceptable, then the + acceptable transfer-coding with the highest non-zero qvalue is + preferred. The "chunked" transfer-coding always has a qvalue + of 1. + + If the TE field-value is empty or if no TE field is present, the only + transfer-coding is "chunked". A message with no transfer-coding is + always acceptable. + +14.40 Trailer + + The Trailer general field value indicates that the given set of + header fields is present in the trailer of a message encoded with + chunked transfer-coding. + + Trailer = "Trailer" ":" 1#field-name + + An HTTP/1.1 message SHOULD include a Trailer header field in a + message using chunked transfer-coding with a non-empty trailer. Doing + so allows the recipient to know which header fields to expect in the + trailer. + + If no Trailer header field is present, the trailer SHOULD NOT include + any header fields. See section 3.6.1 for restrictions on the use of + trailer fields in a "chunked" transfer-coding. + + Message header fields listed in the Trailer header field MUST NOT + include the following header fields: + + . Transfer-Encoding + + . Content-Length + + . Trailer + +14.41 Transfer-Encoding + + The Transfer-Encoding general-header field indicates what (if any) + type of transformation has been applied to the message body in order + to safely transfer it between the sender and the recipient. This + differs from the content-coding in that the transfer-coding is a + property of the message, not of the entity. + + Transfer-Encoding = "Transfer-Encoding" ":" 1#transfer-coding + + Transfer-codings are defined in section 3.6. An example is: + + Transfer-Encoding: chunked + + + +Fielding, et al. Standards Track [Page 143] + +RFC 2616 HTTP/1.1 June 1999 + + + If multiple encodings have been applied to an entity, the transfer- + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + + Many older HTTP/1.0 applications do not understand the Transfer- + Encoding header. + +14.42 Upgrade + + The Upgrade general-header allows the client to specify what + additional communication protocols it supports and would like to use + if the server finds it appropriate to switch protocols. The server + MUST use the Upgrade header field within a 101 (Switching Protocols) + response to indicate which protocol(s) are being switched. + + Upgrade = "Upgrade" ":" 1#product + + For example, + + Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11 + + The Upgrade header field is intended to provide a simple mechanism + for transition from HTTP/1.1 to some other, incompatible protocol. It + does so by allowing the client to advertise its desire to use another + protocol, such as a later version of HTTP with a higher major version + number, even though the current request has been made using HTTP/1.1. + This eases the difficult transition between incompatible protocols by + allowing the client to initiate a request in the more commonly + supported protocol while indicating to the server that it would like + to use a "better" protocol if available (where "better" is determined + by the server, possibly according to the nature of the method and/or + resource being requested). + + The Upgrade header field only applies to switching application-layer + protocols upon the existing transport-layer connection. Upgrade + cannot be used to insist on a protocol change; its acceptance and use + by the server is optional. The capabilities and nature of the + application-layer communication after the protocol change is entirely + dependent upon the new protocol chosen, although the first action + after changing the protocol MUST be a response to the initial HTTP + request containing the Upgrade header field. + + The Upgrade header field only applies to the immediate connection. + Therefore, the upgrade keyword MUST be supplied within a Connection + header field (section 14.10) whenever Upgrade is present in an + HTTP/1.1 message. + + + + +Fielding, et al. Standards Track [Page 144] + +RFC 2616 HTTP/1.1 June 1999 + + + The Upgrade header field cannot be used to indicate a switch to a + protocol on a different connection. For that purpose, it is more + appropriate to use a 301, 302, 303, or 305 redirection response. + + This specification only defines the protocol name "HTTP" for use by + the family of Hypertext Transfer Protocols, as defined by the HTTP + version rules of section 3.1 and future updates to this + specification. Any token can be used as a protocol name; however, it + will only be useful if both the client and server associate the name + with the same protocol. + +14.43 User-Agent + + The User-Agent request-header field contains information about the + user agent originating the request. This is for statistical purposes, + the tracing of protocol violations, and automated recognition of user + agents for the sake of tailoring responses to avoid particular user + agent limitations. User agents SHOULD include this field with + requests. The field can contain multiple product tokens (section 3.8) + and comments identifying the agent and any subproducts which form a + significant part of the user agent. By convention, the product tokens + are listed in order of their significance for identifying the + application. + + User-Agent = "User-Agent" ":" 1*( product | comment ) + + Example: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + +14.44 Vary + + The Vary field value indicates the set of request-header fields that + fully determines, while the response is fresh, whether a cache is + permitted to use the response to reply to a subsequent request + without revalidation. For uncacheable or stale responses, the Vary + field value advises the user agent about the criteria that were used + to select the representation. A Vary field value of "*" implies that + a cache cannot determine from the request headers of a subsequent + request whether this response is the appropriate representation. See + section 13.6 for use of the Vary header field by caches. + + Vary = "Vary" ":" ( "*" | 1#field-name ) + + An HTTP/1.1 server SHOULD include a Vary header field with any + cacheable response that is subject to server-driven negotiation. + Doing so allows a cache to properly interpret future requests on that + resource and informs the user agent about the presence of negotiation + + + +Fielding, et al. Standards Track [Page 145] + +RFC 2616 HTTP/1.1 June 1999 + + + on that resource. A server MAY include a Vary header field with a + non-cacheable response that is subject to server-driven negotiation, + since this might provide the user agent with useful information about + the dimensions over which the response varies at the time of the + response. + + A Vary field value consisting of a list of field-names signals that + the representation selected for the response is based on a selection + algorithm which considers ONLY the listed request-header field values + in selecting the most appropriate representation. A cache MAY assume + that the same selection will be made for future requests with the + same values for the listed field names, for the duration of time for + which the response is fresh. + + The field-names given are not limited to the set of standard + request-header fields defined by this specification. Field names are + case-insensitive. + + A Vary field value of "*" signals that unspecified parameters not + limited to the request-headers (e.g., the network address of the + client), play a role in the selection of the response representation. + The "*" value MUST NOT be generated by a proxy server; it may only be + generated by an origin server. + +14.45 Via + + The Via general-header field MUST be used by gateways and proxies to + indicate the intermediate protocols and recipients between the user + agent and the server on requests, and between the origin server and + the client on responses. It is analogous to the "Received" field of + RFC 822 [9] and is intended to be used for tracking message forwards, + avoiding request loops, and identifying the protocol capabilities of + all senders along the request/response chain. + + Via = "Via" ":" 1#( received-protocol received-by [ comment ] ) + received-protocol = [ protocol-name "/" ] protocol-version + protocol-name = token + protocol-version = token + received-by = ( host [ ":" port ] ) | pseudonym + pseudonym = token + + The received-protocol indicates the protocol version of the message + received by the server or client along each segment of the + request/response chain. The received-protocol version is appended to + the Via field value when the message is forwarded so that information + about the protocol capabilities of upstream applications remains + visible to all recipients. + + + + +Fielding, et al. Standards Track [Page 146] + +RFC 2616 HTTP/1.1 June 1999 + + + The protocol-name is optional if and only if it would be "HTTP". The + received-by field is normally the host and optional port number of a + recipient server or client that subsequently forwarded the message. + However, if the real host is considered to be sensitive information, + it MAY be replaced by a pseudonym. If the port is not given, it MAY + be assumed to be the default port of the received-protocol. + + Multiple Via field values represents each proxy or gateway that has + forwarded the message. Each recipient MUST append its information + such that the end result is ordered according to the sequence of + forwarding applications. + + Comments MAY be used in the Via header field to identify the software + of the recipient proxy or gateway, analogous to the User-Agent and + Server header fields. However, all comments in the Via field are + optional and MAY be removed by any recipient prior to forwarding the + message. + + For example, a request message could be sent from an HTTP/1.0 user + agent to an internal proxy code-named "fred", which uses HTTP/1.1 to + forward the request to a public proxy at nowhere.com, which completes + the request by forwarding it to the origin server at www.ics.uci.edu. + The request received by www.ics.uci.edu would then have the following + Via header field: + + Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1) + + Proxies and gateways used as a portal through a network firewall + SHOULD NOT, by default, forward the names and ports of hosts within + the firewall region. This information SHOULD only be propagated if + explicitly enabled. If not enabled, the received-by host of any host + behind the firewall SHOULD be replaced by an appropriate pseudonym + for that host. + + For organizations that have strong privacy requirements for hiding + internal structures, a proxy MAY combine an ordered subsequence of + Via header field entries with identical received-protocol values into + a single such entry. For example, + + Via: 1.0 ricky, 1.1 ethel, 1.1 fred, 1.0 lucy + + could be collapsed to + + Via: 1.0 ricky, 1.1 mertz, 1.0 lucy + + + + + + + +Fielding, et al. Standards Track [Page 147] + +RFC 2616 HTTP/1.1 June 1999 + + + Applications SHOULD NOT combine multiple entries unless they are all + under the same organizational control and the hosts have already been + replaced by pseudonyms. Applications MUST NOT combine entries which + have different received-protocol values. + +14.46 Warning + + The Warning general-header field is used to carry additional + information about the status or transformation of a message which + might not be reflected in the message. This information is typically + used to warn about a possible lack of semantic transparency from + caching operations or transformations applied to the entity body of + the message. + + Warning headers are sent with responses using: + + Warning = "Warning" ":" 1#warning-value + + warning-value = warn-code SP warn-agent SP warn-text + [SP warn-date] + + warn-code = 3DIGIT + warn-agent = ( host [ ":" port ] ) | pseudonym + ; the name or pseudonym of the server adding + ; the Warning header, for use in debugging + warn-text = quoted-string + warn-date = <"> HTTP-date <"> + + A response MAY carry more than one Warning header. + + The warn-text SHOULD be in a natural language and character set that + is most likely to be intelligible to the human user receiving the + response. This decision MAY be based on any available knowledge, such + as the location of the cache or user, the Accept-Language field in a + request, the Content-Language field in a response, etc. The default + language is English and the default character set is ISO-8859-1. + + If a character set other than ISO-8859-1 is used, it MUST be encoded + in the warn-text using the method described in RFC 2047 [14]. + + Warning headers can in general be applied to any message, however + some specific warn-codes are specific to caches and can only be + applied to response messages. New Warning headers SHOULD be added + after any existing Warning headers. A cache MUST NOT delete any + Warning header that it received with a message. However, if a cache + successfully validates a cache entry, it SHOULD remove any Warning + headers previously attached to that entry except as specified for + + + + +Fielding, et al. Standards Track [Page 148] + +RFC 2616 HTTP/1.1 June 1999 + + + specific Warning codes. It MUST then add any Warning headers received + in the validating response. In other words, Warning headers are those + that would be attached to the most recent relevant response. + + When multiple Warning headers are attached to a response, the user + agent ought to inform the user of as many of them as possible, in the + order that they appear in the response. If it is not possible to + inform the user of all of the warnings, the user agent SHOULD follow + these heuristics: + + - Warnings that appear early in the response take priority over + those appearing later in the response. + + - Warnings in the user's preferred character set take priority + over warnings in other character sets but with identical warn- + codes and warn-agents. + + Systems that generate multiple Warning headers SHOULD order them with + this user agent behavior in mind. + + Requirements for the behavior of caches with respect to Warnings are + stated in section 13.1.2. + + This is a list of the currently-defined warn-codes, each with a + recommended warn-text in English, and a description of its meaning. + + 110 Response is stale + MUST be included whenever the returned response is stale. + + 111 Revalidation failed + MUST be included if a cache returns a stale response because an + attempt to revalidate the response failed, due to an inability to + reach the server. + + 112 Disconnected operation + SHOULD be included if the cache is intentionally disconnected from + the rest of the network for a period of time. + + 113 Heuristic expiration + MUST be included if the cache heuristically chose a freshness + lifetime greater than 24 hours and the response's age is greater + than 24 hours. + + 199 Miscellaneous warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action, besides presenting the warning to + the user. + + + +Fielding, et al. Standards Track [Page 149] + +RFC 2616 HTTP/1.1 June 1999 + + + 214 Transformation applied + MUST be added by an intermediate cache or proxy if it applies any + transformation changing the content-coding (as specified in the + Content-Encoding header) or media-type (as specified in the + Content-Type header) of the response, or the entity-body of the + response, unless this Warning code already appears in the response. + + 299 Miscellaneous persistent warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action. + + If an implementation sends a message with one or more Warning headers + whose version is HTTP/1.0 or lower, then the sender MUST include in + each warning-value a warn-date that matches the date in the response. + + If an implementation receives a message with a warning-value that + includes a warn-date, and that warn-date is different from the Date + value in the response, then that warning-value MUST be deleted from + the message before storing, forwarding, or using it. (This prevents + bad consequences of naive caching of Warning header fields.) If all + of the warning-values are deleted for this reason, the Warning header + MUST be deleted as well. + +14.47 WWW-Authenticate + + The WWW-Authenticate response-header field MUST be included in 401 + (Unauthorized) response messages. The field value consists of at + least one challenge that indicates the authentication scheme(s) and + parameters applicable to the Request-URI. + + WWW-Authenticate = "WWW-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. User + agents are advised to take special care in parsing the WWW- + Authenticate field value as it might contain more than one challenge, + or if more than one WWW-Authenticate header field is provided, the + contents of a challenge itself can contain a comma-separated list of + authentication parameters. + +15 Security Considerations + + This section is meant to inform application developers, information + providers, and users of the security limitations in HTTP/1.1 as + described by this document. The discussion does not include + definitive solutions to the problems revealed, though it does make + some suggestions for reducing security risks. + + + +Fielding, et al. Standards Track [Page 150] + +RFC 2616 HTTP/1.1 June 1999 + + +15.1 Personal Information + + HTTP clients are often privy to large amounts of personal information + (e.g. the user's name, location, mail address, passwords, encryption + keys, etc.), and SHOULD be very careful to prevent unintentional + leakage of this information via the HTTP protocol to other sources. + We very strongly recommend that a convenient interface be provided + for the user to control dissemination of such information, and that + designers and implementors be particularly careful in this area. + History shows that errors in this area often create serious security + and/or privacy problems and generate highly adverse publicity for the + implementor's company. + +15.1.1 Abuse of Server Log Information + + A server is in the position to save personal data about a user's + requests which might identify their reading patterns or subjects of + interest. This information is clearly confidential in nature and its + handling can be constrained by law in certain countries. People using + the HTTP protocol to provide data are responsible for ensuring that + such material is not distributed without the permission of any + individuals that are identifiable by the published results. + +15.1.2 Transfer of Sensitive Information + + Like any generic data transfer protocol, HTTP cannot regulate the + content of the data that is transferred, nor is there any a priori + method of determining the sensitivity of any particular piece of + information within the context of any given request. Therefore, + applications SHOULD supply as much control over this information as + possible to the provider of that information. Four header fields are + worth special mention in this context: Server, Via, Referer and From. + + Revealing the specific software version of the server might allow the + server machine to become more vulnerable to attacks against software + that is known to contain security holes. Implementors SHOULD make the + Server header field a configurable option. + + Proxies which serve as a portal through a network firewall SHOULD + take special precautions regarding the transfer of header information + that identifies the hosts behind the firewall. In particular, they + SHOULD remove, or replace with sanitized versions, any Via fields + generated behind the firewall. + + The Referer header allows reading patterns to be studied and reverse + links drawn. Although it can be very useful, its power can be abused + if user details are not separated from the information contained in + + + + +Fielding, et al. Standards Track [Page 151] + +RFC 2616 HTTP/1.1 June 1999 + + + the Referer. Even when the personal information has been removed, the + Referer header might indicate a private document's URI whose + publication would be inappropriate. + + The information sent in the From field might conflict with the user's + privacy interests or their site's security policy, and hence it + SHOULD NOT be transmitted without the user being able to disable, + enable, and modify the contents of the field. The user MUST be able + to set the contents of this field within a user preference or + application defaults configuration. + + We suggest, though do not require, that a convenient toggle interface + be provided for the user to enable or disable the sending of From and + Referer information. + + The User-Agent (section 14.43) or Server (section 14.38) header + fields can sometimes be used to determine that a specific client or + server have a particular security hole which might be exploited. + Unfortunately, this same information is often used for other valuable + purposes for which HTTP currently has no better mechanism. + +15.1.3 Encoding Sensitive Information in URI's + + Because the source of a link might be private information or might + reveal an otherwise private information source, it is strongly + recommended that the user be able to select whether or not the + Referer field is sent. For example, a browser client could have a + toggle switch for browsing openly/anonymously, which would + respectively enable/disable the sending of Referer and From + information. + + Clients SHOULD NOT include a Referer header field in a (non-secure) + HTTP request if the referring page was transferred with a secure + protocol. + + Authors of services which use the HTTP protocol SHOULD NOT use GET + based forms for the submission of sensitive data, because this will + cause this data to be encoded in the Request-URI. Many existing + servers, proxies, and user agents will log the request URI in some + place where it might be visible to third parties. Servers can use + POST-based form submission instead + +15.1.4 Privacy Issues Connected to Accept Headers + + Accept request-headers can reveal information about the user to all + servers which are accessed. The Accept-Language header in particular + can reveal information the user would consider to be of a private + nature, because the understanding of particular languages is often + + + +Fielding, et al. Standards Track [Page 152] + +RFC 2616 HTTP/1.1 June 1999 + + + strongly correlated to the membership of a particular ethnic group. + User agents which offer the option to configure the contents of an + Accept-Language header to be sent in every request are strongly + encouraged to let the configuration process include a message which + makes the user aware of the loss of privacy involved. + + An approach that limits the loss of privacy would be for a user agent + to omit the sending of Accept-Language headers by default, and to ask + the user whether or not to start sending Accept-Language headers to a + server if it detects, by looking for any Vary response-header fields + generated by the server, that such sending could improve the quality + of service. + + Elaborate user-customized accept header fields sent in every request, + in particular if these include quality values, can be used by servers + as relatively reliable and long-lived user identifiers. Such user + identifiers would allow content providers to do click-trail tracking, + and would allow collaborating content providers to match cross-server + click-trails or form submissions of individual users. Note that for + many users not behind a proxy, the network address of the host + running the user agent will also serve as a long-lived user + identifier. In environments where proxies are used to enhance + privacy, user agents ought to be conservative in offering accept + header configuration options to end users. As an extreme privacy + measure, proxies could filter the accept headers in relayed requests. + General purpose user agents which provide a high degree of header + configurability SHOULD warn users about the loss of privacy which can + be involved. + +15.2 Attacks Based On File and Path Names + + Implementations of HTTP origin servers SHOULD be careful to restrict + the documents returned by HTTP requests to be only those that were + intended by the server administrators. If an HTTP server translates + HTTP URIs directly into file system calls, the server MUST take + special care not to serve files that were not intended to be + delivered to HTTP clients. For example, UNIX, Microsoft Windows, and + other operating systems use ".." as a path component to indicate a + directory level above the current one. On such a system, an HTTP + server MUST disallow any such construct in the Request-URI if it + would otherwise allow access to a resource outside those intended to + be accessible via the HTTP server. Similarly, files intended for + reference only internally to the server (such as access control + files, configuration files, and script code) MUST be protected from + inappropriate retrieval, since they might contain sensitive + information. Experience has shown that minor bugs in such HTTP server + implementations have turned into security risks. + + + + +Fielding, et al. Standards Track [Page 153] + +RFC 2616 HTTP/1.1 June 1999 + + +15.3 DNS Spoofing + + Clients using HTTP rely heavily on the Domain Name Service, and are + thus generally prone to security attacks based on the deliberate + mis-association of IP addresses and DNS names. Clients need to be + cautious in assuming the continuing validity of an IP number/DNS name + association. + + In particular, HTTP clients SHOULD rely on their name resolver for + confirmation of an IP number/DNS name association, rather than + caching the result of previous host name lookups. Many platforms + already can cache host name lookups locally when appropriate, and + they SHOULD be configured to do so. It is proper for these lookups to + be cached, however, only when the TTL (Time To Live) information + reported by the name server makes it likely that the cached + information will remain useful. + + If HTTP clients cache the results of host name lookups in order to + achieve a performance improvement, they MUST observe the TTL + information reported by DNS. + + If HTTP clients do not observe this rule, they could be spoofed when + a previously-accessed server's IP address changes. As network + renumbering is expected to become increasingly common [24], the + possibility of this form of attack will grow. Observing this + requirement thus reduces this potential security vulnerability. + + This requirement also improves the load-balancing behavior of clients + for replicated servers using the same DNS name and reduces the + likelihood of a user's experiencing failure in accessing sites which + use that strategy. + +15.4 Location Headers and Spoofing + + If a single server supports multiple organizations that do not trust + one another, then it MUST check the values of Location and Content- + Location headers in responses that are generated under control of + said organizations to make sure that they do not attempt to + invalidate resources over which they have no authority. + +15.5 Content-Disposition Issues + + RFC 1806 [35], from which the often implemented Content-Disposition + (see section 19.5.1) header in HTTP is derived, has a number of very + serious security considerations. Content-Disposition is not part of + the HTTP standard, but since it is widely implemented, we are + documenting its use and risks for implementors. See RFC 2183 [49] + (which updates RFC 1806) for details. + + + +Fielding, et al. Standards Track [Page 154] + +RFC 2616 HTTP/1.1 June 1999 + + +15.6 Authentication Credentials and Idle Clients + + Existing HTTP clients and user agents typically retain authentication + information indefinitely. HTTP/1.1. does not provide a method for a + server to direct clients to discard these cached credentials. This is + a significant defect that requires further extensions to HTTP. + Circumstances under which credential caching can interfere with the + application's security model include but are not limited to: + + - Clients which have been idle for an extended period following + which the server might wish to cause the client to reprompt the + user for credentials. + + - Applications which include a session termination indication + (such as a `logout' or `commit' button on a page) after which + the server side of the application `knows' that there is no + further reason for the client to retain the credentials. + + This is currently under separate study. There are a number of work- + arounds to parts of this problem, and we encourage the use of + password protection in screen savers, idle time-outs, and other + methods which mitigate the security problems inherent in this + problem. In particular, user agents which cache credentials are + encouraged to provide a readily accessible mechanism for discarding + cached credentials under user control. + +15.7 Proxies and Caching + + By their very nature, HTTP proxies are men-in-the-middle, and + represent an opportunity for man-in-the-middle attacks. Compromise of + the systems on which the proxies run can result in serious security + and privacy problems. Proxies have access to security-related + information, personal information about individual users and + organizations, and proprietary information belonging to users and + content providers. A compromised proxy, or a proxy implemented or + configured without regard to security and privacy considerations, + might be used in the commission of a wide range of potential attacks. + + Proxy operators should protect the systems on which proxies run as + they would protect any system that contains or transports sensitive + information. In particular, log information gathered at proxies often + contains highly sensitive personal information, and/or information + about organizations. Log information should be carefully guarded, and + appropriate guidelines for use developed and followed. (Section + 15.1.1). + + + + + + +Fielding, et al. Standards Track [Page 155] + +RFC 2616 HTTP/1.1 June 1999 + + + Caching proxies provide additional potential vulnerabilities, since + the contents of the cache represent an attractive target for + malicious exploitation. Because cache contents persist after an HTTP + request is complete, an attack on the cache can reveal information + long after a user believes that the information has been removed from + the network. Therefore, cache contents should be protected as + sensitive information. + + Proxy implementors should consider the privacy and security + implications of their design and coding decisions, and of the + configuration options they provide to proxy operators (especially the + default configuration). + + Users of a proxy need to be aware that they are no trustworthier than + the people who run the proxy; HTTP itself cannot solve this problem. + + The judicious use of cryptography, when appropriate, may suffice to + protect against a broad range of security and privacy attacks. Such + cryptography is beyond the scope of the HTTP/1.1 specification. + +15.7.1 Denial of Service Attacks on Proxies + + They exist. They are hard to defend against. Research continues. + Beware. + +16 Acknowledgments + + This specification makes heavy use of the augmented BNF and generic + constructs defined by David H. Crocker for RFC 822 [9]. Similarly, it + reuses many of the definitions provided by Nathaniel Borenstein and + Ned Freed for MIME [7]. We hope that their inclusion in this + specification will help reduce past confusion over the relationship + between HTTP and Internet mail message formats. + + The HTTP protocol has evolved considerably over the years. It has + benefited from a large and active developer community--the many + people who have participated on the www-talk mailing list--and it is + that community which has been most responsible for the success of + HTTP and of the World-Wide Web in general. Marc Andreessen, Robert + Cailliau, Daniel W. Connolly, Bob Denny, John Franks, Jean-Francois + Groff, Phillip M. Hallam-Baker, Hakon W. Lie, Ari Luotonen, Rob + McCool, Lou Montulli, Dave Raggett, Tony Sanders, and Marc + VanHeyningen deserve special recognition for their efforts in + defining early aspects of the protocol. + + This document has benefited greatly from the comments of all those + participating in the HTTP-WG. In addition to those already mentioned, + the following individuals have contributed to this specification: + + + +Fielding, et al. Standards Track [Page 156] + +RFC 2616 HTTP/1.1 June 1999 + + + Gary Adams Ross Patterson + Harald Tveit Alvestrand Albert Lunde + Keith Ball John C. Mallery + Brian Behlendorf Jean-Philippe Martin-Flatin + Paul Burchard Mitra + Maurizio Codogno David Morris + Mike Cowlishaw Gavin Nicol + Roman Czyborra Bill Perry + Michael A. Dolan Jeffrey Perry + David J. Fiander Scott Powers + Alan Freier Owen Rees + Marc Hedlund Luigi Rizzo + Greg Herlihy David Robinson + Koen Holtman Marc Salomon + Alex Hopmann Rich Salz + Bob Jernigan Allan M. Schiffman + Shel Kaphan Jim Seidman + Rohit Khare Chuck Shotton + John Klensin Eric W. Sink + Martijn Koster Simon E. Spero + Alexei Kosut Richard N. Taylor + David M. Kristol Robert S. Thau + Daniel LaLiberte Bill (BearHeart) Weinman + Ben Laurie Francois Yergeau + Paul J. Leach Mary Ellen Zurko + Daniel DuBois Josh Cohen + + + Much of the content and presentation of the caching design is due to + suggestions and comments from individuals including: Shel Kaphan, + Paul Leach, Koen Holtman, David Morris, and Larry Masinter. + + Most of the specification of ranges is based on work originally done + by Ari Luotonen and John Franks, with additional input from Steve + Zilles. + + Thanks to the "cave men" of Palo Alto. You know who you are. + + Jim Gettys (the current editor of this document) wishes particularly + to thank Roy Fielding, the previous editor of this document, along + with John Klensin, Jeff Mogul, Paul Leach, Dave Kristol, Koen + Holtman, John Franks, Josh Cohen, Alex Hopmann, Scott Lawrence, and + Larry Masinter for their help. And thanks go particularly to Jeff + Mogul and Scott Lawrence for performing the "MUST/MAY/SHOULD" audit. + + + + + + + +Fielding, et al. Standards Track [Page 157] + +RFC 2616 HTTP/1.1 June 1999 + + + The Apache Group, Anselm Baird-Smith, author of Jigsaw, and Henrik + Frystyk implemented RFC 2068 early, and we wish to thank them for the + discovery of many of the problems that this document attempts to + rectify. + +17 References + + [1] Alvestrand, H., "Tags for the Identification of Languages", RFC + 1766, March 1995. + + [2] Anklesaria, F., McCahill, M., Lindner, P., Johnson, D., Torrey, + D. and B. Alberti, "The Internet Gopher Protocol (a distributed + document search and retrieval protocol)", RFC 1436, March 1993. + + [3] Berners-Lee, T., "Universal Resource Identifiers in WWW", RFC + 1630, June 1994. + + [4] Berners-Lee, T., Masinter, L. and M. McCahill, "Uniform Resource + Locators (URL)", RFC 1738, December 1994. + + [5] Berners-Lee, T. and D. Connolly, "Hypertext Markup Language - + 2.0", RFC 1866, November 1995. + + [6] Berners-Lee, T., Fielding, R. and H. Frystyk, "Hypertext Transfer + Protocol -- HTTP/1.0", RFC 1945, May 1996. + + [7] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part One: Format of Internet Message Bodies", + RFC 2045, November 1996. + + [8] Braden, R., "Requirements for Internet Hosts -- Communication + Layers", STD 3, RFC 1123, October 1989. + + [9] Crocker, D., "Standard for The Format of ARPA Internet Text + Messages", STD 11, RFC 822, August 1982. + + [10] Davis, F., Kahle, B., Morris, H., Salem, J., Shen, T., Wang, R., + Sui, J., and M. Grinbaum, "WAIS Interface Protocol Prototype + Functional Specification," (v1.5), Thinking Machines + Corporation, April 1990. + + [11] Fielding, R., "Relative Uniform Resource Locators", RFC 1808, + June 1995. + + [12] Horton, M. and R. Adams, "Standard for Interchange of USENET + Messages", RFC 1036, December 1987. + + + + + +Fielding, et al. Standards Track [Page 158] + +RFC 2616 HTTP/1.1 June 1999 + + + [13] Kantor, B. and P. Lapsley, "Network News Transfer Protocol", RFC + 977, February 1986. + + [14] Moore, K., "MIME (Multipurpose Internet Mail Extensions) Part + Three: Message Header Extensions for Non-ASCII Text", RFC 2047, + November 1996. + + [15] Nebel, E. and L. Masinter, "Form-based File Upload in HTML", RFC + 1867, November 1995. + + [16] Postel, J., "Simple Mail Transfer Protocol", STD 10, RFC 821, + August 1982. + + [17] Postel, J., "Media Type Registration Procedure", RFC 1590, + November 1996. + + [18] Postel, J. and J. Reynolds, "File Transfer Protocol", STD 9, RFC + 959, October 1985. + + [19] Reynolds, J. and J. Postel, "Assigned Numbers", STD 2, RFC 1700, + October 1994. + + [20] Sollins, K. and L. Masinter, "Functional Requirements for + Uniform Resource Names", RFC 1737, December 1994. + + [21] US-ASCII. Coded Character Set - 7-Bit American Standard Code for + Information Interchange. Standard ANSI X3.4-1986, ANSI, 1986. + + [22] ISO-8859. International Standard -- Information Processing -- + 8-bit Single-Byte Coded Graphic Character Sets -- + Part 1: Latin alphabet No. 1, ISO-8859-1:1987. + Part 2: Latin alphabet No. 2, ISO-8859-2, 1987. + Part 3: Latin alphabet No. 3, ISO-8859-3, 1988. + Part 4: Latin alphabet No. 4, ISO-8859-4, 1988. + Part 5: Latin/Cyrillic alphabet, ISO-8859-5, 1988. + Part 6: Latin/Arabic alphabet, ISO-8859-6, 1987. + Part 7: Latin/Greek alphabet, ISO-8859-7, 1987. + Part 8: Latin/Hebrew alphabet, ISO-8859-8, 1988. + Part 9: Latin alphabet No. 5, ISO-8859-9, 1990. + + [23] Meyers, J. and M. Rose, "The Content-MD5 Header Field", RFC + 1864, October 1995. + + [24] Carpenter, B. and Y. Rekhter, "Renumbering Needs Work", RFC + 1900, February 1996. + + [25] Deutsch, P., "GZIP file format specification version 4.3", RFC + 1952, May 1996. + + + +Fielding, et al. Standards Track [Page 159] + +RFC 2616 HTTP/1.1 June 1999 + + + [26] Venkata N. Padmanabhan, and Jeffrey C. Mogul. "Improving HTTP + Latency", Computer Networks and ISDN Systems, v. 28, pp. 25-35, + Dec. 1995. Slightly revised version of paper in Proc. 2nd + International WWW Conference '94: Mosaic and the Web, Oct. 1994, + which is available at + http://www.ncsa.uiuc.edu/SDG/IT94/Proceedings/DDay/mogul/HTTPLat + ency.html. + + [27] Joe Touch, John Heidemann, and Katia Obraczka. "Analysis of HTTP + Performance", , + ISI Research Report ISI/RR-98-463, (original report dated Aug. + 1996), USC/Information Sciences Institute, August 1998. + + [28] Mills, D., "Network Time Protocol (Version 3) Specification, + Implementation and Analysis", RFC 1305, March 1992. + + [29] Deutsch, P., "DEFLATE Compressed Data Format Specification + version 1.3", RFC 1951, May 1996. + + [30] S. Spero, "Analysis of HTTP Performance Problems," + http://sunsite.unc.edu/mdma-release/http-prob.html. + + [31] Deutsch, P. and J. Gailly, "ZLIB Compressed Data Format + Specification version 3.3", RFC 1950, May 1996. + + [32] Franks, J., Hallam-Baker, P., Hostetler, J., Leach, P., + Luotonen, A., Sink, E. and L. Stewart, "An Extension to HTTP: + Digest Access Authentication", RFC 2069, January 1997. + + [33] Fielding, R., Gettys, J., Mogul, J., Frystyk, H. and T. + Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1", RFC + 2068, January 1997. + + [34] Bradner, S., "Key words for use in RFCs to Indicate Requirement + Levels", BCP 14, RFC 2119, March 1997. + + [35] Troost, R. and Dorner, S., "Communicating Presentation + Information in Internet Messages: The Content-Disposition + Header", RFC 1806, June 1995. + + [36] Mogul, J., Fielding, R., Gettys, J. and H. Frystyk, "Use and + Interpretation of HTTP Version Numbers", RFC 2145, May 1997. + [jg639] + + [37] Palme, J., "Common Internet Message Headers", RFC 2076, February + 1997. [jg640] + + + + + +Fielding, et al. Standards Track [Page 160] + +RFC 2616 HTTP/1.1 June 1999 + + + [38] Yergeau, F., "UTF-8, a transformation format of Unicode and + ISO-10646", RFC 2279, January 1998. [jg641] + + [39] Nielsen, H.F., Gettys, J., Baird-Smith, A., Prud'hommeaux, E., + Lie, H., and C. Lilley. "Network Performance Effects of + HTTP/1.1, CSS1, and PNG," Proceedings of ACM SIGCOMM '97, Cannes + France, September 1997.[jg642] + + [40] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Two: Media Types", RFC 2046, November + 1996. [jg643] + + [41] Alvestrand, H., "IETF Policy on Character Sets and Languages", + BCP 18, RFC 2277, January 1998. [jg644] + + [42] Berners-Lee, T., Fielding, R. and L. Masinter, "Uniform Resource + Identifiers (URI): Generic Syntax and Semantics", RFC 2396, + August 1998. [jg645] + + [43] Franks, J., Hallam-Baker, P., Hostetler, J., Lawrence, S., + Leach, P., Luotonen, A., Sink, E. and L. Stewart, "HTTP + Authentication: Basic and Digest Access Authentication", RFC + 2617, June 1999. [jg646] + + [44] Luotonen, A., "Tunneling TCP based protocols through Web proxy + servers," Work in Progress. [jg647] + + [45] Palme, J. and A. Hopmann, "MIME E-mail Encapsulation of + Aggregate Documents, such as HTML (MHTML)", RFC 2110, March + 1997. + + [46] Bradner, S., "The Internet Standards Process -- Revision 3", BCP + 9, RFC 2026, October 1996. + + [47] Masinter, L., "Hyper Text Coffee Pot Control Protocol + (HTCPCP/1.0)", RFC 2324, 1 April 1998. + + [48] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Five: Conformance Criteria and Examples", + RFC 2049, November 1996. + + [49] Troost, R., Dorner, S. and K. Moore, "Communicating Presentation + Information in Internet Messages: The Content-Disposition Header + Field", RFC 2183, August 1997. + + + + + + + +Fielding, et al. Standards Track [Page 161] + +RFC 2616 HTTP/1.1 June 1999 + + +18 Authors' Addresses + + Roy T. Fielding + Information and Computer Science + University of California, Irvine + Irvine, CA 92697-3425, USA + + Fax: +1 (949) 824-1715 + EMail: fielding@ics.uci.edu + + + James Gettys + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: jg@w3.org + + + Jeffrey C. Mogul + Western Research Laboratory + Compaq Computer Corporation + 250 University Avenue + Palo Alto, California, 94305, USA + + EMail: mogul@wrl.dec.com + + + Henrik Frystyk Nielsen + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: frystyk@w3.org + + + Larry Masinter + Xerox Corporation + 3333 Coyote Hill Road + Palo Alto, CA 94034, USA + + EMail: masinter@parc.xerox.com + + + + + +Fielding, et al. Standards Track [Page 162] + +RFC 2616 HTTP/1.1 June 1999 + + + Paul J. Leach + Microsoft Corporation + 1 Microsoft Way + Redmond, WA 98052, USA + + EMail: paulle@microsoft.com + + + Tim Berners-Lee + Director, World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: timbl@w3.org + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 163] + +RFC 2616 HTTP/1.1 June 1999 + + +19 Appendices + +19.1 Internet Media Type message/http and application/http + + In addition to defining the HTTP/1.1 protocol, this document serves + as the specification for the Internet media type "message/http" and + "application/http". The message/http type can be used to enclose a + single HTTP request or response message, provided that it obeys the + MIME restrictions for all "message" types regarding line length and + encodings. The application/http type can be used to enclose a + pipeline of one or more HTTP request or response messages (not + intermixed). The following is to be registered with IANA [17]. + + Media Type name: message + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed message + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + Media Type name: application + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed messages + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: HTTP messages enclosed by this type + are in "binary" format; use of an appropriate + Content-Transfer-Encoding is required when + transmitted via E-mail. + Security considerations: none + + + + + + + + + +Fielding, et al. Standards Track [Page 164] + +RFC 2616 HTTP/1.1 June 1999 + + +19.2 Internet Media Type multipart/byteranges + + When an HTTP 206 (Partial Content) response message includes the + content of multiple ranges (a response to a request for multiple + non-overlapping ranges), these are transmitted as a multipart + message-body. The media type for this purpose is called + "multipart/byteranges". + + The multipart/byteranges media type includes two or more parts, each + with its own Content-Type and Content-Range fields. The required + boundary parameter specifies the boundary string used to separate + each body-part. + + Media Type name: multipart + Media subtype name: byteranges + Required parameters: boundary + Optional parameters: none + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + + For example: + + HTTP/1.1 206 Partial Content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-type: multipart/byteranges; boundary=THIS_STRING_SEPARATES + + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 500-999/8000 + + ...the first range... + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 7000-7999/8000 + + ...the second range + --THIS_STRING_SEPARATES-- + + Notes: + + 1) Additional CRLFs may precede the first boundary string in the + entity. + + + + + + +Fielding, et al. Standards Track [Page 165] + +RFC 2616 HTTP/1.1 June 1999 + + + 2) Although RFC 2046 [40] permits the boundary string to be + quoted, some existing implementations handle a quoted boundary + string incorrectly. + + 3) A number of browsers and servers were coded to an early draft + of the byteranges specification to use a media type of + multipart/x-byteranges, which is almost, but not quite + compatible with the version documented in HTTP/1.1. + +19.3 Tolerant Applications + + Although this document specifies the requirements for the generation + of HTTP/1.1 messages, not all applications will be correct in their + implementation. We therefore recommend that operational applications + be tolerant of deviations whenever those deviations can be + interpreted unambiguously. + + Clients SHOULD be tolerant in parsing the Status-Line and servers + tolerant when parsing the Request-Line. In particular, they SHOULD + accept any amount of SP or HT characters between fields, even though + only a single SP is required. + + The line terminator for message-header fields is the sequence CRLF. + However, we recommend that applications, when parsing such headers, + recognize a single LF as a line terminator and ignore the leading CR. + + The character set of an entity-body SHOULD be labeled as the lowest + common denominator of the character codes used within that body, with + the exception that not labeling the entity is preferred over labeling + the entity with the labels US-ASCII or ISO-8859-1. See section 3.7.1 + and 3.4.1. + + Additional rules for requirements on parsing and encoding of dates + and other potential problems with date encodings include: + + - HTTP/1.1 clients and caches SHOULD assume that an RFC-850 date + which appears to be more than 50 years in the future is in fact + in the past (this helps solve the "year 2000" problem). + + - An HTTP/1.1 implementation MAY internally represent a parsed + Expires date as earlier than the proper value, but MUST NOT + internally represent a parsed Expires date as later than the + proper value. + + - All expiration-related calculations MUST be done in GMT. The + local time zone MUST NOT influence the calculation or comparison + of an age or expiration time. + + + + +Fielding, et al. Standards Track [Page 166] + +RFC 2616 HTTP/1.1 June 1999 + + + - If an HTTP header incorrectly carries a date value with a time + zone other than GMT, it MUST be converted into GMT using the + most conservative possible conversion. + +19.4 Differences Between HTTP Entities and RFC 2045 Entities + + HTTP/1.1 uses many of the constructs defined for Internet Mail (RFC + 822 [9]) and the Multipurpose Internet Mail Extensions (MIME [7]) to + allow entities to be transmitted in an open variety of + representations and with extensible mechanisms. However, RFC 2045 + discusses mail, and HTTP has a few features that are different from + those described in RFC 2045. These differences were carefully chosen + to optimize performance over binary connections, to allow greater + freedom in the use of new media types, to make date comparisons + easier, and to acknowledge the practice of some early HTTP servers + and clients. + + This appendix describes specific areas where HTTP differs from RFC + 2045. Proxies and gateways to strict MIME environments SHOULD be + aware of these differences and provide the appropriate conversions + where necessary. Proxies and gateways from MIME environments to HTTP + also need to be aware of the differences because some conversions + might be required. + +19.4.1 MIME-Version + + HTTP is not a MIME-compliant protocol. However, HTTP/1.1 messages MAY + include a single MIME-Version general-header field to indicate what + version of the MIME protocol was used to construct the message. Use + of the MIME-Version header field indicates that the message is in + full compliance with the MIME protocol (as defined in RFC 2045[7]). + Proxies/gateways are responsible for ensuring full compliance (where + possible) when exporting HTTP messages to strict MIME environments. + + MIME-Version = "MIME-Version" ":" 1*DIGIT "." 1*DIGIT + + MIME version "1.0" is the default for use in HTTP/1.1. However, + HTTP/1.1 message parsing and semantics are defined by this document + and not the MIME specification. + +19.4.2 Conversion to Canonical Form + + RFC 2045 [7] requires that an Internet mail entity be converted to + canonical form prior to being transferred, as described in section 4 + of RFC 2049 [48]. Section 3.7.1 of this document describes the forms + allowed for subtypes of the "text" media type when transmitted over + HTTP. RFC 2046 requires that content with a type of "text" represent + line breaks as CRLF and forbids the use of CR or LF outside of line + + + +Fielding, et al. Standards Track [Page 167] + +RFC 2616 HTTP/1.1 June 1999 + + + break sequences. HTTP allows CRLF, bare CR, and bare LF to indicate a + line break within text content when a message is transmitted over + HTTP. + + Where it is possible, a proxy or gateway from HTTP to a strict MIME + environment SHOULD translate all line breaks within the text media + types described in section 3.7.1 of this document to the RFC 2049 + canonical form of CRLF. Note, however, that this might be complicated + by the presence of a Content-Encoding and by the fact that HTTP + allows the use of some character sets which do not use octets 13 and + 10 to represent CR and LF, as is the case for some multi-byte + character sets. + + Implementors should note that conversion will break any cryptographic + checksums applied to the original content unless the original content + is already in canonical form. Therefore, the canonical form is + recommended for any content that uses such checksums in HTTP. + +19.4.3 Conversion of Date Formats + + HTTP/1.1 uses a restricted set of date formats (section 3.3.1) to + simplify the process of date comparison. Proxies and gateways from + other protocols SHOULD ensure that any Date header field present in a + message conforms to one of the HTTP/1.1 formats and rewrite the date + if necessary. + +19.4.4 Introduction of Content-Encoding + + RFC 2045 does not include any concept equivalent to HTTP/1.1's + Content-Encoding header field. Since this acts as a modifier on the + media type, proxies and gateways from HTTP to MIME-compliant + protocols MUST either change the value of the Content-Type header + field or decode the entity-body before forwarding the message. (Some + experimental applications of Content-Type for Internet mail have used + a media-type parameter of ";conversions=" to perform + a function equivalent to Content-Encoding. However, this parameter is + not part of RFC 2045.) + +19.4.5 No Content-Transfer-Encoding + + HTTP does not use the Content-Transfer-Encoding (CTE) field of RFC + 2045. Proxies and gateways from MIME-compliant protocols to HTTP MUST + remove any non-identity CTE ("quoted-printable" or "base64") encoding + prior to delivering the response message to an HTTP client. + + Proxies and gateways from HTTP to MIME-compliant protocols are + responsible for ensuring that the message is in the correct format + and encoding for safe transport on that protocol, where "safe + + + +Fielding, et al. Standards Track [Page 168] + +RFC 2616 HTTP/1.1 June 1999 + + + transport" is defined by the limitations of the protocol being used. + Such a proxy or gateway SHOULD label the data with an appropriate + Content-Transfer-Encoding if doing so will improve the likelihood of + safe transport over the destination protocol. + +19.4.6 Introduction of Transfer-Encoding + + HTTP/1.1 introduces the Transfer-Encoding header field (section + 14.41). Proxies/gateways MUST remove any transfer-coding prior to + forwarding a message via a MIME-compliant protocol. + + A process for decoding the "chunked" transfer-coding (section 3.6) + can be represented in pseudo-code as: + + length := 0 + read chunk-size, chunk-extension (if any) and CRLF + while (chunk-size > 0) { + read chunk-data and CRLF + append chunk-data to entity-body + length := length + chunk-size + read chunk-size and CRLF + } + read entity-header + while (entity-header not empty) { + append entity-header to existing header fields + read entity-header + } + Content-Length := length + Remove "chunked" from Transfer-Encoding + +19.4.7 MHTML and Line Length Limitations + + HTTP implementations which share code with MHTML [45] implementations + need to be aware of MIME line length limitations. Since HTTP does not + have this limitation, HTTP does not fold long lines. MHTML messages + being transported by HTTP follow all conventions of MHTML, including + line length limitations and folding, canonicalization, etc., since + HTTP transports all message-bodies as payload (see section 3.7.2) and + does not interpret the content or any MIME header lines that might be + contained therein. + +19.5 Additional Features + + RFC 1945 and RFC 2068 document protocol elements used by some + existing HTTP implementations, but not consistently and correctly + across most HTTP/1.1 applications. Implementors are advised to be + aware of these features, but cannot rely upon their presence in, or + interoperability with, other HTTP/1.1 applications. Some of these + + + +Fielding, et al. Standards Track [Page 169] + +RFC 2616 HTTP/1.1 June 1999 + + + describe proposed experimental features, and some describe features + that experimental deployment found lacking that are now addressed in + the base HTTP/1.1 specification. + + A number of other headers, such as Content-Disposition and Title, + from SMTP and MIME are also often implemented (see RFC 2076 [37]). + +19.5.1 Content-Disposition + + The Content-Disposition response-header field has been proposed as a + means for the origin server to suggest a default filename if the user + requests that the content is saved to a file. This usage is derived + from the definition of Content-Disposition in RFC 1806 [35]. + + content-disposition = "Content-Disposition" ":" + disposition-type *( ";" disposition-parm ) + disposition-type = "attachment" | disp-extension-token + disposition-parm = filename-parm | disp-extension-parm + filename-parm = "filename" "=" quoted-string + disp-extension-token = token + disp-extension-parm = token "=" ( token | quoted-string ) + + An example is + + Content-Disposition: attachment; filename="fname.ext" + + The receiving user agent SHOULD NOT respect any directory path + information present in the filename-parm parameter, which is the only + parameter believed to apply to HTTP implementations at this time. The + filename SHOULD be treated as a terminal component only. + + If this header is used in a response with the application/octet- + stream content-type, the implied suggestion is that the user agent + should not display the response, but directly enter a `save response + as...' dialog. + + See section 15.5 for Content-Disposition security issues. + +19.6 Compatibility with Previous Versions + + It is beyond the scope of a protocol specification to mandate + compliance with previous versions. HTTP/1.1 was deliberately + designed, however, to make supporting previous versions easy. It is + worth noting that, at the time of composing this specification + (1996), we would expect commercial HTTP/1.1 servers to: + + - recognize the format of the Request-Line for HTTP/0.9, 1.0, and + 1.1 requests; + + + +Fielding, et al. Standards Track [Page 170] + +RFC 2616 HTTP/1.1 June 1999 + + + - understand any valid request in the format of HTTP/0.9, 1.0, or + 1.1; + + - respond appropriately with a message in the same major version + used by the client. + + And we would expect HTTP/1.1 clients to: + + - recognize the format of the Status-Line for HTTP/1.0 and 1.1 + responses; + + - understand any valid response in the format of HTTP/0.9, 1.0, or + 1.1. + + For most implementations of HTTP/1.0, each connection is established + by the client prior to the request and closed by the server after + sending the response. Some implementations implement the Keep-Alive + version of persistent connections described in section 19.7.1 of RFC + 2068 [33]. + +19.6.1 Changes from HTTP/1.0 + + This section summarizes major differences between versions HTTP/1.0 + and HTTP/1.1. + +19.6.1.1 Changes to Simplify Multi-homed Web Servers and Conserve IP + Addresses + + The requirements that clients and servers support the Host request- + header, report an error if the Host request-header (section 14.23) is + missing from an HTTP/1.1 request, and accept absolute URIs (section + 5.1.2) are among the most important changes defined by this + specification. + + Older HTTP/1.0 clients assumed a one-to-one relationship of IP + addresses and servers; there was no other established mechanism for + distinguishing the intended server of a request than the IP address + to which that request was directed. The changes outlined above will + allow the Internet, once older HTTP clients are no longer common, to + support multiple Web sites from a single IP address, greatly + simplifying large operational Web servers, where allocation of many + IP addresses to a single host has created serious problems. The + Internet will also be able to recover the IP addresses that have been + allocated for the sole purpose of allowing special-purpose domain + names to be used in root-level HTTP URLs. Given the rate of growth of + the Web, and the number of servers already deployed, it is extremely + + + + + +Fielding, et al. Standards Track [Page 171] + +RFC 2616 HTTP/1.1 June 1999 + + + important that all implementations of HTTP (including updates to + existing HTTP/1.0 applications) correctly implement these + requirements: + + - Both clients and servers MUST support the Host request-header. + + - A client that sends an HTTP/1.1 request MUST send a Host header. + + - Servers MUST report a 400 (Bad Request) error if an HTTP/1.1 + request does not include a Host request-header. + + - Servers MUST accept absolute URIs. + +19.6.2 Compatibility with HTTP/1.0 Persistent Connections + + Some clients and servers might wish to be compatible with some + previous implementations of persistent connections in HTTP/1.0 + clients and servers. Persistent connections in HTTP/1.0 are + explicitly negotiated as they are not the default behavior. HTTP/1.0 + experimental implementations of persistent connections are faulty, + and the new facilities in HTTP/1.1 are designed to rectify these + problems. The problem was that some existing 1.0 clients may be + sending Keep-Alive to a proxy server that doesn't understand + Connection, which would then erroneously forward it to the next + inbound server, which would establish the Keep-Alive connection and + result in a hung HTTP/1.0 proxy waiting for the close on the + response. The result is that HTTP/1.0 clients must be prevented from + using Keep-Alive when talking to proxies. + + However, talking to proxies is the most important use of persistent + connections, so that prohibition is clearly unacceptable. Therefore, + we need some other mechanism for indicating a persistent connection + is desired, which is safe to use even when talking to an old proxy + that ignores Connection. Persistent connections are the default for + HTTP/1.1 messages; we introduce a new keyword (Connection: close) for + declaring non-persistence. See section 14.10. + + The original HTTP/1.0 form of persistent connections (the Connection: + Keep-Alive and Keep-Alive header) is documented in RFC 2068. [33] + +19.6.3 Changes from RFC 2068 + + This specification has been carefully audited to correct and + disambiguate key word usage; RFC 2068 had many problems in respect to + the conventions laid out in RFC 2119 [34]. + + Clarified which error code should be used for inbound server failures + (e.g. DNS failures). (Section 10.5.5). + + + +Fielding, et al. Standards Track [Page 172] + +RFC 2616 HTTP/1.1 June 1999 + + + CREATE had a race that required an Etag be sent when a resource is + first created. (Section 10.2.2). + + Content-Base was deleted from the specification: it was not + implemented widely, and there is no simple, safe way to introduce it + without a robust extension mechanism. In addition, it is used in a + similar, but not identical fashion in MHTML [45]. + + Transfer-coding and message lengths all interact in ways that + required fixing exactly when chunked encoding is used (to allow for + transfer encoding that may not be self delimiting); it was important + to straighten out exactly how message lengths are computed. (Sections + 3.6, 4.4, 7.2.2, 13.5.2, 14.13, 14.16) + + A content-coding of "identity" was introduced, to solve problems + discovered in caching. (section 3.5) + + Quality Values of zero should indicate that "I don't want something" + to allow clients to refuse a representation. (Section 3.9) + + The use and interpretation of HTTP version numbers has been clarified + by RFC 2145. Require proxies to upgrade requests to highest protocol + version they support to deal with problems discovered in HTTP/1.0 + implementations (Section 3.1) + + Charset wildcarding is introduced to avoid explosion of character set + names in accept headers. (Section 14.2) + + A case was missed in the Cache-Control model of HTTP/1.1; s-maxage + was introduced to add this missing case. (Sections 13.4, 14.8, 14.9, + 14.9.3) + + The Cache-Control: max-age directive was not properly defined for + responses. (Section 14.9.3) + + There are situations where a server (especially a proxy) does not + know the full length of a response but is capable of serving a + byterange request. We therefore need a mechanism to allow byteranges + with a content-range not indicating the full length of the message. + (Section 14.16) + + Range request responses would become very verbose if all meta-data + were always returned; by allowing the server to only send needed + headers in a 206 response, this problem can be avoided. (Section + 10.2.7, 13.5.3, and 14.27) + + + + + + +Fielding, et al. Standards Track [Page 173] + +RFC 2616 HTTP/1.1 June 1999 + + + Fix problem with unsatisfiable range requests; there are two cases: + syntactic problems, and range doesn't exist in the document. The 416 + status code was needed to resolve this ambiguity needed to indicate + an error for a byte range request that falls outside of the actual + contents of a document. (Section 10.4.17, 14.16) + + Rewrite of message transmission requirements to make it much harder + for implementors to get it wrong, as the consequences of errors here + can have significant impact on the Internet, and to deal with the + following problems: + + 1. Changing "HTTP/1.1 or later" to "HTTP/1.1", in contexts where + this was incorrectly placing a requirement on the behavior of + an implementation of a future version of HTTP/1.x + + 2. Made it clear that user-agents should retry requests, not + "clients" in general. + + 3. Converted requirements for clients to ignore unexpected 100 + (Continue) responses, and for proxies to forward 100 responses, + into a general requirement for 1xx responses. + + 4. Modified some TCP-specific language, to make it clearer that + non-TCP transports are possible for HTTP. + + 5. Require that the origin server MUST NOT wait for the request + body before it sends a required 100 (Continue) response. + + 6. Allow, rather than require, a server to omit 100 (Continue) if + it has already seen some of the request body. + + 7. Allow servers to defend against denial-of-service attacks and + broken clients. + + This change adds the Expect header and 417 status code. The message + transmission requirements fixes are in sections 8.2, 10.4.18, + 8.1.2.2, 13.11, and 14.20. + + Proxies should be able to add Content-Length when appropriate. + (Section 13.5.2) + + Clean up confusion between 403 and 404 responses. (Section 10.4.4, + 10.4.5, and 10.4.11) + + Warnings could be cached incorrectly, or not updated appropriately. + (Section 13.1.2, 13.2.4, 13.5.2, 13.5.3, 14.9.3, and 14.46) Warning + also needed to be a general header, as PUT or other methods may have + need for it in requests. + + + +Fielding, et al. Standards Track [Page 174] + +RFC 2616 HTTP/1.1 June 1999 + + + Transfer-coding had significant problems, particularly with + interactions with chunked encoding. The solution is that transfer- + codings become as full fledged as content-codings. This involves + adding an IANA registry for transfer-codings (separate from content + codings), a new header field (TE) and enabling trailer headers in the + future. Transfer encoding is a major performance benefit, so it was + worth fixing [39]. TE also solves another, obscure, downward + interoperability problem that could have occurred due to interactions + between authentication trailers, chunked encoding and HTTP/1.0 + clients.(Section 3.6, 3.6.1, and 14.39) + + The PATCH, LINK, UNLINK methods were defined but not commonly + implemented in previous versions of this specification. See RFC 2068 + [33]. + + The Alternates, Content-Version, Derived-From, Link, URI, Public and + Content-Base header fields were defined in previous versions of this + specification, but not commonly implemented. See RFC 2068 [33]. + +20 Index + + Please see the PostScript version of this RFC for the INDEX. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 175] + +RFC 2616 HTTP/1.1 June 1999 + + +21. Full Copyright Statement + + Copyright (C) The Internet Society (1999). All Rights Reserved. + + This document and translations of it may be copied and furnished to + others, and derivative works that comment on or otherwise explain it + or assist in its implementation may be prepared, copied, published + and distributed, in whole or in part, without restriction of any + kind, provided that the above copyright notice and this paragraph are + included on all such copies and derivative works. However, this + document itself may not be modified in any way, such as by removing + the copyright notice or references to the Internet Society or other + Internet organizations, except as needed for the purpose of + developing Internet standards in which case the procedures for + copyrights defined in the Internet Standards process must be + followed, or as required to translate it into languages other than + English. + + The limited permissions granted above are perpetual and will not be + revoked by the Internet Society or its successors or assigns. + + This document and the information contained herein is provided on an + "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING + TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING + BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION + HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF + MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + +Acknowledgement + + Funding for the RFC Editor function is currently provided by the + Internet Society. + + Network Working Group R. Fielding +Request for Comments: 2616 UC Irvine +Obsoletes: 2068 J. Gettys +Category: Standards Track Compaq/W3C + J. Mogul + Compaq + H. Frystyk + W3C/MIT + L. Masinter + Xerox + P. Leach + Microsoft + T. Berners-Lee + W3C/MIT + June 1999 + + + Hypertext Transfer Protocol -- HTTP/1.1 + +Status of this Memo + + This document specifies an Internet standards track protocol for the + Internet community, and requests discussion and suggestions for + improvements. Please refer to the current edition of the "Internet + Official Protocol Standards" (STD 1) for the standardization state + and status of this protocol. Distribution of this memo is unlimited. + +Copyright Notice + + Copyright (C) The Internet Society (1999). All Rights Reserved. + +Abstract + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. It is a generic, stateless, protocol which can be used for + many tasks beyond its use for hypertext, such as name servers and + distributed object management systems, through extension of its + request methods, error codes and headers [47]. A feature of HTTP is + the typing and negotiation of data representation, allowing systems + to be built independently of the data being transferred. + + HTTP has been in use by the World-Wide Web global information + initiative since 1990. This specification defines the protocol + referred to as "HTTP/1.1", and is an update to RFC 2068 [33]. + + + + + + +Fielding, et al. Standards Track [Page 1] + +RFC 2616 HTTP/1.1 June 1999 + + +Table of Contents + + 1 Introduction ...................................................7 + 1.1 Purpose......................................................7 + 1.2 Requirements .................................................8 + 1.3 Terminology ..................................................8 + 1.4 Overall Operation ...........................................12 + 2 Notational Conventions and Generic Grammar ....................14 + 2.1 Augmented BNF ...............................................14 + 2.2 Basic Rules .................................................15 + 3 Protocol Parameters ...........................................17 + 3.1 HTTP Version ................................................17 + 3.2 Uniform Resource Identifiers ................................18 + 3.2.1 General Syntax ...........................................19 + 3.2.2 http URL .................................................19 + 3.2.3 URI Comparison ...........................................20 + 3.3 Date/Time Formats ...........................................20 + 3.3.1 Full Date ................................................20 + 3.3.2 Delta Seconds ............................................21 + 3.4 Character Sets ..............................................21 + 3.4.1 Missing Charset ..........................................22 + 3.5 Content Codings .............................................23 + 3.6 Transfer Codings ............................................24 + 3.6.1 Chunked Transfer Coding ..................................25 + 3.7 Media Types .................................................26 + 3.7.1 Canonicalization and Text Defaults .......................27 + 3.7.2 Multipart Types ..........................................27 + 3.8 Product Tokens ..............................................28 + 3.9 Quality Values ..............................................29 + 3.10 Language Tags ...............................................29 + 3.11 Entity Tags .................................................30 + 3.12 Range Units .................................................30 + 4 HTTP Message ..................................................31 + 4.1 Message Types ...............................................31 + 4.2 Message Headers .............................................31 + 4.3 Message Body ................................................32 + 4.4 Message Length ..............................................33 + 4.5 General Header Fields .......................................34 + 5 Request .......................................................35 + 5.1 Request-Line ................................................35 + 5.1.1 Method ...................................................36 + 5.1.2 Request-URI ..............................................36 + 5.2 The Resource Identified by a Request ........................38 + 5.3 Request Header Fields .......................................38 + 6 Response ......................................................39 + 6.1 Status-Line .................................................39 + 6.1.1 Status Code and Reason Phrase ............................39 + 6.2 Response Header Fields ......................................41 + + + +Fielding, et al. Standards Track [Page 2] + +RFC 2616 HTTP/1.1 June 1999 + + + 7 Entity ........................................................42 + 7.1 Entity Header Fields ........................................42 + 7.2 Entity Body .................................................43 + 7.2.1 Type .....................................................43 + 7.2.2 Entity Length ............................................43 + 8 Connections ...................................................44 + 8.1 Persistent Connections ......................................44 + 8.1.1 Purpose ..................................................44 + 8.1.2 Overall Operation ........................................45 + 8.1.3 Proxy Servers ............................................46 + 8.1.4 Practical Considerations .................................46 + 8.2 Message Transmission Requirements ...........................47 + 8.2.1 Persistent Connections and Flow Control ..................47 + 8.2.2 Monitoring Connections for Error Status Messages .........48 + 8.2.3 Use of the 100 (Continue) Status .........................48 + 8.2.4 Client Behavior if Server Prematurely Closes Connection ..50 + 9 Method Definitions ............................................51 + 9.1 Safe and Idempotent Methods .................................51 + 9.1.1 Safe Methods .............................................51 + 9.1.2 Idempotent Methods .......................................51 + 9.2 OPTIONS .....................................................52 + 9.3 GET .........................................................53 + 9.4 HEAD ........................................................54 + 9.5 POST ........................................................54 + 9.6 PUT .........................................................55 + 9.7 DELETE ......................................................56 + 9.8 TRACE .......................................................56 + 9.9 CONNECT .....................................................57 + 10 Status Code Definitions ......................................57 + 10.1 Informational 1xx ...........................................57 + 10.1.1 100 Continue .............................................58 + 10.1.2 101 Switching Protocols ..................................58 + 10.2 Successful 2xx ..............................................58 + 10.2.1 200 OK ...................................................58 + 10.2.2 201 Created ..............................................59 + 10.2.3 202 Accepted .............................................59 + 10.2.4 203 Non-Authoritative Information ........................59 + 10.2.5 204 No Content ...........................................60 + 10.2.6 205 Reset Content ........................................60 + 10.2.7 206 Partial Content ......................................60 + 10.3 Redirection 3xx .............................................61 + 10.3.1 300 Multiple Choices .....................................61 + 10.3.2 301 Moved Permanently ....................................62 + 10.3.3 302 Found ................................................62 + 10.3.4 303 See Other ............................................63 + 10.3.5 304 Not Modified .........................................63 + 10.3.6 305 Use Proxy ............................................64 + 10.3.7 306 (Unused) .............................................64 + + + +Fielding, et al. Standards Track [Page 3] + +RFC 2616 HTTP/1.1 June 1999 + + + 10.3.8 307 Temporary Redirect ...................................65 + 10.4 Client Error 4xx ............................................65 + 10.4.1 400 Bad Request .........................................65 + 10.4.2 401 Unauthorized ........................................66 + 10.4.3 402 Payment Required ....................................66 + 10.4.4 403 Forbidden ...........................................66 + 10.4.5 404 Not Found ...........................................66 + 10.4.6 405 Method Not Allowed ..................................66 + 10.4.7 406 Not Acceptable ......................................67 + 10.4.8 407 Proxy Authentication Required .......................67 + 10.4.9 408 Request Timeout .....................................67 + 10.4.10 409 Conflict ............................................67 + 10.4.11 410 Gone ................................................68 + 10.4.12 411 Length Required .....................................68 + 10.4.13 412 Precondition Failed .................................68 + 10.4.14 413 Request Entity Too Large ............................69 + 10.4.15 414 Request-URI Too Long ................................69 + 10.4.16 415 Unsupported Media Type ..............................69 + 10.4.17 416 Requested Range Not Satisfiable .....................69 + 10.4.18 417 Expectation Failed ..................................70 + 10.5 Server Error 5xx ............................................70 + 10.5.1 500 Internal Server Error ................................70 + 10.5.2 501 Not Implemented ......................................70 + 10.5.3 502 Bad Gateway ..........................................70 + 10.5.4 503 Service Unavailable ..................................70 + 10.5.5 504 Gateway Timeout ......................................71 + 10.5.6 505 HTTP Version Not Supported ...........................71 + 11 Access Authentication ........................................71 + 12 Content Negotiation ..........................................71 + 12.1 Server-driven Negotiation ...................................72 + 12.2 Agent-driven Negotiation ....................................73 + 12.3 Transparent Negotiation .....................................74 + 13 Caching in HTTP ..............................................74 + 13.1.1 Cache Correctness ........................................75 + 13.1.2 Warnings .................................................76 + 13.1.3 Cache-control Mechanisms .................................77 + 13.1.4 Explicit User Agent Warnings .............................78 + 13.1.5 Exceptions to the Rules and Warnings .....................78 + 13.1.6 Client-controlled Behavior ...............................79 + 13.2 Expiration Model ............................................79 + 13.2.1 Server-Specified Expiration ..............................79 + 13.2.2 Heuristic Expiration .....................................80 + 13.2.3 Age Calculations .........................................80 + 13.2.4 Expiration Calculations ..................................83 + 13.2.5 Disambiguating Expiration Values .........................84 + 13.2.6 Disambiguating Multiple Responses ........................84 + 13.3 Validation Model ............................................85 + 13.3.1 Last-Modified Dates ......................................86 + + + +Fielding, et al. Standards Track [Page 4] + +RFC 2616 HTTP/1.1 June 1999 + + + 13.3.2 Entity Tag Cache Validators ..............................86 + 13.3.3 Weak and Strong Validators ...............................86 + 13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates.89 + 13.3.5 Non-validating Conditionals ..............................90 + 13.4 Response Cacheability .......................................91 + 13.5 Constructing Responses From Caches ..........................92 + 13.5.1 End-to-end and Hop-by-hop Headers ........................92 + 13.5.2 Non-modifiable Headers ...................................92 + 13.5.3 Combining Headers ........................................94 + 13.5.4 Combining Byte Ranges ....................................95 + 13.6 Caching Negotiated Responses ................................95 + 13.7 Shared and Non-Shared Caches ................................96 + 13.8 Errors or Incomplete Response Cache Behavior ................97 + 13.9 Side Effects of GET and HEAD ................................97 + 13.10 Invalidation After Updates or Deletions ...................97 + 13.11 Write-Through Mandatory ...................................98 + 13.12 Cache Replacement .........................................99 + 13.13 History Lists .............................................99 + 14 Header Field Definitions ....................................100 + 14.1 Accept .....................................................100 + 14.2 Accept-Charset .............................................102 + 14.3 Accept-Encoding ............................................102 + 14.4 Accept-Language ............................................104 + 14.5 Accept-Ranges ..............................................105 + 14.6 Age ........................................................106 + 14.7 Allow ......................................................106 + 14.8 Authorization ..............................................107 + 14.9 Cache-Control ..............................................108 + 14.9.1 What is Cacheable .......................................109 + 14.9.2 What May be Stored by Caches ............................110 + 14.9.3 Modifications of the Basic Expiration Mechanism .........111 + 14.9.4 Cache Revalidation and Reload Controls ..................113 + 14.9.5 No-Transform Directive ..................................115 + 14.9.6 Cache Control Extensions ................................116 + 14.10 Connection ...............................................117 + 14.11 Content-Encoding .........................................118 + 14.12 Content-Language .........................................118 + 14.13 Content-Length ...........................................119 + 14.14 Content-Location .........................................120 + 14.15 Content-MD5 ..............................................121 + 14.16 Content-Range ............................................122 + 14.17 Content-Type .............................................124 + 14.18 Date .....................................................124 + 14.18.1 Clockless Origin Server Operation ......................125 + 14.19 ETag .....................................................126 + 14.20 Expect ...................................................126 + 14.21 Expires ..................................................127 + 14.22 From .....................................................128 + + + +Fielding, et al. Standards Track [Page 5] + +RFC 2616 HTTP/1.1 June 1999 + + + 14.23 Host .....................................................128 + 14.24 If-Match .................................................129 + 14.25 If-Modified-Since ........................................130 + 14.26 If-None-Match ............................................132 + 14.27 If-Range .................................................133 + 14.28 If-Unmodified-Since ......................................134 + 14.29 Last-Modified ............................................134 + 14.30 Location .................................................135 + 14.31 Max-Forwards .............................................136 + 14.32 Pragma ...................................................136 + 14.33 Proxy-Authenticate .......................................137 + 14.34 Proxy-Authorization ......................................137 + 14.35 Range ....................................................138 + 14.35.1 Byte Ranges ...........................................138 + 14.35.2 Range Retrieval Requests ..............................139 + 14.36 Referer ..................................................140 + 14.37 Retry-After ..............................................141 + 14.38 Server ...................................................141 + 14.39 TE .......................................................142 + 14.40 Trailer ..................................................143 + 14.41 Transfer-Encoding..........................................143 + 14.42 Upgrade ..................................................144 + 14.43 User-Agent ...............................................145 + 14.44 Vary .....................................................145 + 14.45 Via ......................................................146 + 14.46 Warning ..................................................148 + 14.47 WWW-Authenticate .........................................150 + 15 Security Considerations .......................................150 + 15.1 Personal Information....................................151 + 15.1.1 Abuse of Server Log Information .........................151 + 15.1.2 Transfer of Sensitive Information .......................151 + 15.1.3 Encoding Sensitive Information in URI's .................152 + 15.1.4 Privacy Issues Connected to Accept Headers ..............152 + 15.2 Attacks Based On File and Path Names .......................153 + 15.3 DNS Spoofing ...............................................154 + 15.4 Location Headers and Spoofing ..............................154 + 15.5 Content-Disposition Issues .................................154 + 15.6 Authentication Credentials and Idle Clients ................155 + 15.7 Proxies and Caching ........................................155 + 15.7.1 Denial of Service Attacks on Proxies....................156 + 16 Acknowledgments .............................................156 + 17 References ..................................................158 + 18 Authors' Addresses ..........................................162 + 19 Appendices ..................................................164 + 19.1 Internet Media Type message/http and application/http ......164 + 19.2 Internet Media Type multipart/byteranges ...................165 + 19.3 Tolerant Applications ......................................166 + 19.4 Differences Between HTTP Entities and RFC 2045 Entities ....167 + + + +Fielding, et al. Standards Track [Page 6] + +RFC 2616 HTTP/1.1 June 1999 + + + 19.4.1 MIME-Version ............................................167 + 19.4.2 Conversion to Canonical Form ............................167 + 19.4.3 Conversion of Date Formats ..............................168 + 19.4.4 Introduction of Content-Encoding ........................168 + 19.4.5 No Content-Transfer-Encoding ............................168 + 19.4.6 Introduction of Transfer-Encoding .......................169 + 19.4.7 MHTML and Line Length Limitations .......................169 + 19.5 Additional Features ........................................169 + 19.5.1 Content-Disposition .....................................170 + 19.6 Compatibility with Previous Versions .......................170 + 19.6.1 Changes from HTTP/1.0 ...................................171 + 19.6.2 Compatibility with HTTP/1.0 Persistent Connections ......172 + 19.6.3 Changes from RFC 2068 ...................................172 + 20 Index .......................................................175 + 21 Full Copyright Statement ....................................176 + +1 Introduction + +1.1 Purpose + + The Hypertext Transfer Protocol (HTTP) is an application-level + protocol for distributed, collaborative, hypermedia information + systems. HTTP has been in use by the World-Wide Web global + information initiative since 1990. The first version of HTTP, + referred to as HTTP/0.9, was a simple protocol for raw data transfer + across the Internet. HTTP/1.0, as defined by RFC 1945 [6], improved + the protocol by allowing messages to be in the format of MIME-like + messages, containing metainformation about the data transferred and + modifiers on the request/response semantics. However, HTTP/1.0 does + not sufficiently take into consideration the effects of hierarchical + proxies, caching, the need for persistent connections, or virtual + hosts. In addition, the proliferation of incompletely-implemented + applications calling themselves "HTTP/1.0" has necessitated a + protocol version change in order for two communicating applications + to determine each other's true capabilities. + + This specification defines the protocol referred to as "HTTP/1.1". + This protocol includes more stringent requirements than HTTP/1.0 in + order to ensure reliable implementation of its features. + + Practical information systems require more functionality than simple + retrieval, including search, front-end update, and annotation. HTTP + allows an open-ended set of methods and headers that indicate the + purpose of a request [47]. It builds on the discipline of reference + provided by the Uniform Resource Identifier (URI) [3], as a location + (URL) [4] or name (URN) [20], for indicating the resource to which a + + + + + +Fielding, et al. Standards Track [Page 7] + +RFC 2616 HTTP/1.1 June 1999 + + + method is to be applied. Messages are passed in a format similar to + that used by Internet mail [9] as defined by the Multipurpose + Internet Mail Extensions (MIME) [7]. + + HTTP is also used as a generic protocol for communication between + user agents and proxies/gateways to other Internet systems, including + those supported by the SMTP [16], NNTP [13], FTP [18], Gopher [2], + and WAIS [10] protocols. In this way, HTTP allows basic hypermedia + access to resources available from diverse applications. + +1.2 Requirements + + The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", + "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this + document are to be interpreted as described in RFC 2119 [34]. + + An implementation is not compliant if it fails to satisfy one or more + of the MUST or REQUIRED level requirements for the protocols it + implements. An implementation that satisfies all the MUST or REQUIRED + level and all the SHOULD level requirements for its protocols is said + to be "unconditionally compliant"; one that satisfies all the MUST + level requirements but not all the SHOULD level requirements for its + protocols is said to be "conditionally compliant." + +1.3 Terminology + + This specification uses a number of terms to refer to the roles + played by participants in, and objects of, the HTTP communication. + + connection + A transport layer virtual circuit established between two programs + for the purpose of communication. + + message + The basic unit of HTTP communication, consisting of a structured + sequence of octets matching the syntax defined in section 4 and + transmitted via the connection. + + request + An HTTP request message, as defined in section 5. + + response + An HTTP response message, as defined in section 6. + + + + + + + + +Fielding, et al. Standards Track [Page 8] + +RFC 2616 HTTP/1.1 June 1999 + + + resource + A network data object or service that can be identified by a URI, + as defined in section 3.2. Resources may be available in multiple + representations (e.g. multiple languages, data formats, size, and + resolutions) or vary in other ways. + + entity + The information transferred as the payload of a request or + response. An entity consists of metainformation in the form of + entity-header fields and content in the form of an entity-body, as + described in section 7. + + representation + An entity included with a response that is subject to content + negotiation, as described in section 12. There may exist multiple + representations associated with a particular response status. + + content negotiation + The mechanism for selecting the appropriate representation when + servicing a request, as described in section 12. The + representation of entities in any response can be negotiated + (including error responses). + + variant + A resource may have one, or more than one, representation(s) + associated with it at any given instant. Each of these + representations is termed a `varriant'. Use of the term `variant' + does not necessarily imply that the resource is subject to content + negotiation. + + client + A program that establishes connections for the purpose of sending + requests. + + user agent + The client which initiates a request. These are often browsers, + editors, spiders (web-traversing robots), or other end user tools. + + server + An application program that accepts connections in order to + service requests by sending back responses. Any given program may + be capable of being both a client and a server; our use of these + terms refers only to the role being performed by the program for a + particular connection, rather than to the program's capabilities + in general. Likewise, any server may act as an origin server, + proxy, gateway, or tunnel, switching behavior based on the nature + of each request. + + + + +Fielding, et al. Standards Track [Page 9] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server + The server on which a given resource resides or is to be created. + + proxy + An intermediary program which acts as both a server and a client + for the purpose of making requests on behalf of other clients. + Requests are serviced internally or by passing them on, with + possible translation, to other servers. A proxy MUST implement + both the client and server requirements of this specification. A + "transparent proxy" is a proxy that does not modify the request or + response beyond what is required for proxy authentication and + identification. A "non-transparent proxy" is a proxy that modifies + the request or response in order to provide some added service to + the user agent, such as group annotation services, media type + transformation, protocol reduction, or anonymity filtering. Except + where either transparent or non-transparent behavior is explicitly + stated, the HTTP proxy requirements apply to both types of + proxies. + + gateway + A server which acts as an intermediary for some other server. + Unlike a proxy, a gateway receives requests as if it were the + origin server for the requested resource; the requesting client + may not be aware that it is communicating with a gateway. + + tunnel + An intermediary program which is acting as a blind relay between + two connections. Once active, a tunnel is not considered a party + to the HTTP communication, though the tunnel may have been + initiated by an HTTP request. The tunnel ceases to exist when both + ends of the relayed connections are closed. + + cache + A program's local store of response messages and the subsystem + that controls its message storage, retrieval, and deletion. A + cache stores cacheable responses in order to reduce the response + time and network bandwidth consumption on future, equivalent + requests. Any client or server may include a cache, though a cache + cannot be used by a server that is acting as a tunnel. + + cacheable + A response is cacheable if a cache is allowed to store a copy of + the response message for use in answering subsequent requests. The + rules for determining the cacheability of HTTP responses are + defined in section 13. Even if a resource is cacheable, there may + be additional constraints on whether a cache can use the cached + copy for a particular request. + + + + +Fielding, et al. Standards Track [Page 10] + +RFC 2616 HTTP/1.1 June 1999 + + + first-hand + A response is first-hand if it comes directly and without + unnecessary delay from the origin server, perhaps via one or more + proxies. A response is also first-hand if its validity has just + been checked directly with the origin server. + + explicit expiration time + The time at which the origin server intends that an entity should + no longer be returned by a cache without further validation. + + heuristic expiration time + An expiration time assigned by a cache when no explicit expiration + time is available. + + age + The age of a response is the time since it was sent by, or + successfully validated with, the origin server. + + freshness lifetime + The length of time between the generation of a response and its + expiration time. + + fresh + A response is fresh if its age has not yet exceeded its freshness + lifetime. + + stale + A response is stale if its age has passed its freshness lifetime. + + semantically transparent + A cache behaves in a "semantically transparent" manner, with + respect to a particular response, when its use affects neither the + requesting client nor the origin server, except to improve + performance. When a cache is semantically transparent, the client + receives exactly the same response (except for hop-by-hop headers) + that it would have received had its request been handled directly + by the origin server. + + validator + A protocol element (e.g., an entity tag or a Last-Modified time) + that is used to find out whether a cache entry is an equivalent + copy of an entity. + + upstream/downstream + Upstream and downstream describe the flow of a message: all + messages flow from upstream to downstream. + + + + + +Fielding, et al. Standards Track [Page 11] + +RFC 2616 HTTP/1.1 June 1999 + + + inbound/outbound + Inbound and outbound refer to the request and response paths for + messages: "inbound" means "traveling toward the origin server", + and "outbound" means "traveling toward the user agent" + +1.4 Overall Operation + + The HTTP protocol is a request/response protocol. A client sends a + request to the server in the form of a request method, URI, and + protocol version, followed by a MIME-like message containing request + modifiers, client information, and possible body content over a + connection with a server. The server responds with a status line, + including the message's protocol version and a success or error code, + followed by a MIME-like message containing server information, entity + metainformation, and possible entity-body content. The relationship + between HTTP and MIME is described in appendix 19.4. + + Most HTTP communication is initiated by a user agent and consists of + a request to be applied to a resource on some origin server. In the + simplest case, this may be accomplished via a single connection (v) + between the user agent (UA) and the origin server (O). + + request chain ------------------------> + UA -------------------v------------------- O + <----------------------- response chain + + A more complicated situation occurs when one or more intermediaries + are present in the request/response chain. There are three common + forms of intermediary: proxy, gateway, and tunnel. A proxy is a + forwarding agent, receiving requests for a URI in its absolute form, + rewriting all or part of the message, and forwarding the reformatted + request toward the server identified by the URI. A gateway is a + receiving agent, acting as a layer above some other server(s) and, if + necessary, translating the requests to the underlying server's + protocol. A tunnel acts as a relay point between two connections + without changing the messages; tunnels are used when the + communication needs to pass through an intermediary (such as a + firewall) even when the intermediary cannot understand the contents + of the messages. + + request chain --------------------------------------> + UA -----v----- A -----v----- B -----v----- C -----v----- O + <------------------------------------- response chain + + The figure above shows three intermediaries (A, B, and C) between the + user agent and origin server. A request or response message that + travels the whole chain will pass through four separate connections. + This distinction is important because some HTTP communication options + + + +Fielding, et al. Standards Track [Page 12] + +RFC 2616 HTTP/1.1 June 1999 + + + may apply only to the connection with the nearest, non-tunnel + neighbor, only to the end-points of the chain, or to all connections + along the chain. Although the diagram is linear, each participant may + be engaged in multiple, simultaneous communications. For example, B + may be receiving requests from many clients other than A, and/or + forwarding requests to servers other than C, at the same time that it + is handling A's request. + + Any party to the communication which is not acting as a tunnel may + employ an internal cache for handling requests. The effect of a cache + is that the request/response chain is shortened if one of the + participants along the chain has a cached response applicable to that + request. The following illustrates the resulting chain if B has a + cached copy of an earlier response from O (via C) for a request which + has not been cached by UA or A. + + request chain ----------> + UA -----v----- A -----v----- B - - - - - - C - - - - - - O + <--------- response chain + + Not all responses are usefully cacheable, and some requests may + contain modifiers which place special requirements on cache behavior. + HTTP requirements for cache behavior and cacheable responses are + defined in section 13. + + In fact, there are a wide variety of architectures and configurations + of caches and proxies currently being experimented with or deployed + across the World Wide Web. These systems include national hierarchies + of proxy caches to save transoceanic bandwidth, systems that + broadcast or multicast cache entries, organizations that distribute + subsets of cached data via CD-ROM, and so on. HTTP systems are used + in corporate intranets over high-bandwidth links, and for access via + PDAs with low-power radio links and intermittent connectivity. The + goal of HTTP/1.1 is to support the wide diversity of configurations + already deployed while introducing protocol constructs that meet the + needs of those who build web applications that require high + reliability and, failing that, at least reliable indications of + failure. + + HTTP communication usually takes place over TCP/IP connections. The + default port is TCP 80 [19], but other ports can be used. This does + not preclude HTTP from being implemented on top of any other protocol + on the Internet, or on other networks. HTTP only presumes a reliable + transport; any protocol that provides such guarantees can be used; + the mapping of the HTTP/1.1 request and response structures onto the + transport data units of the protocol in question is outside the scope + of this specification. + + + + +Fielding, et al. Standards Track [Page 13] + +RFC 2616 HTTP/1.1 June 1999 + + + In HTTP/1.0, most implementations used a new connection for each + request/response exchange. In HTTP/1.1, a connection may be used for + one or more request/response exchanges, although connections may be + closed for a variety of reasons (see section 8.1). + +2 Notational Conventions and Generic Grammar + +2.1 Augmented BNF + + All of the mechanisms specified in this document are described in + both prose and an augmented Backus-Naur Form (BNF) similar to that + used by RFC 822 [9]. Implementors will need to be familiar with the + notation in order to understand this specification. The augmented BNF + includes the following constructs: + + name = definition + The name of a rule is simply the name itself (without any + enclosing "<" and ">") and is separated from its definition by the + equal "=" character. White space is only significant in that + indentation of continuation lines is used to indicate a rule + definition that spans more than one line. Certain basic rules are + in uppercase, such as SP, LWS, HT, CRLF, DIGIT, ALPHA, etc. Angle + brackets are used within definitions whenever their presence will + facilitate discerning the use of rule names. + + "literal" + Quotation marks surround literal text. Unless stated otherwise, + the text is case-insensitive. + + rule1 | rule2 + Elements separated by a bar ("|") are alternatives, e.g., "yes | + no" will accept yes or no. + + (rule1 rule2) + Elements enclosed in parentheses are treated as a single element. + Thus, "(elem (foo | bar) elem)" allows the token sequences "elem + foo elem" and "elem bar elem". + + *rule + The character "*" preceding an element indicates repetition. The + full form is "*element" indicating at least and at most + occurrences of element. Default values are 0 and infinity so + that "*(element)" allows any number, including zero; "1*element" + requires at least one; and "1*2element" allows one or two. + + [rule] + Square brackets enclose optional elements; "[foo bar]" is + equivalent to "*1(foo bar)". + + + +Fielding, et al. Standards Track [Page 14] + +RFC 2616 HTTP/1.1 June 1999 + + + N rule + Specific repetition: "(element)" is equivalent to + "*(element)"; that is, exactly occurrences of (element). + Thus 2DIGIT is a 2-digit number, and 3ALPHA is a string of three + alphabetic characters. + + #rule + A construct "#" is defined, similar to "*", for defining lists of + elements. The full form is "#element" indicating at least + and at most elements, each separated by one or more commas + (",") and OPTIONAL linear white space (LWS). This makes the usual + form of lists very easy; a rule such as + ( *LWS element *( *LWS "," *LWS element )) + can be shown as + 1#element + Wherever this construct is used, null elements are allowed, but do + not contribute to the count of elements present. That is, + "(element), , (element) " is permitted, but counts as only two + elements. Therefore, where at least one element is required, at + least one non-null element MUST be present. Default values are 0 + and infinity so that "#element" allows any number, including zero; + "1#element" requires at least one; and "1#2element" allows one or + two. + + ; comment + A semi-colon, set off some distance to the right of rule text, + starts a comment that continues to the end of line. This is a + simple way of including useful notes in parallel with the + specifications. + + implied *LWS + The grammar described by this specification is word-based. Except + where noted otherwise, linear white space (LWS) can be included + between any two adjacent words (token or quoted-string), and + between adjacent words and separators, without changing the + interpretation of a field. At least one delimiter (LWS and/or + + separators) MUST exist between any two tokens (for the definition + of "token" below), since they would otherwise be interpreted as a + single token. + +2.2 Basic Rules + + The following rules are used throughout this specification to + describe basic parsing constructs. The US-ASCII coded character set + is defined by ANSI X3.4-1986 [21]. + + + + + +Fielding, et al. Standards Track [Page 15] + +RFC 2616 HTTP/1.1 June 1999 + + + OCTET = + CHAR = + UPALPHA = + LOALPHA = + ALPHA = UPALPHA | LOALPHA + DIGIT = + CTL = + CR = + LF = + SP = + HT = + <"> = + + HTTP/1.1 defines the sequence CR LF as the end-of-line marker for all + protocol elements except the entity-body (see appendix 19.3 for + tolerant applications). The end-of-line marker within an entity-body + is defined by its associated media type, as described in section 3.7. + + CRLF = CR LF + + HTTP/1.1 header field values can be folded onto multiple lines if the + continuation line begins with a space or horizontal tab. All linear + white space, including folding, has the same semantics as SP. A + recipient MAY replace any linear white space with a single SP before + interpreting the field value or forwarding the message downstream. + + LWS = [CRLF] 1*( SP | HT ) + + The TEXT rule is only used for descriptive field contents and values + that are not intended to be interpreted by the message parser. Words + of *TEXT MAY contain characters from character sets other than ISO- + 8859-1 [22] only when encoded according to the rules of RFC 2047 + [14]. + + TEXT = + + A CRLF is allowed in the definition of TEXT only as part of a header + field continuation. It is expected that the folding LWS will be + replaced with a single SP before interpretation of the TEXT value. + + Hexadecimal numeric characters are used in several protocol elements. + + HEX = "A" | "B" | "C" | "D" | "E" | "F" + | "a" | "b" | "c" | "d" | "e" | "f" | DIGIT + + + + + +Fielding, et al. Standards Track [Page 16] + +RFC 2616 HTTP/1.1 June 1999 + + + Many HTTP/1.1 header field values consist of words separated by LWS + or special characters. These special characters MUST be in a quoted + string to be used within a parameter value (as defined in section + 3.6). + + token = 1* + separators = "(" | ")" | "<" | ">" | "@" + | "," | ";" | ":" | "\" | <"> + | "/" | "[" | "]" | "?" | "=" + | "{" | "}" | SP | HT + + Comments can be included in some HTTP header fields by surrounding + the comment text with parentheses. Comments are only allowed in + fields containing "comment" as part of their field value definition. + In all other fields, parentheses are considered part of the field + value. + + comment = "(" *( ctext | quoted-pair | comment ) ")" + ctext = + + A string of text is parsed as a single word if it is quoted using + double-quote marks. + + quoted-string = ( <"> *(qdtext | quoted-pair ) <"> ) + qdtext = > + + The backslash character ("\") MAY be used as a single-character + quoting mechanism only within quoted-string and comment constructs. + + quoted-pair = "\" CHAR + +3 Protocol Parameters + +3.1 HTTP Version + + HTTP uses a "." numbering scheme to indicate versions + of the protocol. The protocol versioning policy is intended to allow + the sender to indicate the format of a message and its capacity for + understanding further HTTP communication, rather than the features + obtained via that communication. No change is made to the version + number for the addition of message components which do not affect + communication behavior or which only add to extensible field values. + The number is incremented when the changes made to the + protocol add features which do not change the general message parsing + algorithm, but which may add to the message semantics and imply + additional capabilities of the sender. The number is + incremented when the format of a message within the protocol is + changed. See RFC 2145 [36] for a fuller explanation. + + + +Fielding, et al. Standards Track [Page 17] + +RFC 2616 HTTP/1.1 June 1999 + + + The version of an HTTP message is indicated by an HTTP-Version field + in the first line of the message. + + HTTP-Version = "HTTP" "/" 1*DIGIT "." 1*DIGIT + + Note that the major and minor numbers MUST be treated as separate + integers and that each MAY be incremented higher than a single digit. + Thus, HTTP/2.4 is a lower version than HTTP/2.13, which in turn is + lower than HTTP/12.3. Leading zeros MUST be ignored by recipients and + MUST NOT be sent. + + An application that sends a request or response message that includes + HTTP-Version of "HTTP/1.1" MUST be at least conditionally compliant + with this specification. Applications that are at least conditionally + compliant with this specification SHOULD use an HTTP-Version of + "HTTP/1.1" in their messages, and MUST do so for any message that is + not compatible with HTTP/1.0. For more details on when to send + specific HTTP-Version values, see RFC 2145 [36]. + + The HTTP version of an application is the highest HTTP version for + which the application is at least conditionally compliant. + + Proxy and gateway applications need to be careful when forwarding + messages in protocol versions different from that of the application. + Since the protocol version indicates the protocol capability of the + sender, a proxy/gateway MUST NOT send a message with a version + indicator which is greater than its actual version. If a higher + version request is received, the proxy/gateway MUST either downgrade + the request version, or respond with an error, or switch to tunnel + behavior. + + Due to interoperability problems with HTTP/1.0 proxies discovered + since the publication of RFC 2068[33], caching proxies MUST, gateways + MAY, and tunnels MUST NOT upgrade the request to the highest version + they support. The proxy/gateway's response to that request MUST be in + the same major version as the request. + + Note: Converting between versions of HTTP may involve modification + of header fields required or forbidden by the versions involved. + +3.2 Uniform Resource Identifiers + + URIs have been known by many names: WWW addresses, Universal Document + Identifiers, Universal Resource Identifiers [3], and finally the + combination of Uniform Resource Locators (URL) [4] and Names (URN) + [20]. As far as HTTP is concerned, Uniform Resource Identifiers are + simply formatted strings which identify--via name, location, or any + other characteristic--a resource. + + + +Fielding, et al. Standards Track [Page 18] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.1 General Syntax + + URIs in HTTP can be represented in absolute form or relative to some + known base URI [11], depending upon the context of their use. The two + forms are differentiated by the fact that absolute URIs always begin + with a scheme name followed by a colon. For definitive information on + URL syntax and semantics, see "Uniform Resource Identifiers (URI): + Generic Syntax and Semantics," RFC 2396 [42] (which replaces RFCs + 1738 [4] and RFC 1808 [11]). This specification adopts the + definitions of "URI-reference", "absoluteURI", "relativeURI", "port", + "host","abs_path", "rel_path", and "authority" from that + specification. + + The HTTP protocol does not place any a priori limit on the length of + a URI. Servers MUST be able to handle the URI of any resource they + serve, and SHOULD be able to handle URIs of unbounded length if they + provide GET-based forms that could generate such URIs. A server + SHOULD return 414 (Request-URI Too Long) status if a URI is longer + than the server can handle (see section 10.4.15). + + Note: Servers ought to be cautious about depending on URI lengths + above 255 bytes, because some older client or proxy + implementations might not properly support these lengths. + +3.2.2 http URL + + The "http" scheme is used to locate network resources via the HTTP + protocol. This section defines the scheme-specific syntax and + semantics for http URLs. + + http_URL = "http:" "//" host [ ":" port ] [ abs_path [ "?" query ]] + + If the port is empty or not given, port 80 is assumed. The semantics + are that the identified resource is located at the server listening + for TCP connections on that port of that host, and the Request-URI + for the resource is abs_path (section 5.1.2). The use of IP addresses + in URLs SHOULD be avoided whenever possible (see RFC 1900 [24]). If + the abs_path is not present in the URL, it MUST be given as "/" when + used as a Request-URI for a resource (section 5.1.2). If a proxy + receives a host name which is not a fully qualified domain name, it + MAY add its domain to the host name it received. If a proxy receives + a fully qualified domain name, the proxy MUST NOT change the host + name. + + + + + + + + +Fielding, et al. Standards Track [Page 19] + +RFC 2616 HTTP/1.1 June 1999 + + +3.2.3 URI Comparison + + When comparing two URIs to decide if they match or not, a client + SHOULD use a case-sensitive octet-by-octet comparison of the entire + URIs, with these exceptions: + + - A port that is empty or not given is equivalent to the default + port for that URI-reference; + + - Comparisons of host names MUST be case-insensitive; + + - Comparisons of scheme names MUST be case-insensitive; + + - An empty abs_path is equivalent to an abs_path of "/". + + Characters other than those in the "reserved" and "unsafe" sets (see + RFC 2396 [42]) are equivalent to their ""%" HEX HEX" encoding. + + For example, the following three URIs are equivalent: + + http://abc.com:80/~smith/home.html + http://ABC.com/%7Esmith/home.html + http://ABC.com:/%7esmith/home.html + +3.3 Date/Time Formats + +3.3.1 Full Date + + HTTP applications have historically allowed three different formats + for the representation of date/time stamps: + + Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123 + Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036 + Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format + + The first format is preferred as an Internet standard and represents + a fixed-length subset of that defined by RFC 1123 [8] (an update to + RFC 822 [9]). The second format is in common use, but is based on the + obsolete RFC 850 [12] date format and lacks a four-digit year. + HTTP/1.1 clients and servers that parse the date value MUST accept + all three formats (for compatibility with HTTP/1.0), though they MUST + only generate the RFC 1123 format for representing HTTP-date values + in header fields. See section 19.3 for further information. + + Note: Recipients of date values are encouraged to be robust in + accepting date values that may have been sent by non-HTTP + applications, as is sometimes the case when retrieving or posting + messages via proxies/gateways to SMTP or NNTP. + + + +Fielding, et al. Standards Track [Page 20] + +RFC 2616 HTTP/1.1 June 1999 + + + All HTTP date/time stamps MUST be represented in Greenwich Mean Time + (GMT), without exception. For the purposes of HTTP, GMT is exactly + equal to UTC (Coordinated Universal Time). This is indicated in the + first two formats by the inclusion of "GMT" as the three-letter + abbreviation for time zone, and MUST be assumed when reading the + asctime format. HTTP-date is case sensitive and MUST NOT include + additional LWS beyond that specifically included as SP in the + grammar. + + HTTP-date = rfc1123-date | rfc850-date | asctime-date + rfc1123-date = wkday "," SP date1 SP time SP "GMT" + rfc850-date = weekday "," SP date2 SP time SP "GMT" + asctime-date = wkday SP date3 SP time SP 4DIGIT + date1 = 2DIGIT SP month SP 4DIGIT + ; day month year (e.g., 02 Jun 1982) + date2 = 2DIGIT "-" month "-" 2DIGIT + ; day-month-year (e.g., 02-Jun-82) + date3 = month SP ( 2DIGIT | ( SP 1DIGIT )) + ; month day (e.g., Jun 2) + time = 2DIGIT ":" 2DIGIT ":" 2DIGIT + ; 00:00:00 - 23:59:59 + wkday = "Mon" | "Tue" | "Wed" + | "Thu" | "Fri" | "Sat" | "Sun" + weekday = "Monday" | "Tuesday" | "Wednesday" + | "Thursday" | "Friday" | "Saturday" | "Sunday" + month = "Jan" | "Feb" | "Mar" | "Apr" + | "May" | "Jun" | "Jul" | "Aug" + | "Sep" | "Oct" | "Nov" | "Dec" + + Note: HTTP requirements for the date/time stamp format apply only + to their usage within the protocol stream. Clients and servers are + not required to use these formats for user presentation, request + logging, etc. + +3.3.2 Delta Seconds + + Some HTTP header fields allow a time value to be specified as an + integer number of seconds, represented in decimal, after the time + that the message was received. + + delta-seconds = 1*DIGIT + +3.4 Character Sets + + HTTP uses the same definition of the term "character set" as that + described for MIME: + + + + + +Fielding, et al. Standards Track [Page 21] + +RFC 2616 HTTP/1.1 June 1999 + + + The term "character set" is used in this document to refer to a + method used with one or more tables to convert a sequence of octets + into a sequence of characters. Note that unconditional conversion in + the other direction is not required, in that not all characters may + be available in a given character set and a character set may provide + more than one sequence of octets to represent a particular character. + This definition is intended to allow various kinds of character + encoding, from simple single-table mappings such as US-ASCII to + complex table switching methods such as those that use ISO-2022's + techniques. However, the definition associated with a MIME character + set name MUST fully specify the mapping to be performed from octets + to characters. In particular, use of external profiling information + to determine the exact mapping is not permitted. + + Note: This use of the term "character set" is more commonly + referred to as a "character encoding." However, since HTTP and + MIME share the same registry, it is important that the terminology + also be shared. + + HTTP character sets are identified by case-insensitive tokens. The + complete set of tokens is defined by the IANA Character Set registry + [19]. + + charset = token + + Although HTTP allows an arbitrary token to be used as a charset + value, any token that has a predefined value within the IANA + Character Set registry [19] MUST represent the character set defined + by that registry. Applications SHOULD limit their use of character + sets to those defined by the IANA registry. + + Implementors should be aware of IETF character set requirements [38] + [41]. + +3.4.1 Missing Charset + + Some HTTP/1.0 software has interpreted a Content-Type header without + charset parameter incorrectly to mean "recipient should guess." + Senders wishing to defeat this behavior MAY include a charset + parameter even when the charset is ISO-8859-1 and SHOULD do so when + it is known that it will not confuse the recipient. + + Unfortunately, some older HTTP/1.0 clients did not deal properly with + an explicit charset parameter. HTTP/1.1 recipients MUST respect the + charset label provided by the sender; and those user agents that have + a provision to "guess" a charset MUST use the charset from the + + + + + +Fielding, et al. Standards Track [Page 22] + +RFC 2616 HTTP/1.1 June 1999 + + + content-type field if they support that charset, rather than the + recipient's preference, when initially displaying a document. See + section 3.7.1. + +3.5 Content Codings + + Content coding values indicate an encoding transformation that has + been or can be applied to an entity. Content codings are primarily + used to allow a document to be compressed or otherwise usefully + transformed without losing the identity of its underlying media type + and without loss of information. Frequently, the entity is stored in + coded form, transmitted directly, and only decoded by the recipient. + + content-coding = token + + All content-coding values are case-insensitive. HTTP/1.1 uses + content-coding values in the Accept-Encoding (section 14.3) and + Content-Encoding (section 14.11) header fields. Although the value + describes the content-coding, what is more important is that it + indicates what decoding mechanism will be required to remove the + encoding. + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + content-coding value tokens. Initially, the registry contains the + following tokens: + + gzip An encoding format produced by the file compression program + "gzip" (GNU zip) as described in RFC 1952 [25]. This format is a + Lempel-Ziv coding (LZ77) with a 32 bit CRC. + + compress + The encoding format produced by the common UNIX file compression + program "compress". This format is an adaptive Lempel-Ziv-Welch + coding (LZW). + + Use of program names for the identification of encoding formats + is not desirable and is discouraged for future encodings. Their + use here is representative of historical practice, not good + design. For compatibility with previous implementations of HTTP, + applications SHOULD consider "x-gzip" and "x-compress" to be + equivalent to "gzip" and "compress" respectively. + + deflate + The "zlib" format defined in RFC 1950 [31] in combination with + the "deflate" compression mechanism described in RFC 1951 [29]. + + + + + + +Fielding, et al. Standards Track [Page 23] + +RFC 2616 HTTP/1.1 June 1999 + + + identity + The default (identity) encoding; the use of no transformation + whatsoever. This content-coding is used only in the Accept- + Encoding header, and SHOULD NOT be used in the Content-Encoding + header. + + New content-coding value tokens SHOULD be registered; to allow + interoperability between clients and servers, specifications of the + content coding algorithms needed to implement a new value SHOULD be + publicly available and adequate for independent implementation, and + conform to the purpose of content coding defined in this section. + +3.6 Transfer Codings + + Transfer-coding values are used to indicate an encoding + transformation that has been, can be, or may need to be applied to an + entity-body in order to ensure "safe transport" through the network. + This differs from a content coding in that the transfer-coding is a + property of the message, not of the original entity. + + transfer-coding = "chunked" | transfer-extension + transfer-extension = token *( ";" parameter ) + + Parameters are in the form of attribute/value pairs. + + parameter = attribute "=" value + attribute = token + value = token | quoted-string + + All transfer-coding values are case-insensitive. HTTP/1.1 uses + transfer-coding values in the TE header field (section 14.39) and in + the Transfer-Encoding header field (section 14.41). + + Whenever a transfer-coding is applied to a message-body, the set of + transfer-codings MUST include "chunked", unless the message is + terminated by closing the connection. When the "chunked" transfer- + coding is used, it MUST be the last transfer-coding applied to the + message-body. The "chunked" transfer-coding MUST NOT be applied more + than once to a message-body. These rules allow the recipient to + determine the transfer-length of the message (section 4.4). + + Transfer-codings are analogous to the Content-Transfer-Encoding + values of MIME [7], which were designed to enable safe transport of + binary data over a 7-bit transport service. However, safe transport + has a different focus for an 8bit-clean transfer protocol. In HTTP, + the only unsafe characteristic of message-bodies is the difficulty in + determining the exact body length (section 7.2.2), or the desire to + encrypt data over a shared transport. + + + +Fielding, et al. Standards Track [Page 24] + +RFC 2616 HTTP/1.1 June 1999 + + + The Internet Assigned Numbers Authority (IANA) acts as a registry for + transfer-coding value tokens. Initially, the registry contains the + following tokens: "chunked" (section 3.6.1), "identity" (section + 3.6.2), "gzip" (section 3.5), "compress" (section 3.5), and "deflate" + (section 3.5). + + New transfer-coding value tokens SHOULD be registered in the same way + as new content-coding value tokens (section 3.5). + + A server which receives an entity-body with a transfer-coding it does + not understand SHOULD return 501 (Unimplemented), and close the + connection. A server MUST NOT send transfer-codings to an HTTP/1.0 + client. + +3.6.1 Chunked Transfer Coding + + The chunked encoding modifies the body of a message in order to + transfer it as a series of chunks, each with its own size indicator, + followed by an OPTIONAL trailer containing entity-header fields. This + allows dynamically produced content to be transferred along with the + information necessary for the recipient to verify that it has + received the full message. + + Chunked-Body = *chunk + last-chunk + trailer + CRLF + + chunk = chunk-size [ chunk-extension ] CRLF + chunk-data CRLF + chunk-size = 1*HEX + last-chunk = 1*("0") [ chunk-extension ] CRLF + + chunk-extension= *( ";" chunk-ext-name [ "=" chunk-ext-val ] ) + chunk-ext-name = token + chunk-ext-val = token | quoted-string + chunk-data = chunk-size(OCTET) + trailer = *(entity-header CRLF) + + The chunk-size field is a string of hex digits indicating the size of + the chunk. The chunked encoding is ended by any chunk whose size is + zero, followed by the trailer, which is terminated by an empty line. + + The trailer allows the sender to include additional HTTP header + fields at the end of the message. The Trailer header field can be + used to indicate which header fields are included in a trailer (see + section 14.40). + + + + +Fielding, et al. Standards Track [Page 25] + +RFC 2616 HTTP/1.1 June 1999 + + + A server using chunked transfer-coding in a response MUST NOT use the + trailer for any header fields unless at least one of the following is + true: + + a)the request included a TE header field that indicates "trailers" is + acceptable in the transfer-coding of the response, as described in + section 14.39; or, + + b)the server is the origin server for the response, the trailer + fields consist entirely of optional metadata, and the recipient + could use the message (in a manner acceptable to the origin server) + without receiving this metadata. In other words, the origin server + is willing to accept the possibility that the trailer fields might + be silently discarded along the path to the client. + + This requirement prevents an interoperability failure when the + message is being received by an HTTP/1.1 (or later) proxy and + forwarded to an HTTP/1.0 recipient. It avoids a situation where + compliance with the protocol would have necessitated a possibly + infinite buffer on the proxy. + + An example process for decoding a Chunked-Body is presented in + appendix 19.4.6. + + All HTTP/1.1 applications MUST be able to receive and decode the + "chunked" transfer-coding, and MUST ignore chunk-extension extensions + they do not understand. + +3.7 Media Types + + HTTP uses Internet Media Types [17] in the Content-Type (section + 14.17) and Accept (section 14.1) header fields in order to provide + open and extensible data typing and type negotiation. + + media-type = type "/" subtype *( ";" parameter ) + type = token + subtype = token + + Parameters MAY follow the type/subtype in the form of attribute/value + pairs (as defined in section 3.6). + + The type, subtype, and parameter attribute names are case- + insensitive. Parameter values might or might not be case-sensitive, + depending on the semantics of the parameter name. Linear white space + (LWS) MUST NOT be used between the type and subtype, nor between an + attribute and its value. The presence or absence of a parameter might + be significant to the processing of a media-type, depending on its + definition within the media type registry. + + + +Fielding, et al. Standards Track [Page 26] + +RFC 2616 HTTP/1.1 June 1999 + + + Note that some older HTTP applications do not recognize media type + parameters. When sending data to older HTTP applications, + implementations SHOULD only use media type parameters when they are + required by that type/subtype definition. + + Media-type values are registered with the Internet Assigned Number + Authority (IANA [19]). The media type registration process is + outlined in RFC 1590 [17]. Use of non-registered media types is + discouraged. + +3.7.1 Canonicalization and Text Defaults + + Internet media types are registered with a canonical form. An + entity-body transferred via HTTP messages MUST be represented in the + appropriate canonical form prior to its transmission except for + "text" types, as defined in the next paragraph. + + When in canonical form, media subtypes of the "text" type use CRLF as + the text line break. HTTP relaxes this requirement and allows the + transport of text media with plain CR or LF alone representing a line + break when it is done consistently for an entire entity-body. HTTP + applications MUST accept CRLF, bare CR, and bare LF as being + representative of a line break in text media received via HTTP. In + addition, if the text is represented in a character set that does not + use octets 13 and 10 for CR and LF respectively, as is the case for + some multi-byte character sets, HTTP allows the use of whatever octet + sequences are defined by that character set to represent the + equivalent of CR and LF for line breaks. This flexibility regarding + line breaks applies only to text media in the entity-body; a bare CR + or LF MUST NOT be substituted for CRLF within any of the HTTP control + structures (such as header fields and multipart boundaries). + + If an entity-body is encoded with a content-coding, the underlying + data MUST be in a form defined above prior to being encoded. + + The "charset" parameter is used with some media types to define the + character set (section 3.4) of the data. When no explicit charset + parameter is provided by the sender, media subtypes of the "text" + type are defined to have a default charset value of "ISO-8859-1" when + received via HTTP. Data in character sets other than "ISO-8859-1" or + its subsets MUST be labeled with an appropriate charset value. See + section 3.4.1 for compatibility problems. + +3.7.2 Multipart Types + + MIME provides for a number of "multipart" types -- encapsulations of + one or more entities within a single message-body. All multipart + types share a common syntax, as defined in section 5.1.1 of RFC 2046 + + + +Fielding, et al. Standards Track [Page 27] + +RFC 2616 HTTP/1.1 June 1999 + + + [40], and MUST include a boundary parameter as part of the media type + value. The message body is itself a protocol element and MUST + therefore use only CRLF to represent line breaks between body-parts. + Unlike in RFC 2046, the epilogue of any multipart message MUST be + empty; HTTP applications MUST NOT transmit the epilogue (even if the + original multipart contains an epilogue). These restrictions exist in + order to preserve the self-delimiting nature of a multipart message- + body, wherein the "end" of the message-body is indicated by the + ending multipart boundary. + + In general, HTTP treats a multipart message-body no differently than + any other media type: strictly as payload. The one exception is the + "multipart/byteranges" type (appendix 19.2) when it appears in a 206 + (Partial Content) response, which will be interpreted by some HTTP + caching mechanisms as described in sections 13.5.4 and 14.16. In all + other cases, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + The MIME header fields within each body-part of a multipart message- + body do not have any significance to HTTP beyond that defined by + their MIME semantics. + + In general, an HTTP user agent SHOULD follow the same or similar + behavior as a MIME user agent would upon receipt of a multipart type. + If an application receives an unrecognized multipart subtype, the + application MUST treat it as being equivalent to "multipart/mixed". + + Note: The "multipart/form-data" type has been specifically defined + for carrying form data suitable for processing via the POST + request method, as described in RFC 1867 [15]. + +3.8 Product Tokens + + Product tokens are used to allow communicating applications to + identify themselves by software name and version. Most fields using + product tokens also allow sub-products which form a significant part + of the application to be listed, separated by white space. By + convention, the products are listed in order of their significance + for identifying the application. + + product = token ["/" product-version] + product-version = token + + Examples: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + Server: Apache/0.8.4 + + + + + +Fielding, et al. Standards Track [Page 28] + +RFC 2616 HTTP/1.1 June 1999 + + + Product tokens SHOULD be short and to the point. They MUST NOT be + used for advertising or other non-essential information. Although any + token character MAY appear in a product-version, this token SHOULD + only be used for a version identifier (i.e., successive versions of + the same product SHOULD only differ in the product-version portion of + the product value). + +3.9 Quality Values + + HTTP content negotiation (section 12) uses short "floating point" + numbers to indicate the relative importance ("weight") of various + negotiable parameters. A weight is normalized to a real number in + the range 0 through 1, where 0 is the minimum and 1 the maximum + value. If a parameter has a quality value of 0, then content with + this parameter is `not acceptable' for the client. HTTP/1.1 + applications MUST NOT generate more than three digits after the + decimal point. User configuration of these values SHOULD also be + limited in this fashion. + + qvalue = ( "0" [ "." 0*3DIGIT ] ) + | ( "1" [ "." 0*3("0") ] ) + + "Quality values" is a misnomer, since these values merely represent + relative degradation in desired quality. + +3.10 Language Tags + + A language tag identifies a natural language spoken, written, or + otherwise conveyed by human beings for communication of information + to other human beings. Computer languages are explicitly excluded. + HTTP uses language tags within the Accept-Language and Content- + Language fields. + + The syntax and registry of HTTP language tags is the same as that + defined by RFC 1766 [1]. In summary, a language tag is composed of 1 + or more parts: A primary language tag and a possibly empty series of + subtags: + + language-tag = primary-tag *( "-" subtag ) + primary-tag = 1*8ALPHA + subtag = 1*8ALPHA + + White space is not allowed within the tag and all tags are case- + insensitive. The name space of language tags is administered by the + IANA. Example tags include: + + en, en-US, en-cockney, i-cherokee, x-pig-latin + + + + +Fielding, et al. Standards Track [Page 29] + +RFC 2616 HTTP/1.1 June 1999 + + + where any two-letter primary-tag is an ISO-639 language abbreviation + and any two-letter initial subtag is an ISO-3166 country code. (The + last three tags above are not registered tags; all but the last are + examples of tags which could be registered in future.) + +3.11 Entity Tags + + Entity tags are used for comparing two or more entities from the same + requested resource. HTTP/1.1 uses entity tags in the ETag (section + 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and + If-Range (section 14.27) header fields. The definition of how they + are used and compared as cache validators is in section 13.3.3. An + entity tag consists of an opaque quoted string, possibly prefixed by + a weakness indicator. + + entity-tag = [ weak ] opaque-tag + weak = "W/" + opaque-tag = quoted-string + + A "strong entity tag" MAY be shared by two entities of a resource + only if they are equivalent by octet equality. + + A "weak entity tag," indicated by the "W/" prefix, MAY be shared by + two entities of a resource only if the entities are equivalent and + could be substituted for each other with no significant change in + semantics. A weak entity tag can only be used for weak comparison. + + An entity tag MUST be unique across all versions of all entities + associated with a particular resource. A given entity tag value MAY + be used for entities obtained by requests on different URIs. The use + of the same entity tag value in conjunction with entities obtained by + requests on different URIs does not imply the equivalence of those + entities. + +3.12 Range Units + + HTTP/1.1 allows a client to request that only part (a range of) the + response entity be included within the response. HTTP/1.1 uses range + units in the Range (section 14.35) and Content-Range (section 14.16) + header fields. An entity can be broken down into subranges according + to various structural units. + + range-unit = bytes-unit | other-range-unit + bytes-unit = "bytes" + other-range-unit = token + + The only range unit defined by HTTP/1.1 is "bytes". HTTP/1.1 + implementations MAY ignore ranges specified using other units. + + + +Fielding, et al. Standards Track [Page 30] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 has been designed to allow implementations of applications + that do not depend on knowledge of ranges. + +4 HTTP Message + +4.1 Message Types + + HTTP messages consist of requests from client to server and responses + from server to client. + + HTTP-message = Request | Response ; HTTP/1.1 messages + + Request (section 5) and Response (section 6) messages use the generic + message format of RFC 822 [9] for transferring entities (the payload + of the message). Both types of message consist of a start-line, zero + or more header fields (also known as "headers"), an empty line (i.e., + a line with nothing preceding the CRLF) indicating the end of the + header fields, and possibly a message-body. + + generic-message = start-line + *(message-header CRLF) + CRLF + [ message-body ] + start-line = Request-Line | Status-Line + + In the interest of robustness, servers SHOULD ignore any empty + line(s) received where a Request-Line is expected. In other words, if + the server is reading the protocol stream at the beginning of a + message and receives a CRLF first, it should ignore the CRLF. + + Certain buggy HTTP/1.0 client implementations generate extra CRLF's + after a POST request. To restate what is explicitly forbidden by the + BNF, an HTTP/1.1 client MUST NOT preface or follow a request with an + extra CRLF. + +4.2 Message Headers + + HTTP header fields, which include general-header (section 4.5), + request-header (section 5.3), response-header (section 6.2), and + entity-header (section 7.1) fields, follow the same generic format as + that given in Section 3.1 of RFC 822 [9]. Each header field consists + of a name followed by a colon (":") and the field value. Field names + are case-insensitive. The field value MAY be preceded by any amount + of LWS, though a single SP is preferred. Header fields can be + extended over multiple lines by preceding each extra line with at + least one SP or HT. Applications ought to follow "common form", where + one is known or indicated, when generating HTTP constructs, since + there might exist some implementations that fail to accept anything + + + +Fielding, et al. Standards Track [Page 31] + +RFC 2616 HTTP/1.1 June 1999 + + + beyond the common forms. + + message-header = field-name ":" [ field-value ] + field-name = token + field-value = *( field-content | LWS ) + field-content = + + The field-content does not include any leading or trailing LWS: + linear white space occurring before the first non-whitespace + character of the field-value or after the last non-whitespace + character of the field-value. Such leading or trailing LWS MAY be + removed without changing the semantics of the field value. Any LWS + that occurs between field-content MAY be replaced with a single SP + before interpreting the field value or forwarding the message + downstream. + + The order in which header fields with differing field names are + received is not significant. However, it is "good practice" to send + general-header fields first, followed by request-header or response- + header fields, and ending with the entity-header fields. + + Multiple message-header fields with the same field-name MAY be + present in a message if and only if the entire field-value for that + header field is defined as a comma-separated list [i.e., #(values)]. + It MUST be possible to combine the multiple header fields into one + "field-name: field-value" pair, without changing the semantics of the + message, by appending each subsequent field-value to the first, each + separated by a comma. The order in which header fields with the same + field-name are received is therefore significant to the + interpretation of the combined field value, and thus a proxy MUST NOT + change the order of these field values when a message is forwarded. + +4.3 Message Body + + The message-body (if any) of an HTTP message is used to carry the + entity-body associated with the request or response. The message-body + differs from the entity-body only when a transfer-coding has been + applied, as indicated by the Transfer-Encoding header field (section + 14.41). + + message-body = entity-body + | + + Transfer-Encoding MUST be used to indicate any transfer-codings + applied by an application to ensure safe and proper transfer of the + message. Transfer-Encoding is a property of the message, not of the + + + +Fielding, et al. Standards Track [Page 32] + +RFC 2616 HTTP/1.1 June 1999 + + + entity, and thus MAY be added or removed by any application along the + request/response chain. (However, section 3.6 places restrictions on + when certain transfer-codings may be used.) + + The rules for when a message-body is allowed in a message differ for + requests and responses. + + The presence of a message-body in a request is signaled by the + inclusion of a Content-Length or Transfer-Encoding header field in + the request's message-headers. A message-body MUST NOT be included in + a request if the specification of the request method (section 5.1.1) + does not allow sending an entity-body in requests. A server SHOULD + read and forward a message-body on any request; if the request method + does not include defined semantics for an entity-body, then the + message-body SHOULD be ignored when handling the request. + + For response messages, whether or not a message-body is included with + a message is dependent on both the request method and the response + status code (section 6.1.1). All responses to the HEAD request method + MUST NOT include a message-body, even though the presence of entity- + header fields might lead one to believe they do. All 1xx + (informational), 204 (no content), and 304 (not modified) responses + MUST NOT include a message-body. All other responses do include a + message-body, although it MAY be of zero length. + +4.4 Message Length + + The transfer-length of a message is the length of the message-body as + it appears in the message; that is, after any transfer-codings have + been applied. When a message-body is included with a message, the + transfer-length of that body is determined by one of the following + (in order of precedence): + + 1.Any response message which "MUST NOT" include a message-body (such + as the 1xx, 204, and 304 responses and any response to a HEAD + request) is always terminated by the first empty line after the + header fields, regardless of the entity-header fields present in + the message. + + 2.If a Transfer-Encoding header field (section 14.41) is present and + has any value other than "identity", then the transfer-length is + defined by use of the "chunked" transfer-coding (section 3.6), + unless the message is terminated by closing the connection. + + 3.If a Content-Length header field (section 14.13) is present, its + decimal value in OCTETs represents both the entity-length and the + transfer-length. The Content-Length header field MUST NOT be sent + if these two lengths are different (i.e., if a Transfer-Encoding + + + +Fielding, et al. Standards Track [Page 33] + +RFC 2616 HTTP/1.1 June 1999 + + + header field is present). If a message is received with both a + Transfer-Encoding header field and a Content-Length header field, + the latter MUST be ignored. + + 4.If the message uses the media type "multipart/byteranges", and the + ransfer-length is not otherwise specified, then this self- + elimiting media type defines the transfer-length. This media type + UST NOT be used unless the sender knows that the recipient can arse + it; the presence in a request of a Range header with ultiple byte- + range specifiers from a 1.1 client implies that the lient can parse + multipart/byteranges responses. + + A range header might be forwarded by a 1.0 proxy that does not + understand multipart/byteranges; in this case the server MUST + delimit the message using methods defined in items 1,3 or 5 of + this section. + + 5.By the server closing the connection. (Closing the connection + cannot be used to indicate the end of a request body, since that + would leave no possibility for the server to send back a response.) + + For compatibility with HTTP/1.0 applications, HTTP/1.1 requests + containing a message-body MUST include a valid Content-Length header + field unless the server is known to be HTTP/1.1 compliant. If a + request contains a message-body and a Content-Length is not given, + the server SHOULD respond with 400 (bad request) if it cannot + determine the length of the message, or with 411 (length required) if + it wishes to insist on receiving a valid Content-Length. + + All HTTP/1.1 applications that receive entities MUST accept the + "chunked" transfer-coding (section 3.6), thus allowing this mechanism + to be used for messages when the message length cannot be determined + in advance. + + Messages MUST NOT include both a Content-Length header field and a + non-identity transfer-coding. If the message does include a non- + identity transfer-coding, the Content-Length MUST be ignored. + + When a Content-Length is given in a message where a message-body is + allowed, its field value MUST exactly match the number of OCTETs in + the message-body. HTTP/1.1 user agents MUST notify the user when an + invalid length is received and detected. + +4.5 General Header Fields + + There are a few header fields which have general applicability for + both request and response messages, but which do not apply to the + entity being transferred. These header fields apply only to the + + + +Fielding, et al. Standards Track [Page 34] + +RFC 2616 HTTP/1.1 June 1999 + + + message being transmitted. + + general-header = Cache-Control ; Section 14.9 + | Connection ; Section 14.10 + | Date ; Section 14.18 + | Pragma ; Section 14.32 + | Trailer ; Section 14.40 + | Transfer-Encoding ; Section 14.41 + | Upgrade ; Section 14.42 + | Via ; Section 14.45 + | Warning ; Section 14.46 + + General-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields may be given the semantics of general + header fields if all parties in the communication recognize them to + be general-header fields. Unrecognized header fields are treated as + entity-header fields. + +5 Request + + A request message from a client to a server includes, within the + first line of that message, the method to be applied to the resource, + the identifier of the resource, and the protocol version in use. + + Request = Request-Line ; Section 5.1 + *(( general-header ; Section 4.5 + | request-header ; Section 5.3 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 4.3 + +5.1 Request-Line + + The Request-Line begins with a method token, followed by the + Request-URI and the protocol version, and ending with CRLF. The + elements are separated by SP characters. No CR or LF is allowed + except in the final CRLF sequence. + + Request-Line = Method SP Request-URI SP HTTP-Version CRLF + + + + + + + + + + + +Fielding, et al. Standards Track [Page 35] + +RFC 2616 HTTP/1.1 June 1999 + + +5.1.1 Method + + The Method token indicates the method to be performed on the + resource identified by the Request-URI. The method is case-sensitive. + + Method = "OPTIONS" ; Section 9.2 + | "GET" ; Section 9.3 + | "HEAD" ; Section 9.4 + | "POST" ; Section 9.5 + | "PUT" ; Section 9.6 + | "DELETE" ; Section 9.7 + | "TRACE" ; Section 9.8 + | "CONNECT" ; Section 9.9 + | extension-method + extension-method = token + + The list of methods allowed by a resource can be specified in an + Allow header field (section 14.7). The return code of the response + always notifies the client whether a method is currently allowed on a + resource, since the set of allowed methods can change dynamically. An + origin server SHOULD return the status code 405 (Method Not Allowed) + if the method is known by the origin server but not allowed for the + requested resource, and 501 (Not Implemented) if the method is + unrecognized or not implemented by the origin server. The methods GET + and HEAD MUST be supported by all general-purpose servers. All other + methods are OPTIONAL; however, if the above methods are implemented, + they MUST be implemented with the same semantics as those specified + in section 9. + +5.1.2 Request-URI + + The Request-URI is a Uniform Resource Identifier (section 3.2) and + identifies the resource upon which to apply the request. + + Request-URI = "*" | absoluteURI | abs_path | authority + + The four options for Request-URI are dependent on the nature of the + request. The asterisk "*" means that the request does not apply to a + particular resource, but to the server itself, and is only allowed + when the method used does not necessarily apply to a resource. One + example would be + + OPTIONS * HTTP/1.1 + + The absoluteURI form is REQUIRED when the request is being made to a + proxy. The proxy is requested to forward the request or service it + from a valid cache, and return the response. Note that the proxy MAY + forward the request on to another proxy or directly to the server + + + +Fielding, et al. Standards Track [Page 36] + +RFC 2616 HTTP/1.1 June 1999 + + + specified by the absoluteURI. In order to avoid request loops, a + proxy MUST be able to recognize all of its server names, including + any aliases, local variations, and the numeric IP address. An example + Request-Line would be: + + GET http://www.w3.org/pub/WWW/TheProject.html HTTP/1.1 + + To allow for transition to absoluteURIs in all requests in future + versions of HTTP, all HTTP/1.1 servers MUST accept the absoluteURI + form in requests, even though HTTP/1.1 clients will only generate + them in requests to proxies. + + The authority form is only used by the CONNECT method (section 9.9). + + The most common form of Request-URI is that used to identify a + resource on an origin server or gateway. In this case the absolute + path of the URI MUST be transmitted (see section 3.2.1, abs_path) as + the Request-URI, and the network location of the URI (authority) MUST + be transmitted in a Host header field. For example, a client wishing + to retrieve the resource above directly from the origin server would + create a TCP connection to port 80 of the host "www.w3.org" and send + the lines: + + GET /pub/WWW/TheProject.html HTTP/1.1 + Host: www.w3.org + + followed by the remainder of the Request. Note that the absolute path + cannot be empty; if none is present in the original URI, it MUST be + given as "/" (the server root). + + The Request-URI is transmitted in the format specified in section + 3.2.1. If the Request-URI is encoded using the "% HEX HEX" encoding + [42], the origin server MUST decode the Request-URI in order to + properly interpret the request. Servers SHOULD respond to invalid + Request-URIs with an appropriate status code. + + A transparent proxy MUST NOT rewrite the "abs_path" part of the + received Request-URI when forwarding it to the next inbound server, + except as noted above to replace a null abs_path with "/". + + Note: The "no rewrite" rule prevents the proxy from changing the + meaning of the request when the origin server is improperly using + a non-reserved URI character for a reserved purpose. Implementors + should be aware that some pre-HTTP/1.1 proxies have been known to + rewrite the Request-URI. + + + + + + +Fielding, et al. Standards Track [Page 37] + +RFC 2616 HTTP/1.1 June 1999 + + +5.2 The Resource Identified by a Request + + The exact resource identified by an Internet request is determined by + examining both the Request-URI and the Host header field. + + An origin server that does not allow resources to differ by the + requested host MAY ignore the Host header field value when + determining the resource identified by an HTTP/1.1 request. (But see + section 19.6.1.1 for other requirements on Host support in HTTP/1.1.) + + An origin server that does differentiate resources based on the host + requested (sometimes referred to as virtual hosts or vanity host + names) MUST use the following rules for determining the requested + resource on an HTTP/1.1 request: + + 1. If Request-URI is an absoluteURI, the host is part of the + Request-URI. Any Host header field value in the request MUST be + ignored. + + 2. If the Request-URI is not an absoluteURI, and the request includes + a Host header field, the host is determined by the Host header + field value. + + 3. If the host as determined by rule 1 or 2 is not a valid host on + the server, the response MUST be a 400 (Bad Request) error message. + + Recipients of an HTTP/1.0 request that lacks a Host header field MAY + attempt to use heuristics (e.g., examination of the URI path for + something unique to a particular host) in order to determine what + exact resource is being requested. + +5.3 Request Header Fields + + The request-header fields allow the client to pass additional + information about the request, and about the client itself, to the + server. These fields act as request modifiers, with semantics + equivalent to the parameters on a programming language method + invocation. + + request-header = Accept ; Section 14.1 + | Accept-Charset ; Section 14.2 + | Accept-Encoding ; Section 14.3 + | Accept-Language ; Section 14.4 + | Authorization ; Section 14.8 + | Expect ; Section 14.20 + | From ; Section 14.22 + | Host ; Section 14.23 + | If-Match ; Section 14.24 + + + +Fielding, et al. Standards Track [Page 38] + +RFC 2616 HTTP/1.1 June 1999 + + + | If-Modified-Since ; Section 14.25 + | If-None-Match ; Section 14.26 + | If-Range ; Section 14.27 + | If-Unmodified-Since ; Section 14.28 + | Max-Forwards ; Section 14.31 + | Proxy-Authorization ; Section 14.34 + | Range ; Section 14.35 + | Referer ; Section 14.36 + | TE ; Section 14.39 + | User-Agent ; Section 14.43 + + Request-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of request- + header fields if all parties in the communication recognize them to + be request-header fields. Unrecognized header fields are treated as + entity-header fields. + +6 Response + + After receiving and interpreting a request message, a server responds + with an HTTP response message. + + Response = Status-Line ; Section 6.1 + *(( general-header ; Section 4.5 + | response-header ; Section 6.2 + | entity-header ) CRLF) ; Section 7.1 + CRLF + [ message-body ] ; Section 7.2 + +6.1 Status-Line + + The first line of a Response message is the Status-Line, consisting + of the protocol version followed by a numeric status code and its + associated textual phrase, with each element separated by SP + characters. No CR or LF is allowed except in the final CRLF sequence. + + Status-Line = HTTP-Version SP Status-Code SP Reason-Phrase CRLF + +6.1.1 Status Code and Reason Phrase + + The Status-Code element is a 3-digit integer result code of the + attempt to understand and satisfy the request. These codes are fully + defined in section 10. The Reason-Phrase is intended to give a short + textual description of the Status-Code. The Status-Code is intended + for use by automata and the Reason-Phrase is intended for the human + user. The client is not required to examine or display the Reason- + Phrase. + + + +Fielding, et al. Standards Track [Page 39] + +RFC 2616 HTTP/1.1 June 1999 + + + The first digit of the Status-Code defines the class of response. The + last two digits do not have any categorization role. There are 5 + values for the first digit: + + - 1xx: Informational - Request received, continuing process + + - 2xx: Success - The action was successfully received, + understood, and accepted + + - 3xx: Redirection - Further action must be taken in order to + complete the request + + - 4xx: Client Error - The request contains bad syntax or cannot + be fulfilled + + - 5xx: Server Error - The server failed to fulfill an apparently + valid request + + The individual values of the numeric status codes defined for + HTTP/1.1, and an example set of corresponding Reason-Phrase's, are + presented below. The reason phrases listed here are only + recommendations -- they MAY be replaced by local equivalents without + affecting the protocol. + + Status-Code = + "100" ; Section 10.1.1: Continue + | "101" ; Section 10.1.2: Switching Protocols + | "200" ; Section 10.2.1: OK + | "201" ; Section 10.2.2: Created + | "202" ; Section 10.2.3: Accepted + | "203" ; Section 10.2.4: Non-Authoritative Information + | "204" ; Section 10.2.5: No Content + | "205" ; Section 10.2.6: Reset Content + | "206" ; Section 10.2.7: Partial Content + | "300" ; Section 10.3.1: Multiple Choices + | "301" ; Section 10.3.2: Moved Permanently + | "302" ; Section 10.3.3: Found + | "303" ; Section 10.3.4: See Other + | "304" ; Section 10.3.5: Not Modified + | "305" ; Section 10.3.6: Use Proxy + | "307" ; Section 10.3.8: Temporary Redirect + | "400" ; Section 10.4.1: Bad Request + | "401" ; Section 10.4.2: Unauthorized + | "402" ; Section 10.4.3: Payment Required + | "403" ; Section 10.4.4: Forbidden + | "404" ; Section 10.4.5: Not Found + | "405" ; Section 10.4.6: Method Not Allowed + | "406" ; Section 10.4.7: Not Acceptable + + + +Fielding, et al. Standards Track [Page 40] + +RFC 2616 HTTP/1.1 June 1999 + + + | "407" ; Section 10.4.8: Proxy Authentication Required + | "408" ; Section 10.4.9: Request Time-out + | "409" ; Section 10.4.10: Conflict + | "410" ; Section 10.4.11: Gone + | "411" ; Section 10.4.12: Length Required + | "412" ; Section 10.4.13: Precondition Failed + | "413" ; Section 10.4.14: Request Entity Too Large + | "414" ; Section 10.4.15: Request-URI Too Large + | "415" ; Section 10.4.16: Unsupported Media Type + | "416" ; Section 10.4.17: Requested range not satisfiable + | "417" ; Section 10.4.18: Expectation Failed + | "500" ; Section 10.5.1: Internal Server Error + | "501" ; Section 10.5.2: Not Implemented + | "502" ; Section 10.5.3: Bad Gateway + | "503" ; Section 10.5.4: Service Unavailable + | "504" ; Section 10.5.5: Gateway Time-out + | "505" ; Section 10.5.6: HTTP Version not supported + | extension-code + + extension-code = 3DIGIT + Reason-Phrase = * + + HTTP status codes are extensible. HTTP applications are not required + to understand the meaning of all registered status codes, though such + understanding is obviously desirable. However, applications MUST + understand the class of any status code, as indicated by the first + digit, and treat any unrecognized response as being equivalent to the + x00 status code of that class, with the exception that an + unrecognized response MUST NOT be cached. For example, if an + unrecognized status code of 431 is received by the client, it can + safely assume that there was something wrong with its request and + treat the response as if it had received a 400 status code. In such + cases, user agents SHOULD present to the user the entity returned + with the response, since that entity is likely to include human- + readable information which will explain the unusual status. + +6.2 Response Header Fields + + The response-header fields allow the server to pass additional + information about the response which cannot be placed in the Status- + Line. These header fields give information about the server and about + further access to the resource identified by the Request-URI. + + response-header = Accept-Ranges ; Section 14.5 + | Age ; Section 14.6 + | ETag ; Section 14.19 + | Location ; Section 14.30 + | Proxy-Authenticate ; Section 14.33 + + + +Fielding, et al. Standards Track [Page 41] + +RFC 2616 HTTP/1.1 June 1999 + + + | Retry-After ; Section 14.37 + | Server ; Section 14.38 + | Vary ; Section 14.44 + | WWW-Authenticate ; Section 14.47 + + Response-header field names can be extended reliably only in + combination with a change in the protocol version. However, new or + experimental header fields MAY be given the semantics of response- + header fields if all parties in the communication recognize them to + be response-header fields. Unrecognized header fields are treated as + entity-header fields. + +7 Entity + + Request and Response messages MAY transfer an entity if not otherwise + restricted by the request method or response status code. An entity + consists of entity-header fields and an entity-body, although some + responses will only include the entity-headers. + + In this section, both sender and recipient refer to either the client + or the server, depending on who sends and who receives the entity. + +7.1 Entity Header Fields + + Entity-header fields define metainformation about the entity-body or, + if no body is present, about the resource identified by the request. + Some of this metainformation is OPTIONAL; some might be REQUIRED by + portions of this specification. + + entity-header = Allow ; Section 14.7 + | Content-Encoding ; Section 14.11 + | Content-Language ; Section 14.12 + | Content-Length ; Section 14.13 + | Content-Location ; Section 14.14 + | Content-MD5 ; Section 14.15 + | Content-Range ; Section 14.16 + | Content-Type ; Section 14.17 + | Expires ; Section 14.21 + | Last-Modified ; Section 14.29 + | extension-header + + extension-header = message-header + + The extension-header mechanism allows additional entity-header fields + to be defined without changing the protocol, but these fields cannot + be assumed to be recognizable by the recipient. Unrecognized header + fields SHOULD be ignored by the recipient and MUST be forwarded by + transparent proxies. + + + +Fielding, et al. Standards Track [Page 42] + +RFC 2616 HTTP/1.1 June 1999 + + +7.2 Entity Body + + The entity-body (if any) sent with an HTTP request or response is in + a format and encoding defined by the entity-header fields. + + entity-body = *OCTET + + An entity-body is only present in a message when a message-body is + present, as described in section 4.3. The entity-body is obtained + from the message-body by decoding any Transfer-Encoding that might + have been applied to ensure safe and proper transfer of the message. + +7.2.1 Type + + When an entity-body is included with a message, the data type of that + body is determined via the header fields Content-Type and Content- + Encoding. These define a two-layer, ordered encoding model: + + entity-body := Content-Encoding( Content-Type( data ) ) + + Content-Type specifies the media type of the underlying data. + Content-Encoding may be used to indicate any additional content + codings applied to the data, usually for the purpose of data + compression, that are a property of the requested resource. There is + no default encoding. + + Any HTTP/1.1 message containing an entity-body SHOULD include a + Content-Type header field defining the media type of that body. If + and only if the media type is not given by a Content-Type field, the + recipient MAY attempt to guess the media type via inspection of its + content and/or the name extension(s) of the URI used to identify the + resource. If the media type remains unknown, the recipient SHOULD + treat it as type "application/octet-stream". + +7.2.2 Entity Length + + The entity-length of a message is the length of the message-body + before any transfer-codings have been applied. Section 4.4 defines + how the transfer-length of a message-body is determined. + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 43] + +RFC 2616 HTTP/1.1 June 1999 + + +8 Connections + +8.1 Persistent Connections + +8.1.1 Purpose + + Prior to persistent connections, a separate TCP connection was + established to fetch each URL, increasing the load on HTTP servers + and causing congestion on the Internet. The use of inline images and + other associated data often require a client to make multiple + requests of the same server in a short amount of time. Analysis of + these performance problems and results from a prototype + implementation are available [26] [30]. Implementation experience and + measurements of actual HTTP/1.1 (RFC 2068) implementations show good + results [39]. Alternatives have also been explored, for example, + T/TCP [27]. + + Persistent HTTP connections have a number of advantages: + + - By opening and closing fewer TCP connections, CPU time is saved + in routers and hosts (clients, servers, proxies, gateways, + tunnels, or caches), and memory used for TCP protocol control + blocks can be saved in hosts. + + - HTTP requests and responses can be pipelined on a connection. + Pipelining allows a client to make multiple requests without + waiting for each response, allowing a single TCP connection to + be used much more efficiently, with much lower elapsed time. + + - Network congestion is reduced by reducing the number of packets + caused by TCP opens, and by allowing TCP sufficient time to + determine the congestion state of the network. + + - Latency on subsequent requests is reduced since there is no time + spent in TCP's connection opening handshake. + + - HTTP can evolve more gracefully, since errors can be reported + without the penalty of closing the TCP connection. Clients using + future versions of HTTP might optimistically try a new feature, + but if communicating with an older server, retry with old + semantics after an error is reported. + + HTTP implementations SHOULD implement persistent connections. + + + + + + + + +Fielding, et al. Standards Track [Page 44] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2 Overall Operation + + A significant difference between HTTP/1.1 and earlier versions of + HTTP is that persistent connections are the default behavior of any + HTTP connection. That is, unless otherwise indicated, the client + SHOULD assume that the server will maintain a persistent connection, + even after error responses from the server. + + Persistent connections provide a mechanism by which a client and a + server can signal the close of a TCP connection. This signaling takes + place using the Connection header field (section 14.10). Once a close + has been signaled, the client MUST NOT send any more requests on that + connection. + +8.1.2.1 Negotiation + + An HTTP/1.1 server MAY assume that a HTTP/1.1 client intends to + maintain a persistent connection unless a Connection header including + the connection-token "close" was sent in the request. If the server + chooses to close the connection immediately after sending the + response, it SHOULD send a Connection header including the + connection-token close. + + An HTTP/1.1 client MAY expect a connection to remain open, but would + decide to keep it open based on whether the response from a server + contains a Connection header with the connection-token close. In case + the client does not want to maintain a connection for more than that + request, it SHOULD send a Connection header including the + connection-token close. + + If either the client or the server sends the close token in the + Connection header, that request becomes the last one for the + connection. + + Clients and servers SHOULD NOT assume that a persistent connection is + maintained for HTTP versions less than 1.1 unless it is explicitly + signaled. See section 19.6.2 for more information on backward + compatibility with HTTP/1.0 clients. + + In order to remain persistent, all messages on the connection MUST + have a self-defined message length (i.e., one not defined by closure + of the connection), as described in section 4.4. + + + + + + + + + +Fielding, et al. Standards Track [Page 45] + +RFC 2616 HTTP/1.1 June 1999 + + +8.1.2.2 Pipelining + + A client that supports persistent connections MAY "pipeline" its + requests (i.e., send multiple requests without waiting for each + response). A server MUST send its responses to those requests in the + same order that the requests were received. + + Clients which assume persistent connections and pipeline immediately + after connection establishment SHOULD be prepared to retry their + connection if the first pipelined attempt fails. If a client does + such a retry, it MUST NOT pipeline before it knows the connection is + persistent. Clients MUST also be prepared to resend their requests if + the server closes the connection before sending all of the + corresponding responses. + + Clients SHOULD NOT pipeline requests using non-idempotent methods or + non-idempotent sequences of methods (see section 9.1.2). Otherwise, a + premature termination of the transport connection could lead to + indeterminate results. A client wishing to send a non-idempotent + request SHOULD wait to send that request until it has received the + response status for the previous request. + +8.1.3 Proxy Servers + + It is especially important that proxies correctly implement the + properties of the Connection header field as specified in section + 14.10. + + The proxy server MUST signal persistent connections separately with + its clients and the origin servers (or other proxy servers) that it + connects to. Each persistent connection applies to only one transport + link. + + A proxy server MUST NOT establish a HTTP/1.1 persistent connection + with an HTTP/1.0 client (but see RFC 2068 [33] for information and + discussion of the problems with the Keep-Alive header implemented by + many HTTP/1.0 clients). + +8.1.4 Practical Considerations + + Servers will usually have some time-out value beyond which they will + no longer maintain an inactive connection. Proxy servers might make + this a higher value since it is likely that the client will be making + more connections through the same server. The use of persistent + connections places no requirements on the length (or existence) of + this time-out for either the client or the server. + + + + + +Fielding, et al. Standards Track [Page 46] + +RFC 2616 HTTP/1.1 June 1999 + + + When a client or server wishes to time-out it SHOULD issue a graceful + close on the transport connection. Clients and servers SHOULD both + constantly watch for the other side of the transport close, and + respond to it as appropriate. If a client or server does not detect + the other side's close promptly it could cause unnecessary resource + drain on the network. + + A client, server, or proxy MAY close the transport connection at any + time. For example, a client might have started to send a new request + at the same time that the server has decided to close the "idle" + connection. From the server's point of view, the connection is being + closed while it was idle, but from the client's point of view, a + request is in progress. + + This means that clients, servers, and proxies MUST be able to recover + from asynchronous close events. Client software SHOULD reopen the + transport connection and retransmit the aborted sequence of requests + without user interaction so long as the request sequence is + idempotent (see section 9.1.2). Non-idempotent methods or sequences + MUST NOT be automatically retried, although user agents MAY offer a + human operator the choice of retrying the request(s). Confirmation by + user-agent software with semantic understanding of the application + MAY substitute for user confirmation. The automatic retry SHOULD NOT + be repeated if the second sequence of requests fails. + + Servers SHOULD always respond to at least one request per connection, + if at all possible. Servers SHOULD NOT close a connection in the + middle of transmitting a response, unless a network or client failure + is suspected. + + Clients that use persistent connections SHOULD limit the number of + simultaneous connections that they maintain to a given server. A + single-user client SHOULD NOT maintain more than 2 connections with + any server or proxy. A proxy SHOULD use up to 2*N connections to + another server or proxy, where N is the number of simultaneously + active users. These guidelines are intended to improve HTTP response + times and avoid congestion. + +8.2 Message Transmission Requirements + +8.2.1 Persistent Connections and Flow Control + + HTTP/1.1 servers SHOULD maintain persistent connections and use TCP's + flow control mechanisms to resolve temporary overloads, rather than + terminating connections with the expectation that clients will retry. + The latter technique can exacerbate network congestion. + + + + + +Fielding, et al. Standards Track [Page 47] + +RFC 2616 HTTP/1.1 June 1999 + + +8.2.2 Monitoring Connections for Error Status Messages + + An HTTP/1.1 (or later) client sending a message-body SHOULD monitor + the network connection for an error status while it is transmitting + the request. If the client sees an error status, it SHOULD + immediately cease transmitting the body. If the body is being sent + using a "chunked" encoding (section 3.6), a zero length chunk and + empty trailer MAY be used to prematurely mark the end of the message. + If the body was preceded by a Content-Length header, the client MUST + close the connection. + +8.2.3 Use of the 100 (Continue) Status + + The purpose of the 100 (Continue) status (see section 10.1.1) is to + allow a client that is sending a request message with a request body + to determine if the origin server is willing to accept the request + (based on the request headers) before the client sends the request + body. In some cases, it might either be inappropriate or highly + inefficient for the client to send the body if the server will reject + the message without looking at the body. + + Requirements for HTTP/1.1 clients: + + - If a client will wait for a 100 (Continue) response before + sending the request body, it MUST send an Expect request-header + field (section 14.20) with the "100-continue" expectation. + + - A client MUST NOT send an Expect request-header field (section + 14.20) with the "100-continue" expectation if it does not intend + to send a request body. + + Because of the presence of older implementations, the protocol allows + ambiguous situations in which a client may send "Expect: 100- + continue" without receiving either a 417 (Expectation Failed) status + or a 100 (Continue) status. Therefore, when a client sends this + header field to an origin server (possibly via a proxy) from which it + has never seen a 100 (Continue) status, the client SHOULD NOT wait + for an indefinite period before sending the request body. + + Requirements for HTTP/1.1 origin servers: + + - Upon receiving a request which includes an Expect request-header + field with the "100-continue" expectation, an origin server MUST + either respond with 100 (Continue) status and continue to read + from the input stream, or respond with a final status code. The + origin server MUST NOT wait for the request body before sending + the 100 (Continue) response. If it responds with a final status + code, it MAY close the transport connection or it MAY continue + + + +Fielding, et al. Standards Track [Page 48] + +RFC 2616 HTTP/1.1 June 1999 + + + to read and discard the rest of the request. It MUST NOT + perform the requested method if it returns a final status code. + + - An origin server SHOULD NOT send a 100 (Continue) response if + the request message does not include an Expect request-header + field with the "100-continue" expectation, and MUST NOT send a + 100 (Continue) response if such a request comes from an HTTP/1.0 + (or earlier) client. There is an exception to this rule: for + compatibility with RFC 2068, a server MAY send a 100 (Continue) + status in response to an HTTP/1.1 PUT or POST request that does + not include an Expect request-header field with the "100- + continue" expectation. This exception, the purpose of which is + to minimize any client processing delays associated with an + undeclared wait for 100 (Continue) status, applies only to + HTTP/1.1 requests, and not to requests with any other HTTP- + version value. + + - An origin server MAY omit a 100 (Continue) response if it has + already received some or all of the request body for the + corresponding request. + + - An origin server that sends a 100 (Continue) response MUST + ultimately send a final status code, once the request body is + received and processed, unless it terminates the transport + connection prematurely. + + - If an origin server receives a request that does not include an + Expect request-header field with the "100-continue" expectation, + the request includes a request body, and the server responds + with a final status code before reading the entire request body + from the transport connection, then the server SHOULD NOT close + the transport connection until it has read the entire request, + or until the client closes the connection. Otherwise, the client + might not reliably receive the response message. However, this + requirement is not be construed as preventing a server from + defending itself against denial-of-service attacks, or from + badly broken client implementations. + + Requirements for HTTP/1.1 proxies: + + - If a proxy receives a request that includes an Expect request- + header field with the "100-continue" expectation, and the proxy + either knows that the next-hop server complies with HTTP/1.1 or + higher, or does not know the HTTP version of the next-hop + server, it MUST forward the request, including the Expect header + field. + + + + + +Fielding, et al. Standards Track [Page 49] + +RFC 2616 HTTP/1.1 June 1999 + + + - If the proxy knows that the version of the next-hop server is + HTTP/1.0 or lower, it MUST NOT forward the request, and it MUST + respond with a 417 (Expectation Failed) status. + + - Proxies SHOULD maintain a cache recording the HTTP version + numbers received from recently-referenced next-hop servers. + + - A proxy MUST NOT forward a 100 (Continue) response if the + request message was received from an HTTP/1.0 (or earlier) + client and did not include an Expect request-header field with + the "100-continue" expectation. This requirement overrides the + general rule for forwarding of 1xx responses (see section 10.1). + +8.2.4 Client Behavior if Server Prematurely Closes Connection + + If an HTTP/1.1 client sends a request which includes a request body, + but which does not include an Expect request-header field with the + "100-continue" expectation, and if the client is not directly + connected to an HTTP/1.1 origin server, and if the client sees the + connection close before receiving any status from the server, the + client SHOULD retry the request. If the client does retry this + request, it MAY use the following "binary exponential backoff" + algorithm to be assured of obtaining a reliable response: + + 1. Initiate a new connection to the server + + 2. Transmit the request-headers + + 3. Initialize a variable R to the estimated round-trip time to the + server (e.g., based on the time it took to establish the + connection), or to a constant value of 5 seconds if the round- + trip time is not available. + + 4. Compute T = R * (2**N), where N is the number of previous + retries of this request. + + 5. Wait either for an error response from the server, or for T + seconds (whichever comes first) + + 6. If no error response is received, after T seconds transmit the + body of the request. + + 7. If client sees that the connection is closed prematurely, + repeat from step 1 until the request is accepted, an error + response is received, or the user becomes impatient and + terminates the retry process. + + + + + +Fielding, et al. Standards Track [Page 50] + +RFC 2616 HTTP/1.1 June 1999 + + + If at any point an error status is received, the client + + - SHOULD NOT continue and + + - SHOULD close the connection if it has not completed sending the + request message. + +9 Method Definitions + + The set of common methods for HTTP/1.1 is defined below. Although + this set can be expanded, additional methods cannot be assumed to + share the same semantics for separately extended clients and servers. + + The Host request-header field (section 14.23) MUST accompany all + HTTP/1.1 requests. + +9.1 Safe and Idempotent Methods + +9.1.1 Safe Methods + + Implementors should be aware that the software represents the user in + their interactions over the Internet, and should be careful to allow + the user to be aware of any actions they might take which may have an + unexpected significance to themselves or others. + + In particular, the convention has been established that the GET and + HEAD methods SHOULD NOT have the significance of taking an action + other than retrieval. These methods ought to be considered "safe". + This allows user agents to represent other methods, such as POST, PUT + and DELETE, in a special way, so that the user is made aware of the + fact that a possibly unsafe action is being requested. + + Naturally, it is not possible to ensure that the server does not + generate side-effects as a result of performing a GET request; in + fact, some dynamic resources consider that a feature. The important + distinction here is that the user did not request the side-effects, + so therefore cannot be held accountable for them. + +9.1.2 Idempotent Methods + + Methods can also have the property of "idempotence" in that (aside + from error or expiration issues) the side-effects of N > 0 identical + requests is the same as for a single request. The methods GET, HEAD, + PUT and DELETE share this property. Also, the methods OPTIONS and + TRACE SHOULD NOT have side effects, and so are inherently idempotent. + + + + + + +Fielding, et al. Standards Track [Page 51] + +RFC 2616 HTTP/1.1 June 1999 + + + However, it is possible that a sequence of several requests is non- + idempotent, even if all of the methods executed in that sequence are + idempotent. (A sequence is idempotent if a single execution of the + entire sequence always yields a result that is not changed by a + reexecution of all, or part, of that sequence.) For example, a + sequence is non-idempotent if its result depends on a value that is + later modified in the same sequence. + + A sequence that never has side effects is idempotent, by definition + (provided that no concurrent operations are being executed on the + same set of resources). + +9.2 OPTIONS + + The OPTIONS method represents a request for information about the + communication options available on the request/response chain + identified by the Request-URI. This method allows the client to + determine the options and/or requirements associated with a resource, + or the capabilities of a server, without implying a resource action + or initiating a resource retrieval. + + Responses to this method are not cacheable. + + If the OPTIONS request includes an entity-body (as indicated by the + presence of Content-Length or Transfer-Encoding), then the media type + MUST be indicated by a Content-Type field. Although this + specification does not define any use for such a body, future + extensions to HTTP might use the OPTIONS body to make more detailed + queries on the server. A server that does not support such an + extension MAY discard the request body. + + If the Request-URI is an asterisk ("*"), the OPTIONS request is + intended to apply to the server in general rather than to a specific + resource. Since a server's communication options typically depend on + the resource, the "*" request is only useful as a "ping" or "no-op" + type of method; it does nothing beyond allowing the client to test + the capabilities of the server. For example, this can be used to test + a proxy for HTTP/1.1 compliance (or lack thereof). + + If the Request-URI is not an asterisk, the OPTIONS request applies + only to the options that are available when communicating with that + resource. + + A 200 response SHOULD include any header fields that indicate + optional features implemented by the server and applicable to that + resource (e.g., Allow), possibly including extensions not defined by + this specification. The response body, if any, SHOULD also include + information about the communication options. The format for such a + + + +Fielding, et al. Standards Track [Page 52] + +RFC 2616 HTTP/1.1 June 1999 + + + body is not defined by this specification, but might be defined by + future extensions to HTTP. Content negotiation MAY be used to select + the appropriate response format. If no response body is included, the + response MUST include a Content-Length field with a field-value of + "0". + + The Max-Forwards request-header field MAY be used to target a + specific proxy in the request chain. When a proxy receives an OPTIONS + request on an absoluteURI for which request forwarding is permitted, + the proxy MUST check for a Max-Forwards field. If the Max-Forwards + field-value is zero ("0"), the proxy MUST NOT forward the message; + instead, the proxy SHOULD respond with its own communication options. + If the Max-Forwards field-value is an integer greater than zero, the + proxy MUST decrement the field-value when it forwards the request. If + no Max-Forwards field is present in the request, then the forwarded + request MUST NOT include a Max-Forwards field. + +9.3 GET + + The GET method means retrieve whatever information (in the form of an + entity) is identified by the Request-URI. If the Request-URI refers + to a data-producing process, it is the produced data which shall be + returned as the entity in the response and not the source text of the + process, unless that text happens to be the output of the process. + + The semantics of the GET method change to a "conditional GET" if the + request message includes an If-Modified-Since, If-Unmodified-Since, + If-Match, If-None-Match, or If-Range header field. A conditional GET + method requests that the entity be transferred only under the + circumstances described by the conditional header field(s). The + conditional GET method is intended to reduce unnecessary network + usage by allowing cached entities to be refreshed without requiring + multiple requests or transferring data already held by the client. + + The semantics of the GET method change to a "partial GET" if the + request message includes a Range header field. A partial GET requests + that only part of the entity be transferred, as described in section + 14.35. The partial GET method is intended to reduce unnecessary + network usage by allowing partially-retrieved entities to be + completed without transferring data already held by the client. + + The response to a GET request is cacheable if and only if it meets + the requirements for HTTP caching described in section 13. + + See section 15.1.3 for security considerations when used for forms. + + + + + + +Fielding, et al. Standards Track [Page 53] + +RFC 2616 HTTP/1.1 June 1999 + + +9.4 HEAD + + The HEAD method is identical to GET except that the server MUST NOT + return a message-body in the response. The metainformation contained + in the HTTP headers in response to a HEAD request SHOULD be identical + to the information sent in response to a GET request. This method can + be used for obtaining metainformation about the entity implied by the + request without transferring the entity-body itself. This method is + often used for testing hypertext links for validity, accessibility, + and recent modification. + + The response to a HEAD request MAY be cacheable in the sense that the + information contained in the response MAY be used to update a + previously cached entity from that resource. If the new field values + indicate that the cached entity differs from the current entity (as + would be indicated by a change in Content-Length, Content-MD5, ETag + or Last-Modified), then the cache MUST treat the cache entry as + stale. + +9.5 POST + + The POST method is used to request that the origin server accept the + entity enclosed in the request as a new subordinate of the resource + identified by the Request-URI in the Request-Line. POST is designed + to allow a uniform method to cover the following functions: + + - Annotation of existing resources; + + - Posting a message to a bulletin board, newsgroup, mailing list, + or similar group of articles; + + - Providing a block of data, such as the result of submitting a + form, to a data-handling process; + + - Extending a database through an append operation. + + The actual function performed by the POST method is determined by the + server and is usually dependent on the Request-URI. The posted entity + is subordinate to that URI in the same way that a file is subordinate + to a directory containing it, a news article is subordinate to a + newsgroup to which it is posted, or a record is subordinate to a + database. + + The action performed by the POST method might not result in a + resource that can be identified by a URI. In this case, either 200 + (OK) or 204 (No Content) is the appropriate response status, + depending on whether or not the response includes an entity that + describes the result. + + + +Fielding, et al. Standards Track [Page 54] + +RFC 2616 HTTP/1.1 June 1999 + + + If a resource has been created on the origin server, the response + SHOULD be 201 (Created) and contain an entity which describes the + status of the request and refers to the new resource, and a Location + header (see section 14.30). + + Responses to this method are not cacheable, unless the response + includes appropriate Cache-Control or Expires header fields. However, + the 303 (See Other) response can be used to direct the user agent to + retrieve a cacheable resource. + + POST requests MUST obey the message transmission requirements set out + in section 8.2. + + See section 15.1.3 for security considerations. + +9.6 PUT + + The PUT method requests that the enclosed entity be stored under the + supplied Request-URI. If the Request-URI refers to an already + existing resource, the enclosed entity SHOULD be considered as a + modified version of the one residing on the origin server. If the + Request-URI does not point to an existing resource, and that URI is + capable of being defined as a new resource by the requesting user + agent, the origin server can create the resource with that URI. If a + new resource is created, the origin server MUST inform the user agent + via the 201 (Created) response. If an existing resource is modified, + either the 200 (OK) or 204 (No Content) response codes SHOULD be sent + to indicate successful completion of the request. If the resource + could not be created or modified with the Request-URI, an appropriate + error response SHOULD be given that reflects the nature of the + problem. The recipient of the entity MUST NOT ignore any Content-* + (e.g. Content-Range) headers that it does not understand or implement + and MUST return a 501 (Not Implemented) response in such cases. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + + The fundamental difference between the POST and PUT requests is + reflected in the different meaning of the Request-URI. The URI in a + POST request identifies the resource that will handle the enclosed + entity. That resource might be a data-accepting process, a gateway to + some other protocol, or a separate entity that accepts annotations. + In contrast, the URI in a PUT request identifies the entity enclosed + with the request -- the user agent knows what URI is intended and the + server MUST NOT attempt to apply the request to some other resource. + If the server desires that the request be applied to a different URI, + + + + +Fielding, et al. Standards Track [Page 55] + +RFC 2616 HTTP/1.1 June 1999 + + + it MUST send a 301 (Moved Permanently) response; the user agent MAY + then make its own decision regarding whether or not to redirect the + request. + + A single resource MAY be identified by many different URIs. For + example, an article might have a URI for identifying "the current + version" which is separate from the URI identifying each particular + version. In this case, a PUT request on a general URI might result in + several other URIs being defined by the origin server. + + HTTP/1.1 does not define how a PUT method affects the state of an + origin server. + + PUT requests MUST obey the message transmission requirements set out + in section 8.2. + + Unless otherwise specified for a particular entity-header, the + entity-headers in the PUT request SHOULD be applied to the resource + created or modified by the PUT. + +9.7 DELETE + + The DELETE method requests that the origin server delete the resource + identified by the Request-URI. This method MAY be overridden by human + intervention (or other means) on the origin server. The client cannot + be guaranteed that the operation has been carried out, even if the + status code returned from the origin server indicates that the action + has been completed successfully. However, the server SHOULD NOT + indicate success unless, at the time the response is given, it + intends to delete the resource or move it to an inaccessible + location. + + A successful response SHOULD be 200 (OK) if the response includes an + entity describing the status, 202 (Accepted) if the action has not + yet been enacted, or 204 (No Content) if the action has been enacted + but the response does not include an entity. + + If the request passes through a cache and the Request-URI identifies + one or more currently cached entities, those entries SHOULD be + treated as stale. Responses to this method are not cacheable. + +9.8 TRACE + + The TRACE method is used to invoke a remote, application-layer loop- + back of the request message. The final recipient of the request + SHOULD reflect the message received back to the client as the + entity-body of a 200 (OK) response. The final recipient is either the + + + + +Fielding, et al. Standards Track [Page 56] + +RFC 2616 HTTP/1.1 June 1999 + + + origin server or the first proxy or gateway to receive a Max-Forwards + value of zero (0) in the request (see section 14.31). A TRACE request + MUST NOT include an entity. + + TRACE allows the client to see what is being received at the other + end of the request chain and use that data for testing or diagnostic + information. The value of the Via header field (section 14.45) is of + particular interest, since it acts as a trace of the request chain. + Use of the Max-Forwards header field allows the client to limit the + length of the request chain, which is useful for testing a chain of + proxies forwarding messages in an infinite loop. + + If the request is valid, the response SHOULD contain the entire + request message in the entity-body, with a Content-Type of + "message/http". Responses to this method MUST NOT be cached. + +9.9 CONNECT + + This specification reserves the method name CONNECT for use with a + proxy that can dynamically switch to being a tunnel (e.g. SSL + tunneling [44]). + +10 Status Code Definitions + + Each Status-Code is described below, including a description of which + method(s) it can follow and any metainformation required in the + response. + +10.1 Informational 1xx + + This class of status code indicates a provisional response, + consisting only of the Status-Line and optional headers, and is + terminated by an empty line. There are no required headers for this + class of status code. Since HTTP/1.0 did not define any 1xx status + codes, servers MUST NOT send a 1xx response to an HTTP/1.0 client + except under experimental conditions. + + A client MUST be prepared to accept one or more 1xx status responses + prior to a regular response, even if the client does not expect a 100 + (Continue) status message. Unexpected 1xx status responses MAY be + ignored by a user agent. + + Proxies MUST forward 1xx responses, unless the connection between the + proxy and its client has been closed, or unless the proxy itself + requested the generation of the 1xx response. (For example, if a + + + + + + +Fielding, et al. Standards Track [Page 57] + +RFC 2616 HTTP/1.1 June 1999 + + + proxy adds a "Expect: 100-continue" field when it forwards a request, + then it need not forward the corresponding 100 (Continue) + response(s).) + +10.1.1 100 Continue + + The client SHOULD continue with its request. This interim response is + used to inform the client that the initial part of the request has + been received and has not yet been rejected by the server. The client + SHOULD continue by sending the remainder of the request or, if the + request has already been completed, ignore this response. The server + MUST send a final response after the request has been completed. See + section 8.2.3 for detailed discussion of the use and handling of this + status code. + +10.1.2 101 Switching Protocols + + The server understands and is willing to comply with the client's + request, via the Upgrade message header field (section 14.42), for a + change in the application protocol being used on this connection. The + server will switch protocols to those defined by the response's + Upgrade header field immediately after the empty line which + terminates the 101 response. + + The protocol SHOULD be switched only when it is advantageous to do + so. For example, switching to a newer version of HTTP is advantageous + over older versions, and switching to a real-time, synchronous + protocol might be advantageous when delivering resources that use + such features. + +10.2 Successful 2xx + + This class of status code indicates that the client's request was + successfully received, understood, and accepted. + +10.2.1 200 OK + + The request has succeeded. The information returned with the response + is dependent on the method used in the request, for example: + + GET an entity corresponding to the requested resource is sent in + the response; + + HEAD the entity-header fields corresponding to the requested + resource are sent in the response without any message-body; + + POST an entity describing or containing the result of the action; + + + + +Fielding, et al. Standards Track [Page 58] + +RFC 2616 HTTP/1.1 June 1999 + + + TRACE an entity containing the request message as received by the + end server. + +10.2.2 201 Created + + The request has been fulfilled and resulted in a new resource being + created. The newly created resource can be referenced by the URI(s) + returned in the entity of the response, with the most specific URI + for the resource given by a Location header field. The response + SHOULD include an entity containing a list of resource + characteristics and location(s) from which the user or user agent can + choose the one most appropriate. The entity format is specified by + the media type given in the Content-Type header field. The origin + server MUST create the resource before returning the 201 status code. + If the action cannot be carried out immediately, the server SHOULD + respond with 202 (Accepted) response instead. + + A 201 response MAY contain an ETag response header field indicating + the current value of the entity tag for the requested variant just + created, see section 14.19. + +10.2.3 202 Accepted + + The request has been accepted for processing, but the processing has + not been completed. The request might or might not eventually be + acted upon, as it might be disallowed when processing actually takes + place. There is no facility for re-sending a status code from an + asynchronous operation such as this. + + The 202 response is intentionally non-committal. Its purpose is to + allow a server to accept a request for some other process (perhaps a + batch-oriented process that is only run once per day) without + requiring that the user agent's connection to the server persist + until the process is completed. The entity returned with this + response SHOULD include an indication of the request's current status + and either a pointer to a status monitor or some estimate of when the + user can expect the request to be fulfilled. + +10.2.4 203 Non-Authoritative Information + + The returned metainformation in the entity-header is not the + definitive set as available from the origin server, but is gathered + from a local or a third-party copy. The set presented MAY be a subset + or superset of the original version. For example, including local + annotation information about the resource might result in a superset + of the metainformation known by the origin server. Use of this + response code is not required and is only appropriate when the + response would otherwise be 200 (OK). + + + +Fielding, et al. Standards Track [Page 59] + +RFC 2616 HTTP/1.1 June 1999 + + +10.2.5 204 No Content + + The server has fulfilled the request but does not need to return an + entity-body, and might want to return updated metainformation. The + response MAY include new or updated metainformation in the form of + entity-headers, which if present SHOULD be associated with the + requested variant. + + If the client is a user agent, it SHOULD NOT change its document view + from that which caused the request to be sent. This response is + primarily intended to allow input for actions to take place without + causing a change to the user agent's active document view, although + any new or updated metainformation SHOULD be applied to the document + currently in the user agent's active view. + + The 204 response MUST NOT include a message-body, and thus is always + terminated by the first empty line after the header fields. + +10.2.6 205 Reset Content + + The server has fulfilled the request and the user agent SHOULD reset + the document view which caused the request to be sent. This response + is primarily intended to allow input for actions to take place via + user input, followed by a clearing of the form in which the input is + given so that the user can easily initiate another input action. The + response MUST NOT include an entity. + +10.2.7 206 Partial Content + + The server has fulfilled the partial GET request for the resource. + The request MUST have included a Range header field (section 14.35) + indicating the desired range, and MAY have included an If-Range + header field (section 14.27) to make the request conditional. + + The response MUST include the following header fields: + + - Either a Content-Range header field (section 14.16) indicating + the range included with this response, or a multipart/byteranges + Content-Type including Content-Range fields for each part. If a + Content-Length header field is present in the response, its + value MUST match the actual number of OCTETs transmitted in the + message-body. + + - Date + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + + + +Fielding, et al. Standards Track [Page 60] + +RFC 2616 HTTP/1.1 June 1999 + + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the 206 response is the result of an If-Range request that used a + strong cache validator (see section 13.3.3), the response SHOULD NOT + include other entity-headers. If the response is the result of an + If-Range request that used a weak validator, the response MUST NOT + include other entity-headers; this prevents inconsistencies between + cached entity-bodies and updated headers. Otherwise, the response + MUST include all of the entity-headers that would have been returned + with a 200 (OK) response to the same request. + + A cache MUST NOT combine a 206 response with other previously cached + content if the ETag or Last-Modified headers do not match exactly, + see 13.5.4. + + A cache that does not support the Range and Content-Range headers + MUST NOT cache 206 (Partial) responses. + +10.3 Redirection 3xx + + This class of status code indicates that further action needs to be + taken by the user agent in order to fulfill the request. The action + required MAY be carried out by the user agent without interaction + with the user if and only if the method used in the second request is + GET or HEAD. A client SHOULD detect infinite redirection loops, since + such loops generate network traffic for each redirection. + + Note: previous versions of this specification recommended a + maximum of five redirections. Content developers should be aware + that there might be clients that implement such a fixed + limitation. + +10.3.1 300 Multiple Choices + + The requested resource corresponds to any one of a set of + representations, each with its own specific location, and agent- + driven negotiation information (section 12) is being provided so that + the user (or user agent) can select a preferred representation and + redirect its request to that location. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of resource characteristics and location(s) from + which the user or user agent can choose the one most appropriate. The + entity format is specified by the media type given in the Content- + Type header field. Depending upon the format and the capabilities of + + + + +Fielding, et al. Standards Track [Page 61] + +RFC 2616 HTTP/1.1 June 1999 + + + the user agent, selection of the most appropriate choice MAY be + performed automatically. However, this specification does not define + any standard for such automatic selection. + + If the server has a preferred choice of representation, it SHOULD + include the specific URI for that representation in the Location + field; user agents MAY use the Location field value for automatic + redirection. This response is cacheable unless indicated otherwise. + +10.3.2 301 Moved Permanently + + The requested resource has been assigned a new permanent URI and any + future references to this resource SHOULD use one of the returned + URIs. Clients with link editing capabilities ought to automatically + re-link references to the Request-URI to one or more of the new + references returned by the server, where possible. This response is + cacheable unless indicated otherwise. + + The new permanent URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + If the 301 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: When automatically redirecting a POST request after + receiving a 301 status code, some existing HTTP/1.0 user agents + will erroneously change it into a GET request. + +10.3.3 302 Found + + The requested resource resides temporarily under a different URI. + Since the redirection might be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + + + + + + +Fielding, et al. Standards Track [Page 62] + +RFC 2616 HTTP/1.1 June 1999 + + + If the 302 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + + Note: RFC 1945 and RFC 2068 specify that the client is not allowed + to change the method on the redirected request. However, most + existing user agent implementations treat 302 as if it were a 303 + response, performing a GET on the Location field-value regardless + of the original request method. The status codes 303 and 307 have + been added for servers that wish to make unambiguously clear which + kind of reaction is expected of the client. + +10.3.4 303 See Other + + The response to the request can be found under a different URI and + SHOULD be retrieved using a GET method on that resource. This method + exists primarily to allow the output of a POST-activated script to + redirect the user agent to a selected resource. The new URI is not a + substitute reference for the originally requested resource. The 303 + response MUST NOT be cached, but the response to the second + (redirected) request might be cacheable. + + The different URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s). + + Note: Many pre-HTTP/1.1 user agents do not understand the 303 + status. When interoperability with such clients is a concern, the + 302 status code may be used instead, since most user agents react + to a 302 response as described here for 303. + +10.3.5 304 Not Modified + + If the client has performed a conditional GET request and access is + allowed, but the document has not been modified, the server SHOULD + respond with this status code. The 304 response MUST NOT contain a + message-body, and thus is always terminated by the first empty line + after the header fields. + + The response MUST include the following header fields: + + - Date, unless its omission is required by section 14.18.1 + + + + + + + +Fielding, et al. Standards Track [Page 63] + +RFC 2616 HTTP/1.1 June 1999 + + + If a clockless origin server obeys these rules, and proxies and + clients add their own Date to any response received without one (as + already specified by [RFC 2068], section 14.19), caches will operate + correctly. + + - ETag and/or Content-Location, if the header would have been sent + in a 200 response to the same request + + - Expires, Cache-Control, and/or Vary, if the field-value might + differ from that sent in any previous response for the same + variant + + If the conditional GET used a strong cache validator (see section + 13.3.3), the response SHOULD NOT include other entity-headers. + Otherwise (i.e., the conditional GET used a weak validator), the + response MUST NOT include other entity-headers; this prevents + inconsistencies between cached entity-bodies and updated headers. + + If a 304 response indicates an entity not currently cached, then the + cache MUST disregard the response and repeat the request without the + conditional. + + If a cache uses a received 304 response to update a cache entry, the + cache MUST update the entry to reflect any new field values given in + the response. + +10.3.6 305 Use Proxy + + The requested resource MUST be accessed through the proxy given by + the Location field. The Location field gives the URI of the proxy. + The recipient is expected to repeat this single request via the + proxy. 305 responses MUST only be generated by origin servers. + + Note: RFC 2068 was not clear that 305 was intended to redirect a + single request, and to be generated by origin servers only. Not + observing these limitations has significant security consequences. + +10.3.7 306 (Unused) + + The 306 status code was used in a previous version of the + specification, is no longer used, and the code is reserved. + + + + + + + + + + +Fielding, et al. Standards Track [Page 64] + +RFC 2616 HTTP/1.1 June 1999 + + +10.3.8 307 Temporary Redirect + + The requested resource resides temporarily under a different URI. + Since the redirection MAY be altered on occasion, the client SHOULD + continue to use the Request-URI for future requests. This response + is only cacheable if indicated by a Cache-Control or Expires header + field. + + The temporary URI SHOULD be given by the Location field in the + response. Unless the request method was HEAD, the entity of the + response SHOULD contain a short hypertext note with a hyperlink to + the new URI(s) , since many pre-HTTP/1.1 user agents do not + understand the 307 status. Therefore, the note SHOULD contain the + information necessary for a user to repeat the original request on + the new URI. + + If the 307 status code is received in response to a request other + than GET or HEAD, the user agent MUST NOT automatically redirect the + request unless it can be confirmed by the user, since this might + change the conditions under which the request was issued. + +10.4 Client Error 4xx + + The 4xx class of status code is intended for cases in which the + client seems to have erred. Except when responding to a HEAD request, + the server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. These status codes are applicable to any request method. + User agents SHOULD display any included entity to the user. + + If the client is sending data, a server implementation using TCP + SHOULD be careful to ensure that the client acknowledges receipt of + the packet(s) containing the response, before the server closes the + input connection. If the client continues sending data to the server + after the close, the server's TCP stack will send a reset packet to + the client, which may erase the client's unacknowledged input buffers + before they can be read and interpreted by the HTTP application. + +10.4.1 400 Bad Request + + The request could not be understood by the server due to malformed + syntax. The client SHOULD NOT repeat the request without + modifications. + + + + + + + + +Fielding, et al. Standards Track [Page 65] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.2 401 Unauthorized + + The request requires user authentication. The response MUST include a + WWW-Authenticate header field (section 14.47) containing a challenge + applicable to the requested resource. The client MAY repeat the + request with a suitable Authorization header field (section 14.8). If + the request already included Authorization credentials, then the 401 + response indicates that authorization has been refused for those + credentials. If the 401 response contains the same challenge as the + prior response, and the user agent has already attempted + authentication at least once, then the user SHOULD be presented the + entity that was given in the response, since that entity might + include relevant diagnostic information. HTTP access authentication + is explained in "HTTP Authentication: Basic and Digest Access + Authentication" [43]. + +10.4.3 402 Payment Required + + This code is reserved for future use. + +10.4.4 403 Forbidden + + The server understood the request, but is refusing to fulfill it. + Authorization will not help and the request SHOULD NOT be repeated. + If the request method was not HEAD and the server wishes to make + public why the request has not been fulfilled, it SHOULD describe the + reason for the refusal in the entity. If the server does not wish to + make this information available to the client, the status code 404 + (Not Found) can be used instead. + +10.4.5 404 Not Found + + The server has not found anything matching the Request-URI. No + indication is given of whether the condition is temporary or + permanent. The 410 (Gone) status code SHOULD be used if the server + knows, through some internally configurable mechanism, that an old + resource is permanently unavailable and has no forwarding address. + This status code is commonly used when the server does not wish to + reveal exactly why the request has been refused, or when no other + response is applicable. + +10.4.6 405 Method Not Allowed + + The method specified in the Request-Line is not allowed for the + resource identified by the Request-URI. The response MUST include an + Allow header containing a list of valid methods for the requested + resource. + + + + +Fielding, et al. Standards Track [Page 66] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.7 406 Not Acceptable + + The resource identified by the request is only capable of generating + response entities which have content characteristics not acceptable + according to the accept headers sent in the request. + + Unless it was a HEAD request, the response SHOULD include an entity + containing a list of available entity characteristics and location(s) + from which the user or user agent can choose the one most + appropriate. The entity format is specified by the media type given + in the Content-Type header field. Depending upon the format and the + capabilities of the user agent, selection of the most appropriate + choice MAY be performed automatically. However, this specification + does not define any standard for such automatic selection. + + Note: HTTP/1.1 servers are allowed to return responses which are + not acceptable according to the accept headers sent in the + request. In some cases, this may even be preferable to sending a + 406 response. User agents are encouraged to inspect the headers of + an incoming response to determine if it is acceptable. + + If the response could be unacceptable, a user agent SHOULD + temporarily stop receipt of more data and query the user for a + decision on further actions. + +10.4.8 407 Proxy Authentication Required + + This code is similar to 401 (Unauthorized), but indicates that the + client must first authenticate itself with the proxy. The proxy MUST + return a Proxy-Authenticate header field (section 14.33) containing a + challenge applicable to the proxy for the requested resource. The + client MAY repeat the request with a suitable Proxy-Authorization + header field (section 14.34). HTTP access authentication is explained + in "HTTP Authentication: Basic and Digest Access Authentication" + [43]. + +10.4.9 408 Request Timeout + + The client did not produce a request within the time that the server + was prepared to wait. The client MAY repeat the request without + modifications at any later time. + +10.4.10 409 Conflict + + The request could not be completed due to a conflict with the current + state of the resource. This code is only allowed in situations where + it is expected that the user might be able to resolve the conflict + and resubmit the request. The response body SHOULD include enough + + + +Fielding, et al. Standards Track [Page 67] + +RFC 2616 HTTP/1.1 June 1999 + + + information for the user to recognize the source of the conflict. + Ideally, the response entity would include enough information for the + user or user agent to fix the problem; however, that might not be + possible and is not required. + + Conflicts are most likely to occur in response to a PUT request. For + example, if versioning were being used and the entity being PUT + included changes to a resource which conflict with those made by an + earlier (third-party) request, the server might use the 409 response + to indicate that it can't complete the request. In this case, the + response entity would likely contain a list of the differences + between the two versions in a format defined by the response + Content-Type. + +10.4.11 410 Gone + + The requested resource is no longer available at the server and no + forwarding address is known. This condition is expected to be + considered permanent. Clients with link editing capabilities SHOULD + delete references to the Request-URI after user approval. If the + server does not know, or has no facility to determine, whether or not + the condition is permanent, the status code 404 (Not Found) SHOULD be + used instead. This response is cacheable unless indicated otherwise. + + The 410 response is primarily intended to assist the task of web + maintenance by notifying the recipient that the resource is + intentionally unavailable and that the server owners desire that + remote links to that resource be removed. Such an event is common for + limited-time, promotional services and for resources belonging to + individuals no longer working at the server's site. It is not + necessary to mark all permanently unavailable resources as "gone" or + to keep the mark for any length of time -- that is left to the + discretion of the server owner. + +10.4.12 411 Length Required + + The server refuses to accept the request without a defined Content- + Length. The client MAY repeat the request if it adds a valid + Content-Length header field containing the length of the message-body + in the request message. + +10.4.13 412 Precondition Failed + + The precondition given in one or more of the request-header fields + evaluated to false when it was tested on the server. This response + code allows the client to place preconditions on the current resource + metainformation (header field data) and thus prevent the requested + method from being applied to a resource other than the one intended. + + + +Fielding, et al. Standards Track [Page 68] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.14 413 Request Entity Too Large + + The server is refusing to process a request because the request + entity is larger than the server is willing or able to process. The + server MAY close the connection to prevent the client from continuing + the request. + + If the condition is temporary, the server SHOULD include a Retry- + After header field to indicate that it is temporary and after what + time the client MAY try again. + +10.4.15 414 Request-URI Too Long + + The server is refusing to service the request because the Request-URI + is longer than the server is willing to interpret. This rare + condition is only likely to occur when a client has improperly + converted a POST request to a GET request with long query + information, when the client has descended into a URI "black hole" of + redirection (e.g., a redirected URI prefix that points to a suffix of + itself), or when the server is under attack by a client attempting to + exploit security holes present in some servers using fixed-length + buffers for reading or manipulating the Request-URI. + +10.4.16 415 Unsupported Media Type + + The server is refusing to service the request because the entity of + the request is in a format not supported by the requested resource + for the requested method. + +10.4.17 416 Requested Range Not Satisfiable + + A server SHOULD return a response with this status code if a request + included a Range request-header field (section 14.35), and none of + the range-specifier values in this field overlap the current extent + of the selected resource, and the request did not include an If-Range + request-header field. (For byte-ranges, this means that the first- + byte-pos of all of the byte-range-spec values were greater than the + current length of the selected resource.) + + When this status code is returned for a byte-range request, the + response SHOULD include a Content-Range entity-header field + specifying the current length of the selected resource (see section + 14.16). This response MUST NOT use the multipart/byteranges content- + type. + + + + + + + +Fielding, et al. Standards Track [Page 69] + +RFC 2616 HTTP/1.1 June 1999 + + +10.4.18 417 Expectation Failed + + The expectation given in an Expect request-header field (see section + 14.20) could not be met by this server, or, if the server is a proxy, + the server has unambiguous evidence that the request could not be met + by the next-hop server. + +10.5 Server Error 5xx + + Response status codes beginning with the digit "5" indicate cases in + which the server is aware that it has erred or is incapable of + performing the request. Except when responding to a HEAD request, the + server SHOULD include an entity containing an explanation of the + error situation, and whether it is a temporary or permanent + condition. User agents SHOULD display any included entity to the + user. These response codes are applicable to any request method. + +10.5.1 500 Internal Server Error + + The server encountered an unexpected condition which prevented it + from fulfilling the request. + +10.5.2 501 Not Implemented + + The server does not support the functionality required to fulfill the + request. This is the appropriate response when the server does not + recognize the request method and is not capable of supporting it for + any resource. + +10.5.3 502 Bad Gateway + + The server, while acting as a gateway or proxy, received an invalid + response from the upstream server it accessed in attempting to + fulfill the request. + +10.5.4 503 Service Unavailable + + The server is currently unable to handle the request due to a + temporary overloading or maintenance of the server. The implication + is that this is a temporary condition which will be alleviated after + some delay. If known, the length of the delay MAY be indicated in a + Retry-After header. If no Retry-After is given, the client SHOULD + handle the response as it would for a 500 response. + + Note: The existence of the 503 status code does not imply that a + server must use it when becoming overloaded. Some servers may wish + to simply refuse the connection. + + + + +Fielding, et al. Standards Track [Page 70] + +RFC 2616 HTTP/1.1 June 1999 + + +10.5.5 504 Gateway Timeout + + The server, while acting as a gateway or proxy, did not receive a + timely response from the upstream server specified by the URI (e.g. + HTTP, FTP, LDAP) or some other auxiliary server (e.g. DNS) it needed + to access in attempting to complete the request. + + Note: Note to implementors: some deployed proxies are known to + return 400 or 500 when DNS lookups time out. + +10.5.6 505 HTTP Version Not Supported + + The server does not support, or refuses to support, the HTTP protocol + version that was used in the request message. The server is + indicating that it is unable or unwilling to complete the request + using the same major version as the client, as described in section + 3.1, other than with this error message. The response SHOULD contain + an entity describing why that version is not supported and what other + protocols are supported by that server. + +11 Access Authentication + + HTTP provides several OPTIONAL challenge-response authentication + mechanisms which can be used by a server to challenge a client + request and by a client to provide authentication information. The + general framework for access authentication, and the specification of + "basic" and "digest" authentication, are specified in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. This + specification adopts the definitions of "challenge" and "credentials" + from that specification. + +12 Content Negotiation + + Most HTTP responses include an entity which contains information for + interpretation by a human user. Naturally, it is desirable to supply + the user with the "best available" entity corresponding to the + request. Unfortunately for servers and caches, not all users have the + same preferences for what is "best," and not all user agents are + equally capable of rendering all entity types. For that reason, HTTP + has provisions for several mechanisms for "content negotiation" -- + the process of selecting the best representation for a given response + when there are multiple representations available. + + Note: This is not called "format negotiation" because the + alternate representations may be of the same media type, but use + different capabilities of that type, be in different languages, + etc. + + + + +Fielding, et al. Standards Track [Page 71] + +RFC 2616 HTTP/1.1 June 1999 + + + Any response containing an entity-body MAY be subject to negotiation, + including error responses. + + There are two kinds of content negotiation which are possible in + HTTP: server-driven and agent-driven negotiation. These two kinds of + negotiation are orthogonal and thus may be used separately or in + combination. One method of combination, referred to as transparent + negotiation, occurs when a cache uses the agent-driven negotiation + information provided by the origin server in order to provide + server-driven negotiation for subsequent requests. + +12.1 Server-driven Negotiation + + If the selection of the best representation for a response is made by + an algorithm located at the server, it is called server-driven + negotiation. Selection is based on the available representations of + the response (the dimensions over which it can vary; e.g. language, + content-coding, etc.) and the contents of particular header fields in + the request message or on other information pertaining to the request + (such as the network address of the client). + + Server-driven negotiation is advantageous when the algorithm for + selecting from among the available representations is difficult to + describe to the user agent, or when the server desires to send its + "best guess" to the client along with the first response (hoping to + avoid the round-trip delay of a subsequent request if the "best + guess" is good enough for the user). In order to improve the server's + guess, the user agent MAY include request header fields (Accept, + Accept-Language, Accept-Encoding, etc.) which describe its + preferences for such a response. + + Server-driven negotiation has disadvantages: + + 1. It is impossible for the server to accurately determine what + might be "best" for any given user, since that would require + complete knowledge of both the capabilities of the user agent + and the intended use for the response (e.g., does the user want + to view it on screen or print it on paper?). + + 2. Having the user agent describe its capabilities in every + request can be both very inefficient (given that only a small + percentage of responses have multiple representations) and a + potential violation of the user's privacy. + + 3. It complicates the implementation of an origin server and the + algorithms for generating responses to a request. + + + + + +Fielding, et al. Standards Track [Page 72] + +RFC 2616 HTTP/1.1 June 1999 + + + 4. It may limit a public cache's ability to use the same response + for multiple user's requests. + + HTTP/1.1 includes the following request-header fields for enabling + server-driven negotiation through description of user agent + capabilities and user preferences: Accept (section 14.1), Accept- + Charset (section 14.2), Accept-Encoding (section 14.3), Accept- + Language (section 14.4), and User-Agent (section 14.43). However, an + origin server is not limited to these dimensions and MAY vary the + response based on any aspect of the request, including information + outside the request-header fields or within extension header fields + not defined by this specification. + + The Vary header field can be used to express the parameters the + server uses to select a representation that is subject to server- + driven negotiation. See section 13.6 for use of the Vary header field + by caches and section 14.44 for use of the Vary header field by + servers. + +12.2 Agent-driven Negotiation + + With agent-driven negotiation, selection of the best representation + for a response is performed by the user agent after receiving an + initial response from the origin server. Selection is based on a list + of the available representations of the response included within the + header fields or entity-body of the initial response, with each + representation identified by its own URI. Selection from among the + representations may be performed automatically (if the user agent is + capable of doing so) or manually by the user selecting from a + generated (possibly hypertext) menu. + + Agent-driven negotiation is advantageous when the response would vary + over commonly-used dimensions (such as type, language, or encoding), + when the origin server is unable to determine a user agent's + capabilities from examining the request, and generally when public + caches are used to distribute server load and reduce network usage. + + Agent-driven negotiation suffers from the disadvantage of needing a + second request to obtain the best alternate representation. This + second request is only efficient when caching is used. In addition, + this specification does not define any mechanism for supporting + automatic selection, though it also does not prevent any such + mechanism from being developed as an extension and used within + HTTP/1.1. + + + + + + + +Fielding, et al. Standards Track [Page 73] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 defines the 300 (Multiple Choices) and 406 (Not Acceptable) + status codes for enabling agent-driven negotiation when the server is + unwilling or unable to provide a varying response using server-driven + negotiation. + +12.3 Transparent Negotiation + + Transparent negotiation is a combination of both server-driven and + agent-driven negotiation. When a cache is supplied with a form of the + list of available representations of the response (as in agent-driven + negotiation) and the dimensions of variance are completely understood + by the cache, then the cache becomes capable of performing server- + driven negotiation on behalf of the origin server for subsequent + requests on that resource. + + Transparent negotiation has the advantage of distributing the + negotiation work that would otherwise be required of the origin + server and also removing the second request delay of agent-driven + negotiation when the cache is able to correctly guess the right + response. + + This specification does not define any mechanism for transparent + negotiation, though it also does not prevent any such mechanism from + being developed as an extension that could be used within HTTP/1.1. + +13 Caching in HTTP + + HTTP is typically used for distributed information systems, where + performance can be improved by the use of response caches. The + HTTP/1.1 protocol includes a number of elements intended to make + caching work as well as possible. Because these elements are + inextricable from other aspects of the protocol, and because they + interact with each other, it is useful to describe the basic caching + design of HTTP separately from the detailed descriptions of methods, + headers, response codes, etc. + + Caching would be useless if it did not significantly improve + performance. The goal of caching in HTTP/1.1 is to eliminate the need + to send requests in many cases, and to eliminate the need to send + full responses in many other cases. The former reduces the number of + network round-trips required for many operations; we use an + "expiration" mechanism for this purpose (see section 13.2). The + latter reduces network bandwidth requirements; we use a "validation" + mechanism for this purpose (see section 13.3). + + Requirements for performance, availability, and disconnected + operation require us to be able to relax the goal of semantic + transparency. The HTTP/1.1 protocol allows origin servers, caches, + + + +Fielding, et al. Standards Track [Page 74] + +RFC 2616 HTTP/1.1 June 1999 + + + and clients to explicitly reduce transparency when necessary. + However, because non-transparent operation may confuse non-expert + users, and might be incompatible with certain server applications + (such as those for ordering merchandise), the protocol requires that + transparency be relaxed + + - only by an explicit protocol-level request when relaxed by + client or origin server + + - only with an explicit warning to the end user when relaxed by + cache or client + + Therefore, the HTTP/1.1 protocol provides these important elements: + + 1. Protocol features that provide full semantic transparency when + this is required by all parties. + + 2. Protocol features that allow an origin server or user agent to + explicitly request and control non-transparent operation. + + 3. Protocol features that allow a cache to attach warnings to + responses that do not preserve the requested approximation of + semantic transparency. + + A basic principle is that it must be possible for the clients to + detect any potential relaxation of semantic transparency. + + Note: The server, cache, or client implementor might be faced with + design decisions not explicitly discussed in this specification. + If a decision might affect semantic transparency, the implementor + ought to err on the side of maintaining transparency unless a + careful and complete analysis shows significant benefits in + breaking transparency. + +13.1.1 Cache Correctness + + A correct cache MUST respond to a request with the most up-to-date + response held by the cache that is appropriate to the request (see + sections 13.2.5, 13.2.6, and 13.12) which meets one of the following + conditions: + + 1. It has been checked for equivalence with what the origin server + would have returned by revalidating the response with the + origin server (section 13.3); + + + + + + + +Fielding, et al. Standards Track [Page 75] + +RFC 2616 HTTP/1.1 June 1999 + + + 2. It is "fresh enough" (see section 13.2). In the default case, + this means it meets the least restrictive freshness requirement + of the client, origin server, and cache (see section 14.9); if + the origin server so specifies, it is the freshness requirement + of the origin server alone. + + If a stored response is not "fresh enough" by the most + restrictive freshness requirement of both the client and the + origin server, in carefully considered circumstances the cache + MAY still return the response with the appropriate Warning + header (see section 13.1.5 and 14.46), unless such a response + is prohibited (e.g., by a "no-store" cache-directive, or by a + "no-cache" cache-request-directive; see section 14.9). + + 3. It is an appropriate 304 (Not Modified), 305 (Proxy Redirect), + or error (4xx or 5xx) response message. + + If the cache can not communicate with the origin server, then a + correct cache SHOULD respond as above if the response can be + correctly served from the cache; if not it MUST return an error or + warning indicating that there was a communication failure. + + If a cache receives a response (either an entire response, or a 304 + (Not Modified) response) that it would normally forward to the + requesting client, and the received response is no longer fresh, the + cache SHOULD forward it to the requesting client without adding a new + Warning (but without removing any existing Warning headers). A cache + SHOULD NOT attempt to revalidate a response simply because that + response became stale in transit; this might lead to an infinite + loop. A user agent that receives a stale response without a Warning + MAY display a warning indication to the user. + +13.1.2 Warnings + + Whenever a cache returns a response that is neither first-hand nor + "fresh enough" (in the sense of condition 2 in section 13.1.1), it + MUST attach a warning to that effect, using a Warning general-header. + The Warning header and the currently defined warnings are described + in section 14.46. The warning allows clients to take appropriate + action. + + Warnings MAY be used for other purposes, both cache-related and + otherwise. The use of a warning, rather than an error status code, + distinguish these responses from true failures. + + Warnings are assigned three digit warn-codes. The first digit + indicates whether the Warning MUST or MUST NOT be deleted from a + stored cache entry after a successful revalidation: + + + +Fielding, et al. Standards Track [Page 76] + +RFC 2616 HTTP/1.1 June 1999 + + + 1xx Warnings that describe the freshness or revalidation status of + the response, and so MUST be deleted after a successful + revalidation. 1XX warn-codes MAY be generated by a cache only when + validating a cached entry. It MUST NOT be generated by clients. + + 2xx Warnings that describe some aspect of the entity body or entity + headers that is not rectified by a revalidation (for example, a + lossy compression of the entity bodies) and which MUST NOT be + deleted after a successful revalidation. + + See section 14.46 for the definitions of the codes themselves. + + HTTP/1.0 caches will cache all Warnings in responses, without + deleting the ones in the first category. Warnings in responses that + are passed to HTTP/1.0 caches carry an extra warning-date field, + which prevents a future HTTP/1.1 recipient from believing an + erroneously cached Warning. + + Warnings also carry a warning text. The text MAY be in any + appropriate natural language (perhaps based on the client's Accept + headers), and include an OPTIONAL indication of what character set is + used. + + Multiple warnings MAY be attached to a response (either by the origin + server or by a cache), including multiple warnings with the same code + number. For example, a server might provide the same warning with + texts in both English and Basque. + + When multiple warnings are attached to a response, it might not be + practical or reasonable to display all of them to the user. This + version of HTTP does not specify strict priority rules for deciding + which warnings to display and in what order, but does suggest some + heuristics. + +13.1.3 Cache-control Mechanisms + + The basic cache mechanisms in HTTP/1.1 (server-specified expiration + times and validators) are implicit directives to caches. In some + cases, a server or client might need to provide explicit directives + to the HTTP caches. We use the Cache-Control header for this purpose. + + The Cache-Control header allows a client or server to transmit a + variety of directives in either requests or responses. These + directives typically override the default caching algorithms. As a + general rule, if there is any apparent conflict between header + values, the most restrictive interpretation is applied (that is, the + one that is most likely to preserve semantic transparency). However, + + + + +Fielding, et al. Standards Track [Page 77] + +RFC 2616 HTTP/1.1 June 1999 + + + in some cases, cache-control directives are explicitly specified as + weakening the approximation of semantic transparency (for example, + "max-stale" or "public"). + + The cache-control directives are described in detail in section 14.9. + +13.1.4 Explicit User Agent Warnings + + Many user agents make it possible for users to override the basic + caching mechanisms. For example, the user agent might allow the user + to specify that cached entities (even explicitly stale ones) are + never validated. Or the user agent might habitually add "Cache- + Control: max-stale=3600" to every request. The user agent SHOULD NOT + default to either non-transparent behavior, or behavior that results + in abnormally ineffective caching, but MAY be explicitly configured + to do so by an explicit action of the user. + + If the user has overridden the basic caching mechanisms, the user + agent SHOULD explicitly indicate to the user whenever this results in + the display of information that might not meet the server's + transparency requirements (in particular, if the displayed entity is + known to be stale). Since the protocol normally allows the user agent + to determine if responses are stale or not, this indication need only + be displayed when this actually happens. The indication need not be a + dialog box; it could be an icon (for example, a picture of a rotting + fish) or some other indicator. + + If the user has overridden the caching mechanisms in a way that would + abnormally reduce the effectiveness of caches, the user agent SHOULD + continually indicate this state to the user (for example, by a + display of a picture of currency in flames) so that the user does not + inadvertently consume excess resources or suffer from excessive + latency. + +13.1.5 Exceptions to the Rules and Warnings + + In some cases, the operator of a cache MAY choose to configure it to + return stale responses even when not requested by clients. This + decision ought not be made lightly, but may be necessary for reasons + of availability or performance, especially when the cache is poorly + connected to the origin server. Whenever a cache returns a stale + response, it MUST mark it as such (using a Warning header) enabling + the client software to alert the user that there might be a potential + problem. + + + + + + + +Fielding, et al. Standards Track [Page 78] + +RFC 2616 HTTP/1.1 June 1999 + + + It also allows the user agent to take steps to obtain a first-hand or + fresh response. For this reason, a cache SHOULD NOT return a stale + response if the client explicitly requests a first-hand or fresh one, + unless it is impossible to comply for technical or policy reasons. + +13.1.6 Client-controlled Behavior + + While the origin server (and to a lesser extent, intermediate caches, + by their contribution to the age of a response) are the primary + source of expiration information, in some cases the client might need + to control a cache's decision about whether to return a cached + response without validating it. Clients do this using several + directives of the Cache-Control header. + + A client's request MAY specify the maximum age it is willing to + accept of an unvalidated response; specifying a value of zero forces + the cache(s) to revalidate all responses. A client MAY also specify + the minimum time remaining before a response expires. Both of these + options increase constraints on the behavior of caches, and so cannot + further relax the cache's approximation of semantic transparency. + + A client MAY also specify that it will accept stale responses, up to + some maximum amount of staleness. This loosens the constraints on the + caches, and so might violate the origin server's specified + constraints on semantic transparency, but might be necessary to + support disconnected operation, or high availability in the face of + poor connectivity. + +13.2 Expiration Model + +13.2.1 Server-Specified Expiration + + HTTP caching works best when caches can entirely avoid making + requests to the origin server. The primary mechanism for avoiding + requests is for an origin server to provide an explicit expiration + time in the future, indicating that a response MAY be used to satisfy + subsequent requests. In other words, a cache can return a fresh + response without first contacting the server. + + Our expectation is that servers will assign future explicit + expiration times to responses in the belief that the entity is not + likely to change, in a semantically significant way, before the + expiration time is reached. This normally preserves semantic + transparency, as long as the server's expiration times are carefully + chosen. + + + + + + +Fielding, et al. Standards Track [Page 79] + +RFC 2616 HTTP/1.1 June 1999 + + + The expiration mechanism applies only to responses taken from a cache + and not to first-hand responses forwarded immediately to the + requesting client. + + If an origin server wishes to force a semantically transparent cache + to validate every request, it MAY assign an explicit expiration time + in the past. This means that the response is always stale, and so the + cache SHOULD validate it before using it for subsequent requests. See + section 14.9.4 for a more restrictive way to force revalidation. + + If an origin server wishes to force any HTTP/1.1 cache, no matter how + it is configured, to validate every request, it SHOULD use the "must- + revalidate" cache-control directive (see section 14.9). + + Servers specify explicit expiration times using either the Expires + header, or the max-age directive of the Cache-Control header. + + An expiration time cannot be used to force a user agent to refresh + its display or reload a resource; its semantics apply only to caching + mechanisms, and such mechanisms need only check a resource's + expiration status when a new request for that resource is initiated. + See section 13.13 for an explanation of the difference between caches + and history mechanisms. + +13.2.2 Heuristic Expiration + + Since origin servers do not always provide explicit expiration times, + HTTP caches typically assign heuristic expiration times, employing + algorithms that use other header values (such as the Last-Modified + time) to estimate a plausible expiration time. The HTTP/1.1 + specification does not provide specific algorithms, but does impose + worst-case constraints on their results. Since heuristic expiration + times might compromise semantic transparency, they ought to used + cautiously, and we encourage origin servers to provide explicit + expiration times as much as possible. + +13.2.3 Age Calculations + + In order to know if a cached entry is fresh, a cache needs to know if + its age exceeds its freshness lifetime. We discuss how to calculate + the latter in section 13.2.4; this section describes how to calculate + the age of a response or cache entry. + + In this discussion, we use the term "now" to mean "the current value + of the clock at the host performing the calculation." Hosts that use + HTTP, but especially hosts running origin servers and caches, SHOULD + use NTP [28] or some similar protocol to synchronize their clocks to + a globally accurate time standard. + + + +Fielding, et al. Standards Track [Page 80] + +RFC 2616 HTTP/1.1 June 1999 + + + HTTP/1.1 requires origin servers to send a Date header, if possible, + with every response, giving the time at which the response was + generated (see section 14.18). We use the term "date_value" to denote + the value of the Date header, in a form appropriate for arithmetic + operations. + + HTTP/1.1 uses the Age response-header to convey the estimated age of + the response message when obtained from a cache. The Age field value + is the cache's estimate of the amount of time since the response was + generated or revalidated by the origin server. + + In essence, the Age value is the sum of the time that the response + has been resident in each of the caches along the path from the + origin server, plus the amount of time it has been in transit along + network paths. + + We use the term "age_value" to denote the value of the Age header, in + a form appropriate for arithmetic operations. + + A response's age can be calculated in two entirely independent ways: + + 1. now minus date_value, if the local clock is reasonably well + synchronized to the origin server's clock. If the result is + negative, the result is replaced by zero. + + 2. age_value, if all of the caches along the response path + implement HTTP/1.1. + + Given that we have two independent ways to compute the age of a + response when it is received, we can combine these as + + corrected_received_age = max(now - date_value, age_value) + + and as long as we have either nearly synchronized clocks or all- + HTTP/1.1 paths, one gets a reliable (conservative) result. + + Because of network-imposed delays, some significant interval might + pass between the time that a server generates a response and the time + it is received at the next outbound cache or client. If uncorrected, + this delay could result in improperly low ages. + + Because the request that resulted in the returned Age value must have + been initiated prior to that Age value's generation, we can correct + for delays imposed by the network by recording the time at which the + request was initiated. Then, when an Age value is received, it MUST + be interpreted relative to the time the request was initiated, not + + + + + +Fielding, et al. Standards Track [Page 81] + +RFC 2616 HTTP/1.1 June 1999 + + + the time that the response was received. This algorithm results in + conservative behavior no matter how much delay is experienced. So, we + compute: + + corrected_initial_age = corrected_received_age + + (now - request_time) + + where "request_time" is the time (according to the local clock) when + the request that elicited this response was sent. + + Summary of age calculation algorithm, when a cache receives a + response: + + /* + * age_value + * is the value of Age: header received by the cache with + * this response. + * date_value + * is the value of the origin server's Date: header + * request_time + * is the (local) time when the cache made the request + * that resulted in this cached response + * response_time + * is the (local) time when the cache received the + * response + * now + * is the current (local) time + */ + + apparent_age = max(0, response_time - date_value); + corrected_received_age = max(apparent_age, age_value); + response_delay = response_time - request_time; + corrected_initial_age = corrected_received_age + response_delay; + resident_time = now - response_time; + current_age = corrected_initial_age + resident_time; + + The current_age of a cache entry is calculated by adding the amount + of time (in seconds) since the cache entry was last validated by the + origin server to the corrected_initial_age. When a response is + generated from a cache entry, the cache MUST include a single Age + header field in the response with a value equal to the cache entry's + current_age. + + The presence of an Age header field in a response implies that a + response is not first-hand. However, the converse is not true, since + the lack of an Age header field in a response does not imply that the + + + + + +Fielding, et al. Standards Track [Page 82] + +RFC 2616 HTTP/1.1 June 1999 + + + response is first-hand unless all caches along the request path are + compliant with HTTP/1.1 (i.e., older HTTP caches did not implement + the Age header field). + +13.2.4 Expiration Calculations + + In order to decide whether a response is fresh or stale, we need to + compare its freshness lifetime to its age. The age is calculated as + described in section 13.2.3; this section describes how to calculate + the freshness lifetime, and to determine if a response has expired. + In the discussion below, the values can be represented in any form + appropriate for arithmetic operations. + + We use the term "expires_value" to denote the value of the Expires + header. We use the term "max_age_value" to denote an appropriate + value of the number of seconds carried by the "max-age" directive of + the Cache-Control header in a response (see section 14.9.3). + + The max-age directive takes priority over Expires, so if max-age is + present in a response, the calculation is simply: + + freshness_lifetime = max_age_value + + Otherwise, if Expires is present in the response, the calculation is: + + freshness_lifetime = expires_value - date_value + + Note that neither of these calculations is vulnerable to clock skew, + since all of the information comes from the origin server. + + If none of Expires, Cache-Control: max-age, or Cache-Control: s- + maxage (see section 14.9.3) appears in the response, and the response + does not include other restrictions on caching, the cache MAY compute + a freshness lifetime using a heuristic. The cache MUST attach Warning + 113 to any response whose age is more than 24 hours if such warning + has not already been added. + + Also, if the response does have a Last-Modified time, the heuristic + expiration value SHOULD be no more than some fraction of the interval + since that time. A typical setting of this fraction might be 10%. + + The calculation to determine if a response has expired is quite + simple: + + response_is_fresh = (freshness_lifetime > current_age) + + + + + + +Fielding, et al. Standards Track [Page 83] + +RFC 2616 HTTP/1.1 June 1999 + + +13.2.5 Disambiguating Expiration Values + + Because expiration values are assigned optimistically, it is possible + for two caches to contain fresh values for the same resource that are + different. + + If a client performing a retrieval receives a non-first-hand response + for a request that was already fresh in its own cache, and the Date + header in its existing cache entry is newer than the Date on the new + response, then the client MAY ignore the response. If so, it MAY + retry the request with a "Cache-Control: max-age=0" directive (see + section 14.9), to force a check with the origin server. + + If a cache has two fresh responses for the same representation with + different validators, it MUST use the one with the more recent Date + header. This situation might arise because the cache is pooling + responses from other caches, or because a client has asked for a + reload or a revalidation of an apparently fresh cache entry. + +13.2.6 Disambiguating Multiple Responses + + Because a client might be receiving responses via multiple paths, so + that some responses flow through one set of caches and other + responses flow through a different set of caches, a client might + receive responses in an order different from that in which the origin + server sent them. We would like the client to use the most recently + generated response, even if older responses are still apparently + fresh. + + Neither the entity tag nor the expiration value can impose an + ordering on responses, since it is possible that a later response + intentionally carries an earlier expiration time. The Date values are + ordered to a granularity of one second. + + When a client tries to revalidate a cache entry, and the response it + receives contains a Date header that appears to be older than the one + for the existing entry, then the client SHOULD repeat the request + unconditionally, and include + + Cache-Control: max-age=0 + + to force any intermediate caches to validate their copies directly + with the origin server, or + + Cache-Control: no-cache + + to force any intermediate caches to obtain a new copy from the origin + server. + + + +Fielding, et al. Standards Track [Page 84] + +RFC 2616 HTTP/1.1 June 1999 + + + If the Date values are equal, then the client MAY use either response + (or MAY, if it is being extremely prudent, request a new response). + Servers MUST NOT depend on clients being able to choose + deterministically between responses generated during the same second, + if their expiration times overlap. + +13.3 Validation Model + + When a cache has a stale entry that it would like to use as a + response to a client's request, it first has to check with the origin + server (or possibly an intermediate cache with a fresh response) to + see if its cached entry is still usable. We call this "validating" + the cache entry. Since we do not want to have to pay the overhead of + retransmitting the full response if the cached entry is good, and we + do not want to pay the overhead of an extra round trip if the cached + entry is invalid, the HTTP/1.1 protocol supports the use of + conditional methods. + + The key protocol features for supporting conditional methods are + those concerned with "cache validators." When an origin server + generates a full response, it attaches some sort of validator to it, + which is kept with the cache entry. When a client (user agent or + proxy cache) makes a conditional request for a resource for which it + has a cache entry, it includes the associated validator in the + request. + + The server then checks that validator against the current validator + for the entity, and, if they match (see section 13.3.3), it responds + with a special status code (usually, 304 (Not Modified)) and no + entity-body. Otherwise, it returns a full response (including + entity-body). Thus, we avoid transmitting the full response if the + validator matches, and we avoid an extra round trip if it does not + match. + + In HTTP/1.1, a conditional request looks exactly the same as a normal + request for the same resource, except that it carries a special + header (which includes the validator) that implicitly turns the + method (usually, GET) into a conditional. + + The protocol includes both positive and negative senses of cache- + validating conditions. That is, it is possible to request either that + a method be performed if and only if a validator matches or if and + only if no validators match. + + + + + + + + +Fielding, et al. Standards Track [Page 85] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: a response that lacks a validator may still be cached, and + served from cache until it expires, unless this is explicitly + prohibited by a cache-control directive. However, a cache cannot + do a conditional retrieval if it does not have a validator for the + entity, which means it will not be refreshable after it expires. + +13.3.1 Last-Modified Dates + + The Last-Modified entity-header field value is often used as a cache + validator. In simple terms, a cache entry is considered to be valid + if the entity has not been modified since the Last-Modified value. + +13.3.2 Entity Tag Cache Validators + + The ETag response-header field value, an entity tag, provides for an + "opaque" cache validator. This might allow more reliable validation + in situations where it is inconvenient to store modification dates, + where the one-second resolution of HTTP date values is not + sufficient, or where the origin server wishes to avoid certain + paradoxes that might arise from the use of modification dates. + + Entity Tags are described in section 3.11. The headers used with + entity tags are described in sections 14.19, 14.24, 14.26 and 14.44. + +13.3.3 Weak and Strong Validators + + Since both origin servers and caches will compare two validators to + decide if they represent the same or different entities, one normally + would expect that if the entity (the entity-body or any entity- + headers) changes in any way, then the associated validator would + change as well. If this is true, then we call this validator a + "strong validator." + + However, there might be cases when a server prefers to change the + validator only on semantically significant changes, and not when + insignificant aspects of the entity change. A validator that does not + always change when the resource changes is a "weak validator." + + Entity tags are normally "strong validators," but the protocol + provides a mechanism to tag an entity tag as "weak." One can think of + a strong validator as one that changes whenever the bits of an entity + changes, while a weak value changes whenever the meaning of an entity + changes. Alternatively, one can think of a strong validator as part + of an identifier for a specific entity, while a weak validator is + part of an identifier for a set of semantically equivalent entities. + + Note: One example of a strong validator is an integer that is + incremented in stable storage every time an entity is changed. + + + +Fielding, et al. Standards Track [Page 86] + +RFC 2616 HTTP/1.1 June 1999 + + + An entity's modification time, if represented with one-second + resolution, could be a weak validator, since it is possible that + the resource might be modified twice during a single second. + + Support for weak validators is optional. However, weak validators + allow for more efficient caching of equivalent objects; for + example, a hit counter on a site is probably good enough if it is + updated every few days or weeks, and any value during that period + is likely "good enough" to be equivalent. + + A "use" of a validator is either when a client generates a request + and includes the validator in a validating header field, or when a + server compares two validators. + + Strong validators are usable in any context. Weak validators are only + usable in contexts that do not depend on exact equality of an entity. + For example, either kind is usable for a conditional GET of a full + entity. However, only a strong validator is usable for a sub-range + retrieval, since otherwise the client might end up with an internally + inconsistent entity. + + Clients MAY issue simple (non-subrange) GET requests with either weak + validators or strong validators. Clients MUST NOT use weak validators + in other forms of request. + + The only function that the HTTP/1.1 protocol defines on validators is + comparison. There are two validator comparison functions, depending + on whether the comparison context allows the use of weak validators + or not: + + - The strong comparison function: in order to be considered equal, + both validators MUST be identical in every way, and both MUST + NOT be weak. + + - The weak comparison function: in order to be considered equal, + both validators MUST be identical in every way, but either or + both of them MAY be tagged as "weak" without affecting the + result. + + An entity tag is strong unless it is explicitly tagged as weak. + Section 3.11 gives the syntax for entity tags. + + A Last-Modified time, when used as a validator in a request, is + implicitly weak unless it is possible to deduce that it is strong, + using the following rules: + + - The validator is being compared by an origin server to the + actual current validator for the entity and, + + + +Fielding, et al. Standards Track [Page 87] + +RFC 2616 HTTP/1.1 June 1999 + + + - That origin server reliably knows that the associated entity did + not change twice during the second covered by the presented + validator. + + or + + - The validator is about to be used by a client in an If- + Modified-Since or If-Unmodified-Since header, because the client + has a cache entry for the associated entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + or + + - The validator is being compared by an intermediate cache to the + validator stored in its cache entry for the entity, and + + - That cache entry includes a Date value, which gives the time + when the origin server sent the original response, and + + - The presented Last-Modified time is at least 60 seconds before + the Date value. + + This method relies on the fact that if two different responses were + sent by the origin server during the same second, but both had the + same Last-Modified time, then at least one of those responses would + have a Date value equal to its Last-Modified time. The arbitrary 60- + second limit guards against the possibility that the Date and Last- + Modified values are generated from different clocks, or at somewhat + different times during the preparation of the response. An + implementation MAY use a value larger than 60 seconds, if it is + believed that 60 seconds is too short. + + If a client wishes to perform a sub-range retrieval on a value for + which it has only a Last-Modified time and no opaque validator, it + MAY do this only if the Last-Modified time is strong in the sense + described here. + + A cache or origin server receiving a conditional request, other than + a full-body GET request, MUST use the strong comparison function to + evaluate the condition. + + These rules allow HTTP/1.1 caches and clients to safely perform sub- + range retrievals on values that have been obtained from HTTP/1.0 + + + +Fielding, et al. Standards Track [Page 88] + +RFC 2616 HTTP/1.1 June 1999 + + + servers. + +13.3.4 Rules for When to Use Entity Tags and Last-Modified Dates + + We adopt a set of rules and recommendations for origin servers, + clients, and caches regarding when various validator types ought to + be used, and for what purposes. + + HTTP/1.1 origin servers: + + - SHOULD send an entity tag validator unless it is not feasible to + generate one. + + - MAY send a weak entity tag instead of a strong entity tag, if + performance considerations support the use of weak entity tags, + or if it is unfeasible to send a strong entity tag. + + - SHOULD send a Last-Modified value if it is feasible to send one, + unless the risk of a breakdown in semantic transparency that + could result from using this date in an If-Modified-Since header + would lead to serious problems. + + In other words, the preferred behavior for an HTTP/1.1 origin server + is to send both a strong entity tag and a Last-Modified value. + + In order to be legal, a strong entity tag MUST change whenever the + associated entity value changes in any way. A weak entity tag SHOULD + change whenever the associated entity changes in a semantically + significant way. + + Note: in order to provide semantically transparent caching, an + origin server must avoid reusing a specific strong entity tag + value for two different entities, or reusing a specific weak + entity tag value for two semantically different entities. Cache + entries might persist for arbitrarily long periods, regardless of + expiration times, so it might be inappropriate to expect that a + cache will never again attempt to validate an entry using a + validator that it obtained at some point in the past. + + HTTP/1.1 clients: + + - If an entity tag has been provided by the origin server, MUST + use that entity tag in any cache-conditional request (using If- + Match or If-None-Match). + + - If only a Last-Modified value has been provided by the origin + server, SHOULD use that value in non-subrange cache-conditional + requests (using If-Modified-Since). + + + +Fielding, et al. Standards Track [Page 89] + +RFC 2616 HTTP/1.1 June 1999 + + + - If only a Last-Modified value has been provided by an HTTP/1.0 + origin server, MAY use that value in subrange cache-conditional + requests (using If-Unmodified-Since:). The user agent SHOULD + provide a way to disable this, in case of difficulty. + + - If both an entity tag and a Last-Modified value have been + provided by the origin server, SHOULD use both validators in + cache-conditional requests. This allows both HTTP/1.0 and + HTTP/1.1 caches to respond appropriately. + + An HTTP/1.1 origin server, upon receiving a conditional request that + includes both a Last-Modified date (e.g., in an If-Modified-Since or + If-Unmodified-Since header field) and one or more entity tags (e.g., + in an If-Match, If-None-Match, or If-Range header field) as cache + validators, MUST NOT return a response status of 304 (Not Modified) + unless doing so is consistent with all of the conditional header + fields in the request. + + An HTTP/1.1 caching proxy, upon receiving a conditional request that + includes both a Last-Modified date and one or more entity tags as + cache validators, MUST NOT return a locally cached response to the + client unless that cached response is consistent with all of the + conditional header fields in the request. + + Note: The general principle behind these rules is that HTTP/1.1 + servers and clients should transmit as much non-redundant + information as is available in their responses and requests. + HTTP/1.1 systems receiving this information will make the most + conservative assumptions about the validators they receive. + + HTTP/1.0 clients and caches will ignore entity tags. Generally, + last-modified values received or used by these systems will + support transparent and efficient caching, and so HTTP/1.1 origin + servers should provide Last-Modified values. In those rare cases + where the use of a Last-Modified value as a validator by an + HTTP/1.0 system could result in a serious problem, then HTTP/1.1 + origin servers should not provide one. + +13.3.5 Non-validating Conditionals + + The principle behind entity tags is that only the service author + knows the semantics of a resource well enough to select an + appropriate cache validation mechanism, and the specification of any + validator comparison function more complex than byte-equality would + open up a can of worms. Thus, comparisons of any other headers + (except Last-Modified, for compatibility with HTTP/1.0) are never + used for purposes of validating a cache entry. + + + + +Fielding, et al. Standards Track [Page 90] + +RFC 2616 HTTP/1.1 June 1999 + + +13.4 Response Cacheability + + Unless specifically constrained by a cache-control (section 14.9) + directive, a caching system MAY always store a successful response + (see section 13.8) as a cache entry, MAY return it without validation + if it is fresh, and MAY return it after successful validation. If + there is neither a cache validator nor an explicit expiration time + associated with a response, we do not expect it to be cached, but + certain caches MAY violate this expectation (for example, when little + or no network connectivity is available). A client can usually detect + that such a response was taken from a cache by comparing the Date + header to the current time. + + Note: some HTTP/1.0 caches are known to violate this expectation + without providing any Warning. + + However, in some cases it might be inappropriate for a cache to + retain an entity, or to return it in response to a subsequent + request. This might be because absolute semantic transparency is + deemed necessary by the service author, or because of security or + privacy considerations. Certain cache-control directives are + therefore provided so that the server can indicate that certain + resource entities, or portions thereof, are not to be cached + regardless of other considerations. + + Note that section 14.8 normally prevents a shared cache from saving + and returning a response to a previous request if that request + included an Authorization header. + + A response received with a status code of 200, 203, 206, 300, 301 or + 410 MAY be stored by a cache and used in reply to a subsequent + request, subject to the expiration mechanism, unless a cache-control + directive prohibits caching. However, a cache that does not support + the Range and Content-Range headers MUST NOT cache 206 (Partial + Content) responses. + + A response received with any other status code (e.g. status codes 302 + and 307) MUST NOT be returned in a reply to a subsequent request + unless there are cache-control directives or another header(s) that + explicitly allow it. For example, these include the following: an + Expires header (section 14.21); a "max-age", "s-maxage", "must- + revalidate", "proxy-revalidate", "public" or "private" cache-control + directive (section 14.9). + + + + + + + + +Fielding, et al. Standards Track [Page 91] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5 Constructing Responses From Caches + + The purpose of an HTTP cache is to store information received in + response to requests for use in responding to future requests. In + many cases, a cache simply returns the appropriate parts of a + response to the requester. However, if the cache holds a cache entry + based on a previous response, it might have to combine parts of a new + response with what is held in the cache entry. + +13.5.1 End-to-end and Hop-by-hop Headers + + For the purpose of defining the behavior of caches and non-caching + proxies, we divide HTTP headers into two categories: + + - End-to-end headers, which are transmitted to the ultimate + recipient of a request or response. End-to-end headers in + responses MUST be stored as part of a cache entry and MUST be + transmitted in any response formed from a cache entry. + + - Hop-by-hop headers, which are meaningful only for a single + transport-level connection, and are not stored by caches or + forwarded by proxies. + + The following HTTP/1.1 headers are hop-by-hop headers: + + - Connection + - Keep-Alive + - Proxy-Authenticate + - Proxy-Authorization + - TE + - Trailers + - Transfer-Encoding + - Upgrade + + All other headers defined by HTTP/1.1 are end-to-end headers. + + Other hop-by-hop headers MUST be listed in a Connection header, + (section 14.10) to be introduced into HTTP/1.1 (or later). + +13.5.2 Non-modifiable Headers + + Some features of the HTTP/1.1 protocol, such as Digest + Authentication, depend on the value of certain end-to-end headers. A + transparent proxy SHOULD NOT modify an end-to-end header unless the + definition of that header requires or specifically allows that. + + + + + + +Fielding, et al. Standards Track [Page 92] + +RFC 2616 HTTP/1.1 June 1999 + + + A transparent proxy MUST NOT modify any of the following fields in a + request or response, and it MUST NOT add any of these fields if not + already present: + + - Content-Location + + - Content-MD5 + + - ETag + + - Last-Modified + + A transparent proxy MUST NOT modify any of the following fields in a + response: + + - Expires + + but it MAY add any of these fields if not already present. If an + Expires header is added, it MUST be given a field-value identical to + that of the Date header in that response. + + A proxy MUST NOT modify or add any of the following fields in a + message that contains the no-transform cache-control directive, or in + any request: + + - Content-Encoding + + - Content-Range + + - Content-Type + + A non-transparent proxy MAY modify or add these fields to a message + that does not include no-transform, but if it does so, it MUST add a + Warning 214 (Transformation applied) if one does not already appear + in the message (see section 14.46). + + Warning: unnecessary modification of end-to-end headers might + cause authentication failures if stronger authentication + mechanisms are introduced in later versions of HTTP. Such + authentication mechanisms MAY rely on the values of header fields + not listed here. + + The Content-Length field of a request or response is added or deleted + according to the rules in section 4.4. A transparent proxy MUST + preserve the entity-length (section 7.2.2) of the entity-body, + although it MAY change the transfer-length (section 4.4). + + + + + +Fielding, et al. Standards Track [Page 93] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.3 Combining Headers + + When a cache makes a validating request to a server, and the server + provides a 304 (Not Modified) response or a 206 (Partial Content) + response, the cache then constructs a response to send to the + requesting client. + + If the status code is 304 (Not Modified), the cache uses the entity- + body stored in the cache entry as the entity-body of this outgoing + response. If the status code is 206 (Partial Content) and the ETag or + Last-Modified headers match exactly, the cache MAY combine the + contents stored in the cache entry with the new contents received in + the response and use the result as the entity-body of this outgoing + response, (see 13.5.4). + + The end-to-end headers stored in the cache entry are used for the + constructed response, except that + + - any stored Warning headers with warn-code 1xx (see section + 14.46) MUST be deleted from the cache entry and the forwarded + response. + + - any stored Warning headers with warn-code 2xx MUST be retained + in the cache entry and the forwarded response. + + - any end-to-end headers provided in the 304 or 206 response MUST + replace the corresponding headers from the cache entry. + + Unless the cache decides to remove the cache entry, it MUST also + replace the end-to-end headers stored with the cache entry with + corresponding headers received in the incoming response, except for + Warning headers as described immediately above. If a header field- + name in the incoming response matches more than one header in the + cache entry, all such old headers MUST be replaced. + + In other words, the set of end-to-end headers received in the + incoming response overrides all corresponding end-to-end headers + stored with the cache entry (except for stored Warning headers with + warn-code 1xx, which are deleted even if not overridden). + + Note: this rule allows an origin server to use a 304 (Not + Modified) or a 206 (Partial Content) response to update any header + associated with a previous response for the same entity or sub- + ranges thereof, although it might not always be meaningful or + correct to do so. This rule does not allow an origin server to use + a 304 (Not Modified) or a 206 (Partial Content) response to + entirely delete a header that it had provided with a previous + response. + + + +Fielding, et al. Standards Track [Page 94] + +RFC 2616 HTTP/1.1 June 1999 + + +13.5.4 Combining Byte Ranges + + A response might transfer only a subrange of the bytes of an entity- + body, either because the request included one or more Range + specifications, or because a connection was broken prematurely. After + several such transfers, a cache might have received several ranges of + the same entity-body. + + If a cache has a stored non-empty set of subranges for an entity, and + an incoming response transfers another subrange, the cache MAY + combine the new subrange with the existing set if both the following + conditions are met: + + - Both the incoming response and the cache entry have a cache + validator. + + - The two cache validators match using the strong comparison + function (see section 13.3.3). + + If either requirement is not met, the cache MUST use only the most + recent partial response (based on the Date values transmitted with + every response, and using the incoming response if these values are + equal or missing), and MUST discard the other partial information. + +13.6 Caching Negotiated Responses + + Use of server-driven content negotiation (section 12.1), as indicated + by the presence of a Vary header field in a response, alters the + conditions and procedure by which a cache can use the response for + subsequent requests. See section 14.44 for use of the Vary header + field by servers. + + A server SHOULD use the Vary header field to inform a cache of what + request-header fields were used to select among multiple + representations of a cacheable response subject to server-driven + negotiation. The set of header fields named by the Vary field value + is known as the "selecting" request-headers. + + When the cache receives a subsequent request whose Request-URI + specifies one or more cache entries including a Vary header field, + the cache MUST NOT use such a cache entry to construct a response to + the new request unless all of the selecting request-headers present + in the new request match the corresponding stored request-headers in + the original request. + + The selecting request-headers from two requests are defined to match + if and only if the selecting request-headers in the first request can + be transformed to the selecting request-headers in the second request + + + +Fielding, et al. Standards Track [Page 95] + +RFC 2616 HTTP/1.1 June 1999 + + + by adding or removing linear white space (LWS) at places where this + is allowed by the corresponding BNF, and/or combining multiple + message-header fields with the same field name following the rules + about message headers in section 4.2. + + A Vary header field-value of "*" always fails to match and subsequent + requests on that resource can only be properly interpreted by the + origin server. + + If the selecting request header fields for the cached entry do not + match the selecting request header fields of the new request, then + the cache MUST NOT use a cached entry to satisfy the request unless + it first relays the new request to the origin server in a conditional + request and the server responds with 304 (Not Modified), including an + entity tag or Content-Location that indicates the entity to be used. + + If an entity tag was assigned to a cached representation, the + forwarded request SHOULD be conditional and include the entity tags + in an If-None-Match header field from all its cache entries for the + resource. This conveys to the server the set of entities currently + held by the cache, so that if any one of these entities matches the + requested entity, the server can use the ETag header field in its 304 + (Not Modified) response to tell the cache which entry is appropriate. + If the entity-tag of the new response matches that of an existing + entry, the new response SHOULD be used to update the header fields of + the existing entry, and the result MUST be returned to the client. + + If any of the existing cache entries contains only partial content + for the associated entity, its entity-tag SHOULD NOT be included in + the If-None-Match header field unless the request is for a range that + would be fully satisfied by that entry. + + If a cache receives a successful response whose Content-Location + field matches that of an existing cache entry for the same Request- + ]URI, whose entity-tag differs from that of the existing entry, and + whose Date is more recent than that of the existing entry, the + existing entry SHOULD NOT be returned in response to future requests + and SHOULD be deleted from the cache. + +13.7 Shared and Non-Shared Caches + + For reasons of security and privacy, it is necessary to make a + distinction between "shared" and "non-shared" caches. A non-shared + cache is one that is accessible only to a single user. Accessibility + in this case SHOULD be enforced by appropriate security mechanisms. + All other caches are considered to be "shared." Other sections of + + + + + +Fielding, et al. Standards Track [Page 96] + +RFC 2616 HTTP/1.1 June 1999 + + + this specification place certain constraints on the operation of + shared caches in order to prevent loss of privacy or failure of + access controls. + +13.8 Errors or Incomplete Response Cache Behavior + + A cache that receives an incomplete response (for example, with fewer + bytes of data than specified in a Content-Length header) MAY store + the response. However, the cache MUST treat this as a partial + response. Partial responses MAY be combined as described in section + 13.5.4; the result might be a full response or might still be + partial. A cache MUST NOT return a partial response to a client + without explicitly marking it as such, using the 206 (Partial + Content) status code. A cache MUST NOT return a partial response + using a status code of 200 (OK). + + If a cache receives a 5xx response while attempting to revalidate an + entry, it MAY either forward this response to the requesting client, + or act as if the server failed to respond. In the latter case, it MAY + return a previously received response unless the cached entry + includes the "must-revalidate" cache-control directive (see section + 14.9). + +13.9 Side Effects of GET and HEAD + + Unless the origin server explicitly prohibits the caching of their + responses, the application of GET and HEAD methods to any resources + SHOULD NOT have side effects that would lead to erroneous behavior if + these responses are taken from a cache. They MAY still have side + effects, but a cache is not required to consider such side effects in + its caching decisions. Caches are always expected to observe an + origin server's explicit restrictions on caching. + + We note one exception to this rule: since some applications have + traditionally used GETs and HEADs with query URLs (those containing a + "?" in the rel_path part) to perform operations with significant side + effects, caches MUST NOT treat responses to such URIs as fresh unless + the server provides an explicit expiration time. This specifically + means that responses from HTTP/1.0 servers for such URIs SHOULD NOT + be taken from a cache. See section 9.1.1 for related information. + +13.10 Invalidation After Updates or Deletions + + The effect of certain methods performed on a resource at the origin + server might cause one or more existing cache entries to become non- + transparently invalid. That is, although they might continue to be + "fresh," they do not accurately reflect what the origin server would + return for a new request on that resource. + + + +Fielding, et al. Standards Track [Page 97] + +RFC 2616 HTTP/1.1 June 1999 + + + There is no way for the HTTP protocol to guarantee that all such + cache entries are marked invalid. For example, the request that + caused the change at the origin server might not have gone through + the proxy where a cache entry is stored. However, several rules help + reduce the likelihood of erroneous behavior. + + In this section, the phrase "invalidate an entity" means that the + cache will either remove all instances of that entity from its + storage, or will mark these as "invalid" and in need of a mandatory + revalidation before they can be returned in response to a subsequent + request. + + Some HTTP methods MUST cause a cache to invalidate an entity. This is + either the entity referred to by the Request-URI, or by the Location + or Content-Location headers (if present). These methods are: + + - PUT + + - DELETE + + - POST + + In order to prevent denial of service attacks, an invalidation based + on the URI in a Location or Content-Location header MUST only be + performed if the host part is the same as in the Request-URI. + + A cache that passes through requests for methods it does not + understand SHOULD invalidate any entities referred to by the + Request-URI. + +13.11 Write-Through Mandatory + + All methods that might be expected to cause modifications to the + origin server's resources MUST be written through to the origin + server. This currently includes all methods except for GET and HEAD. + A cache MUST NOT reply to such a request from a client before having + transmitted the request to the inbound server, and having received a + corresponding response from the inbound server. This does not prevent + a proxy cache from sending a 100 (Continue) response before the + inbound server has sent its final reply. + + The alternative (known as "write-back" or "copy-back" caching) is not + allowed in HTTP/1.1, due to the difficulty of providing consistent + updates and the problems arising from server, cache, or network + failure prior to write-back. + + + + + + +Fielding, et al. Standards Track [Page 98] + +RFC 2616 HTTP/1.1 June 1999 + + +13.12 Cache Replacement + + If a new cacheable (see sections 14.9.2, 13.2.5, 13.2.6 and 13.8) + response is received from a resource while any existing responses for + the same resource are cached, the cache SHOULD use the new response + to reply to the current request. It MAY insert it into cache storage + and MAY, if it meets all other requirements, use it to respond to any + future requests that would previously have caused the old response to + be returned. If it inserts the new response into cache storage the + rules in section 13.5.3 apply. + + Note: a new response that has an older Date header value than + existing cached responses is not cacheable. + +13.13 History Lists + + User agents often have history mechanisms, such as "Back" buttons and + history lists, which can be used to redisplay an entity retrieved + earlier in a session. + + History mechanisms and caches are different. In particular history + mechanisms SHOULD NOT try to show a semantically transparent view of + the current state of a resource. Rather, a history mechanism is meant + to show exactly what the user saw at the time when the resource was + retrieved. + + By default, an expiration time does not apply to history mechanisms. + If the entity is still in storage, a history mechanism SHOULD display + it even if the entity has expired, unless the user has specifically + configured the agent to refresh expired history documents. + + This is not to be construed to prohibit the history mechanism from + telling the user that a view might be stale. + + Note: if history list mechanisms unnecessarily prevent users from + viewing stale resources, this will tend to force service authors + to avoid using HTTP expiration controls and cache controls when + they would otherwise like to. Service authors may consider it + important that users not be presented with error messages or + warning messages when they use navigation controls (such as BACK) + to view previously fetched resources. Even though sometimes such + resources ought not to cached, or ought to expire quickly, user + interface considerations may force service authors to resort to + other means of preventing caching (e.g. "once-only" URLs) in order + not to suffer the effects of improperly functioning history + mechanisms. + + + + + +Fielding, et al. Standards Track [Page 99] + +RFC 2616 HTTP/1.1 June 1999 + + +14 Header Field Definitions + + This section defines the syntax and semantics of all standard + HTTP/1.1 header fields. For entity-header fields, both sender and + recipient refer to either the client or the server, depending on who + sends and who receives the entity. + +14.1 Accept + + The Accept request-header field can be used to specify certain media + types which are acceptable for the response. Accept headers can be + used to indicate that the request is specifically limited to a small + set of desired types, as in the case of a request for an in-line + image. + + Accept = "Accept" ":" + #( media-range [ accept-params ] ) + + media-range = ( "*/*" + | ( type "/" "*" ) + | ( type "/" subtype ) + ) *( ";" parameter ) + accept-params = ";" "q" "=" qvalue *( accept-extension ) + accept-extension = ";" token [ "=" ( token | quoted-string ) ] + + The asterisk "*" character is used to group media types into ranges, + with "*/*" indicating all media types and "type/*" indicating all + subtypes of that type. The media-range MAY include media type + parameters that are applicable to that range. + + Each media-range MAY be followed by one or more accept-params, + beginning with the "q" parameter for indicating a relative quality + factor. The first "q" parameter (if any) separates the media-range + parameter(s) from the accept-params. Quality factors allow the user + or user agent to indicate the relative degree of preference for that + media-range, using the qvalue scale from 0 to 1 (section 3.9). The + default value is q=1. + + Note: Use of the "q" parameter name to separate media type + parameters from Accept extension parameters is due to historical + practice. Although this prevents any media type parameter named + "q" from being used with a media range, such an event is believed + to be unlikely given the lack of any "q" parameters in the IANA + media type registry and the rare usage of any media type + parameters in Accept. Future media types are discouraged from + registering any parameter named "q". + + + + + +Fielding, et al. Standards Track [Page 100] + +RFC 2616 HTTP/1.1 June 1999 + + + The example + + Accept: audio/*; q=0.2, audio/basic + + SHOULD be interpreted as "I prefer audio/basic, but send me any audio + type if it is the best available after an 80% mark-down in quality." + + If no Accept header field is present, then it is assumed that the + client accepts all media types. If an Accept header field is present, + and if the server cannot send a response which is acceptable + according to the combined Accept field value, then the server SHOULD + send a 406 (not acceptable) response. + + A more elaborate example is + + Accept: text/plain; q=0.5, text/html, + text/x-dvi; q=0.8, text/x-c + + Verbally, this would be interpreted as "text/html and text/x-c are + the preferred media types, but if they do not exist, then send the + text/x-dvi entity, and if that does not exist, send the text/plain + entity." + + Media ranges can be overridden by more specific media ranges or + specific media types. If more than one media range applies to a given + type, the most specific reference has precedence. For example, + + Accept: text/*, text/html, text/html;level=1, */* + + have the following precedence: + + 1) text/html;level=1 + 2) text/html + 3) text/* + 4) */* + + The media type quality factor associated with a given type is + determined by finding the media range with the highest precedence + which matches that type. For example, + + Accept: text/*;q=0.3, text/html;q=0.7, text/html;level=1, + text/html;level=2;q=0.4, */*;q=0.5 + + would cause the following values to be associated: + + text/html;level=1 = 1 + text/html = 0.7 + text/plain = 0.3 + + + +Fielding, et al. Standards Track [Page 101] + +RFC 2616 HTTP/1.1 June 1999 + + + image/jpeg = 0.5 + text/html;level=2 = 0.4 + text/html;level=3 = 0.7 + + Note: A user agent might be provided with a default set of quality + values for certain media ranges. However, unless the user agent is + a closed system which cannot interact with other rendering agents, + this default set ought to be configurable by the user. + +14.2 Accept-Charset + + The Accept-Charset request-header field can be used to indicate what + character sets are acceptable for the response. This field allows + clients capable of understanding more comprehensive or special- + purpose character sets to signal that capability to a server which is + capable of representing documents in those character sets. + + Accept-Charset = "Accept-Charset" ":" + 1#( ( charset | "*" )[ ";" "q" "=" qvalue ] ) + + + Character set values are described in section 3.4. Each charset MAY + be given an associated quality value which represents the user's + preference for that charset. The default value is q=1. An example is + + Accept-Charset: iso-8859-5, unicode-1-1;q=0.8 + + The special value "*", if present in the Accept-Charset field, + matches every character set (including ISO-8859-1) which is not + mentioned elsewhere in the Accept-Charset field. If no "*" is present + in an Accept-Charset field, then all character sets not explicitly + mentioned get a quality value of 0, except for ISO-8859-1, which gets + a quality value of 1 if not explicitly mentioned. + + If no Accept-Charset header is present, the default is that any + character set is acceptable. If an Accept-Charset header is present, + and if the server cannot send a response which is acceptable + according to the Accept-Charset header, then the server SHOULD send + an error response with the 406 (not acceptable) status code, though + the sending of an unacceptable response is also allowed. + +14.3 Accept-Encoding + + The Accept-Encoding request-header field is similar to Accept, but + restricts the content-codings (section 3.5) that are acceptable in + the response. + + Accept-Encoding = "Accept-Encoding" ":" + + + +Fielding, et al. Standards Track [Page 102] + +RFC 2616 HTTP/1.1 June 1999 + + + 1#( codings [ ";" "q" "=" qvalue ] ) + codings = ( content-coding | "*" ) + + Examples of its use are: + + Accept-Encoding: compress, gzip + Accept-Encoding: + Accept-Encoding: * + Accept-Encoding: compress;q=0.5, gzip;q=1.0 + Accept-Encoding: gzip;q=1.0, identity; q=0.5, *;q=0 + + A server tests whether a content-coding is acceptable, according to + an Accept-Encoding field, using these rules: + + 1. If the content-coding is one of the content-codings listed in + the Accept-Encoding field, then it is acceptable, unless it is + accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + 2. The special "*" symbol in an Accept-Encoding field matches any + available content-coding not explicitly listed in the header + field. + + 3. If multiple content-codings are acceptable, then the acceptable + content-coding with the highest non-zero qvalue is preferred. + + 4. The "identity" content-coding is always acceptable, unless + specifically refused because the Accept-Encoding field includes + "identity;q=0", or because the field includes "*;q=0" and does + not explicitly include the "identity" content-coding. If the + Accept-Encoding field-value is empty, then only the "identity" + encoding is acceptable. + + If an Accept-Encoding field is present in a request, and if the + server cannot send a response which is acceptable according to the + Accept-Encoding header, then the server SHOULD send an error response + with the 406 (Not Acceptable) status code. + + If no Accept-Encoding field is present in a request, the server MAY + assume that the client will accept any content coding. In this case, + if "identity" is one of the available content-codings, then the + server SHOULD use the "identity" content-coding, unless it has + additional information that a different content-coding is meaningful + to the client. + + Note: If the request does not include an Accept-Encoding field, + and if the "identity" content-coding is unavailable, then + content-codings commonly understood by HTTP/1.0 clients (i.e., + + + +Fielding, et al. Standards Track [Page 103] + +RFC 2616 HTTP/1.1 June 1999 + + + "gzip" and "compress") are preferred; some older clients + improperly display messages sent with other content-codings. The + server might also make this decision based on information about + the particular user-agent or client. + + Note: Most HTTP/1.0 applications do not recognize or obey qvalues + associated with content-codings. This means that qvalues will not + work and are not permitted with x-gzip or x-compress. + +14.4 Accept-Language + + The Accept-Language request-header field is similar to Accept, but + restricts the set of natural languages that are preferred as a + response to the request. Language tags are defined in section 3.10. + + Accept-Language = "Accept-Language" ":" + 1#( language-range [ ";" "q" "=" qvalue ] ) + language-range = ( ( 1*8ALPHA *( "-" 1*8ALPHA ) ) | "*" ) + + Each language-range MAY be given an associated quality value which + represents an estimate of the user's preference for the languages + specified by that range. The quality value defaults to "q=1". For + example, + + Accept-Language: da, en-gb;q=0.8, en;q=0.7 + + would mean: "I prefer Danish, but will accept British English and + other types of English." A language-range matches a language-tag if + it exactly equals the tag, or if it exactly equals a prefix of the + tag such that the first tag character following the prefix is "-". + The special range "*", if present in the Accept-Language field, + matches every tag not matched by any other range present in the + Accept-Language field. + + Note: This use of a prefix matching rule does not imply that + language tags are assigned to languages in such a way that it is + always true that if a user understands a language with a certain + tag, then this user will also understand all languages with tags + for which this tag is a prefix. The prefix rule simply allows the + use of prefix tags if this is the case. + + The language quality factor assigned to a language-tag by the + Accept-Language field is the quality value of the longest language- + range in the field that matches the language-tag. If no language- + range in the field matches the tag, the language quality factor + assigned is 0. If no Accept-Language header is present in the + request, the server + + + + +Fielding, et al. Standards Track [Page 104] + +RFC 2616 HTTP/1.1 June 1999 + + + SHOULD assume that all languages are equally acceptable. If an + Accept-Language header is present, then all languages which are + assigned a quality factor greater than 0 are acceptable. + + It might be contrary to the privacy expectations of the user to send + an Accept-Language header with the complete linguistic preferences of + the user in every request. For a discussion of this issue, see + section 15.1.4. + + As intelligibility is highly dependent on the individual user, it is + recommended that client applications make the choice of linguistic + preference available to the user. If the choice is not made + available, then the Accept-Language header field MUST NOT be given in + the request. + + Note: When making the choice of linguistic preference available to + the user, we remind implementors of the fact that users are not + familiar with the details of language matching as described above, + and should provide appropriate guidance. As an example, users + might assume that on selecting "en-gb", they will be served any + kind of English document if British English is not available. A + user agent might suggest in such a case to add "en" to get the + best matching behavior. + +14.5 Accept-Ranges + + The Accept-Ranges response-header field allows the server to + indicate its acceptance of range requests for a resource: + + Accept-Ranges = "Accept-Ranges" ":" acceptable-ranges + acceptable-ranges = 1#range-unit | "none" + + Origin servers that accept byte-range requests MAY send + + Accept-Ranges: bytes + + but are not required to do so. Clients MAY generate byte-range + requests without having received this header for the resource + involved. Range units are defined in section 3.12. + + Servers that do not accept any kind of range request for a + resource MAY send + + Accept-Ranges: none + + to advise the client not to attempt a range request. + + + + + +Fielding, et al. Standards Track [Page 105] + +RFC 2616 HTTP/1.1 June 1999 + + +14.6 Age + + The Age response-header field conveys the sender's estimate of the + amount of time since the response (or its revalidation) was + generated at the origin server. A cached response is "fresh" if + its age does not exceed its freshness lifetime. Age values are + calculated as specified in section 13.2.3. + + Age = "Age" ":" age-value + age-value = delta-seconds + + Age values are non-negative decimal integers, representing time in + seconds. + + If a cache receives a value larger than the largest positive + integer it can represent, or if any of its age calculations + overflows, it MUST transmit an Age header with a value of + 2147483648 (2^31). An HTTP/1.1 server that includes a cache MUST + include an Age header field in every response generated from its + own cache. Caches SHOULD use an arithmetic type of at least 31 + bits of range. + +14.7 Allow + + The Allow entity-header field lists the set of methods supported + by the resource identified by the Request-URI. The purpose of this + field is strictly to inform the recipient of valid methods + associated with the resource. An Allow header field MUST be + present in a 405 (Method Not Allowed) response. + + Allow = "Allow" ":" #Method + + Example of use: + + Allow: GET, HEAD, PUT + + This field cannot prevent a client from trying other methods. + However, the indications given by the Allow header field value + SHOULD be followed. The actual set of allowed methods is defined + by the origin server at the time of each request. + + The Allow header field MAY be provided with a PUT request to + recommend the methods to be supported by the new or modified + resource. The server is not required to support these methods and + SHOULD include an Allow header in the response giving the actual + supported methods. + + + + + +Fielding, et al. Standards Track [Page 106] + +RFC 2616 HTTP/1.1 June 1999 + + + A proxy MUST NOT modify the Allow header field even if it does not + understand all the methods specified, since the user agent might + have other means of communicating with the origin server. + +14.8 Authorization + + A user agent that wishes to authenticate itself with a server-- + usually, but not necessarily, after receiving a 401 response--does + so by including an Authorization request-header field with the + request. The Authorization field value consists of credentials + containing the authentication information of the user agent for + the realm of the resource being requested. + + Authorization = "Authorization" ":" credentials + + HTTP access authentication is described in "HTTP Authentication: + Basic and Digest Access Authentication" [43]. If a request is + authenticated and a realm specified, the same credentials SHOULD + be valid for all other requests within this realm (assuming that + the authentication scheme itself does not require otherwise, such + as credentials that vary according to a challenge value or using + synchronized clocks). + + When a shared cache (see section 13.7) receives a request + containing an Authorization field, it MUST NOT return the + corresponding response as a reply to any other request, unless one + of the following specific exceptions holds: + + 1. If the response includes the "s-maxage" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But (if the specified maximum age has + passed) a proxy cache MUST first revalidate it with the origin + server, using the request-headers from the new request to allow + the origin server to authenticate the new request. (This is the + defined behavior for s-maxage.) If the response includes "s- + maxage=0", the proxy MUST always revalidate it before re-using + it. + + 2. If the response includes the "must-revalidate" cache-control + directive, the cache MAY use that response in replying to a + subsequent request. But if the response is stale, all caches + MUST first revalidate it with the origin server, using the + request-headers from the new request to allow the origin server + to authenticate the new request. + + 3. If the response includes the "public" cache-control directive, + it MAY be returned in reply to any subsequent request. + + + + +Fielding, et al. Standards Track [Page 107] + +RFC 2616 HTTP/1.1 June 1999 + + +14.9 Cache-Control + + The Cache-Control general-header field is used to specify directives + that MUST be obeyed by all caching mechanisms along the + request/response chain. The directives specify behavior intended to + prevent caches from adversely interfering with the request or + response. These directives typically override the default caching + algorithms. Cache directives are unidirectional in that the presence + of a directive in a request does not imply that the same directive is + to be given in the response. + + Note that HTTP/1.0 caches might not implement Cache-Control and + might only implement Pragma: no-cache (see section 14.32). + + Cache directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a cache- + directive for a specific cache. + + Cache-Control = "Cache-Control" ":" 1#cache-directive + + cache-directive = cache-request-directive + | cache-response-directive + + cache-request-directive = + "no-cache" ; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "max-age" "=" delta-seconds ; Section 14.9.3, 14.9.4 + | "max-stale" [ "=" delta-seconds ] ; Section 14.9.3 + | "min-fresh" "=" delta-seconds ; Section 14.9.3 + | "no-transform" ; Section 14.9.5 + | "only-if-cached" ; Section 14.9.4 + | cache-extension ; Section 14.9.6 + + cache-response-directive = + "public" ; Section 14.9.1 + | "private" [ "=" <"> 1#field-name <"> ] ; Section 14.9.1 + | "no-cache" [ "=" <"> 1#field-name <"> ]; Section 14.9.1 + | "no-store" ; Section 14.9.2 + | "no-transform" ; Section 14.9.5 + | "must-revalidate" ; Section 14.9.4 + | "proxy-revalidate" ; Section 14.9.4 + | "max-age" "=" delta-seconds ; Section 14.9.3 + | "s-maxage" "=" delta-seconds ; Section 14.9.3 + | cache-extension ; Section 14.9.6 + + cache-extension = token [ "=" ( token | quoted-string ) ] + + + +Fielding, et al. Standards Track [Page 108] + +RFC 2616 HTTP/1.1 June 1999 + + + When a directive appears without any 1#field-name parameter, the + directive applies to the entire request or response. When such a + directive appears with a 1#field-name parameter, it applies only to + the named field or fields, and not to the rest of the request or + response. This mechanism supports extensibility; implementations of + future versions of the HTTP protocol might apply these directives to + header fields not defined in HTTP/1.1. + + The cache-control directives can be broken down into these general + categories: + + - Restrictions on what are cacheable; these may only be imposed by + the origin server. + + - Restrictions on what may be stored by a cache; these may be + imposed by either the origin server or the user agent. + + - Modifications of the basic expiration mechanism; these may be + imposed by either the origin server or the user agent. + + - Controls over cache revalidation and reload; these may only be + imposed by a user agent. + + - Control over transformation of entities. + + - Extensions to the caching system. + +14.9.1 What is Cacheable + + By default, a response is cacheable if the requirements of the + request method, request header fields, and the response status + indicate that it is cacheable. Section 13.4 summarizes these defaults + for cacheability. The following Cache-Control response directives + allow an origin server to override the default cacheability of a + response: + + public + Indicates that the response MAY be cached by any cache, even if it + would normally be non-cacheable or cacheable only within a non- + shared cache. (See also Authorization, section 14.8, for + additional details.) + + private + Indicates that all or part of the response message is intended for + a single user and MUST NOT be cached by a shared cache. This + allows an origin server to state that the specified parts of the + + + + + +Fielding, et al. Standards Track [Page 109] + +RFC 2616 HTTP/1.1 June 1999 + + + response are intended for only one user and are not a valid + response for requests by other users. A private (non-shared) cache + MAY cache the response. + + Note: This usage of the word private only controls where the + response may be cached, and cannot ensure the privacy of the + message content. + + no-cache + If the no-cache directive does not specify a field-name, then a + cache MUST NOT use the response to satisfy a subsequent request + without successful revalidation with the origin server. This + allows an origin server to prevent caching even by caches that + have been configured to return stale responses to client requests. + + If the no-cache directive does specify one or more field-names, + then a cache MAY use the response to satisfy a subsequent request, + subject to any other restrictions on caching. However, the + specified field-name(s) MUST NOT be sent in the response to a + subsequent request without successful revalidation with the origin + server. This allows an origin server to prevent the re-use of + certain header fields in a response, while still allowing caching + of the rest of the response. + + Note: Most HTTP/1.0 caches will not recognize or obey this + directive. + +14.9.2 What May be Stored by Caches + + no-store + The purpose of the no-store directive is to prevent the + inadvertent release or retention of sensitive information (for + example, on backup tapes). The no-store directive applies to the + entire message, and MAY be sent either in a response or in a + request. If sent in a request, a cache MUST NOT store any part of + either this request or any response to it. If sent in a response, + a cache MUST NOT store any part of either this response or the + request that elicited it. This directive applies to both non- + shared and shared caches. "MUST NOT store" in this context means + that the cache MUST NOT intentionally store the information in + non-volatile storage, and MUST make a best-effort attempt to + remove the information from volatile storage as promptly as + possible after forwarding it. + + Even when this directive is associated with a response, users + might explicitly store such a response outside of the caching + system (e.g., with a "Save As" dialog). History buffers MAY store + such responses as part of their normal operation. + + + +Fielding, et al. Standards Track [Page 110] + +RFC 2616 HTTP/1.1 June 1999 + + + The purpose of this directive is to meet the stated requirements + of certain users and service authors who are concerned about + accidental releases of information via unanticipated accesses to + cache data structures. While the use of this directive might + improve privacy in some cases, we caution that it is NOT in any + way a reliable or sufficient mechanism for ensuring privacy. In + particular, malicious or compromised caches might not recognize or + obey this directive, and communications networks might be + vulnerable to eavesdropping. + +14.9.3 Modifications of the Basic Expiration Mechanism + + The expiration time of an entity MAY be specified by the origin + server using the Expires header (see section 14.21). Alternatively, + it MAY be specified using the max-age directive in a response. When + the max-age cache-control directive is present in a cached response, + the response is stale if its current age is greater than the age + value given (in seconds) at the time of a new request for that + resource. The max-age directive on a response implies that the + response is cacheable (i.e., "public") unless some other, more + restrictive cache directive is also present. + + If a response includes both an Expires header and a max-age + directive, the max-age directive overrides the Expires header, even + if the Expires header is more restrictive. This rule allows an origin + server to provide, for a given response, a longer expiration time to + an HTTP/1.1 (or later) cache than to an HTTP/1.0 cache. This might be + useful if certain HTTP/1.0 caches improperly calculate ages or + expiration times, perhaps due to desynchronized clocks. + + Many HTTP/1.0 cache implementations will treat an Expires value that + is less than or equal to the response Date value as being equivalent + to the Cache-Control response directive "no-cache". If an HTTP/1.1 + cache receives such a response, and the response does not include a + Cache-Control header field, it SHOULD consider the response to be + non-cacheable in order to retain compatibility with HTTP/1.0 servers. + + Note: An origin server might wish to use a relatively new HTTP + cache control feature, such as the "private" directive, on a + network including older caches that do not understand that + feature. The origin server will need to combine the new feature + with an Expires field whose value is less than or equal to the + Date value. This will prevent older caches from improperly + caching the response. + + + + + + + +Fielding, et al. Standards Track [Page 111] + +RFC 2616 HTTP/1.1 June 1999 + + + s-maxage + If a response includes an s-maxage directive, then for a shared + cache (but not for a private cache), the maximum age specified by + this directive overrides the maximum age specified by either the + max-age directive or the Expires header. The s-maxage directive + also implies the semantics of the proxy-revalidate directive (see + section 14.9.4), i.e., that the shared cache must not use the + entry after it becomes stale to respond to a subsequent request + without first revalidating it with the origin server. The s- + maxage directive is always ignored by a private cache. + + Note that most older caches, not compliant with this specification, + do not implement any cache-control directives. An origin server + wishing to use a cache-control directive that restricts, but does not + prevent, caching by an HTTP/1.1-compliant cache MAY exploit the + requirement that the max-age directive overrides the Expires header, + and the fact that pre-HTTP/1.1-compliant caches do not observe the + max-age directive. + + Other directives allow a user agent to modify the basic expiration + mechanism. These directives MAY be specified on a request: + + max-age + Indicates that the client is willing to accept a response whose + age is no greater than the specified time in seconds. Unless max- + stale directive is also included, the client is not willing to + accept a stale response. + + min-fresh + Indicates that the client is willing to accept a response whose + freshness lifetime is no less than its current age plus the + specified time in seconds. That is, the client wants a response + that will still be fresh for at least the specified number of + seconds. + + max-stale + Indicates that the client is willing to accept a response that has + exceeded its expiration time. If max-stale is assigned a value, + then the client is willing to accept a response that has exceeded + its expiration time by no more than the specified number of + seconds. If no value is assigned to max-stale, then the client is + willing to accept a stale response of any age. + + If a cache returns a stale response, either because of a max-stale + directive on a request, or because the cache is configured to + override the expiration time of a response, the cache MUST attach a + Warning header to the stale response, using Warning 110 (Response is + stale). + + + +Fielding, et al. Standards Track [Page 112] + +RFC 2616 HTTP/1.1 June 1999 + + + A cache MAY be configured to return stale responses without + validation, but only if this does not conflict with any "MUST"-level + requirements concerning cache validation (e.g., a "must-revalidate" + cache-control directive). + + If both the new request and the cached entry include "max-age" + directives, then the lesser of the two values is used for determining + the freshness of the cached entry for that request. + +14.9.4 Cache Revalidation and Reload Controls + + Sometimes a user agent might want or need to insist that a cache + revalidate its cache entry with the origin server (and not just with + the next cache along the path to the origin server), or to reload its + cache entry from the origin server. End-to-end revalidation might be + necessary if either the cache or the origin server has overestimated + the expiration time of the cached response. End-to-end reload may be + necessary if the cache entry has become corrupted for some reason. + + End-to-end revalidation may be requested either when the client does + not have its own local cached copy, in which case we call it + "unspecified end-to-end revalidation", or when the client does have a + local cached copy, in which case we call it "specific end-to-end + revalidation." + + The client can specify these three kinds of action using Cache- + Control request directives: + + End-to-end reload + The request includes a "no-cache" cache-control directive or, for + compatibility with HTTP/1.0 clients, "Pragma: no-cache". Field + names MUST NOT be included with the no-cache directive in a + request. The server MUST NOT use a cached copy when responding to + such a request. + + Specific end-to-end revalidation + The request includes a "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request includes a cache-validating conditional with + the client's current validator. + + Unspecified end-to-end revalidation + The request includes "max-age=0" cache-control directive, which + forces each cache along the path to the origin server to + revalidate its own entry, if any, with the next cache or server. + The initial request does not include a cache-validating + + + + +Fielding, et al. Standards Track [Page 113] + +RFC 2616 HTTP/1.1 June 1999 + + + conditional; the first cache along the path (if any) that holds a + cache entry for this resource includes a cache-validating + conditional with its current validator. + + max-age + When an intermediate cache is forced, by means of a max-age=0 + directive, to revalidate its own cache entry, and the client has + supplied its own validator in the request, the supplied validator + might differ from the validator currently stored with the cache + entry. In this case, the cache MAY use either validator in making + its own request without affecting semantic transparency. + + However, the choice of validator might affect performance. The + best approach is for the intermediate cache to use its own + validator when making its request. If the server replies with 304 + (Not Modified), then the cache can return its now validated copy + to the client with a 200 (OK) response. If the server replies with + a new entity and cache validator, however, the intermediate cache + can compare the returned validator with the one provided in the + client's request, using the strong comparison function. If the + client's validator is equal to the origin server's, then the + intermediate cache simply returns 304 (Not Modified). Otherwise, + it returns the new entity with a 200 (OK) response. + + If a request includes the no-cache directive, it SHOULD NOT + include min-fresh, max-stale, or max-age. + + only-if-cached + In some cases, such as times of extremely poor network + connectivity, a client may want a cache to return only those + responses that it currently has stored, and not to reload or + revalidate with the origin server. To do this, the client may + include the only-if-cached directive in a request. If it receives + this directive, a cache SHOULD either respond using a cached entry + that is consistent with the other constraints of the request, or + respond with a 504 (Gateway Timeout) status. However, if a group + of caches is being operated as a unified system with good internal + connectivity, such a request MAY be forwarded within that group of + caches. + + must-revalidate + Because a cache MAY be configured to ignore a server's specified + expiration time, and because a client request MAY include a max- + stale directive (which has a similar effect), the protocol also + includes a mechanism for the origin server to require revalidation + of a cache entry on any subsequent use. When the must-revalidate + directive is present in a response received by a cache, that cache + MUST NOT use the entry after it becomes stale to respond to a + + + +Fielding, et al. Standards Track [Page 114] + +RFC 2616 HTTP/1.1 June 1999 + + + subsequent request without first revalidating it with the origin + server. (I.e., the cache MUST do an end-to-end revalidation every + time, if, based solely on the origin server's Expires or max-age + value, the cached response is stale.) + + The must-revalidate directive is necessary to support reliable + operation for certain protocol features. In all circumstances an + HTTP/1.1 cache MUST obey the must-revalidate directive; in + particular, if the cache cannot reach the origin server for any + reason, it MUST generate a 504 (Gateway Timeout) response. + + Servers SHOULD send the must-revalidate directive if and only if + failure to revalidate a request on the entity could result in + incorrect operation, such as a silently unexecuted financial + transaction. Recipients MUST NOT take any automated action that + violates this directive, and MUST NOT automatically provide an + unvalidated copy of the entity if revalidation fails. + + Although this is not recommended, user agents operating under + severe connectivity constraints MAY violate this directive but, if + so, MUST explicitly warn the user that an unvalidated response has + been provided. The warning MUST be provided on each unvalidated + access, and SHOULD require explicit user confirmation. + + proxy-revalidate + The proxy-revalidate directive has the same meaning as the must- + revalidate directive, except that it does not apply to non-shared + user agent caches. It can be used on a response to an + authenticated request to permit the user's cache to store and + later return the response without needing to revalidate it (since + it has already been authenticated once by that user), while still + requiring proxies that service many users to revalidate each time + (in order to make sure that each user has been authenticated). + Note that such authenticated responses also need the public cache + control directive in order to allow them to be cached at all. + +14.9.5 No-Transform Directive + + no-transform + Implementors of intermediate caches (proxies) have found it useful + to convert the media type of certain entity bodies. A non- + transparent proxy might, for example, convert between image + formats in order to save cache space or to reduce the amount of + traffic on a slow link. + + Serious operational problems occur, however, when these + transformations are applied to entity bodies intended for certain + kinds of applications. For example, applications for medical + + + +Fielding, et al. Standards Track [Page 115] + +RFC 2616 HTTP/1.1 June 1999 + + + imaging, scientific data analysis and those using end-to-end + authentication, all depend on receiving an entity body that is bit + for bit identical to the original entity-body. + + Therefore, if a message includes the no-transform directive, an + intermediate cache or proxy MUST NOT change those headers that are + listed in section 13.5.2 as being subject to the no-transform + directive. This implies that the cache or proxy MUST NOT change + any aspect of the entity-body that is specified by these headers, + including the value of the entity-body itself. + +14.9.6 Cache Control Extensions + + The Cache-Control header field can be extended through the use of one + or more cache-extension tokens, each with an optional assigned value. + Informational extensions (those which do not require a change in + cache behavior) MAY be added without changing the semantics of other + directives. Behavioral extensions are designed to work by acting as + modifiers to the existing base of cache directives. Both the new + directive and the standard directive are supplied, such that + applications which do not understand the new directive will default + to the behavior specified by the standard directive, and those that + understand the new directive will recognize it as modifying the + requirements associated with the standard directive. In this way, + extensions to the cache-control directives can be made without + requiring changes to the base protocol. + + This extension mechanism depends on an HTTP cache obeying all of the + cache-control directives defined for its native HTTP-version, obeying + certain extensions, and ignoring all directives that it does not + understand. + + For example, consider a hypothetical new response directive called + community which acts as a modifier to the private directive. We + define this new directive to mean that, in addition to any non-shared + cache, any cache which is shared only by members of the community + named within its value may cache the response. An origin server + wishing to allow the UCI community to use an otherwise private + response in their shared cache(s) could do so by including + + Cache-Control: private, community="UCI" + + A cache seeing this header field will act correctly even if the cache + does not understand the community cache-extension, since it will also + see and understand the private directive and thus default to the safe + behavior. + + + + + +Fielding, et al. Standards Track [Page 116] + +RFC 2616 HTTP/1.1 June 1999 + + + Unrecognized cache-directives MUST be ignored; it is assumed that any + cache-directive likely to be unrecognized by an HTTP/1.1 cache will + be combined with standard directives (or the response's default + cacheability) such that the cache behavior will remain minimally + correct even if the cache does not understand the extension(s). + +14.10 Connection + + The Connection general-header field allows the sender to specify + options that are desired for that particular connection and MUST NOT + be communicated by proxies over further connections. + + The Connection header has the following grammar: + + Connection = "Connection" ":" 1#(connection-token) + connection-token = token + + HTTP/1.1 proxies MUST parse the Connection header field before a + message is forwarded and, for each connection-token in this field, + remove any header field(s) from the message with the same name as the + connection-token. Connection options are signaled by the presence of + a connection-token in the Connection header field, not by any + corresponding additional header field(s), since the additional header + field may not be sent if there are no parameters associated with that + connection option. + + Message headers listed in the Connection header MUST NOT include + end-to-end headers, such as Cache-Control. + + HTTP/1.1 defines the "close" connection option for the sender to + signal that the connection will be closed after completion of the + response. For example, + + Connection: close + + in either the request or the response header fields indicates that + the connection SHOULD NOT be considered `persistent' (section 8.1) + after the current request/response is complete. + + HTTP/1.1 applications that do not support persistent connections MUST + include the "close" connection option in every message. + + A system receiving an HTTP/1.0 (or lower-version) message that + includes a Connection header MUST, for each connection-token in this + field, remove and ignore any header field(s) from the message with + the same name as the connection-token. This protects against mistaken + forwarding of such header fields by pre-HTTP/1.1 proxies. See section + 19.6.2. + + + +Fielding, et al. Standards Track [Page 117] + +RFC 2616 HTTP/1.1 June 1999 + + +14.11 Content-Encoding + + The Content-Encoding entity-header field is used as a modifier to the + media-type. When present, its value indicates what additional content + codings have been applied to the entity-body, and thus what decoding + mechanisms must be applied in order to obtain the media-type + referenced by the Content-Type header field. Content-Encoding is + primarily used to allow a document to be compressed without losing + the identity of its underlying media type. + + Content-Encoding = "Content-Encoding" ":" 1#content-coding + + Content codings are defined in section 3.5. An example of its use is + + Content-Encoding: gzip + + The content-coding is a characteristic of the entity identified by + the Request-URI. Typically, the entity-body is stored with this + encoding and is only decoded before rendering or analogous usage. + However, a non-transparent proxy MAY modify the content-coding if the + new coding is known to be acceptable to the recipient, unless the + "no-transform" cache-control directive is present in the message. + + If the content-coding of an entity is not "identity", then the + response MUST include a Content-Encoding entity-header (section + 14.11) that lists the non-identity content-coding(s) used. + + If the content-coding of an entity in a request message is not + acceptable to the origin server, the server SHOULD respond with a + status code of 415 (Unsupported Media Type). + + If multiple encodings have been applied to an entity, the content + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + +14.12 Content-Language + + The Content-Language entity-header field describes the natural + language(s) of the intended audience for the enclosed entity. Note + that this might not be equivalent to all the languages used within + the entity-body. + + Content-Language = "Content-Language" ":" 1#language-tag + + + + + + + +Fielding, et al. Standards Track [Page 118] + +RFC 2616 HTTP/1.1 June 1999 + + + Language tags are defined in section 3.10. The primary purpose of + Content-Language is to allow a user to identify and differentiate + entities according to the user's own preferred language. Thus, if the + body content is intended only for a Danish-literate audience, the + appropriate field is + + Content-Language: da + + If no Content-Language is specified, the default is that the content + is intended for all language audiences. This might mean that the + sender does not consider it to be specific to any natural language, + or that the sender does not know for which language it is intended. + + Multiple languages MAY be listed for content that is intended for + multiple audiences. For example, a rendition of the "Treaty of + Waitangi," presented simultaneously in the original Maori and English + versions, would call for + + Content-Language: mi, en + + However, just because multiple languages are present within an entity + does not mean that it is intended for multiple linguistic audiences. + An example would be a beginner's language primer, such as "A First + Lesson in Latin," which is clearly intended to be used by an + English-literate audience. In this case, the Content-Language would + properly only include "en". + + Content-Language MAY be applied to any media type -- it is not + limited to textual documents. + +14.13 Content-Length + + The Content-Length entity-header field indicates the size of the + entity-body, in decimal number of OCTETs, sent to the recipient or, + in the case of the HEAD method, the size of the entity-body that + would have been sent had the request been a GET. + + Content-Length = "Content-Length" ":" 1*DIGIT + + An example is + + Content-Length: 3495 + + Applications SHOULD use this field to indicate the transfer-length of + the message-body, unless this is prohibited by the rules in section + 4.4. + + + + + +Fielding, et al. Standards Track [Page 119] + +RFC 2616 HTTP/1.1 June 1999 + + + Any Content-Length greater than or equal to zero is a valid value. + Section 4.4 describes how to determine the length of a message-body + if a Content-Length is not given. + + Note that the meaning of this field is significantly different from + the corresponding definition in MIME, where it is an optional field + used within the "message/external-body" content-type. In HTTP, it + SHOULD be sent whenever the message's length can be determined prior + to being transferred, unless this is prohibited by the rules in + section 4.4. + +14.14 Content-Location + + The Content-Location entity-header field MAY be used to supply the + resource location for the entity enclosed in the message when that + entity is accessible from a location separate from the requested + resource's URI. A server SHOULD provide a Content-Location for the + variant corresponding to the response entity; especially in the case + where a resource has multiple entities associated with it, and those + entities actually have separate locations by which they might be + individually accessed, the server SHOULD provide a Content-Location + for the particular variant which is returned. + + Content-Location = "Content-Location" ":" + ( absoluteURI | relativeURI ) + + The value of Content-Location also defines the base URI for the + entity. + + The Content-Location value is not a replacement for the original + requested URI; it is only a statement of the location of the resource + corresponding to this particular entity at the time of the request. + Future requests MAY specify the Content-Location URI as the request- + URI if the desire is to identify the source of that particular + entity. + + A cache cannot assume that an entity with a Content-Location + different from the URI used to retrieve it can be used to respond to + later requests on that Content-Location URI. However, the Content- + Location can be used to differentiate between multiple entities + retrieved from a single requested resource, as described in section + 13.6. + + If the Content-Location is a relative URI, the relative URI is + interpreted relative to the Request-URI. + + The meaning of the Content-Location header in PUT or POST requests is + undefined; servers are free to ignore it in those cases. + + + +Fielding, et al. Standards Track [Page 120] + +RFC 2616 HTTP/1.1 June 1999 + + +14.15 Content-MD5 + + The Content-MD5 entity-header field, as defined in RFC 1864 [23], is + an MD5 digest of the entity-body for the purpose of providing an + end-to-end message integrity check (MIC) of the entity-body. (Note: a + MIC is good for detecting accidental modification of the entity-body + in transit, but is not proof against malicious attacks.) + + Content-MD5 = "Content-MD5" ":" md5-digest + md5-digest = + + The Content-MD5 header field MAY be generated by an origin server or + client to function as an integrity check of the entity-body. Only + origin servers or clients MAY generate the Content-MD5 header field; + proxies and gateways MUST NOT generate it, as this would defeat its + value as an end-to-end integrity check. Any recipient of the entity- + body, including gateways and proxies, MAY check that the digest value + in this header field matches that of the entity-body as received. + + The MD5 digest is computed based on the content of the entity-body, + including any content-coding that has been applied, but not including + any transfer-encoding applied to the message-body. If the message is + received with a transfer-encoding, that encoding MUST be removed + prior to checking the Content-MD5 value against the received entity. + + This has the result that the digest is computed on the octets of the + entity-body exactly as, and in the order that, they would be sent if + no transfer-encoding were being applied. + + HTTP extends RFC 1864 to permit the digest to be computed for MIME + composite media-types (e.g., multipart/* and message/rfc822), but + this does not change how the digest is computed as defined in the + preceding paragraph. + + There are several consequences of this. The entity-body for composite + types MAY contain many body-parts, each with its own MIME and HTTP + headers (including Content-MD5, Content-Transfer-Encoding, and + Content-Encoding headers). If a body-part has a Content-Transfer- + Encoding or Content-Encoding header, it is assumed that the content + of the body-part has had the encoding applied, and the body-part is + included in the Content-MD5 digest as is -- i.e., after the + application. The Transfer-Encoding header field is not allowed within + body-parts. + + Conversion of all line breaks to CRLF MUST NOT be done before + computing or checking the digest: the line break convention used in + the text actually transmitted MUST be left unaltered when computing + the digest. + + + +Fielding, et al. Standards Track [Page 121] + +RFC 2616 HTTP/1.1 June 1999 + + + Note: while the definition of Content-MD5 is exactly the same for + HTTP as in RFC 1864 for MIME entity-bodies, there are several ways + in which the application of Content-MD5 to HTTP entity-bodies + differs from its application to MIME entity-bodies. One is that + HTTP, unlike MIME, does not use Content-Transfer-Encoding, and + does use Transfer-Encoding and Content-Encoding. Another is that + HTTP more frequently uses binary content types than MIME, so it is + worth noting that, in such cases, the byte order used to compute + the digest is the transmission byte order defined for the type. + Lastly, HTTP allows transmission of text types with any of several + line break conventions and not just the canonical form using CRLF. + +14.16 Content-Range + + The Content-Range entity-header is sent with a partial entity-body to + specify where in the full entity-body the partial body should be + applied. Range units are defined in section 3.12. + + Content-Range = "Content-Range" ":" content-range-spec + + content-range-spec = byte-content-range-spec + byte-content-range-spec = bytes-unit SP + byte-range-resp-spec "/" + ( instance-length | "*" ) + + byte-range-resp-spec = (first-byte-pos "-" last-byte-pos) + | "*" + instance-length = 1*DIGIT + + The header SHOULD indicate the total length of the full entity-body, + unless this length is unknown or difficult to determine. The asterisk + "*" character means that the instance-length is unknown at the time + when the response was generated. + + Unlike byte-ranges-specifier values (see section 14.35.1), a byte- + range-resp-spec MUST only specify one range, and MUST contain + absolute byte positions for both the first and last byte of the + range. + + A byte-content-range-spec with a byte-range-resp-spec whose last- + byte-pos value is less than its first-byte-pos value, or whose + instance-length value is less than or equal to its last-byte-pos + value, is invalid. The recipient of an invalid byte-content-range- + spec MUST ignore it and any content transferred along with it. + + A server sending a response with status code 416 (Requested range not + satisfiable) SHOULD include a Content-Range field with a byte-range- + resp-spec of "*". The instance-length specifies the current length of + + + +Fielding, et al. Standards Track [Page 122] + +RFC 2616 HTTP/1.1 June 1999 + + + the selected resource. A response with status code 206 (Partial + Content) MUST NOT include a Content-Range field with a byte-range- + resp-spec of "*". + + Examples of byte-content-range-spec values, assuming that the entity + contains a total of 1234 bytes: + + . The first 500 bytes: + bytes 0-499/1234 + + . The second 500 bytes: + bytes 500-999/1234 + + . All except for the first 500 bytes: + bytes 500-1233/1234 + + . The last 500 bytes: + bytes 734-1233/1234 + + When an HTTP message includes the content of a single range (for + example, a response to a request for a single range, or to a request + for a set of ranges that overlap without any holes), this content is + transmitted with a Content-Range header, and a Content-Length header + showing the number of bytes actually transferred. For example, + + HTTP/1.1 206 Partial content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-Range: bytes 21010-47021/47022 + Content-Length: 26012 + Content-Type: image/gif + + When an HTTP message includes the content of multiple ranges (for + example, a response to a request for multiple non-overlapping + ranges), these are transmitted as a multipart message. The multipart + media type used for this purpose is "multipart/byteranges" as defined + in appendix 19.2. See appendix 19.6.3 for a compatibility issue. + + A response to a request for a single range MUST NOT be sent using the + multipart/byteranges media type. A response to a request for + multiple ranges, whose result is a single range, MAY be sent as a + multipart/byteranges media type with one part. A client that cannot + decode a multipart/byteranges message MUST NOT ask for multiple + byte-ranges in a single request. + + When a client requests multiple byte-ranges in one request, the + server SHOULD return them in the order that they appeared in the + request. + + + +Fielding, et al. Standards Track [Page 123] + +RFC 2616 HTTP/1.1 June 1999 + + + If the server ignores a byte-range-spec because it is syntactically + invalid, the server SHOULD treat the request as if the invalid Range + header field did not exist. (Normally, this means return a 200 + response containing the full entity). + + If the server receives a request (other than one including an If- + Range request-header field) with an unsatisfiable Range request- + header field (that is, all of whose byte-range-spec values have a + first-byte-pos value greater than the current length of the selected + resource), it SHOULD return a response code of 416 (Requested range + not satisfiable) (section 10.4.17). + + Note: clients cannot depend on servers to send a 416 (Requested + range not satisfiable) response instead of a 200 (OK) response for + an unsatisfiable Range request-header, since not all servers + implement this request-header. + +14.17 Content-Type + + The Content-Type entity-header field indicates the media type of the + entity-body sent to the recipient or, in the case of the HEAD method, + the media type that would have been sent had the request been a GET. + + Content-Type = "Content-Type" ":" media-type + + Media types are defined in section 3.7. An example of the field is + + Content-Type: text/html; charset=ISO-8859-4 + + Further discussion of methods for identifying the media type of an + entity is provided in section 7.2.1. + +14.18 Date + + The Date general-header field represents the date and time at which + the message was originated, having the same semantics as orig-date in + RFC 822. The field value is an HTTP-date, as described in section + 3.3.1; it MUST be sent in RFC 1123 [8]-date format. + + Date = "Date" ":" HTTP-date + + An example is + + Date: Tue, 15 Nov 1994 08:12:31 GMT + + Origin servers MUST include a Date header field in all responses, + except in these cases: + + + + +Fielding, et al. Standards Track [Page 124] + +RFC 2616 HTTP/1.1 June 1999 + + + 1. If the response status code is 100 (Continue) or 101 (Switching + Protocols), the response MAY include a Date header field, at + the server's option. + + 2. If the response status code conveys a server error, e.g. 500 + (Internal Server Error) or 503 (Service Unavailable), and it is + inconvenient or impossible to generate a valid Date. + + 3. If the server does not have a clock that can provide a + reasonable approximation of the current time, its responses + MUST NOT include a Date header field. In this case, the rules + in section 14.18.1 MUST be followed. + + A received message that does not have a Date header field MUST be + assigned one by the recipient if the message will be cached by that + recipient or gatewayed via a protocol which requires a Date. An HTTP + implementation without a clock MUST NOT cache responses without + revalidating them on every use. An HTTP cache, especially a shared + cache, SHOULD use a mechanism, such as NTP [28], to synchronize its + clock with a reliable external standard. + + Clients SHOULD only send a Date header field in messages that include + an entity-body, as in the case of the PUT and POST requests, and even + then it is optional. A client without a clock MUST NOT send a Date + header field in a request. + + The HTTP-date sent in a Date header SHOULD NOT represent a date and + time subsequent to the generation of the message. It SHOULD represent + the best available approximation of the date and time of message + generation, unless the implementation has no means of generating a + reasonably accurate date and time. In theory, the date ought to + represent the moment just before the entity is generated. In + practice, the date can be generated at any time during the message + origination without affecting its semantic value. + +14.18.1 Clockless Origin Server Operation + + Some origin server implementations might not have a clock available. + An origin server without a clock MUST NOT assign Expires or Last- + Modified values to a response, unless these values were associated + with the resource by a system or user with a reliable clock. It MAY + assign an Expires value that is known, at or before server + configuration time, to be in the past (this allows "pre-expiration" + of responses without storing separate Expires values for each + resource). + + + + + + +Fielding, et al. Standards Track [Page 125] + +RFC 2616 HTTP/1.1 June 1999 + + +14.19 ETag + + The ETag response-header field provides the current value of the + entity tag for the requested variant. The headers used with entity + tags are described in sections 14.24, 14.26 and 14.44. The entity tag + MAY be used for comparison with other entities from the same resource + (see section 13.3.3). + + ETag = "ETag" ":" entity-tag + + Examples: + + ETag: "xyzzy" + ETag: W/"xyzzy" + ETag: "" + +14.20 Expect + + The Expect request-header field is used to indicate that particular + server behaviors are required by the client. + + Expect = "Expect" ":" 1#expectation + + expectation = "100-continue" | expectation-extension + expectation-extension = token [ "=" ( token | quoted-string ) + *expect-params ] + expect-params = ";" token [ "=" ( token | quoted-string ) ] + + + A server that does not understand or is unable to comply with any of + the expectation values in the Expect field of a request MUST respond + with appropriate error status. The server MUST respond with a 417 + (Expectation Failed) status if any of the expectations cannot be met + or, if there are other problems with the request, some other 4xx + status. + + This header field is defined with extensible syntax to allow for + future extensions. If a server receives a request containing an + Expect field that includes an expectation-extension that it does not + support, it MUST respond with a 417 (Expectation Failed) status. + + Comparison of expectation values is case-insensitive for unquoted + tokens (including the 100-continue token), and is case-sensitive for + quoted-string expectation-extensions. + + + + + + + +Fielding, et al. Standards Track [Page 126] + +RFC 2616 HTTP/1.1 June 1999 + + + The Expect mechanism is hop-by-hop: that is, an HTTP/1.1 proxy MUST + return a 417 (Expectation Failed) status if it receives a request + with an expectation that it cannot meet. However, the Expect + request-header itself is end-to-end; it MUST be forwarded if the + request is forwarded. + + Many older HTTP/1.0 and HTTP/1.1 applications do not understand the + Expect header. + + See section 8.2.3 for the use of the 100 (continue) status. + +14.21 Expires + + The Expires entity-header field gives the date/time after which the + response is considered stale. A stale cache entry may not normally be + returned by a cache (either a proxy cache or a user agent cache) + unless it is first validated with the origin server (or with an + intermediate cache that has a fresh copy of the entity). See section + 13.2 for further discussion of the expiration model. + + The presence of an Expires field does not imply that the original + resource will change or cease to exist at, before, or after that + time. + + The format is an absolute date and time as defined by HTTP-date in + section 3.3.1; it MUST be in RFC 1123 date format: + + Expires = "Expires" ":" HTTP-date + + An example of its use is + + Expires: Thu, 01 Dec 1994 16:00:00 GMT + + Note: if a response includes a Cache-Control field with the max- + age directive (see section 14.9.3), that directive overrides the + Expires field. + + HTTP/1.1 clients and caches MUST treat other invalid date formats, + especially including the value "0", as in the past (i.e., "already + expired"). + + To mark a response as "already expired," an origin server sends an + Expires date that is equal to the Date header value. (See the rules + for expiration calculations in section 13.2.4.) + + + + + + + +Fielding, et al. Standards Track [Page 127] + +RFC 2616 HTTP/1.1 June 1999 + + + To mark a response as "never expires," an origin server sends an + Expires date approximately one year from the time the response is + sent. HTTP/1.1 servers SHOULD NOT send Expires dates more than one + year in the future. + + The presence of an Expires header field with a date value of some + time in the future on a response that otherwise would by default be + non-cacheable indicates that the response is cacheable, unless + indicated otherwise by a Cache-Control header field (section 14.9). + +14.22 From + + The From request-header field, if given, SHOULD contain an Internet + e-mail address for the human user who controls the requesting user + agent. The address SHOULD be machine-usable, as defined by "mailbox" + in RFC 822 [9] as updated by RFC 1123 [8]: + + From = "From" ":" mailbox + + An example is: + + From: webmaster@w3.org + + This header field MAY be used for logging purposes and as a means for + identifying the source of invalid or unwanted requests. It SHOULD NOT + be used as an insecure form of access protection. The interpretation + of this field is that the request is being performed on behalf of the + person given, who accepts responsibility for the method performed. In + particular, robot agents SHOULD include this header so that the + person responsible for running the robot can be contacted if problems + occur on the receiving end. + + The Internet e-mail address in this field MAY be separate from the + Internet host which issued the request. For example, when a request + is passed through a proxy the original issuer's address SHOULD be + used. + + The client SHOULD NOT send the From header field without the user's + approval, as it might conflict with the user's privacy interests or + their site's security policy. It is strongly recommended that the + user be able to disable, enable, and modify the value of this field + at any time prior to a request. + +14.23 Host + + The Host request-header field specifies the Internet host and port + number of the resource being requested, as obtained from the original + URI given by the user or referring resource (generally an HTTP URL, + + + +Fielding, et al. Standards Track [Page 128] + +RFC 2616 HTTP/1.1 June 1999 + + + as described in section 3.2.2). The Host field value MUST represent + the naming authority of the origin server or gateway given by the + original URL. This allows the origin server or gateway to + differentiate between internally-ambiguous URLs, such as the root "/" + URL of a server for multiple host names on a single IP address. + + Host = "Host" ":" host [ ":" port ] ; Section 3.2.2 + + A "host" without any trailing port information implies the default + port for the service requested (e.g., "80" for an HTTP URL). For + example, a request on the origin server for + would properly include: + + GET /pub/WWW/ HTTP/1.1 + Host: www.w3.org + + A client MUST include a Host header field in all HTTP/1.1 request + messages . If the requested URI does not include an Internet host + name for the service being requested, then the Host header field MUST + be given with an empty value. An HTTP/1.1 proxy MUST ensure that any + request message it forwards does contain an appropriate Host header + field that identifies the service being requested by the proxy. All + Internet-based HTTP/1.1 servers MUST respond with a 400 (Bad Request) + status code to any HTTP/1.1 request message which lacks a Host header + field. + + See sections 5.2 and 19.6.1.1 for other requirements relating to + Host. + +14.24 If-Match + + The If-Match request-header field is used with a method to make it + conditional. A client that has one or more entities previously + obtained from the resource can verify that one of those entities is + current by including a list of their associated entity tags in the + If-Match header field. Entity tags are defined in section 3.11. The + purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. It is also + used, on updating requests, to prevent inadvertent modification of + the wrong version of a resource. As a special case, the value "*" + matches any current entity of the resource. + + If-Match = "If-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-Match header) on that resource, or if "*" is given + + + + +Fielding, et al. Standards Track [Page 129] + +RFC 2616 HTTP/1.1 June 1999 + + + and any current entity exists for that resource, then the server MAY + perform the requested method as if the If-Match header field did not + exist. + + A server MUST use the strong comparison function (see section 13.3.3) + to compare the entity tags in If-Match. + + If none of the entity tags match, or if "*" is given and no current + entity exists, the server MUST NOT perform the requested method, and + MUST return a 412 (Precondition Failed) response. This behavior is + most useful when the client wants to prevent an updating method, such + as PUT, from modifying a resource that has changed since the client + last retrieved it. + + If the request would, without the If-Match header field, result in + anything other than a 2xx or 412 status, then the If-Match header + MUST be ignored. + + The meaning of "If-Match: *" is that the method SHOULD be performed + if the representation selected by the origin server (or by a cache, + possibly using the Vary mechanism, see section 14.44) exists, and + MUST NOT be performed if the representation does not exist. + + A request intended to update a resource (e.g., a PUT) MAY include an + If-Match header field to signal that the request method MUST NOT be + applied if the entity corresponding to the If-Match value (a single + entity tag) is no longer a representation of that resource. This + allows the user to indicate that they do not wish the request to be + successful if the resource has been changed without their knowledge. + Examples: + + If-Match: "xyzzy" + If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-Match: * + + The result of a request having both an If-Match header field and + either an If-None-Match or an If-Modified-Since header fields is + undefined by this specification. + +14.25 If-Modified-Since + + The If-Modified-Since request-header field is used with a method to + make it conditional: if the requested variant has not been modified + since the time specified in this field, an entity will not be + returned from the server; instead, a 304 (not modified) response will + be returned without any message-body. + + If-Modified-Since = "If-Modified-Since" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 130] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of the field is: + + If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + A GET method with an If-Modified-Since header and no Range header + requests that the identified entity be transferred only if it has + been modified since the date given by the If-Modified-Since header. + The algorithm for determining this includes the following cases: + + a) If the request would normally result in anything other than a + 200 (OK) status, or if the passed If-Modified-Since date is + invalid, the response is exactly the same as for a normal GET. + A date which is later than the server's current time is + invalid. + + b) If the variant has been modified since the If-Modified-Since + date, the response is exactly the same as for a normal GET. + + c) If the variant has not been modified since a valid If- + Modified-Since date, the server SHOULD return a 304 (Not + Modified) response. + + The purpose of this feature is to allow efficient updates of cached + information with a minimum amount of transaction overhead. + + Note: The Range request-header field modifies the meaning of If- + Modified-Since; see section 14.35 for full details. + + Note: If-Modified-Since times are interpreted by the server, whose + clock might not be synchronized with the client. + + Note: When handling an If-Modified-Since header field, some + servers will use an exact date comparison function, rather than a + less-than function, for deciding whether to send a 304 (Not + Modified) response. To get best results when sending an If- + Modified-Since header field for cache validation, clients are + advised to use the exact date string received in a previous Last- + Modified header field whenever possible. + + Note: If a client uses an arbitrary date in the If-Modified-Since + header instead of a date taken from the Last-Modified header for + the same request, the client should be aware of the fact that this + date is interpreted in the server's understanding of time. The + client should consider unsynchronized clocks and rounding problems + due to the different encodings of time between the client and + server. This includes the possibility of race conditions if the + document has changed between the time it was first requested and + the If-Modified-Since date of a subsequent request, and the + + + +Fielding, et al. Standards Track [Page 131] + +RFC 2616 HTTP/1.1 June 1999 + + + possibility of clock-skew-related problems if the If-Modified- + Since date is derived from the client's clock without correction + to the server's clock. Corrections for different time bases + between client and server are at best approximate due to network + latency. + + The result of a request having both an If-Modified-Since header field + and either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.26 If-None-Match + + The If-None-Match request-header field is used with a method to make + it conditional. A client that has one or more entities previously + obtained from the resource can verify that none of those entities is + current by including a list of their associated entity tags in the + If-None-Match header field. The purpose of this feature is to allow + efficient updates of cached information with a minimum amount of + transaction overhead. It is also used to prevent a method (e.g. PUT) + from inadvertently modifying an existing resource when the client + believes that the resource does not exist. + + As a special case, the value "*" matches any current entity of the + resource. + + If-None-Match = "If-None-Match" ":" ( "*" | 1#entity-tag ) + + If any of the entity tags match the entity tag of the entity that + would have been returned in the response to a similar GET request + (without the If-None-Match header) on that resource, or if "*" is + given and any current entity exists for that resource, then the + server MUST NOT perform the requested method, unless required to do + so because the resource's modification date fails to match that + supplied in an If-Modified-Since header field in the request. + Instead, if the request method was GET or HEAD, the server SHOULD + respond with a 304 (Not Modified) response, including the cache- + related header fields (particularly ETag) of one of the entities that + matched. For all other request methods, the server MUST respond with + a status of 412 (Precondition Failed). + + See section 13.3.3 for rules on how to determine if two entities tags + match. The weak comparison function can only be used with GET or HEAD + requests. + + + + + + + + +Fielding, et al. Standards Track [Page 132] + +RFC 2616 HTTP/1.1 June 1999 + + + If none of the entity tags match, then the server MAY perform the + requested method as if the If-None-Match header field did not exist, + but MUST also ignore any If-Modified-Since header field(s) in the + request. That is, if no entity tags match, then the server MUST NOT + return a 304 (Not Modified) response. + + If the request would, without the If-None-Match header field, result + in anything other than a 2xx or 304 status, then the If-None-Match + header MUST be ignored. (See section 13.3.4 for a discussion of + server behavior when both If-Modified-Since and If-None-Match appear + in the same request.) + + The meaning of "If-None-Match: *" is that the method MUST NOT be + performed if the representation selected by the origin server (or by + a cache, possibly using the Vary mechanism, see section 14.44) + exists, and SHOULD be performed if the representation does not exist. + This feature is intended to be useful in preventing races between PUT + operations. + + Examples: + + If-None-Match: "xyzzy" + If-None-Match: W/"xyzzy" + If-None-Match: "xyzzy", "r2d2xxxx", "c3piozzzz" + If-None-Match: W/"xyzzy", W/"r2d2xxxx", W/"c3piozzzz" + If-None-Match: * + + The result of a request having both an If-None-Match header field and + either an If-Match or an If-Unmodified-Since header fields is + undefined by this specification. + +14.27 If-Range + + If a client has a partial copy of an entity in its cache, and wishes + to have an up-to-date copy of the entire entity in its cache, it + could use the Range request-header with a conditional GET (using + either or both of If-Unmodified-Since and If-Match.) However, if the + condition fails because the entity has been modified, the client + would then have to make a second request to obtain the entire current + entity-body. + + The If-Range header allows a client to "short-circuit" the second + request. Informally, its meaning is `if the entity is unchanged, send + me the part(s) that I am missing; otherwise, send me the entire new + entity'. + + If-Range = "If-Range" ":" ( entity-tag | HTTP-date ) + + + + +Fielding, et al. Standards Track [Page 133] + +RFC 2616 HTTP/1.1 June 1999 + + + If the client has no entity tag for an entity, but does have a Last- + Modified date, it MAY use that date in an If-Range header. (The + server can distinguish between a valid HTTP-date and any form of + entity-tag by examining no more than two characters.) The If-Range + header SHOULD only be used together with a Range header, and MUST be + ignored if the request does not include a Range header, or if the + server does not support the sub-range operation. + + If the entity tag given in the If-Range header matches the current + entity tag for the entity, then the server SHOULD provide the + specified sub-range of the entity using a 206 (Partial content) + response. If the entity tag does not match, then the server SHOULD + return the entire entity using a 200 (OK) response. + +14.28 If-Unmodified-Since + + The If-Unmodified-Since request-header field is used with a method to + make it conditional. If the requested resource has not been modified + since the time specified in this field, the server SHOULD perform the + requested operation as if the If-Unmodified-Since header were not + present. + + If the requested variant has been modified since the specified time, + the server MUST NOT perform the requested operation, and MUST return + a 412 (Precondition Failed). + + If-Unmodified-Since = "If-Unmodified-Since" ":" HTTP-date + + An example of the field is: + + If-Unmodified-Since: Sat, 29 Oct 1994 19:43:31 GMT + + If the request normally (i.e., without the If-Unmodified-Since + header) would result in anything other than a 2xx or 412 status, the + If-Unmodified-Since header SHOULD be ignored. + + If the specified date is invalid, the header is ignored. + + The result of a request having both an If-Unmodified-Since header + field and either an If-None-Match or an If-Modified-Since header + fields is undefined by this specification. + +14.29 Last-Modified + + The Last-Modified entity-header field indicates the date and time at + which the origin server believes the variant was last modified. + + Last-Modified = "Last-Modified" ":" HTTP-date + + + +Fielding, et al. Standards Track [Page 134] + +RFC 2616 HTTP/1.1 June 1999 + + + An example of its use is + + Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT + + The exact meaning of this header field depends on the implementation + of the origin server and the nature of the original resource. For + files, it may be just the file system last-modified time. For + entities with dynamically included parts, it may be the most recent + of the set of last-modify times for its component parts. For database + gateways, it may be the last-update time stamp of the record. For + virtual objects, it may be the last time the internal state changed. + + An origin server MUST NOT send a Last-Modified date which is later + than the server's time of message origination. In such cases, where + the resource's last modification would indicate some time in the + future, the server MUST replace that date with the message + origination date. + + An origin server SHOULD obtain the Last-Modified value of the entity + as close as possible to the time that it generates the Date value of + its response. This allows a recipient to make an accurate assessment + of the entity's modification time, especially if the entity changes + near the time that the response is generated. + + HTTP/1.1 servers SHOULD send Last-Modified whenever feasible. + +14.30 Location + + The Location response-header field is used to redirect the recipient + to a location other than the Request-URI for completion of the + request or identification of a new resource. For 201 (Created) + responses, the Location is that of the new resource which was created + by the request. For 3xx responses, the location SHOULD indicate the + server's preferred URI for automatic redirection to the resource. The + field value consists of a single absolute URI. + + Location = "Location" ":" absoluteURI + + An example is: + + Location: http://www.w3.org/pub/WWW/People.html + + Note: The Content-Location header field (section 14.14) differs + from Location in that the Content-Location identifies the original + location of the entity enclosed in the request. It is therefore + possible for a response to contain header fields for both Location + and Content-Location. Also see section 13.10 for cache + requirements of some methods. + + + +Fielding, et al. Standards Track [Page 135] + +RFC 2616 HTTP/1.1 June 1999 + + +14.31 Max-Forwards + + The Max-Forwards request-header field provides a mechanism with the + TRACE (section 9.8) and OPTIONS (section 9.2) methods to limit the + number of proxies or gateways that can forward the request to the + next inbound server. This can be useful when the client is attempting + to trace a request chain which appears to be failing or looping in + mid-chain. + + Max-Forwards = "Max-Forwards" ":" 1*DIGIT + + The Max-Forwards value is a decimal integer indicating the remaining + number of times this request message may be forwarded. + + Each proxy or gateway recipient of a TRACE or OPTIONS request + containing a Max-Forwards header field MUST check and update its + value prior to forwarding the request. If the received value is zero + (0), the recipient MUST NOT forward the request; instead, it MUST + respond as the final recipient. If the received Max-Forwards value is + greater than zero, then the forwarded message MUST contain an updated + Max-Forwards field with a value decremented by one (1). + + The Max-Forwards header field MAY be ignored for all other methods + defined by this specification and for any extension methods for which + it is not explicitly referred to as part of that method definition. + +14.32 Pragma + + The Pragma general-header field is used to include implementation- + specific directives that might apply to any recipient along the + request/response chain. All pragma directives specify optional + behavior from the viewpoint of the protocol; however, some systems + MAY require that behavior be consistent with the directives. + + Pragma = "Pragma" ":" 1#pragma-directive + pragma-directive = "no-cache" | extension-pragma + extension-pragma = token [ "=" ( token | quoted-string ) ] + + When the no-cache directive is present in a request message, an + application SHOULD forward the request toward the origin server even + if it has a cached copy of what is being requested. This pragma + directive has the same semantics as the no-cache cache-directive (see + section 14.9) and is defined here for backward compatibility with + HTTP/1.0. Clients SHOULD include both header fields when a no-cache + request is sent to a server not known to be HTTP/1.1 compliant. + + + + + + +Fielding, et al. Standards Track [Page 136] + +RFC 2616 HTTP/1.1 June 1999 + + + Pragma directives MUST be passed through by a proxy or gateway + application, regardless of their significance to that application, + since the directives might be applicable to all recipients along the + request/response chain. It is not possible to specify a pragma for a + specific recipient; however, any pragma directive not relevant to a + recipient SHOULD be ignored by that recipient. + + HTTP/1.1 caches SHOULD treat "Pragma: no-cache" as if the client had + sent "Cache-Control: no-cache". No new Pragma directives will be + defined in HTTP. + + Note: because the meaning of "Pragma: no-cache as a response + header field is not actually specified, it does not provide a + reliable replacement for "Cache-Control: no-cache" in a response + +14.33 Proxy-Authenticate + + The Proxy-Authenticate response-header field MUST be included as part + of a 407 (Proxy Authentication Required) response. The field value + consists of a challenge that indicates the authentication scheme and + parameters applicable to the proxy for this Request-URI. + + Proxy-Authenticate = "Proxy-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. Unlike + WWW-Authenticate, the Proxy-Authenticate header field applies only to + the current connection and SHOULD NOT be passed on to downstream + clients. However, an intermediate proxy might need to obtain its own + credentials by requesting them from the downstream client, which in + some circumstances will appear as if the proxy is forwarding the + Proxy-Authenticate header field. + +14.34 Proxy-Authorization + + The Proxy-Authorization request-header field allows the client to + identify itself (or its user) to a proxy which requires + authentication. The Proxy-Authorization field value consists of + credentials containing the authentication information of the user + agent for the proxy and/or realm of the resource being requested. + + Proxy-Authorization = "Proxy-Authorization" ":" credentials + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43] . Unlike + Authorization, the Proxy-Authorization header field applies only to + the next outbound proxy that demanded authentication using the Proxy- + Authenticate field. When multiple proxies are used in a chain, the + + + +Fielding, et al. Standards Track [Page 137] + +RFC 2616 HTTP/1.1 June 1999 + + + Proxy-Authorization header field is consumed by the first outbound + proxy that was expecting to receive credentials. A proxy MAY relay + the credentials from the client request to the next proxy if that is + the mechanism by which the proxies cooperatively authenticate a given + request. + +14.35 Range + +14.35.1 Byte Ranges + + Since all HTTP entities are represented in HTTP messages as sequences + of bytes, the concept of a byte range is meaningful for any HTTP + entity. (However, not all clients and servers need to support byte- + range operations.) + + Byte range specifications in HTTP apply to the sequence of bytes in + the entity-body (not necessarily the same as the message-body). + + A byte range operation MAY specify a single range of bytes, or a set + of ranges within a single entity. + + ranges-specifier = byte-ranges-specifier + byte-ranges-specifier = bytes-unit "=" byte-range-set + byte-range-set = 1#( byte-range-spec | suffix-byte-range-spec ) + byte-range-spec = first-byte-pos "-" [last-byte-pos] + first-byte-pos = 1*DIGIT + last-byte-pos = 1*DIGIT + + The first-byte-pos value in a byte-range-spec gives the byte-offset + of the first byte in a range. The last-byte-pos value gives the + byte-offset of the last byte in the range; that is, the byte + positions specified are inclusive. Byte offsets start at zero. + + If the last-byte-pos value is present, it MUST be greater than or + equal to the first-byte-pos in that byte-range-spec, or the byte- + range-spec is syntactically invalid. The recipient of a byte-range- + set that includes one or more syntactically invalid byte-range-spec + values MUST ignore the header field that includes that byte-range- + set. + + If the last-byte-pos value is absent, or if the value is greater than + or equal to the current length of the entity-body, last-byte-pos is + taken to be equal to one less than the current length of the entity- + body in bytes. + + By its choice of last-byte-pos, a client can limit the number of + bytes retrieved without knowing the size of the entity. + + + + +Fielding, et al. Standards Track [Page 138] + +RFC 2616 HTTP/1.1 June 1999 + + + suffix-byte-range-spec = "-" suffix-length + suffix-length = 1*DIGIT + + A suffix-byte-range-spec is used to specify the suffix of the + entity-body, of a length given by the suffix-length value. (That is, + this form specifies the last N bytes of an entity-body.) If the + entity is shorter than the specified suffix-length, the entire + entity-body is used. + + If a syntactically valid byte-range-set includes at least one byte- + range-spec whose first-byte-pos is less than the current length of + the entity-body, or at least one suffix-byte-range-spec with a non- + zero suffix-length, then the byte-range-set is satisfiable. + Otherwise, the byte-range-set is unsatisfiable. If the byte-range-set + is unsatisfiable, the server SHOULD return a response with a status + of 416 (Requested range not satisfiable). Otherwise, the server + SHOULD return a response with a status of 206 (Partial Content) + containing the satisfiable ranges of the entity-body. + + Examples of byte-ranges-specifier values (assuming an entity-body of + length 10000): + + - The first 500 bytes (byte offsets 0-499, inclusive): bytes=0- + 499 + + - The second 500 bytes (byte offsets 500-999, inclusive): + bytes=500-999 + + - The final 500 bytes (byte offsets 9500-9999, inclusive): + bytes=-500 + + - Or bytes=9500- + + - The first and last bytes only (bytes 0 and 9999): bytes=0-0,-1 + + - Several legal but not canonical specifications of the second 500 + bytes (byte offsets 500-999, inclusive): + bytes=500-600,601-999 + bytes=500-700,601-999 + +14.35.2 Range Retrieval Requests + + HTTP retrieval requests using conditional or unconditional GET + methods MAY request one or more sub-ranges of the entity, instead of + the entire entity, using the Range request header, which applies to + the entity returned as the result of the request: + + Range = "Range" ":" ranges-specifier + + + +Fielding, et al. Standards Track [Page 139] + +RFC 2616 HTTP/1.1 June 1999 + + + A server MAY ignore the Range header. However, HTTP/1.1 origin + servers and intermediate caches ought to support byte ranges when + possible, since Range supports efficient recovery from partially + failed transfers, and supports efficient partial retrieval of large + entities. + + If the server supports the Range header and the specified range or + ranges are appropriate for the entity: + + - The presence of a Range header in an unconditional GET modifies + what is returned if the GET is otherwise successful. In other + words, the response carries a status code of 206 (Partial + Content) instead of 200 (OK). + + - The presence of a Range header in a conditional GET (a request + using one or both of If-Modified-Since and If-None-Match, or + one or both of If-Unmodified-Since and If-Match) modifies what + is returned if the GET is otherwise successful and the + condition is true. It does not affect the 304 (Not Modified) + response returned if the conditional is false. + + In some cases, it might be more appropriate to use the If-Range + header (see section 14.27) in addition to the Range header. + + If a proxy that supports ranges receives a Range request, forwards + the request to an inbound server, and receives an entire entity in + reply, it SHOULD only return the requested range to its client. It + SHOULD store the entire received response in its cache if that is + consistent with its cache allocation policies. + +14.36 Referer + + The Referer[sic] request-header field allows the client to specify, + for the server's benefit, the address (URI) of the resource from + which the Request-URI was obtained (the "referrer", although the + header field is misspelled.) The Referer request-header allows a + server to generate lists of back-links to resources for interest, + logging, optimized caching, etc. It also allows obsolete or mistyped + links to be traced for maintenance. The Referer field MUST NOT be + sent if the Request-URI was obtained from a source that does not have + its own URI, such as input from the user keyboard. + + Referer = "Referer" ":" ( absoluteURI | relativeURI ) + + Example: + + Referer: http://www.w3.org/hypertext/DataSources/Overview.html + + + + +Fielding, et al. Standards Track [Page 140] + +RFC 2616 HTTP/1.1 June 1999 + + + If the field value is a relative URI, it SHOULD be interpreted + relative to the Request-URI. The URI MUST NOT include a fragment. See + section 15.1.3 for security considerations. + +14.37 Retry-After + + The Retry-After response-header field can be used with a 503 (Service + Unavailable) response to indicate how long the service is expected to + be unavailable to the requesting client. This field MAY also be used + with any 3xx (Redirection) response to indicate the minimum time the + user-agent is asked wait before issuing the redirected request. The + value of this field can be either an HTTP-date or an integer number + of seconds (in decimal) after the time of the response. + + Retry-After = "Retry-After" ":" ( HTTP-date | delta-seconds ) + + Two examples of its use are + + Retry-After: Fri, 31 Dec 1999 23:59:59 GMT + Retry-After: 120 + + In the latter example, the delay is 2 minutes. + +14.38 Server + + The Server response-header field contains information about the + software used by the origin server to handle the request. The field + can contain multiple product tokens (section 3.8) and comments + identifying the server and any significant subproducts. The product + tokens are listed in order of their significance for identifying the + application. + + Server = "Server" ":" 1*( product | comment ) + + Example: + + Server: CERN/3.0 libwww/2.17 + + If the response is being forwarded through a proxy, the proxy + application MUST NOT modify the Server response-header. Instead, it + SHOULD include a Via field (as described in section 14.45). + + Note: Revealing the specific software version of the server might + allow the server machine to become more vulnerable to attacks + against software that is known to contain security holes. Server + implementors are encouraged to make this field a configurable + option. + + + + +Fielding, et al. Standards Track [Page 141] + +RFC 2616 HTTP/1.1 June 1999 + + +14.39 TE + + The TE request-header field indicates what extension transfer-codings + it is willing to accept in the response and whether or not it is + willing to accept trailer fields in a chunked transfer-coding. Its + value may consist of the keyword "trailers" and/or a comma-separated + list of extension transfer-coding names with optional accept + parameters (as described in section 3.6). + + TE = "TE" ":" #( t-codings ) + t-codings = "trailers" | ( transfer-extension [ accept-params ] ) + + The presence of the keyword "trailers" indicates that the client is + willing to accept trailer fields in a chunked transfer-coding, as + defined in section 3.6.1. This keyword is reserved for use with + transfer-coding values even though it does not itself represent a + transfer-coding. + + Examples of its use are: + + TE: deflate + TE: + TE: trailers, deflate;q=0.5 + + The TE header field only applies to the immediate connection. + Therefore, the keyword MUST be supplied within a Connection header + field (section 14.10) whenever TE is present in an HTTP/1.1 message. + + A server tests whether a transfer-coding is acceptable, according to + a TE field, using these rules: + + 1. The "chunked" transfer-coding is always acceptable. If the + keyword "trailers" is listed, the client indicates that it is + willing to accept trailer fields in the chunked response on + behalf of itself and any downstream clients. The implication is + that, if given, the client is stating that either all + downstream clients are willing to accept trailer fields in the + forwarded response, or that it will attempt to buffer the + response on behalf of downstream recipients. + + Note: HTTP/1.1 does not define any means to limit the size of a + chunked response such that a client can be assured of buffering + the entire response. + + 2. If the transfer-coding being tested is one of the transfer- + codings listed in the TE field, then it is acceptable unless it + is accompanied by a qvalue of 0. (As defined in section 3.9, a + qvalue of 0 means "not acceptable.") + + + +Fielding, et al. Standards Track [Page 142] + +RFC 2616 HTTP/1.1 June 1999 + + + 3. If multiple transfer-codings are acceptable, then the + acceptable transfer-coding with the highest non-zero qvalue is + preferred. The "chunked" transfer-coding always has a qvalue + of 1. + + If the TE field-value is empty or if no TE field is present, the only + transfer-coding is "chunked". A message with no transfer-coding is + always acceptable. + +14.40 Trailer + + The Trailer general field value indicates that the given set of + header fields is present in the trailer of a message encoded with + chunked transfer-coding. + + Trailer = "Trailer" ":" 1#field-name + + An HTTP/1.1 message SHOULD include a Trailer header field in a + message using chunked transfer-coding with a non-empty trailer. Doing + so allows the recipient to know which header fields to expect in the + trailer. + + If no Trailer header field is present, the trailer SHOULD NOT include + any header fields. See section 3.6.1 for restrictions on the use of + trailer fields in a "chunked" transfer-coding. + + Message header fields listed in the Trailer header field MUST NOT + include the following header fields: + + . Transfer-Encoding + + . Content-Length + + . Trailer + +14.41 Transfer-Encoding + + The Transfer-Encoding general-header field indicates what (if any) + type of transformation has been applied to the message body in order + to safely transfer it between the sender and the recipient. This + differs from the content-coding in that the transfer-coding is a + property of the message, not of the entity. + + Transfer-Encoding = "Transfer-Encoding" ":" 1#transfer-coding + + Transfer-codings are defined in section 3.6. An example is: + + Transfer-Encoding: chunked + + + +Fielding, et al. Standards Track [Page 143] + +RFC 2616 HTTP/1.1 June 1999 + + + If multiple encodings have been applied to an entity, the transfer- + codings MUST be listed in the order in which they were applied. + Additional information about the encoding parameters MAY be provided + by other entity-header fields not defined by this specification. + + Many older HTTP/1.0 applications do not understand the Transfer- + Encoding header. + +14.42 Upgrade + + The Upgrade general-header allows the client to specify what + additional communication protocols it supports and would like to use + if the server finds it appropriate to switch protocols. The server + MUST use the Upgrade header field within a 101 (Switching Protocols) + response to indicate which protocol(s) are being switched. + + Upgrade = "Upgrade" ":" 1#product + + For example, + + Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11 + + The Upgrade header field is intended to provide a simple mechanism + for transition from HTTP/1.1 to some other, incompatible protocol. It + does so by allowing the client to advertise its desire to use another + protocol, such as a later version of HTTP with a higher major version + number, even though the current request has been made using HTTP/1.1. + This eases the difficult transition between incompatible protocols by + allowing the client to initiate a request in the more commonly + supported protocol while indicating to the server that it would like + to use a "better" protocol if available (where "better" is determined + by the server, possibly according to the nature of the method and/or + resource being requested). + + The Upgrade header field only applies to switching application-layer + protocols upon the existing transport-layer connection. Upgrade + cannot be used to insist on a protocol change; its acceptance and use + by the server is optional. The capabilities and nature of the + application-layer communication after the protocol change is entirely + dependent upon the new protocol chosen, although the first action + after changing the protocol MUST be a response to the initial HTTP + request containing the Upgrade header field. + + The Upgrade header field only applies to the immediate connection. + Therefore, the upgrade keyword MUST be supplied within a Connection + header field (section 14.10) whenever Upgrade is present in an + HTTP/1.1 message. + + + + +Fielding, et al. Standards Track [Page 144] + +RFC 2616 HTTP/1.1 June 1999 + + + The Upgrade header field cannot be used to indicate a switch to a + protocol on a different connection. For that purpose, it is more + appropriate to use a 301, 302, 303, or 305 redirection response. + + This specification only defines the protocol name "HTTP" for use by + the family of Hypertext Transfer Protocols, as defined by the HTTP + version rules of section 3.1 and future updates to this + specification. Any token can be used as a protocol name; however, it + will only be useful if both the client and server associate the name + with the same protocol. + +14.43 User-Agent + + The User-Agent request-header field contains information about the + user agent originating the request. This is for statistical purposes, + the tracing of protocol violations, and automated recognition of user + agents for the sake of tailoring responses to avoid particular user + agent limitations. User agents SHOULD include this field with + requests. The field can contain multiple product tokens (section 3.8) + and comments identifying the agent and any subproducts which form a + significant part of the user agent. By convention, the product tokens + are listed in order of their significance for identifying the + application. + + User-Agent = "User-Agent" ":" 1*( product | comment ) + + Example: + + User-Agent: CERN-LineMode/2.15 libwww/2.17b3 + +14.44 Vary + + The Vary field value indicates the set of request-header fields that + fully determines, while the response is fresh, whether a cache is + permitted to use the response to reply to a subsequent request + without revalidation. For uncacheable or stale responses, the Vary + field value advises the user agent about the criteria that were used + to select the representation. A Vary field value of "*" implies that + a cache cannot determine from the request headers of a subsequent + request whether this response is the appropriate representation. See + section 13.6 for use of the Vary header field by caches. + + Vary = "Vary" ":" ( "*" | 1#field-name ) + + An HTTP/1.1 server SHOULD include a Vary header field with any + cacheable response that is subject to server-driven negotiation. + Doing so allows a cache to properly interpret future requests on that + resource and informs the user agent about the presence of negotiation + + + +Fielding, et al. Standards Track [Page 145] + +RFC 2616 HTTP/1.1 June 1999 + + + on that resource. A server MAY include a Vary header field with a + non-cacheable response that is subject to server-driven negotiation, + since this might provide the user agent with useful information about + the dimensions over which the response varies at the time of the + response. + + A Vary field value consisting of a list of field-names signals that + the representation selected for the response is based on a selection + algorithm which considers ONLY the listed request-header field values + in selecting the most appropriate representation. A cache MAY assume + that the same selection will be made for future requests with the + same values for the listed field names, for the duration of time for + which the response is fresh. + + The field-names given are not limited to the set of standard + request-header fields defined by this specification. Field names are + case-insensitive. + + A Vary field value of "*" signals that unspecified parameters not + limited to the request-headers (e.g., the network address of the + client), play a role in the selection of the response representation. + The "*" value MUST NOT be generated by a proxy server; it may only be + generated by an origin server. + +14.45 Via + + The Via general-header field MUST be used by gateways and proxies to + indicate the intermediate protocols and recipients between the user + agent and the server on requests, and between the origin server and + the client on responses. It is analogous to the "Received" field of + RFC 822 [9] and is intended to be used for tracking message forwards, + avoiding request loops, and identifying the protocol capabilities of + all senders along the request/response chain. + + Via = "Via" ":" 1#( received-protocol received-by [ comment ] ) + received-protocol = [ protocol-name "/" ] protocol-version + protocol-name = token + protocol-version = token + received-by = ( host [ ":" port ] ) | pseudonym + pseudonym = token + + The received-protocol indicates the protocol version of the message + received by the server or client along each segment of the + request/response chain. The received-protocol version is appended to + the Via field value when the message is forwarded so that information + about the protocol capabilities of upstream applications remains + visible to all recipients. + + + + +Fielding, et al. Standards Track [Page 146] + +RFC 2616 HTTP/1.1 June 1999 + + + The protocol-name is optional if and only if it would be "HTTP". The + received-by field is normally the host and optional port number of a + recipient server or client that subsequently forwarded the message. + However, if the real host is considered to be sensitive information, + it MAY be replaced by a pseudonym. If the port is not given, it MAY + be assumed to be the default port of the received-protocol. + + Multiple Via field values represents each proxy or gateway that has + forwarded the message. Each recipient MUST append its information + such that the end result is ordered according to the sequence of + forwarding applications. + + Comments MAY be used in the Via header field to identify the software + of the recipient proxy or gateway, analogous to the User-Agent and + Server header fields. However, all comments in the Via field are + optional and MAY be removed by any recipient prior to forwarding the + message. + + For example, a request message could be sent from an HTTP/1.0 user + agent to an internal proxy code-named "fred", which uses HTTP/1.1 to + forward the request to a public proxy at nowhere.com, which completes + the request by forwarding it to the origin server at www.ics.uci.edu. + The request received by www.ics.uci.edu would then have the following + Via header field: + + Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1) + + Proxies and gateways used as a portal through a network firewall + SHOULD NOT, by default, forward the names and ports of hosts within + the firewall region. This information SHOULD only be propagated if + explicitly enabled. If not enabled, the received-by host of any host + behind the firewall SHOULD be replaced by an appropriate pseudonym + for that host. + + For organizations that have strong privacy requirements for hiding + internal structures, a proxy MAY combine an ordered subsequence of + Via header field entries with identical received-protocol values into + a single such entry. For example, + + Via: 1.0 ricky, 1.1 ethel, 1.1 fred, 1.0 lucy + + could be collapsed to + + Via: 1.0 ricky, 1.1 mertz, 1.0 lucy + + + + + + + +Fielding, et al. Standards Track [Page 147] + +RFC 2616 HTTP/1.1 June 1999 + + + Applications SHOULD NOT combine multiple entries unless they are all + under the same organizational control and the hosts have already been + replaced by pseudonyms. Applications MUST NOT combine entries which + have different received-protocol values. + +14.46 Warning + + The Warning general-header field is used to carry additional + information about the status or transformation of a message which + might not be reflected in the message. This information is typically + used to warn about a possible lack of semantic transparency from + caching operations or transformations applied to the entity body of + the message. + + Warning headers are sent with responses using: + + Warning = "Warning" ":" 1#warning-value + + warning-value = warn-code SP warn-agent SP warn-text + [SP warn-date] + + warn-code = 3DIGIT + warn-agent = ( host [ ":" port ] ) | pseudonym + ; the name or pseudonym of the server adding + ; the Warning header, for use in debugging + warn-text = quoted-string + warn-date = <"> HTTP-date <"> + + A response MAY carry more than one Warning header. + + The warn-text SHOULD be in a natural language and character set that + is most likely to be intelligible to the human user receiving the + response. This decision MAY be based on any available knowledge, such + as the location of the cache or user, the Accept-Language field in a + request, the Content-Language field in a response, etc. The default + language is English and the default character set is ISO-8859-1. + + If a character set other than ISO-8859-1 is used, it MUST be encoded + in the warn-text using the method described in RFC 2047 [14]. + + Warning headers can in general be applied to any message, however + some specific warn-codes are specific to caches and can only be + applied to response messages. New Warning headers SHOULD be added + after any existing Warning headers. A cache MUST NOT delete any + Warning header that it received with a message. However, if a cache + successfully validates a cache entry, it SHOULD remove any Warning + headers previously attached to that entry except as specified for + + + + +Fielding, et al. Standards Track [Page 148] + +RFC 2616 HTTP/1.1 June 1999 + + + specific Warning codes. It MUST then add any Warning headers received + in the validating response. In other words, Warning headers are those + that would be attached to the most recent relevant response. + + When multiple Warning headers are attached to a response, the user + agent ought to inform the user of as many of them as possible, in the + order that they appear in the response. If it is not possible to + inform the user of all of the warnings, the user agent SHOULD follow + these heuristics: + + - Warnings that appear early in the response take priority over + those appearing later in the response. + + - Warnings in the user's preferred character set take priority + over warnings in other character sets but with identical warn- + codes and warn-agents. + + Systems that generate multiple Warning headers SHOULD order them with + this user agent behavior in mind. + + Requirements for the behavior of caches with respect to Warnings are + stated in section 13.1.2. + + This is a list of the currently-defined warn-codes, each with a + recommended warn-text in English, and a description of its meaning. + + 110 Response is stale + MUST be included whenever the returned response is stale. + + 111 Revalidation failed + MUST be included if a cache returns a stale response because an + attempt to revalidate the response failed, due to an inability to + reach the server. + + 112 Disconnected operation + SHOULD be included if the cache is intentionally disconnected from + the rest of the network for a period of time. + + 113 Heuristic expiration + MUST be included if the cache heuristically chose a freshness + lifetime greater than 24 hours and the response's age is greater + than 24 hours. + + 199 Miscellaneous warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action, besides presenting the warning to + the user. + + + +Fielding, et al. Standards Track [Page 149] + +RFC 2616 HTTP/1.1 June 1999 + + + 214 Transformation applied + MUST be added by an intermediate cache or proxy if it applies any + transformation changing the content-coding (as specified in the + Content-Encoding header) or media-type (as specified in the + Content-Type header) of the response, or the entity-body of the + response, unless this Warning code already appears in the response. + + 299 Miscellaneous persistent warning + The warning text MAY include arbitrary information to be presented + to a human user, or logged. A system receiving this warning MUST + NOT take any automated action. + + If an implementation sends a message with one or more Warning headers + whose version is HTTP/1.0 or lower, then the sender MUST include in + each warning-value a warn-date that matches the date in the response. + + If an implementation receives a message with a warning-value that + includes a warn-date, and that warn-date is different from the Date + value in the response, then that warning-value MUST be deleted from + the message before storing, forwarding, or using it. (This prevents + bad consequences of naive caching of Warning header fields.) If all + of the warning-values are deleted for this reason, the Warning header + MUST be deleted as well. + +14.47 WWW-Authenticate + + The WWW-Authenticate response-header field MUST be included in 401 + (Unauthorized) response messages. The field value consists of at + least one challenge that indicates the authentication scheme(s) and + parameters applicable to the Request-URI. + + WWW-Authenticate = "WWW-Authenticate" ":" 1#challenge + + The HTTP access authentication process is described in "HTTP + Authentication: Basic and Digest Access Authentication" [43]. User + agents are advised to take special care in parsing the WWW- + Authenticate field value as it might contain more than one challenge, + or if more than one WWW-Authenticate header field is provided, the + contents of a challenge itself can contain a comma-separated list of + authentication parameters. + +15 Security Considerations + + This section is meant to inform application developers, information + providers, and users of the security limitations in HTTP/1.1 as + described by this document. The discussion does not include + definitive solutions to the problems revealed, though it does make + some suggestions for reducing security risks. + + + +Fielding, et al. Standards Track [Page 150] + +RFC 2616 HTTP/1.1 June 1999 + + +15.1 Personal Information + + HTTP clients are often privy to large amounts of personal information + (e.g. the user's name, location, mail address, passwords, encryption + keys, etc.), and SHOULD be very careful to prevent unintentional + leakage of this information via the HTTP protocol to other sources. + We very strongly recommend that a convenient interface be provided + for the user to control dissemination of such information, and that + designers and implementors be particularly careful in this area. + History shows that errors in this area often create serious security + and/or privacy problems and generate highly adverse publicity for the + implementor's company. + +15.1.1 Abuse of Server Log Information + + A server is in the position to save personal data about a user's + requests which might identify their reading patterns or subjects of + interest. This information is clearly confidential in nature and its + handling can be constrained by law in certain countries. People using + the HTTP protocol to provide data are responsible for ensuring that + such material is not distributed without the permission of any + individuals that are identifiable by the published results. + +15.1.2 Transfer of Sensitive Information + + Like any generic data transfer protocol, HTTP cannot regulate the + content of the data that is transferred, nor is there any a priori + method of determining the sensitivity of any particular piece of + information within the context of any given request. Therefore, + applications SHOULD supply as much control over this information as + possible to the provider of that information. Four header fields are + worth special mention in this context: Server, Via, Referer and From. + + Revealing the specific software version of the server might allow the + server machine to become more vulnerable to attacks against software + that is known to contain security holes. Implementors SHOULD make the + Server header field a configurable option. + + Proxies which serve as a portal through a network firewall SHOULD + take special precautions regarding the transfer of header information + that identifies the hosts behind the firewall. In particular, they + SHOULD remove, or replace with sanitized versions, any Via fields + generated behind the firewall. + + The Referer header allows reading patterns to be studied and reverse + links drawn. Although it can be very useful, its power can be abused + if user details are not separated from the information contained in + + + + +Fielding, et al. Standards Track [Page 151] + +RFC 2616 HTTP/1.1 June 1999 + + + the Referer. Even when the personal information has been removed, the + Referer header might indicate a private document's URI whose + publication would be inappropriate. + + The information sent in the From field might conflict with the user's + privacy interests or their site's security policy, and hence it + SHOULD NOT be transmitted without the user being able to disable, + enable, and modify the contents of the field. The user MUST be able + to set the contents of this field within a user preference or + application defaults configuration. + + We suggest, though do not require, that a convenient toggle interface + be provided for the user to enable or disable the sending of From and + Referer information. + + The User-Agent (section 14.43) or Server (section 14.38) header + fields can sometimes be used to determine that a specific client or + server have a particular security hole which might be exploited. + Unfortunately, this same information is often used for other valuable + purposes for which HTTP currently has no better mechanism. + +15.1.3 Encoding Sensitive Information in URI's + + Because the source of a link might be private information or might + reveal an otherwise private information source, it is strongly + recommended that the user be able to select whether or not the + Referer field is sent. For example, a browser client could have a + toggle switch for browsing openly/anonymously, which would + respectively enable/disable the sending of Referer and From + information. + + Clients SHOULD NOT include a Referer header field in a (non-secure) + HTTP request if the referring page was transferred with a secure + protocol. + + Authors of services which use the HTTP protocol SHOULD NOT use GET + based forms for the submission of sensitive data, because this will + cause this data to be encoded in the Request-URI. Many existing + servers, proxies, and user agents will log the request URI in some + place where it might be visible to third parties. Servers can use + POST-based form submission instead + +15.1.4 Privacy Issues Connected to Accept Headers + + Accept request-headers can reveal information about the user to all + servers which are accessed. The Accept-Language header in particular + can reveal information the user would consider to be of a private + nature, because the understanding of particular languages is often + + + +Fielding, et al. Standards Track [Page 152] + +RFC 2616 HTTP/1.1 June 1999 + + + strongly correlated to the membership of a particular ethnic group. + User agents which offer the option to configure the contents of an + Accept-Language header to be sent in every request are strongly + encouraged to let the configuration process include a message which + makes the user aware of the loss of privacy involved. + + An approach that limits the loss of privacy would be for a user agent + to omit the sending of Accept-Language headers by default, and to ask + the user whether or not to start sending Accept-Language headers to a + server if it detects, by looking for any Vary response-header fields + generated by the server, that such sending could improve the quality + of service. + + Elaborate user-customized accept header fields sent in every request, + in particular if these include quality values, can be used by servers + as relatively reliable and long-lived user identifiers. Such user + identifiers would allow content providers to do click-trail tracking, + and would allow collaborating content providers to match cross-server + click-trails or form submissions of individual users. Note that for + many users not behind a proxy, the network address of the host + running the user agent will also serve as a long-lived user + identifier. In environments where proxies are used to enhance + privacy, user agents ought to be conservative in offering accept + header configuration options to end users. As an extreme privacy + measure, proxies could filter the accept headers in relayed requests. + General purpose user agents which provide a high degree of header + configurability SHOULD warn users about the loss of privacy which can + be involved. + +15.2 Attacks Based On File and Path Names + + Implementations of HTTP origin servers SHOULD be careful to restrict + the documents returned by HTTP requests to be only those that were + intended by the server administrators. If an HTTP server translates + HTTP URIs directly into file system calls, the server MUST take + special care not to serve files that were not intended to be + delivered to HTTP clients. For example, UNIX, Microsoft Windows, and + other operating systems use ".." as a path component to indicate a + directory level above the current one. On such a system, an HTTP + server MUST disallow any such construct in the Request-URI if it + would otherwise allow access to a resource outside those intended to + be accessible via the HTTP server. Similarly, files intended for + reference only internally to the server (such as access control + files, configuration files, and script code) MUST be protected from + inappropriate retrieval, since they might contain sensitive + information. Experience has shown that minor bugs in such HTTP server + implementations have turned into security risks. + + + + +Fielding, et al. Standards Track [Page 153] + +RFC 2616 HTTP/1.1 June 1999 + + +15.3 DNS Spoofing + + Clients using HTTP rely heavily on the Domain Name Service, and are + thus generally prone to security attacks based on the deliberate + mis-association of IP addresses and DNS names. Clients need to be + cautious in assuming the continuing validity of an IP number/DNS name + association. + + In particular, HTTP clients SHOULD rely on their name resolver for + confirmation of an IP number/DNS name association, rather than + caching the result of previous host name lookups. Many platforms + already can cache host name lookups locally when appropriate, and + they SHOULD be configured to do so. It is proper for these lookups to + be cached, however, only when the TTL (Time To Live) information + reported by the name server makes it likely that the cached + information will remain useful. + + If HTTP clients cache the results of host name lookups in order to + achieve a performance improvement, they MUST observe the TTL + information reported by DNS. + + If HTTP clients do not observe this rule, they could be spoofed when + a previously-accessed server's IP address changes. As network + renumbering is expected to become increasingly common [24], the + possibility of this form of attack will grow. Observing this + requirement thus reduces this potential security vulnerability. + + This requirement also improves the load-balancing behavior of clients + for replicated servers using the same DNS name and reduces the + likelihood of a user's experiencing failure in accessing sites which + use that strategy. + +15.4 Location Headers and Spoofing + + If a single server supports multiple organizations that do not trust + one another, then it MUST check the values of Location and Content- + Location headers in responses that are generated under control of + said organizations to make sure that they do not attempt to + invalidate resources over which they have no authority. + +15.5 Content-Disposition Issues + + RFC 1806 [35], from which the often implemented Content-Disposition + (see section 19.5.1) header in HTTP is derived, has a number of very + serious security considerations. Content-Disposition is not part of + the HTTP standard, but since it is widely implemented, we are + documenting its use and risks for implementors. See RFC 2183 [49] + (which updates RFC 1806) for details. + + + +Fielding, et al. Standards Track [Page 154] + +RFC 2616 HTTP/1.1 June 1999 + + +15.6 Authentication Credentials and Idle Clients + + Existing HTTP clients and user agents typically retain authentication + information indefinitely. HTTP/1.1. does not provide a method for a + server to direct clients to discard these cached credentials. This is + a significant defect that requires further extensions to HTTP. + Circumstances under which credential caching can interfere with the + application's security model include but are not limited to: + + - Clients which have been idle for an extended period following + which the server might wish to cause the client to reprompt the + user for credentials. + + - Applications which include a session termination indication + (such as a `logout' or `commit' button on a page) after which + the server side of the application `knows' that there is no + further reason for the client to retain the credentials. + + This is currently under separate study. There are a number of work- + arounds to parts of this problem, and we encourage the use of + password protection in screen savers, idle time-outs, and other + methods which mitigate the security problems inherent in this + problem. In particular, user agents which cache credentials are + encouraged to provide a readily accessible mechanism for discarding + cached credentials under user control. + +15.7 Proxies and Caching + + By their very nature, HTTP proxies are men-in-the-middle, and + represent an opportunity for man-in-the-middle attacks. Compromise of + the systems on which the proxies run can result in serious security + and privacy problems. Proxies have access to security-related + information, personal information about individual users and + organizations, and proprietary information belonging to users and + content providers. A compromised proxy, or a proxy implemented or + configured without regard to security and privacy considerations, + might be used in the commission of a wide range of potential attacks. + + Proxy operators should protect the systems on which proxies run as + they would protect any system that contains or transports sensitive + information. In particular, log information gathered at proxies often + contains highly sensitive personal information, and/or information + about organizations. Log information should be carefully guarded, and + appropriate guidelines for use developed and followed. (Section + 15.1.1). + + + + + + +Fielding, et al. Standards Track [Page 155] + +RFC 2616 HTTP/1.1 June 1999 + + + Caching proxies provide additional potential vulnerabilities, since + the contents of the cache represent an attractive target for + malicious exploitation. Because cache contents persist after an HTTP + request is complete, an attack on the cache can reveal information + long after a user believes that the information has been removed from + the network. Therefore, cache contents should be protected as + sensitive information. + + Proxy implementors should consider the privacy and security + implications of their design and coding decisions, and of the + configuration options they provide to proxy operators (especially the + default configuration). + + Users of a proxy need to be aware that they are no trustworthier than + the people who run the proxy; HTTP itself cannot solve this problem. + + The judicious use of cryptography, when appropriate, may suffice to + protect against a broad range of security and privacy attacks. Such + cryptography is beyond the scope of the HTTP/1.1 specification. + +15.7.1 Denial of Service Attacks on Proxies + + They exist. They are hard to defend against. Research continues. + Beware. + +16 Acknowledgments + + This specification makes heavy use of the augmented BNF and generic + constructs defined by David H. Crocker for RFC 822 [9]. Similarly, it + reuses many of the definitions provided by Nathaniel Borenstein and + Ned Freed for MIME [7]. We hope that their inclusion in this + specification will help reduce past confusion over the relationship + between HTTP and Internet mail message formats. + + The HTTP protocol has evolved considerably over the years. It has + benefited from a large and active developer community--the many + people who have participated on the www-talk mailing list--and it is + that community which has been most responsible for the success of + HTTP and of the World-Wide Web in general. Marc Andreessen, Robert + Cailliau, Daniel W. Connolly, Bob Denny, John Franks, Jean-Francois + Groff, Phillip M. Hallam-Baker, Hakon W. Lie, Ari Luotonen, Rob + McCool, Lou Montulli, Dave Raggett, Tony Sanders, and Marc + VanHeyningen deserve special recognition for their efforts in + defining early aspects of the protocol. + + This document has benefited greatly from the comments of all those + participating in the HTTP-WG. In addition to those already mentioned, + the following individuals have contributed to this specification: + + + +Fielding, et al. Standards Track [Page 156] + +RFC 2616 HTTP/1.1 June 1999 + + + Gary Adams Ross Patterson + Harald Tveit Alvestrand Albert Lunde + Keith Ball John C. Mallery + Brian Behlendorf Jean-Philippe Martin-Flatin + Paul Burchard Mitra + Maurizio Codogno David Morris + Mike Cowlishaw Gavin Nicol + Roman Czyborra Bill Perry + Michael A. Dolan Jeffrey Perry + David J. Fiander Scott Powers + Alan Freier Owen Rees + Marc Hedlund Luigi Rizzo + Greg Herlihy David Robinson + Koen Holtman Marc Salomon + Alex Hopmann Rich Salz + Bob Jernigan Allan M. Schiffman + Shel Kaphan Jim Seidman + Rohit Khare Chuck Shotton + John Klensin Eric W. Sink + Martijn Koster Simon E. Spero + Alexei Kosut Richard N. Taylor + David M. Kristol Robert S. Thau + Daniel LaLiberte Bill (BearHeart) Weinman + Ben Laurie Francois Yergeau + Paul J. Leach Mary Ellen Zurko + Daniel DuBois Josh Cohen + + + Much of the content and presentation of the caching design is due to + suggestions and comments from individuals including: Shel Kaphan, + Paul Leach, Koen Holtman, David Morris, and Larry Masinter. + + Most of the specification of ranges is based on work originally done + by Ari Luotonen and John Franks, with additional input from Steve + Zilles. + + Thanks to the "cave men" of Palo Alto. You know who you are. + + Jim Gettys (the current editor of this document) wishes particularly + to thank Roy Fielding, the previous editor of this document, along + with John Klensin, Jeff Mogul, Paul Leach, Dave Kristol, Koen + Holtman, John Franks, Josh Cohen, Alex Hopmann, Scott Lawrence, and + Larry Masinter for their help. And thanks go particularly to Jeff + Mogul and Scott Lawrence for performing the "MUST/MAY/SHOULD" audit. + + + + + + + +Fielding, et al. Standards Track [Page 157] + +RFC 2616 HTTP/1.1 June 1999 + + + The Apache Group, Anselm Baird-Smith, author of Jigsaw, and Henrik + Frystyk implemented RFC 2068 early, and we wish to thank them for the + discovery of many of the problems that this document attempts to + rectify. + +17 References + + [1] Alvestrand, H., "Tags for the Identification of Languages", RFC + 1766, March 1995. + + [2] Anklesaria, F., McCahill, M., Lindner, P., Johnson, D., Torrey, + D. and B. Alberti, "The Internet Gopher Protocol (a distributed + document search and retrieval protocol)", RFC 1436, March 1993. + + [3] Berners-Lee, T., "Universal Resource Identifiers in WWW", RFC + 1630, June 1994. + + [4] Berners-Lee, T., Masinter, L. and M. McCahill, "Uniform Resource + Locators (URL)", RFC 1738, December 1994. + + [5] Berners-Lee, T. and D. Connolly, "Hypertext Markup Language - + 2.0", RFC 1866, November 1995. + + [6] Berners-Lee, T., Fielding, R. and H. Frystyk, "Hypertext Transfer + Protocol -- HTTP/1.0", RFC 1945, May 1996. + + [7] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part One: Format of Internet Message Bodies", + RFC 2045, November 1996. + + [8] Braden, R., "Requirements for Internet Hosts -- Communication + Layers", STD 3, RFC 1123, October 1989. + + [9] Crocker, D., "Standard for The Format of ARPA Internet Text + Messages", STD 11, RFC 822, August 1982. + + [10] Davis, F., Kahle, B., Morris, H., Salem, J., Shen, T., Wang, R., + Sui, J., and M. Grinbaum, "WAIS Interface Protocol Prototype + Functional Specification," (v1.5), Thinking Machines + Corporation, April 1990. + + [11] Fielding, R., "Relative Uniform Resource Locators", RFC 1808, + June 1995. + + [12] Horton, M. and R. Adams, "Standard for Interchange of USENET + Messages", RFC 1036, December 1987. + + + + + +Fielding, et al. Standards Track [Page 158] + +RFC 2616 HTTP/1.1 June 1999 + + + [13] Kantor, B. and P. Lapsley, "Network News Transfer Protocol", RFC + 977, February 1986. + + [14] Moore, K., "MIME (Multipurpose Internet Mail Extensions) Part + Three: Message Header Extensions for Non-ASCII Text", RFC 2047, + November 1996. + + [15] Nebel, E. and L. Masinter, "Form-based File Upload in HTML", RFC + 1867, November 1995. + + [16] Postel, J., "Simple Mail Transfer Protocol", STD 10, RFC 821, + August 1982. + + [17] Postel, J., "Media Type Registration Procedure", RFC 1590, + November 1996. + + [18] Postel, J. and J. Reynolds, "File Transfer Protocol", STD 9, RFC + 959, October 1985. + + [19] Reynolds, J. and J. Postel, "Assigned Numbers", STD 2, RFC 1700, + October 1994. + + [20] Sollins, K. and L. Masinter, "Functional Requirements for + Uniform Resource Names", RFC 1737, December 1994. + + [21] US-ASCII. Coded Character Set - 7-Bit American Standard Code for + Information Interchange. Standard ANSI X3.4-1986, ANSI, 1986. + + [22] ISO-8859. International Standard -- Information Processing -- + 8-bit Single-Byte Coded Graphic Character Sets -- + Part 1: Latin alphabet No. 1, ISO-8859-1:1987. + Part 2: Latin alphabet No. 2, ISO-8859-2, 1987. + Part 3: Latin alphabet No. 3, ISO-8859-3, 1988. + Part 4: Latin alphabet No. 4, ISO-8859-4, 1988. + Part 5: Latin/Cyrillic alphabet, ISO-8859-5, 1988. + Part 6: Latin/Arabic alphabet, ISO-8859-6, 1987. + Part 7: Latin/Greek alphabet, ISO-8859-7, 1987. + Part 8: Latin/Hebrew alphabet, ISO-8859-8, 1988. + Part 9: Latin alphabet No. 5, ISO-8859-9, 1990. + + [23] Meyers, J. and M. Rose, "The Content-MD5 Header Field", RFC + 1864, October 1995. + + [24] Carpenter, B. and Y. Rekhter, "Renumbering Needs Work", RFC + 1900, February 1996. + + [25] Deutsch, P., "GZIP file format specification version 4.3", RFC + 1952, May 1996. + + + +Fielding, et al. Standards Track [Page 159] + +RFC 2616 HTTP/1.1 June 1999 + + + [26] Venkata N. Padmanabhan, and Jeffrey C. Mogul. "Improving HTTP + Latency", Computer Networks and ISDN Systems, v. 28, pp. 25-35, + Dec. 1995. Slightly revised version of paper in Proc. 2nd + International WWW Conference '94: Mosaic and the Web, Oct. 1994, + which is available at + http://www.ncsa.uiuc.edu/SDG/IT94/Proceedings/DDay/mogul/HTTPLat + ency.html. + + [27] Joe Touch, John Heidemann, and Katia Obraczka. "Analysis of HTTP + Performance", , + ISI Research Report ISI/RR-98-463, (original report dated Aug. + 1996), USC/Information Sciences Institute, August 1998. + + [28] Mills, D., "Network Time Protocol (Version 3) Specification, + Implementation and Analysis", RFC 1305, March 1992. + + [29] Deutsch, P., "DEFLATE Compressed Data Format Specification + version 1.3", RFC 1951, May 1996. + + [30] S. Spero, "Analysis of HTTP Performance Problems," + http://sunsite.unc.edu/mdma-release/http-prob.html. + + [31] Deutsch, P. and J. Gailly, "ZLIB Compressed Data Format + Specification version 3.3", RFC 1950, May 1996. + + [32] Franks, J., Hallam-Baker, P., Hostetler, J., Leach, P., + Luotonen, A., Sink, E. and L. Stewart, "An Extension to HTTP: + Digest Access Authentication", RFC 2069, January 1997. + + [33] Fielding, R., Gettys, J., Mogul, J., Frystyk, H. and T. + Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1", RFC + 2068, January 1997. + + [34] Bradner, S., "Key words for use in RFCs to Indicate Requirement + Levels", BCP 14, RFC 2119, March 1997. + + [35] Troost, R. and Dorner, S., "Communicating Presentation + Information in Internet Messages: The Content-Disposition + Header", RFC 1806, June 1995. + + [36] Mogul, J., Fielding, R., Gettys, J. and H. Frystyk, "Use and + Interpretation of HTTP Version Numbers", RFC 2145, May 1997. + [jg639] + + [37] Palme, J., "Common Internet Message Headers", RFC 2076, February + 1997. [jg640] + + + + + +Fielding, et al. Standards Track [Page 160] + +RFC 2616 HTTP/1.1 June 1999 + + + [38] Yergeau, F., "UTF-8, a transformation format of Unicode and + ISO-10646", RFC 2279, January 1998. [jg641] + + [39] Nielsen, H.F., Gettys, J., Baird-Smith, A., Prud'hommeaux, E., + Lie, H., and C. Lilley. "Network Performance Effects of + HTTP/1.1, CSS1, and PNG," Proceedings of ACM SIGCOMM '97, Cannes + France, September 1997.[jg642] + + [40] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Two: Media Types", RFC 2046, November + 1996. [jg643] + + [41] Alvestrand, H., "IETF Policy on Character Sets and Languages", + BCP 18, RFC 2277, January 1998. [jg644] + + [42] Berners-Lee, T., Fielding, R. and L. Masinter, "Uniform Resource + Identifiers (URI): Generic Syntax and Semantics", RFC 2396, + August 1998. [jg645] + + [43] Franks, J., Hallam-Baker, P., Hostetler, J., Lawrence, S., + Leach, P., Luotonen, A., Sink, E. and L. Stewart, "HTTP + Authentication: Basic and Digest Access Authentication", RFC + 2617, June 1999. [jg646] + + [44] Luotonen, A., "Tunneling TCP based protocols through Web proxy + servers," Work in Progress. [jg647] + + [45] Palme, J. and A. Hopmann, "MIME E-mail Encapsulation of + Aggregate Documents, such as HTML (MHTML)", RFC 2110, March + 1997. + + [46] Bradner, S., "The Internet Standards Process -- Revision 3", BCP + 9, RFC 2026, October 1996. + + [47] Masinter, L., "Hyper Text Coffee Pot Control Protocol + (HTCPCP/1.0)", RFC 2324, 1 April 1998. + + [48] Freed, N. and N. Borenstein, "Multipurpose Internet Mail + Extensions (MIME) Part Five: Conformance Criteria and Examples", + RFC 2049, November 1996. + + [49] Troost, R., Dorner, S. and K. Moore, "Communicating Presentation + Information in Internet Messages: The Content-Disposition Header + Field", RFC 2183, August 1997. + + + + + + + +Fielding, et al. Standards Track [Page 161] + +RFC 2616 HTTP/1.1 June 1999 + + +18 Authors' Addresses + + Roy T. Fielding + Information and Computer Science + University of California, Irvine + Irvine, CA 92697-3425, USA + + Fax: +1 (949) 824-1715 + EMail: fielding@ics.uci.edu + + + James Gettys + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: jg@w3.org + + + Jeffrey C. Mogul + Western Research Laboratory + Compaq Computer Corporation + 250 University Avenue + Palo Alto, California, 94305, USA + + EMail: mogul@wrl.dec.com + + + Henrik Frystyk Nielsen + World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: frystyk@w3.org + + + Larry Masinter + Xerox Corporation + 3333 Coyote Hill Road + Palo Alto, CA 94034, USA + + EMail: masinter@parc.xerox.com + + + + + +Fielding, et al. Standards Track [Page 162] + +RFC 2616 HTTP/1.1 June 1999 + + + Paul J. Leach + Microsoft Corporation + 1 Microsoft Way + Redmond, WA 98052, USA + + EMail: paulle@microsoft.com + + + Tim Berners-Lee + Director, World Wide Web Consortium + MIT Laboratory for Computer Science + 545 Technology Square + Cambridge, MA 02139, USA + + Fax: +1 (617) 258 8682 + EMail: timbl@w3.org + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 163] + +RFC 2616 HTTP/1.1 June 1999 + + +19 Appendices + +19.1 Internet Media Type message/http and application/http + + In addition to defining the HTTP/1.1 protocol, this document serves + as the specification for the Internet media type "message/http" and + "application/http". The message/http type can be used to enclose a + single HTTP request or response message, provided that it obeys the + MIME restrictions for all "message" types regarding line length and + encodings. The application/http type can be used to enclose a + pipeline of one or more HTTP request or response messages (not + intermixed). The following is to be registered with IANA [17]. + + Media Type name: message + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed message + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + Media Type name: application + Media subtype name: http + Required parameters: none + Optional parameters: version, msgtype + version: The HTTP-Version number of the enclosed messages + (e.g., "1.1"). If not present, the version can be + determined from the first line of the body. + msgtype: The message type -- "request" or "response". If not + present, the type can be determined from the first + line of the body. + Encoding considerations: HTTP messages enclosed by this type + are in "binary" format; use of an appropriate + Content-Transfer-Encoding is required when + transmitted via E-mail. + Security considerations: none + + + + + + + + + +Fielding, et al. Standards Track [Page 164] + +RFC 2616 HTTP/1.1 June 1999 + + +19.2 Internet Media Type multipart/byteranges + + When an HTTP 206 (Partial Content) response message includes the + content of multiple ranges (a response to a request for multiple + non-overlapping ranges), these are transmitted as a multipart + message-body. The media type for this purpose is called + "multipart/byteranges". + + The multipart/byteranges media type includes two or more parts, each + with its own Content-Type and Content-Range fields. The required + boundary parameter specifies the boundary string used to separate + each body-part. + + Media Type name: multipart + Media subtype name: byteranges + Required parameters: boundary + Optional parameters: none + Encoding considerations: only "7bit", "8bit", or "binary" are + permitted + Security considerations: none + + + For example: + + HTTP/1.1 206 Partial Content + Date: Wed, 15 Nov 1995 06:25:24 GMT + Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT + Content-type: multipart/byteranges; boundary=THIS_STRING_SEPARATES + + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 500-999/8000 + + ...the first range... + --THIS_STRING_SEPARATES + Content-type: application/pdf + Content-range: bytes 7000-7999/8000 + + ...the second range + --THIS_STRING_SEPARATES-- + + Notes: + + 1) Additional CRLFs may precede the first boundary string in the + entity. + + + + + + +Fielding, et al. Standards Track [Page 165] + +RFC 2616 HTTP/1.1 June 1999 + + + 2) Although RFC 2046 [40] permits the boundary string to be + quoted, some existing implementations handle a quoted boundary + string incorrectly. + + 3) A number of browsers and servers were coded to an early draft + of the byteranges specification to use a media type of + multipart/x-byteranges, which is almost, but not quite + compatible with the version documented in HTTP/1.1. + +19.3 Tolerant Applications + + Although this document specifies the requirements for the generation + of HTTP/1.1 messages, not all applications will be correct in their + implementation. We therefore recommend that operational applications + be tolerant of deviations whenever those deviations can be + interpreted unambiguously. + + Clients SHOULD be tolerant in parsing the Status-Line and servers + tolerant when parsing the Request-Line. In particular, they SHOULD + accept any amount of SP or HT characters between fields, even though + only a single SP is required. + + The line terminator for message-header fields is the sequence CRLF. + However, we recommend that applications, when parsing such headers, + recognize a single LF as a line terminator and ignore the leading CR. + + The character set of an entity-body SHOULD be labeled as the lowest + common denominator of the character codes used within that body, with + the exception that not labeling the entity is preferred over labeling + the entity with the labels US-ASCII or ISO-8859-1. See section 3.7.1 + and 3.4.1. + + Additional rules for requirements on parsing and encoding of dates + and other potential problems with date encodings include: + + - HTTP/1.1 clients and caches SHOULD assume that an RFC-850 date + which appears to be more than 50 years in the future is in fact + in the past (this helps solve the "year 2000" problem). + + - An HTTP/1.1 implementation MAY internally represent a parsed + Expires date as earlier than the proper value, but MUST NOT + internally represent a parsed Expires date as later than the + proper value. + + - All expiration-related calculations MUST be done in GMT. The + local time zone MUST NOT influence the calculation or comparison + of an age or expiration time. + + + + +Fielding, et al. Standards Track [Page 166] + +RFC 2616 HTTP/1.1 June 1999 + + + - If an HTTP header incorrectly carries a date value with a time + zone other than GMT, it MUST be converted into GMT using the + most conservative possible conversion. + +19.4 Differences Between HTTP Entities and RFC 2045 Entities + + HTTP/1.1 uses many of the constructs defined for Internet Mail (RFC + 822 [9]) and the Multipurpose Internet Mail Extensions (MIME [7]) to + allow entities to be transmitted in an open variety of + representations and with extensible mechanisms. However, RFC 2045 + discusses mail, and HTTP has a few features that are different from + those described in RFC 2045. These differences were carefully chosen + to optimize performance over binary connections, to allow greater + freedom in the use of new media types, to make date comparisons + easier, and to acknowledge the practice of some early HTTP servers + and clients. + + This appendix describes specific areas where HTTP differs from RFC + 2045. Proxies and gateways to strict MIME environments SHOULD be + aware of these differences and provide the appropriate conversions + where necessary. Proxies and gateways from MIME environments to HTTP + also need to be aware of the differences because some conversions + might be required. + +19.4.1 MIME-Version + + HTTP is not a MIME-compliant protocol. However, HTTP/1.1 messages MAY + include a single MIME-Version general-header field to indicate what + version of the MIME protocol was used to construct the message. Use + of the MIME-Version header field indicates that the message is in + full compliance with the MIME protocol (as defined in RFC 2045[7]). + Proxies/gateways are responsible for ensuring full compliance (where + possible) when exporting HTTP messages to strict MIME environments. + + MIME-Version = "MIME-Version" ":" 1*DIGIT "." 1*DIGIT + + MIME version "1.0" is the default for use in HTTP/1.1. However, + HTTP/1.1 message parsing and semantics are defined by this document + and not the MIME specification. + +19.4.2 Conversion to Canonical Form + + RFC 2045 [7] requires that an Internet mail entity be converted to + canonical form prior to being transferred, as described in section 4 + of RFC 2049 [48]. Section 3.7.1 of this document describes the forms + allowed for subtypes of the "text" media type when transmitted over + HTTP. RFC 2046 requires that content with a type of "text" represent + line breaks as CRLF and forbids the use of CR or LF outside of line + + + +Fielding, et al. Standards Track [Page 167] + +RFC 2616 HTTP/1.1 June 1999 + + + break sequences. HTTP allows CRLF, bare CR, and bare LF to indicate a + line break within text content when a message is transmitted over + HTTP. + + Where it is possible, a proxy or gateway from HTTP to a strict MIME + environment SHOULD translate all line breaks within the text media + types described in section 3.7.1 of this document to the RFC 2049 + canonical form of CRLF. Note, however, that this might be complicated + by the presence of a Content-Encoding and by the fact that HTTP + allows the use of some character sets which do not use octets 13 and + 10 to represent CR and LF, as is the case for some multi-byte + character sets. + + Implementors should note that conversion will break any cryptographic + checksums applied to the original content unless the original content + is already in canonical form. Therefore, the canonical form is + recommended for any content that uses such checksums in HTTP. + +19.4.3 Conversion of Date Formats + + HTTP/1.1 uses a restricted set of date formats (section 3.3.1) to + simplify the process of date comparison. Proxies and gateways from + other protocols SHOULD ensure that any Date header field present in a + message conforms to one of the HTTP/1.1 formats and rewrite the date + if necessary. + +19.4.4 Introduction of Content-Encoding + + RFC 2045 does not include any concept equivalent to HTTP/1.1's + Content-Encoding header field. Since this acts as a modifier on the + media type, proxies and gateways from HTTP to MIME-compliant + protocols MUST either change the value of the Content-Type header + field or decode the entity-body before forwarding the message. (Some + experimental applications of Content-Type for Internet mail have used + a media-type parameter of ";conversions=" to perform + a function equivalent to Content-Encoding. However, this parameter is + not part of RFC 2045.) + +19.4.5 No Content-Transfer-Encoding + + HTTP does not use the Content-Transfer-Encoding (CTE) field of RFC + 2045. Proxies and gateways from MIME-compliant protocols to HTTP MUST + remove any non-identity CTE ("quoted-printable" or "base64") encoding + prior to delivering the response message to an HTTP client. + + Proxies and gateways from HTTP to MIME-compliant protocols are + responsible for ensuring that the message is in the correct format + and encoding for safe transport on that protocol, where "safe + + + +Fielding, et al. Standards Track [Page 168] + +RFC 2616 HTTP/1.1 June 1999 + + + transport" is defined by the limitations of the protocol being used. + Such a proxy or gateway SHOULD label the data with an appropriate + Content-Transfer-Encoding if doing so will improve the likelihood of + safe transport over the destination protocol. + +19.4.6 Introduction of Transfer-Encoding + + HTTP/1.1 introduces the Transfer-Encoding header field (section + 14.41). Proxies/gateways MUST remove any transfer-coding prior to + forwarding a message via a MIME-compliant protocol. + + A process for decoding the "chunked" transfer-coding (section 3.6) + can be represented in pseudo-code as: + + length := 0 + read chunk-size, chunk-extension (if any) and CRLF + while (chunk-size > 0) { + read chunk-data and CRLF + append chunk-data to entity-body + length := length + chunk-size + read chunk-size and CRLF + } + read entity-header + while (entity-header not empty) { + append entity-header to existing header fields + read entity-header + } + Content-Length := length + Remove "chunked" from Transfer-Encoding + +19.4.7 MHTML and Line Length Limitations + + HTTP implementations which share code with MHTML [45] implementations + need to be aware of MIME line length limitations. Since HTTP does not + have this limitation, HTTP does not fold long lines. MHTML messages + being transported by HTTP follow all conventions of MHTML, including + line length limitations and folding, canonicalization, etc., since + HTTP transports all message-bodies as payload (see section 3.7.2) and + does not interpret the content or any MIME header lines that might be + contained therein. + +19.5 Additional Features + + RFC 1945 and RFC 2068 document protocol elements used by some + existing HTTP implementations, but not consistently and correctly + across most HTTP/1.1 applications. Implementors are advised to be + aware of these features, but cannot rely upon their presence in, or + interoperability with, other HTTP/1.1 applications. Some of these + + + +Fielding, et al. Standards Track [Page 169] + +RFC 2616 HTTP/1.1 June 1999 + + + describe proposed experimental features, and some describe features + that experimental deployment found lacking that are now addressed in + the base HTTP/1.1 specification. + + A number of other headers, such as Content-Disposition and Title, + from SMTP and MIME are also often implemented (see RFC 2076 [37]). + +19.5.1 Content-Disposition + + The Content-Disposition response-header field has been proposed as a + means for the origin server to suggest a default filename if the user + requests that the content is saved to a file. This usage is derived + from the definition of Content-Disposition in RFC 1806 [35]. + + content-disposition = "Content-Disposition" ":" + disposition-type *( ";" disposition-parm ) + disposition-type = "attachment" | disp-extension-token + disposition-parm = filename-parm | disp-extension-parm + filename-parm = "filename" "=" quoted-string + disp-extension-token = token + disp-extension-parm = token "=" ( token | quoted-string ) + + An example is + + Content-Disposition: attachment; filename="fname.ext" + + The receiving user agent SHOULD NOT respect any directory path + information present in the filename-parm parameter, which is the only + parameter believed to apply to HTTP implementations at this time. The + filename SHOULD be treated as a terminal component only. + + If this header is used in a response with the application/octet- + stream content-type, the implied suggestion is that the user agent + should not display the response, but directly enter a `save response + as...' dialog. + + See section 15.5 for Content-Disposition security issues. + +19.6 Compatibility with Previous Versions + + It is beyond the scope of a protocol specification to mandate + compliance with previous versions. HTTP/1.1 was deliberately + designed, however, to make supporting previous versions easy. It is + worth noting that, at the time of composing this specification + (1996), we would expect commercial HTTP/1.1 servers to: + + - recognize the format of the Request-Line for HTTP/0.9, 1.0, and + 1.1 requests; + + + +Fielding, et al. Standards Track [Page 170] + +RFC 2616 HTTP/1.1 June 1999 + + + - understand any valid request in the format of HTTP/0.9, 1.0, or + 1.1; + + - respond appropriately with a message in the same major version + used by the client. + + And we would expect HTTP/1.1 clients to: + + - recognize the format of the Status-Line for HTTP/1.0 and 1.1 + responses; + + - understand any valid response in the format of HTTP/0.9, 1.0, or + 1.1. + + For most implementations of HTTP/1.0, each connection is established + by the client prior to the request and closed by the server after + sending the response. Some implementations implement the Keep-Alive + version of persistent connections described in section 19.7.1 of RFC + 2068 [33]. + +19.6.1 Changes from HTTP/1.0 + + This section summarizes major differences between versions HTTP/1.0 + and HTTP/1.1. + +19.6.1.1 Changes to Simplify Multi-homed Web Servers and Conserve IP + Addresses + + The requirements that clients and servers support the Host request- + header, report an error if the Host request-header (section 14.23) is + missing from an HTTP/1.1 request, and accept absolute URIs (section + 5.1.2) are among the most important changes defined by this + specification. + + Older HTTP/1.0 clients assumed a one-to-one relationship of IP + addresses and servers; there was no other established mechanism for + distinguishing the intended server of a request than the IP address + to which that request was directed. The changes outlined above will + allow the Internet, once older HTTP clients are no longer common, to + support multiple Web sites from a single IP address, greatly + simplifying large operational Web servers, where allocation of many + IP addresses to a single host has created serious problems. The + Internet will also be able to recover the IP addresses that have been + allocated for the sole purpose of allowing special-purpose domain + names to be used in root-level HTTP URLs. Given the rate of growth of + the Web, and the number of servers already deployed, it is extremely + + + + + +Fielding, et al. Standards Track [Page 171] + +RFC 2616 HTTP/1.1 June 1999 + + + important that all implementations of HTTP (including updates to + existing HTTP/1.0 applications) correctly implement these + requirements: + + - Both clients and servers MUST support the Host request-header. + + - A client that sends an HTTP/1.1 request MUST send a Host header. + + - Servers MUST report a 400 (Bad Request) error if an HTTP/1.1 + request does not include a Host request-header. + + - Servers MUST accept absolute URIs. + +19.6.2 Compatibility with HTTP/1.0 Persistent Connections + + Some clients and servers might wish to be compatible with some + previous implementations of persistent connections in HTTP/1.0 + clients and servers. Persistent connections in HTTP/1.0 are + explicitly negotiated as they are not the default behavior. HTTP/1.0 + experimental implementations of persistent connections are faulty, + and the new facilities in HTTP/1.1 are designed to rectify these + problems. The problem was that some existing 1.0 clients may be + sending Keep-Alive to a proxy server that doesn't understand + Connection, which would then erroneously forward it to the next + inbound server, which would establish the Keep-Alive connection and + result in a hung HTTP/1.0 proxy waiting for the close on the + response. The result is that HTTP/1.0 clients must be prevented from + using Keep-Alive when talking to proxies. + + However, talking to proxies is the most important use of persistent + connections, so that prohibition is clearly unacceptable. Therefore, + we need some other mechanism for indicating a persistent connection + is desired, which is safe to use even when talking to an old proxy + that ignores Connection. Persistent connections are the default for + HTTP/1.1 messages; we introduce a new keyword (Connection: close) for + declaring non-persistence. See section 14.10. + + The original HTTP/1.0 form of persistent connections (the Connection: + Keep-Alive and Keep-Alive header) is documented in RFC 2068. [33] + +19.6.3 Changes from RFC 2068 + + This specification has been carefully audited to correct and + disambiguate key word usage; RFC 2068 had many problems in respect to + the conventions laid out in RFC 2119 [34]. + + Clarified which error code should be used for inbound server failures + (e.g. DNS failures). (Section 10.5.5). + + + +Fielding, et al. Standards Track [Page 172] + +RFC 2616 HTTP/1.1 June 1999 + + + CREATE had a race that required an Etag be sent when a resource is + first created. (Section 10.2.2). + + Content-Base was deleted from the specification: it was not + implemented widely, and there is no simple, safe way to introduce it + without a robust extension mechanism. In addition, it is used in a + similar, but not identical fashion in MHTML [45]. + + Transfer-coding and message lengths all interact in ways that + required fixing exactly when chunked encoding is used (to allow for + transfer encoding that may not be self delimiting); it was important + to straighten out exactly how message lengths are computed. (Sections + 3.6, 4.4, 7.2.2, 13.5.2, 14.13, 14.16) + + A content-coding of "identity" was introduced, to solve problems + discovered in caching. (section 3.5) + + Quality Values of zero should indicate that "I don't want something" + to allow clients to refuse a representation. (Section 3.9) + + The use and interpretation of HTTP version numbers has been clarified + by RFC 2145. Require proxies to upgrade requests to highest protocol + version they support to deal with problems discovered in HTTP/1.0 + implementations (Section 3.1) + + Charset wildcarding is introduced to avoid explosion of character set + names in accept headers. (Section 14.2) + + A case was missed in the Cache-Control model of HTTP/1.1; s-maxage + was introduced to add this missing case. (Sections 13.4, 14.8, 14.9, + 14.9.3) + + The Cache-Control: max-age directive was not properly defined for + responses. (Section 14.9.3) + + There are situations where a server (especially a proxy) does not + know the full length of a response but is capable of serving a + byterange request. We therefore need a mechanism to allow byteranges + with a content-range not indicating the full length of the message. + (Section 14.16) + + Range request responses would become very verbose if all meta-data + were always returned; by allowing the server to only send needed + headers in a 206 response, this problem can be avoided. (Section + 10.2.7, 13.5.3, and 14.27) + + + + + + +Fielding, et al. Standards Track [Page 173] + +RFC 2616 HTTP/1.1 June 1999 + + + Fix problem with unsatisfiable range requests; there are two cases: + syntactic problems, and range doesn't exist in the document. The 416 + status code was needed to resolve this ambiguity needed to indicate + an error for a byte range request that falls outside of the actual + contents of a document. (Section 10.4.17, 14.16) + + Rewrite of message transmission requirements to make it much harder + for implementors to get it wrong, as the consequences of errors here + can have significant impact on the Internet, and to deal with the + following problems: + + 1. Changing "HTTP/1.1 or later" to "HTTP/1.1", in contexts where + this was incorrectly placing a requirement on the behavior of + an implementation of a future version of HTTP/1.x + + 2. Made it clear that user-agents should retry requests, not + "clients" in general. + + 3. Converted requirements for clients to ignore unexpected 100 + (Continue) responses, and for proxies to forward 100 responses, + into a general requirement for 1xx responses. + + 4. Modified some TCP-specific language, to make it clearer that + non-TCP transports are possible for HTTP. + + 5. Require that the origin server MUST NOT wait for the request + body before it sends a required 100 (Continue) response. + + 6. Allow, rather than require, a server to omit 100 (Continue) if + it has already seen some of the request body. + + 7. Allow servers to defend against denial-of-service attacks and + broken clients. + + This change adds the Expect header and 417 status code. The message + transmission requirements fixes are in sections 8.2, 10.4.18, + 8.1.2.2, 13.11, and 14.20. + + Proxies should be able to add Content-Length when appropriate. + (Section 13.5.2) + + Clean up confusion between 403 and 404 responses. (Section 10.4.4, + 10.4.5, and 10.4.11) + + Warnings could be cached incorrectly, or not updated appropriately. + (Section 13.1.2, 13.2.4, 13.5.2, 13.5.3, 14.9.3, and 14.46) Warning + also needed to be a general header, as PUT or other methods may have + need for it in requests. + + + +Fielding, et al. Standards Track [Page 174] + +RFC 2616 HTTP/1.1 June 1999 + + + Transfer-coding had significant problems, particularly with + interactions with chunked encoding. The solution is that transfer- + codings become as full fledged as content-codings. This involves + adding an IANA registry for transfer-codings (separate from content + codings), a new header field (TE) and enabling trailer headers in the + future. Transfer encoding is a major performance benefit, so it was + worth fixing [39]. TE also solves another, obscure, downward + interoperability problem that could have occurred due to interactions + between authentication trailers, chunked encoding and HTTP/1.0 + clients.(Section 3.6, 3.6.1, and 14.39) + + The PATCH, LINK, UNLINK methods were defined but not commonly + implemented in previous versions of this specification. See RFC 2068 + [33]. + + The Alternates, Content-Version, Derived-From, Link, URI, Public and + Content-Base header fields were defined in previous versions of this + specification, but not commonly implemented. See RFC 2068 [33]. + +20 Index + + Please see the PostScript version of this RFC for the INDEX. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Fielding, et al. Standards Track [Page 175] + +RFC 2616 HTTP/1.1 June 1999 + + +21. Full Copyright Statement + + Copyright (C) The Internet Society (1999). All Rights Reserved. + + This document and translations of it may be copied and furnished to + others, and derivative works that comment on or otherwise explain it + or assist in its implementation may be prepared, copied, published + and distributed, in whole or in part, without restriction of any + kind, provided that the above copyright notice and this paragraph are + included on all such copies and derivative works. However, this + document itself may not be modified in any way, such as by removing + the copyright notice or references to the Internet Society or other + Internet organizations, except as needed for the purpose of + developing Internet standards in which case the procedures for + copyrights defined in the Internet Standards process must be + followed, or as required to translate it into languages other than + English. + + The limited permissions granted above are perpetual and will not be + revoked by the Internet Society or its successors or assigns. + + This document and the information contained herein is provided on an + "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING + TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING + BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION + HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF + MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + +Acknowledgement + + Funding for the RFC Editor function is currently provided by the + Internet Society. \ No newline at end of file diff --git a/packages/re_editor/example/ios/Flutter/AppFrameworkInfo.plist b/packages/re_editor/example/ios/Flutter/AppFrameworkInfo.plist new file mode 100644 index 0000000..9625e10 --- /dev/null +++ b/packages/re_editor/example/ios/Flutter/AppFrameworkInfo.plist @@ -0,0 +1,26 @@ + + + + + CFBundleDevelopmentRegion + en + CFBundleExecutable + App + CFBundleIdentifier + io.flutter.flutter.app + CFBundleInfoDictionaryVersion + 6.0 + CFBundleName + App + CFBundlePackageType + FMWK + CFBundleShortVersionString + 1.0 + CFBundleSignature + ???? + CFBundleVersion + 1.0 + MinimumOSVersion + 11.0 + + diff --git a/packages/re_editor/example/ios/Flutter/Debug.xcconfig b/packages/re_editor/example/ios/Flutter/Debug.xcconfig new file mode 100644 index 0000000..592ceee --- /dev/null +++ b/packages/re_editor/example/ios/Flutter/Debug.xcconfig @@ -0,0 +1 @@ +#include "Generated.xcconfig" diff --git a/packages/re_editor/example/ios/Flutter/Release.xcconfig b/packages/re_editor/example/ios/Flutter/Release.xcconfig new file mode 100644 index 0000000..592ceee --- /dev/null +++ b/packages/re_editor/example/ios/Flutter/Release.xcconfig @@ -0,0 +1 @@ +#include "Generated.xcconfig" diff --git a/packages/re_editor/example/ios/Runner.xcodeproj/project.pbxproj b/packages/re_editor/example/ios/Runner.xcodeproj/project.pbxproj new file mode 100644 index 0000000..ae71864 --- /dev/null +++ b/packages/re_editor/example/ios/Runner.xcodeproj/project.pbxproj @@ -0,0 +1,617 @@ +// !$*UTF8*$! +{ + archiveVersion = 1; + classes = { + }; + objectVersion = 54; + objects = { + +/* Begin PBXBuildFile section */ + 1498D2341E8E89220040F4C2 /* GeneratedPluginRegistrant.m in Sources */ = {isa = PBXBuildFile; fileRef = 1498D2331E8E89220040F4C2 /* GeneratedPluginRegistrant.m */; }; + 3B3967161E833CAA004F5970 /* AppFrameworkInfo.plist in Resources */ = {isa = PBXBuildFile; fileRef = 3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */; }; + 74858FAF1ED2DC5600515810 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 74858FAE1ED2DC5600515810 /* AppDelegate.swift */; }; + 97C146FC1CF9000F007C117D /* Main.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 97C146FA1CF9000F007C117D /* Main.storyboard */; }; + 97C146FE1CF9000F007C117D /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 97C146FD1CF9000F007C117D /* Assets.xcassets */; }; + 97C147011CF9000F007C117D /* LaunchScreen.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 97C146FF1CF9000F007C117D /* LaunchScreen.storyboard */; }; + 331C808B294A63AB00263BE5 /* RunnerTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 331C807B294A618700263BE5 /* RunnerTests.swift */; }; +/* End PBXBuildFile section */ + +/* Begin PBXContainerItemProxy section */ + 331C8085294A63A400263BE5 /* PBXContainerItemProxy */ = { + isa = PBXContainerItemProxy; + containerPortal = 97C146E61CF9000F007C117D /* Project object */; + proxyType = 1; + remoteGlobalIDString = 97C146ED1CF9000F007C117D; + remoteInfo = Runner; + }; +/* End PBXContainerItemProxy section */ + +/* Begin PBXCopyFilesBuildPhase section */ + 9705A1C41CF9048500538489 /* Embed Frameworks */ = { + isa = PBXCopyFilesBuildPhase; + buildActionMask = 2147483647; + dstPath = ""; + dstSubfolderSpec = 10; + files = ( + ); + name = "Embed Frameworks"; + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXCopyFilesBuildPhase section */ + +/* Begin PBXFileReference section */ + 1498D2321E8E86230040F4C2 /* GeneratedPluginRegistrant.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = GeneratedPluginRegistrant.h; sourceTree = ""; }; + 1498D2331E8E89220040F4C2 /* GeneratedPluginRegistrant.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = GeneratedPluginRegistrant.m; sourceTree = ""; }; + 3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.xml; name = AppFrameworkInfo.plist; path = Flutter/AppFrameworkInfo.plist; sourceTree = ""; }; + 74858FAD1ED2DC5600515810 /* Runner-Bridging-Header.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "Runner-Bridging-Header.h"; sourceTree = ""; }; + 74858FAE1ED2DC5600515810 /* AppDelegate.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = ""; }; + 7AFA3C8E1D35360C0083082E /* Release.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; name = Release.xcconfig; path = Flutter/Release.xcconfig; sourceTree = ""; }; + 9740EEB21CF90195004384FC /* Debug.xcconfig */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.xcconfig; name = Debug.xcconfig; path = Flutter/Debug.xcconfig; sourceTree = ""; }; + 9740EEB31CF90195004384FC /* Generated.xcconfig */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.xcconfig; name = Generated.xcconfig; path = Flutter/Generated.xcconfig; sourceTree = ""; }; + 97C146EE1CF9000F007C117D /* Runner.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = Runner.app; sourceTree = BUILT_PRODUCTS_DIR; }; + 97C146FB1CF9000F007C117D /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/Main.storyboard; sourceTree = ""; }; + 97C146FD1CF9000F007C117D /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Assets.xcassets; sourceTree = ""; }; + 97C147001CF9000F007C117D /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/LaunchScreen.storyboard; sourceTree = ""; }; + 97C147021CF9000F007C117D /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = ""; }; + 331C807B294A618700263BE5 /* RunnerTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RunnerTests.swift; sourceTree = ""; }; + 331C8081294A63A400263BE5 /* RunnerTests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = RunnerTests.xctest; sourceTree = BUILT_PRODUCTS_DIR; }; +/* End PBXFileReference section */ + +/* Begin PBXFrameworksBuildPhase section */ + 97C146EB1CF9000F007C117D /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXFrameworksBuildPhase section */ + +/* Begin PBXGroup section */ + 9740EEB11CF90186004384FC /* Flutter */ = { + isa = PBXGroup; + children = ( + 3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */, + 9740EEB21CF90195004384FC /* Debug.xcconfig */, + 7AFA3C8E1D35360C0083082E /* Release.xcconfig */, + 9740EEB31CF90195004384FC /* Generated.xcconfig */, + ); + name = Flutter; + sourceTree = ""; + }; + 331C8082294A63A400263BE5 /* RunnerTests */ = { + isa = PBXGroup; + children = ( + 331C807B294A618700263BE5 /* RunnerTests.swift */, + ); + path = RunnerTests; + sourceTree = ""; + }; + 97C146E51CF9000F007C117D = { + isa = PBXGroup; + children = ( + 9740EEB11CF90186004384FC /* Flutter */, + 97C146F01CF9000F007C117D /* Runner */, + 97C146EF1CF9000F007C117D /* Products */, + 331C8082294A63A400263BE5 /* RunnerTests */, + ); + sourceTree = ""; + }; + 97C146EF1CF9000F007C117D /* Products */ = { + isa = PBXGroup; + children = ( + 97C146EE1CF9000F007C117D /* Runner.app */, + 331C8081294A63A400263BE5 /* RunnerTests.xctest */, + ); + name = Products; + sourceTree = ""; + }; + 97C146F01CF9000F007C117D /* Runner */ = { + isa = PBXGroup; + children = ( + 97C146FA1CF9000F007C117D /* Main.storyboard */, + 97C146FD1CF9000F007C117D /* Assets.xcassets */, + 97C146FF1CF9000F007C117D /* LaunchScreen.storyboard */, + 97C147021CF9000F007C117D /* Info.plist */, + 1498D2321E8E86230040F4C2 /* GeneratedPluginRegistrant.h */, + 1498D2331E8E89220040F4C2 /* GeneratedPluginRegistrant.m */, + 74858FAE1ED2DC5600515810 /* AppDelegate.swift */, + 74858FAD1ED2DC5600515810 /* Runner-Bridging-Header.h */, + ); + path = Runner; + sourceTree = ""; + }; +/* End PBXGroup section */ + +/* Begin PBXNativeTarget section */ + 331C8080294A63A400263BE5 /* RunnerTests */ = { + isa = PBXNativeTarget; + buildConfigurationList = 331C8087294A63A400263BE5 /* Build configuration list for PBXNativeTarget "RunnerTests" */; + buildPhases = ( + 331C807D294A63A400263BE5 /* Sources */, + 331C807E294A63A400263BE5 /* Frameworks */, + 331C807F294A63A400263BE5 /* Resources */, + ); + buildRules = ( + ); + dependencies = ( + 331C8086294A63A400263BE5 /* PBXTargetDependency */, + ); + name = RunnerTests; + productName = RunnerTests; + productReference = 331C8081294A63A400263BE5 /* RunnerTests.xctest */; + productType = "com.apple.product-type.bundle.unit-test"; + }; + 97C146ED1CF9000F007C117D /* Runner */ = { + isa = PBXNativeTarget; + buildConfigurationList = 97C147051CF9000F007C117D /* Build configuration list for PBXNativeTarget "Runner" */; + buildPhases = ( + 9740EEB61CF901F6004384FC /* Run Script */, + 97C146EA1CF9000F007C117D /* Sources */, + 97C146EB1CF9000F007C117D /* Frameworks */, + 97C146EC1CF9000F007C117D /* Resources */, + 9705A1C41CF9048500538489 /* Embed Frameworks */, + 3B06AD1E1E4923F5004D2608 /* Thin Binary */, + ); + buildRules = ( + ); + dependencies = ( + ); + name = Runner; + productName = Runner; + productReference = 97C146EE1CF9000F007C117D /* Runner.app */; + productType = "com.apple.product-type.application"; + }; +/* End PBXNativeTarget section */ + +/* Begin PBXProject section */ + 97C146E61CF9000F007C117D /* Project object */ = { + isa = PBXProject; + attributes = { + BuildIndependentTargetsInParallel = YES; + LastUpgradeCheck = 1430; + ORGANIZATIONNAME = ""; + TargetAttributes = { + 331C8080294A63A400263BE5 = { + CreatedOnToolsVersion = 14.0; + TestTargetID = 97C146ED1CF9000F007C117D; + }; + 97C146ED1CF9000F007C117D = { + CreatedOnToolsVersion = 7.3.1; + LastSwiftMigration = 1100; + }; + }; + }; + buildConfigurationList = 97C146E91CF9000F007C117D /* Build configuration list for PBXProject "Runner" */; + compatibilityVersion = "Xcode 9.3"; + developmentRegion = en; + hasScannedForEncodings = 0; + knownRegions = ( + en, + Base, + ); + mainGroup = 97C146E51CF9000F007C117D; + productRefGroup = 97C146EF1CF9000F007C117D /* Products */; + projectDirPath = ""; + projectRoot = ""; + targets = ( + 97C146ED1CF9000F007C117D /* Runner */, + 331C8080294A63A400263BE5 /* RunnerTests */, + ); + }; +/* End PBXProject section */ + +/* Begin PBXResourcesBuildPhase section */ + 331C807F294A63A400263BE5 /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 97C146EC1CF9000F007C117D /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 97C147011CF9000F007C117D /* LaunchScreen.storyboard in Resources */, + 3B3967161E833CAA004F5970 /* AppFrameworkInfo.plist in Resources */, + 97C146FE1CF9000F007C117D /* Assets.xcassets in Resources */, + 97C146FC1CF9000F007C117D /* Main.storyboard in Resources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXResourcesBuildPhase section */ + +/* Begin PBXShellScriptBuildPhase section */ + 3B06AD1E1E4923F5004D2608 /* Thin Binary */ = { + isa = PBXShellScriptBuildPhase; + alwaysOutOfDate = 1; + buildActionMask = 2147483647; + files = ( + ); + inputPaths = ( + "${TARGET_BUILD_DIR}/${INFOPLIST_PATH}", + ); + name = "Thin Binary"; + outputPaths = ( + ); + runOnlyForDeploymentPostprocessing = 0; + shellPath = /bin/sh; + shellScript = "/bin/sh \"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh\" embed_and_thin"; + }; + 9740EEB61CF901F6004384FC /* Run Script */ = { + isa = PBXShellScriptBuildPhase; + alwaysOutOfDate = 1; + buildActionMask = 2147483647; + files = ( + ); + inputPaths = ( + ); + name = "Run Script"; + outputPaths = ( + ); + runOnlyForDeploymentPostprocessing = 0; + shellPath = /bin/sh; + shellScript = "/bin/sh \"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh\" build"; + }; +/* End PBXShellScriptBuildPhase section */ + +/* Begin PBXSourcesBuildPhase section */ + 331C807D294A63A400263BE5 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 331C808B294A63AB00263BE5 /* RunnerTests.swift in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 97C146EA1CF9000F007C117D /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 74858FAF1ED2DC5600515810 /* AppDelegate.swift in Sources */, + 1498D2341E8E89220040F4C2 /* GeneratedPluginRegistrant.m in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXSourcesBuildPhase section */ + +/* Begin PBXTargetDependency section */ + 331C8086294A63A400263BE5 /* PBXTargetDependency */ = { + isa = PBXTargetDependency; + target = 97C146ED1CF9000F007C117D /* Runner */; + targetProxy = 331C8085294A63A400263BE5 /* PBXContainerItemProxy */; + }; +/* End PBXTargetDependency section */ + +/* Begin PBXVariantGroup section */ + 97C146FA1CF9000F007C117D /* Main.storyboard */ = { + isa = PBXVariantGroup; + children = ( + 97C146FB1CF9000F007C117D /* Base */, + ); + name = Main.storyboard; + sourceTree = ""; + }; + 97C146FF1CF9000F007C117D /* LaunchScreen.storyboard */ = { + isa = PBXVariantGroup; + children = ( + 97C147001CF9000F007C117D /* Base */, + ); + name = LaunchScreen.storyboard; + sourceTree = ""; + }; +/* End PBXVariantGroup section */ + +/* Begin XCBuildConfiguration section */ + 249021D3217E4FDB00AE95B9 /* Profile */ = { + isa = XCBuildConfiguration; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + CLANG_ANALYZER_NONNULL = YES; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_COMMA = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_STRICT_PROTOTYPES = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CLANG_WARN_UNREACHABLE_CODE = YES; + CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer"; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym"; + ENABLE_NS_ASSERTIONS = NO; + ENABLE_STRICT_OBJC_MSGSEND = YES; + GCC_C_LANGUAGE_STANDARD = gnu99; + GCC_NO_COMMON_BLOCKS = YES; + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNDECLARED_SELECTOR = YES; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + IPHONEOS_DEPLOYMENT_TARGET = 11.0; + MTL_ENABLE_DEBUG_INFO = NO; + SDKROOT = iphoneos; + SUPPORTED_PLATFORMS = iphoneos; + TARGETED_DEVICE_FAMILY = "1,2"; + VALIDATE_PRODUCT = YES; + }; + name = Profile; + }; + 249021D4217E4FDB00AE95B9 /* Profile */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)"; + DEVELOPMENT_TEAM = DXY5A5J7C4; + ENABLE_BITCODE = NO; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + ); + PRODUCT_BUNDLE_IDENTIFIER = com.example.example; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h"; + SWIFT_VERSION = 5.0; + VERSIONING_SYSTEM = "apple-generic"; + }; + name = Profile; + }; + 331C8088294A63A400263BE5 /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = AE0B7B92F70575B8D7E0D07E /* Pods-RunnerTests.debug.xcconfig */; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CODE_SIGN_STYLE = Automatic; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.example.example.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG; + SWIFT_OPTIMIZATION_LEVEL = "-Onone"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner"; + }; + name = Debug; + }; + 331C8089294A63A400263BE5 /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 89B67EB44CE7B6631473024E /* Pods-RunnerTests.release.xcconfig */; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CODE_SIGN_STYLE = Automatic; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.example.example.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner"; + }; + name = Release; + }; + 331C808A294A63A400263BE5 /* Profile */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 640959BDD8F10B91D80A66BE /* Pods-RunnerTests.profile.xcconfig */; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CODE_SIGN_STYLE = Automatic; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.example.example.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner"; + }; + name = Profile; + }; + 97C147031CF9000F007C117D /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + CLANG_ANALYZER_NONNULL = YES; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_COMMA = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_STRICT_PROTOTYPES = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CLANG_WARN_UNREACHABLE_CODE = YES; + CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer"; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = dwarf; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_TESTABILITY = YES; + GCC_C_LANGUAGE_STANDARD = gnu99; + GCC_DYNAMIC_NO_PIC = NO; + GCC_NO_COMMON_BLOCKS = YES; + GCC_OPTIMIZATION_LEVEL = 0; + GCC_PREPROCESSOR_DEFINITIONS = ( + "DEBUG=1", + "$(inherited)", + ); + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNDECLARED_SELECTOR = YES; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + IPHONEOS_DEPLOYMENT_TARGET = 11.0; + MTL_ENABLE_DEBUG_INFO = YES; + ONLY_ACTIVE_ARCH = YES; + SDKROOT = iphoneos; + TARGETED_DEVICE_FAMILY = "1,2"; + }; + name = Debug; + }; + 97C147041CF9000F007C117D /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + CLANG_ANALYZER_NONNULL = YES; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_COMMA = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_STRICT_PROTOTYPES = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CLANG_WARN_UNREACHABLE_CODE = YES; + CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer"; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym"; + ENABLE_NS_ASSERTIONS = NO; + ENABLE_STRICT_OBJC_MSGSEND = YES; + GCC_C_LANGUAGE_STANDARD = gnu99; + GCC_NO_COMMON_BLOCKS = YES; + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNDECLARED_SELECTOR = YES; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + IPHONEOS_DEPLOYMENT_TARGET = 11.0; + MTL_ENABLE_DEBUG_INFO = NO; + SDKROOT = iphoneos; + SUPPORTED_PLATFORMS = iphoneos; + SWIFT_COMPILATION_MODE = wholemodule; + SWIFT_OPTIMIZATION_LEVEL = "-O"; + TARGETED_DEVICE_FAMILY = "1,2"; + VALIDATE_PRODUCT = YES; + }; + name = Release; + }; + 97C147061CF9000F007C117D /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 9740EEB21CF90195004384FC /* Debug.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)"; + DEVELOPMENT_TEAM = DXY5A5J7C4; + ENABLE_BITCODE = NO; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + ); + PRODUCT_BUNDLE_IDENTIFIER = com.example.example; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h"; + SWIFT_OPTIMIZATION_LEVEL = "-Onone"; + SWIFT_VERSION = 5.0; + VERSIONING_SYSTEM = "apple-generic"; + }; + name = Debug; + }; + 97C147071CF9000F007C117D /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)"; + DEVELOPMENT_TEAM = DXY5A5J7C4; + ENABLE_BITCODE = NO; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + ); + PRODUCT_BUNDLE_IDENTIFIER = com.example.example; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h"; + SWIFT_VERSION = 5.0; + VERSIONING_SYSTEM = "apple-generic"; + }; + name = Release; + }; +/* End XCBuildConfiguration section */ + +/* Begin XCConfigurationList section */ + 331C8087294A63A400263BE5 /* Build configuration list for PBXNativeTarget "RunnerTests" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 331C8088294A63A400263BE5 /* Debug */, + 331C8089294A63A400263BE5 /* Release */, + 331C808A294A63A400263BE5 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 97C146E91CF9000F007C117D /* Build configuration list for PBXProject "Runner" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 97C147031CF9000F007C117D /* Debug */, + 97C147041CF9000F007C117D /* Release */, + 249021D3217E4FDB00AE95B9 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 97C147051CF9000F007C117D /* Build configuration list for PBXNativeTarget "Runner" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 97C147061CF9000F007C117D /* Debug */, + 97C147071CF9000F007C117D /* Release */, + 249021D4217E4FDB00AE95B9 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; +/* End XCConfigurationList section */ + }; + rootObject = 97C146E61CF9000F007C117D /* Project object */; +} diff --git a/packages/re_editor/example/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata b/packages/re_editor/example/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata new file mode 100644 index 0000000..919434a --- /dev/null +++ b/packages/re_editor/example/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata @@ -0,0 +1,7 @@ + + + + + diff --git a/packages/re_editor/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/packages/re_editor/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist new file mode 100644 index 0000000..18d9810 --- /dev/null +++ b/packages/re_editor/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist @@ -0,0 +1,8 @@ + + + + + IDEDidComputeMac32BitWarning + + + diff --git a/packages/re_editor/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings b/packages/re_editor/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings new file mode 100644 index 0000000..f9b0d7c --- /dev/null +++ b/packages/re_editor/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings @@ -0,0 +1,8 @@ + + + + + PreviewsEnabled + + + diff --git a/packages/re_editor/example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme b/packages/re_editor/example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme new file mode 100644 index 0000000..87131a0 --- /dev/null +++ b/packages/re_editor/example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme @@ -0,0 +1,98 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/packages/re_editor/example/ios/Runner.xcworkspace/contents.xcworkspacedata b/packages/re_editor/example/ios/Runner.xcworkspace/contents.xcworkspacedata new file mode 100644 index 0000000..1d526a1 --- /dev/null +++ b/packages/re_editor/example/ios/Runner.xcworkspace/contents.xcworkspacedata @@ -0,0 +1,7 @@ + + + + + diff --git a/packages/re_editor/example/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/packages/re_editor/example/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist new file mode 100644 index 0000000..18d9810 --- /dev/null +++ b/packages/re_editor/example/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist @@ -0,0 +1,8 @@ + + + + + IDEDidComputeMac32BitWarning + + + diff --git a/packages/re_editor/example/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings b/packages/re_editor/example/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings new file mode 100644 index 0000000..f9b0d7c --- /dev/null +++ b/packages/re_editor/example/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings @@ -0,0 +1,8 @@ + + + + + PreviewsEnabled + + + diff --git a/packages/re_editor/example/ios/Runner/AppDelegate.swift b/packages/re_editor/example/ios/Runner/AppDelegate.swift new file mode 100644 index 0000000..70693e4 --- /dev/null +++ b/packages/re_editor/example/ios/Runner/AppDelegate.swift @@ -0,0 +1,13 @@ +import UIKit +import Flutter + +@UIApplicationMain +@objc class AppDelegate: FlutterAppDelegate { + override func application( + _ application: UIApplication, + didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? + ) -> Bool { + GeneratedPluginRegistrant.register(with: self) + return super.application(application, didFinishLaunchingWithOptions: launchOptions) + } +} diff --git a/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json b/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json new file mode 100644 index 0000000..d36b1fa --- /dev/null +++ b/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json @@ -0,0 +1,122 @@ +{ + "images" : [ + { + "size" : "20x20", + "idiom" : "iphone", + "filename" : "Icon-App-20x20@2x.png", + "scale" : "2x" + }, + { + "size" : "20x20", + "idiom" : "iphone", + "filename" : "Icon-App-20x20@3x.png", + "scale" : "3x" + }, + { + "size" : "29x29", + "idiom" : "iphone", + "filename" : "Icon-App-29x29@1x.png", + "scale" : "1x" + }, + { + "size" : "29x29", + "idiom" : "iphone", + "filename" : "Icon-App-29x29@2x.png", + "scale" : "2x" + }, + { + "size" : "29x29", + "idiom" : "iphone", + "filename" : "Icon-App-29x29@3x.png", + "scale" : "3x" + }, + { + "size" : "40x40", + "idiom" : "iphone", + "filename" : "Icon-App-40x40@2x.png", + "scale" : "2x" + }, + { + "size" : "40x40", + "idiom" : "iphone", + "filename" : "Icon-App-40x40@3x.png", + "scale" : "3x" + }, + { + "size" : "60x60", + "idiom" : "iphone", + "filename" : "Icon-App-60x60@2x.png", + "scale" : "2x" + }, + { + "size" : "60x60", + "idiom" : "iphone", + "filename" : "Icon-App-60x60@3x.png", + "scale" : "3x" + }, + { + "size" : "20x20", + "idiom" : "ipad", + "filename" : "Icon-App-20x20@1x.png", + "scale" : "1x" + }, + { + "size" : "20x20", + "idiom" : "ipad", + "filename" : "Icon-App-20x20@2x.png", + "scale" : "2x" + }, + { + "size" : "29x29", + "idiom" : "ipad", + "filename" : "Icon-App-29x29@1x.png", + "scale" : "1x" + }, + { + "size" : "29x29", + "idiom" : "ipad", + "filename" : "Icon-App-29x29@2x.png", + "scale" : "2x" + }, + { + "size" : "40x40", + "idiom" : "ipad", + "filename" : "Icon-App-40x40@1x.png", + "scale" : "1x" + }, + { + "size" : "40x40", + "idiom" : "ipad", + "filename" : "Icon-App-40x40@2x.png", + "scale" : "2x" + }, + { + "size" : "76x76", + "idiom" : "ipad", + "filename" : "Icon-App-76x76@1x.png", + "scale" : "1x" + }, + { + "size" : "76x76", + "idiom" : "ipad", + "filename" : "Icon-App-76x76@2x.png", + "scale" : "2x" + }, + { + "size" : "83.5x83.5", + "idiom" : "ipad", + "filename" : "Icon-App-83.5x83.5@2x.png", + "scale" : "2x" + }, + { + "size" : "1024x1024", + "idiom" : "ios-marketing", + "filename" : "Icon-App-1024x1024@1x.png", + "scale" : "1x" + } + ], + "info" : { + "version" : 1, + "author" : "xcode" + } +} diff --git a/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png b/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png new file mode 100644 index 0000000000000000000000000000000000000000..dc9ada4725e9b0ddb1deab583e5b5102493aa332 GIT binary patch literal 10932 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 literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png b/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..797d452e458972bab9d994556c8305db4c827017 GIT binary patch literal 406 zcmV;H0crk;P))>cdjpWt&rLJgVp-t?DREyuq1A%0Z4)6_WsQ7{nzjN zo!X zGXV)2i3kcZIL~_j>uIKPK_zib+3T+Nt3Mb&Br)s)UIaA}@p{wDda>7=Q|mGRp7pqY zkJ!7E{MNz$9nOwoVqpFb)}$IP24Wn2JJ=Cw(!`OXJBr45rP>>AQr$6c7slJWvbpNW z@KTwna6d?PP>hvXCcp=4F;=GR@R4E7{4VU^0p4F>v^#A|>07*qoM6N<$f*5nx ACIA2c literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png b/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png new file mode 100644 index 0000000000000000000000000000000000000000..6ed2d933e1120817fe9182483a228007b18ab6ae GIT binary patch literal 450 zcmV;z0X_bSP)iGWQ_5NJQ_~rNh*z)}eT%KUb z`7gNk0#AwF^#0T0?hIa^`~Ck;!}#m+_uT050aTR(J!bU#|IzRL%^UsMS#KsYnTF*!YeDOytlP4VhV?b} z%rz_<=#CPc)tU1MZTq~*2=8~iZ!lSa<{9b@2Jl;?IEV8)=fG217*|@)CCYgFze-x? zIFODUIA>nWKpE+bn~n7;-89sa>#DR>TSlqWk*!2hSN6D~Qb#VqbP~4Fk&m`@1$JGr zXPIdeRE&b2Thd#{MtDK$px*d3-Wx``>!oimf%|A-&-q*6KAH)e$3|6JV%HX{Hig)k suLT-RhftRq8b9;(V=235Wa|I=027H2wCDra;{X5v07*qoM6N<$f;9x^2LJ#7 literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png b/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png new file mode 100644 index 0000000000000000000000000000000000000000..4cd7b0099ca80c806f8fe495613e8d6c69460d76 GIT binary patch literal 282 zcmV+#0p(^bcu7P-R4C8Q z&e;xxFbF_Vrezo%_kH*OKhshZ6BFpG-Y1e10`QXJKbND7AMQ&cMj60B5TNObaZxYybcN07*qoM6N<$g3m;S%K!iX literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png b/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..fe730945a01f64a61e2235dbe3f45b08f7729182 GIT binary patch literal 462 zcmV;<0WtoGP)-}iV`2<;=$?g5M=KQbZ{F&YRNy7Nn@%_*5{gvDM0aKI4?ESmw z{NnZg)A0R`+4?NF_RZexyVB&^^ZvN!{I28tr{Vje;QNTz`dG&Jz0~Ek&f2;*Z7>B|cg}xYpxEFY+0YrKLF;^Q+-HreN0P{&i zK~zY`?b7ECf-n?@;d<&orQ*Q7KoR%4|C>{W^h6@&01>0SKS`dn{Q}GT%Qj_{PLZ_& zs`MFI#j-(>?bvdZ!8^xTwlY{qA)T4QLbY@j(!YJ7aXJervHy6HaG_2SB`6CC{He}f zHVw(fJWApwPq!6VY7r1w-Fs)@ox~N+q|w~e;JI~C4Vf^@d>Wvj=fl`^u9x9wd9 zR%3*Q+)t%S!MU_`id^@&Y{y7-r98lZX0?YrHlfmwb?#}^1b{8g&KzmkE(L>Z&)179 zp<)v6Y}pRl100G2FL_t(o!|l{-Q-VMg#&MKg7c{O0 z2wJImOS3Gy*Z2Qifdv~JYOp;v+U)a|nLoc7hNH;I$;lzDt$}rkaFw1mYK5_0Q(Sut zvbEloxON7$+HSOgC9Z8ltuC&0OSF!-mXv5caV>#bc3@hBPX@I$58-z}(ZZE!t-aOG zpjNkbau@>yEzH(5Yj4kZiMH32XI!4~gVXNnjAvRx;Sdg^`>2DpUEwoMhTs_st8pKG z(%SHyHdU&v%f36~uERh!bd`!T2dw;z6PrOTQ7Vt*#9F2uHlUVnb#ev_o^fh}Dzmq} zWtlk35}k=?xj28uO|5>>$yXadTUE@@IPpgH`gJ~Ro4>jd1IF|(+IX>8M4Ps{PNvmI zNj4D+XgN83gPt_Gm}`Ybv{;+&yu-C(Grdiahmo~BjG-l&mWM+{e5M1sm&=xduwgM9 z`8OEh`=F3r`^E{n_;%9weN{cf2%7=VzC@cYj+lg>+3|D|_1C@{hcU(DyQG_BvBWe? zvTv``=%b1zrol#=R`JB)>cdjpWt&rLJgVp-t?DREyuq1A%0Z4)6_WsQ7{nzjN zo!X zGXV)2i3kcZIL~_j>uIKPK_zib+3T+Nt3Mb&Br)s)UIaA}@p{wDda>7=Q|mGRp7pqY zkJ!7E{MNz$9nOwoVqpFb)}$IP24Wn2JJ=Cw(!`OXJBr45rP>>AQr$6c7slJWvbpNW z@KTwna6d?PP>hvXCcp=4F;=GR@R4E7{4VU^0p4F>v^#A|>07*qoM6N<$f*5nx ACIA2c literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png b/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..502f463a9bc882b461c96aadf492d1729e49e725 GIT binary patch literal 586 zcmV-Q0=4~#P)+}#`wDE{8-2Mebf5<{{PqV{TgVcv*r8?UZ3{-|G?_}T*&y;@cqf{ z{Q*~+qr%%p!1pS*_Uicl#q9lc(D`!D`LN62sNwq{oYw(Wmhk)k<@f$!$@ng~_5)Ru z0Z)trIA5^j{DIW^c+vT2%lW+2<(RtE2wR;4O@)Tm`Xr*?A(qYoM}7i5Yxw>D(&6ou zxz!_Xr~yNF+waPe00049Nkl*;a!v6h%{rlvIH#gW3s8p;bFr=l}mRqpW2h zw=OA%hdyL~z+UHOzl0eKhEr$YYOL-c-%Y<)=j?(bzDweB7{b+%_ypvm_cG{SvM=DK zhv{K@m>#Bw>2W$eUI#iU)Wdgs8Y3U+A$Gd&{+j)d)BmGKx+43U_!tik_YlN)>$7G! zhkE!s;%oku3;IwG3U^2kw?z+HM)jB{@zFhK8P#KMSytSthr+4!c(5c%+^UBn`0X*2 zy3(k600_CSZj?O$Qu%&$;|TGUJrptR(HzyIx>5E(2r{eA(<6t3e3I0B)7d6s7?Z5J zZ!rtKvA{MiEBm&KFtoifx>5P^Z=vl)95XJn()aS5%ad(s?4-=Tkis9IGu{`Fy8r+H07*qoM6N<$f20Z)wqMt%V?S?~D#06};F zA3KcL`Wb+>5ObvgQIG&ig8(;V04hz?@cqy3{mSh8o!|U|)cI!1_+!fWH@o*8vh^CU z^ws0;(c$gI+2~q^tO#GDHf@=;DncUw00J^eL_t(&-tE|HQ`%4vfZ;WsBqu-$0nu1R zq^Vj;p$clf^?twn|KHO+IGt^q#a3X?w9dXC@*yxhv&l}F322(8Y1&=P&I}~G@#h6; z1CV9ecD9ZEe87{{NtI*)_aJ<`kJa z?5=RBtFF50s;jQLFil-`)m2wrb=6h(&brpj%nG_U&ut~$?8Rokzxi8zJoWr#2dto5 zOX_URcc<1`Iky+jc;A%Vzx}1QU{2$|cKPom2Vf1{8m`vja4{F>HS?^Nc^rp}xo+Nh zxd}eOm`fm3@MQC1< zIk&aCjb~Yh%5+Yq0`)D;q{#-Uqlv*o+Oor zE!I71Z@ASH3grl8&P^L0WpavHoP|UX4e?!igT`4?AZk$hu*@%6WJ;zDOGlw7kj@ zY5!B-0ft0f?Lgb>C;$Ke07*qoM6N<$f~t1N9smFU literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png b/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..0ec303439225b78712f49115768196d8d76f6790 GIT binary patch literal 862 zcmV-k1EKthP)20Z)wqMt%V?S?~D#06};F zA3KcL`Wb+>5ObvgQIG&ig8(;V04hz?@cqy3{mSh8o!|U|)cI!1_+!fWH@o*8vh^CU z^ws0;(c$gI+2~q^tO#GDHf@=;DncUw00J^eL_t(&-tE|HQ`%4vfZ;WsBqu-$0nu1R zq^Vj;p$clf^?twn|KHO+IGt^q#a3X?w9dXC@*yxhv&l}F322(8Y1&=P&I}~G@#h6; z1CV9ecD9ZEe87{{NtI*)_aJ<`kJa z?5=RBtFF50s;jQLFil-`)m2wrb=6h(&brpj%nG_U&ut~$?8Rokzxi8zJoWr#2dto5 zOX_URcc<1`Iky+jc;A%Vzx}1QU{2$|cKPom2Vf1{8m`vja4{F>HS?^Nc^rp}xo+Nh zxd}eOm`fm3@MQC1< zIk&aCjb~Yh%5+Yq0`)D;q{#-Uqlv*o+Oor zE!I71Z@ASH3grl8&P^L0WpavHoP|UX4e?!igT`4?AZk$hu*@%6WJ;zDOGlw7kj@ zY5!B-0ft0f?Lgb>C;$Ke07*qoM6N<$f~t1N9smFU literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png b/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png new file mode 100644 index 0000000000000000000000000000000000000000..e9f5fea27c705180eb716271f41b582e76dcbd90 GIT binary patch literal 1674 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 literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png b/packages/re_editor/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..0467bf12aa4d28f374bb26596605a46dcbb3e7c8 GIT binary patch literal 1418 zcmV;51$Fv~P)q zKfU)WzW*n(@|xWGCA9ScMt*e9`2kdxPQ&&>|-UCa7_51w+ zLUsW@ZzZSW0y$)Hp~e9%PvP|a03ks1`~K?q{u;6NC8*{AOqIUq{CL&;p56Lf$oQGq z^={4hPQv)y=I|4n+?>7Fim=dxt1 z2H+Dm+1+fh+IF>G0SjJMkQQre1x4|G*Z==(Ot&kCnUrL4I(rf(ucITwmuHf^hXiJT zkdTm&kdTm&kdTm&kdP`esgWG0BcWCVkVZ&2dUwN`cgM8QJb`Z7Z~e<&Yj2(}>Tmf` zm1{eLgw!b{bXkjWbF%dTkTZEJWyWOb##Lfw4EK2}<0d6%>AGS{po>WCOy&f$Tay_> z?NBlkpo@s-O;0V%Y_Xa-G#_O08q5LR*~F%&)}{}r&L%Sbs8AS4t7Y0NEx*{soY=0MZExqA5XHQkqi#4gW3 zqODM^iyZl;dvf)-bOXtOru(s)Uc7~BFx{w-FK;2{`VA?(g&@3z&bfLFyctOH!cVsF z7IL=fo-qBndRUm;kAdXR4e6>k-z|21AaN%ubeVrHl*<|s&Ax@W-t?LR(P-24A5=>a z*R9#QvjzF8n%@1Nw@?CG@6(%>+-0ASK~jEmCV|&a*7-GKT72W<(TbSjf)&Eme6nGE z>Gkj4Sq&2e+-G%|+NM8OOm5zVl9{Z8Dd8A5z3y8mZ=4Bv4%>as_{9cN#bm~;h>62( zdqY93Zy}v&c4n($Vv!UybR8ocs7#zbfX1IY-*w~)p}XyZ-SFC~4w>BvMVr`dFbelV{lLL0bx7@*ZZdebr3`sP;? zVImji)kG)(6Juv0lz@q`F!k1FE;CQ(D0iG$wchPbKZQELlsZ#~rt8#90Y_Xh&3U-< z{s<&cCV_1`^TD^ia9!*mQDq& zn2{r`j};V|uV%_wsP!zB?m%;FeaRe+X47K0e+KE!8C{gAWF8)lCd1u1%~|M!XNRvw zvtqy3iz0WSpWdhn6$hP8PaRBmp)q`#PCA`Vd#Tc$@f1tAcM>f_I@bC)hkI9|o(Iqv zo}Piadq!j76}004RBio<`)70k^`K1NK)q>w?p^C6J2ZC!+UppiK6&y3Kmbv&O!oYF z34$0Z;QO!JOY#!`qyGH<3Pd}Pt@q*A0V=3SVtWKRR8d8Z&@)3qLPA19LPA19LPEUC YUoZo%k(ykuW&i*H07*qoM6N<$f+CH{y8r+H literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json b/packages/re_editor/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json new file mode 100644 index 0000000..0bedcf2 --- /dev/null +++ b/packages/re_editor/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json @@ -0,0 +1,23 @@ +{ + "images" : [ + { + "idiom" : "universal", + "filename" : "LaunchImage.png", + "scale" : "1x" + }, + { + "idiom" : "universal", + "filename" : "LaunchImage@2x.png", + "scale" : "2x" + }, + { + "idiom" : "universal", + "filename" : "LaunchImage@3x.png", + "scale" : "3x" + } + ], + "info" : { + "version" : 1, + "author" : "xcode" + } +} diff --git a/packages/re_editor/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png b/packages/re_editor/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png new file mode 100644 index 0000000000000000000000000000000000000000..9da19eacad3b03bb08bbddbbf4ac48dd78b3d838 GIT binary patch literal 68 zcmeAS@N?(olHy`uVBq!ia0vp^j3CUx0wlM}@Gt=>Zci7-kcv6Uzs@r-FtIZ-&5|)J Q1PU{Fy85}Sb4q9e0B4a5jsO4v literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png b/packages/re_editor/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..9da19eacad3b03bb08bbddbbf4ac48dd78b3d838 GIT binary patch literal 68 zcmeAS@N?(olHy`uVBq!ia0vp^j3CUx0wlM}@Gt=>Zci7-kcv6Uzs@r-FtIZ-&5|)J Q1PU{Fy85}Sb4q9e0B4a5jsO4v literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png b/packages/re_editor/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png new file mode 100644 index 0000000000000000000000000000000000000000..9da19eacad3b03bb08bbddbbf4ac48dd78b3d838 GIT binary patch literal 68 zcmeAS@N?(olHy`uVBq!ia0vp^j3CUx0wlM}@Gt=>Zci7-kcv6Uzs@r-FtIZ-&5|)J Q1PU{Fy85}Sb4q9e0B4a5jsO4v literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md b/packages/re_editor/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md new file mode 100644 index 0000000..89c2725 --- /dev/null +++ b/packages/re_editor/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md @@ -0,0 +1,5 @@ +# Launch Screen Assets + +You can customize the launch screen with your own desired assets by replacing the image files in this directory. + +You can also do it by opening your Flutter project's Xcode project with `open ios/Runner.xcworkspace`, selecting `Runner/Assets.xcassets` in the Project Navigator and dropping in the desired images. \ No newline at end of file diff --git a/packages/re_editor/example/ios/Runner/Base.lproj/LaunchScreen.storyboard b/packages/re_editor/example/ios/Runner/Base.lproj/LaunchScreen.storyboard new file mode 100644 index 0000000..f2e259c --- /dev/null +++ b/packages/re_editor/example/ios/Runner/Base.lproj/LaunchScreen.storyboard @@ -0,0 +1,37 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/packages/re_editor/example/ios/Runner/Base.lproj/Main.storyboard b/packages/re_editor/example/ios/Runner/Base.lproj/Main.storyboard new file mode 100644 index 0000000..f3c2851 --- /dev/null +++ b/packages/re_editor/example/ios/Runner/Base.lproj/Main.storyboard @@ -0,0 +1,26 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/packages/re_editor/example/ios/Runner/Info.plist b/packages/re_editor/example/ios/Runner/Info.plist new file mode 100644 index 0000000..5458fc4 --- /dev/null +++ b/packages/re_editor/example/ios/Runner/Info.plist @@ -0,0 +1,49 @@ + + + + + CFBundleDevelopmentRegion + $(DEVELOPMENT_LANGUAGE) + CFBundleDisplayName + Example + CFBundleExecutable + $(EXECUTABLE_NAME) + CFBundleIdentifier + $(PRODUCT_BUNDLE_IDENTIFIER) + CFBundleInfoDictionaryVersion + 6.0 + CFBundleName + example + CFBundlePackageType + APPL + CFBundleShortVersionString + $(FLUTTER_BUILD_NAME) + CFBundleSignature + ???? + CFBundleVersion + $(FLUTTER_BUILD_NUMBER) + LSRequiresIPhoneOS + + UILaunchStoryboardName + LaunchScreen + UIMainStoryboardFile + Main + UISupportedInterfaceOrientations + + UIInterfaceOrientationPortrait + UIInterfaceOrientationLandscapeLeft + UIInterfaceOrientationLandscapeRight + + UISupportedInterfaceOrientations~ipad + + UIInterfaceOrientationPortrait + UIInterfaceOrientationPortraitUpsideDown + UIInterfaceOrientationLandscapeLeft + UIInterfaceOrientationLandscapeRight + + CADisableMinimumFrameDurationOnPhone + + UIApplicationSupportsIndirectInputEvents + + + diff --git a/packages/re_editor/example/ios/Runner/Runner-Bridging-Header.h b/packages/re_editor/example/ios/Runner/Runner-Bridging-Header.h new file mode 100644 index 0000000..308a2a5 --- /dev/null +++ b/packages/re_editor/example/ios/Runner/Runner-Bridging-Header.h @@ -0,0 +1 @@ +#import "GeneratedPluginRegistrant.h" diff --git a/packages/re_editor/example/ios/RunnerTests/RunnerTests.swift b/packages/re_editor/example/ios/RunnerTests/RunnerTests.swift new file mode 100644 index 0000000..86a7c3b --- /dev/null +++ b/packages/re_editor/example/ios/RunnerTests/RunnerTests.swift @@ -0,0 +1,12 @@ +import Flutter +import UIKit +import XCTest + +class RunnerTests: XCTestCase { + + func testExample() { + // If you add code to the Runner application, consider adding tests here. + // See https://developer.apple.com/documentation/xctest for more information about using XCTest. + } + +} diff --git a/packages/re_editor/example/lib/editor_autocomplete.dart b/packages/re_editor/example/lib/editor_autocomplete.dart new file mode 100644 index 0000000..6105a56 --- /dev/null +++ b/packages/re_editor/example/lib/editor_autocomplete.dart @@ -0,0 +1,481 @@ +import 'dart:math'; + +import 'package:flutter/material.dart'; +import 'package:flutter/services.dart'; +import 'package:re_editor/re_editor.dart'; +import 'package:re_editor_exmaple/find.dart'; +import 'package:re_editor_exmaple/menu.dart'; +import 'package:re_highlight/languages/dart.dart'; +import 'package:re_highlight/styles/atom-one-light.dart'; + +const List _kStringPrompts = [ + CodeFieldPrompt( + word: 'length', + type: 'int' + ), + CodeFieldPrompt( + word: 'isEmpty', + type: 'bool' + ), + CodeFieldPrompt( + word: 'isNotEmpty', + type: 'bool' + ), + CodeFieldPrompt( + word: 'characters', + type: 'Characters' + ), + CodeFieldPrompt( + word: 'hashCode', + type: 'int' + ), + CodeFieldPrompt( + word: 'codeUnits', + type: 'List' + ), + CodeFieldPrompt( + word: 'runes', + type: 'Runes' + ), + CodeFunctionPrompt( + word: 'codeUnitAt', + type: 'int', + parameters: { + 'index': 'int' + } + ), + CodeFunctionPrompt( + word: 'replaceAll', + type: 'String', + parameters: { + 'from': 'Pattern', + 'replace': 'String', + } + ), + CodeFunctionPrompt( + word: 'contains', + type: 'bool', + parameters: { + 'other': 'String', + } + ), + CodeFunctionPrompt( + word: 'split', + type: 'List', + parameters: { + 'pattern': 'Pattern', + } + ), + CodeFunctionPrompt( + word: 'endsWith', + type: 'bool', + parameters: { + 'other': 'String', + } + ), + CodeFunctionPrompt( + word: 'startsWith', + type: 'bool', + parameters: { + 'other': 'String', + } + ) +]; + +class AutoCompleteEditor extends StatefulWidget { + + const AutoCompleteEditor({super.key}); + + @override + State createState() => _AutoCompleteEditorState(); + +} + +class _AutoCompleteEditorState extends State { + + final CodeLineEditingController _controller = CodeLineEditingController(); + + @override + void initState() { + rootBundle.loadString('assets/code.dart').then((value) { + _controller.text = value; + }); + super.initState(); + } + + @override + Widget build(BuildContext context) { + return CodeAutocomplete( + viewBuilder: (context, notifier, onSelected) { + return _DefaultCodeAutocompleteListView( + notifier: notifier, + onSelected: onSelected, + ); + }, + promptsBuilder: DefaultCodeAutocompletePromptsBuilder( + language: langDart, + directPrompts: const [ + CodeFieldPrompt( + word: 'foo', + type: 'String' + ), + CodeFieldPrompt( + word: 'bar', + type: 'String' + ), + CodeFunctionPrompt( + word: 'hello', + type: 'void', + parameters: { + 'value': 'String', + } + ) + ], + relatedPrompts: { + 'foo': _kStringPrompts, + 'bar': _kStringPrompts, + }, + ), + child: CodeEditor( + style: CodeEditorStyle( + fontSize: 18, + codeTheme: CodeHighlightTheme( + languages: { + 'dart': CodeHighlightThemeMode( + mode: langDart + ) + }, + theme: atomOneLightTheme + ), + ), + controller: _controller, + wordWrap: false, + indicatorBuilder: (context, editingController, chunkController, notifier) { + return Row( + children: [ + DefaultCodeLineNumber( + controller: editingController, + notifier: notifier, + ), + DefaultCodeChunkIndicator( + width: 20, + controller: chunkController, + notifier: notifier + ) + ], + ); + }, + findBuilder: (context, controller, readOnly) => CodeFindPanelView(controller: controller, readOnly: readOnly), + toolbarController: const ContextMenuControllerImpl(), + leadingDivider: Container( + width: 1, + color: Colors.blue + ), + ) + ); + } + +} + +class _DefaultCodeAutocompleteListView extends StatefulWidget implements PreferredSizeWidget { + + static const double kItemHeight = 26; + + final ValueNotifier notifier; + final ValueChanged onSelected; + + const _DefaultCodeAutocompleteListView({ + required this.notifier, + required this.onSelected, + }); + + @override + Size get preferredSize => Size( + 250, + // 2 is border size + min(kItemHeight * notifier.value.prompts.length, 150) + 2 + ); + + @override + State createState() => _DefaultCodeAutocompleteListViewState(); + +} + +class _DefaultCodeAutocompleteListViewState extends State<_DefaultCodeAutocompleteListView> { + + @override + void initState() { + widget.notifier.addListener(_onValueChanged); + super.initState(); + } + + @override + void dispose() { + widget.notifier.removeListener(_onValueChanged); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + return Container( + constraints: BoxConstraints.loose(widget.preferredSize), + decoration: BoxDecoration( + color: Colors.grey, + borderRadius: BorderRadius.circular(6) + ), + child: AutoScrollListView( + controller: ScrollController(), + initialIndex: widget.notifier.value.index, + scrollDirection: Axis.vertical, + itemCount: widget.notifier.value.prompts.length, + itemBuilder:(context, index) { + final CodePrompt prompt = widget.notifier.value.prompts[index]; + final BorderRadius radius = BorderRadius.only( + topLeft: index == 0 ? const Radius.circular(5) : Radius.zero, + topRight: index == 0 ? const Radius.circular(5) : Radius.zero, + bottomLeft: index == widget.notifier.value.prompts.length - 1 ? const Radius.circular(5) : Radius.zero, + bottomRight: index == widget.notifier.value.prompts.length - 1 ? const Radius.circular(5) : Radius.zero, + ); + return InkWell( + borderRadius: radius, + onTap: () { + widget.onSelected(widget.notifier.value.copyWith( + index: index + ).autocomplete); + }, + child: Container( + width: double.infinity, + height: _DefaultCodeAutocompleteListView.kItemHeight, + padding: const EdgeInsets.only( + left: 5, + right: 5 + ), + alignment: Alignment.centerLeft, + decoration: BoxDecoration( + color: index == widget.notifier.value.index ? const Color.fromARGB(255, 255, 140, 0) : null, + borderRadius: radius + ), + child: RichText( + text: prompt.createSpan(context, widget.notifier.value.input), + overflow: TextOverflow.ellipsis, + maxLines: 1, + ), + ) + ); + }, + ) + ); + } + + void _onValueChanged() { + setState(() { + }); + } + +} + +extension _CodePromptExtension on CodePrompt { + + InlineSpan createSpan(BuildContext context, String input) { + const TextStyle style = TextStyle(); + final InlineSpan span = style.createSpan( + value: word, + anchor: input, + color: Colors.blue, + fontWeight: FontWeight.bold, + ); + final CodePrompt prompt = this; + if (prompt is CodeFieldPrompt) { + return TextSpan( + children: [ + span, + TextSpan( + text: ' ${prompt.type}', + style: style.copyWith( + color: Colors.cyan + ) + ) + ] + ); + } + if (prompt is CodeFunctionPrompt) { + return TextSpan( + children: [ + span, + TextSpan( + text: '(...) -> ${prompt.type}', + style: style.copyWith( + color: Colors.cyan + ) + ) + ] + ); + } + return span; + } + +} + +extension _TextStyleExtension on TextStyle { + + InlineSpan createSpan({ + required String value, + required String anchor, + required Color color, + FontWeight? fontWeight, + bool casesensitive = false, + }) { + if (anchor.isEmpty) { + return TextSpan( + text: value, + style: this, + ); + } + final int index; + if (casesensitive) { + index = value.indexOf(anchor); + } else { + index = value.toLowerCase().indexOf(anchor.toLowerCase()); + } + if (index < 0) { + return TextSpan( + text: value, + style: this, + ); + } + return TextSpan( + children: [ + TextSpan( + text: value.substring(0, index), + style: this + ), + TextSpan( + text: value.substring(index, index + anchor.length), + style: copyWith( + color: color, + fontWeight: fontWeight, + ) + ), + TextSpan( + text: value.substring(index + anchor.length), + style: this + ) + ] + ); + } + +} + +class AutoScrollListView extends StatefulWidget { + + final ScrollController controller; + final IndexedWidgetBuilder itemBuilder; + final int itemCount; + final int initialIndex; + final Axis scrollDirection; + + const AutoScrollListView({ + super.key, + required this.controller, + required this.itemBuilder, + required this.itemCount, + this.initialIndex = 0, + this.scrollDirection = Axis.vertical, + }); + + @override + State createState() => _AutoScrollListViewState(); + +} + +class _AutoScrollListViewState extends State { + + late final List _keys; + + @override + void initState() { + _keys = List.generate(widget.itemCount, (index) => GlobalKey()); + WidgetsBinding.instance.addPostFrameCallback((_) { + _autoScroll(); + }); + super.initState(); + } + + @override + void didUpdateWidget(covariant AutoScrollListView oldWidget) { + if (widget.itemCount > oldWidget.itemCount) { + _keys.addAll(List.generate(widget.itemCount - oldWidget.itemCount, (index) => GlobalKey())); + } else if (widget.itemCount < oldWidget.itemCount) { + _keys.sublist(oldWidget.itemCount - widget.itemCount); + } + WidgetsBinding.instance.addPostFrameCallback((_) { + _autoScroll(); + }); + super.didUpdateWidget(oldWidget); + } + + @override + Widget build(BuildContext context) { + final List widgets = []; + for (int i = 0; i < widget.itemCount; i++) { + widgets.add(Container( + key: _keys[i], + child: widget.itemBuilder(context, i), + )); + } + return SingleChildScrollView( + controller: widget.controller, + scrollDirection: widget.scrollDirection, + child: isHorizontal ? Row( + children: widgets, + ) : Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: widgets, + ), + ); + } + + void _autoScroll() { + final ScrollController controller = widget.controller; + if (!controller.hasClients) { + return; + } + if (controller.position.maxScrollExtent == 0) { + return; + } + double pre = 0; + double cur = 0; + for (int i = 0; i < _keys.length; i++) { + final RenderObject? obj = _keys[i].currentContext?.findRenderObject(); + if (obj == null || obj is! RenderBox) { + continue; + } + if (isHorizontal) { + double width = obj.size.width; + if (i == widget.initialIndex) { + cur = pre + width; + break; + } + pre += width; + } else { + double height = obj.size.height; + if (i == widget.initialIndex) { + cur = pre + height; + break; + } + pre += height; + } + } + if (pre == cur) { + return; + } + if (pre < widget.controller.offset) { + controller.jumpTo(pre - 1); + } else if (cur > controller.offset + controller.position.viewportDimension) { + controller.jumpTo(cur - controller.position.viewportDimension); + } + } + + bool get isHorizontal => widget.scrollDirection == Axis.horizontal; + +} \ No newline at end of file diff --git a/packages/re_editor/example/lib/editor_basic_field.dart b/packages/re_editor/example/lib/editor_basic_field.dart new file mode 100644 index 0000000..07a722f --- /dev/null +++ b/packages/re_editor/example/lib/editor_basic_field.dart @@ -0,0 +1,16 @@ +import 'package:flutter/material.dart'; +import 'package:re_editor/re_editor.dart'; + +class BasicField extends StatelessWidget { + + const BasicField({super.key}); + + @override + Widget build(BuildContext context) { + return CodeEditor( + wordWrap: false, + controller: CodeLineEditingController.fromText(('${'Hello Reqable💐👏 ' * 10}\n') * 100), + ); + } + +} \ No newline at end of file diff --git a/packages/re_editor/example/lib/editor_json.dart b/packages/re_editor/example/lib/editor_json.dart new file mode 100644 index 0000000..eedaf30 --- /dev/null +++ b/packages/re_editor/example/lib/editor_json.dart @@ -0,0 +1,69 @@ +import 'package:flutter/material.dart'; +import 'package:flutter/services.dart'; +import 'package:re_editor/re_editor.dart'; +import 'package:re_editor_exmaple/find.dart'; +import 'package:re_editor_exmaple/menu.dart'; +import 'package:re_highlight/languages/json.dart'; +import 'package:re_highlight/styles/atom-one-light.dart'; + +class JsonEditor extends StatefulWidget { + + const JsonEditor({super.key}); + + @override + State createState() => _JsonEditorState(); + +} + +class _JsonEditorState extends State { + + final CodeLineEditingController _controller = CodeLineEditingController(); + + @override + void initState() { + rootBundle.loadString('assets/code.json').then((value) { + _controller.text = value; + }); + super.initState(); + } + + @override + Widget build(BuildContext context) { + return CodeEditor( + style: CodeEditorStyle( + codeTheme: CodeHighlightTheme( + languages: { + 'json': CodeHighlightThemeMode( + mode: langJson + ) + }, + theme: atomOneLightTheme + ), + ), + controller: _controller, + wordWrap: false, + indicatorBuilder: (context, editingController, chunkController, notifier) { + return Row( + children: [ + DefaultCodeLineNumber( + controller: editingController, + notifier: notifier, + ), + DefaultCodeChunkIndicator( + width: 20, + controller: chunkController, + notifier: notifier + ) + ], + ); + }, + findBuilder: (context, controller, readOnly) => CodeFindPanelView(controller: controller, readOnly: readOnly), + toolbarController: const ContextMenuControllerImpl(), + leadingDivider: Container( + width: 1, + color: Colors.blue + ), + ); + } + +} \ No newline at end of file diff --git a/packages/re_editor/example/lib/editor_large_text.dart b/packages/re_editor/example/lib/editor_large_text.dart new file mode 100644 index 0000000..6d44b97 --- /dev/null +++ b/packages/re_editor/example/lib/editor_large_text.dart @@ -0,0 +1,57 @@ +import 'package:flutter/material.dart'; +import 'package:flutter/services.dart'; +import 'package:re_editor/re_editor.dart'; +import 'package:re_editor_exmaple/find.dart'; +import 'package:re_editor_exmaple/menu.dart'; + +class LargeTextEditor extends StatefulWidget { + + const LargeTextEditor({super.key}); + + @override + State createState() => _LargeTextEditorState(); + +} + +class _LargeTextEditorState extends State { + + final CodeLineEditingController _controller = CodeLineEditingController(); + + @override + void initState() { + rootBundle.loadString('assets/large.txt').then((value) { + _controller.text = value; + }); + super.initState(); + } + + @override + Widget build(BuildContext context) { + return CodeEditor( + controller: _controller, + wordWrap: false, + indicatorBuilder: (context, editingController, chunkController, notifier) { + return Row( + children: [ + DefaultCodeLineNumber( + controller: editingController, + notifier: notifier, + ), + DefaultCodeChunkIndicator( + width: 20, + controller: chunkController, + notifier: notifier + ) + ], + ); + }, + findBuilder: (context, controller, readOnly) => CodeFindPanelView(controller: controller, readOnly: readOnly), + toolbarController: const ContextMenuControllerImpl(), + leadingDivider: Container( + width: 1, + color: Colors.blue + ), + ); + } + +} \ No newline at end of file diff --git a/packages/re_editor/example/lib/find.dart b/packages/re_editor/example/lib/find.dart new file mode 100644 index 0000000..fb6f290 --- /dev/null +++ b/packages/re_editor/example/lib/find.dart @@ -0,0 +1,283 @@ +import 'dart:math'; + +import 'package:flutter/material.dart'; +import 'package:re_editor/re_editor.dart'; + +const EdgeInsetsGeometry _kDefaultFindMargin = EdgeInsets.only( + right: 10 +); +const double _kDefaultFindPanelWidth = 360; +const double _kDefaultFindPanelHeight = 36; +const double _kDefaultReplacePanelHeight = _kDefaultFindPanelHeight * 2; +const double _kDefaultFindIconSize = 16; +const double _kDefaultFindIconWidth = 30; +const double _kDefaultFindIconHeight = 30; +const double _kDefaultFindInputFontSize = 13; +const double _kDefaultFindResultFontSize = 12; +const EdgeInsetsGeometry _kDefaultFindPadding = EdgeInsets.only( + left: 5, + right: 5, + top: 2.5, + bottom: 2.5 +); +const EdgeInsetsGeometry _kDefaultFindInputContentPadding = EdgeInsets.only( + left: 5, + right: 5, +); + +class CodeFindPanelView extends StatelessWidget implements PreferredSizeWidget { + + final CodeFindController controller; + final EdgeInsetsGeometry margin; + final bool readOnly; + final Color? iconColor; + final Color? iconSelectedColor; + final double iconSize; + final double inputFontSize; + final double resultFontSize; + final Color? inputTextColor; + final Color? resultFontColor; + final EdgeInsetsGeometry padding; + final InputDecoration decoration; + + const CodeFindPanelView({ + super.key, + required this.controller, + this.margin = _kDefaultFindMargin, + required this.readOnly, + this.iconSelectedColor, + this.iconColor, + this.iconSize = _kDefaultFindIconSize, + this.inputFontSize = _kDefaultFindInputFontSize, + this.resultFontSize = _kDefaultFindResultFontSize, + this.inputTextColor, + this.resultFontColor, + this.padding = _kDefaultFindPadding, + this.decoration = const InputDecoration( + filled: true, + contentPadding: _kDefaultFindInputContentPadding, + border: OutlineInputBorder( + borderRadius: BorderRadius.all(Radius.circular(0)), + gapPadding: 0 + ), + ) + }); + + @override + Size get preferredSize => Size( + double.infinity, + controller.value == null ? 0 : + ((controller.value!.replaceMode ? _kDefaultReplacePanelHeight : _kDefaultFindPanelHeight) + margin.vertical) + ); + + @override + Widget build(BuildContext context) { + if (controller.value == null) { + return const SizedBox(width: 0, height: 0); + } + return Container( + margin: margin, + alignment: Alignment.topRight, + height: preferredSize.height, + child: SingleChildScrollView( + scrollDirection: Axis.horizontal, + child: SizedBox( + width: _kDefaultFindPanelWidth, + child: Column( + children: [ + _buildFindInputView(context), + if (controller.value!.replaceMode) + _buildReplaceInputView(context), + ], + ), + ), + ) + ); + } + + Widget _buildFindInputView(BuildContext context) { + final CodeFindValue value = controller.value!; + final String result; + if (value.result == null) { + result = 'none'; + } else { + result = '${value.result!.index + 1}/${value.result!.matches.length}'; + } + return Row( + children: [ + SizedBox( + width: _kDefaultFindPanelWidth / 1.75, + height: _kDefaultFindPanelHeight, + child: Stack( + alignment: Alignment.center, + children: [ + _buildTextField( + context: context, + controller: controller.findInputController, + focusNode: controller.findInputFocusNode, + iconsWidth: _kDefaultFindIconWidth * 1.5 + ), + Row( + mainAxisAlignment: MainAxisAlignment.end, + children: [ + _buildCheckText( + context: context, + text: 'Aa', + checked: value.option.caseSensitive, + onPressed: () { + controller.toggleCaseSensitive(); + } + ), + _buildCheckText( + context: context, + text: '.*', + checked: value.option.regex, + onPressed: () { + controller.toggleRegex(); + } + ) + ], + ) + ], + ) + ), + Text(result, + style: TextStyle( + color: resultFontColor, + fontSize: resultFontSize + ) + ), + Expanded( + child: Row( + mainAxisAlignment: MainAxisAlignment.end, + children: [ + _buildIconButton( + onPressed: value.result == null ? null : () { + controller.previousMatch(); + }, + icon: Icons.arrow_upward, + tooltip: 'Previous' + ), + _buildIconButton( + onPressed: value.result == null ? null : () { + controller.nextMatch(); + }, + icon: Icons.arrow_downward, + tooltip: 'Next' + ), + _buildIconButton( + onPressed: () { + controller.close(); + }, + icon: Icons.close, + tooltip: 'Close' + ) + ], + ), + ) + ], + ); + } + + Widget _buildReplaceInputView(BuildContext context) { + final CodeFindValue value = controller.value!; + return Row( + children: [ + SizedBox( + width: _kDefaultFindPanelWidth / 1.75, + height: _kDefaultFindPanelHeight, + child: _buildTextField( + context: context, + controller: controller.replaceInputController, + focusNode: controller.replaceInputFocusNode, + ), + ), + _buildIconButton( + onPressed: value.result == null ? null : () { + controller.replaceMatch(); + }, + icon: Icons.done, + tooltip: 'Replace' + ), + _buildIconButton( + onPressed: value.result == null ? null : () { + controller.replaceAllMatches(); + }, + icon: Icons.done_all, + tooltip: 'Replace All' + ) + ], + ); + } + + Widget _buildTextField({ + required BuildContext context, + required TextEditingController controller, + required FocusNode focusNode, + double iconsWidth = 0, + }) { + return Padding( + padding: padding, + child: TextField( + maxLines: 1, + focusNode: focusNode, + style: TextStyle( + color: inputTextColor, + fontSize: inputFontSize + ), + decoration: decoration.copyWith( + contentPadding: (decoration.contentPadding ?? EdgeInsets.zero).add(EdgeInsets.only( + right: iconsWidth + ) + )), + controller: controller, + ), + ); + } + + Widget _buildCheckText({ + required BuildContext context, + required String text, + required bool checked, + required VoidCallback onPressed, + }) { + final Color selectedColor = iconSelectedColor ?? Theme.of(context).primaryColor; + return GestureDetector( + onTap: onPressed, + child: MouseRegion( + cursor: SystemMouseCursors.click, + child: SizedBox( + width: _kDefaultFindIconWidth * 0.75, + child: Text( + text, + style: TextStyle( + color: checked ? selectedColor : iconColor, + fontSize: inputFontSize, + ) + ), + ), + ) + ); + } + + Widget _buildIconButton({ + required IconData icon, + VoidCallback? onPressed, + String? tooltip + }) { + return IconButton( + onPressed: onPressed, + icon: Icon( + icon, + size: iconSize, + ), + constraints: const BoxConstraints( + maxWidth: _kDefaultFindIconWidth, + maxHeight: _kDefaultFindIconHeight + ), + tooltip: tooltip, + splashRadius: max(_kDefaultFindIconWidth, _kDefaultFindIconHeight) / 2, + ); + } + +} \ No newline at end of file diff --git a/packages/re_editor/example/lib/main.dart b/packages/re_editor/example/lib/main.dart new file mode 100644 index 0000000..a245c5f --- /dev/null +++ b/packages/re_editor/example/lib/main.dart @@ -0,0 +1,105 @@ +import 'package:collection/collection.dart'; +import 'package:flutter/material.dart'; +import 'package:re_editor_exmaple/editor_autocomplete.dart'; +import 'package:re_editor_exmaple/editor_basic_field.dart'; +import 'package:re_editor_exmaple/editor_json.dart'; +import 'package:re_editor_exmaple/editor_large_text.dart'; + +void main() { + runApp(const MyApp()); +} + +class MyApp extends StatelessWidget { + const MyApp({Key? key}) : super(key: key); + + // This widget is the root of your application. + @override + Widget build(BuildContext context) { + return MaterialApp( + title: 'Re-Editor', + theme: ThemeData( + colorScheme: const ColorScheme.light( + primary: Color.fromARGB(255, 255, 140, 0), + ) + ), + home: const MyHomePage(title: 'Re-Editor Demo Page'), + ); + } +} + +class MyHomePage extends StatefulWidget { + const MyHomePage({Key? key, required this.title}) : super(key: key); + + // This widget is the home page of your application. It is stateful, meaning + // that it has a State object (defined below) that contains fields that affect + // how it looks. + + // This class is the configuration for the state. It holds the values (in this + // case the title) provided by the parent (in this case the App widget) and + // used by the build method of the State. Fields in a Widget subclass are + // always marked "final". + + final String title; + + @override + State createState() => _MyHomePageState(); +} + +class _MyHomePageState extends State { + + static const Map _editors = { + 'Basic Field': BasicField(), + 'Json Editor': JsonEditor(), + 'Auto Complete': AutoCompleteEditor(), + 'Large Text': LargeTextEditor(), + }; + + int _index = 0; + + @override + Widget build(BuildContext context) { + final Widget child = _editors.values.elementAt(_index); + return Scaffold( + appBar: AppBar( + title: Text(widget.title), + ), + body: Container( + margin: const EdgeInsets.all(20), + child: Column( + children: [ + SingleChildScrollView( + scrollDirection: Axis.horizontal, + child: Row( + children: _editors.entries.mapIndexed((index, entry) { + return TextButton( + onPressed: () { + setState(() { + _index = index; + }); + }, + child: Text( + entry.key, + style: TextStyle( + color: _index == index ? null : Colors.black + ), + ), + ); + }).toList(), + ), + ), + Expanded( + child: Container( + decoration: BoxDecoration( + border: Border.all( + color: Colors.grey + ) + ), + child: child, + ) + ) + ], + ) + ), + ); + } +} \ No newline at end of file diff --git a/packages/re_editor/example/lib/menu.dart b/packages/re_editor/example/lib/menu.dart new file mode 100644 index 0000000..8778eb1 --- /dev/null +++ b/packages/re_editor/example/lib/menu.dart @@ -0,0 +1,65 @@ +import 'package:flutter/material.dart'; +import 'package:re_editor/re_editor.dart'; + +class ContextMenuItemWidget extends PopupMenuItem implements PreferredSizeWidget { + + ContextMenuItemWidget({ + Key? key, + required String text, + required VoidCallback onTap, + }) : super( + key: key, + onTap: onTap, + child: Text(text) + ); + + @override + Size get preferredSize => const Size(150, 25); + +} + +class ContextMenuControllerImpl implements SelectionToolbarController { + + const ContextMenuControllerImpl(); + + @override + void hide(BuildContext context) { + } + + @override + void show({ + required BuildContext context, + required CodeLineEditingController controller, + required TextSelectionToolbarAnchors anchors, + Rect? renderRect, + required LayerLink layerLink, + required ValueNotifier visibility, + }) { + showMenu( + context: context, + position: RelativeRect.fromSize(anchors.primaryAnchor & const Size(150, double.infinity), + MediaQuery.of(context).size), + items: [ + ContextMenuItemWidget( + text: 'Cut', + onTap: () { + controller.cut(); + }, + ), + ContextMenuItemWidget( + text: 'Copy', + onTap: () { + controller.copy(); + }, + ), + ContextMenuItemWidget( + text: 'Paste', + onTap: () { + controller.paste(); + }, + ), + ] + ); + } + +} \ No newline at end of file diff --git a/packages/re_editor/example/linux/CMakeLists.txt b/packages/re_editor/example/linux/CMakeLists.txt new file mode 100644 index 0000000..9cb0d1d --- /dev/null +++ b/packages/re_editor/example/linux/CMakeLists.txt @@ -0,0 +1,145 @@ +# Project-level configuration. +cmake_minimum_required(VERSION 3.10) +project(runner LANGUAGES CXX) + +# The name of the executable created for the application. Change this to change +# the on-disk name of your application. +set(BINARY_NAME "example") +# The unique GTK application identifier for this application. See: +# https://wiki.gnome.org/HowDoI/ChooseApplicationID +set(APPLICATION_ID "com.example.example") + +# Explicitly opt in to modern CMake behaviors to avoid warnings with recent +# versions of CMake. +cmake_policy(SET CMP0063 NEW) + +# Load bundled libraries from the lib/ directory relative to the binary. +set(CMAKE_INSTALL_RPATH "$ORIGIN/lib") + +# Root filesystem for cross-building. +if(FLUTTER_TARGET_PLATFORM_SYSROOT) + set(CMAKE_SYSROOT ${FLUTTER_TARGET_PLATFORM_SYSROOT}) + set(CMAKE_FIND_ROOT_PATH ${CMAKE_SYSROOT}) + set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) + set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY) + set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY) + set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY) +endif() + +# Define build configuration options. +if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES) + set(CMAKE_BUILD_TYPE "Debug" CACHE + STRING "Flutter build mode" FORCE) + set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS + "Debug" "Profile" "Release") +endif() + +# Compilation settings that should be applied to most targets. +# +# Be cautious about adding new options here, as plugins use this function by +# default. In most cases, you should add new options to specific targets instead +# of modifying this function. +function(APPLY_STANDARD_SETTINGS TARGET) + target_compile_features(${TARGET} PUBLIC cxx_std_14) + target_compile_options(${TARGET} PRIVATE -Wall -Werror) + target_compile_options(${TARGET} PRIVATE "$<$>:-O3>") + target_compile_definitions(${TARGET} PRIVATE "$<$>:NDEBUG>") +endfunction() + +# Flutter library and tool build rules. +set(FLUTTER_MANAGED_DIR "${CMAKE_CURRENT_SOURCE_DIR}/flutter") +add_subdirectory(${FLUTTER_MANAGED_DIR}) + +# System-level dependencies. +find_package(PkgConfig REQUIRED) +pkg_check_modules(GTK REQUIRED IMPORTED_TARGET gtk+-3.0) + +add_definitions(-DAPPLICATION_ID="${APPLICATION_ID}") + +# Define the application target. To change its name, change BINARY_NAME above, +# not the value here, or `flutter run` will no longer work. +# +# Any new source files that you add to the application should be added here. +add_executable(${BINARY_NAME} + "main.cc" + "my_application.cc" + "${FLUTTER_MANAGED_DIR}/generated_plugin_registrant.cc" +) + +# Apply the standard set of build settings. This can be removed for applications +# that need different build settings. +apply_standard_settings(${BINARY_NAME}) + +# Add dependency libraries. Add any application-specific dependencies here. +target_link_libraries(${BINARY_NAME} PRIVATE flutter) +target_link_libraries(${BINARY_NAME} PRIVATE PkgConfig::GTK) + +# Run the Flutter tool portions of the build. This must not be removed. +add_dependencies(${BINARY_NAME} flutter_assemble) + +# Only the install-generated bundle's copy of the executable will launch +# correctly, since the resources must in the right relative locations. To avoid +# people trying to run the unbundled copy, put it in a subdirectory instead of +# the default top-level location. +set_target_properties(${BINARY_NAME} + PROPERTIES + RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/intermediates_do_not_run" +) + + +# Generated plugin build rules, which manage building the plugins and adding +# them to the application. +include(flutter/generated_plugins.cmake) + + +# === Installation === +# By default, "installing" just makes a relocatable bundle in the build +# directory. +set(BUILD_BUNDLE_DIR "${PROJECT_BINARY_DIR}/bundle") +if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT) + set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE) +endif() + +# Start with a clean build bundle directory every time. +install(CODE " + file(REMOVE_RECURSE \"${BUILD_BUNDLE_DIR}/\") + " COMPONENT Runtime) + +set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data") +set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}/lib") + +install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}" + COMPONENT Runtime) + +install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" + COMPONENT Runtime) + +install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) + +foreach(bundled_library ${PLUGIN_BUNDLED_LIBRARIES}) + install(FILES "${bundled_library}" + DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) +endforeach(bundled_library) + +# Copy the native assets provided by the build.dart from all packages. +set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/linux/") +install(DIRECTORY "${NATIVE_ASSETS_DIR}" + DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) + +# Fully re-copy the assets directory on each build to avoid having stale files +# from a previous install. +set(FLUTTER_ASSET_DIR_NAME "flutter_assets") +install(CODE " + file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\") + " COMPONENT Runtime) +install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}" + DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime) + +# Install the AOT library on non-Debug builds only. +if(NOT CMAKE_BUILD_TYPE MATCHES "Debug") + install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) +endif() diff --git a/packages/re_editor/example/linux/flutter/CMakeLists.txt b/packages/re_editor/example/linux/flutter/CMakeLists.txt new file mode 100644 index 0000000..d5bd016 --- /dev/null +++ b/packages/re_editor/example/linux/flutter/CMakeLists.txt @@ -0,0 +1,88 @@ +# This file controls Flutter-level build steps. It should not be edited. +cmake_minimum_required(VERSION 3.10) + +set(EPHEMERAL_DIR "${CMAKE_CURRENT_SOURCE_DIR}/ephemeral") + +# Configuration provided via flutter tool. +include(${EPHEMERAL_DIR}/generated_config.cmake) + +# TODO: Move the rest of this into files in ephemeral. See +# https://github.com/flutter/flutter/issues/57146. + +# Serves the same purpose as list(TRANSFORM ... PREPEND ...), +# which isn't available in 3.10. +function(list_prepend LIST_NAME PREFIX) + set(NEW_LIST "") + foreach(element ${${LIST_NAME}}) + list(APPEND NEW_LIST "${PREFIX}${element}") + endforeach(element) + set(${LIST_NAME} "${NEW_LIST}" PARENT_SCOPE) +endfunction() + +# === Flutter Library === +# System-level dependencies. +find_package(PkgConfig REQUIRED) +pkg_check_modules(GTK REQUIRED IMPORTED_TARGET gtk+-3.0) +pkg_check_modules(GLIB REQUIRED IMPORTED_TARGET glib-2.0) +pkg_check_modules(GIO REQUIRED IMPORTED_TARGET gio-2.0) + +set(FLUTTER_LIBRARY "${EPHEMERAL_DIR}/libflutter_linux_gtk.so") + +# Published to parent scope for install step. +set(FLUTTER_LIBRARY ${FLUTTER_LIBRARY} PARENT_SCOPE) +set(FLUTTER_ICU_DATA_FILE "${EPHEMERAL_DIR}/icudtl.dat" PARENT_SCOPE) +set(PROJECT_BUILD_DIR "${PROJECT_DIR}/build/" PARENT_SCOPE) +set(AOT_LIBRARY "${PROJECT_DIR}/build/lib/libapp.so" PARENT_SCOPE) + +list(APPEND FLUTTER_LIBRARY_HEADERS + "fl_basic_message_channel.h" + "fl_binary_codec.h" + "fl_binary_messenger.h" + "fl_dart_project.h" + "fl_engine.h" + "fl_json_message_codec.h" + "fl_json_method_codec.h" + "fl_message_codec.h" + "fl_method_call.h" + "fl_method_channel.h" + "fl_method_codec.h" + "fl_method_response.h" + "fl_plugin_registrar.h" + "fl_plugin_registry.h" + "fl_standard_message_codec.h" + "fl_standard_method_codec.h" + "fl_string_codec.h" + "fl_value.h" + "fl_view.h" + "flutter_linux.h" +) +list_prepend(FLUTTER_LIBRARY_HEADERS "${EPHEMERAL_DIR}/flutter_linux/") +add_library(flutter INTERFACE) +target_include_directories(flutter INTERFACE + "${EPHEMERAL_DIR}" +) +target_link_libraries(flutter INTERFACE "${FLUTTER_LIBRARY}") +target_link_libraries(flutter INTERFACE + PkgConfig::GTK + PkgConfig::GLIB + PkgConfig::GIO +) +add_dependencies(flutter flutter_assemble) + +# === Flutter tool backend === +# _phony_ is a non-existent file to force this command to run every time, +# since currently there's no way to get a full input/output list from the +# flutter tool. +add_custom_command( + OUTPUT ${FLUTTER_LIBRARY} ${FLUTTER_LIBRARY_HEADERS} + ${CMAKE_CURRENT_BINARY_DIR}/_phony_ + COMMAND ${CMAKE_COMMAND} -E env + ${FLUTTER_TOOL_ENVIRONMENT} + "${FLUTTER_ROOT}/packages/flutter_tools/bin/tool_backend.sh" + ${FLUTTER_TARGET_PLATFORM} ${CMAKE_BUILD_TYPE} + VERBATIM +) +add_custom_target(flutter_assemble DEPENDS + "${FLUTTER_LIBRARY}" + ${FLUTTER_LIBRARY_HEADERS} +) diff --git a/packages/re_editor/example/linux/flutter/generated_plugin_registrant.cc b/packages/re_editor/example/linux/flutter/generated_plugin_registrant.cc new file mode 100644 index 0000000..e71a16d --- /dev/null +++ b/packages/re_editor/example/linux/flutter/generated_plugin_registrant.cc @@ -0,0 +1,11 @@ +// +// Generated file. Do not edit. +// + +// clang-format off + +#include "generated_plugin_registrant.h" + + +void fl_register_plugins(FlPluginRegistry* registry) { +} diff --git a/packages/re_editor/example/linux/flutter/generated_plugin_registrant.h b/packages/re_editor/example/linux/flutter/generated_plugin_registrant.h new file mode 100644 index 0000000..e0f0a47 --- /dev/null +++ b/packages/re_editor/example/linux/flutter/generated_plugin_registrant.h @@ -0,0 +1,15 @@ +// +// Generated file. Do not edit. +// + +// clang-format off + +#ifndef GENERATED_PLUGIN_REGISTRANT_ +#define GENERATED_PLUGIN_REGISTRANT_ + +#include + +// Registers Flutter plugins. +void fl_register_plugins(FlPluginRegistry* registry); + +#endif // GENERATED_PLUGIN_REGISTRANT_ diff --git a/packages/re_editor/example/linux/flutter/generated_plugins.cmake b/packages/re_editor/example/linux/flutter/generated_plugins.cmake new file mode 100644 index 0000000..2e1de87 --- /dev/null +++ b/packages/re_editor/example/linux/flutter/generated_plugins.cmake @@ -0,0 +1,23 @@ +# +# Generated file, do not edit. +# + +list(APPEND FLUTTER_PLUGIN_LIST +) + +list(APPEND FLUTTER_FFI_PLUGIN_LIST +) + +set(PLUGIN_BUNDLED_LIBRARIES) + +foreach(plugin ${FLUTTER_PLUGIN_LIST}) + add_subdirectory(flutter/ephemeral/.plugin_symlinks/${plugin}/linux plugins/${plugin}) + target_link_libraries(${BINARY_NAME} PRIVATE ${plugin}_plugin) + list(APPEND PLUGIN_BUNDLED_LIBRARIES $) + list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${plugin}_bundled_libraries}) +endforeach(plugin) + +foreach(ffi_plugin ${FLUTTER_FFI_PLUGIN_LIST}) + add_subdirectory(flutter/ephemeral/.plugin_symlinks/${ffi_plugin}/linux plugins/${ffi_plugin}) + list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${ffi_plugin}_bundled_libraries}) +endforeach(ffi_plugin) diff --git a/packages/re_editor/example/linux/main.cc b/packages/re_editor/example/linux/main.cc new file mode 100644 index 0000000..e7c5c54 --- /dev/null +++ b/packages/re_editor/example/linux/main.cc @@ -0,0 +1,6 @@ +#include "my_application.h" + +int main(int argc, char** argv) { + g_autoptr(MyApplication) app = my_application_new(); + return g_application_run(G_APPLICATION(app), argc, argv); +} diff --git a/packages/re_editor/example/linux/my_application.cc b/packages/re_editor/example/linux/my_application.cc new file mode 100644 index 0000000..0ba8f43 --- /dev/null +++ b/packages/re_editor/example/linux/my_application.cc @@ -0,0 +1,104 @@ +#include "my_application.h" + +#include +#ifdef GDK_WINDOWING_X11 +#include +#endif + +#include "flutter/generated_plugin_registrant.h" + +struct _MyApplication { + GtkApplication parent_instance; + char** dart_entrypoint_arguments; +}; + +G_DEFINE_TYPE(MyApplication, my_application, GTK_TYPE_APPLICATION) + +// Implements GApplication::activate. +static void my_application_activate(GApplication* application) { + MyApplication* self = MY_APPLICATION(application); + GtkWindow* window = + GTK_WINDOW(gtk_application_window_new(GTK_APPLICATION(application))); + + // Use a header bar when running in GNOME as this is the common style used + // by applications and is the setup most users will be using (e.g. Ubuntu + // desktop). + // If running on X and not using GNOME then just use a traditional title bar + // in case the window manager does more exotic layout, e.g. tiling. + // If running on Wayland assume the header bar will work (may need changing + // if future cases occur). + gboolean use_header_bar = TRUE; +#ifdef GDK_WINDOWING_X11 + GdkScreen* screen = gtk_window_get_screen(window); + if (GDK_IS_X11_SCREEN(screen)) { + const gchar* wm_name = gdk_x11_screen_get_window_manager_name(screen); + if (g_strcmp0(wm_name, "GNOME Shell") != 0) { + use_header_bar = FALSE; + } + } +#endif + if (use_header_bar) { + GtkHeaderBar* header_bar = GTK_HEADER_BAR(gtk_header_bar_new()); + gtk_widget_show(GTK_WIDGET(header_bar)); + gtk_header_bar_set_title(header_bar, "example"); + gtk_header_bar_set_show_close_button(header_bar, TRUE); + gtk_window_set_titlebar(window, GTK_WIDGET(header_bar)); + } else { + gtk_window_set_title(window, "example"); + } + + gtk_window_set_default_size(window, 1280, 720); + gtk_widget_show(GTK_WIDGET(window)); + + g_autoptr(FlDartProject) project = fl_dart_project_new(); + fl_dart_project_set_dart_entrypoint_arguments(project, self->dart_entrypoint_arguments); + + FlView* view = fl_view_new(project); + gtk_widget_show(GTK_WIDGET(view)); + gtk_container_add(GTK_CONTAINER(window), GTK_WIDGET(view)); + + fl_register_plugins(FL_PLUGIN_REGISTRY(view)); + + gtk_widget_grab_focus(GTK_WIDGET(view)); +} + +// Implements GApplication::local_command_line. +static gboolean my_application_local_command_line(GApplication* application, gchar*** arguments, int* exit_status) { + MyApplication* self = MY_APPLICATION(application); + // Strip out the first argument as it is the binary name. + self->dart_entrypoint_arguments = g_strdupv(*arguments + 1); + + g_autoptr(GError) error = nullptr; + if (!g_application_register(application, nullptr, &error)) { + g_warning("Failed to register: %s", error->message); + *exit_status = 1; + return TRUE; + } + + g_application_activate(application); + *exit_status = 0; + + return TRUE; +} + +// Implements GObject::dispose. +static void my_application_dispose(GObject* object) { + MyApplication* self = MY_APPLICATION(object); + g_clear_pointer(&self->dart_entrypoint_arguments, g_strfreev); + G_OBJECT_CLASS(my_application_parent_class)->dispose(object); +} + +static void my_application_class_init(MyApplicationClass* klass) { + G_APPLICATION_CLASS(klass)->activate = my_application_activate; + G_APPLICATION_CLASS(klass)->local_command_line = my_application_local_command_line; + G_OBJECT_CLASS(klass)->dispose = my_application_dispose; +} + +static void my_application_init(MyApplication* self) {} + +MyApplication* my_application_new() { + return MY_APPLICATION(g_object_new(my_application_get_type(), + "application-id", APPLICATION_ID, + "flags", G_APPLICATION_NON_UNIQUE, + nullptr)); +} diff --git a/packages/re_editor/example/linux/my_application.h b/packages/re_editor/example/linux/my_application.h new file mode 100644 index 0000000..72271d5 --- /dev/null +++ b/packages/re_editor/example/linux/my_application.h @@ -0,0 +1,18 @@ +#ifndef FLUTTER_MY_APPLICATION_H_ +#define FLUTTER_MY_APPLICATION_H_ + +#include + +G_DECLARE_FINAL_TYPE(MyApplication, my_application, MY, APPLICATION, + GtkApplication) + +/** + * my_application_new: + * + * Creates a new Flutter-based application. + * + * Returns: a new #MyApplication. + */ +MyApplication* my_application_new(); + +#endif // FLUTTER_MY_APPLICATION_H_ diff --git a/packages/re_editor/example/macos/Flutter/Flutter-Debug.xcconfig b/packages/re_editor/example/macos/Flutter/Flutter-Debug.xcconfig new file mode 100644 index 0000000..c2efd0b --- /dev/null +++ b/packages/re_editor/example/macos/Flutter/Flutter-Debug.xcconfig @@ -0,0 +1 @@ +#include "ephemeral/Flutter-Generated.xcconfig" diff --git a/packages/re_editor/example/macos/Flutter/Flutter-Release.xcconfig b/packages/re_editor/example/macos/Flutter/Flutter-Release.xcconfig new file mode 100644 index 0000000..c2efd0b --- /dev/null +++ b/packages/re_editor/example/macos/Flutter/Flutter-Release.xcconfig @@ -0,0 +1 @@ +#include "ephemeral/Flutter-Generated.xcconfig" diff --git a/packages/re_editor/example/macos/Flutter/GeneratedPluginRegistrant.swift b/packages/re_editor/example/macos/Flutter/GeneratedPluginRegistrant.swift new file mode 100644 index 0000000..cccf817 --- /dev/null +++ b/packages/re_editor/example/macos/Flutter/GeneratedPluginRegistrant.swift @@ -0,0 +1,10 @@ +// +// Generated file. Do not edit. +// + +import FlutterMacOS +import Foundation + + +func RegisterGeneratedPlugins(registry: FlutterPluginRegistry) { +} diff --git a/packages/re_editor/example/macos/Runner.xcodeproj/project.pbxproj b/packages/re_editor/example/macos/Runner.xcodeproj/project.pbxproj new file mode 100644 index 0000000..27e0f50 --- /dev/null +++ b/packages/re_editor/example/macos/Runner.xcodeproj/project.pbxproj @@ -0,0 +1,695 @@ +// !$*UTF8*$! +{ + archiveVersion = 1; + classes = { + }; + objectVersion = 54; + objects = { + +/* Begin PBXAggregateTarget section */ + 33CC111A2044C6BA0003C045 /* Flutter Assemble */ = { + isa = PBXAggregateTarget; + buildConfigurationList = 33CC111B2044C6BA0003C045 /* Build configuration list for PBXAggregateTarget "Flutter Assemble" */; + buildPhases = ( + 33CC111E2044C6BF0003C045 /* ShellScript */, + ); + dependencies = ( + ); + name = "Flutter Assemble"; + productName = FLX; + }; +/* End PBXAggregateTarget section */ + +/* Begin PBXBuildFile section */ + 331C80D8294CF71000263BE5 /* RunnerTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 331C80D7294CF71000263BE5 /* RunnerTests.swift */; }; + 335BBD1B22A9A15E00E9071D /* GeneratedPluginRegistrant.swift in Sources */ = {isa = PBXBuildFile; fileRef = 335BBD1A22A9A15E00E9071D /* GeneratedPluginRegistrant.swift */; }; + 33CC10F12044A3C60003C045 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 33CC10F02044A3C60003C045 /* AppDelegate.swift */; }; + 33CC10F32044A3C60003C045 /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 33CC10F22044A3C60003C045 /* Assets.xcassets */; }; + 33CC10F62044A3C60003C045 /* MainMenu.xib in Resources */ = {isa = PBXBuildFile; fileRef = 33CC10F42044A3C60003C045 /* MainMenu.xib */; }; + 33CC11132044BFA00003C045 /* MainFlutterWindow.swift in Sources */ = {isa = PBXBuildFile; fileRef = 33CC11122044BFA00003C045 /* MainFlutterWindow.swift */; }; +/* End PBXBuildFile section */ + +/* Begin PBXContainerItemProxy section */ + 331C80D9294CF71000263BE5 /* PBXContainerItemProxy */ = { + isa = PBXContainerItemProxy; + containerPortal = 33CC10E52044A3C60003C045 /* Project object */; + proxyType = 1; + remoteGlobalIDString = 33CC10EC2044A3C60003C045; + remoteInfo = Runner; + }; + 33CC111F2044C79F0003C045 /* PBXContainerItemProxy */ = { + isa = PBXContainerItemProxy; + containerPortal = 33CC10E52044A3C60003C045 /* Project object */; + proxyType = 1; + remoteGlobalIDString = 33CC111A2044C6BA0003C045; + remoteInfo = FLX; + }; +/* End PBXContainerItemProxy section */ + +/* Begin PBXCopyFilesBuildPhase section */ + 33CC110E2044A8840003C045 /* Bundle Framework */ = { + isa = PBXCopyFilesBuildPhase; + buildActionMask = 2147483647; + dstPath = ""; + dstSubfolderSpec = 10; + files = ( + ); + name = "Bundle Framework"; + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXCopyFilesBuildPhase section */ + +/* Begin PBXFileReference section */ + 331C80D5294CF71000263BE5 /* RunnerTests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = RunnerTests.xctest; sourceTree = BUILT_PRODUCTS_DIR; }; + 331C80D7294CF71000263BE5 /* RunnerTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RunnerTests.swift; sourceTree = ""; }; + 333000ED22D3DE5D00554162 /* Warnings.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = Warnings.xcconfig; sourceTree = ""; }; + 335BBD1A22A9A15E00E9071D /* GeneratedPluginRegistrant.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = GeneratedPluginRegistrant.swift; sourceTree = ""; }; + 33CC10ED2044A3C60003C045 /* example.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = "example.app"; sourceTree = BUILT_PRODUCTS_DIR; }; + 33CC10F02044A3C60003C045 /* AppDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = ""; }; + 33CC10F22044A3C60003C045 /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; name = Assets.xcassets; path = Runner/Assets.xcassets; sourceTree = ""; }; + 33CC10F52044A3C60003C045 /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.xib; name = Base; path = Base.lproj/MainMenu.xib; sourceTree = ""; }; + 33CC10F72044A3C60003C045 /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; name = Info.plist; path = Runner/Info.plist; sourceTree = ""; }; + 33CC11122044BFA00003C045 /* MainFlutterWindow.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainFlutterWindow.swift; sourceTree = ""; }; + 33CEB47222A05771004F2AC0 /* Flutter-Debug.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = "Flutter-Debug.xcconfig"; sourceTree = ""; }; + 33CEB47422A05771004F2AC0 /* Flutter-Release.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = "Flutter-Release.xcconfig"; sourceTree = ""; }; + 33CEB47722A0578A004F2AC0 /* Flutter-Generated.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; name = "Flutter-Generated.xcconfig"; path = "ephemeral/Flutter-Generated.xcconfig"; sourceTree = ""; }; + 33E51913231747F40026EE4D /* DebugProfile.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = DebugProfile.entitlements; sourceTree = ""; }; + 33E51914231749380026EE4D /* Release.entitlements */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.entitlements; path = Release.entitlements; sourceTree = ""; }; + 33E5194F232828860026EE4D /* AppInfo.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = AppInfo.xcconfig; sourceTree = ""; }; + 7AFA3C8E1D35360C0083082E /* Release.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = Release.xcconfig; sourceTree = ""; }; + 9740EEB21CF90195004384FC /* Debug.xcconfig */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.xcconfig; path = Debug.xcconfig; sourceTree = ""; }; +/* End PBXFileReference section */ + +/* Begin PBXFrameworksBuildPhase section */ + 331C80D2294CF70F00263BE5 /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 33CC10EA2044A3C60003C045 /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXFrameworksBuildPhase section */ + +/* Begin PBXGroup section */ + 331C80D6294CF71000263BE5 /* RunnerTests */ = { + isa = PBXGroup; + children = ( + 331C80D7294CF71000263BE5 /* RunnerTests.swift */, + ); + path = RunnerTests; + sourceTree = ""; + }; + 33BA886A226E78AF003329D5 /* Configs */ = { + isa = PBXGroup; + children = ( + 33E5194F232828860026EE4D /* AppInfo.xcconfig */, + 9740EEB21CF90195004384FC /* Debug.xcconfig */, + 7AFA3C8E1D35360C0083082E /* Release.xcconfig */, + 333000ED22D3DE5D00554162 /* Warnings.xcconfig */, + ); + path = Configs; + sourceTree = ""; + }; + 33CC10E42044A3C60003C045 = { + isa = PBXGroup; + children = ( + 33FAB671232836740065AC1E /* Runner */, + 33CEB47122A05771004F2AC0 /* Flutter */, + 331C80D6294CF71000263BE5 /* RunnerTests */, + 33CC10EE2044A3C60003C045 /* Products */, + D73912EC22F37F3D000D13A0 /* Frameworks */, + ); + sourceTree = ""; + }; + 33CC10EE2044A3C60003C045 /* Products */ = { + isa = PBXGroup; + children = ( + 33CC10ED2044A3C60003C045 /* example.app */, + 331C80D5294CF71000263BE5 /* RunnerTests.xctest */, + ); + name = Products; + sourceTree = ""; + }; + 33CC11242044D66E0003C045 /* Resources */ = { + isa = PBXGroup; + children = ( + 33CC10F22044A3C60003C045 /* Assets.xcassets */, + 33CC10F42044A3C60003C045 /* MainMenu.xib */, + 33CC10F72044A3C60003C045 /* Info.plist */, + ); + name = Resources; + path = ..; + sourceTree = ""; + }; + 33CEB47122A05771004F2AC0 /* Flutter */ = { + isa = PBXGroup; + children = ( + 335BBD1A22A9A15E00E9071D /* GeneratedPluginRegistrant.swift */, + 33CEB47222A05771004F2AC0 /* Flutter-Debug.xcconfig */, + 33CEB47422A05771004F2AC0 /* Flutter-Release.xcconfig */, + 33CEB47722A0578A004F2AC0 /* Flutter-Generated.xcconfig */, + ); + path = Flutter; + sourceTree = ""; + }; + 33FAB671232836740065AC1E /* Runner */ = { + isa = PBXGroup; + children = ( + 33CC10F02044A3C60003C045 /* AppDelegate.swift */, + 33CC11122044BFA00003C045 /* MainFlutterWindow.swift */, + 33E51913231747F40026EE4D /* DebugProfile.entitlements */, + 33E51914231749380026EE4D /* Release.entitlements */, + 33CC11242044D66E0003C045 /* Resources */, + 33BA886A226E78AF003329D5 /* Configs */, + ); + path = Runner; + sourceTree = ""; + }; + D73912EC22F37F3D000D13A0 /* Frameworks */ = { + isa = PBXGroup; + children = ( + ); + name = Frameworks; + sourceTree = ""; + }; +/* End PBXGroup section */ + +/* Begin PBXNativeTarget section */ + 331C80D4294CF70F00263BE5 /* RunnerTests */ = { + isa = PBXNativeTarget; + buildConfigurationList = 331C80DE294CF71000263BE5 /* Build configuration list for PBXNativeTarget "RunnerTests" */; + buildPhases = ( + 331C80D1294CF70F00263BE5 /* Sources */, + 331C80D2294CF70F00263BE5 /* Frameworks */, + 331C80D3294CF70F00263BE5 /* Resources */, + ); + buildRules = ( + ); + dependencies = ( + 331C80DA294CF71000263BE5 /* PBXTargetDependency */, + ); + name = RunnerTests; + productName = RunnerTests; + productReference = 331C80D5294CF71000263BE5 /* RunnerTests.xctest */; + productType = "com.apple.product-type.bundle.unit-test"; + }; + 33CC10EC2044A3C60003C045 /* Runner */ = { + isa = PBXNativeTarget; + buildConfigurationList = 33CC10FB2044A3C60003C045 /* Build configuration list for PBXNativeTarget "Runner" */; + buildPhases = ( + 33CC10E92044A3C60003C045 /* Sources */, + 33CC10EA2044A3C60003C045 /* Frameworks */, + 33CC10EB2044A3C60003C045 /* Resources */, + 33CC110E2044A8840003C045 /* Bundle Framework */, + 3399D490228B24CF009A79C7 /* ShellScript */, + ); + buildRules = ( + ); + dependencies = ( + 33CC11202044C79F0003C045 /* PBXTargetDependency */, + ); + name = Runner; + productName = Runner; + productReference = 33CC10ED2044A3C60003C045 /* example.app */; + productType = "com.apple.product-type.application"; + }; +/* End PBXNativeTarget section */ + +/* Begin PBXProject section */ + 33CC10E52044A3C60003C045 /* Project object */ = { + isa = PBXProject; + attributes = { + LastSwiftUpdateCheck = 0920; + LastUpgradeCheck = 1430; + ORGANIZATIONNAME = ""; + TargetAttributes = { + 331C80D4294CF70F00263BE5 = { + CreatedOnToolsVersion = 14.0; + TestTargetID = 33CC10EC2044A3C60003C045; + }; + 33CC10EC2044A3C60003C045 = { + CreatedOnToolsVersion = 9.2; + LastSwiftMigration = 1100; + ProvisioningStyle = Automatic; + SystemCapabilities = { + com.apple.Sandbox = { + enabled = 1; + }; + }; + }; + 33CC111A2044C6BA0003C045 = { + CreatedOnToolsVersion = 9.2; + ProvisioningStyle = Manual; + }; + }; + }; + buildConfigurationList = 33CC10E82044A3C60003C045 /* Build configuration list for PBXProject "Runner" */; + compatibilityVersion = "Xcode 9.3"; + developmentRegion = en; + hasScannedForEncodings = 0; + knownRegions = ( + en, + Base, + ); + mainGroup = 33CC10E42044A3C60003C045; + productRefGroup = 33CC10EE2044A3C60003C045 /* Products */; + projectDirPath = ""; + projectRoot = ""; + targets = ( + 33CC10EC2044A3C60003C045 /* Runner */, + 331C80D4294CF70F00263BE5 /* RunnerTests */, + 33CC111A2044C6BA0003C045 /* Flutter Assemble */, + ); + }; +/* End PBXProject section */ + +/* Begin PBXResourcesBuildPhase section */ + 331C80D3294CF70F00263BE5 /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 33CC10EB2044A3C60003C045 /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 33CC10F32044A3C60003C045 /* Assets.xcassets in Resources */, + 33CC10F62044A3C60003C045 /* MainMenu.xib in Resources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXResourcesBuildPhase section */ + +/* Begin PBXShellScriptBuildPhase section */ + 3399D490228B24CF009A79C7 /* ShellScript */ = { + isa = PBXShellScriptBuildPhase; + alwaysOutOfDate = 1; + buildActionMask = 2147483647; + files = ( + ); + inputFileListPaths = ( + ); + inputPaths = ( + ); + outputFileListPaths = ( + ); + outputPaths = ( + ); + runOnlyForDeploymentPostprocessing = 0; + shellPath = /bin/sh; + shellScript = "echo \"$PRODUCT_NAME.app\" > \"$PROJECT_DIR\"/Flutter/ephemeral/.app_filename && \"$FLUTTER_ROOT\"/packages/flutter_tools/bin/macos_assemble.sh embed\n"; + }; + 33CC111E2044C6BF0003C045 /* ShellScript */ = { + isa = PBXShellScriptBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + inputFileListPaths = ( + Flutter/ephemeral/FlutterInputs.xcfilelist, + ); + inputPaths = ( + Flutter/ephemeral/tripwire, + ); + outputFileListPaths = ( + Flutter/ephemeral/FlutterOutputs.xcfilelist, + ); + outputPaths = ( + ); + runOnlyForDeploymentPostprocessing = 0; + shellPath = /bin/sh; + shellScript = "\"$FLUTTER_ROOT\"/packages/flutter_tools/bin/macos_assemble.sh && touch Flutter/ephemeral/tripwire"; + }; +/* End PBXShellScriptBuildPhase section */ + +/* Begin PBXSourcesBuildPhase section */ + 331C80D1294CF70F00263BE5 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 331C80D8294CF71000263BE5 /* RunnerTests.swift in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 33CC10E92044A3C60003C045 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 33CC11132044BFA00003C045 /* MainFlutterWindow.swift in Sources */, + 33CC10F12044A3C60003C045 /* AppDelegate.swift in Sources */, + 335BBD1B22A9A15E00E9071D /* GeneratedPluginRegistrant.swift in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXSourcesBuildPhase section */ + +/* Begin PBXTargetDependency section */ + 331C80DA294CF71000263BE5 /* PBXTargetDependency */ = { + isa = PBXTargetDependency; + target = 33CC10EC2044A3C60003C045 /* Runner */; + targetProxy = 331C80D9294CF71000263BE5 /* PBXContainerItemProxy */; + }; + 33CC11202044C79F0003C045 /* PBXTargetDependency */ = { + isa = PBXTargetDependency; + target = 33CC111A2044C6BA0003C045 /* Flutter Assemble */; + targetProxy = 33CC111F2044C79F0003C045 /* PBXContainerItemProxy */; + }; +/* End PBXTargetDependency section */ + +/* Begin PBXVariantGroup section */ + 33CC10F42044A3C60003C045 /* MainMenu.xib */ = { + isa = PBXVariantGroup; + children = ( + 33CC10F52044A3C60003C045 /* Base */, + ); + name = MainMenu.xib; + path = Runner; + sourceTree = ""; + }; +/* End PBXVariantGroup section */ + +/* Begin XCBuildConfiguration section */ + 331C80DB294CF71000263BE5 /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.example.example.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/example.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/example"; + }; + name = Debug; + }; + 331C80DC294CF71000263BE5 /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.example.example.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/example.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/example"; + }; + name = Release; + }; + 331C80DD294CF71000263BE5 /* Profile */ = { + isa = XCBuildConfiguration; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.example.example.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/example.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/example"; + }; + name = Profile; + }; + 338D0CE9231458BD00FA5F75 /* Profile */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + CLANG_ANALYZER_NONNULL = YES; + CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++14"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_DOCUMENTATION_COMMENTS = YES; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CODE_SIGN_IDENTITY = "-"; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym"; + ENABLE_NS_ASSERTIONS = NO; + ENABLE_STRICT_OBJC_MSGSEND = YES; + GCC_C_LANGUAGE_STANDARD = gnu11; + GCC_NO_COMMON_BLOCKS = YES; + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + MACOSX_DEPLOYMENT_TARGET = 10.14; + MTL_ENABLE_DEBUG_INFO = NO; + SDKROOT = macosx; + SWIFT_COMPILATION_MODE = wholemodule; + SWIFT_OPTIMIZATION_LEVEL = "-O"; + }; + name = Profile; + }; + 338D0CEA231458BD00FA5F75 /* Profile */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 33E5194F232828860026EE4D /* AppInfo.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CODE_SIGN_ENTITLEMENTS = Runner/DebugProfile.entitlements; + CODE_SIGN_STYLE = Automatic; + COMBINE_HIDPI_IMAGES = YES; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/../Frameworks", + ); + PROVISIONING_PROFILE_SPECIFIER = ""; + SWIFT_VERSION = 5.0; + }; + name = Profile; + }; + 338D0CEB231458BD00FA5F75 /* Profile */ = { + isa = XCBuildConfiguration; + buildSettings = { + CODE_SIGN_STYLE = Manual; + PRODUCT_NAME = "$(TARGET_NAME)"; + }; + name = Profile; + }; + 33CC10F92044A3C60003C045 /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 9740EEB21CF90195004384FC /* Debug.xcconfig */; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + CLANG_ANALYZER_NONNULL = YES; + CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++14"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_DOCUMENTATION_COMMENTS = YES; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CODE_SIGN_IDENTITY = "-"; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = dwarf; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_TESTABILITY = YES; + GCC_C_LANGUAGE_STANDARD = gnu11; + GCC_DYNAMIC_NO_PIC = NO; + GCC_NO_COMMON_BLOCKS = YES; + GCC_OPTIMIZATION_LEVEL = 0; + GCC_PREPROCESSOR_DEFINITIONS = ( + "DEBUG=1", + "$(inherited)", + ); + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + MACOSX_DEPLOYMENT_TARGET = 10.14; + MTL_ENABLE_DEBUG_INFO = YES; + ONLY_ACTIVE_ARCH = YES; + SDKROOT = macosx; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG; + SWIFT_OPTIMIZATION_LEVEL = "-Onone"; + }; + name = Debug; + }; + 33CC10FA2044A3C60003C045 /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + CLANG_ANALYZER_NONNULL = YES; + CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++14"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_DOCUMENTATION_COMMENTS = YES; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CODE_SIGN_IDENTITY = "-"; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym"; + ENABLE_NS_ASSERTIONS = NO; + ENABLE_STRICT_OBJC_MSGSEND = YES; + GCC_C_LANGUAGE_STANDARD = gnu11; + GCC_NO_COMMON_BLOCKS = YES; + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + MACOSX_DEPLOYMENT_TARGET = 10.14; + MTL_ENABLE_DEBUG_INFO = NO; + SDKROOT = macosx; + SWIFT_COMPILATION_MODE = wholemodule; + SWIFT_OPTIMIZATION_LEVEL = "-O"; + }; + name = Release; + }; + 33CC10FC2044A3C60003C045 /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 33E5194F232828860026EE4D /* AppInfo.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CODE_SIGN_ENTITLEMENTS = Runner/DebugProfile.entitlements; + CODE_SIGN_STYLE = Automatic; + COMBINE_HIDPI_IMAGES = YES; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/../Frameworks", + ); + PROVISIONING_PROFILE_SPECIFIER = ""; + SWIFT_OPTIMIZATION_LEVEL = "-Onone"; + SWIFT_VERSION = 5.0; + }; + name = Debug; + }; + 33CC10FD2044A3C60003C045 /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 33E5194F232828860026EE4D /* AppInfo.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CODE_SIGN_ENTITLEMENTS = Runner/Release.entitlements; + CODE_SIGN_STYLE = Automatic; + COMBINE_HIDPI_IMAGES = YES; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/../Frameworks", + ); + PROVISIONING_PROFILE_SPECIFIER = ""; + SWIFT_VERSION = 5.0; + }; + name = Release; + }; + 33CC111C2044C6BA0003C045 /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + CODE_SIGN_STYLE = Manual; + PRODUCT_NAME = "$(TARGET_NAME)"; + }; + name = Debug; + }; + 33CC111D2044C6BA0003C045 /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + CODE_SIGN_STYLE = Automatic; + PRODUCT_NAME = "$(TARGET_NAME)"; + }; + name = Release; + }; +/* End XCBuildConfiguration section */ + +/* Begin XCConfigurationList section */ + 331C80DE294CF71000263BE5 /* Build configuration list for PBXNativeTarget "RunnerTests" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 331C80DB294CF71000263BE5 /* Debug */, + 331C80DC294CF71000263BE5 /* Release */, + 331C80DD294CF71000263BE5 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 33CC10E82044A3C60003C045 /* Build configuration list for PBXProject "Runner" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 33CC10F92044A3C60003C045 /* Debug */, + 33CC10FA2044A3C60003C045 /* Release */, + 338D0CE9231458BD00FA5F75 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 33CC10FB2044A3C60003C045 /* Build configuration list for PBXNativeTarget "Runner" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 33CC10FC2044A3C60003C045 /* Debug */, + 33CC10FD2044A3C60003C045 /* Release */, + 338D0CEA231458BD00FA5F75 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 33CC111B2044C6BA0003C045 /* Build configuration list for PBXAggregateTarget "Flutter Assemble" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 33CC111C2044C6BA0003C045 /* Debug */, + 33CC111D2044C6BA0003C045 /* Release */, + 338D0CEB231458BD00FA5F75 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; +/* End XCConfigurationList section */ + }; + rootObject = 33CC10E52044A3C60003C045 /* Project object */; +} diff --git a/packages/re_editor/example/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/packages/re_editor/example/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist new file mode 100644 index 0000000..18d9810 --- /dev/null +++ b/packages/re_editor/example/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist @@ -0,0 +1,8 @@ + + + + + IDEDidComputeMac32BitWarning + + + diff --git a/packages/re_editor/example/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme b/packages/re_editor/example/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme new file mode 100644 index 0000000..397f3d3 --- /dev/null +++ b/packages/re_editor/example/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme @@ -0,0 +1,98 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/packages/re_editor/example/macos/Runner.xcworkspace/contents.xcworkspacedata b/packages/re_editor/example/macos/Runner.xcworkspace/contents.xcworkspacedata new file mode 100644 index 0000000..1d526a1 --- /dev/null +++ b/packages/re_editor/example/macos/Runner.xcworkspace/contents.xcworkspacedata @@ -0,0 +1,7 @@ + + + + + diff --git a/packages/re_editor/example/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/packages/re_editor/example/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist new file mode 100644 index 0000000..18d9810 --- /dev/null +++ b/packages/re_editor/example/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist @@ -0,0 +1,8 @@ + + + + + IDEDidComputeMac32BitWarning + + + diff --git a/packages/re_editor/example/macos/Runner/AppDelegate.swift b/packages/re_editor/example/macos/Runner/AppDelegate.swift new file mode 100644 index 0000000..d53ef64 --- /dev/null +++ b/packages/re_editor/example/macos/Runner/AppDelegate.swift @@ -0,0 +1,9 @@ +import Cocoa +import FlutterMacOS + +@NSApplicationMain +class AppDelegate: FlutterAppDelegate { + override func applicationShouldTerminateAfterLastWindowClosed(_ sender: NSApplication) -> Bool { + return true + } +} diff --git a/packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json b/packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json new file mode 100644 index 0000000..a2ec33f --- /dev/null +++ b/packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json @@ -0,0 +1,68 @@ +{ + "images" : [ + { + "size" : "16x16", + "idiom" : "mac", + "filename" : "app_icon_16.png", + "scale" : "1x" + }, + { + "size" : "16x16", + "idiom" : "mac", + "filename" : "app_icon_32.png", + "scale" : "2x" + }, + { + "size" : "32x32", + "idiom" : "mac", + "filename" : "app_icon_32.png", + "scale" : "1x" + }, + { + "size" : "32x32", + "idiom" : "mac", + "filename" : "app_icon_64.png", + "scale" : "2x" + }, + { + "size" : "128x128", + "idiom" : "mac", + "filename" : "app_icon_128.png", + "scale" : "1x" + }, + { + "size" : "128x128", + "idiom" : "mac", + "filename" : "app_icon_256.png", + "scale" : "2x" + }, + { + "size" : "256x256", + "idiom" : "mac", + "filename" : "app_icon_256.png", + "scale" : "1x" + }, + { + "size" : "256x256", + "idiom" : "mac", + "filename" : "app_icon_512.png", + "scale" : "2x" + }, + { + "size" : "512x512", + "idiom" : "mac", + "filename" : "app_icon_512.png", + "scale" : "1x" + }, + { + "size" : "512x512", + "idiom" : "mac", + "filename" : "app_icon_1024.png", + "scale" : "2x" + } + ], + "info" : { + "version" : 1, + "author" : "xcode" + } +} diff --git a/packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png b/packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png new file mode 100644 index 0000000000000000000000000000000000000000..82b6f9d9a33e198f5747104729e1fcef999772a5 GIT binary patch literal 102994 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ⅅ8MglG&ER{i5lN315cO?EdHNLrg? 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 z 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 Pe7HEdAEg|=c=LY&YVNkY literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png b/packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png new file mode 100644 index 0000000000000000000000000000000000000000..13b35eba55c6dabc3aac36f33d859266c18fa0d0 GIT binary patch literal 5680 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 literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png b/packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png new file mode 100644 index 0000000000000000000000000000000000000000..0a3f5fa40fb3d1e0710331a48de5d256da3f275d GIT binary patch literal 520 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 literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png b/packages/re_editor/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png new file mode 100644 index 0000000000000000000000000000000000000000..2f1632cfddf3d9dade342351e627a0a75609fb46 GIT binary patch literal 2218 zcmV;b2vzrqP)Px#L}ge>W=%~1DgXcg2mk?xX#fNO00031000^Q000001E2u_0{{R30RRC20H6W@ z1ONa40RR91K%fHv1ONa40RR91KmY&$07g+lumAuE6iGxuRCodHTWf3-RTMruyW6Fu zQYeUM04eX6D5c0FCjKKPrco1(K`<0SL=crI{PC3-^hZU0kQie$gh-5!7z6SH6Q0J% zqot*`H1q{R5fHFYS}dje@;kG=v$L0(yY0?wY2%*c?A&{2?!D*x?m71{of2gv!$5|C z3>qG_BW}7K_yUcT3A5C6QD<+{aq?x;MAUyAiJn#Jv8_zZtQ{P zTRzbL3U9!qVuZzS$xKU10KiW~Bgdcv1-!uAhQxf3a7q+dU6lj?yoO4Lq4TUN4}h{N z*fIM=SS8|C2$(T>w$`t@3Tka!(r!7W`x z-isCVgQD^mG-MJ;XtJuK3V{Vy72GQ83KRWsHU?e*wrhKk=ApIYeDqLi;JI1e zuvv}5^Dc=k7F7?nm3nIw$NVmU-+R>> zyqOR$-2SDpJ}Pt;^RkJytDVXNTsu|mI1`~G7yw`EJR?VkGfNdqK9^^8P`JdtTV&tX4CNcV4 z&N06nZa??Fw1AgQOUSE2AmPE@WO(Fvo`%m`cDgiv(fAeRA%3AGXUbsGw{7Q`cY;1BI#ac3iN$$Hw z0LT0;xc%=q)me?Y*$xI@GRAw?+}>=9D+KTk??-HJ4=A>`V&vKFS75@MKdSF1JTq{S zc1!^8?YA|t+uKigaq!sT;Z!&0F2=k7F0PIU;F$leJLaw2UI6FL^w}OG&!;+b%ya1c z1n+6-inU<0VM-Y_s5iTElq)ThyF?StVcebpGI znw#+zLx2@ah{$_2jn+@}(zJZ{+}_N9BM;z)0yr|gF-4=Iyu@hI*Lk=-A8f#bAzc9f z`Kd6K--x@t04swJVC3JK1cHY-Hq+=|PN-VO;?^_C#;coU6TDP7Bt`;{JTG;!+jj(` zw5cLQ-(Cz-Tlb`A^w7|R56Ce;Wmr0)$KWOUZ6ai0PhzPeHwdl0H(etP zUV`va_i0s-4#DkNM8lUlqI7>YQLf)(lz9Q3Uw`)nc(z3{m5ZE77Ul$V%m)E}3&8L0 z-XaU|eB~Is08eORPk;=<>!1w)Kf}FOVS2l&9~A+@R#koFJ$Czd%Y(ENTV&A~U(IPI z;UY+gf+&6ioZ=roly<0Yst8ck>(M=S?B-ys3mLdM&)ex!hbt+ol|T6CTS+Sc0jv(& z7ijdvFwBq;0a{%3GGwkDKTeG`b+lyj0jjS1OMkYnepCdoosNY`*zmBIo*981BU%%U z@~$z0V`OVtIbEx5pa|Tct|Lg#ZQf5OYMUMRD>Wdxm5SAqV2}3!ceE-M2 z@O~lQ0OiKQp}o9I;?uxCgYVV?FH|?Riri*U$Zi_`V2eiA>l zdSm6;SEm6#T+SpcE8Ro_f2AwxzI z44hfe^WE3!h@W3RDyA_H440cpmYkv*)6m1XazTqw%=E5Xv7^@^^T7Q2wxr+Z2kVYr + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/packages/re_editor/example/macos/Runner/Configs/AppInfo.xcconfig b/packages/re_editor/example/macos/Runner/Configs/AppInfo.xcconfig new file mode 100644 index 0000000..92fb3cd --- /dev/null +++ b/packages/re_editor/example/macos/Runner/Configs/AppInfo.xcconfig @@ -0,0 +1,14 @@ +// Application-level settings for the Runner target. +// +// This may be replaced with something auto-generated from metadata (e.g., pubspec.yaml) in the +// future. If not, the values below would default to using the project name when this becomes a +// 'flutter create' template. + +// The application's name. By default this is also the title of the Flutter window. +PRODUCT_NAME = example + +// The application's bundle identifier +PRODUCT_BUNDLE_IDENTIFIER = com.example.example + +// The copyright displayed in application information +PRODUCT_COPYRIGHT = Copyright © 2024 com.example. All rights reserved. diff --git a/packages/re_editor/example/macos/Runner/Configs/Debug.xcconfig b/packages/re_editor/example/macos/Runner/Configs/Debug.xcconfig new file mode 100644 index 0000000..36b0fd9 --- /dev/null +++ b/packages/re_editor/example/macos/Runner/Configs/Debug.xcconfig @@ -0,0 +1,2 @@ +#include "../../Flutter/Flutter-Debug.xcconfig" +#include "Warnings.xcconfig" diff --git a/packages/re_editor/example/macos/Runner/Configs/Release.xcconfig b/packages/re_editor/example/macos/Runner/Configs/Release.xcconfig new file mode 100644 index 0000000..dff4f49 --- /dev/null +++ b/packages/re_editor/example/macos/Runner/Configs/Release.xcconfig @@ -0,0 +1,2 @@ +#include "../../Flutter/Flutter-Release.xcconfig" +#include "Warnings.xcconfig" diff --git a/packages/re_editor/example/macos/Runner/Configs/Warnings.xcconfig b/packages/re_editor/example/macos/Runner/Configs/Warnings.xcconfig new file mode 100644 index 0000000..42bcbf4 --- /dev/null +++ b/packages/re_editor/example/macos/Runner/Configs/Warnings.xcconfig @@ -0,0 +1,13 @@ +WARNING_CFLAGS = -Wall -Wconditional-uninitialized -Wnullable-to-nonnull-conversion -Wmissing-method-return-type -Woverlength-strings +GCC_WARN_UNDECLARED_SELECTOR = YES +CLANG_UNDEFINED_BEHAVIOR_SANITIZER_NULLABILITY = YES +CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE +CLANG_WARN__DUPLICATE_METHOD_MATCH = YES +CLANG_WARN_PRAGMA_PACK = YES +CLANG_WARN_STRICT_PROTOTYPES = YES +CLANG_WARN_COMMA = YES +GCC_WARN_STRICT_SELECTOR_MATCH = YES +CLANG_WARN_OBJC_REPEATED_USE_OF_WEAK = YES +CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES +GCC_WARN_SHADOW = YES +CLANG_WARN_UNREACHABLE_CODE = YES diff --git a/packages/re_editor/example/macos/Runner/DebugProfile.entitlements b/packages/re_editor/example/macos/Runner/DebugProfile.entitlements new file mode 100644 index 0000000..dddb8a3 --- /dev/null +++ b/packages/re_editor/example/macos/Runner/DebugProfile.entitlements @@ -0,0 +1,12 @@ + + + + + com.apple.security.app-sandbox + + com.apple.security.cs.allow-jit + + com.apple.security.network.server + + + diff --git a/packages/re_editor/example/macos/Runner/Info.plist b/packages/re_editor/example/macos/Runner/Info.plist new file mode 100644 index 0000000..4789daa --- /dev/null +++ b/packages/re_editor/example/macos/Runner/Info.plist @@ -0,0 +1,32 @@ + + + + + CFBundleDevelopmentRegion + $(DEVELOPMENT_LANGUAGE) + CFBundleExecutable + $(EXECUTABLE_NAME) + CFBundleIconFile + + CFBundleIdentifier + $(PRODUCT_BUNDLE_IDENTIFIER) + CFBundleInfoDictionaryVersion + 6.0 + CFBundleName + $(PRODUCT_NAME) + CFBundlePackageType + APPL + CFBundleShortVersionString + $(FLUTTER_BUILD_NAME) + CFBundleVersion + $(FLUTTER_BUILD_NUMBER) + LSMinimumSystemVersion + $(MACOSX_DEPLOYMENT_TARGET) + NSHumanReadableCopyright + $(PRODUCT_COPYRIGHT) + NSMainNibFile + MainMenu + NSPrincipalClass + NSApplication + + diff --git a/packages/re_editor/example/macos/Runner/MainFlutterWindow.swift b/packages/re_editor/example/macos/Runner/MainFlutterWindow.swift new file mode 100644 index 0000000..3cc05eb --- /dev/null +++ b/packages/re_editor/example/macos/Runner/MainFlutterWindow.swift @@ -0,0 +1,15 @@ +import Cocoa +import FlutterMacOS + +class MainFlutterWindow: NSWindow { + override func awakeFromNib() { + let flutterViewController = FlutterViewController() + let windowFrame = self.frame + self.contentViewController = flutterViewController + self.setFrame(windowFrame, display: true) + + RegisterGeneratedPlugins(registry: flutterViewController) + + super.awakeFromNib() + } +} diff --git a/packages/re_editor/example/macos/Runner/Release.entitlements b/packages/re_editor/example/macos/Runner/Release.entitlements new file mode 100644 index 0000000..852fa1a --- /dev/null +++ b/packages/re_editor/example/macos/Runner/Release.entitlements @@ -0,0 +1,8 @@ + + + + + com.apple.security.app-sandbox + + + diff --git a/packages/re_editor/example/macos/RunnerTests/RunnerTests.swift b/packages/re_editor/example/macos/RunnerTests/RunnerTests.swift new file mode 100644 index 0000000..5418c9f --- /dev/null +++ b/packages/re_editor/example/macos/RunnerTests/RunnerTests.swift @@ -0,0 +1,12 @@ +import FlutterMacOS +import Cocoa +import XCTest + +class RunnerTests: XCTestCase { + + func testExample() { + // If you add code to the Runner application, consider adding tests here. + // See https://developer.apple.com/documentation/xctest for more information about using XCTest. + } + +} diff --git a/packages/re_editor/example/pubspec.yaml b/packages/re_editor/example/pubspec.yaml new file mode 100644 index 0000000..c022198 --- /dev/null +++ b/packages/re_editor/example/pubspec.yaml @@ -0,0 +1,66 @@ +name: re_editor_exmaple +description: A new Flutter project. +publish_to: none + +version: 1.0.0 + +environment: + sdk: ">=2.17.0 <3.0.0" + flutter: ">=1.17.0" + +dependencies: + flutter: + sdk: flutter + collection: ^1.17.1 + re_highlight: ^0.0.2 + re_editor: + path: ../ + +dev_dependencies: + flutter_lints: ^2.0.3 + +# For information on the generic Dart part of this file, see the +# following page: https://dart.dev/tools/pub/pubspec + +# The following section is specific to Flutter packages. +flutter: + + # The following line ensures that the Material Icons font is + # included with your application, so that you can use the icons in + # the material Icons class. + uses-material-design: true + + # To add assets to your application, add an assets section, like this: + # assets: + # - images/a_dot_burr.jpeg + # - images/a_dot_ham.jpeg + + # An image asset can refer to one or more resolution-specific "variants", see + # https://flutter.dev/assets-and-images/#resolution-aware + + # For details regarding adding assets from package dependencies, see + # https://flutter.dev/assets-and-images/#from-packages + + # To add custom fonts to your application, add a fonts section here, + # in this "flutter" section. Each entry in this list should have a + # "family" key with the font family name, and a "fonts" key with a + # list giving the asset and other descriptors for the font. For + # example: + # fonts: + # - family: Schyler + # fonts: + # - asset: fonts/Schyler-Regular.ttf + # - asset: fonts/Schyler-Italic.ttf + # style: italic + # - family: Trajan Pro + # fonts: + # - asset: fonts/TrajanPro.ttf + # - asset: fonts/TrajanPro_Bold.ttf + # weight: 700 + # + # For details regarding fonts from package dependencies, + # see https://flutter.dev/custom-fonts/#from-packages + assets: + - assets/code.json + - assets/code.dart + - assets/large.txt diff --git a/packages/re_editor/example/web/favicon.png b/packages/re_editor/example/web/favicon.png new file mode 100644 index 0000000000000000000000000000000000000000..8aaa46ac1ae21512746f852a42ba87e4165dfdd1 GIT binary patch literal 917 zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`jKx9jP7LeL$-D$|I14-?iy0X7 zltGxWVyS%@P(fs7NJL45ua8x7ey(0(N`6wRUPW#JP&EUCO@$SZnVVXYs8ErclUHn2 zVXFjIVFhG^g!Ppaz)DK8ZIvQ?0~DO|i&7O#^-S~(l1AfjnEK zjFOT9D}DX)@^Za$W4-*MbbUihOG|wNBYh(yU7!lx;>x^|#0uTKVr7USFmqf|i<65o z3raHc^AtelCMM;Vme?vOfh>Xph&xL%(-1c06+^uR^q@XSM&D4+Kp$>4P^%3{)XKjo zGZknv$b36P8?Z_gF{nK@`XI}Z90TzwSQO}0J1!f2c(B=V`5aP@1P1a|PZ!4!3&Gl8 zTYqUsf!gYFyJnXpu0!n&N*SYAX-%d(5gVjrHJWqXQshj@!Zm{!01WsQrH~9=kTxW#6SvuapgMqt>$=j#%eyGrQzr zP{L-3gsMA^$I1&gsBAEL+vxi1*Igl=8#8`5?A-T5=z-sk46WA1IUT)AIZHx1rdUrf zVJrJn<74DDw`j)Ki#gt}mIT-Q`XRa2-jQXQoI%w`nb|XblvzK${ZzlV)m-XcwC(od z71_OEC5Bt9GEXosOXaPTYOia#R4ID2TiU~`zVMl08TV_C%DnU4^+HE>9(CE4D6?Fz oujB08i7adh9xk7*FX66dWH6F5TM;?E2b5PlUHx3vIVCg!0Dx9vYXATM literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/web/icons/Icon-192.png b/packages/re_editor/example/web/icons/Icon-192.png new file mode 100644 index 0000000000000000000000000000000000000000..b749bfef07473333cf1dd31e9eed89862a5d52aa GIT binary patch literal 5292 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 literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/web/icons/Icon-512.png b/packages/re_editor/example/web/icons/Icon-512.png new file mode 100644 index 0000000000000000000000000000000000000000..88cfd48dff1169879ba46840804b412fe02fefd6 GIT binary patch literal 8252 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 literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/web/icons/Icon-maskable-192.png b/packages/re_editor/example/web/icons/Icon-maskable-192.png new file mode 100644 index 0000000000000000000000000000000000000000..eb9b4d76e525556d5d89141648c724331630325d GIT binary patch literal 5594 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 X>c!)3PgKfL&lX^$Z>Cpu&6)6jvi^Z! literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/web/icons/Icon-maskable-512.png b/packages/re_editor/example/web/icons/Icon-maskable-512.png new file mode 100644 index 0000000000000000000000000000000000000000..d69c56691fbdb0b7efa65097c7cc1edac12a6d3e GIT binary patch literal 20998 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 MPgg&ebxsLQ025IeI{*Lx literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/web/index.html b/packages/re_editor/example/web/index.html new file mode 100644 index 0000000..45cf2ca --- /dev/null +++ b/packages/re_editor/example/web/index.html @@ -0,0 +1,59 @@ + + + + + + + + + + + + + + + + + + + + example + + + + + + + + + + diff --git a/packages/re_editor/example/web/manifest.json b/packages/re_editor/example/web/manifest.json new file mode 100644 index 0000000..096edf8 --- /dev/null +++ b/packages/re_editor/example/web/manifest.json @@ -0,0 +1,35 @@ +{ + "name": "example", + "short_name": "example", + "start_url": ".", + "display": "standalone", + "background_color": "#0175C2", + "theme_color": "#0175C2", + "description": "A new Flutter project.", + "orientation": "portrait-primary", + "prefer_related_applications": false, + "icons": [ + { + "src": "icons/Icon-192.png", + "sizes": "192x192", + "type": "image/png" + }, + { + "src": "icons/Icon-512.png", + "sizes": "512x512", + "type": "image/png" + }, + { + "src": "icons/Icon-maskable-192.png", + "sizes": "192x192", + "type": "image/png", + "purpose": "maskable" + }, + { + "src": "icons/Icon-maskable-512.png", + "sizes": "512x512", + "type": "image/png", + "purpose": "maskable" + } + ] +} diff --git a/packages/re_editor/example/windows/CMakeLists.txt b/packages/re_editor/example/windows/CMakeLists.txt new file mode 100644 index 0000000..d960948 --- /dev/null +++ b/packages/re_editor/example/windows/CMakeLists.txt @@ -0,0 +1,108 @@ +# Project-level configuration. +cmake_minimum_required(VERSION 3.14) +project(example LANGUAGES CXX) + +# The name of the executable created for the application. Change this to change +# the on-disk name of your application. +set(BINARY_NAME "example") + +# Explicitly opt in to modern CMake behaviors to avoid warnings with recent +# versions of CMake. +cmake_policy(VERSION 3.14...3.25) + +# Define build configuration option. +get_property(IS_MULTICONFIG GLOBAL PROPERTY GENERATOR_IS_MULTI_CONFIG) +if(IS_MULTICONFIG) + set(CMAKE_CONFIGURATION_TYPES "Debug;Profile;Release" + CACHE STRING "" FORCE) +else() + if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES) + set(CMAKE_BUILD_TYPE "Debug" CACHE + STRING "Flutter build mode" FORCE) + set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS + "Debug" "Profile" "Release") + endif() +endif() +# Define settings for the Profile build mode. +set(CMAKE_EXE_LINKER_FLAGS_PROFILE "${CMAKE_EXE_LINKER_FLAGS_RELEASE}") +set(CMAKE_SHARED_LINKER_FLAGS_PROFILE "${CMAKE_SHARED_LINKER_FLAGS_RELEASE}") +set(CMAKE_C_FLAGS_PROFILE "${CMAKE_C_FLAGS_RELEASE}") +set(CMAKE_CXX_FLAGS_PROFILE "${CMAKE_CXX_FLAGS_RELEASE}") + +# Use Unicode for all projects. +add_definitions(-DUNICODE -D_UNICODE) + +# Compilation settings that should be applied to most targets. +# +# Be cautious about adding new options here, as plugins use this function by +# default. In most cases, you should add new options to specific targets instead +# of modifying this function. +function(APPLY_STANDARD_SETTINGS TARGET) + target_compile_features(${TARGET} PUBLIC cxx_std_17) + target_compile_options(${TARGET} PRIVATE /W4 /WX /wd"4100") + target_compile_options(${TARGET} PRIVATE /EHsc) + target_compile_definitions(${TARGET} PRIVATE "_HAS_EXCEPTIONS=0") + target_compile_definitions(${TARGET} PRIVATE "$<$:_DEBUG>") +endfunction() + +# Flutter library and tool build rules. +set(FLUTTER_MANAGED_DIR "${CMAKE_CURRENT_SOURCE_DIR}/flutter") +add_subdirectory(${FLUTTER_MANAGED_DIR}) + +# Application build; see runner/CMakeLists.txt. +add_subdirectory("runner") + + +# Generated plugin build rules, which manage building the plugins and adding +# them to the application. +include(flutter/generated_plugins.cmake) + + +# === Installation === +# Support files are copied into place next to the executable, so that it can +# run in place. This is done instead of making a separate bundle (as on Linux) +# so that building and running from within Visual Studio will work. +set(BUILD_BUNDLE_DIR "$") +# Make the "install" step default, as it's required to run. +set(CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD 1) +if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT) + set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE) +endif() + +set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data") +set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}") + +install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}" + COMPONENT Runtime) + +install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" + COMPONENT Runtime) + +install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) + +if(PLUGIN_BUNDLED_LIBRARIES) + install(FILES "${PLUGIN_BUNDLED_LIBRARIES}" + DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) +endif() + +# Copy the native assets provided by the build.dart from all packages. +set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/windows/") +install(DIRECTORY "${NATIVE_ASSETS_DIR}" + DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) + +# Fully re-copy the assets directory on each build to avoid having stale files +# from a previous install. +set(FLUTTER_ASSET_DIR_NAME "flutter_assets") +install(CODE " + file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\") + " COMPONENT Runtime) +install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}" + DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime) + +# Install the AOT library on non-Debug builds only. +install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" + CONFIGURATIONS Profile;Release + COMPONENT Runtime) diff --git a/packages/re_editor/example/windows/flutter/CMakeLists.txt b/packages/re_editor/example/windows/flutter/CMakeLists.txt new file mode 100644 index 0000000..903f489 --- /dev/null +++ b/packages/re_editor/example/windows/flutter/CMakeLists.txt @@ -0,0 +1,109 @@ +# This file controls Flutter-level build steps. It should not be edited. +cmake_minimum_required(VERSION 3.14) + +set(EPHEMERAL_DIR "${CMAKE_CURRENT_SOURCE_DIR}/ephemeral") + +# Configuration provided via flutter tool. +include(${EPHEMERAL_DIR}/generated_config.cmake) + +# TODO: Move the rest of this into files in ephemeral. See +# https://github.com/flutter/flutter/issues/57146. +set(WRAPPER_ROOT "${EPHEMERAL_DIR}/cpp_client_wrapper") + +# Set fallback configurations for older versions of the flutter tool. +if (NOT DEFINED FLUTTER_TARGET_PLATFORM) + set(FLUTTER_TARGET_PLATFORM "windows-x64") +endif() + +# === Flutter Library === +set(FLUTTER_LIBRARY "${EPHEMERAL_DIR}/flutter_windows.dll") + +# Published to parent scope for install step. +set(FLUTTER_LIBRARY ${FLUTTER_LIBRARY} PARENT_SCOPE) +set(FLUTTER_ICU_DATA_FILE "${EPHEMERAL_DIR}/icudtl.dat" PARENT_SCOPE) +set(PROJECT_BUILD_DIR "${PROJECT_DIR}/build/" PARENT_SCOPE) +set(AOT_LIBRARY "${PROJECT_DIR}/build/windows/app.so" PARENT_SCOPE) + +list(APPEND FLUTTER_LIBRARY_HEADERS + "flutter_export.h" + "flutter_windows.h" + "flutter_messenger.h" + "flutter_plugin_registrar.h" + "flutter_texture_registrar.h" +) +list(TRANSFORM FLUTTER_LIBRARY_HEADERS PREPEND "${EPHEMERAL_DIR}/") +add_library(flutter INTERFACE) +target_include_directories(flutter INTERFACE + "${EPHEMERAL_DIR}" +) +target_link_libraries(flutter INTERFACE "${FLUTTER_LIBRARY}.lib") +add_dependencies(flutter flutter_assemble) + +# === Wrapper === +list(APPEND CPP_WRAPPER_SOURCES_CORE + "core_implementations.cc" + "standard_codec.cc" +) +list(TRANSFORM CPP_WRAPPER_SOURCES_CORE PREPEND "${WRAPPER_ROOT}/") +list(APPEND CPP_WRAPPER_SOURCES_PLUGIN + "plugin_registrar.cc" +) +list(TRANSFORM CPP_WRAPPER_SOURCES_PLUGIN PREPEND "${WRAPPER_ROOT}/") +list(APPEND CPP_WRAPPER_SOURCES_APP + "flutter_engine.cc" + "flutter_view_controller.cc" +) +list(TRANSFORM CPP_WRAPPER_SOURCES_APP PREPEND "${WRAPPER_ROOT}/") + +# Wrapper sources needed for a plugin. +add_library(flutter_wrapper_plugin STATIC + ${CPP_WRAPPER_SOURCES_CORE} + ${CPP_WRAPPER_SOURCES_PLUGIN} +) +apply_standard_settings(flutter_wrapper_plugin) +set_target_properties(flutter_wrapper_plugin PROPERTIES + POSITION_INDEPENDENT_CODE ON) +set_target_properties(flutter_wrapper_plugin PROPERTIES + CXX_VISIBILITY_PRESET hidden) +target_link_libraries(flutter_wrapper_plugin PUBLIC flutter) +target_include_directories(flutter_wrapper_plugin PUBLIC + "${WRAPPER_ROOT}/include" +) +add_dependencies(flutter_wrapper_plugin flutter_assemble) + +# Wrapper sources needed for the runner. +add_library(flutter_wrapper_app STATIC + ${CPP_WRAPPER_SOURCES_CORE} + ${CPP_WRAPPER_SOURCES_APP} +) +apply_standard_settings(flutter_wrapper_app) +target_link_libraries(flutter_wrapper_app PUBLIC flutter) +target_include_directories(flutter_wrapper_app PUBLIC + "${WRAPPER_ROOT}/include" +) +add_dependencies(flutter_wrapper_app flutter_assemble) + +# === Flutter tool backend === +# _phony_ is a non-existent file to force this command to run every time, +# since currently there's no way to get a full input/output list from the +# flutter tool. +set(PHONY_OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/_phony_") +set_source_files_properties("${PHONY_OUTPUT}" PROPERTIES SYMBOLIC TRUE) +add_custom_command( + OUTPUT ${FLUTTER_LIBRARY} ${FLUTTER_LIBRARY_HEADERS} + ${CPP_WRAPPER_SOURCES_CORE} ${CPP_WRAPPER_SOURCES_PLUGIN} + ${CPP_WRAPPER_SOURCES_APP} + ${PHONY_OUTPUT} + COMMAND ${CMAKE_COMMAND} -E env + ${FLUTTER_TOOL_ENVIRONMENT} + "${FLUTTER_ROOT}/packages/flutter_tools/bin/tool_backend.bat" + ${FLUTTER_TARGET_PLATFORM} $ + VERBATIM +) +add_custom_target(flutter_assemble DEPENDS + "${FLUTTER_LIBRARY}" + ${FLUTTER_LIBRARY_HEADERS} + ${CPP_WRAPPER_SOURCES_CORE} + ${CPP_WRAPPER_SOURCES_PLUGIN} + ${CPP_WRAPPER_SOURCES_APP} +) diff --git a/packages/re_editor/example/windows/flutter/generated_plugin_registrant.cc b/packages/re_editor/example/windows/flutter/generated_plugin_registrant.cc new file mode 100644 index 0000000..8b6d468 --- /dev/null +++ b/packages/re_editor/example/windows/flutter/generated_plugin_registrant.cc @@ -0,0 +1,11 @@ +// +// Generated file. Do not edit. +// + +// clang-format off + +#include "generated_plugin_registrant.h" + + +void RegisterPlugins(flutter::PluginRegistry* registry) { +} diff --git a/packages/re_editor/example/windows/flutter/generated_plugin_registrant.h b/packages/re_editor/example/windows/flutter/generated_plugin_registrant.h new file mode 100644 index 0000000..dc139d8 --- /dev/null +++ b/packages/re_editor/example/windows/flutter/generated_plugin_registrant.h @@ -0,0 +1,15 @@ +// +// Generated file. Do not edit. +// + +// clang-format off + +#ifndef GENERATED_PLUGIN_REGISTRANT_ +#define GENERATED_PLUGIN_REGISTRANT_ + +#include + +// Registers Flutter plugins. +void RegisterPlugins(flutter::PluginRegistry* registry); + +#endif // GENERATED_PLUGIN_REGISTRANT_ diff --git a/packages/re_editor/example/windows/flutter/generated_plugins.cmake b/packages/re_editor/example/windows/flutter/generated_plugins.cmake new file mode 100644 index 0000000..b93c4c3 --- /dev/null +++ b/packages/re_editor/example/windows/flutter/generated_plugins.cmake @@ -0,0 +1,23 @@ +# +# Generated file, do not edit. +# + +list(APPEND FLUTTER_PLUGIN_LIST +) + +list(APPEND FLUTTER_FFI_PLUGIN_LIST +) + +set(PLUGIN_BUNDLED_LIBRARIES) + +foreach(plugin ${FLUTTER_PLUGIN_LIST}) + add_subdirectory(flutter/ephemeral/.plugin_symlinks/${plugin}/windows plugins/${plugin}) + target_link_libraries(${BINARY_NAME} PRIVATE ${plugin}_plugin) + list(APPEND PLUGIN_BUNDLED_LIBRARIES $) + list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${plugin}_bundled_libraries}) +endforeach(plugin) + +foreach(ffi_plugin ${FLUTTER_FFI_PLUGIN_LIST}) + add_subdirectory(flutter/ephemeral/.plugin_symlinks/${ffi_plugin}/windows plugins/${ffi_plugin}) + list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${ffi_plugin}_bundled_libraries}) +endforeach(ffi_plugin) diff --git a/packages/re_editor/example/windows/runner/CMakeLists.txt b/packages/re_editor/example/windows/runner/CMakeLists.txt new file mode 100644 index 0000000..394917c --- /dev/null +++ b/packages/re_editor/example/windows/runner/CMakeLists.txt @@ -0,0 +1,40 @@ +cmake_minimum_required(VERSION 3.14) +project(runner LANGUAGES CXX) + +# Define the application target. To change its name, change BINARY_NAME in the +# top-level CMakeLists.txt, not the value here, or `flutter run` will no longer +# work. +# +# Any new source files that you add to the application should be added here. +add_executable(${BINARY_NAME} WIN32 + "flutter_window.cpp" + "main.cpp" + "utils.cpp" + "win32_window.cpp" + "${FLUTTER_MANAGED_DIR}/generated_plugin_registrant.cc" + "Runner.rc" + "runner.exe.manifest" +) + +# Apply the standard set of build settings. This can be removed for applications +# that need different build settings. +apply_standard_settings(${BINARY_NAME}) + +# Add preprocessor definitions for the build version. +target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION=\"${FLUTTER_VERSION}\"") +target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_MAJOR=${FLUTTER_VERSION_MAJOR}") +target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_MINOR=${FLUTTER_VERSION_MINOR}") +target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_PATCH=${FLUTTER_VERSION_PATCH}") +target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_BUILD=${FLUTTER_VERSION_BUILD}") + +# Disable Windows macros that collide with C++ standard library functions. +target_compile_definitions(${BINARY_NAME} PRIVATE "NOMINMAX") + +# Add dependency libraries and include directories. Add any application-specific +# dependencies here. +target_link_libraries(${BINARY_NAME} PRIVATE flutter flutter_wrapper_app) +target_link_libraries(${BINARY_NAME} PRIVATE "dwmapi.lib") +target_include_directories(${BINARY_NAME} PRIVATE "${CMAKE_SOURCE_DIR}") + +# Run the Flutter tool portions of the build. This must not be removed. +add_dependencies(${BINARY_NAME} flutter_assemble) diff --git a/packages/re_editor/example/windows/runner/Runner.rc b/packages/re_editor/example/windows/runner/Runner.rc new file mode 100644 index 0000000..687e6bd --- /dev/null +++ b/packages/re_editor/example/windows/runner/Runner.rc @@ -0,0 +1,121 @@ +// Microsoft Visual C++ generated resource script. +// +#pragma code_page(65001) +#include "resource.h" + +#define APSTUDIO_READONLY_SYMBOLS +///////////////////////////////////////////////////////////////////////////// +// +// Generated from the TEXTINCLUDE 2 resource. +// +#include "winres.h" + +///////////////////////////////////////////////////////////////////////////// +#undef APSTUDIO_READONLY_SYMBOLS + +///////////////////////////////////////////////////////////////////////////// +// English (United States) resources + +#if !defined(AFX_RESOURCE_DLL) || defined(AFX_TARG_ENU) +LANGUAGE LANG_ENGLISH, SUBLANG_ENGLISH_US + +#ifdef APSTUDIO_INVOKED +///////////////////////////////////////////////////////////////////////////// +// +// TEXTINCLUDE +// + +1 TEXTINCLUDE +BEGIN + "resource.h\0" +END + +2 TEXTINCLUDE +BEGIN + "#include ""winres.h""\r\n" + "\0" +END + +3 TEXTINCLUDE +BEGIN + "\r\n" + "\0" +END + +#endif // APSTUDIO_INVOKED + + +///////////////////////////////////////////////////////////////////////////// +// +// Icon +// + +// Icon with lowest ID value placed first to ensure application icon +// remains consistent on all systems. +IDI_APP_ICON ICON "resources\\app_icon.ico" + + +///////////////////////////////////////////////////////////////////////////// +// +// Version +// + +#if defined(FLUTTER_VERSION_MAJOR) && defined(FLUTTER_VERSION_MINOR) && defined(FLUTTER_VERSION_PATCH) && defined(FLUTTER_VERSION_BUILD) +#define VERSION_AS_NUMBER FLUTTER_VERSION_MAJOR,FLUTTER_VERSION_MINOR,FLUTTER_VERSION_PATCH,FLUTTER_VERSION_BUILD +#else +#define VERSION_AS_NUMBER 1,0,0,0 +#endif + +#if defined(FLUTTER_VERSION) +#define VERSION_AS_STRING FLUTTER_VERSION +#else +#define VERSION_AS_STRING "1.0.0" +#endif + +VS_VERSION_INFO VERSIONINFO + FILEVERSION VERSION_AS_NUMBER + PRODUCTVERSION VERSION_AS_NUMBER + FILEFLAGSMASK VS_FFI_FILEFLAGSMASK +#ifdef _DEBUG + FILEFLAGS VS_FF_DEBUG +#else + FILEFLAGS 0x0L +#endif + FILEOS VOS__WINDOWS32 + FILETYPE VFT_APP + FILESUBTYPE 0x0L +BEGIN + BLOCK "StringFileInfo" + BEGIN + BLOCK "040904e4" + BEGIN + VALUE "CompanyName", "com.example" "\0" + VALUE "FileDescription", "example" "\0" + VALUE "FileVersion", VERSION_AS_STRING "\0" + VALUE "InternalName", "example" "\0" + VALUE "LegalCopyright", "Copyright (C) 2024 com.example. All rights reserved." "\0" + VALUE "OriginalFilename", "example.exe" "\0" + VALUE "ProductName", "example" "\0" + VALUE "ProductVersion", VERSION_AS_STRING "\0" + END + END + BLOCK "VarFileInfo" + BEGIN + VALUE "Translation", 0x409, 1252 + END +END + +#endif // English (United States) resources +///////////////////////////////////////////////////////////////////////////// + + + +#ifndef APSTUDIO_INVOKED +///////////////////////////////////////////////////////////////////////////// +// +// Generated from the TEXTINCLUDE 3 resource. +// + + +///////////////////////////////////////////////////////////////////////////// +#endif // not APSTUDIO_INVOKED diff --git a/packages/re_editor/example/windows/runner/flutter_window.cpp b/packages/re_editor/example/windows/runner/flutter_window.cpp new file mode 100644 index 0000000..955ee30 --- /dev/null +++ b/packages/re_editor/example/windows/runner/flutter_window.cpp @@ -0,0 +1,71 @@ +#include "flutter_window.h" + +#include + +#include "flutter/generated_plugin_registrant.h" + +FlutterWindow::FlutterWindow(const flutter::DartProject& project) + : project_(project) {} + +FlutterWindow::~FlutterWindow() {} + +bool FlutterWindow::OnCreate() { + if (!Win32Window::OnCreate()) { + return false; + } + + RECT frame = GetClientArea(); + + // The size here must match the window dimensions to avoid unnecessary surface + // creation / destruction in the startup path. + flutter_controller_ = std::make_unique( + frame.right - frame.left, frame.bottom - frame.top, project_); + // Ensure that basic setup of the controller was successful. + if (!flutter_controller_->engine() || !flutter_controller_->view()) { + return false; + } + RegisterPlugins(flutter_controller_->engine()); + SetChildContent(flutter_controller_->view()->GetNativeWindow()); + + flutter_controller_->engine()->SetNextFrameCallback([&]() { + this->Show(); + }); + + // Flutter can complete the first frame before the "show window" callback is + // registered. The following call ensures a frame is pending to ensure the + // window is shown. It is a no-op if the first frame hasn't completed yet. + flutter_controller_->ForceRedraw(); + + return true; +} + +void FlutterWindow::OnDestroy() { + if (flutter_controller_) { + flutter_controller_ = nullptr; + } + + Win32Window::OnDestroy(); +} + +LRESULT +FlutterWindow::MessageHandler(HWND hwnd, UINT const message, + WPARAM const wparam, + LPARAM const lparam) noexcept { + // Give Flutter, including plugins, an opportunity to handle window messages. + if (flutter_controller_) { + std::optional result = + flutter_controller_->HandleTopLevelWindowProc(hwnd, message, wparam, + lparam); + if (result) { + return *result; + } + } + + switch (message) { + case WM_FONTCHANGE: + flutter_controller_->engine()->ReloadSystemFonts(); + break; + } + + return Win32Window::MessageHandler(hwnd, message, wparam, lparam); +} diff --git a/packages/re_editor/example/windows/runner/flutter_window.h b/packages/re_editor/example/windows/runner/flutter_window.h new file mode 100644 index 0000000..6da0652 --- /dev/null +++ b/packages/re_editor/example/windows/runner/flutter_window.h @@ -0,0 +1,33 @@ +#ifndef RUNNER_FLUTTER_WINDOW_H_ +#define RUNNER_FLUTTER_WINDOW_H_ + +#include +#include + +#include + +#include "win32_window.h" + +// A window that does nothing but host a Flutter view. +class FlutterWindow : public Win32Window { + public: + // Creates a new FlutterWindow hosting a Flutter view running |project|. + explicit FlutterWindow(const flutter::DartProject& project); + virtual ~FlutterWindow(); + + protected: + // Win32Window: + bool OnCreate() override; + void OnDestroy() override; + LRESULT MessageHandler(HWND window, UINT const message, WPARAM const wparam, + LPARAM const lparam) noexcept override; + + private: + // The project to run. + flutter::DartProject project_; + + // The Flutter instance hosted by this window. + std::unique_ptr flutter_controller_; +}; + +#endif // RUNNER_FLUTTER_WINDOW_H_ diff --git a/packages/re_editor/example/windows/runner/main.cpp b/packages/re_editor/example/windows/runner/main.cpp new file mode 100644 index 0000000..a61bf80 --- /dev/null +++ b/packages/re_editor/example/windows/runner/main.cpp @@ -0,0 +1,43 @@ +#include +#include +#include + +#include "flutter_window.h" +#include "utils.h" + +int APIENTRY wWinMain(_In_ HINSTANCE instance, _In_opt_ HINSTANCE prev, + _In_ wchar_t *command_line, _In_ int show_command) { + // Attach to console when present (e.g., 'flutter run') or create a + // new console when running with a debugger. + if (!::AttachConsole(ATTACH_PARENT_PROCESS) && ::IsDebuggerPresent()) { + CreateAndAttachConsole(); + } + + // Initialize COM, so that it is available for use in the library and/or + // plugins. + ::CoInitializeEx(nullptr, COINIT_APARTMENTTHREADED); + + flutter::DartProject project(L"data"); + + std::vector command_line_arguments = + GetCommandLineArguments(); + + project.set_dart_entrypoint_arguments(std::move(command_line_arguments)); + + FlutterWindow window(project); + Win32Window::Point origin(10, 10); + Win32Window::Size size(1280, 720); + if (!window.Create(L"example", origin, size)) { + return EXIT_FAILURE; + } + window.SetQuitOnClose(true); + + ::MSG msg; + while (::GetMessage(&msg, nullptr, 0, 0)) { + ::TranslateMessage(&msg); + ::DispatchMessage(&msg); + } + + ::CoUninitialize(); + return EXIT_SUCCESS; +} diff --git a/packages/re_editor/example/windows/runner/resource.h b/packages/re_editor/example/windows/runner/resource.h new file mode 100644 index 0000000..66a65d1 --- /dev/null +++ b/packages/re_editor/example/windows/runner/resource.h @@ -0,0 +1,16 @@ +//{{NO_DEPENDENCIES}} +// Microsoft Visual C++ generated include file. +// Used by Runner.rc +// +#define IDI_APP_ICON 101 + +// Next default values for new objects +// +#ifdef APSTUDIO_INVOKED +#ifndef APSTUDIO_READONLY_SYMBOLS +#define _APS_NEXT_RESOURCE_VALUE 102 +#define _APS_NEXT_COMMAND_VALUE 40001 +#define _APS_NEXT_CONTROL_VALUE 1001 +#define _APS_NEXT_SYMED_VALUE 101 +#endif +#endif diff --git a/packages/re_editor/example/windows/runner/resources/app_icon.ico b/packages/re_editor/example/windows/runner/resources/app_icon.ico new file mode 100644 index 0000000000000000000000000000000000000000..c04e20caf6370ebb9253ad831cc31de4a9c965f6 GIT binary patch literal 33772 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 literal 0 HcmV?d00001 diff --git a/packages/re_editor/example/windows/runner/runner.exe.manifest b/packages/re_editor/example/windows/runner/runner.exe.manifest new file mode 100644 index 0000000..a42ea76 --- /dev/null +++ b/packages/re_editor/example/windows/runner/runner.exe.manifest @@ -0,0 +1,20 @@ + + + + + PerMonitorV2 + + + + + + + + + + + + + + + diff --git a/packages/re_editor/example/windows/runner/utils.cpp b/packages/re_editor/example/windows/runner/utils.cpp new file mode 100644 index 0000000..b2b0873 --- /dev/null +++ b/packages/re_editor/example/windows/runner/utils.cpp @@ -0,0 +1,65 @@ +#include "utils.h" + +#include +#include +#include +#include + +#include + +void CreateAndAttachConsole() { + if (::AllocConsole()) { + FILE *unused; + if (freopen_s(&unused, "CONOUT$", "w", stdout)) { + _dup2(_fileno(stdout), 1); + } + if (freopen_s(&unused, "CONOUT$", "w", stderr)) { + _dup2(_fileno(stdout), 2); + } + std::ios::sync_with_stdio(); + FlutterDesktopResyncOutputStreams(); + } +} + +std::vector GetCommandLineArguments() { + // Convert the UTF-16 command line arguments to UTF-8 for the Engine to use. + int argc; + wchar_t** argv = ::CommandLineToArgvW(::GetCommandLineW(), &argc); + if (argv == nullptr) { + return std::vector(); + } + + std::vector command_line_arguments; + + // Skip the first argument as it's the binary name. + for (int i = 1; i < argc; i++) { + command_line_arguments.push_back(Utf8FromUtf16(argv[i])); + } + + ::LocalFree(argv); + + return command_line_arguments; +} + +std::string Utf8FromUtf16(const wchar_t* utf16_string) { + if (utf16_string == nullptr) { + return std::string(); + } + int target_length = ::WideCharToMultiByte( + CP_UTF8, WC_ERR_INVALID_CHARS, utf16_string, + -1, nullptr, 0, nullptr, nullptr) + -1; // remove the trailing null character + int input_length = (int)wcslen(utf16_string); + std::string utf8_string; + if (target_length <= 0 || target_length > utf8_string.max_size()) { + return utf8_string; + } + utf8_string.resize(target_length); + int converted_length = ::WideCharToMultiByte( + CP_UTF8, WC_ERR_INVALID_CHARS, utf16_string, + input_length, utf8_string.data(), target_length, nullptr, nullptr); + if (converted_length == 0) { + return std::string(); + } + return utf8_string; +} diff --git a/packages/re_editor/example/windows/runner/utils.h b/packages/re_editor/example/windows/runner/utils.h new file mode 100644 index 0000000..3879d54 --- /dev/null +++ b/packages/re_editor/example/windows/runner/utils.h @@ -0,0 +1,19 @@ +#ifndef RUNNER_UTILS_H_ +#define RUNNER_UTILS_H_ + +#include +#include + +// Creates a console for the process, and redirects stdout and stderr to +// it for both the runner and the Flutter library. +void CreateAndAttachConsole(); + +// Takes a null-terminated wchar_t* encoded in UTF-16 and returns a std::string +// encoded in UTF-8. Returns an empty std::string on failure. +std::string Utf8FromUtf16(const wchar_t* utf16_string); + +// Gets the command line arguments passed in as a std::vector, +// encoded in UTF-8. Returns an empty std::vector on failure. +std::vector GetCommandLineArguments(); + +#endif // RUNNER_UTILS_H_ diff --git a/packages/re_editor/example/windows/runner/win32_window.cpp b/packages/re_editor/example/windows/runner/win32_window.cpp new file mode 100644 index 0000000..60608d0 --- /dev/null +++ b/packages/re_editor/example/windows/runner/win32_window.cpp @@ -0,0 +1,288 @@ +#include "win32_window.h" + +#include +#include + +#include "resource.h" + +namespace { + +/// Window attribute that enables dark mode window decorations. +/// +/// Redefined in case the developer's machine has a Windows SDK older than +/// version 10.0.22000.0. +/// See: https://docs.microsoft.com/windows/win32/api/dwmapi/ne-dwmapi-dwmwindowattribute +#ifndef DWMWA_USE_IMMERSIVE_DARK_MODE +#define DWMWA_USE_IMMERSIVE_DARK_MODE 20 +#endif + +constexpr const wchar_t kWindowClassName[] = L"FLUTTER_RUNNER_WIN32_WINDOW"; + +/// Registry key for app theme preference. +/// +/// A value of 0 indicates apps should use dark mode. A non-zero or missing +/// value indicates apps should use light mode. +constexpr const wchar_t kGetPreferredBrightnessRegKey[] = + L"Software\\Microsoft\\Windows\\CurrentVersion\\Themes\\Personalize"; +constexpr const wchar_t kGetPreferredBrightnessRegValue[] = L"AppsUseLightTheme"; + +// The number of Win32Window objects that currently exist. +static int g_active_window_count = 0; + +using EnableNonClientDpiScaling = BOOL __stdcall(HWND hwnd); + +// Scale helper to convert logical scaler values to physical using passed in +// scale factor +int Scale(int source, double scale_factor) { + return static_cast(source * scale_factor); +} + +// Dynamically loads the |EnableNonClientDpiScaling| from the User32 module. +// This API is only needed for PerMonitor V1 awareness mode. +void EnableFullDpiSupportIfAvailable(HWND hwnd) { + HMODULE user32_module = LoadLibraryA("User32.dll"); + if (!user32_module) { + return; + } + auto enable_non_client_dpi_scaling = + reinterpret_cast( + GetProcAddress(user32_module, "EnableNonClientDpiScaling")); + if (enable_non_client_dpi_scaling != nullptr) { + enable_non_client_dpi_scaling(hwnd); + } + FreeLibrary(user32_module); +} + +} // namespace + +// Manages the Win32Window's window class registration. +class WindowClassRegistrar { + public: + ~WindowClassRegistrar() = default; + + // Returns the singleton registrar instance. + static WindowClassRegistrar* GetInstance() { + if (!instance_) { + instance_ = new WindowClassRegistrar(); + } + return instance_; + } + + // Returns the name of the window class, registering the class if it hasn't + // previously been registered. + const wchar_t* GetWindowClass(); + + // Unregisters the window class. Should only be called if there are no + // instances of the window. + void UnregisterWindowClass(); + + private: + WindowClassRegistrar() = default; + + static WindowClassRegistrar* instance_; + + bool class_registered_ = false; +}; + +WindowClassRegistrar* WindowClassRegistrar::instance_ = nullptr; + +const wchar_t* WindowClassRegistrar::GetWindowClass() { + if (!class_registered_) { + WNDCLASS window_class{}; + window_class.hCursor = LoadCursor(nullptr, IDC_ARROW); + window_class.lpszClassName = kWindowClassName; + window_class.style = CS_HREDRAW | CS_VREDRAW; + window_class.cbClsExtra = 0; + window_class.cbWndExtra = 0; + window_class.hInstance = GetModuleHandle(nullptr); + window_class.hIcon = + LoadIcon(window_class.hInstance, MAKEINTRESOURCE(IDI_APP_ICON)); + window_class.hbrBackground = 0; + window_class.lpszMenuName = nullptr; + window_class.lpfnWndProc = Win32Window::WndProc; + RegisterClass(&window_class); + class_registered_ = true; + } + return kWindowClassName; +} + +void WindowClassRegistrar::UnregisterWindowClass() { + UnregisterClass(kWindowClassName, nullptr); + class_registered_ = false; +} + +Win32Window::Win32Window() { + ++g_active_window_count; +} + +Win32Window::~Win32Window() { + --g_active_window_count; + Destroy(); +} + +bool Win32Window::Create(const std::wstring& title, + const Point& origin, + const Size& size) { + Destroy(); + + const wchar_t* window_class = + WindowClassRegistrar::GetInstance()->GetWindowClass(); + + const POINT target_point = {static_cast(origin.x), + static_cast(origin.y)}; + HMONITOR monitor = MonitorFromPoint(target_point, MONITOR_DEFAULTTONEAREST); + UINT dpi = FlutterDesktopGetDpiForMonitor(monitor); + double scale_factor = dpi / 96.0; + + HWND window = CreateWindow( + window_class, title.c_str(), WS_OVERLAPPEDWINDOW, + Scale(origin.x, scale_factor), Scale(origin.y, scale_factor), + Scale(size.width, scale_factor), Scale(size.height, scale_factor), + nullptr, nullptr, GetModuleHandle(nullptr), this); + + if (!window) { + return false; + } + + UpdateTheme(window); + + return OnCreate(); +} + +bool Win32Window::Show() { + return ShowWindow(window_handle_, SW_SHOWNORMAL); +} + +// static +LRESULT CALLBACK Win32Window::WndProc(HWND const window, + UINT const message, + WPARAM const wparam, + LPARAM const lparam) noexcept { + if (message == WM_NCCREATE) { + auto window_struct = reinterpret_cast(lparam); + SetWindowLongPtr(window, GWLP_USERDATA, + reinterpret_cast(window_struct->lpCreateParams)); + + auto that = static_cast(window_struct->lpCreateParams); + EnableFullDpiSupportIfAvailable(window); + that->window_handle_ = window; + } else if (Win32Window* that = GetThisFromHandle(window)) { + return that->MessageHandler(window, message, wparam, lparam); + } + + return DefWindowProc(window, message, wparam, lparam); +} + +LRESULT +Win32Window::MessageHandler(HWND hwnd, + UINT const message, + WPARAM const wparam, + LPARAM const lparam) noexcept { + switch (message) { + case WM_DESTROY: + window_handle_ = nullptr; + Destroy(); + if (quit_on_close_) { + PostQuitMessage(0); + } + return 0; + + case WM_DPICHANGED: { + auto newRectSize = reinterpret_cast(lparam); + LONG newWidth = newRectSize->right - newRectSize->left; + LONG newHeight = newRectSize->bottom - newRectSize->top; + + SetWindowPos(hwnd, nullptr, newRectSize->left, newRectSize->top, newWidth, + newHeight, SWP_NOZORDER | SWP_NOACTIVATE); + + return 0; + } + case WM_SIZE: { + RECT rect = GetClientArea(); + if (child_content_ != nullptr) { + // Size and position the child window. + MoveWindow(child_content_, rect.left, rect.top, rect.right - rect.left, + rect.bottom - rect.top, TRUE); + } + return 0; + } + + case WM_ACTIVATE: + if (child_content_ != nullptr) { + SetFocus(child_content_); + } + return 0; + + case WM_DWMCOLORIZATIONCOLORCHANGED: + UpdateTheme(hwnd); + return 0; + } + + return DefWindowProc(window_handle_, message, wparam, lparam); +} + +void Win32Window::Destroy() { + OnDestroy(); + + if (window_handle_) { + DestroyWindow(window_handle_); + window_handle_ = nullptr; + } + if (g_active_window_count == 0) { + WindowClassRegistrar::GetInstance()->UnregisterWindowClass(); + } +} + +Win32Window* Win32Window::GetThisFromHandle(HWND const window) noexcept { + return reinterpret_cast( + GetWindowLongPtr(window, GWLP_USERDATA)); +} + +void Win32Window::SetChildContent(HWND content) { + child_content_ = content; + SetParent(content, window_handle_); + RECT frame = GetClientArea(); + + MoveWindow(content, frame.left, frame.top, frame.right - frame.left, + frame.bottom - frame.top, true); + + SetFocus(child_content_); +} + +RECT Win32Window::GetClientArea() { + RECT frame; + GetClientRect(window_handle_, &frame); + return frame; +} + +HWND Win32Window::GetHandle() { + return window_handle_; +} + +void Win32Window::SetQuitOnClose(bool quit_on_close) { + quit_on_close_ = quit_on_close; +} + +bool Win32Window::OnCreate() { + // No-op; provided for subclasses. + return true; +} + +void Win32Window::OnDestroy() { + // No-op; provided for subclasses. +} + +void Win32Window::UpdateTheme(HWND const window) { + DWORD light_mode; + DWORD light_mode_size = sizeof(light_mode); + LSTATUS result = RegGetValue(HKEY_CURRENT_USER, kGetPreferredBrightnessRegKey, + kGetPreferredBrightnessRegValue, + RRF_RT_REG_DWORD, nullptr, &light_mode, + &light_mode_size); + + if (result == ERROR_SUCCESS) { + BOOL enable_dark_mode = light_mode == 0; + DwmSetWindowAttribute(window, DWMWA_USE_IMMERSIVE_DARK_MODE, + &enable_dark_mode, sizeof(enable_dark_mode)); + } +} diff --git a/packages/re_editor/example/windows/runner/win32_window.h b/packages/re_editor/example/windows/runner/win32_window.h new file mode 100644 index 0000000..e901dde --- /dev/null +++ b/packages/re_editor/example/windows/runner/win32_window.h @@ -0,0 +1,102 @@ +#ifndef RUNNER_WIN32_WINDOW_H_ +#define RUNNER_WIN32_WINDOW_H_ + +#include + +#include +#include +#include + +// A class abstraction for a high DPI-aware Win32 Window. Intended to be +// inherited from by classes that wish to specialize with custom +// rendering and input handling +class Win32Window { + public: + struct Point { + unsigned int x; + unsigned int y; + Point(unsigned int x, unsigned int y) : x(x), y(y) {} + }; + + struct Size { + unsigned int width; + unsigned int height; + Size(unsigned int width, unsigned int height) + : width(width), height(height) {} + }; + + Win32Window(); + virtual ~Win32Window(); + + // Creates a win32 window with |title| that is positioned and sized using + // |origin| and |size|. New windows are created on the default monitor. Window + // sizes are specified to the OS in physical pixels, hence to ensure a + // consistent size this function will scale the inputted width and height as + // as appropriate for the default monitor. The window is invisible until + // |Show| is called. Returns true if the window was created successfully. + bool Create(const std::wstring& title, const Point& origin, const Size& size); + + // Show the current window. Returns true if the window was successfully shown. + bool Show(); + + // Release OS resources associated with window. + void Destroy(); + + // Inserts |content| into the window tree. + void SetChildContent(HWND content); + + // Returns the backing Window handle to enable clients to set icon and other + // window properties. Returns nullptr if the window has been destroyed. + HWND GetHandle(); + + // If true, closing this window will quit the application. + void SetQuitOnClose(bool quit_on_close); + + // Return a RECT representing the bounds of the current client area. + RECT GetClientArea(); + + protected: + // Processes and route salient window messages for mouse handling, + // size change and DPI. Delegates handling of these to member overloads that + // inheriting classes can handle. + virtual LRESULT MessageHandler(HWND window, + UINT const message, + WPARAM const wparam, + LPARAM const lparam) noexcept; + + // Called when CreateAndShow is called, allowing subclass window-related + // setup. Subclasses should return false if setup fails. + virtual bool OnCreate(); + + // Called when Destroy is called. + virtual void OnDestroy(); + + private: + friend class WindowClassRegistrar; + + // OS callback called by message pump. Handles the WM_NCCREATE message which + // is passed when the non-client area is being created and enables automatic + // non-client DPI scaling so that the non-client area automatically + // responds to changes in DPI. All other messages are handled by + // MessageHandler. + static LRESULT CALLBACK WndProc(HWND const window, + UINT const message, + WPARAM const wparam, + LPARAM const lparam) noexcept; + + // Retrieves a class instance pointer for |window| + static Win32Window* GetThisFromHandle(HWND const window) noexcept; + + // Update the window frame's theme to match the system theme. + static void UpdateTheme(HWND const window); + + bool quit_on_close_ = false; + + // window handle for top level window. + HWND window_handle_ = nullptr; + + // window handle for hosted content. + HWND child_content_ = nullptr; +}; + +#endif // RUNNER_WIN32_WINDOW_H_ diff --git a/packages/re_editor/lib/re_editor.dart b/packages/re_editor/lib/re_editor.dart new file mode 100644 index 0000000..51e9788 --- /dev/null +++ b/packages/re_editor/lib/re_editor.dart @@ -0,0 +1 @@ +export 'src/re_editor.dart'; \ No newline at end of file diff --git a/packages/re_editor/lib/src/_code_autocomplete.dart b/packages/re_editor/lib/src/_code_autocomplete.dart new file mode 100644 index 0000000..fae1006 --- /dev/null +++ b/packages/re_editor/lib/src/_code_autocomplete.dart @@ -0,0 +1,323 @@ +part of re_editor; + +class _DefaultCodeAutocompletePromptsBuilder implements DefaultCodeAutocompletePromptsBuilder { + + final Mode? language; + final List keywordPrompts; + final List directPrompts; + final Map> relatedPrompts; + + final Set _allKeywordPrompts = {}; + + _DefaultCodeAutocompletePromptsBuilder({ + this.language, + required this.keywordPrompts, + required this.directPrompts, + required this.relatedPrompts + }) { + _allKeywordPrompts.addAll(keywordPrompts); + _allKeywordPrompts.addAll(directPrompts); + final dynamic keywords = language?.keywords; + if (keywords is Map) { + final dynamic keywordList = keywords['keyword']; + if (keywordList is List) { + _allKeywordPrompts.addAll(keywordList.map( + (keyword) => CodeKeywordPrompt(word: keyword)) + ); + } + final dynamic builtInList = keywords['built_in']; + if (builtInList is List) { + _allKeywordPrompts.addAll(builtInList.map( + (keyword) => CodeKeywordPrompt(word: keyword)) + ); + } + final dynamic literalList = keywords['literal']; + if (literalList is List) { + _allKeywordPrompts.addAll(literalList.map( + (keyword) => CodeKeywordPrompt(word: keyword)) + ); + } + final dynamic typeList = keywords['type']; + if (typeList is List) { + _allKeywordPrompts.addAll(typeList.map( + (keyword) => CodeKeywordPrompt(word: keyword)) + ); + } + } + } + + @override + CodeAutocompleteEditingValue? build(BuildContext context, CodeLine codeLine, CodeLineSelection selection) { + final String text = codeLine.text; + final Characters charactersBefore = text.substring(0, selection.extentOffset).characters; + if (charactersBefore.isEmpty) { + return null; + } + final Characters charactersAfter = text.substring(selection.extentOffset).characters; + // FIXME:Check whether the position is inside a string + if (charactersBefore.containsSymbols(const ['\'', '"']) && charactersAfter.containsSymbols(const ['\'', '"'])) { + return null; + } + // TODO Should check operator `->` for some languages like c/c++ + final Iterable prompts; + final String input; + if (charactersBefore.takeLast(1).string == '.') { + input = ''; + int start = charactersBefore.length - 2; + for (; start >= 0; start--) { + if (!charactersBefore.elementAt(start).isValidVariablePart) { + break; + } + } + final String target = charactersBefore.getRange(start + 1, charactersBefore.length - 1).string; + prompts = relatedPrompts[target] ?? const []; + } else { + int start = charactersBefore.length - 1; + for (; start >= 0; start--) { + if (!charactersBefore.elementAt(start).isValidVariablePart) { + break; + } + } + input = charactersBefore.getRange(start + 1, charactersBefore.length).string; + if (input.isEmpty) { + return null; + } + if (start > 0 && charactersBefore.elementAt(start) == '.') { + final int mark = start; + for (start = start - 1; start >= 0; start--) { + if (!charactersBefore.elementAt(start).isValidVariablePart) { + break; + } + } + final String target = charactersBefore.getRange(start + 1, mark).string; + prompts = relatedPrompts[target]?.where( + (prompt) => prompt.match(input) + ) ?? const []; + } else { + prompts = _allKeywordPrompts.where( + (prompt) => prompt.match(input) + ); + } + } + if (prompts.isEmpty) { + return null; + } + return CodeAutocompleteEditingValue( + input: input, + prompts: prompts.toList(), + index: 0 + ); + } + +} + +class _CodeAutocomplete extends StatefulWidget { + + const _CodeAutocomplete({ + required this.viewBuilder, + required this.promptsBuilder, + required this.child, + }); + + final CodeAutocompleteWidgetBuilder viewBuilder; + final CodeAutocompletePromptsBuilder promptsBuilder; + final Widget child; + + @override + State createState() => _CodeAutocompleteState(); + +} + +class _CodeAutocompleteState extends State<_CodeAutocomplete> { + + late final _CodeAutocompleteNavigateAction _navigateAction; + late final _CodeAutocompleteAction _selectAction; + + ValueChanged? _onAutocomplete; + OverlayEntry? _overlayEntry; + ValueNotifier? _notifier; + + @override + void initState() { + super.initState(); + _navigateAction = _CodeAutocompleteNavigateAction( + onInvoke: (intent) { + final CodeAutocompleteEditingValue? value = _notifier?.value; + if (value == null) { + return null; + } + int newIndex = value.index; + if (intent.direction == AxisDirection.up) { + newIndex--; + } else { + newIndex++; + } + if (newIndex < 0) { + newIndex = value.prompts.length - 1; + } else if (newIndex >= value.prompts.length) { + newIndex = 0; + } + _notifier?.value = value.copyWith( + index: newIndex, + ); + return intent; + }, + ); + _selectAction = _CodeAutocompleteAction( + onInvoke: (intent) { + final CodeAutocompleteEditingValue? value = _notifier?.value; + if (value == null) { + return null; + } + _onAutocomplete?.call(value.autocomplete); + return intent; + }, + ); + } + + @override + void didUpdateWidget(covariant _CodeAutocomplete oldWidget) { + super.didUpdateWidget(oldWidget); + } + + @override + Widget build(BuildContext context) { + return Actions( + actions: { + CodeShortcutCursorMoveIntent: _navigateAction, + CodeShortcutNewLineIntent: _selectAction, + }, + child: widget.child + ); + } + + void show({ + required LayerLink layerLink, + required Offset position, + required double lineHeight, + required CodeLineEditingValue value, + required ValueChanged onAutocomplete, + }) { + dismiss(); + final CodeAutocompleteEditingValue? autocompleteEditingValue = widget.promptsBuilder.build( + context, + value.codeLines[value.selection.extentIndex], + value.selection, + ); + if (autocompleteEditingValue == null) { + return; + } + _notifier = ValueNotifier(autocompleteEditingValue); + _onAutocomplete = onAutocomplete; + _overlayEntry = OverlayEntry( + builder:(context) { + return _buildWidget(context, layerLink, position, lineHeight); + }, + ); + Overlay.of(context, rootOverlay: true).insert(_overlayEntry!); + _navigateAction.setEnabled(true); + _selectAction.setEnabled(true); + } + + void dismiss() { + _notifier = null; + _onAutocomplete = null; + _overlayEntry?.remove(); + _overlayEntry = null; + _navigateAction.setEnabled(false); + _selectAction.setEnabled(false); + } + + Widget _buildWidget(BuildContext context, LayerLink layerLink, Offset position, double lineHeight) { + final PreferredSizeWidget child = widget.viewBuilder(context, _notifier!, (result) { + _onAutocomplete?.call(result); + }); + final Size screenSize = MediaQuery.of(context).size; + final double offsetX; + if (position.dx + child.preferredSize.width > screenSize.width) { + offsetX = screenSize.width - (position.dx + child.preferredSize.width); + } else { + offsetX = 0; + } + final double offsetY; + if (position.dy + child.preferredSize.height > screenSize.height) { + offsetY = -child.preferredSize.height - lineHeight; + } else { + offsetY = 0; + } + return CompositedTransformFollower( + link: layerLink, + showWhenUnlinked: false, + offset: Offset(offsetX, offsetY), + child: Align( + alignment: Alignment.topLeft, + child: Material( + color: Colors.transparent, + child: TapRegion( + onTapOutside: (event) { + dismiss(); + }, + child: CodeEditorTapRegion( + child: ExcludeSemantics( + child: child, + ) + ) + ), + ) + ), + ); + } + +} + +class _CodeAutocompleteAction extends CallbackAction { + + bool _isEnabled = false; + + _CodeAutocompleteAction({ + required super.onInvoke + }); + + void setEnabled(bool enabled) { + _isEnabled = enabled; + } + + @override + bool get isActionEnabled => _isEnabled; + +} + +class _CodeAutocompleteNavigateAction extends _CodeAutocompleteAction { + + _CodeAutocompleteNavigateAction({ + required super.onInvoke + }); + + @override + bool consumesKey(CodeShortcutCursorMoveIntent intent) { + return intent.direction == AxisDirection.up || intent.direction == AxisDirection.down; + } + +} + +extension _CodeAutocompleteStringExtension on String { + + bool get isValidVariablePart { + final int char = codeUnits.first; + return (char >= 65 && char <= 90) || (char >= 97 && char <= 122) || char == 95; + } + +} + +extension _CodeAutocompleteCharactersExtension on Characters { + + bool containsSymbols(List symbols) { + for (int i = length - 1; i >= 0; i--) { + if (symbols.contains(elementAt(i))) { + return true; + } + } + return false; + } + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/_code_editable.dart b/packages/re_editor/lib/src/_code_editable.dart new file mode 100644 index 0000000..365f6d7 --- /dev/null +++ b/packages/re_editor/lib/src/_code_editable.dart @@ -0,0 +1,489 @@ +part of re_editor; + +const double _kDefaultTextSize = 13.0; +const double _kDefaultFontHeight = 1.4; +const double _kDefaultCaretWidth = 2; +const EdgeInsetsGeometry _kDefaultPadding = EdgeInsets.all(5); +const Duration _kCursorBlinkHalfPeriod = Duration(milliseconds: 500); + +class _CodeEditable extends StatefulWidget { + + final GlobalKey editorKey; + final String? hint; + final CodeIndicatorBuilder? indicatorBuilder; + final CodeScrollbarBuilder? scrollbarBuilder; + final double? verticalScrollbarWidth; + final double? horizontalScrollbarHeight; + final TextStyle textStyle; + final Color? hintTextColor; + final Color? backgroundColor; + final Color selectionColor; + final Color highlightColor; + final Color cursorColor; + final Color? cursorLineColor; + final Color? chunkIndicatorColor; + final double cursorWidth; + final bool showCursorWhenReadOnly; + final EdgeInsetsGeometry padding; + final EdgeInsetsGeometry margin; + final Widget? leadingDivider; + final Border? border; + final BorderRadius? borderRadius; + final Clip clipBehavior; + final ValueChanged? onChanged; + final FocusNode focusNode; + final CodeLineEditingController controller; + final _CodeInputController inputController; + final _CodeFloatingCursorController floatingCursorController; + final CodeHighlightTheme? codeTheme; + final bool readOnly; + final bool autofocus; + final bool wordWrap; + final int? maxLengthSingleLineRendering; + final CodeFindController findController; + final CodeScrollController scrollController; + final CodeChunkController chunkController; + final LayerLink startHandleLayerLink; + final LayerLink endHandleLayerLink; + final LayerLink toolbarLayerLink; + final _SelectionOverlayController selectionOverlayController; + + const _CodeEditable({ + required this.editorKey, + this.hint, + this.indicatorBuilder, + this.scrollbarBuilder, + this.verticalScrollbarWidth, + this.horizontalScrollbarHeight, + required this.textStyle, + this.hintTextColor, + this.backgroundColor, + required this.selectionColor, + required this.highlightColor, + required this.cursorColor, + this.cursorLineColor, + this.chunkIndicatorColor, + required this.cursorWidth, + required this.showCursorWhenReadOnly, + required this.padding, + required this.margin, + required this.leadingDivider, + this.border, + this.borderRadius, + this.clipBehavior = Clip.none, + this.onChanged, + required this.focusNode, + required this.controller, + required this.inputController, + required this.floatingCursorController, + required this.codeTheme, + required this.readOnly, + required this.autofocus, + required this.wordWrap, + this.maxLengthSingleLineRendering, + required this.findController, + required this.scrollController, + required this.chunkController, + required this.startHandleLayerLink, + required this.endHandleLayerLink, + required this.toolbarLayerLink, + required this.selectionOverlayController, + }); + + @override + State createState() => _CodeEditableState(); + +} + +class _CodeEditableState extends State<_CodeEditable> with AutomaticKeepAliveClientMixin<_CodeEditable>, SingleTickerProviderStateMixin { + + late bool _didAutoFocus; + late final _CodeCursorBlinkController _cursorController; + + late AnimationController _floatingCursorAnimationController; + + late _CodeHighlighter _highlighter; + late CodeIndicatorValueNotifier _codeIndicatorValueNotifier; + + @override + bool get wantKeepAlive => widget.focusNode.hasFocus; + + @override + void initState() { + super.initState(); + _didAutoFocus = false; + + widget.controller.addListener(_onCodeInputChanged); + widget.inputController.addListener(_onCodeUserInputChanged); + + _highlighter = _CodeHighlighter( + context: context, + controller: widget.controller, + theme: widget.codeTheme, + ); + + _codeIndicatorValueNotifier = CodeIndicatorValueNotifier(null); + + _cursorController = _CodeCursorBlinkController(); + _floatingCursorAnimationController = AnimationController(vsync: this); + + widget.floatingCursorController + ..blinkController = _cursorController + ..animationController = _floatingCursorAnimationController; + + widget.focusNode.addListener(_onFocusChanged); + widget.findController.addListener(_onCodeFindChanged); + } + + @override + void didUpdateWidget(covariant _CodeEditable oldWidget) { + if (oldWidget.controller != widget.controller) { + _highlighter.controller = widget.controller; + oldWidget.controller.removeListener(_onCodeInputChanged); + widget.controller.addListener(_onCodeInputChanged); + } + if (oldWidget.inputController != widget.inputController) { + oldWidget.inputController.removeListener(_onCodeUserInputChanged); + widget.inputController.addListener(_onCodeUserInputChanged); + } + if (oldWidget.focusNode != widget.focusNode) { + oldWidget.focusNode.removeListener(_onFocusChanged); + widget.focusNode.addListener(_onFocusChanged); + } + if (oldWidget.findController != widget.findController) { + oldWidget.findController.removeListener(_onCodeFindChanged); + widget.findController.addListener(_onCodeFindChanged); + } + if (oldWidget.codeTheme != widget.codeTheme) { + _highlighter.theme = widget.codeTheme; + } + super.didUpdateWidget(oldWidget); + } + + @override + void didChangeDependencies() { + super.didChangeDependencies(); + if (!_didAutoFocus && widget.autofocus) { + _didAutoFocus = true; + SchedulerBinding.instance.addPostFrameCallback((_) { + if (mounted) { + FocusScope.of(context).autofocus(widget.focusNode); + } + }); + } + } + + @override + void dispose() { + widget.controller.removeListener(_onCodeInputChanged); + widget.inputController.removeListener(_onCodeUserInputChanged); + _highlighter.dispose(); + _codeIndicatorValueNotifier.dispose(); + _cursorController.dispose(); + _floatingCursorAnimationController.dispose(); + widget.focusNode.removeListener(_onFocusChanged); + widget.findController.removeListener(_onCodeFindChanged); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + super.build(context); + final Widget child = _CodeScrollable( + axisDirection: AxisDirection.down, + controller: widget.scrollController.verticalScroller, + viewportBuilder: (context, ViewportOffset vertical) { + Widget codeField; + if (widget.wordWrap) { + codeField = _buildCodeField(vertical, null); + } else { + codeField = _CodeScrollable( + axisDirection: AxisDirection.right, + controller: widget.scrollController.horizontalScroller, + viewportBuilder: (context, ViewportOffset horizontal) { + return _buildCodeField(vertical, horizontal); + }, + scrollbarBuilder: widget.scrollbarBuilder + ); + } + if (widget.controller.value.isInitial) { + final String? hint = widget.hint; + if (hint != null && hint.isNotEmpty) { + codeField = Stack( + children: [ + codeField, + IgnorePointer( + ignoring: true, + child: Padding( + padding: widget.padding, + child: Text( + hint, + style: widget.textStyle.copyWith( + color: widget.hintTextColor + ), + ), + ) + ) + ], + ); + } + } + final Widget? indicator = widget.indicatorBuilder?.call( + context, + widget.controller, + widget.chunkController, + _codeIndicatorValueNotifier + ); + return Container( + decoration: BoxDecoration( + border: widget.border, + color: widget.backgroundColor, + borderRadius: widget.borderRadius, + ), + clipBehavior: widget.clipBehavior, + margin: widget.margin, + child: Row( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + if (indicator != null) + indicator, + if (widget.leadingDivider != null) + widget.leadingDivider!, + Expanded( + child: RepaintBoundary( + child: CompositedTransformTarget( + link: widget.toolbarLayerLink, + child: codeField + ), + ), + ) + ], + ), + ); + }, + scrollbarBuilder: widget.scrollbarBuilder + ); + return CodeEditorTapRegion( + onTapOutside: (_) { + widget.focusNode.unfocus(); + }, + child: NotificationListener( + onNotification: (notification) { + if (notification is ScrollStartNotification) { + widget.selectionOverlayController.hideToolbar(); + } + return false; + }, + child: child + ) + ); + } + + Widget _buildCodeField(ViewportOffset vertical, ViewportOffset? horizontal) { + return _CodeField( + key: widget.editorKey, + verticalViewport: vertical, + horizontalViewport: horizontal, + verticalScrollbarWidth: widget.verticalScrollbarWidth ?? _kScrollbarThickness, + horizontalScrollbarHeight: widget.horizontalScrollbarHeight ?? _kScrollbarThickness, + selection: widget.controller.selection, + highlightSelections: widget.findController.allMatchSelections, + codes: widget.controller.codeLines, + textStyle: widget.textStyle, + hasFocus: widget.focusNode.hasFocus, + highlighter: _highlighter, + showCursorNotifier: _cursorController, + floatingCursorNotifier: widget.floatingCursorController, + onRenderParagraphsChanged: (paragraphs) { + _codeIndicatorValueNotifier.value = CodeIndicatorValue( + paragraphs: paragraphs, + focusedIndex: widget.controller.selection.extentIndex + ); + }, + selectionColor: widget.selectionColor, + highlightColor: widget.highlightColor, + cursorColor: widget.cursorColor, + cursorLineColor: widget.cursorLineColor, + chunkIndicatorColor: widget.chunkIndicatorColor, + cursorWidth: widget.cursorWidth, + padding: widget.padding, + readOnly: widget.readOnly, + // Enable long text rendering when the find is on. + maxLengthSingleLineRendering: widget.findController.value != null ? null : widget.maxLengthSingleLineRendering, + startHandleLayerLink: widget.startHandleLayerLink, + endHandleLayerLink: widget.endHandleLayerLink, + ); + } + + void _onFocusChanged() { + if (!mounted) { + return; + } + _updateCursorState(); + _updateAutoCompleteState(false); + updateKeepAlive(); + if (!widget.focusNode.hasFocus) { + if (kIsAndroid || kIsIOS) { + widget.controller.cancelSelection(); + } + widget.selectionOverlayController.hideHandle(); + widget.selectionOverlayController.hideToolbar(); + } + } + + void _onCodeInputChanged() { + if (!mounted) { + return; + } + widget.onChanged?.call(widget.controller.value); + if (widget.controller.codeLines != widget.controller.preValue?.codeLines && + widget.controller.preValue != null) { + widget.selectionOverlayController.hideHandle(); + widget.selectionOverlayController.hideToolbar(); + } else { + _updateAutoCompleteState(false); + } + _updateCursorState(); + setState(() { + }); + } + + void _onCodeUserInputChanged() { + if (!mounted) { + return; + } + // Delay 50ms to update the auto-complate prompt words. + Future.delayed(const Duration(milliseconds: 50), () { + _updateAutoCompleteState(true); + }); + } + + void _onCodeFindChanged() { + if (!mounted) { + return; + } + final CodeFindValue? value = widget.findController.value; + if (value == null) { + widget.focusNode.requestFocus(); + return; + } + if (widget.focusNode.hasFocus) { + return; + } + final CodeLineSelection? currentMatch = widget.findController.currentMatchSelection; + if (currentMatch == null) { + return; + } + widget.controller.selection = currentMatch; + if (currentMatch.isSameLine) { + widget.controller.makePositionCenterIfInvisible(CodeLinePosition( + index: currentMatch.start.index, + offset: (currentMatch.startOffset + currentMatch.endOffset) >> 1 + )); + } else { + widget.controller.makePositionCenterIfInvisible(currentMatch.start); + } + } + + void _updateCursorState() { + if (widget.focusNode.hasFocus && (!widget.readOnly || widget.showCursorWhenReadOnly)) { + _cursorController.startBlink(); + } else { + _cursorController.stopBlink(); + } + } + + void _updateAutoCompleteState(bool isCodeLineChanged) { + if (!mounted) { + return; + } + final _CodeAutocompleteState? autocompleteState; + try { + autocompleteState = context.findAncestorStateOfType<_CodeAutocompleteState>(); + } catch (e) { + // Ignore the error when the widget is disposed. + return; + } + if (autocompleteState == null) { + return; + } + if (!isCodeLineChanged) { + autocompleteState.dismiss(); + return; + } + if (widget.controller.isComposing || !widget.controller.selection.isCollapsed) { + autocompleteState.dismiss(); + return; + } + final _CodeFieldRender? render = widget.editorKey.currentContext?.findRenderObject() as _CodeFieldRender?; + if (render == null) { + autocompleteState.dismiss(); + return; + } + final Offset? position = render.calculateTextPositionScreenOffset(widget.controller.selection.extent, true); + if (position == null) { + autocompleteState.dismiss(); + return; + } + autocompleteState.show( + layerLink: widget.startHandleLayerLink, + position: position, + lineHeight: render.lineHeight, + value: widget.controller.value, + onAutocomplete: (value) { + autocompleteState?.dismiss(); + final CodeLineSelection selection = widget.controller.selection; + widget.controller.replaceSelection(value.word, selection.copyWith( + baseOffset: selection.baseOffset - value.input.length, + )); + widget.controller.selection = selection.copyWith( + baseOffset: selection.baseOffset + value.selection.baseOffset, + extentOffset: selection.extentOffset + value.selection.extentOffset, + ); + } + ); + } + +} + +class _CodeCursorBlinkController extends ValueNotifier { + + Timer? _timer; + + _CodeCursorBlinkController() : super(false); + + void startBlink() { + if (_timer != null) { + _timer!.cancel(); + } + _timer = Timer.periodic(_kCursorBlinkHalfPeriod, _cursorTick); + if (kIsAndroid || kIsIOS) { + // Wait selection position to update + Future.delayed(const Duration(milliseconds: 100), () { + value = true; + }); + } else { + value = true; + } + } + + void stopBlink() { + if (_timer == null) { + return; + } + _timer?.cancel(); + _timer = null; + value = false; + } + + void _cursorTick(Timer timer) { + value = !value; + } + + @override + void dispose() { + stopBlink(); + super.dispose(); + } + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/_code_extensions.dart b/packages/re_editor/lib/src/_code_extensions.dart new file mode 100644 index 0000000..ef8a7ec --- /dev/null +++ b/packages/re_editor/lib/src/_code_extensions.dart @@ -0,0 +1,44 @@ +part of re_editor; + +extension _InlineSpanExtension on InlineSpan { + + int get length => _computeLength(); + + int _computeLength() { + int len = 0; + if (this is TextSpan) { + len += (this as TextSpan).length; + } else { + len += toPlainText(includePlaceholders: false).length; + } + return len; + } + +} + +extension _TextSpanExtension on TextSpan { + + int get length => _computeLength(); + + int _computeLength() { + int len = 0; + if (text != null) { + len += text!.length; + } + if (children != null) { + for (final InlineSpan span in children!) { + len += span.length; + } + } + return len; + } + +} + +extension _OffsetExtension on Offset { + + bool isSamePosition(Offset offset) { + return (this - offset).distance < 10; + } + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/_code_field.dart b/packages/re_editor/lib/src/_code_field.dart new file mode 100644 index 0000000..7e7c19a --- /dev/null +++ b/packages/re_editor/lib/src/_code_field.dart @@ -0,0 +1,1991 @@ +part of re_editor; + +class _CodeField extends SingleChildRenderObjectWidget { + + final ViewportOffset verticalViewport; + final ViewportOffset? horizontalViewport; + final double verticalScrollbarWidth; + final double horizontalScrollbarHeight; + final CodeLines codes; + final CodeLineSelection selection; + final List? highlightSelections; + final TextStyle textStyle; + final bool hasFocus; + final _CodeHighlighter highlighter; + final ValueNotifier showCursorNotifier; + final ValueNotifier<_FloatingCursorState> floatingCursorNotifier; + final ValueChanged> onRenderParagraphsChanged; + final Color selectionColor; + final Color highlightColor; + final Color cursorColor; + final Color floatingCursorColor; + final Color? cursorLineColor; + final Color? chunkIndicatorColor; + final double cursorWidth; + final double floatingCursorWidth; + final EdgeInsetsGeometry padding; + final bool readOnly; + final int? maxLengthSingleLineRendering; + final LayerLink startHandleLayerLink; + final LayerLink endHandleLayerLink; + + _CodeField({ + super.key, + required this.verticalViewport, + required this.horizontalViewport, + required this.verticalScrollbarWidth, + required this.horizontalScrollbarHeight, + required this.codes, + required this.selection, + required this.highlightSelections, + required this.textStyle, + required this.hasFocus, + required this.highlighter, + required this.showCursorNotifier, + required this.floatingCursorNotifier, + required this.onRenderParagraphsChanged, + required this.selectionColor, + required this.highlightColor, + required this.cursorColor, + floatingCursorColor, + this.cursorLineColor, + this.chunkIndicatorColor, + required this.cursorWidth, + floatingCursorWidth, + required this.padding, + required this.readOnly, + this.maxLengthSingleLineRendering, + required this.startHandleLayerLink, + required this.endHandleLayerLink, + }): assert(codes.isNotEmpty), + floatingCursorColor = floatingCursorColor ?? cursorColor, + floatingCursorWidth = floatingCursorWidth ?? cursorWidth; + + + @override + RenderObject createRenderObject(BuildContext context) => _CodeFieldRender( + verticalViewport: verticalViewport, + horizontalViewport: horizontalViewport, + verticalScrollbarWidth: verticalScrollbarWidth, + horizontalScrollbarHeight: horizontalScrollbarHeight, + codes: codes, + selection: selection, + highlightSelections: highlightSelections, + textStyle: textStyle, + hasFocus: hasFocus, + highlighter: highlighter, + showCursorNotifier: showCursorNotifier, + floatingCursorNotifier: floatingCursorNotifier, + onRenderParagraphsChanged: onRenderParagraphsChanged, + selectionColor: selectionColor, + highlightColor: highlightColor, + cursorColor: cursorColor, + floatingCursorColor: floatingCursorColor, + cursorLineColor: cursorLineColor, + chunkIndicatorColor: chunkIndicatorColor, + cursorWidth: cursorWidth, + floatingCursorWidth: floatingCursorWidth, + padding: padding, + readOnly: readOnly, + maxLengthSingleLineRendering: maxLengthSingleLineRendering, + startHandleLayerLink: startHandleLayerLink, + endHandleLayerLink: endHandleLayerLink, + ); + + @override + void updateRenderObject(BuildContext context, covariant _CodeFieldRender renderObject) { + renderObject + ..verticalViewport = verticalViewport + ..horizontalViewport = horizontalViewport + ..verticalScrollbarWidth = verticalScrollbarWidth + ..horizontalScrollbarHeight = horizontalScrollbarHeight + ..codes = codes + ..selection = selection + ..highlightSelections = highlightSelections + ..textStyle = textStyle + ..hasFocus = hasFocus + ..highlighter = highlighter + ..showCursorNotifier = showCursorNotifier + ..floatingCursorNotifier = floatingCursorNotifier + ..onRenderParagraphsChanged = onRenderParagraphsChanged + ..selectionColor = selectionColor + ..highlightColor = highlightColor + ..cursorColor = cursorColor + ..floatingCursorColor = floatingCursorColor + ..cursorLineColor = cursorLineColor + ..chunkIndicatorColor = chunkIndicatorColor + ..cursorWidth = cursorWidth + ..floatingCursorWidth = floatingCursorWidth + ..padding = padding + ..readOnly = readOnly + ..maxLengthSingleLineRendering = maxLengthSingleLineRendering + ..startHandleLayerLink = startHandleLayerLink + ..endHandleLayerLink = endHandleLayerLink; + } + +} + +const Duration positionCenteringDuration = Duration(milliseconds: 300); + +class _CodeFieldRender extends RenderBox implements MouseTrackerAnnotation { + + ViewportOffset _verticalViewport; + ViewportOffset? _horizontalViewport; + double _verticalScrollbarWidth; + double _horizontalScrollbarHeight; + CodeLines _codes; + CodeLineSelection _selection; + TextStyle _textStyle; + bool _hasFocus; + _CodeHighlighter _highlighter; + ValueNotifier _showCursorNotifier; + ValueNotifier<_FloatingCursorState> _floatingCursorNotifier; + ValueChanged> _onRenderParagraphsChanged; + EdgeInsetsGeometry _padding; + bool _readOnly; + int? _maxLengthSingleLineRendering; + Color? _chunkIndicatorColor; + + double? _horizontalViewportSize; + double? _verticalViewportSize; + MouseCursor _cursor; + DateTime? _lastAutoScrollTime; + DateTime? _vDwellStartTime; + DateTime? _hDwellStartTime; + + final Paint _paint; + final List _displayParagraphs; + final List<_CodeChunkIndicator> _chunkIndicators; + late final _CodeFieldExtraRender _foregroundRender; + late final _CodeFieldExtraRender _backgroundRender; + late double _preferredLineHeight; + + _CodeFieldRender({ + required ViewportOffset verticalViewport, + required ViewportOffset? horizontalViewport, + required double verticalScrollbarWidth, + required double horizontalScrollbarHeight, + required CodeLines codes, + required CodeLineSelection selection, + required List? highlightSelections, + required TextStyle textStyle, + required bool hasFocus, + required _CodeHighlighter highlighter, + required ValueNotifier showCursorNotifier, + required ValueNotifier<_FloatingCursorState> floatingCursorNotifier, + required ValueChanged> onRenderParagraphsChanged, + required Color selectionColor, + required Color highlightColor, + required Color cursorColor, + required Color floatingCursorColor, + Color? cursorLineColor, + Color? chunkIndicatorColor, + required double cursorWidth, + required double floatingCursorWidth, + required EdgeInsetsGeometry padding, + required bool readOnly, + int? maxLengthSingleLineRendering, + required LayerLink startHandleLayerLink, + required LayerLink endHandleLayerLink, + }) : _verticalViewport = verticalViewport, + _horizontalViewport = horizontalViewport, + _verticalScrollbarWidth = verticalScrollbarWidth, + _horizontalScrollbarHeight = horizontalScrollbarHeight, + _codes = codes, + _selection = selection, + _textStyle = textStyle, + _hasFocus = hasFocus, + _highlighter = highlighter, + _showCursorNotifier = showCursorNotifier, + _floatingCursorNotifier = floatingCursorNotifier, + _onRenderParagraphsChanged = onRenderParagraphsChanged, + _padding = padding, + _readOnly = readOnly, + _maxLengthSingleLineRendering = maxLengthSingleLineRendering, + _chunkIndicatorColor = chunkIndicatorColor, + _paint = Paint(), + _displayParagraphs = [], + _chunkIndicators = [], + _cursor = SystemMouseCursors.text, + _startHandleLayerLink = startHandleLayerLink, + _endHandleLayerLink = endHandleLayerLink { + _backgroundRender = _CodeFieldExtraRender( + painters: [ + _CodeCursorLinePainter(cursorLineColor, _selection), + _CodeFieldSelectionPainter(selectionColor, _selection), + _CodeFieldHighlightPainter(highlightColor, highlightSelections ?? const []) + ] + ); + adoptChild(_backgroundRender); + _foregroundRender = _CodeFieldExtraRender( + painters: [ + _CodeFieldCursorPainter( + position: _selection.extent, + color: cursorColor, + width: cursorWidth, + height: 0.0, + visible: _showCursorNotifier.value + ), + _CodeFieldFloatingCursorPainter( + position: _floatingCursorNotifier.value, + color: floatingCursorColor, + width: floatingCursorWidth, + height: 0.0, + ) + ] + ); + adoptChild(_foregroundRender); + _calculatePreferredLineHeight(); + } + + set verticalViewport(ViewportOffset value) { + if (_verticalViewport == value) { + return; + } + if (attached) { + _verticalViewport.removeListener(markNeedsLayout); + } + _verticalViewport = value; + if (attached) { + markNeedsLayout(); + _verticalViewport.addListener(markNeedsLayout); + } + } + + set horizontalViewport(ViewportOffset? value) { + if (_horizontalViewport == value) { + return; + } + if (attached) { + _horizontalViewport?.removeListener(markNeedsLayout); + } + _horizontalViewport = value; + if (attached) { + markNeedsLayout(); + _horizontalViewport?.addListener(markNeedsLayout); + } + } + + set verticalScrollbarWidth(double value) { + if (_verticalScrollbarWidth == value) { + return; + } + _verticalScrollbarWidth = value; + markNeedsLayout(); + } + + set horizontalScrollbarHeight(double value) { + if (_horizontalScrollbarHeight == value) { + return; + } + _horizontalScrollbarHeight = value; + markNeedsLayout(); + } + + set codes(CodeLines value) { + if (_codes.equals(value)) { + return; + } + _codes = value; + markNeedsLayout(); + } + + set selection(CodeLineSelection value) { + if (_selection == value) { + return; + } + _selection = value; + _backgroundRender.find<_CodeCursorLinePainter>().selection = value; + _backgroundRender.find<_CodeFieldSelectionPainter>().selection = value; + _foregroundRender.find<_CodeFieldCursorPainter>().position = value.extent; + if (kIsAndroid || kIsIOS) { + _foregroundRender.find<_CodeFieldCursorPainter>().willDraw = _selection.isCollapsed; + } + markNeedsLayout(); + } + + set highlightSelections(List? value) { + _backgroundRender.find<_CodeFieldHighlightPainter>().selections = value ?? const []; + } + + set textStyle(TextStyle value) { + if (_textStyle == value) { + return; + } + final RenderComparison comparison = _textStyle.compareTo(value); + _textStyle = value; + if (comparison.index >= RenderComparison.layout.index) { + _calculatePreferredLineHeight(); + markNeedsLayout(); + } else { + markNeedsPaint(); + } + } + + TextStyle get textStyle => _textStyle; + + bool get hasFocus => _hasFocus; + + set hasFocus(bool value) { + if (_hasFocus == value) { + return; + } + _hasFocus = value; + markNeedsPaint(); + } + + set highlighter(_CodeHighlighter value) { + if (_highlighter == value) { + return; + } + if (attached) { + _highlighter.removeListener(markNeedsLayout); + } + _highlighter = value; + if (attached) { + markNeedsLayout(); + _highlighter.addListener(markNeedsLayout); + } + } + + set showCursorNotifier(ValueNotifier value) { + if (_showCursorNotifier == value) { + return; + } + if (attached) { + _showCursorNotifier.removeListener(_onCursorVisibleChanged); + } + _showCursorNotifier = value; + if (attached) { + _onCursorVisibleChanged(); + _showCursorNotifier.addListener(_onCursorVisibleChanged); + } + } + + set floatingCursorNotifier(ValueNotifier<_FloatingCursorState> value) { + if (_floatingCursorNotifier == value) { + return; + } + if (attached) { + _floatingCursorNotifier.removeListener(_onFloatingCursorChanged); + } + _floatingCursorNotifier = value; + if (attached) { + _onFloatingCursorChanged(); + _floatingCursorNotifier.addListener(_onFloatingCursorChanged); + } + } + + set onRenderParagraphsChanged(ValueChanged> value) { + if (_onRenderParagraphsChanged == value) { + return; + } + _onRenderParagraphsChanged = value; + } + + set selectionColor(Color value) { + _backgroundRender.find<_CodeFieldSelectionPainter>().color = value; + } + + set highlightColor(Color value) { + _backgroundRender.find<_CodeFieldHighlightPainter>().color = value; + } + + set cursorColor(Color value) { + _foregroundRender.find<_CodeFieldCursorPainter>().color = value; + } + + set floatingCursorColor(Color value) { + _foregroundRender.find<_CodeFieldFloatingCursorPainter>().color = value; + } + + set cursorLineColor(Color? value) { + _backgroundRender.find<_CodeCursorLinePainter>().color = value; + } + + set chunkIndicatorColor(Color? value) { + if (_chunkIndicatorColor == value) { + return; + } + _chunkIndicatorColor = value; + markNeedsPaint(); + } + + set cursorWidth(double value) { + _foregroundRender.find<_CodeFieldCursorPainter>().width = value; + } + + set floatingCursorWidth(double value) { + _foregroundRender.find<_CodeFieldFloatingCursorPainter>().width = value; + } + + double get cursorWidth { + return _foregroundRender.find<_CodeFieldCursorPainter>().width; + } + + double get floatingCursorWidth { + return _foregroundRender.find<_CodeFieldFloatingCursorPainter>().width; + } + + double get floatingCursorHeight { + return _foregroundRender.find<_CodeFieldFloatingCursorPainter>().height; + } + + ValueNotifier get showCursorNotifier => _showCursorNotifier; + + /// The [LayerLink] of start selection handle. + /// + /// [RenderEditable] is responsible for calculating the [Offset] of this + /// [LayerLink], which will be used as [CompositedTransformTarget] of start handle. + LayerLink get startHandleLayerLink => _startHandleLayerLink; + LayerLink _startHandleLayerLink; + set startHandleLayerLink(LayerLink value) { + if (_startHandleLayerLink == value) { + return; + } + _startHandleLayerLink = value; + markNeedsPaint(); + } + + /// The [LayerLink] of end selection handle. + /// + /// [RenderEditable] is responsible for calculating the [Offset] of this + /// [LayerLink], which will be used as [CompositedTransformTarget] of end handle. + LayerLink get endHandleLayerLink => _endHandleLayerLink; + LayerLink _endHandleLayerLink; + set endHandleLayerLink(LayerLink value) { + if (_endHandleLayerLink == value) { + return; + } + _endHandleLayerLink = value; + markNeedsPaint(); + } + + /// Track whether position of the start of the selected text is within the viewport. + /// + /// For example, if the text contains "Hello World", and the user selects + /// "Hello", then scrolls so only "World" is visible, this will become false. + /// If the user scrolls back so that the "H" is visible again, this will + /// become true. + /// + /// This bool indicates whether the text is scrolled so that the handle is + /// inside the text field viewport, as opposed to whether it is actually + /// visible on the screen. + ValueListenable get selectionStartInViewport => _selectionStartInViewport; + final ValueNotifier _selectionStartInViewport = ValueNotifier(true); + + /// Track whether position of the end of the selected text is within the viewport. + /// + /// For example, if the text contains "Hello World", and the user selects + /// "World", then scrolls so only "Hello" is visible, this will become + /// 'false'. If the user scrolls back so that the "d" is visible again, this + /// will become 'true'. + /// + /// This bool indicates whether the text is scrolled so that the handle is + /// inside the text field viewport, as opposed to whether it is actually + /// visible on the screen. + ValueListenable get selectionEndInViewport => _selectionEndInViewport; + final ValueNotifier _selectionEndInViewport = ValueNotifier(true); + + double get lineHeight => _preferredLineHeight; + + EdgeInsetsGeometry get padding => _padding; + + double get paddingLeft => _padding.resolve(TextDirection.ltr).left; + + double get paddingTop => _padding.resolve(TextDirection.ltr).top; + + double get paddingRight => _padding.resolve(TextDirection.ltr).right; + + double get paddingBottom => _padding.resolve(TextDirection.ltr).bottom; + + set padding(EdgeInsetsGeometry value) { + if (_padding == value) { + return; + } + double offset = value.resolve(TextDirection.ltr).top - _padding.resolve(TextDirection.ltr).top; + if (_verticalViewport.pixels > 0) { + if (_verticalViewport.pixels + offset < 0) { + _verticalViewport.correctBy(0); + } else { + _verticalViewport.correctBy(offset); + } + } + _padding = value; + markNeedsLayout(); + } + + set readOnly(bool value) { + if (_readOnly == value) { + return; + } + _readOnly = value; + markNeedsPaint(); + } + + set maxLengthSingleLineRendering(int? value) { + if (_maxLengthSingleLineRendering == value) { + return; + } + _maxLengthSingleLineRendering = value; + markNeedsLayout(); + } + + List get displayParagraphs => _displayParagraphs; + + Offset get paintOffset => Offset(_horizontalViewport?.pixels ?? 0, _verticalViewport.pixels); + + CodeLineRenderParagraph? findDisplayParagraphByLineIndex(int index) { + for (final CodeLineRenderParagraph paragraph in _displayParagraphs) { + if (paragraph.index == index) { + return paragraph; + } + } + return null; + } + + CodeLineSelection? setPositionAt({ + required Offset position, + }) { + final Offset localPosition = globalToLocal(position); + if (!isValidPointer(localPosition)) { + return null; + } + final CodeLinePosition? result = calculateTextPosition(localPosition); + if (result == null) { + return null; + } + return CodeLineSelection.fromPosition( + position: result, + ); + } + + CodeLineSelection? extendPositionTo({ + required CodeLineSelection oldSelection, + required Offset position, + CodeLineSelection? anchor, + bool allowOverflow = false, + }) { + final Offset localPosition = globalToLocal(position); + if (!allowOverflow && !isValidPointer(localPosition)) { + return null; + } + final CodeLinePosition? result = calculateTextPosition( + Offset( + min(size.width, max(0, localPosition.dx)), + min(size.height - _preferredLineHeight / 2, max(_preferredLineHeight / 2, localPosition.dy)) + ) + ); + if (result == null) { + return null; + } + if (anchor != null) { + if (result.isBefore(anchor.start)) { + return CodeLineSelection.fromPosition( + position: result + ).copyWith( + baseIndex: anchor.end.index, + baseOffset: anchor.end.offset, + baseAffinity: anchor.end.affinity, + ); + } + if (result.isAfter(anchor.end)) { + return CodeLineSelection.fromPosition( + position: result + ).copyWith( + baseIndex: anchor.start.index, + baseOffset: anchor.start.offset, + baseAffinity: anchor.start.affinity, + ); + } + return anchor; + } + return oldSelection.copyWith( + extentIndex: result.index, + extentOffset: result.offset, + extentAffinity: result.affinity + ); + } + + CodeLineRange? selectWord({ + required Offset position, + }) { + final Offset localPosition = globalToLocal(position); + if (!isValidPointer(localPosition)) { + return null; + } + return _selectWord(localPosition); + } + + void makePositionVisible(CodeLinePosition position, [int tryCount = 0]) { + final Offset? offset = calculateTextPositionViewportOffset(position); + if (offset == null) { + if (_displayParagraphs.isNotEmpty) { + final CodeLineRenderParagraph first = _displayParagraphs.first; + if (position.index < first.index) { + _verticalViewport.jumpTo(first.top + _preferredLineHeight * (position.index - first.index)); + } + final CodeLineRenderParagraph last = _displayParagraphs.last; + if (position.index > last.index) { + _verticalViewport.jumpTo(max(0, last.bottom - size.height + _preferredLineHeight * (position.index - first.index))); + } + } + if (tryCount < 10) { + SchedulerBinding.instance.addPostFrameCallback((timeStamp) { + // Check whether the viewport is still valid. + final ViewportOffset viewport = _verticalViewport; + if (viewport is ScrollPosition && viewport.context.notificationContext == null) { + return; + } + makePositionVisible(position, tryCount + 1); + }); + } + return; + } + if (offset.dy < 0) { + _verticalViewport.jumpTo(_verticalViewport.pixels + offset.dy); + } else if (offset.dy > size.height - _preferredLineHeight) { + _verticalViewport.jumpTo(_verticalViewport.pixels + offset.dy - (size.height - _preferredLineHeight)); + } + if (_horizontalViewport != null) { + if (offset.dx < 0) { + _horizontalViewport!.jumpTo(_horizontalViewport!.pixels + offset.dx); + } else if (offset.dx > size.width - _preferredLineHeight) { + _horizontalViewport!.jumpTo(_horizontalViewport!.pixels + offset.dx - (size.width - _preferredLineHeight)); + } + } + } + + void makePositionCenterIfInvisible(CodeLinePosition position, {int tryCount = 0, bool animated = false}) { + void scrollViewport(ViewportOffset viewport, num target) { + if (animated) { + viewport.animateTo(target.toDouble(), duration: positionCenteringDuration, curve: Curves.decelerate); + } else { + viewport.jumpTo(target.toDouble()); + } + } + + final Offset? offset = calculateTextPositionViewportOffset(position); + if (offset == null) { + if (_displayParagraphs.isNotEmpty) { + final CodeLineRenderParagraph first = _displayParagraphs.first; + if (position.index < first.index) { + final double target = max(0, first.top - _preferredLineHeight * (first.index - position.index) - size.height / 2); + scrollViewport(_verticalViewport, target); + } + final CodeLineRenderParagraph last = _displayParagraphs.last; + if (position.index > last.index) { + final double target = min( + _verticalViewportSize!, + last.bottom + size.height / 2 + _preferredLineHeight * (position.index - first.index), + ); + scrollViewport(_verticalViewport, target); + } + } + if (tryCount < 10) { + SchedulerBinding.instance.addPostFrameCallback((timeStamp) { + // Check whether the viewport is still valid. + final ViewportOffset viewport = _verticalViewport; + if (viewport is ScrollPosition && viewport.context.notificationContext == null) { + return; + } + makePositionCenterIfInvisible(position, tryCount: tryCount + 1); + }); + } + return; + } + if (offset.dy < paddingTop) { + final double target = max(0, _verticalViewport.pixels + offset.dy - size.height / 2); + scrollViewport(_verticalViewport, target); + } else if (offset.dy > size.height - _preferredLineHeight - paddingBottom) { + final double target = min( + _verticalViewportSize!, + _verticalViewport.pixels + offset.dy + _preferredLineHeight - size.height / 2, + ); + scrollViewport(_verticalViewport, target); + } + + if (_horizontalViewport != null) { + if (offset.dx < 0) { + final target = max(0, _horizontalViewport!.pixels + offset.dx - size.width / 2); + scrollViewport(_horizontalViewport!, target); + } else if (offset.dx > size.width - _preferredLineHeight) { + final target = min( + _horizontalViewportSize!, + _horizontalViewport!.pixels + offset.dx + _preferredLineHeight - size.width / 2, + ); + scrollViewport(_horizontalViewport!, target); + } + } + } + + void forceRepaint() { + _highlighter.clearCache(); + _displayParagraphs.clear(); + _updateDisplayRenderParagraphs(); + markNeedsPaint(); + } + + /// Calculates auto-scroll velocity (pixels/sec) using a high-acceleration dual-zone model: + /// - Inner buffer zone (0 to edgeThreshold from edge): linear crawl from [minVelocity] to [edgeVelocity]. + /// - Outer pull zone (beyond edge into overscroll): rapid acceleration over a compact distance ([maxPullDistance]). + double _calculateAutoScrollVelocity({ + required double pointerPosition, + required double viewportDimension, + required double edgeThreshold, + required bool isStartEdge, + required double minVelocity, + required double edgeVelocity, + required double maxVelocity, + required double maxPullDistance, + }) { + if (isStartEdge) { + if (pointerPosition >= edgeThreshold) { + return 0.0; + } + if (pointerPosition >= 0.0) { + final double ratio = (edgeThreshold - pointerPosition) / edgeThreshold; + return minVelocity + (edgeVelocity - minVelocity) * ratio; + } else { + final double pullDistance = -pointerPosition; + final double ratio = (pullDistance / maxPullDistance).clamp(0.0, 1.0); + final double factor = ratio * sqrt(ratio); + return edgeVelocity + (maxVelocity - edgeVelocity) * factor; + } + } else { + final double triggerPos = viewportDimension - edgeThreshold; + if (pointerPosition <= triggerPos) { + return 0.0; + } + if (pointerPosition <= viewportDimension) { + final double ratio = (pointerPosition - triggerPos) / edgeThreshold; + return minVelocity + (edgeVelocity - minVelocity) * ratio; + } else { + final double pullDistance = pointerPosition - viewportDimension; + final double ratio = (pullDistance / maxPullDistance).clamp(0.0, 1.0); + final double factor = ratio * sqrt(ratio); + return edgeVelocity + (maxVelocity - edgeVelocity) * factor; + } + } + } + + void autoScrollWhenDragging(Offset dragPosition) { + final Offset offset = globalToLocal(dragPosition); + final double lineHeight = _preferredLineHeight; + final double vEdgeThreshold = max(32.0, lineHeight * 1.5); + const double vMaxPullDistance = 45.0; + + // 水平方向针对移动端狭窄屏幕优化: + // 1. 更宽的内侧触控带 (40px),无需紧贴屏幕物理边缘 + // 2. 超紧凑外拉加速距离 (15px),碰到边距或边框即可快速起速 + // 3. 驻留自适应加速 (Dwell Acceleration),按住边缘原地不动即可持续加速 + final double hEdgeThreshold = max(40.0, lineHeight * 1.8); + const double hMaxPullDistance = 15.0; + + final DateTime now = DateTime.now(); + final double dt; + if (_lastAutoScrollTime == null) { + dt = 0.016; + } else { + final double elapsed = now.difference(_lastAutoScrollTime!).inMicroseconds / 1000000.0; + dt = elapsed.clamp(0.005, 0.05); + } + + bool scrolled = false; + + // Vertical auto-scroll + bool vActive = false; + if (_verticalViewportSize != null && _verticalViewportSize! > 0) { + if (offset.dy < vEdgeThreshold && _verticalViewport.pixels > 0) { + vActive = true; + _vDwellStartTime ??= now; + final double dwellSeconds = now.difference(_vDwellStartTime!).inMicroseconds / 1000000.0; + final double dwellMultiplier = dwellSeconds > 0.25 + ? 1.0 + ((dwellSeconds - 0.25) / 0.75).clamp(0.0, 1.0) * 2.5 + : 1.0; + final double baseV = _calculateAutoScrollVelocity( + pointerPosition: offset.dy, + viewportDimension: size.height, + edgeThreshold: vEdgeThreshold, + isStartEdge: true, + minVelocity: 70.0, + edgeVelocity: 180.0, + maxVelocity: 1500.0, + maxPullDistance: vMaxPullDistance, + ); + final double v = min(1600.0, baseV * dwellMultiplier); + if (v > 0) { + final double delta = v * dt; + final double target = max(0.0, _verticalViewport.pixels - delta); + if (target != _verticalViewport.pixels) { + _verticalViewport.jumpTo(target); + scrolled = true; + } + } + } else if (offset.dy > size.height - vEdgeThreshold && _verticalViewport.pixels < _verticalViewportSize!) { + vActive = true; + _vDwellStartTime ??= now; + final double dwellSeconds = now.difference(_vDwellStartTime!).inMicroseconds / 1000000.0; + final double dwellMultiplier = dwellSeconds > 0.25 + ? 1.0 + ((dwellSeconds - 0.25) / 0.75).clamp(0.0, 1.0) * 2.5 + : 1.0; + final double baseV = _calculateAutoScrollVelocity( + pointerPosition: offset.dy, + viewportDimension: size.height, + edgeThreshold: vEdgeThreshold, + isStartEdge: false, + minVelocity: 70.0, + edgeVelocity: 180.0, + maxVelocity: 1500.0, + maxPullDistance: vMaxPullDistance, + ); + final double v = min(1600.0, baseV * dwellMultiplier); + if (v > 0) { + final double delta = v * dt; + final double target = min(_verticalViewportSize!, _verticalViewport.pixels + delta); + if (target != _verticalViewport.pixels) { + _verticalViewport.jumpTo(target); + scrolled = true; + } + } + } + } + if (!vActive) { + _vDwellStartTime = null; + } + + // Horizontal auto-scroll + bool hActive = false; + if (_horizontalViewport != null && _horizontalViewportSize != null && _horizontalViewportSize! > 0) { + if (offset.dx < hEdgeThreshold && _horizontalViewport!.pixels > 0) { + hActive = true; + _hDwellStartTime ??= now; + final double dwellSeconds = now.difference(_hDwellStartTime!).inMicroseconds / 1000000.0; + final double dwellMultiplier = dwellSeconds > 0.2 + ? 1.0 + ((dwellSeconds - 0.2) / 0.7).clamp(0.0, 1.0) * 3.5 + : 1.0; + final double baseV = _calculateAutoScrollVelocity( + pointerPosition: offset.dx, + viewportDimension: size.width, + edgeThreshold: hEdgeThreshold, + isStartEdge: true, + minVelocity: 70.0, + edgeVelocity: 200.0, + maxVelocity: 1300.0, + maxPullDistance: hMaxPullDistance, + ); + final double v = min(1400.0, baseV * dwellMultiplier); + if (v > 0) { + final double delta = v * dt; + final double target = max(0.0, _horizontalViewport!.pixels - delta); + if (target != _horizontalViewport!.pixels) { + _horizontalViewport!.jumpTo(target); + scrolled = true; + } + } + } else if (offset.dx > size.width - hEdgeThreshold && _horizontalViewport!.pixels < _horizontalViewportSize!) { + hActive = true; + _hDwellStartTime ??= now; + final double dwellSeconds = now.difference(_hDwellStartTime!).inMicroseconds / 1000000.0; + final double dwellMultiplier = dwellSeconds > 0.2 + ? 1.0 + ((dwellSeconds - 0.2) / 0.7).clamp(0.0, 1.0) * 3.5 + : 1.0; + final double baseV = _calculateAutoScrollVelocity( + pointerPosition: offset.dx, + viewportDimension: size.width, + edgeThreshold: hEdgeThreshold, + isStartEdge: false, + minVelocity: 70.0, + edgeVelocity: 200.0, + maxVelocity: 1300.0, + maxPullDistance: hMaxPullDistance, + ); + final double v = min(1400.0, baseV * dwellMultiplier); + if (v > 0) { + final double delta = v * dt; + final double target = min(_horizontalViewportSize!, _horizontalViewport!.pixels + delta); + if (target != _horizontalViewport!.pixels) { + _horizontalViewport!.jumpTo(target); + scrolled = true; + } + } + } + } + if (!hActive) { + _hDwellStartTime = null; + } + + if (scrolled) { + _lastAutoScrollTime = now; + } else { + _lastAutoScrollTime = null; + } + } + + void stopAutoScroll() { + _lastAutoScrollTime = null; + _vDwellStartTime = null; + _hDwellStartTime = null; + } + + void autoScrollWhenDraggingFloatingCursor(Offset offset) { + final double unit = _preferredLineHeight; + if (_verticalViewportSize != null) { + if (offset.dy == paintBounds.top + paddingTop) { + _alignTopEdge( + offset: _verticalViewport.pixels - unit + ); + } else if (offset.dy == paintBounds.bottom - paddingBottom - floatingCursorHeight) { + _alignBottomEdge( + offset: _verticalViewport.pixels + unit + ); + } + } + if (_horizontalViewport != null && _horizontalViewportSize != null) { + if (offset.dx < unit) { + _horizontalViewport!.jumpTo(max(0, _horizontalViewport!.pixels - unit)); + } else if (offset.dx > size.width - unit) { + _horizontalViewport!.jumpTo(min(_horizontalViewport!.pixels + unit, _horizontalViewportSize!)); + } + } + } + + int chunkIndicatorHitIndex(Offset position) { + final Offset localPosition = globalToLocal(position); + if (!isValidPointer(localPosition)) { + return -1; + } + final int index = _chunkIndicators.indexWhere((chunk) => chunk.canExpand && chunk.region.contains(localPosition)); + if (index < 0) { + return -1; + } + return _chunkIndicators[index].index; + } + + CodeLinePosition? getUpPosition(CodeLinePosition position) { + final CodeLineRenderParagraph? paragraph = findDisplayParagraphByLineIndex(position.index); + if (paragraph == null) { + return null; + } + final Offset? offset = paragraph.getOffset(position.textPosition); + if (offset == null) { + return null; + } + if (offset.dy > 0) { + return paragraph.getPosition(offset - Offset(0, paragraph.preferredLineHeight)); + } + // The up position is not in this code line + IParagraph? upParagraph = findDisplayParagraphByLineIndex(position.index - 1)?.paragraph; + if (upParagraph == null) { + if (position.index > 0) { + upParagraph = _buildParagraph(position.index - 1); + } else { + return null; + } + } + return CodeLinePosition.from( + index: position.index - 1, + position: upParagraph.getPosition(Offset(offset.dx, upParagraph.height - upParagraph.preferredLineHeight)) + ); + } + + CodeLinePosition? getDownPosition(CodeLinePosition position) { + final CodeLineRenderParagraph? paragraph = findDisplayParagraphByLineIndex(position.index); + if (paragraph == null) { + return null; + } + final Offset? offset = paragraph.getOffset(position.textPosition); + if (offset == null) { + return null; + } + if (offset.dy < paragraph.height - paragraph.preferredLineHeight) { + return paragraph.getPosition(offset + Offset(0, paragraph.preferredLineHeight)); + } + // The up position is not in this code line + IParagraph? downParagraph = findDisplayParagraphByLineIndex(position.index + 1)?.paragraph; + if (downParagraph == null) { + if (position.index < _codes.length - 1) { + downParagraph = _buildParagraph(position.index + 1); + } else { + return null; + } + } + return CodeLinePosition.from( + index: position.index + 1, + position: downParagraph.getPosition(Offset(offset.dx, 0)) + ); + } + + @override + MouseCursor get cursor => _cursor; + + @override + PointerEnterEventListener? get onEnter => null; + + @override + PointerExitEventListener? get onExit => null; + + @override + bool get validForMouseTracker => true; + + @override + bool hitTest(BoxHitTestResult result, { required Offset position }) { + bool hitTarget = false; + if (size.contains(position)) { + result.add(BoxHitTestEntry(this, position)); + final CodeLineRenderParagraph? paragraph = _findDisplayRenderParagraph(position + paintOffset); + final InlineSpan? span = paragraph?.getSpanForPosition(position - paragraph.offset + paintOffset); + if (span is MouseTrackerAnnotationTextSpan) { + result.add(HitTestEntry(_MouseTrackerAnnotationTextSpan( + id: paragraph!.index, + rects: paragraph.getRangeRects(paragraph.getRangeForSpan(span)).map((rect) { + return Rect.fromPoints(localToGlobal(rect.topLeft + paragraph.offset - paintOffset), localToGlobal(rect.bottomRight + paragraph.offset - paintOffset)); + }).toList(), + span: span, + ))); + } else if (span is HitTestTarget) { + result.add(HitTestEntry(span as HitTestTarget)); + } + if (_chunkIndicators.where((chunk) => chunk.canExpand && chunk.region.contains(position)).isNotEmpty) { + _cursor = SystemMouseCursors.click; + } else if (span is TextSpan && span.mouseCursor != MouseCursor.defer) { + _cursor = span.mouseCursor; + } else { + _cursor = SystemMouseCursors.text; + } + hitTarget = true; + } + return hitTarget; + } + + @override + bool hitTestSelf(Offset position) => true; + + @override + void attach(covariant PipelineOwner owner) { + super.attach(owner); + _foregroundRender.attach(owner); + _backgroundRender.attach(owner); + _verticalViewport.addListener(markNeedsLayout); + _horizontalViewport?.addListener(markNeedsPaint); + _highlighter.addListener(markNeedsLayout); + _showCursorNotifier.addListener(_onCursorVisibleChanged); + _floatingCursorNotifier.addListener(_onFloatingCursorChanged); + } + + @override + void detach() { + _verticalViewport.removeListener(markNeedsLayout); + _horizontalViewport?.removeListener(markNeedsPaint); + _highlighter.removeListener(markNeedsLayout); + _showCursorNotifier.removeListener(_onCursorVisibleChanged); + _floatingCursorNotifier.removeListener(_onFloatingCursorChanged); + super.detach(); + _foregroundRender.detach(); + _backgroundRender.detach(); + } + + @override + void redepthChildren() { + redepthChild(_foregroundRender); + redepthChild(_backgroundRender); + super.redepthChildren(); + } + + @override + void visitChildren(RenderObjectVisitor visitor) { + visitor(_foregroundRender); + visitor(_backgroundRender); + super.visitChildren(visitor); + } + + @override + void markNeedsPaint() { + super.markNeedsPaint(); + _chunkIndicators.clear(); + _backgroundRender.markNeedsPaint(); + _foregroundRender.markNeedsPaint(); + } + + @override + void performLayout() { + // _Trace.begin('CodeField performLayout'); + assert(constraints.maxWidth > 0 && constraints.maxWidth != double.infinity, + '_CodeField should have an explicit width.'); + assert(constraints.maxHeight > 0 && constraints.maxHeight != double.infinity, + '_CodeField should have an explicit height.'); + size = Size(constraints.maxWidth, constraints.maxHeight); + _foregroundRender.layout(constraints); + _backgroundRender.layout(constraints); + if (_horizontalViewport != null) { + _horizontalViewport!.applyViewportDimension(size.width); + } + _verticalViewport.applyViewportDimension(size.height); + _updateDisplayRenderParagraphs(); + // _Trace.end('CodeField performLayout'); + } + + @override + void paint(PaintingContext context, Offset offset) { + // _Trace.begin('CodeField paint'); + context.paintChild(_backgroundRender, offset); + + final Canvas canvas = context.canvas; + canvas.save(); + canvas.clipRect(Rect.fromLTWH(offset.dx, offset.dy, size.width, size.height)); + _drawText(canvas, offset); + canvas.restore(); + + _updateSelectionExtentsVisibility(offset); + + context.paintChild(_foregroundRender, offset); + + final Offset? startHandlePosition = calculateTextPositionViewportOffset(_selection.start); + if (startHandlePosition != null) { + _drawHandleLayer(context, _startHandleLayerLink, startHandlePosition, offset + Offset(0, _preferredLineHeight)); + } + final Offset? endHandlePosition = calculateTextPositionViewportOffset(_selection.end); + if (endHandlePosition != null) { + _drawHandleLayer(context, _endHandleLayerLink, endHandlePosition, offset + Offset(0, _preferredLineHeight)); + } + // _Trace.end('CodeField paint'); + } + + @override + void dispose() { + _foregroundRender.dispose(); + _backgroundRender.dispose(); + super.dispose(); + } + + CodeLinePosition? calculateTextPosition(Offset localPosition) { + final Offset offset = localPosition + paintOffset; + final CodeLineRenderParagraph? target = _findDisplayRenderParagraph(offset, true); + if (target == null) { + return null; + } + return target.getPosition(offset - target.offset); + } + + Offset? calculateTextPositionViewportOffset(CodeLinePosition position) { + final CodeLineRenderParagraph? paragraph = findDisplayParagraphByLineIndex(position.index); + if (paragraph == null) { + return null; + } + final Offset? offset = paragraph.getOffset(position); + if (offset == null) { + return null; + } + return offset + paragraph.offset - paintOffset; + } + + Offset? calculateTextPositionScreenOffset(CodeLinePosition position, bool rightBottom) { + final Offset? offset = calculateTextPositionViewportOffset(position); + if (offset != null) { + return localToGlobal(rightBottom ? offset + Offset(0, _preferredLineHeight) : offset); + } + return null; + } + + /// Calculates the bounding rectangle (in global screen coordinates) of the given selection. + Rect? calculateSelectionBoundingRect(CodeLineSelection selection) { + if (selection.isCollapsed) { + final Offset? offset = calculateTextPositionScreenOffset(selection.start, false); + if (offset == null) return null; + return Rect.fromLTWH(offset.dx, offset.dy, 0, _preferredLineHeight); + } + final List paragraphs = _displayParagraphs; + if (paragraphs.isEmpty) return null; + + double minX = double.infinity; + double minY = double.infinity; + double maxX = -double.infinity; + double maxY = -double.infinity; + bool foundAny = false; + + final CodeLinePosition start = selection.start; + final CodeLinePosition end = selection.end; + + for (final CodeLineRenderParagraph paragraph in paragraphs) { + if (paragraph.index < start.index || paragraph.index > end.index) { + continue; + } + final int startIndex = (paragraph.index == start.index) ? start.offset : 0; + final int endIndex = (paragraph.index == end.index) ? end.offset : paragraph.length; + + final List rects; + if (startIndex == endIndex) { + final Offset? offset = paragraph.getOffset(TextPosition(offset: startIndex)); + if (offset != null) { + rects = [Rect.fromLTWH(offset.dx, offset.dy, 0, paragraph.preferredLineHeight)]; + } else { + rects = const []; + } + } else { + rects = paragraph.getRangeRects(TextRange(start: startIndex, end: endIndex)); + } + + final Offset paragraphGlobalOffset = localToGlobal(paragraph.offset - paintOffset); + for (final Rect r in rects) { + final Rect globalR = r.shift(paragraphGlobalOffset); + if (globalR.left < minX) minX = globalR.left; + if (globalR.top < minY) minY = globalR.top; + if (globalR.right > maxX) maxX = globalR.right; + if (globalR.bottom > maxY) maxY = globalR.bottom; + foundAny = true; + } + } + + if (!foundAny) return null; + return Rect.fromLTRB(minX, minY, maxX, maxY); + } + + void _updateDisplayRenderParagraphs() { + final double effectiveWidth; + if (_horizontalViewport == null) { + effectiveWidth = constraints.maxWidth - _padding.horizontal; + } else { + effectiveWidth = double.infinity; + } + final double target = _verticalViewport.pixels; + if (_displayParagraphs.isEmpty) { + // Move the scroll offset to zero + final int startIndex; + if (target <= paddingTop) { + startIndex = 0; + } else { + startIndex = min(((target - paddingTop) / _preferredLineHeight).ceil(), _codes.length - 1); + } + _displayParagraphs.addAll(_buildDisplayRenderParagraphs(startIndex, effectiveWidth)); + } else { + if (_codes.length <= _displayParagraphs.first.index) { + _displayParagraphs.clear(); + _updateDisplayRenderParagraphs(); + return; + } + if (target < _displayParagraphs.first.top) { + int startIndex = 0; + double delta = 0; + double offset = _displayParagraphs.first.top; + for (int i = _displayParagraphs.first.index - 1; i >= 0; i--) { + final IParagraph paragraph = _buildParagraph(i, effectiveWidth); + delta += paragraph.height - _preferredLineHeight; + offset -= paragraph.height; + if (target >= offset) { + startIndex = i; + break; + } + } + _verticalViewport.correctBy(delta); + _displayParagraphs.clear(); + _displayParagraphs.addAll(_buildDisplayRenderParagraphs(startIndex, effectiveWidth)); + } else if (target > _displayParagraphs.last.bottom) { + final int startIndex; + if (target <= paddingTop) { + startIndex = 0; + } else { + startIndex = (target / _preferredLineHeight).floor(); + } + _displayParagraphs.clear(); + _displayParagraphs.addAll(_buildDisplayRenderParagraphs(startIndex, effectiveWidth)); + } else { + int startIndex = -1; + double delta = 0; + for (final CodeLineRenderParagraph paragraph in _displayParagraphs) { + if (target <= paragraph.bottom) { + startIndex = paragraph.index; + break; + } + delta += paragraph.paragraph.height - _preferredLineHeight; + } + assert(startIndex >= 0); + _verticalViewport.correctBy(-delta); + _displayParagraphs.clear(); + _displayParagraphs.addAll(_buildDisplayRenderParagraphs(startIndex, effectiveWidth)); + } + } + // The codes length maybe changed, this will make the displayParagraphs empty. + if (_displayParagraphs.isEmpty) { + _updateDisplayRenderParagraphs(); + return; + } + final double totalHeight = _displayParagraphs.last.bottom + (_codes.length - (_displayParagraphs.last.index + 1)) * _preferredLineHeight + paddingBottom; + _verticalViewportSize = max(0, totalHeight - size.height); + if (_verticalViewport.pixels > _verticalViewportSize!) { + _verticalViewport.correctBy(_verticalViewportSize! - _verticalViewport.pixels); + } + _verticalViewport.applyContentDimensions(0, _verticalViewportSize!); + if (_horizontalViewport != null) { + final double maxWidth = _displayParagraphs.map((e) => e.width).reduce(max); + _horizontalViewportSize = max(0, maxWidth + _padding.horizontal - size.width); + _horizontalViewport!.applyContentDimensions(0, _horizontalViewportSize!); + } + // applyContentDimensions will change the _verticalViewport.pixels, we should rebuild. + if (_displayParagraphs.first.offset.dy > _verticalViewport.pixels + paddingTop) { + _updateDisplayRenderParagraphs(); + return; + } + + _onRenderParagraphsChanged(_displayParagraphs.map((e) => e.copyWith( + offset: Offset(e.offset.dx - (_horizontalViewport?.pixels ?? 0) , e.offset.dy - _verticalViewport.pixels) + )).toList()); + } + + void _drawText(Canvas canvas, Offset offset) { + if (_displayParagraphs.isEmpty) { + return; + } + canvas.save(); + canvas.translate(offset.dx, offset.dy); + for (final CodeLineRenderParagraph paragraph in _displayParagraphs) { + final Offset drawOffset = paragraph.offset - paintOffset; + paragraph.draw(canvas, drawOffset); + _drawChunkIndicatorIfNeeded(canvas, paragraph, drawOffset); + } + canvas.restore(); + } + + void _drawChunkIndicatorIfNeeded(Canvas canvas, CodeLineRenderParagraph paragraph, Offset offset) { + if (!paragraph.chunkParent && !paragraph.chunkLongText) { + return; + } + final Color? chunkIndicatorColor = _chunkIndicatorColor ?? _textStyle.color?.withAlpha(128); + if (chunkIndicatorColor == null || chunkIndicatorColor == Colors.transparent) { + return; + } + final Offset? end = paragraph.getOffset(TextPosition(offset: paragraph.length)); + if (end == null) { + return; + } + final Rect region = _drawChunkIndicator(canvas, chunkIndicatorColor, offset + end); + _chunkIndicators.add(_CodeChunkIndicator(region, paragraph.index, paragraph.chunkParent)); + } + + Rect _drawChunkIndicator(Canvas canvas, Color color, Offset offset) { + _paint.color = color; + final double dy = _preferredLineHeight / 2 + 1; + const double radius = 1; + const double start = 3; + const double interval = 3; + canvas.drawCircle(offset + Offset(start, dy), radius, _paint); + canvas.drawCircle(offset + Offset(start + interval, dy), radius, _paint); + canvas.drawCircle(offset + Offset(start + interval * 2, dy), radius, _paint); + return Rect.fromLTWH(offset.dx + start - radius, offset.dy, start + interval * 2 + radius, _preferredLineHeight); + } + + void _drawHandleLayer(PaintingContext context, LayerLink layer, Offset position, Offset offset) { + final Offset point = Offset( + clampDouble(position.dx, 0.0, size.width), + clampDouble(position.dy, 0.0, size.height), + ); + context.pushLayer( + LeaderLayer(link: layer, offset: point + offset), + super.paint, + Offset.zero, + ); + } + + void _updateSelectionExtentsVisibility(Offset effectiveOffset) { + if (!kIsAndroid && !kIsIOS) { + return; + } + final Rect visibleRegion = Offset.zero & size; + // Check if the selection is visible with an approximation because a + // difference between rounded and unrounded values causes the caret to be + // reported as having a slightly (< 0.5) negative y offset. This rounding + // happens in paragraph.cc's layout and TextPainter's + // _applyFloatingPointHack. Ideally, the rounding mismatch will be fixed and + // this can be changed to be a strict check instead of an approximation. + const double visibleRegionSlop = 0.5; + final Offset? startOffset = calculateTextPositionViewportOffset(_selection.start); + if (startOffset == null) { + _selectionStartInViewport.value = false; + } else { + _selectionStartInViewport.value = visibleRegion + .inflate(visibleRegionSlop) + .contains(startOffset); + } + final Offset? endOffset = calculateTextPositionViewportOffset(_selection.end); + if (endOffset == null) { + _selectionEndInViewport.value = false; + } else { + _selectionEndInViewport.value = visibleRegion + .inflate(visibleRegionSlop) + .contains(endOffset.dy < 0 ? endOffset : endOffset + Offset(0, _preferredLineHeight)); + } + } + + void _calculatePreferredLineHeight() { + final TextPainter painter = TextPainter( + textDirection: TextDirection.ltr, + ); + painter.text = TextSpan( + text: '0', + style: _textStyle, + ); + _preferredLineHeight = painter.preferredLineHeight; + _foregroundRender.find<_CodeFieldCursorPainter>().height = painter.preferredLineHeight; + _foregroundRender.find<_CodeFieldFloatingCursorPainter>().height = painter.preferredLineHeight; + } + + void _onCursorVisibleChanged() { + _foregroundRender.find<_CodeFieldCursorPainter>().visible = _showCursorNotifier.value; + } + + void _onFloatingCursorChanged() { + _foregroundRender.find<_CodeFieldFloatingCursorPainter>().position = _floatingCursorNotifier.value; + } + + bool isValidPointer(Offset localPosition) { + if (localPosition.dx <= 0 || localPosition.dx >= size.width - _verticalScrollbarWidth) { + return false; + } + if (localPosition.dy <= 0) { + return false; + } + if (localPosition.dy >= size.height - ((_horizontalViewportSize ?? -1) <= 0 ? 0 : _horizontalScrollbarHeight)) { + return false; + } + return true; + } + + bool isValidPointer2(Offset globalPosition) { + final Offset localPosition = globalToLocal(globalPosition); + return isValidPointer(localPosition); + } + + CodeLineRange? _selectWord(Offset localPosition) { + final Offset offset = localPosition + paintOffset; + final CodeLineRenderParagraph? target = _findDisplayRenderParagraph(offset); + if (target == null) { + return null; + } + final CodeLineRange range = target.getWord(offset - target.offset); + if (range.isCollapsed) { + return null; + } + return range; + } + + CodeLineRenderParagraph? _findDisplayRenderParagraph(Offset offset, [bool canOverflow = false]) { + for (final CodeLineRenderParagraph paragraph in _displayParagraphs) { + if (paragraph.inVerticalRange(offset)) { + return paragraph; + } + } + if (canOverflow && _displayParagraphs.isNotEmpty) { + final CodeLineRenderParagraph top = _displayParagraphs.first; + if (offset.dy <= top.bottom) { + return top; + } + final CodeLineRenderParagraph bottom = _displayParagraphs.last; + if (offset.dy >= bottom.top) { + return bottom; + } + } + return null; + } + + void _alignTopEdge({ + double? offset + }) { + final double position = offset ?? _verticalViewport.pixels; + if (position < paddingTop) { + _verticalViewport.jumpTo(max(position, 0)); + } else { + final double scroll = position ~/ _preferredLineHeight * _preferredLineHeight + paddingTop; + if (scroll < _verticalViewport.pixels) { + _verticalViewport.jumpTo(scroll); + } + } + } + + void _alignBottomEdge({ + double? offset + }) { + final double? viewportMax = _verticalViewportSize; + if (viewportMax == null) { + return; + } + final double position = offset ?? _verticalViewport.pixels; + if (position > viewportMax - paddingBottom) { + _verticalViewport.jumpTo(min(position, viewportMax)); + } else { + final double delta = (size.height / _preferredLineHeight).ceil() * _preferredLineHeight - size.height; + final double scroll = position ~/ _preferredLineHeight * _preferredLineHeight + delta + paddingTop; + if (scroll > _verticalViewport.pixels) { + _verticalViewport.jumpTo(min(scroll, viewportMax)); + } + } + } + + List _buildDisplayRenderParagraphs(int startIndex, double maxWidth) { + double offset = startIndex * _preferredLineHeight; + final List paragraphs = []; + for (int i = startIndex; i < _codes.length; i++) { + final IParagraph paragraph = _buildParagraph(i, maxWidth); + _displayParagraphs.add(CodeLineRenderParagraph( + index: i, + paragraph: paragraph, + offset: Offset(paddingLeft, offset + paddingTop), + chunkParent: _codes[i].chunkParent, + chunkLongText: paragraph.trucated, + )); + offset += paragraph.height; + if (offset + paddingTop >= _verticalViewport.pixels + size.height) { + break; + } + } + return paragraphs; + } + + IParagraph _buildParagraph(int index, [double? maxWidth]) { + return _highlighter.build( + index: index, + style: _textStyle, + maxWidth: maxWidth ?? (_horizontalViewport == null ? size.width - padding.horizontal : double.infinity), + maxLengthSingleLineRendering: _maxLengthSingleLineRendering, + ); + } + +} + +class _CodeChunkIndicator { + + final Rect region; + final int index; + final bool canExpand; + + const _CodeChunkIndicator(this.region, this.index, this.canExpand); +} + +abstract class _CodeFieldExtraPainter extends ChangeNotifier { + + void paint(Canvas canvas, Size size, _CodeFieldRender render); + +} + +class _CodeFieldExtraRender extends RenderBox { + + final List<_CodeFieldExtraPainter> painters; + + _CodeFieldExtraRender({ + required this.painters + }); + + @override + _CodeFieldRender? get parent => super.parent as _CodeFieldRender?; + + @override + bool get isRepaintBoundary => true; + + @override + bool get sizedByParent => true; + + @override + void paint(PaintingContext context, Offset offset) { + final _CodeFieldRender? parent = this.parent; + assert(parent != null); + // _Trace.begin('CodeField ExtraRender'); + final Canvas canvas = context.canvas; + canvas.save(); + canvas.clipRect(Rect.fromLTWH(offset.dx, offset.dy, size.width, size.height)); + for (final _CodeFieldExtraPainter painter in painters) { + painter.paint(context.canvas, size, parent!); + } + canvas.restore(); + // _Trace.end('CodeField ExtraRender'); + } + + @override + void attach(PipelineOwner owner) { + super.attach(owner); + for (final _CodeFieldExtraPainter painter in painters) { + painter.addListener(markNeedsPaint); + } + } + + @override + void detach() { + for (final _CodeFieldExtraPainter painter in painters) { + painter.removeListener(markNeedsPaint); + } + super.detach(); + } + + @override + Size computeDryLayout(BoxConstraints constraints) => constraints.biggest; + + T find() { + T? result; + for (final _CodeFieldExtraPainter painter in painters) { + if (painter is T) { + result = painter; + break; + } + } + assert(result != null, 'Failed to find $T'); + return result!; + } +} + +class _CodeCursorLinePainter extends _CodeFieldExtraPainter { + + final Paint _paint; + Color? _color; + CodeLineSelection _selection; + + _CodeCursorLinePainter(this._color, this._selection) : _paint = Paint() { + _paint + ..style = PaintingStyle.stroke + ..strokeWidth = 1; + } + + set color(Color? value) { + if (_color == value) { + return; + } + _color = value; + notifyListeners(); + } + + set selection(CodeLineSelection value) { + if (_selection == value) { + return; + } + _selection = value; + notifyListeners(); + } + + @override + void paint(Canvas canvas, Size size, _CodeFieldRender render) { + if (_color == null || _color == Colors.transparent || _color!.alpha == 0) { + return; + } + if (!_selection.isCollapsed) { + return; + } + final CodeLineRenderParagraph? paragraph = render.findDisplayParagraphByLineIndex(_selection.extentIndex); + if (paragraph == null) { + return; + } + Offset? offset = paragraph.getOffset(_selection.extent); + if (offset == null) { + return; + } + offset += paragraph.offset - render.paintOffset; + if (offset.dy + paragraph.preferredLineHeight < 0 || offset.dy >= size.height) { + return; + } + _paint.color = _color!; + canvas.drawLine(Offset(0, offset.dy), Offset(size.width, offset.dy), _paint); + canvas.drawLine(Offset(0, offset.dy + paragraph.preferredLineHeight), + Offset(size.width, offset.dy + paragraph.preferredLineHeight), _paint); + } + +} + +abstract class _CodeFieldSelectionsPainter extends _CodeFieldExtraPainter { + + static const Offset _newLinePadding = Offset(5.0, 0.0); + + final Paint _paint; + Color _color; + List _selections; + + _CodeFieldSelectionsPainter(this._color, this._selections) : _paint = Paint(); + + set color(Color value) { + if (_color == value) { + return; + } + _color = value; + notifyListeners(); + } + + set selections(List value) { + if (listEquals(_selections, value)) { + return; + } + _selections = value; + notifyListeners(); + } + + @override + void paint(Canvas canvas, Size size, _CodeFieldRender render) { + if (_color == Colors.transparent || _color.alpha == 0) { + return; + } + final List paragraphs = render.displayParagraphs; + if (paragraphs.isEmpty) { + return; + } + for (final CodeLineSelection selection in _selections) { + if (selection.isCollapsed) { + continue; + } + int startIndex; + int endIndex; + for (final CodeLineRenderParagraph paragraph in paragraphs) { + final CodeLinePosition start = selection.start; + final CodeLinePosition end = selection.end; + if (paragraph.index < start.index || paragraph.index > end.index) { + continue; + } + if (paragraph.index == start.index) { + startIndex = start.offset; + } else { + startIndex = 0; + } + if (paragraph.index == end.index) { + endIndex = end.offset; + } else { + endIndex = paragraph.length; + } + final List rects; + if (startIndex == endIndex) { + final Offset? offset = paragraph.getOffset(TextPosition(offset: startIndex)); + if (offset == null) { + rects = const []; + } else { + rects = [ + Rect.fromLTWH(offset.dx, offset.dy, 0, paragraph.preferredLineHeight) + ]; + } + } else { + rects = paragraph.getRangeRects(TextRange( + start: startIndex, + end: endIndex + )); + } + if (rects.isEmpty) { + continue; + } + for (final Rect rect in rects) { + if (rect == rects.last && paragraph.index < end.index) { + _drawRect(canvas, Rect.fromPoints(rect.topLeft, rect.bottomRight + _newLinePadding), + paragraph.offset - render.paintOffset); + } else if (!rect.isEmpty) { + _drawRect(canvas, rect, paragraph.offset - render.paintOffset); + } + } + } + } + } + + void _drawRect(Canvas canvas, Rect rect, Offset offset) { + _paint.color = _color; + canvas.drawRect(Rect.fromPoints(rect.topLeft + offset, rect.bottomRight + offset), _paint); + } + +} + +class _CodeFieldSelectionPainter extends _CodeFieldSelectionsPainter { + + _CodeFieldSelectionPainter(Color color, CodeLineSelection selection) : + super(color, [selection]); + + set selection(CodeLineSelection value) { + selections = [value]; + } + +} + +class _CodeFieldHighlightPainter extends _CodeFieldSelectionsPainter { + + _CodeFieldHighlightPainter(super.color, super.selections); + +} + +class _CodeFieldCursorPainter extends _CodeFieldExtraPainter { + + final Paint _paint; + CodeLinePosition _position; + Color _color; + double _width; + double _height; + bool _visible; + bool _willDraw; + + _CodeFieldCursorPainter({ + required CodeLinePosition position, + required Color color, + required double width, + required double height, + required bool visible, + }) : _position = position, + _color = color, + _width = width, + _height = height, + _visible = visible, + _willDraw = true, + _paint = Paint(); + + set position(CodeLinePosition value) { + if (_position == value) { + return; + } + _position = value; + notifyListeners(); + } + + set color(Color value) { + if (_color == value) { + return; + } + _color = value; + notifyListeners(); + } + + double get width => _width; + + set width(double value) { + if (_width == value) { + return; + } + _width = value; + notifyListeners(); + } + + set height(double value) { + if (_height == value) { + return; + } + _height = value; + notifyListeners(); + } + + set visible(bool value) { + if (_visible == value) { + return; + } + _visible = value; + notifyListeners(); + } + + set willDraw(bool value) { + if (_willDraw == value) { + return; + } + _willDraw = value; + notifyListeners(); + } + + @override + void paint(Canvas canvas, Size size, _CodeFieldRender render) { + if (!_visible || !_willDraw || _color == Colors.transparent || _color.alpha == 0) { + return; + } + final CodeLineRenderParagraph? paragraph = render.findDisplayParagraphByLineIndex(_position.index); + if (paragraph == null) { + return; + } + Offset? offset = paragraph.getOffset(_position); + if (offset == null) { + return; + } + offset += paragraph.offset - render.paintOffset; + if (offset.dx + _width < 0 || offset.dx >= size.width || offset.dy + _height < 0 || offset.dy >= size.height) { + return; + } + _drawCaret(canvas, offset, size); + } + + void _drawCaret(Canvas canvas, Offset offset, Size size) { + _paint.color = _color; + canvas.drawRRect(RRect.fromRectXY(Rect.fromLTWH(offset.dx - _width / 2, offset.dy, _width, _height), _width / 2, _width / 2), _paint); + } + +} + +class _CodeFieldFloatingCursorPainter extends _CodeFieldExtraPainter { + + final Paint _paint; + _FloatingCursorState _position; + Color _color; + double _width; + double _height; + + _CodeFieldFloatingCursorPainter({ + required _FloatingCursorState position, + required Color color, + required double width, + required double height, + }) : _position = position, + _color = color, + _width = width, + _height = height, + _paint = Paint(); + + set position(_FloatingCursorState value) { + if (_position == value) { + return; + } + _position = value; + notifyListeners(); + } + + set color(Color value) { + if (_color == value) { + return; + } + _color = value; + notifyListeners(); + } + + double get width => _width; + + set width(double value) { + if (_width == value) { + return; + } + _width = value; + notifyListeners(); + } + + double get height => _height; + + set height(double value) { + if (_height == value) { + return; + } + _height = value; + notifyListeners(); + } + + @override + void paint(Canvas canvas, Size size, _CodeFieldRender render) { + if (!_position.isActive() || _color == Colors.transparent || _color.alpha == 0) { + return; + } + _drawFloatingCaret(canvas, _position.floatingCursorOffset!, size); + if (_position.previewCursorOffset != null) { + _drawPreviewCursor(canvas, _position.previewCursorOffset!, size); + } + } + + void _drawFloatingCaret(Canvas canvas, Offset offset, Size size) { + final caretRect = RRect.fromRectXY( + Rect.fromLTWH(offset.dx - _width / 2, offset.dy, _width, _height), + _width / 2, + _width / 2, + ); + final path = Path()..addRRect(caretRect); + + canvas.drawShadow( + path, + Colors.black, + 4.0, + true, + ); + + _paint.color = _color; + canvas.drawRRect(RRect.fromRectXY(Rect.fromLTWH(offset.dx - _width / 2, offset.dy, _width, _height), _width / 2, _width / 2), _paint); + } + + void _drawPreviewCursor(Canvas canvas, Offset offset, Size size) { + _paint.color = _color.withAlpha(150); + canvas.drawRRect(RRect.fromRectXY(Rect.fromLTWH(offset.dx - _width / 2, offset.dy, _width, _height), _width / 2, _width / 2), _paint); + } + +} diff --git a/packages/re_editor/lib/src/_code_find.dart b/packages/re_editor/lib/src/_code_find.dart new file mode 100644 index 0000000..e579503 --- /dev/null +++ b/packages/re_editor/lib/src/_code_find.dart @@ -0,0 +1,525 @@ +part of re_editor; + +class _CodeFindControllerImpl extends ValueNotifier implements CodeFindController { + + late final CodeLineEditingController _controller; + late final _IsolateTasker<_CodeFindPayload, CodeFindResult?> _tasker; + late final TextEditingController _findInputController; + late final FocusNode _findInputFocusNode; + late final TextEditingController _replaceInputController; + late final FocusNode _replaceInputFocusNode; + late bool _shouldNotUpdateResults; + late bool _replacingMatch; + + _CodeFindControllerImpl(CodeLineEditingController controller, [CodeFindValue? value]) : super(value) { + _controller = controller is _CodeLineEditingControllerDelegate ? controller.delegate : controller; + _controller.addListener(_updateResult); + _tasker = _IsolateTasker<_CodeFindPayload, CodeFindResult?>('CodeFind', _run); + _findInputController = TextEditingController(); + _findInputController.addListener(_onFindPatternChanged); + _findInputFocusNode = FocusNode(); + _replaceInputController = TextEditingController(); + _replaceInputFocusNode = FocusNode(); + _shouldNotUpdateResults = false; + _replacingMatch = false; + _updateResult(); + } + + @override + void dispose() { + super.dispose(); + _controller.removeListener(_updateResult); + _findInputController.removeListener(_onFindPatternChanged); + _findInputController.dispose(); + _findInputFocusNode.dispose(); + _replaceInputController.dispose(); + _replaceInputFocusNode.dispose(); + _tasker.close(); + } + + @override + TextEditingController get findInputController => _findInputController; + + @override + TextEditingController get replaceInputController => _replaceInputController; + + @override + FocusNode get findInputFocusNode => _findInputFocusNode; + + @override + FocusNode get replaceInputFocusNode => _replaceInputFocusNode; + + @override + List? get allMatchSelections { + final List? matches = value?.result?.matches; + if (matches == null) { + return null; + } + if (value!.result!.dirty) { + return null; + } + final List selections = []; + for (final CodeLineSelection match in matches) { + final CodeLineSelection? selection = convertMatchToSelection(match); + if (selection == null) { + continue; + } + selections.add(selection); + } + return selections; + } + + @override + CodeLineSelection? get currentMatchSelection { + final CodeLineSelection? currentMatch = value?.result?.currentMatch; + if (currentMatch == null) { + return null; + } + if (value!.result!.dirty) { + return null; + } + return convertMatchToSelection(currentMatch); + } + + @override + void findMode() { + _findInputFocusNode.requestFocus(); + final String? autoFilled = _autoFilledPattern(); + _findInputController.removeListener(_onFindPatternChanged); + if (autoFilled != null) { + _findInputController.value = TextEditingValue( + text: autoFilled, + selection: TextSelection( + baseOffset: 0, + extentOffset: autoFilled.length + ) + ); + } else { + _findInputController.selection = TextSelection( + baseOffset: 0, + extentOffset: _findInputController.text.length + ); + } + _findInputController.addListener(_onFindPatternChanged); + final CodeFindValue preValue = value ?? const CodeFindValue.empty(); + value = preValue.copyWith( + option: preValue.option.copyWith( + pattern: _findInputController.text + ), + result: null, + searching: true + ); + _updateResult(); + } + + @override + void replaceMode() { + _replaceInputFocusNode.requestFocus(); + final String? autoFilled = _autoFilledPattern(); + _findInputController.removeListener(_onFindPatternChanged); + if (autoFilled != null) { + _findInputController.value = TextEditingValue( + text: autoFilled, + selection: TextSelection( + baseOffset: 0, + extentOffset: autoFilled.length + ) + ); + } else { + _findInputController.selection = TextSelection( + baseOffset: 0, + extentOffset: _findInputController.text.length + ); + } + _findInputController.addListener(_onFindPatternChanged); + final CodeFindValue preValue = value ?? const CodeFindValue.empty(); + value = preValue.copyWith( + option: preValue.option.copyWith( + pattern: _findInputController.text, + ), + replaceMode: true, + result: null, + searching: true + ); + _updateResult(); + } + + @override + void focusOnFindInput() { + _findInputFocusNode.requestFocus(); + _findInputController.selection = TextSelection( + baseOffset: 0, + extentOffset: _findInputController.text.length + ); + } + + @override + void focusOnReplaceInput() { + _replaceInputFocusNode.requestFocus(); + _replaceInputController.selection = TextSelection( + baseOffset: 0, + extentOffset: _replaceInputController.text.length + ); + } + + @override + void toggleMode() { + final CodeFindValue? preValue = value; + if (preValue == null) { + return; + } + value = preValue.copyWith( + replaceMode: !preValue.replaceMode, + result: preValue.result + ); + } + + @override + void close() { + value = null; + } + + @override + void toggleRegex() { + final CodeFindOption? option = value?.option; + if (option == null) { + return; + } + value = value?.copyWith( + option: option.copyWith( + regex: !option.regex, + ), + result: null, + searching: true + ); + _updateResult(); + } + + @override + void toggleCaseSensitive() { + final CodeFindOption? option = value?.option; + if (option == null) { + return; + } + value = value?.copyWith( + option: option.copyWith( + caseSensitive: !option.caseSensitive, + ), + result: null, + searching: true + ); + _updateResult(); + } + + @override + void previousMatch() { + final CodeFindResult? result = value?.result; + if (result == null || result.dirty) { + return; + } + final CodeFindValue newValue = value!.copyWith( + result: result.previous + ); + _expandChunkIfNeeded(newValue); + value = newValue; + if (result.matches.length == 1) { + final CodeLineSelection? selection = currentMatchSelection; + if (selection != null) { + _controller.makePositionCenterIfInvisible(selection.start); + } + } + } + + @override + void nextMatch() { + final CodeFindResult? result = value?.result; + if (result == null || result.dirty) { + return; + } + final CodeFindValue newValue = value!.copyWith( + result: result.next + ); + _expandChunkIfNeeded(newValue); + value = newValue; + if (result.matches.length == 1) { + final CodeLineSelection? selection = currentMatchSelection; + if (selection != null) { + _controller.makePositionCenterIfInvisible(selection.start); + } + } + } + + @override + void replaceMatch() { + final CodeFindResult? result = value?.result; + if (result == null || result.dirty) { + return; + } + if (currentMatchSelection == null) { + _expandChunkIfNeeded(value!); + } + final CodeLineSelection? selection = currentMatchSelection; + if (selection == null) { + return; + } + _replacingMatch = true; + final CodeLines preCodeLines = _controller.codeLines; + _controller.replaceSelection(_replaceInputController.text, selection); + final CodeFindValue newValue = value!.copyWith( + result: result.next.copyWith( + dirty: !preCodeLines.equals(_controller.codeLines) + ) + ); + _expandChunkIfNeeded(newValue); + value = newValue; + _replacingMatch = false; + } + + @override + void replaceAllMatches() { + final CodeFindResult? result = value?.result; + if (result == null || result.matches.isEmpty || result.dirty) { + return; + } + final CodeFindOption? option = value?.option; + if (option == null) { + return; + } + final RegExp? regExp = option.regExp; + if (regExp == null) { + return; + } + _replacingMatch = true; + final CodeLines preCodeLine = _controller.codeLines; + _controller.replaceAll(regExp, _replaceInputController.text); + value = value?.copyWith( + result: result.copyWith( + dirty: !preCodeLine.equals(_controller.codeLines) + ) + ); + _replacingMatch = false; + } + + @override + CodeLineSelection? convertMatchToSelection(CodeLineSelection match) { + final CodeLineIndex baseIndex = _controller.lineIndex2Index(match.baseIndex); + if (baseIndex.chunkIndex >= 0) { + // This match is in a collapsed chunk, invisble + return null; + } + final CodeLineIndex extentIndex; + if (match.isSameLine) { + extentIndex = baseIndex; + } else { + extentIndex = _controller.lineIndex2Index(match.extentIndex); + } + if (extentIndex.chunkIndex >= 0) { + // This match is in a collapsed chunk, invisble + return null; + } + return match.copyWith( + baseIndex: baseIndex.index, + extentIndex: extentIndex.index + ); + } + + void _onFindPatternChanged() { + final CodeFindOption? option = value?.option; + if (option == null) { + return; + } + if (_findInputController.text == option.pattern) { + return; + } + value = value?.copyWith( + option: option.copyWith( + pattern: _findInputController.text, + ), + result: null, + searching: true + ); + _updateResult(); + } + + String? _autoFilledPattern() { + final CodeLineSelection selection = _controller.selection; + if (selection.isCollapsed || !selection.isSameLine) { + return null; + } + return _controller.selectedText; + } + + void _updateResult() { + if (_shouldNotUpdateResults) { + return; + } + final CodeFindOption? option = value?.option; + if (option == null || option.pattern.isEmpty) { + value = value?.copyWith( + result: null, + searching: false + ); + return; + } + final bool optionChanged = value?.result?.option != option; + if (!optionChanged && _controller.codeLines.equals(value?.result?.codeLines)) { + value = value?.copyWith( + result: value?.result, + searching: false + ); + return; + } + final _CodeFindPayload payload = _CodeFindPayload( + codeLines: _controller.codeLines, + selection: _controller.unfoldLineSelection, + option: option, + forwardMatch: !_replacingMatch + ); + _tasker.run(payload, (result) { + if (option == value?.option) { + final CodeFindValue newValue = value!.copyWith( + result: result, + searching: false + ); + if (optionChanged) { + _expandChunkIfNeeded(newValue); + } + value = newValue; + } else { + value = value?.copyWith( + result: null, + searching: false + ); + } + }); + } + + void _expandChunkIfNeeded(CodeFindValue value) { + _shouldNotUpdateResults = true; + final CodeLineSelection? match = value.result?.currentMatch; + if (match != null) { + _expandChunkIfSelectionInvisible(match); + } + _shouldNotUpdateResults = false; + } + + void _expandChunkIfSelectionInvisible(CodeLineSelection match) { + if (match.isSameLine) { + final CodeLineIndex start = _controller.lineIndex2Index(match.startIndex); + if (start.chunkIndex < 0) { + return; + } + _controller.expandChunk(start.index); + } else { + final CodeLineIndex start = _controller.lineIndex2Index(match.startIndex); + final CodeLineIndex end = _controller.lineIndex2Index(match.endIndex); + if (start.chunkIndex >= 0) { + _controller.expandChunk(start.index); + } else if (end.chunkIndex >= 0) { + _controller.expandChunk(end.index); + } else { + return; + } + } + // If the selection is in a nested chunk, we should expand the chunk from outside one by one + _expandChunkIfSelectionInvisible(match); + } + + @pragma('vm:entry-point') + static CodeFindResult? _run(_CodeFindPayload payload) { + final RegExp? regExp = payload.option.regExp; + if (regExp == null) { + return null; + } + final List rawCodeLines = payload.codeLines.toList().fold([], (previousValue, element) { + previousValue.addAll(element.flat()); + return previousValue; + }); + final Iterable matches = regExp.allMatches(rawCodeLines.join(TextLineBreak.lf.value)); + if (matches.isEmpty) { + return null; + } + final List selections = []; + for (final Match match in matches) { + final CodeLinePosition start = _findPosition(rawCodeLines, match.start); + final CodeLinePosition end = _findPosition(rawCodeLines, match.end); + selections.add(CodeLineSelection( + baseIndex: start.index, + baseOffset: start.offset, + extentIndex: end.index, + extentOffset: end.offset + )); + } + int index; + if (payload.forwardMatch) { + index = selections.length - 1; + for (; index > 0; index--) { + if (selections[index].contains(payload.selection)) { + break; + } + if (selections[index].endIndex < payload.selection.startIndex) { + break; + } + if (selections[index].endIndex == payload.selection.startIndex && + selections[index].endOffset <= payload.selection.startOffset) { + break; + } + } + } else { + index = 0; + for (; index < selections.length; index++) { + if (selections[index].contains(payload.selection)) { + break; + } + if (selections[index].startIndex > payload.selection.endIndex) { + break; + } + if (selections[index].startIndex == payload.selection.endIndex && + selections[index].startOffset >= payload.selection.endOffset) { + break; + } + } + } + return CodeFindResult( + index: max(min(index, selections.length - 1), 0), + matches: selections, + option: payload.option, + codeLines: payload.codeLines, + dirty: false + ); + } + + static CodeLinePosition _findPosition(List codeLines, int index) { + int start = 0; + int line = 0; + int offset = -1; + for (; line < codeLines.length; line++) { + if (index <= start + codeLines[line].length) { + offset = index - start; + break; + } + start += codeLines[line].length + 1; + } + return CodeLinePosition( + index: line, + offset: offset + ); + } + +} + +class _CodeFindPayload { + + final CodeLines codeLines; + final CodeLineSelection selection; + final CodeFindOption option; + final bool forwardMatch; + + const _CodeFindPayload({ + required this.codeLines, + required this.selection, + required this.option, + required this.forwardMatch, + }); + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/_code_floating_cursor.dart b/packages/re_editor/lib/src/_code_floating_cursor.dart new file mode 100644 index 0000000..caa31b7 --- /dev/null +++ b/packages/re_editor/lib/src/_code_floating_cursor.dart @@ -0,0 +1,149 @@ +part of re_editor; + +// The time the animation of the floating cursor snapping to the final cursor position will take. +const Duration floatingCursorSnapDuration = Duration(milliseconds: 300); + +// Class containing the floating cursor control logic. +class _CodeFloatingCursorController + extends ValueNotifier<_FloatingCursorState> { + late final _CodeCursorBlinkController _blinkController; + late final AnimationController _animationController; + + _CodeFloatingCursorController() : super(const _FloatingCursorState()); + + /// Sets the [Offset] and [CodeLineSelection] of the cursors. Setting either one of these offsets + /// to null is equivalent to turning off the corresponding cursor. + void setFloatingCursorPositions( + {Offset? floatingCursorOffset, + Offset? previewCursorOffset, + Offset? finalCursorOffset, + CodeLineSelection? finalCursorSelection}) { + if (value.floatingCursorOffset != null && floatingCursorOffset == null) { + // Starting the floating cursor, stop blinking of the normal cursor + _blinkController.startBlink(); + } else if (value.floatingCursorOffset == null && + floatingCursorOffset != null) { + // Stopping the floating cursor, resume blinking of the normal cursor + _blinkController.stopBlink(); + } + + value = _FloatingCursorState( + floatingCursorOffset: floatingCursorOffset, + previewCursorOffset: previewCursorOffset, + finalCursorOffset: finalCursorOffset, + finalCursorSelection: finalCursorSelection, + ); + } + + /// Turns off the floating cursor by setting all the offsets to null. + void disableFloatingCursor() { + setFloatingCursorPositions(); + } + + /// Update the [Offset] value of preview cursor. + void updatePreviewCursorOffset(Offset? previewCursorOffset) { + value = value.copyWith(previewCursorOffset: previewCursorOffset); + } + + void _onFloatingCursorResetAnimationTick() { + if (_animationController.isCompleted) { + // Once animation is complete, turn off the floating cursor off + disableFloatingCursor(); + } else { + final double lerpValue = _animationController.value; + final double lerpX = ui.lerpDouble(value.floatingCursorOffset!.dx, + value.finalCursorOffset!.dx, lerpValue)!; + final double lerpY = ui.lerpDouble(value.floatingCursorOffset!.dy, + value.finalCursorOffset!.dy, lerpValue)!; + + setFloatingCursorPositions( + floatingCursorOffset: Offset(lerpX, lerpY), + previewCursorOffset: value.previewCursorOffset, + finalCursorOffset: value.finalCursorOffset, + finalCursorSelection: value.finalCursorSelection); + } + } + + /// Performs the "snapping" animation and turns of the floating cursor. + void animateDisableFloatingCursor() { + _animationController.value = 0.0; + _animationController.animateTo(1, + duration: floatingCursorSnapDuration, curve: Curves.decelerate); + } + + @override + void dispose() { + disableFloatingCursor(); + super.dispose(); + } + + /// The two methods below are meant to only be used for property injection. Both [_blinkController] and [_animationController] + /// have to be set before calling any of the other methods for the [_CodeFloatingCursorController] to work properly. + + set blinkController(_CodeCursorBlinkController value) { + _blinkController = value; + } + + set animationController(AnimationController value) { + value.addListener(_onFloatingCursorResetAnimationTick); + _animationController = value; + } + + Offset? get previewCursorOffset => value.previewCursorOffset; + + Offset? get floatingCursorOffset => value.floatingCursorOffset; +} + +class _FloatingCursorState { + /// The offset of the floating cursor. + final Offset? floatingCursorOffset; + + /// The offset of the preview cursor. The preview cursor is only visible when the floating cursor is hovering to the right of + /// the end of the line, where no text is present. It shows where the actual cursor would end up if the floating cursor would + /// be stoped in that moment. + final Offset? previewCursorOffset; + + /// The offset where the actual cursor would be placed if floating cursor would be stopped. + final Offset? finalCursorOffset; + + final CodeLineSelection? finalCursorSelection; + + const _FloatingCursorState( + {this.floatingCursorOffset, + this.previewCursorOffset, + this.finalCursorOffset, + this.finalCursorSelection}); + + /// Creates a copy of this instance with the specified values overridden. + _FloatingCursorState copyWith({ + Offset? floatingCursorOffset, + Offset? previewCursorOffset, + Offset? finalCursorOffset, + CodeLineSelection? finalCursorSelection, + }) { + return _FloatingCursorState( + floatingCursorOffset: floatingCursorOffset ?? this.floatingCursorOffset, + previewCursorOffset: previewCursorOffset ?? this.previewCursorOffset, + finalCursorOffset: finalCursorOffset ?? this.finalCursorOffset, + finalCursorSelection: finalCursorSelection ?? this.finalCursorSelection, + ); + } + + bool isActive() { + // Floating cursor is active only if its offset is not null. + return floatingCursorOffset != null; + } + + @override + bool operator ==(Object other) => + identical(this, other) || + (other is _FloatingCursorState && + floatingCursorOffset == other.floatingCursorOffset && + previewCursorOffset == other.previewCursorOffset && + finalCursorOffset == other.finalCursorOffset && + finalCursorSelection == other.finalCursorSelection); + + @override + int get hashCode => Object.hash(floatingCursorOffset, previewCursorOffset, + finalCursorOffset, finalCursorSelection); +} diff --git a/packages/re_editor/lib/src/_code_formatter.dart b/packages/re_editor/lib/src/_code_formatter.dart new file mode 100644 index 0000000..9c19820 --- /dev/null +++ b/packages/re_editor/lib/src/_code_formatter.dart @@ -0,0 +1,795 @@ +part of re_editor; + +class _DefaultCodeCommentFormatter implements DefaultCodeCommentFormatter { + + final String? singleLinePrefix; + final String? multiLinePrefix; + final String? multiLineSuffix; + + const _DefaultCodeCommentFormatter({ + this.singleLinePrefix, + this.multiLinePrefix, + this.multiLineSuffix + }); + + @override + CodeLineEditingValue format(CodeLineEditingValue value, String indent, bool single) { + if (single && (singleLinePrefix == null || singleLinePrefix!.isEmpty)) { + return value; + } + if (!single && (multiLinePrefix == null || multiLinePrefix!.isEmpty) && (multiLineSuffix == null || multiLineSuffix!.isEmpty)) { + return value; + } + final _DefaultCommentFormatter formatter; + if (single) { + formatter = _DefaultSingleLineCommentFormatter(singleLinePrefix!); + } else { + formatter = _DefaultMultiLineCommentFormatter(multiLinePrefix!, multiLineSuffix!); + } + return formatter.format(value, indent); + } + +} + +abstract class _DefaultCommentFormatter { + + final String symbol; + + const _DefaultCommentFormatter(this.symbol); + + CodeLineEditingValue format(CodeLineEditingValue value, String indent); + +} + +class _DefaultSingleLineCommentFormatter extends _DefaultCommentFormatter { + const _DefaultSingleLineCommentFormatter(super.symbol); + + @override + CodeLineEditingValue format(CodeLineEditingValue value, String indent) { + final CodeLineSelection selection = value.selection; + if (selection.isSameLine) { + return _formatSelectedCodeLine(value, indent); + } else { + return _formatSelectedCodeLines(value, indent); + } + } + + CodeLineEditingValue _formatSelectedCodeLine(CodeLineEditingValue value, String indent) { + final String trimCode = value.codeLines[value.selection.baseIndex].text.trimLeft(); + if (trimCode.startsWith('$symbol ')) { + return _uncommentSelectedCodeLine(value, '$symbol '); + } else if (trimCode.startsWith(symbol)) { + return _uncommentSelectedCodeLine(value, symbol); + } else { + return _commentSelectedCodeLine(value, indent, '$symbol '); + } + } + + CodeLineEditingValue _uncommentSelectedCodeLine(CodeLineEditingValue value, String prefix) { + final CodeLineSelection selection = value.selection; + final CodeLines codeLines = value.codeLines; + final int lineIndex = selection.baseIndex; + final CodeLine codeLine = codeLines[lineIndex]; + final int index = codeLine.text.indexOf(prefix); + final CodeLines newCodeLines = CodeLines.from(codeLines); + newCodeLines[lineIndex] = codeLine.copyWith( + text: codeLine.text.substring(0, index) + codeLine.text.substring(index + prefix.length) + ); + int relocation(int offset) { + if (offset <= index) { + return offset; + } else { + return max(index, offset - prefix.length); + } + } + return value.copyWith( + codeLines: newCodeLines, + selection: selection.copyWith( + baseOffset: relocation(selection.baseOffset), + extentOffset: relocation(selection.extentOffset), + ) + ); + } + + CodeLineEditingValue _commentSelectedCodeLine(CodeLineEditingValue value, String indent, String prefix) { + final CodeLineSelection selection = value.selection; + final CodeLines codeLines = value.codeLines; + final int lineIndex = selection.baseIndex; + final CodeLine codeLine = codeLines[lineIndex]; + final int index = codeLine.text.getOffsetWithoutIndent(indent); + final CodeLines newCodeLines = CodeLines.from(codeLines); + newCodeLines[lineIndex] = codeLine.copyWith( + text: codeLine.text.insert(prefix, index) + ); + final int baseOffset; + final int extentOffset; + if (selection.isCollapsed) { + if (selection.baseOffset < index) { + baseOffset = extentOffset = selection.baseOffset; + } else { + baseOffset = extentOffset = selection.baseOffset + prefix.length; + } + } else { + if (selection.startOffset < index && selection.endOffset > index) { + if (selection.baseOffset < index) { + baseOffset = selection.baseOffset; + extentOffset = selection.extentOffset + prefix.length; + } else { + extentOffset = selection.extentOffset; + baseOffset = selection.baseOffset + prefix.length; + } + } else if (selection.startOffset >= index) { + baseOffset = selection.baseOffset + prefix.length; + extentOffset = selection.extentOffset + prefix.length; + } else { + baseOffset = selection.baseOffset; + extentOffset = selection.extentOffset; + } + } + return value.copyWith( + codeLines: newCodeLines, + selection: selection.copyWith( + baseOffset: baseOffset, + extentOffset: extentOffset, + ) + ); + } + + CodeLineEditingValue _formatSelectedCodeLines(CodeLineEditingValue value, String indent) { + final CodeLineSelection selection = value.selection; + final CodeLines codeLines = value.codeLines; + final List texts = []; + for (int i = selection.startIndex; i <= selection.endIndex; i++) { + texts.add(codeLines[i].text); + } + final bool willComment; + texts.removeWhere((text) => text.isEmpty); + if (texts.isEmpty) { + willComment = true; + } else { + willComment = texts.any((text) => !text.trimLeft().startsWith(symbol)); + } + if (willComment) { + return _commentSelectedCodeLines(value, indent, '$symbol '); + } else { + return _uncommentSelectedCodeLines(value, indent, symbol); + } + } + + CodeLineEditingValue _commentSelectedCodeLines(CodeLineEditingValue value, String indent, String prefix) { + final CodeLineSelection selection = value.selection; + final CodeLines codeLines = value.codeLines; + int? index; + for (int i = selection.startIndex; i <= selection.endIndex; i++) { + final CodeLine codeLine = codeLines[i]; + if (codeLine.text.isEmpty) { + continue; + } + final int offset = codeLine.text.getOffsetWithoutIndent(indent); + if (index == null) { + index = offset; + } else { + index = min(index, offset); + } + } + if (index == null) { + return value; + } + final CodeLines newCodeLines = CodeLines.from(codeLines); + for (int i = selection.startIndex; i <= selection.endIndex; i++) { + final CodeLine codeLine = newCodeLines[i]; + if (codeLine.text.isEmpty) { + continue; + } + final newChunks = _commentChunks(codeLine, prefix, index); + newCodeLines[i] = codeLine.copyWith( + text: codeLine.text.insert(prefix, index), + chunks: newChunks + ); + } + final int baseOffset; + final int extentOffset; + if (selection.baseIndex < selection.extentIndex) { + if (selection.baseOffset < index || newCodeLines[selection.baseIndex].text.isEmpty) { + baseOffset = selection.baseOffset; + } else { + baseOffset = selection.baseOffset + prefix.length; + } + if (selection.extentOffset <= index) { + extentOffset = selection.extentOffset; + } else { + extentOffset = selection.extentOffset + prefix.length; + } + } else { + if (selection.baseOffset <= index) { + baseOffset = selection.baseOffset; + } else { + baseOffset = selection.baseOffset + prefix.length; + } + if (selection.extentOffset < index || newCodeLines[selection.extentIndex].text.isEmpty) { + extentOffset = selection.extentOffset; + } else { + extentOffset = selection.extentOffset + prefix.length; + } + } + return value.copyWith( + codeLines: newCodeLines, + selection: selection.copyWith( + baseOffset: baseOffset, + extentOffset: extentOffset, + ) + ); + } + + List _commentChunks(CodeLine codeLine, String prefix, int index) { + final List newCodeChunks = List.from(codeLine.chunks); + for (int j = 0; j < newCodeChunks.length; j++) { + final CodeLine codeLineChunk = newCodeChunks[j]; + if (codeLineChunk.text.isEmpty) { + continue; + } + final newCodeLineChunks = _commentChunks(codeLineChunk, prefix, index); + newCodeChunks[j] = codeLineChunk.copyWith( + text: codeLineChunk.text.insert(prefix, index), + chunks: newCodeLineChunks); + } + return newCodeChunks; + } + + CodeLineEditingValue _uncommentSelectedCodeLines(CodeLineEditingValue value, String indent, String prefix) { + final CodeLineSelection selection = value.selection; + final CodeLines newCodeLines = CodeLines.from(value.codeLines); + int? baseOffset; + int? extentOffset; + for (int i = selection.startIndex; i <= selection.endIndex; i++) { + final CodeLine codeLine = newCodeLines[i]; + if (codeLine.text.isEmpty) { + continue; + } + final String trimCode = codeLine.text.trimLeft(); + final String deletion; + if (trimCode.startsWith('$prefix ')) { + deletion = '$prefix '; + } else { + deletion = prefix; + } + final int index = codeLine.text.indexOf(deletion); + final codeChunks = _uncommentChunks(codeLine, deletion, index); + newCodeLines[i] = codeLine.copyWith( + text: codeLine.text.substring(0, index) + codeLine.text.substring(index + deletion.length), + chunks: codeChunks + ); + if (i == selection.baseIndex) { + if (selection.baseOffset > index) { + baseOffset = max(index, selection.baseOffset - deletion.length); + } + } + if (i == selection.extentIndex) { + if (selection.extentOffset > index) { + extentOffset = max(index, selection.extentOffset - deletion.length); + } + } + } + return value.copyWith( + codeLines: newCodeLines, + selection: selection.copyWith( + baseOffset: baseOffset, + extentOffset: extentOffset, + ) + ); + } + + List _uncommentChunks( + CodeLine codeLine, String deletion, int index) { + final List newCodeChunks = List.from(codeLine.chunks); + for (int j = 0; j < newCodeChunks.length; j++) { + final CodeLine codeLineChunk = newCodeChunks[j]; + if (codeLineChunk.text.isEmpty) { + continue; + } + final newCodeLineChunks = + _uncommentChunks(codeLineChunk, deletion, index); + newCodeChunks[j] = codeLineChunk.copyWith( + text: codeLineChunk.text.substring(0, index) + + codeLineChunk.text.substring(index + deletion.length), + chunks: newCodeLineChunks); + } + return newCodeChunks; + } +} + +class _DefaultMultiLineCommentFormatter extends _DefaultCommentFormatter { + + final String prefix; + final String suffix; + + _DefaultMultiLineCommentFormatter(this.prefix, this.suffix) : super(prefix + suffix); + + @override + CodeLineEditingValue format(CodeLineEditingValue value, String indent) { + final CodeLineSelection selection = value.selection; + if (selection.isSameLine) { + return _formatSelectedCodeLine(value, indent); + } else { + return _formatSelectedCodeLines(value, indent); + } + } + + CodeLineEditingValue _formatSelectedCodeLine( + CodeLineEditingValue value, + String indent, + ) { + final CodeLineSelection selection = value.selection; + final String codeLine = value.codeLines[selection.baseIndex].text; + + final int baseOffset = selection.baseOffset; + final int extentOffset = selection.extentOffset; + + final int base; + final int extent; + + if (extentOffset >= baseOffset) { + base = baseOffset; + extent = extentOffset; + } else { + base = extentOffset; + extent = baseOffset; + } + + final int prefixIndex; + final int suffixIndex = codeLine.indexOf(suffix, extent); + + prefixIndex = _getIndexOfPrefix( + codeLine, + base, + ); + + if (prefixIndex == -1 || suffixIndex == -1 || base < prefixIndex) { + return _commentSelectedCodeLine( + value, + indent, + '$prefix ', + ' $suffix', + ); + } + + if (codeLine.startsWith('$prefix ', prefixIndex) && + codeLine.startsWith(' $suffix', suffixIndex - 1)) { + return _uncommentSelectedCodeLine( + value, + '$prefix ', + ' $suffix', + prefixIndex, + suffixIndex - 1, + ); + } else if (codeLine.startsWith('$prefix ', prefixIndex) && + codeLine.startsWith(suffix, suffixIndex)) { + return _uncommentSelectedCodeLine( + value, + '$prefix ', + suffix, + prefixIndex, + suffixIndex, + ); + } + if (codeLine.startsWith(prefix, prefixIndex) && + codeLine.startsWith(' $suffix', suffixIndex - 1)) { + return _uncommentSelectedCodeLine( + value, + prefix, + ' $suffix', + prefixIndex, + suffixIndex - 1, + ); + } + if (codeLine.startsWith(prefix, prefixIndex) && + codeLine.startsWith(suffix, suffixIndex)) { + return _uncommentSelectedCodeLine( + value, + prefix, + suffix, + prefixIndex, + suffixIndex, + ); + } else { + return _commentSelectedCodeLine( + value, + indent, + '$prefix ', + ' $suffix', + ); + } + } + + CodeLineEditingValue _uncommentSelectedCodeLine( + CodeLineEditingValue value, + String prefix, + String suffix, + int prefixIndex, + int suffixIndex, + ) { + final CodeLineSelection selection = value.selection; + final CodeLines codeLines = value.codeLines; + final int lineIndex = selection.baseIndex; + final CodeLine codeLine = codeLines[lineIndex]; + + final CodeLines newCodeLines = CodeLines.from(codeLines); + + newCodeLines[lineIndex] = codeLine.copyWith( + text: codeLine.text.substring(0, prefixIndex) + + codeLine.text.substring(prefixIndex + prefix.length, suffixIndex) + + codeLine.text.substring(suffixIndex + suffix.length), + ); + + int relocationPrefix(int offset, int deletion) { + if (offset <= prefixIndex) { + return offset; + } else { + return max(prefixIndex, offset - deletion); + } + } + + int relocationSuffix(int offset, int deletion) { + return min(offset - deletion, newCodeLines[lineIndex].text.length); + } + + final int deletion; + + if (prefixIndex + this.prefix.length >= selection.baseOffset) { + deletion = this.prefix.length; + } else { + deletion = prefix.length; + } + + final int baseOffset; + final int extentOffset; + + if (selection.extentOffset >= selection.baseOffset) { + baseOffset = relocationPrefix(selection.baseOffset, deletion); + extentOffset = relocationSuffix(selection.extentOffset, deletion); + } else { + baseOffset = relocationSuffix(selection.baseOffset, deletion); + extentOffset = relocationPrefix(selection.extentOffset, deletion); + } + + return value.copyWith( + codeLines: newCodeLines, + selection: selection.copyWith( + baseOffset: baseOffset, + extentOffset: extentOffset, + ), + ); + } + + CodeLineEditingValue _commentSelectedCodeLine( + CodeLineEditingValue value, + String indent, + String prefix, + String suffix, + ) { + final CodeLineSelection selection = value.selection; + final CodeLines codeLines = value.codeLines; + final int lineIndex = selection.baseIndex; + final CodeLine codeLine = codeLines[lineIndex]; + final int index = codeLine.text.getOffsetWithoutIndent(indent); + final CodeLines newCodeLines = CodeLines.from(codeLines); + + if (selection.extentOffset >= selection.baseOffset) { + newCodeLines[lineIndex] = codeLine.copyWith( + text: codeLine.text + .insert(suffix, selection.extentOffset) + .insert(prefix, selection.baseOffset), + ); + } else { + newCodeLines[lineIndex] = codeLine.copyWith( + text: codeLine.text + .insert(suffix, selection.baseOffset) + .insert(prefix, selection.extentOffset), + ); + } + + final int baseOffset; + final int extentOffset; + + if (selection.isCollapsed) { + if (selection.baseOffset < index) { + baseOffset = extentOffset = selection.baseOffset; + } else { + baseOffset = extentOffset = selection.baseOffset + prefix.length; + } + } else { + if (selection.startOffset < index && selection.endOffset > index) { + if (selection.baseOffset < index) { + baseOffset = selection.baseOffset; + extentOffset = selection.extentOffset + prefix.length; + } else { + extentOffset = selection.extentOffset; + baseOffset = selection.baseOffset + prefix.length; + } + } else if (selection.startOffset >= index) { + baseOffset = selection.baseOffset + prefix.length; + extentOffset = selection.extentOffset + prefix.length; + } else { + baseOffset = selection.baseOffset; + extentOffset = selection.extentOffset; + } + } + + return value.copyWith( + codeLines: newCodeLines, + selection: selection.copyWith( + baseOffset: baseOffset, + extentOffset: extentOffset, + ), + ); + } + + CodeLineEditingValue _formatSelectedCodeLines( + CodeLineEditingValue value, + String indent, + ) { + final CodeLineSelection selection = value.selection; + final int baseIndex = selection.baseIndex; + final int extentIndex = selection.extentIndex; + + String codeFirstLine; + String codeLastLine; + + final int base; + final int extent; + + if (extentIndex >= baseIndex) { + codeFirstLine = value.codeLines[baseIndex].text; + codeLastLine = value.codeLines[extentIndex].text; + + base = selection.baseOffset; + extent = selection.extentOffset; + } else { + codeFirstLine = value.codeLines[extentIndex].text; + codeLastLine = value.codeLines[baseIndex].text; + + base = selection.extentOffset; + extent = selection.baseOffset; + } + + final int prefixIndex; + final int suffixIndex = codeLastLine.indexOf(suffix, extent); + + prefixIndex = _getIndexOfPrefix( + codeFirstLine, + base, + ); + + if (prefixIndex == -1 || suffixIndex == -1 || base < prefixIndex) { + return _commentSelectedCodeLines( + value, + indent, + '$prefix ', + ' $suffix', + ); + } + + if (codeFirstLine.startsWith('$prefix ', prefixIndex) && + codeLastLine.startsWith(' $suffix', suffixIndex - 1)) { + return _uncommentSelectedCodeLines( + value, + '$prefix ', + ' $suffix', + prefixIndex, + suffixIndex - 1, + ); + } else if (codeFirstLine.startsWith('$prefix ', prefixIndex) && + codeLastLine.startsWith(suffix, suffixIndex)) { + return _uncommentSelectedCodeLines( + value, + '$prefix ', + suffix, + prefixIndex, + suffixIndex, + ); + } + if (codeFirstLine.startsWith(prefix, prefixIndex) && + codeLastLine.startsWith(' $suffix', suffixIndex - 1)) { + return _uncommentSelectedCodeLines( + value, + prefix, + ' $suffix', + prefixIndex, + suffixIndex - 1, + ); + } + if (codeFirstLine.startsWith(prefix, prefixIndex) && + codeLastLine.startsWith(suffix, suffixIndex)) { + return _uncommentSelectedCodeLines( + value, + prefix, + suffix, + prefixIndex, + suffixIndex, + ); + } else { + return _commentSelectedCodeLines( + value, + indent, + '$prefix ', + ' $suffix', + ); + } + } + + CodeLineEditingValue _uncommentSelectedCodeLines( + CodeLineEditingValue value, + String prefix, + String suffix, + int prefixIndex, + int suffixIndex, + ) { + final CodeLineSelection selection = value.selection; + final CodeLines codeLines = value.codeLines; + final CodeLines newCodeLines = CodeLines.from(codeLines); + + final int baseIndex = selection.baseIndex; + final int extentIndex = selection.extentIndex; + + final CodeLine codeFirstLine; + final CodeLine codeLastLine; + + final int baseOffset; + final int extentOffset; + + if (extentIndex >= baseIndex) { + codeFirstLine = codeLines[baseIndex]; + codeLastLine = codeLines[extentIndex]; + + newCodeLines[baseIndex] = codeFirstLine.copyWith( + text: codeFirstLine.text.substring(0, prefixIndex) + + codeFirstLine.text.substring(prefixIndex + prefix.length), + ); + + newCodeLines[extentIndex] = codeLastLine.copyWith( + text: codeLastLine.text.substring(0, suffixIndex) + + codeLastLine.text.substring(suffixIndex + suffix.length), + ); + + final int deletion; + + if (prefixIndex + this.prefix.length >= selection.baseOffset) { + deletion = this.prefix.length; + } else { + deletion = prefix.length; + } + + baseOffset = selection.baseOffset - deletion; + extentOffset = min( + selection.extentOffset, + newCodeLines[extentIndex].text.length, + ); + } else { + codeFirstLine = codeLines[extentIndex]; + codeLastLine = codeLines[baseIndex]; + + newCodeLines[extentIndex] = codeFirstLine.copyWith( + text: codeFirstLine.text.substring(0, prefixIndex) + + codeFirstLine.text.substring(prefixIndex + prefix.length), + ); + + newCodeLines[baseIndex] = codeLastLine.copyWith( + text: codeLastLine.text.substring(0, suffixIndex) + + codeLastLine.text.substring(suffixIndex + suffix.length), + ); + + final int deletion; + + if (prefixIndex + this.prefix.length >= selection.extentOffset) { + deletion = this.prefix.length; + } else { + deletion = prefix.length; + } + + baseOffset = min( + selection.baseOffset, + newCodeLines[baseIndex].text.length, + ); + extentOffset = selection.extentOffset - deletion; + } + + return value.copyWith( + codeLines: newCodeLines, + selection: selection.copyWith( + baseOffset: baseOffset, + extentOffset: extentOffset, + ), + ); + } + + CodeLineEditingValue _commentSelectedCodeLines( + CodeLineEditingValue value, + String indent, + String prefix, + String suffix, + ) { + final CodeLineSelection selection = value.selection; + final CodeLines codeLines = value.codeLines; + final CodeLines newCodeLines = CodeLines.from(codeLines); + + final int baseIndex = selection.baseIndex; + final int extentIndex = selection.extentIndex; + + final CodeLine codeFirstLine; + final CodeLine codeLastLine; + + if (extentIndex >= baseIndex) { + codeFirstLine = codeLines[baseIndex]; + codeLastLine = codeLines[extentIndex]; + + newCodeLines[baseIndex] = codeFirstLine.copyWith( + text: codeFirstLine.text.insert(prefix, selection.baseOffset), + ); + + newCodeLines[extentIndex] = codeLastLine.copyWith( + text: codeLastLine.text.insert(suffix, selection.extentOffset), + ); + } else { + codeFirstLine = codeLines[extentIndex]; + codeLastLine = codeLines[baseIndex]; + + newCodeLines[extentIndex] = codeFirstLine.copyWith( + text: codeFirstLine.text.insert(prefix, selection.extentOffset), + ); + + newCodeLines[baseIndex] = codeLastLine.copyWith( + text: codeLastLine.text.insert(suffix, selection.baseOffset), + ); + } + + final int baseOffset; + final int extentOffset; + + if (extentIndex >= baseIndex) { + baseOffset = selection.baseOffset + prefix.length; + extentOffset = selection.extentOffset; + } else { + baseOffset = selection.baseOffset; + extentOffset = selection.extentOffset + suffix.length; + } + + return value.copyWith( + codeLines: newCodeLines, + selection: selection.copyWith( + baseOffset: baseOffset, + extentOffset: extentOffset, + ), + ); + } + + int _getIndexOfPrefix( + String text, + int baseIndex, + ) { + int index = -1; + int prefixLength = prefix.length - 1; + int suffixLength = suffix.length - 1; + + if (baseIndex >= text.length - 1) { + return index; + } + + for (int i = baseIndex; i > 0; i--) { + if (text[i] == suffix[suffixLength]) { + if (text.substring(i - suffixLength, i + 1) == suffix) { + break; + } + } + + if (text[i] == prefix[prefixLength]) { + if (text.substring(i - prefixLength, i + 1) == prefix) { + index = i - 1; + break; + } + } + } + + return index; + } + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/_code_highlight.dart b/packages/re_editor/lib/src/_code_highlight.dart new file mode 100644 index 0000000..6c6af79 --- /dev/null +++ b/packages/re_editor/lib/src/_code_highlight.dart @@ -0,0 +1,337 @@ +part of re_editor; + +class _CodeHighlighter extends ValueNotifier> { + + final BuildContext _context; + final _CodeParagraphProvider _provider; + final _CodeHighlightEngine _engine; + + CodeLineEditingController _controller; + CodeHighlightTheme? _theme; + + _CodeHighlighter({ + required BuildContext context, + required CodeLineEditingController controller, + CodeHighlightTheme? theme, + }) : _context = context, + _provider = _CodeParagraphProvider(), + _controller = controller, + _theme = theme, + _engine = _CodeHighlightEngine(theme), + super(const []) { + _controller.addListener(_onCodesChanged); + _processHighlight(); + } + + set controller(CodeLineEditingController value) { + if (_controller == value) { + return; + } + _controller.removeListener(_onCodesChanged); + _controller = value; + _controller.addListener(_onCodesChanged); + _processHighlight(); + } + + set theme(CodeHighlightTheme? value) { + if (_theme == value) { + return; + } + _theme = value; + _engine.theme = value; + _processHighlight(); + } + + IParagraph build({ + required int index, + required TextStyle style, + required double maxWidth, + int? maxLengthSingleLineRendering, + }) { + _provider.updateBaseStyle(style); + _provider.updateMaxLengthSingleLineRendering(maxLengthSingleLineRendering); + return _provider.build(_controller.buildTextSpan( + context: _context, + index: index, + textSpan: _buildSpan(index, style), + style: style + ), maxWidth); + } + + void clearCache() { + _provider.clearCache(); + } + + @override + void dispose() { + _controller.removeListener(_onCodesChanged); + _engine.dispose(); + super.dispose(); + } + + TextSpan _buildSpan(int index, TextStyle style) { + final String text = _controller.codeLines[index].text; + if (index >= value.length) { + return TextSpan( + text: text, + style: style + ); + } + final _HighlightResult result = value[index]; + if (result.nodes.isEmpty) { + return TextSpan( + text: text, + style: style + ); + } + if (result.source == text) { + return _buildSpanFromNodes(result.nodes, style); + } + // Diff the changes and reuse node to avoid style blink. + final List<_HighlightNode> startNodes = []; + int start = 0; + int end = text.length; + for (int i = 0; i < result.nodes.length && start < end; i++) { + final String value = result.nodes[i].value; + if (text.startsWith(value, start)) { + startNodes.add(result.nodes[i]); + start += value.length; + } else { + break; + } + } + final List<_HighlightNode> endNodes = []; + for (int i = result.nodes.length - 1; i >= 0 && start < end; i--) { + final String value = result.nodes[i].value; + if (text.substring(start, end).endsWith(value)) { + endNodes.insert(0, result.nodes[i]); + end -= value.length; + } else { + break; + } + } + final _HighlightNode? midNode; + if (startNodes.isEmpty) { + midNode = _HighlightNode(text.substring(start, end), result.nodes[0].className); + } else if (startNodes.length < result.nodes.length) { + midNode = _HighlightNode(text.substring(start, end), result.nodes[startNodes.length].className); + } else if (end > start){ + midNode = _HighlightNode(text.substring(start, end), result.nodes.last.className); + } else { + midNode = null; + } + return _buildSpanFromNodes([ + ...startNodes, + if (midNode != null) + midNode, + ...endNodes + ], style); + } + + TextSpan _buildSpanFromNodes(List<_HighlightNode> nodes, TextStyle baseStyle) { + return TextSpan( + children: nodes.map((e) => TextSpan( + text: e.value, + style: _findStyle(e.className) + )).toList(), + style: baseStyle + ); + } + + TextStyle? _findStyle(String? className) { + if (className == null) { + return null; + } + while(true) { + final TextStyle? style = _theme?.theme[className]; + if (style != null) { + return style; + } + final int pieceIndex = className!.indexOf('-'); + if (pieceIndex < 0) { + break; + } + className = className.substring(pieceIndex + 1); + if (className.isEmpty) { + break; + } + } + return null; + } + + void _onCodesChanged() { + if (_controller.preValue?.codeLines == _controller.codeLines) { + return; + } + _processHighlight(); + } + + void _processHighlight() { + _engine.run(_controller.codeLines, (result) => value = result); + } + +} + +class _CodeHighlightEngine { + + late final _IsolateTasker<_HighlightPayload, List<_HighlightResult>> _tasker; + + Highlight? _highlight; + CodeHighlightTheme? _theme; + + _CodeHighlightEngine(final CodeHighlightTheme? theme) { + this.theme = theme; + _tasker = _IsolateTasker<_HighlightPayload, List<_HighlightResult>>('CodeHighlightEngine', _run); + } + + set theme(CodeHighlightTheme? value) { + if (_theme == value) { + return; + } + _theme = value; + final Map? modes = _theme?.languages; + if (modes == null) { + _highlight = null; + } else { + final Highlight highlight = Highlight(); + highlight.registerLanguages(modes.map((key, value) => MapEntry(key, value.mode))); + for (final HLPlugin plugin in _theme!.plugins) { + highlight.addPlugin(plugin); + } + _highlight = highlight; + } + } + + void dispose() { + _tasker.close(); + } + + void run(CodeLines codes, IsolateCallback> callback) { + final Highlight? highlight = _highlight; + if (highlight == null) { + callback(const []); + return; + } + final Map? modes = _theme?.languages; + if (modes == null) { + callback(const []); + return; + } + _tasker.run(_HighlightPayload( + highlight: highlight, + codes: codes, + languages: modes.keys.toList(), + maxSizes: modes.values.map((e) => e.maxSize).toList(), + maxLineLengths: modes.values.map((e) => e.maxLineLength).toList(), + ), callback); + } + + @pragma('vm:entry-point') + static List<_HighlightResult> _run(_HighlightPayload payload) { + final CodeLines codeLines = payload.codes; + final int maxSize = payload.maxSizes.reduce(min); + final int maxLineLength = payload.maxLineLengths.reduce(min); + // Evalaute performance + bool canHighlight = true; + int total = 0; + for (int i = 0; i < codeLines.length; i++) { + final int length = codeLines[i].length; + if (length > maxLineLength || total > maxSize) { + canHighlight = false; + break; + } + total += length; + } + final String code = payload.codes.asString(TextLineBreak.lf, false); + final HighlightResult result; + if (!canHighlight) { + result = payload.highlight.justTextHighlightResult(code); + } else if (payload.languages.length == 1) { + result = payload.highlight.highlight(code: code, language: payload.languages.first); + } else { + result = payload.highlight.highlightAuto(code, payload.languages); + } + final _HighlightLineRenderer renderer = _HighlightLineRenderer(); + result.render(renderer); + return renderer.lineResults; + } + +} + +class _HighlightPayload { + + final Highlight highlight; + final CodeLines codes; + final List languages; + final List maxSizes; + final List maxLineLengths; + + const _HighlightPayload({ + required this.highlight, + required this.codes, + required this.languages, + required this.maxSizes, + required this.maxLineLengths, + }); + +} + +class _HighlightResult { + final List<_HighlightNode> nodes; + + _HighlightResult(this.nodes); + + String get source => nodes.map((e) => e.value).join(); +} + +class _HighlightNode { + + final String? className; + final String value; + + const _HighlightNode(this.value, [this.className]); +} + +class _HighlightLineRenderer implements HighlightRenderer { + + final List<_HighlightResult> lineResults; + final List classNames; + _HighlightLineRenderer(): lineResults = [ + _HighlightResult([]) + ], classNames = []; + + @override + void addText(String text) { + final String? className = classNames.isEmpty ? null : classNames.last; + final List lines = text.split(TextLineBreak.lf.value); + lineResults.last.nodes.add(_HighlightNode(lines.first, className)); + if (lines.length > 1) { + for (int i = 1; i < lines.length; i++) { + lineResults.add(_HighlightResult([_HighlightNode(lines[i], className)])); + } + } + } + + @override + void openNode(DataNode node) { + final String? className = classNames.isEmpty ? null : classNames.last; + String? newClassName; + if (className == null || node.scope == null) { + newClassName = node.scope; + } else { + newClassName = '$className-${node.scope!}'; + } + newClassName = newClassName?.split('.')[0]; + classNames.add(newClassName); + } + + + @override + void closeNode(DataNode node) { + if (classNames.isNotEmpty) { + classNames.removeLast(); + } + } + +} + diff --git a/packages/re_editor/lib/src/_code_indicator.dart b/packages/re_editor/lib/src/_code_indicator.dart new file mode 100644 index 0000000..4393f41 --- /dev/null +++ b/packages/re_editor/lib/src/_code_indicator.dart @@ -0,0 +1,373 @@ +part of re_editor; + +class CodeLineNumberRenderObject extends RenderBox { + + CodeLineEditingController _controller; + CodeIndicatorValueNotifier _notifier; + TextStyle _textStyle; + TextStyle _focusedTextStyle; + int _minNumberCount; + int _allLineCount; + + final String Function(int lineIndex)? _customLineIndex2Text; + final TextPainter _textPainter; + + CodeLineNumberRenderObject({ + required CodeLineEditingController controller, + required CodeIndicatorValueNotifier notifier, + required TextStyle textStyle, + required TextStyle focusedTextStyle, + required int minNumberCount, + String Function(int lineIndex)? custonLineIndex2Text, + }) : _controller = controller, + _notifier = notifier, + _textStyle = textStyle, + _focusedTextStyle = focusedTextStyle, + _minNumberCount = minNumberCount, + _allLineCount = controller.lineCount, + _customLineIndex2Text = custonLineIndex2Text, + _textPainter = TextPainter( + textDirection: TextDirection.ltr, + ); + + set controller(CodeLineEditingController value) { + if (_controller == value) { + return; + } + if (attached) { + _controller.removeListener(_onCodeLineChanged); + } + _controller = value; + if (attached) { + _controller.addListener(_onCodeLineChanged); + } + _onCodeLineChanged(); + } + + set notifier(CodeIndicatorValueNotifier value) { + if (_notifier == value) { + return; + } + if (attached) { + _notifier.removeListener(markNeedsPaint); + } + _notifier = value; + if (attached) { + _notifier.addListener(markNeedsPaint); + } + markNeedsPaint(); + } + + set textStyle(TextStyle value) { + if (_textStyle == value) { + return; + } + _textStyle = value; + markNeedsLayout(); + } + + set focusedTextStyle(TextStyle value) { + if (_focusedTextStyle == value) { + return; + } + _focusedTextStyle = value; + markNeedsLayout(); + } + + set minNumberCount(int value) { + if (_minNumberCount == value) { + return; + } + _minNumberCount = value; + markNeedsLayout(); + } + + @override + bool hitTestSelf(Offset position) => true; + + @override + void handleEvent(PointerEvent event, BoxHitTestEntry entry) { + if (event is PointerDownEvent) { + final Offset position = globalToLocal(event.position); + final CodeLineRenderParagraph? paragraph = _findParagraphByPosition(position); + if (paragraph != null) { + _controller.selectLine(paragraph.index); + } + } + super.handleEvent(event, entry); + } + + @override + void attach(covariant PipelineOwner owner) { + _controller.addListener(_onCodeLineChanged); + _notifier.addListener(markNeedsPaint); + super.attach(owner); + } + + @override + void detach() { + _controller.removeListener(_onCodeLineChanged); + _notifier.removeListener(markNeedsPaint); + super.detach(); + } + + @override + void performLayout() { + assert(constraints.maxHeight > 0 && constraints.maxHeight != double.infinity, + 'CodeLineNumber should have an explicit height.'); + _textPainter.text = TextSpan( + text: '0' * max(_minNumberCount, _allLineCount.toString().length), + style: _textStyle, + ); + _textPainter.layout(); + size = Size(_textPainter.width, constraints.maxHeight); + } + + @override + void paint(PaintingContext context, Offset offset) { + final Canvas canvas = context.canvas; + final CodeIndicatorValue? value = _notifier.value; + if (value == null || value.paragraphs.isEmpty) { + // line offsets are not determined. + return; + } + canvas.save(); + canvas.clipRect(Rect.fromLTWH(offset.dx, offset.dy, size.width, size.height)); + int firstLineIndex = _controller.index2lineIndex(value.paragraphs.first.index); + for (final CodeLineRenderParagraph paragraph in value.paragraphs) { + final lineIndexText = _customLineIndex2Text?.call(firstLineIndex) ?? (firstLineIndex + 1).toString(); + _textPainter.text = TextSpan( + text: lineIndexText, + style: paragraph.index == value.focusedIndex ? _focusedTextStyle : _textStyle + ); + _textPainter.layout(); + _textPainter.paint(canvas, Offset(offset.dx + size.width - _textPainter.width, offset.dy + paragraph.offset.dy)); + firstLineIndex += _controller.codeLines[paragraph.index].lineCount; + } + canvas.restore(); + } + + void _onCodeLineChanged() { + if (!attached) { + return; + } + final int newAllLineCount = _controller.lineCount; + if (max(_minNumberCount, newAllLineCount.toString().length) != + max(_minNumberCount, _allLineCount.toString().length)) { + _allLineCount = newAllLineCount; + markNeedsLayout(); + } else { + _allLineCount = newAllLineCount; + markNeedsPaint(); + } + } + + CodeLineRenderParagraph? _findParagraphByPosition(Offset position) { + final int? index = _notifier.value?.paragraphs.indexWhere((e) => position.dy > e.top + && position.dy < e.bottom); + if (index == null || index < 0) { + return null; + } + return _notifier.value?.paragraphs[index]; + } + +} + +class CodeChunkIndicatorRenderObject extends RenderBox implements MouseTrackerAnnotation { + + double _width; + CodeChunkController _controller; + CodeIndicatorValueNotifier _notifier; + CodeChunkIndicatorPainter _painter; + bool _collapseIndicatorVisible; + bool _expandIndicatorVisible; + MouseCursor _cursor; + + CodeChunkIndicatorRenderObject({ + required double width, + required CodeChunkController controller, + required CodeIndicatorValueNotifier notifier, + required CodeChunkIndicatorPainter painter, + required bool collapseIndicatorVisible, + required bool expandIndicatorVisible, + }) : _width = width, + _controller = controller, + _notifier = notifier, + _painter = painter, + _collapseIndicatorVisible = collapseIndicatorVisible, + _expandIndicatorVisible = expandIndicatorVisible, + _cursor = MouseCursor.defer; + + set width(double value) { + if (_width == value) { + return; + } + _width = value; + markNeedsLayout(); + } + + set controller(CodeChunkController value) { + if (_controller == value) { + return; + } + if (attached) { + _controller.removeListener(markNeedsPaint); + } + _controller = value; + if (attached) { + _controller.addListener(markNeedsPaint); + } + markNeedsPaint(); + } + + set notifier(CodeIndicatorValueNotifier value) { + if (_notifier == value) { + return; + } + if (attached) { + _notifier.removeListener(markNeedsPaint); + } + _notifier = value; + if (attached) { + _notifier.addListener(markNeedsPaint); + } + markNeedsPaint(); + } + + set painter(CodeChunkIndicatorPainter value) { + if (_painter == value) { + return; + } + _painter = value; + markNeedsPaint(); + } + + set collapseIndicatorVisible(bool value) { + if (_collapseIndicatorVisible == value) { + return; + } + _collapseIndicatorVisible = value; + markNeedsPaint(); + } + + set expandIndicatorVisible(bool value) { + if (_expandIndicatorVisible == value) { + return; + } + _expandIndicatorVisible = value; + markNeedsPaint(); + } + + @override + MouseCursor get cursor => _cursor; + + @override + PointerEnterEventListener? get onEnter => null; + + @override + PointerExitEventListener? get onExit => null; + + @override + bool get validForMouseTracker => true; + + @override + bool hitTest(BoxHitTestResult result, {required ui.Offset position}) { + bool hitTarget = false; + if (size.contains(position)) { + result.add(BoxHitTestEntry(this, position)); + if (_findParagraphByPosition(position) != null) { + _cursor = SystemMouseCursors.click; + } else { + _cursor = MouseCursor.defer; + } + hitTarget = true; + } + return hitTarget; + } + + @override + void handleEvent(PointerEvent event, BoxHitTestEntry entry) { + if (event is PointerDownEvent) { + final Offset position = globalToLocal(event.position); + final CodeLineRenderParagraph? paragraph = _findParagraphByPosition(position); + if (paragraph != null) { + _controller.toggle(paragraph.index); + } + } + super.handleEvent(event, entry); + } + + @override + void attach(covariant PipelineOwner owner) { + _controller.addListener(markNeedsPaint); + _notifier.addListener(markNeedsPaint); + super.attach(owner); + } + + @override + void detach() { + _controller.removeListener(markNeedsPaint); + _notifier.removeListener(markNeedsPaint); + super.detach(); + } + + @override + void performLayout() { + assert(_width > 0 && _width != double.infinity && + constraints.maxHeight > 0 && constraints.maxHeight != double.infinity, + 'CodeChunkIndicator should have an explicit width and height.'); + size = Size(_width, constraints.maxHeight); + } + + @override + void paint(PaintingContext context, Offset offset) { + final Canvas canvas = context.canvas; + final CodeIndicatorValue? value = _notifier.value; + if (value == null) { + // line offsets are not determined. + return; + } + if (!_expandIndicatorVisible && !_collapseIndicatorVisible) { + return; + } + canvas.save(); + canvas.clipRect(Rect.fromLTWH(offset.dx, offset.dy, size.width, size.height)); + for (final CodeLineRenderParagraph paragraph in value.paragraphs) { + final Offset newOffset = offset + Offset(0, paragraph.offset.dy); + final Size container = Size(_width, paragraph.preferredLineHeight); + if (paragraph.chunkParent) { + if (_expandIndicatorVisible) { + canvas.save(); + canvas.translate(newOffset.dx, newOffset.dy); + _painter.paintExpandIndicator(canvas, container); + canvas.restore(); + } + } else if (_controller.canCollapse(paragraph.index)) { + if (_collapseIndicatorVisible) { + canvas.save(); + canvas.translate(newOffset.dx, newOffset.dy); + _painter.paintCollapseIndicator(canvas, container); + canvas.restore(); + } + } + } + canvas.restore(); + } + + CodeLineRenderParagraph? _findParagraphByPosition(Offset position) { + final int? index = _notifier.value?.paragraphs.indexWhere((e) => position.dy > e.top + && position.dy < e.top + e.preferredLineHeight); + if (index == null || index < 0) { + return null; + } + final CodeLineRenderParagraph? paragraph = _notifier.value?.paragraphs[index]; + if (paragraph == null) { + return null; + } + if (paragraph.chunkParent || _controller.findByIndex(paragraph.index) != null) { + return paragraph; + } + return null; + } + +} diff --git a/packages/re_editor/lib/src/_code_input.dart b/packages/re_editor/lib/src/_code_input.dart new file mode 100644 index 0000000..5b74002 --- /dev/null +++ b/packages/re_editor/lib/src/_code_input.dart @@ -0,0 +1,756 @@ +part of re_editor; + +class _CodeInputController extends ChangeNotifier implements DeltaTextInputClient { + + CodeLineEditingController _controller; + FocusNode _focusNode; + bool _readOnly; + bool _autocompleteSymbols; + bool _updateCausedByFloatingCursor; + late Offset _floatingCursorStartingOffset; + + TextInputConnection? _textInputConnection; + TextEditingValue? _remoteEditingValue; + + final _CodeFloatingCursorController _floatingCursorController; + Timer? _floatingCursorScrollTimer; + + GlobalKey? _editorKey; + + _CodeInputController({ + required CodeLineEditingController controller, + required _CodeFloatingCursorController floatingCursorController, + required FocusNode focusNode, + required bool readOnly, + required bool autocompleteSymbols, + }) : _controller = controller, + _floatingCursorController = floatingCursorController, + _focusNode = focusNode, + _readOnly = readOnly, + _updateCausedByFloatingCursor = false, + _autocompleteSymbols = autocompleteSymbols { + _controller.addListener(_onCodeEditingChanged); + _focusNode.addListener(_onFocusChanged); + } + + void bindEditor(GlobalKey key) { + _editorKey = key; + } + + set controller(CodeLineEditingController value) { + if (_controller == value) { + return; + } + _controller.removeListener(_onCodeEditingChanged); + _controller = value; + _controller.addListener(_onCodeEditingChanged); + _onCodeEditingChanged(); + } + + set focusNode(FocusNode value) { + if (_focusNode == value) { + return; + } + _focusNode.removeListener(_onFocusChanged); + _focusNode = value; + _focusNode.addListener(_onFocusChanged); + } + + set readOnly(bool value) { + if (_readOnly == value) { + return; + } + _readOnly = value; + } + + set autocompleteSymbols(bool value) { + if (_autocompleteSymbols == value) { + return; + } + _autocompleteSymbols = value; + } + + set value(CodeLineEditingValue value) { + _controller.value = value; + } + + CodeLineEditingValue get value => _controller.value; + + set codeLines(CodeLines value) { + _controller.codeLines = value.isEmpty ? _kInitialCodeLines : value; + } + + CodeLines get codeLines => _controller.codeLines; + + set selection(CodeLineSelection value) => _controller.selection = value; + + CodeLineSelection get selection => _controller.selection; + + set composing(TextRange value) => _controller.composing = value; + + TextRange get composing => _controller.composing; + + @override + void connectionClosed() { + } + + @override + AutofillScope? get currentAutofillScope => null; + + @override + TextEditingValue? get currentTextEditingValue => _buildTextEditingValue(); + + @override + void performAction(TextInputAction action) { + if (action == TextInputAction.newline) { + // Fix issue #42, iOS will insert duplicate new lines. + // We only do this on Android. + if (kIsAndroid) { + _controller.applyNewLine(); + } + } + } + + @override + void performPrivateCommand(String action, Map data) { + } + + @override + void showAutocorrectionPromptRect(int start, int end) { + } + + @override + void showToolbar() { + } + + @override + void insertTextPlaceholder(Size size) { + } + + @override + void removeTextPlaceholder() { + } + + @override + void updateEditingValueWithDeltas(List textEditingDeltas) { + if (_updateCausedByFloatingCursor) { + // This is necessary because otherwise the content of the line where the floating cursor was started + // will be pasted over to the line where the floating cursor was stopped. + _updateCausedByFloatingCursor = false; + return; + } + + if (textEditingDeltas.any((delta) => delta is TextEditingDeltaInsertion && delta.textInserted == '\n')) { + TextEditingValue newValue = _remoteEditingValue!; + for (final TextEditingDelta delta in textEditingDeltas) { + newValue = delta.apply(newValue); + } + _remoteEditingValue = newValue; + _controller.applyNewLine(); + return; + } + + // _Trace.begin('updateEditingValue all'); + TextEditingValue newValue = _remoteEditingValue!; + bool smartChange = false; + for (final TextEditingDelta delta in textEditingDeltas) { + if (_autocompleteSymbols) { + TextEditingDelta newDelta = _SmartTextEditingDelta(delta).apply(selection); + if (newDelta != delta) { + smartChange = true; + } + newValue = newDelta.apply(newValue); + } else { + newValue = delta.apply(newValue); + } + } + if (newValue == _remoteEditingValue) { + return; + } + if (!smartChange) { + _remoteEditingValue = newValue; + } + // print('update text ${newValue.text}'); + // print('update selection ${newValue.selection}'); + // print('update composing ${newValue.composing}'); + if (newValue.usePrefix) { + if (newValue.selection.isCollapsed && newValue.selection.start == 0) { + _controller.deleteBackward(); + } else { + _controller.edit(newValue.removePrefixIfNecessary()); + } + } else { + _controller.edit(newValue); + } + notifyListeners(); + // _Trace.end('updateEditingValue all'); + } + + @override + void updateEditingValue(TextEditingValue textEditingValue) { + } + + @override + void updateFloatingCursor(RawFloatingCursorPoint point) { + _updateCausedByFloatingCursor = true; + final _CodeFieldRender? render = _editorKey?.currentContext?.findRenderObject() as _CodeFieldRender?; + if (render == null) { + return; + } + switch(point.state) { + case FloatingCursorDragState.Start: + _floatingCursorStartingOffset = render.calculateTextPositionViewportOffset(selection.base)!; + _floatingCursorController.setFloatingCursorPositions( + floatingCursorOffset: _floatingCursorStartingOffset, + finalCursorSelection: selection, + ); + break; + case FloatingCursorDragState.Update: + final Offset updatedOffset = _floatingCursorStartingOffset + point.offset!; + + final double topBound = render.paintBounds.top + render.paddingTop; + final double leftBound = render.paintBounds.left + render.paddingLeft; + final double bottomBound = render.paintBounds.bottom - render.paddingBottom - render.floatingCursorHeight; + final double rightBound = render.paintBounds.right - render.paddingRight; + + // Clamp the offset coordinates to the paint bounds + Offset clampedUpdatedOffset = Offset( + updatedOffset.dx.clamp(leftBound, rightBound), + updatedOffset.dy.clamp(topBound, bottomBound), + ); + + // An adjustment is made on the y-axis so that whenever it is in between lines, the line where the center + // of the floating cursor is will be selected. + Offset adjustedClampedUpdatedOffset = clampedUpdatedOffset + Offset(0, render.floatingCursorHeight / 2); + final CodeLinePosition newPosition = render.calculateTextPosition(adjustedClampedUpdatedOffset)!; + + // The offset at which the actual cursor would end up if floating cursor was terminated now. + final Offset? snappedNewOffset = render.calculateTextPositionViewportOffset(newPosition); + + CodeLineSelection newSelection = CodeLineSelection.fromPosition(position: newPosition); + + + if (clampedUpdatedOffset != updatedOffset) { + // When the cursor is at one of the edges, adjust the starting offset so that the floating cursor + // does not get "loose" when starting to move in the opposite direction. + _floatingCursorStartingOffset += clampedUpdatedOffset - updatedOffset; + } + + if (clampedUpdatedOffset.dy == topBound || clampedUpdatedOffset.dy == bottomBound || clampedUpdatedOffset.dx == rightBound || clampedUpdatedOffset.dx == leftBound) { + _floatingCursorScrollTimer ??= Timer.periodic(const Duration(milliseconds: 50), (timer) { + render.autoScrollWhenDraggingFloatingCursor(clampedUpdatedOffset); + final CodeLinePosition newPos = render.calculateTextPosition(adjustedClampedUpdatedOffset)!; + final Offset? snappedNewOffset = render.calculateTextPositionViewportOffset(newPos); + + // This step ensures that the preview cursor will keep updating when scrolling + if (adjustedClampedUpdatedOffset.dx > snappedNewOffset!.dx + render.textStyle.fontSize!) { + _floatingCursorController.updatePreviewCursorOffset(snappedNewOffset); + } + else { + _floatingCursorController.updatePreviewCursorOffset(null); + } + }); + } + else { + if (_floatingCursorScrollTimer != null) { + _floatingCursorScrollTimer!.cancel(); + _floatingCursorScrollTimer = null; + } + } + + // Only turn on the preview cursor if we are away from the end of the line (relatively to the font size) + if (adjustedClampedUpdatedOffset.dx > snappedNewOffset!.dx + render.textStyle.fontSize!) { + _floatingCursorController.setFloatingCursorPositions( + floatingCursorOffset: clampedUpdatedOffset, + previewCursorOffset: snappedNewOffset, + finalCursorOffset: snappedNewOffset, + finalCursorSelection:newSelection + ); + } + else { + _floatingCursorController.setFloatingCursorPositions( + floatingCursorOffset: clampedUpdatedOffset, + finalCursorOffset: snappedNewOffset, + finalCursorSelection: newSelection + ); + } + + break; + case FloatingCursorDragState.End: + if (_floatingCursorScrollTimer != null) { + _floatingCursorScrollTimer!.cancel(); + _floatingCursorScrollTimer = null; + } + selection = _floatingCursorController.value.finalCursorSelection!; + final CodeLinePosition finalPosition = CodeLinePosition( + index: selection.baseIndex, + offset: selection.baseOffset, + affinity: selection.baseAffinity); + + final Offset? finalOffset = render.calculateTextPositionViewportOffset(finalPosition); + + // If the final selection is in not the viewport, make it visible without animating the floating cursor. + // Otherwise, play the floating cursor reset animation. + if (finalOffset != null && (finalOffset.dx < 0 || finalOffset.dy < 0)) { + render.makePositionCenterIfInvisible( + CodeLinePosition( + index: selection.baseIndex, + offset: selection.baseOffset, + affinity: selection.baseAffinity), + animated: true); + _floatingCursorController.disableFloatingCursor(); + } + else { + _floatingCursorController.animateDisableFloatingCursor(); + } + + + } + } + + @override + void didChangeInputControl(TextInputControl? oldControl, TextInputControl? newControl) { + } + + @override + void performSelector(String selectorName) { + } + + @override + void insertContent(KeyboardInsertedContent content) { + } + + bool onFocusReceived() => false; + + void ensureInput() { + if (_focusNode.hasFocus) { + if (!_readOnly) { + _openInputConnection(); + } + } else { + _focusNode.requestFocus(); + } + } + + @override + void notifyListeners() { + // Do nothing here. + super.notifyListeners(); + } + + @override + void dispose() { + super.dispose(); + _closeInputConnectionIfNeeded(); + _controller.removeListener(_onCodeEditingChanged); + _focusNode.removeListener(_onFocusChanged); + } + + bool get _hasInputConnection => _textInputConnection?.attached ?? false; + + void _onCodeEditingChanged() { + _updateRemoteEditingValueIfNeeded(); + _updateRemoteComposingIfNeeded(); + } + + void _updateRemoteEditingValueIfNeeded() { + if (!_hasInputConnection) { + return; + } + TextEditingValue localValue = _buildTextEditingValue(); + if (localValue == _remoteEditingValue) { + return; + } + if (localValue.composing.isValid && max(localValue.composing.start, localValue.composing.end) > localValue.text.length) { + localValue = localValue.copyWith( + composing: TextRange.empty + ); + } + // print('post text ${localValue.text}'); + // print('post selection ${localValue.selection}'); + // print('post composing ${localValue.composing}'); + _remoteEditingValue = localValue; + + _textInputConnection!.setEditingState(localValue); + } + + void _updateRemoteComposingIfNeeded({ + bool retry = false + }) { + if (!_hasInputConnection) { + return; + } + final _CodeFieldRender? render = _editorKey?.currentContext?.findRenderObject() as _CodeFieldRender?; + if (render == null) { + return; + } + final Offset? composingStart = render.calculateTextPositionViewportOffset(selection.base.copyWith( + offset: _remoteEditingValue?.composing.start + )); + final Offset? composingEnd = render.calculateTextPositionViewportOffset(selection.extent.copyWith( + offset: _remoteEditingValue?.composing.end + )); + if (composingStart != null && composingEnd != null) { + _textInputConnection!.setComposingRect(Rect.fromPoints(composingStart, composingEnd + Offset(0, render.lineHeight))); + } + final Offset? caret = render.calculateTextPositionViewportOffset(selection.base) ?? composingStart; + if (caret != null) { + _textInputConnection!.setCaretRect(Rect.fromLTWH(caret.dx, caret.dy, render.cursorWidth, render.lineHeight)); + } else if (!retry) { + Future.delayed(const Duration(milliseconds: 10), () { + _updateRemoteComposingIfNeeded( + retry: true + ); + }); + } + } + + void _updateRemoteEditableSizeAndTransform() { + if (!_hasInputConnection) { + return; + } + final _CodeFieldRender? render = _editorKey?.currentContext?.findRenderObject() as _CodeFieldRender?; + if (render == null || !render.hasSize) { + return; + } + _textInputConnection!.setEditableSizeAndTransform(render.size, render.getTransformTo(null)); + } + + void _onFocusChanged() { + _openOrCloseInputConnectionIfNeeded(); + } + + void _openOrCloseInputConnectionIfNeeded() { + if (_focusNode.hasFocus && !_readOnly) { + if (_focusNode.consumeKeyboardToken()) { + _openInputConnection(); + } + } else { + _closeInputConnectionIfNeeded(); + _controller.clearComposing(); + } + } + + void _openInputConnection() { + final BuildContext? context = _editorKey?.currentContext; + if (context == null) { + return; + } + if (!_hasInputConnection) { + // Fix PlatformException issue on new flutter version. + // See https://github.com/reqable/re-editor/issues/83 + final TextInputConnection connection = TextInput.attach(this, + _TextInputConfiguration( + flutterViewId: View.maybeOf(context)?.viewId ?? 0, + enableDeltaModel: true, + inputAction: TextInputAction.newline, + autocorrect: false, + smartDashesType: SmartDashesType.disabled, + smartQuotesType: SmartQuotesType.disabled, + textCapitalization: TextCapitalization.none, + keyboardAppearance: Theme.of(context).brightness, + ), + ); + _remoteEditingValue = _buildTextEditingValue(); + connection.setEditingState(_remoteEditingValue!); + connection.show(); + _textInputConnection = connection; + } else { + _textInputConnection?.show(); + } + _updateRemoteComposingIfNeeded(); + _updateRemoteEditableSizeAndTransform(); + } + + void _closeInputConnectionIfNeeded() { + if (_hasInputConnection) { + _textInputConnection!.close(); + } + _textInputConnection = null; + } + + TextEditingValue _buildTextEditingValue() { + final TextSelection textSelection; + if (selection.isSameLine) { + textSelection = TextSelection( + baseOffset: selection.baseOffset, + extentOffset: selection.extentOffset + ); + } else { + if (selection.baseIndex < selection.extentIndex) { + textSelection = TextSelection( + baseOffset: selection.baseOffset, + extentOffset: codeLines[selection.baseIndex].length + ); + } else { + textSelection = TextSelection( + baseOffset: 0, + extentOffset: selection.baseOffset + ); + } + } + return TextEditingValue( + text: codeLines[selection.baseIndex].text, + selection: textSelection, + composing: composing + ).appendPrefixIfNecessary(); + } + +} + +class _SmartTextEditingDelta { + + static const List<_ClosureSymbol> _closureSymbols = [ + _ClosureSymbol('{', '}'), + _ClosureSymbol('[', ']'), + _ClosureSymbol('(', ')'), + ]; + + static const List _quoteSymbols = [ + '\'', '"', '`' + ]; + + static const List<_ClosureSymbol> _wrapSymbols = [ + _ClosureSymbol('{', '}'), + _ClosureSymbol('[', ']'), + _ClosureSymbol('(', ')'), + _ClosureSymbol('\'', '\''), + _ClosureSymbol('"', '"'), + _ClosureSymbol('`', '`'), + ]; + + final TextEditingDelta _delta; + + _SmartTextEditingDelta(this._delta); + + TextEditingDelta apply(CodeLineSelection selection) { + TextEditingDelta delta = _delta; + if (delta is TextEditingDeltaInsertion) { + delta = _smartInsertion(delta); + } else if (delta is TextEditingDeltaReplacement) { + delta = _smartReplacement(delta, selection); + } + return delta; + } + + TextEditingDelta _smartInsertion(TextEditingDeltaInsertion delta) { + for (final _ClosureSymbol symbol in _closureSymbols) { + if (delta.textInserted == symbol.left) { + if (!_shouldAutoClosed(delta.oldText, delta.insertionOffset, symbol)) { + break; + } + return TextEditingDeltaInsertion( + oldText: delta.oldText, + textInserted: symbol.toString(), + insertionOffset: delta.insertionOffset, + selection: delta.selection, + composing: delta.composing, + ); + } else if (delta.textInserted == symbol.right) { + if (!_shouldSkipClosed(delta.oldText, delta.insertionOffset, symbol)) { + break; + } + return TextEditingDeltaNonTextUpdate( + oldText: delta.oldText, + selection: TextSelection.collapsed( + offset: delta.insertionOffset + 1 + ), + composing: delta.composing + ); + } + } + for (final String symbol in _quoteSymbols) { + if (delta.textInserted != symbol) { + continue; + } + if (!_shouldAutoQuoted(delta.oldText, symbol, delta.insertionOffset)) { + break; + } + return TextEditingDeltaInsertion( + oldText: delta.oldText, + textInserted: symbol * 2, + insertionOffset: delta.insertionOffset, + selection: delta.selection, + composing: delta.composing, + ); + } + return delta; + } + + TextEditingDelta _smartReplacement(TextEditingDeltaReplacement delta, CodeLineSelection selection) { + if (!selection.isSameLine) { + return delta; + } + if (delta.replacementText.length > 1) { + return delta; + } + final int index = _wrapSymbols.indexWhere((element) => element.left == delta.replacementText); + if (index < 0) { + return delta; + } + final _ClosureSymbol symbol = _wrapSymbols[index]; + return TextEditingDeltaReplacement( + oldText: delta.oldText, + replacementText: symbol.left + delta.textReplaced + symbol.right, + replacedRange: delta.replacedRange, + selection: TextSelection( + baseOffset: selection.startOffset + 1, + extentOffset: selection.endOffset + 1 + ), + composing: delta.composing + ); + } + + bool _shouldAutoClosed(String text, int offset, _ClosureSymbol symbol) { + final Characters characters = text.characters; + if (characters.isEmpty) { + return true; + } + int leftSymbolCount = 0; + int rightSymbolCount = 0; + for (int i = 0; i < characters.length; i++) { + final String character = characters.elementAt(i); + if (i <= offset) { + if (character == symbol.left) { + leftSymbolCount++; + } else if (character == symbol.right) { + leftSymbolCount--; + } + } else { + if (character == symbol.left) { + rightSymbolCount--; + } else if (character == symbol.right) { + rightSymbolCount++; + } + } + } + return max(0, leftSymbolCount) >= rightSymbolCount; + } + + bool _shouldSkipClosed(String text, int offset, _ClosureSymbol symbol) { + if (text.isEmpty) { + return false; + } + if (offset == text.length) { + return false; + } + return text.substring(offset, offset + 1) == symbol.right; + } + + bool _shouldAutoQuoted(String text, String symbol, int offset) { + final Characters characters = text.characters; + if (characters.isEmpty) { + return true; + } + int leftSymbolCount = 0; + int rightSymbolCount = 0; + for (int i = 0; i < characters.length; i++) { + final String character = characters.elementAt(i); + if (i < offset) { + if (character == symbol) { + leftSymbolCount++; + } + } else { + if (character == symbol) { + rightSymbolCount++; + } + } + } + if (leftSymbolCount == 0 && rightSymbolCount == 0) { + return true; + } + if (rightSymbolCount == 0) { + return leftSymbolCount % 2 == 0; + } + if (leftSymbolCount == 0) { + return rightSymbolCount % 2 == 0; + } + return leftSymbolCount % 2 == rightSymbolCount % 2; + } + +} + +class _ClosureSymbol { + final String left; + final String right; + + const _ClosureSymbol(this.left, this.right); + + @override + String toString() { + return left + right; + } + +} + +const String _kPrefix = '\u200b'; + +extension _TextEditingValueExtension on TextEditingValue { + + bool get startWithPrefix => text.startsWith(_kPrefix); + + bool get usePrefix => kIsIOS || kIsAndroid; + + TextEditingValue appendPrefixIfNecessary() { + if (!usePrefix) { + return this; + } + return copyWith( + text: '$_kPrefix$text', + selection: selection.copyWith( + baseOffset: selection.baseOffset + 1, + extentOffset: selection.extentOffset + 1, + ), + composing: composing.isValid ? TextRange( + start: composing.start + 1, + end: composing.end + 1 + ) : composing + ); + } + + TextEditingValue removePrefixIfNecessary() { + if (!usePrefix) { + return this; + } + if (!startWithPrefix) { + return this; + } + return copyWith( + text: text.substring(1), + selection: selection.copyWith( + baseOffset: max(0, selection.baseOffset - 1), + extentOffset: max(0, selection.extentOffset - 1), + ), + composing: composing.isValid ? TextRange( + start: max(0, composing.start - 1), + end: max(0, composing.end - 1) + ) : null + ); + } + +} + +class _TextInputConfiguration extends TextInputConfiguration { + + final int flutterViewId; + + const _TextInputConfiguration({ + required this.flutterViewId, + required super.enableDeltaModel, + required super.inputAction, + super.autocorrect = false, + super.smartDashesType = SmartDashesType.disabled, + super.smartQuotesType = SmartQuotesType.disabled, + super.textCapitalization = TextCapitalization.none, + super.keyboardAppearance, + }); + + @override + Map toJson() { + return { + ...super.toJson(), + 'viewId': flutterViewId, + }; + } + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/_code_line.dart b/packages/re_editor/lib/src/_code_line.dart new file mode 100644 index 0000000..1ad82d6 --- /dev/null +++ b/packages/re_editor/lib/src/_code_line.dart @@ -0,0 +1,2504 @@ +part of re_editor; + +const CodeLines _kInitialCodeLines = CodeLines([ + CodeLineSegment(codeLines: [ + CodeLine.empty + ]) +]); + +const int _kUnitCodeWhitespace = 0x20; +const List _kClosures = ['{}', '[]', '()']; +const List _kClosureAndQuates = ['{}', '[]', '()', '\'\'', '""', '``']; + +class _CodeLineEditingControllerImpl extends ValueNotifier implements CodeLineEditingController { + + @override + final CodeLineOptions options; + final CodeLineSpanBuilder? spanBuilder; + late final _CodeLineEditingCache _cache; + late int _preEditLineIndex; + CodeLineEditingValue? _preValue; + GlobalKey? _editorKey; + + _CodeLineEditingControllerImpl({ + required CodeLines codeLines, + required this.options, + this.spanBuilder, + }) : super(CodeLineEditingValue(codeLines: codeLines)) { + _cache = _CodeLineEditingCache(this); + _preEditLineIndex = -1; + } + + factory _CodeLineEditingControllerImpl.fromText(String? text, [ + CodeLineOptions options = const CodeLineOptions() + ]) { + return _CodeLineEditingControllerImpl( + codeLines: text?.codeLines ?? _kInitialCodeLines, + options: options + ); + } + + factory _CodeLineEditingControllerImpl.fromTextAsync(String? text, [ + CodeLineOptions options = const CodeLineOptions() + ]) { + final _CodeLineEditingControllerImpl controller = _CodeLineEditingControllerImpl( + codeLines: _kInitialCodeLines, + options: options + ); + if (text != null && text.isNotEmpty) { + text.codeLinesAsync.then((value) => controller.codeLines = value); + } + return controller; + } + + @override + set value(CodeLineEditingValue value) { + _preValue = super.value; + super.value = value; + } + + @override + set codeLines(CodeLines newCodeLines) { + value = value.copyWith( + codeLines: newCodeLines.isEmpty ? _kInitialCodeLines : newCodeLines + ); + } + + @override + set selection(CodeLineSelection newSelection) { + value = value.copyWith( + selection: newSelection + ); + } + + @override + set composing(TextRange newComposing) { + value = value.copyWith( + composing: newComposing + ); + } + + TextLineBreak get lineBreak => options.lineBreak; + + String get indent => options.indent; + + @override + CodeLineEditingValue? get preValue => _preValue; + + @override + CodeLines get codeLines => value.codeLines; + + @override + CodeLineSelection get selection => value.selection; + + @override + TextRange get composing => value.composing; + + @override + CodeLine get baseLine => codeLines[selection.baseIndex]; + + @override + CodeLine get extentLine => codeLines[selection.extentIndex]; + + @override + CodeLine get startLine => codeLines[selection.startIndex]; + + @override + CodeLine get endLine => codeLines[selection.endIndex]; + + @override + bool get isComposing => composing.end > composing.start; + + @override + String get text => codeLines.asString(lineBreak); + + @override + String get selectedText { + final StringBuffer sb = StringBuffer(); + if (selection.isSameLine) { + sb.write(startLine.substring(selection.startOffset, selection.endOffset)); + } else { + for (int i = selection.startIndex; i <= selection.endIndex; i++) { + final CodeLine codeLine = codeLines[i]; + if (i == selection.startIndex) { + if (codeLine.chunkParent) { + sb.write(codeLine.asString(selection.startOffset, lineBreak)); + } else { + sb.write(codeLine.substring(selection.startOffset)); + } + } else if (i == selection.endIndex) { + sb.write(codeLine.substring(0, selection.endOffset)); + } else { + sb.write(codeLine.asString(0, lineBreak)); + } + if (i < selection.endIndex) { + sb.write(lineBreak.value); + } + } + } + return sb.toString(); + } + + @override + int get lineCount => codeLines.lineCount; + + @override + CodeLineSelection get unfoldLineSelection { + final int baseRawIndex; + final int extentRawIndex; + if (selection.isSameLine) { + baseRawIndex = extentRawIndex = index2lineIndex(selection.baseIndex); + } else { + baseRawIndex = index2lineIndex(selection.baseIndex); + extentRawIndex = index2lineIndex(selection.extentIndex); + } + return selection.copyWith( + baseIndex: baseRawIndex, + extentIndex: extentRawIndex + ); + } + + @override + bool get isEmpty => codeLines == _kInitialCodeLines; + + @override + bool get isAllSelected => selection.start.index == 0 && selection.start.offset == 0 && + selection.end.index == codeLines.length - 1 && selection.end.offset == codeLines.last.length; + + @override + bool get canUndo => _cache.canUndo; + + @override + bool get canRedo => _cache.canRedo; + + @override + set text(String value) { + runRevocableOp(() { + this.value = CodeLineEditingValue( + codeLines: value.codeLines + ); + }); + } + + @override + set textAsync(String value) { + value.codeLinesAsync.then((value) { + runRevocableOp(() { + this.value = CodeLineEditingValue( + codeLines: value + ); + }); + }).onError((error, stackTrace) { + // Should not happen + }); + } + + @override + void bindEditor(GlobalKey key) { + _editorKey = key; + } + + @override + void edit(TextEditingValue newValue) { + if (newValue.text.isMultiline) { + final String replacement; + final String beforeText = _codeTextBefore(selection.start); + final String endText = _codeTextAfter(selection.end); + if (beforeText.isNotEmpty && !newValue.text.startsWith(beforeText)) { + replacement = newValue.text; + } else if (endText.isNotEmpty && !newValue.text.endsWith(endText)) { + replacement = newValue.text; + } else { + replacement = newValue.text.substring(beforeText.length, newValue.text.length - endText.length); + } + _replaceRange(replacement); + return; + } + final CodeLines newCodeLines; + final TextSelection newSelection; + final TextRange newComposing; + // FIXME: large list operation is very very slow + if (selection.isSameLine) { + if (startLine.text == newValue.text) { + newCodeLines = codeLines; + } else { + newCodeLines = CodeLines.from(codeLines); + newCodeLines[selection.startIndex] = startLine.copyWith( + text: newValue.text + ); + } + newSelection = newValue.selection; + newComposing = newValue.composing; + } else if (selection.baseIndex < selection.extentIndex) { + newCodeLines = codeLines.sublines(0, selection.startIndex); + newCodeLines.add(endLine.copyWith( + text: newValue.text + endLine.substring(selection.endOffset) + )); + if (selection.endIndex + 1 < codeLines.length) { + newCodeLines.addFrom(codeLines, selection.endIndex + 1); + } + newSelection = newValue.selection; + newComposing = newValue.composing; + } else { + newCodeLines = codeLines.sublines(0, selection.startIndex); + newCodeLines.add(endLine.copyWith( + text: startLine.substring(0, selection.startOffset) + newValue.text + )); + if (selection.endIndex + 1 < codeLines.length) { + newCodeLines.addFrom(codeLines, selection.endIndex + 1); + } + newSelection = TextSelection.collapsed( + offset: selection.startOffset + newValue.selection.baseOffset + ); + if (newValue.composing.isValid) { + newComposing = TextRange( + start: selection.startOffset + newValue.composing.start, + end: selection.startOffset + newValue.composing.end, + ); + } else { + newComposing = newValue.composing; + } + } + if (_preEditLineIndex != selection.extentIndex) { + _preEditLineIndex = selection.extentIndex; + _cache.markNewRecord(true); + } + value = value.copyWith( + codeLines: newCodeLines, + selection: CodeLineSelection.fromTextSelection( + index: selection.startIndex, + selection: newSelection, + ), + composing: newComposing + ); + _cache.markNewRecord(false); + makeCursorCenterIfInvisible(); + } + + @override + void selectLine(int index) { + selectLines(index, index); + } + + @override + void selectLines(int base, int extent) { + final int start = min(base, extent); + final int end = max(base, extent); + if (start < 0 || end >= codeLines.length) { + return; + } + selection = selection.copyWith( + baseIndex: base, + baseOffset: base > extent ? codeLines[end].length : 0, + extentIndex: extent, + extentOffset: base > extent ? 0 : codeLines[end].length, + ); + makeCursorCenterIfInvisible(); + } + + @override + void selectAll() { + selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: codeLines.length - 1, + extentOffset: codeLines.last.length + ); + } + + @override + void cancelSelection() { + if (!selection.isCollapsed) { + selection = CodeLineSelection.fromPosition( + position: selection.extent + ); + makeCursorCenterIfInvisible(); + } + } + + @override + void moveSelectionLinesUp() { + runRevocableOp(_moveSelectionLinesUp); + } + + @override + void moveSelectionLinesDown() { + runRevocableOp(_moveSelectionLinesDown); + } + + @override + void moveCursor(AxisDirection direction) { + switch (direction) { + case AxisDirection.left: + if (!selection.isCollapsed) { + selection = CodeLineSelection.fromPosition( + position: selection.start + ); + } else if (selection.extentIndex != 0 || selection.extentOffset != 0) { + if (selection.baseAffinity != selection.extentAffinity) { + selection = selection.copyWith( + baseAffinity: TextAffinity.upstream, + extentAffinity: TextAffinity.upstream + ); + } else { + final int index; + final int offset; + if (selection.extentOffset == 0) { + index = selection.extentIndex - 1; + offset = codeLines[index].length; + } else { + index = selection.extentIndex; + // Skip 1 character to left + offset = codeLines[index].substring(0, selection.extentOffset).characters.skipLast(1).string.length; + } + selection = CodeLineSelection.collapsed( + index: index, + offset: offset, + affinity: TextAffinity.downstream, + ); + } + } + break; + case AxisDirection.right: + if (!selection.isCollapsed) { + selection = CodeLineSelection.fromPosition( + position: selection.end + ); + } else if (selection.extentIndex != codeLines.length - 1 || selection.extentOffset != codeLines.last.length) { + if (selection.baseAffinity != selection.extentAffinity) { + selection = selection.copyWith( + baseAffinity: TextAffinity.downstream, + extentAffinity: TextAffinity.downstream + ); + } else { + final int index; + final int offset; + if (selection.extentOffset == extentLine.length){ + index = selection.extentIndex + 1; + offset = 0; + } else { + index = selection.extentIndex; + // Skip 1 character to right + offset = selection.extentOffset + codeLines[index].substring(selection.extentOffset).characters.first.length; + } + selection = CodeLineSelection.collapsed( + index: index, + offset: offset, + affinity: TextAffinity.upstream, + ); + } + } + break; + case AxisDirection.up: + final CodeLinePosition? position = _render?.getUpPosition(selection.start); + if (position != null) { + selection = CodeLineSelection.fromPosition( + position: position + ); + } else { + final CodeLinePosition current = selection.start; + if (current.index == 0) { + selection = const CodeLineSelection.collapsed( + index: 0, + offset: 0 + ); + } else { + selection = CodeLineSelection.collapsed( + index: current.index - 1, + offset: min(codeLines[current.index - 1].length, current.offset) + ); + } + } + break; + case AxisDirection.down: + final CodeLinePosition? position = _render?.getDownPosition(selection.start); + if (position != null) { + selection = CodeLineSelection.fromPosition( + position: position + ); + } else { + final CodeLinePosition current = selection.end; + if (current.index == codeLines.length - 1) { + selection = CodeLineSelection.collapsed( + index: codeLines.length - 1, + offset: codeLines.last.length + ); + } else { + selection = CodeLineSelection.collapsed( + index: current.index + 1, + offset: min(codeLines[current.index + 1].length, current.offset) + ); + } + } + break; + } + makeCursorVisible(); + } + + @override + void moveCursorToLineStart() { + final String current = extentLine.text; + final int prefixWhitespaceCount = _prefixWhitespaceCount(current); + final int offset; + if (selection.extentOffset == 0) { + offset = prefixWhitespaceCount; + } else { + if (selection.extentOffset == prefixWhitespaceCount) { + offset = 0; + } else { + offset = prefixWhitespaceCount; + } + } + selection = CodeLineSelection.collapsed( + index: selection.extentIndex, + offset: offset + ); + makeCursorVisible(); + } + + @override + void moveCursorToLineEnd() { + selection = CodeLineSelection.collapsed( + index: selection.extentIndex, + offset: extentLine.length + ); + makeCursorVisible(); + } + + @override + void moveCursorToPageStart() { + selection = const CodeLineSelection.collapsed( + index: 0, + offset: 0 + ); + makeCursorVisible(); + } + + @override + void moveCursorToPageEnd() { + selection = CodeLineSelection.collapsed( + index: codeLines.length - 1, + offset: codeLines.last.length + ); + makeCursorVisible(); + } + + @override + void moveCursorToPageUp() { + // TODO + } + + @override + void moveCursorToPageDown() { + // TODO + } + + @override + void moveCursorToWordBoundaryBackward() { + if (selection.extentOffset == 0) { + final int newIndex = selection.extentIndex - 1; + + if (newIndex < 0) { + return; + } + + selection = CodeLineSelection.collapsed( + index: newIndex, + offset: codeLines[newIndex].length, + ); + makeCursorVisible(); + } + + final String current = extentLine.text; + + if (current.isEmpty) { + return; + } + + int offset = selection.extentOffset - 1; + + while (offset > 0) { + if (current.codeUnitAt(offset) == _kUnitCodeWhitespace) { + offset--; + } else { + break; + } + } + + final int codeUnit = current.codeUnitAt(offset); + bool isBeforeAlphanumeric = _isAlphanumeric(codeUnit); + int i = offset - 1; + + while (i > 0) { + bool isCurrentAlphanumeric = _isAlphanumeric(current.codeUnitAt(i)); + + if (isBeforeAlphanumeric != isCurrentAlphanumeric) { + break; + } + + isBeforeAlphanumeric = isCurrentAlphanumeric; + i--; + } + + if (i <= 0) { + i = 0; + } else { + i++; + } + + selection = CodeLineSelection.collapsed( + index: selection.extentIndex, + offset: i, + ); + makeCursorVisible(); + } + + @override + void moveCursorToWordBoundaryForward() { + if (selection.extentOffset == extentLine.text.length) { + final int newIndex = selection.extentIndex + 1; + + if (newIndex >= codeLines.length) { + return; + } + + selection = CodeLineSelection.collapsed( + index: newIndex, + offset: 0, + ); + makeCursorVisible(); + } + + final String current = extentLine.text; + + if (current.isEmpty) { + return; + } + + int offset = selection.extentOffset; + + while (offset < current.length) { + if (current.codeUnitAt(offset) == _kUnitCodeWhitespace) { + offset++; + } else { + break; + } + } + + final int codeUnit = current.codeUnitAt(offset); + bool isBeforeAlphanumeric = _isAlphanumeric(codeUnit); + int i = offset + 1; + + while (i < current.length) { + bool isCurrentAlphanumeric = _isAlphanumeric(current.codeUnitAt(i)); + + if (isBeforeAlphanumeric != isCurrentAlphanumeric) { + break; + } + + isBeforeAlphanumeric = isCurrentAlphanumeric; + i++; + } + + selection = CodeLineSelection.collapsed( + index: selection.extentIndex, + offset: i, + ); + makeCursorVisible(); + } + + @override + void extendSelection(AxisDirection direction) { + switch (direction) { + case AxisDirection.left: + if (selection.extentIndex != 0 || selection.extentOffset != 0) { + final int index; + final int offset; + if (selection.extentOffset == 0) { + index = selection.extentIndex - 1; + offset = codeLines[index].length; + } else { + index = selection.extentIndex; + final Characters characters = extentLine.substring(0, selection.extentOffset).characters; + offset = selection.extentOffset - characters.takeLast(1).first.length; + } + selection = selection.copyWith( + extentIndex: index, + extentOffset: offset, + extentAffinity: TextAffinity.downstream + ); + } + break; + case AxisDirection.right: + if (selection.extentIndex != codeLines.length - 1 || selection.extentOffset != codeLines.last.length) { + final int index; + final int offset; + if (selection.extentOffset == extentLine.length){ + index = selection.extentIndex + 1; + offset = 0; + } else { + final Characters characters = extentLine.substring(selection.extentOffset).characters; + index = selection.extentIndex; + offset = selection.extentOffset + characters.elementAt(0).length; + } + selection = selection.copyWith( + extentIndex: index, + extentOffset: offset, + extentAffinity: TextAffinity.upstream + ); + } + break; + case AxisDirection.up: + final CodeLinePosition? position = _render?.getUpPosition(selection.extent); + if (position != null) { + selection = selection.copyWith( + extentIndex: position.index, + extentOffset: position.offset, + extentAffinity: position.affinity + ); + } else { + final CodeLinePosition current = selection.extent; + if (current.index == 0) { + selection = selection.copyWith( + extentIndex: 0, + extentOffset: 0 + ); + } else { + selection = selection.copyWith( + extentIndex: current.index - 1, + extentOffset: min(codeLines[current.index - 1].length, current.offset) + ); + } + } + break; + case AxisDirection.down: + final CodeLinePosition? position = _render?.getDownPosition(selection.extent); + if (position != null) { + selection = selection.copyWith( + extentIndex: position.index, + extentOffset: position.offset, + extentAffinity: position.affinity + ); + } else { + final CodeLinePosition current = selection.extent; + if (current.index == codeLines.length - 1) { + selection = selection.copyWith( + extentIndex: codeLines.length - 1, + extentOffset: codeLines.last.length + ); + } else { + selection = selection.copyWith( + extentIndex: current.index + 1, + extentOffset: min(codeLines[current.index + 1].length, current.offset) + ); + } + } + break; + } + makeCursorVisible(); + } + + @override + void extendSelectionToLineStart() { + selection = selection.copyWith( + extentOffset: 0 + ); + makeCursorVisible(); + } + + @override + void extendSelectionToLineEnd() { + selection = selection.copyWith( + extentIndex: selection.extentIndex, + extentOffset: extentLine.length + ); + makeCursorVisible(); + } + + @override + void extendSelectionToPageStart() { + selection = selection.copyWith( + extentIndex: 0, + extentOffset: 0 + ); + makeCursorVisible(); + } + + @override + void extendSelectionToPageEnd() { + selection = selection.copyWith( + extentIndex: codeLines.length - 1, + extentOffset: codeLines.last.length + ); + makeCursorVisible(); + } + + @override + void extendSelectionToWordBoundaryForward() { + if (selection.extentOffset == 0) { + final int newIndex = selection.extentIndex - 1; + + if (newIndex < 0) { + return; + } + + selection = selection.copyWith( + extentIndex: newIndex, + extentOffset: codeLines[newIndex].length, + ); + makeCursorVisible(); + } + + final String current = extentLine.text; + + if (current.isEmpty) { + return; + } + + int offset = selection.extentOffset - 1; + + while (offset > 0) { + if (current.codeUnitAt(offset) == _kUnitCodeWhitespace) { + offset--; + } else { + break; + } + } + + final int codeUnit = current.codeUnitAt(offset); + bool isBeforeAlphanumeric = _isAlphanumeric(codeUnit); + int i = offset - 1; + + while (i > 0) { + bool isCurrentAlphanumeric = _isAlphanumeric(current.codeUnitAt(i)); + + if (isBeforeAlphanumeric != isCurrentAlphanumeric) { + break; + } + + isBeforeAlphanumeric = isCurrentAlphanumeric; + i--; + } + + if (i <= 0) { + i = 0; + } else { + i++; + } + + selection = selection.copyWith( + extentIndex: selection.extentIndex, + extentOffset: i, + ); + makeCursorVisible(); + } + + @override + void extendSelectionToWordBoundaryBackward() { + if (selection.extentOffset == extentLine.text.length) { + final int newIndex = selection.extentIndex + 1; + + if (newIndex >= codeLines.length) { + return; + } + + selection = selection.copyWith( + extentIndex: newIndex, + extentOffset: 0, + ); + makeCursorVisible(); + } + + final String current = extentLine.text; + + if (current.isEmpty) { + return; + } + + int offset = selection.extentOffset; + + while (offset < current.length) { + if (current.codeUnitAt(offset) == _kUnitCodeWhitespace) { + offset++; + } else { + break; + } + } + + final int codeUnit = current.codeUnitAt(offset); + bool isBeforeAlphanumeric = _isAlphanumeric(codeUnit); + int i = offset + 1; + + while (i < current.length) { + bool isCurrentAlphanumeric = _isAlphanumeric(current.codeUnitAt(i)); + + if (isBeforeAlphanumeric != isCurrentAlphanumeric) { + break; + } + + isBeforeAlphanumeric = isCurrentAlphanumeric; + i++; + } + + selection = selection.copyWith( + extentIndex: selection.extentIndex, + extentOffset: i, + ); + makeCursorVisible(); + } + + @override + void deleteLineForward() { + runRevocableOp(_deleteLineForward); + } + + @override + void deleteLineBackward() { + runRevocableOp(_deleteLineBackward); + } + + @override + void deleteSelectionLines([bool keepExtentOffset = true]) { + runRevocableOp(() { + _deleteSelectionLines(keepExtentOffset); + }); + } + + @override + void deleteSelection() { + runRevocableOp(_deleteSelection); + } + + @override + void deleteBackward() { + runRevocableOp(_deleteBackward); + } + + @override + void deleteForward() { + runRevocableOp(_deleteForward); + } + + @override + void deleteWordBackward() { + runRevocableOp(_deleteWordBackward); + } + + @override + void deleteWordForward() { + runRevocableOp(_deleteWordForward); + } + + @override + void applyNewLine() { + runRevocableOp(_applyNewLine); + } + + @override + void applyIndent() { + runRevocableOp(_applyIndent); + } + + @override + void applyOutdent() { + runRevocableOp(_applyOutdent); + } + + @override + void transposeCharacters() { + runRevocableOp(_transposeCharacters); + } + + @override + void replaceSelection(String replacement, [CodeLineSelection? range]) { + runRevocableOp(() { + _replaceRange(replacement, range); + }); + } + + @override + void replaceAll(Pattern pattern, String replacement) { + runRevocableOp(() { + _replaceAll(pattern, replacement); + }); + } + + @override + void undo() => _cache.undo(); + + @override + void redo() => _cache.redo(); + + @override + Future copy() { + if (selection.isCollapsed) { + return Clipboard.setData(ClipboardData(text: extentLine.text + lineBreak.value)); + } else { + return Clipboard.setData(ClipboardData(text: selectedText)); + } + } + + @override + void cut() { + copy(); + if (selection.isCollapsed) { + deleteSelectionLines(true); + } else { + deleteSelection(); + } + } + + @override + void paste() { + Clipboard.getData(Clipboard.kTextPlain).then((data) { + final String? text = data?.text; + if (text == null || text.isEmpty) { + return; + } + replaceSelection(text); + }); + } + + @override + void collapseChunk(int start, int end) { + if (start < 0 || start >= codeLines.length || end <= start + 1 || end > codeLines.length) { + return; + } + if (codeLines[start].chunkParent) { + return; + } + final CodeLines newCodeLines = codeLines.sublines(0, start); + newCodeLines.add(codeLines[start].copyWith( + chunks: codeLines.sublines(start + 1, end).toList() + )); + if (end < codeLines.length) { + newCodeLines.addFrom(codeLines, end); + } + final int newStartIndex; + final int newStartOffset; + if (selection.startIndex <= start) { + newStartIndex = selection.startIndex; + newStartOffset = selection.startOffset; + } else if (selection.startIndex < end) { + newStartIndex = start; + newStartOffset = codeLines[start].text.length; + } else { + newStartIndex = selection.startIndex - (end - start - 1); + newStartOffset = selection.startOffset; + } + final int newEndIndex; + final int newEndOffset; + if (selection.endIndex <= start) { + newEndIndex = selection.endIndex; + newEndOffset = selection.endOffset; + } else if (selection.endIndex < end) { + newEndIndex = start; + newEndOffset = codeLines[start].text.length; + } else { + newEndIndex = selection.endIndex - (end - start - 1); + newEndOffset = selection.endOffset; + } + final CodeLineSelection newSelection; + if (selection.baseIndex < selection.extentIndex) { + newSelection = selection.copyWith( + baseIndex: newStartIndex, + baseOffset: newStartOffset, + extentIndex: newEndIndex, + extentOffset: newEndOffset + ); + } else { + newSelection = selection.copyWith( + baseIndex: newEndIndex, + baseOffset: newEndOffset, + extentIndex: newStartIndex, + extentOffset: newStartOffset + ); + } + final TextRange newComposing; + if (selection.baseIndex > start && selection.baseIndex < end) { + newComposing = TextRange.empty; + } else { + newComposing = composing; + } + value = value.copyWith( + codeLines: newCodeLines, + selection: newSelection, + composing: newComposing + ); + } + + @override + void expandChunk(int index) { + if (!codeLines[index].chunkParent) { + return; + } + final CodeLines newCodeLines = codeLines.sublines(0, index); + newCodeLines.add(codeLines[index].copyWith( + chunks: const [] + )); + final List collapsedChunks = codeLines[index].chunks; + newCodeLines.addAll(collapsedChunks); + if (index + 1 < codeLines.length) { + newCodeLines.addFrom(codeLines, index + 1); + } + final CodeLineSelection newSelection; + if (selection.endIndex <= index) { + newSelection = selection; + } else if (selection.startIndex <= index) { + if (selection.baseIndex < selection.extentIndex) { + newSelection = selection.copyWith( + extentIndex: selection.extentIndex + collapsedChunks.length + ); + } else { + newSelection = selection.copyWith( + baseIndex: selection.baseIndex + collapsedChunks.length + ); + } + } else { + newSelection = selection.copyWith( + baseIndex: selection.baseIndex + collapsedChunks.length, + extentIndex: selection.extentIndex + collapsedChunks.length + ); + } + value = value.copyWith( + codeLines: newCodeLines, + selection: newSelection, + ); + } + + @override + void clearComposing() { + value = value.copyWith( + composing: TextRange.empty + ); + } + + @override + void clearHistory() { + _cache.clear(); + } + + @override + int index2lineIndex(int index) => codeLines.index2lineIndex(index); + + @override + CodeLineIndex lineIndex2Index(int lineIndex) => codeLines.lineIndex2Index(lineIndex); + + @override + void makeCursorCenterIfInvisible() { + _render?.makePositionCenterIfInvisible(selection.extent); + } + + @override + void makeCursorVisible() { + _render?.makePositionVisible(selection.extent); + } + + @override + void makePositionCenterIfInvisible(CodeLinePosition position) { + _render?.makePositionCenterIfInvisible(position); + } + + @override + void makePositionVisible(CodeLinePosition position) { + _render?.makePositionVisible(position); + } + + @override + void forceRepaint() { + _render?.forceRepaint(); + } + + @override + void runRevocableOp(VoidCallback op) { + _cache.markNewRecord(true); + op(); + _cache.markNewRecord(false); + } + + @override + void dispose() { + _editorKey = null; + _cache.dispose(); + super.dispose(); + } + + _CodeFieldRender? get _render => _editorKey?.currentContext?.findRenderObject() as _CodeFieldRender?; + + bool _isAlphanumeric(int codeUnit) { + return (codeUnit <= 57 && codeUnit >= 48) || + (codeUnit <= 90 && codeUnit >= 65) || + (codeUnit <= 122 && codeUnit >= 97); + } + + void _moveSelectionLinesUp() { + if (selection.startIndex == 0) { + return; + } + final CodeLines newCodeLines = CodeLines.from(codeLines); + final CodeLine tmp = codeLines[selection.startIndex - 1]; + for (int i = selection.startIndex; i <= selection.endIndex; i++) { + newCodeLines[i - 1] = newCodeLines[i]; + } + newCodeLines[selection.endIndex] = tmp; + value = value.copyWith( + codeLines: newCodeLines, + selection: selection.copyWith( + baseIndex: selection.baseIndex - 1, + extentIndex: selection.extentIndex - 1, + ) + ); + makeCursorCenterIfInvisible(); + } + + void _moveSelectionLinesDown() { + if (selection.endIndex == codeLines.length - 1) { + return; + } + final CodeLines newCodeLines = CodeLines.from(codeLines); + final CodeLine tmp = codeLines[selection.endIndex + 1]; + for (int i = selection.endIndex; i >= selection.startIndex; i--) { + newCodeLines[i + 1] = newCodeLines[i]; + } + newCodeLines[selection.startIndex] = tmp; + value = value.copyWith( + codeLines: newCodeLines, + selection: selection.copyWith( + baseIndex: selection.baseIndex + 1, + extentIndex: selection.extentIndex + 1, + ) + ); + makeCursorCenterIfInvisible(); + } + + void _deleteLineForward() { + if (!selection.isCollapsed) { + _deleteForward(); + return; + } + if (selection.extentOffset >= extentLine.length) { + _deleteForward(); + return; + } + final CodeLines newCodeLines = CodeLines.from(codeLines); + newCodeLines[selection.extentIndex] = extentLine.copyWith( + text: _codeTextBefore(selection.extent) + ); + value = value.copyWith( + codeLines: newCodeLines, + ); + makeCursorVisible(); + } + + void _deleteLineBackward() { + if (!selection.isCollapsed) { + _deleteBackward(); + return; + } + if (selection.extentOffset == 0) { + _deleteBackward(); + return; + } + final CodeLines newCodeLines = CodeLines.from(codeLines); + newCodeLines[selection.extentIndex] = extentLine.copyWith( + text: _codeTextAfter(selection.extent) + ); + value = value.copyWith( + codeLines: newCodeLines, + selection: CodeLineSelection.collapsed( + index: selection.extentIndex, + offset: 0, + ), + ); + makeCursorVisible(); + } + + void _deleteSelectionLines([bool keepExtentOffset = true]) { + if (codeLines.equals(_kInitialCodeLines)) { + return; + } + final CodeLines newCodeLines = codeLines.sublines(0, selection.startIndex); + if (selection.endIndex + 1 < codeLines.length) { + newCodeLines.addFrom(codeLines, selection.endIndex + 1); + } + if (newCodeLines.isEmpty) { + newCodeLines.add(CodeLine.empty); + } + final int index = min(selection.startIndex, newCodeLines.length - 1); + final int offset; + if (keepExtentOffset) { + offset = min(newCodeLines[index].length, selection.extentOffset); + } else { + offset = 0; + } + value = value.copyWith( + codeLines: newCodeLines, + selection: CodeLineSelection.collapsed( + index: index, + offset: offset + ), + ); + makeCursorCenterIfInvisible(); + } + + void _deleteSelection() { + if (selection.isCollapsed) { + return; + } + final CodeLines newCodeLines = codeLines.sublines(0, selection.startIndex); + final CodeLine after = _codeLineAfter(selection.end); + newCodeLines.add(after.copyWith( + text: _codeTextBefore(selection.start) + after.text, + )); + if (selection.endIndex + 1 < codeLines.length) { + newCodeLines.addFrom(codeLines, selection.endIndex + 1); + } + value = value.copyWith( + codeLines: newCodeLines, + selection: CodeLineSelection.collapsed( + index: selection.startIndex, + offset: selection.startOffset, + affinity: selection.start.affinity + ) + ); + makeCursorCenterIfInvisible(); + } + + void _deleteBackward() { + if (selection.isCollapsed) { + if (selection.baseIndex == 0 && selection.baseOffset == 0) { + // At the start position of page, nothing to delete + return; + } + if (selection.baseOffset == 0) { + // Delete this line and merge into the previous line + final CodeLines newCodeLines = codeLines.sublines(0, selection.baseIndex - 1); + final CodeLine preLine = codeLines[selection.baseIndex - 1]; + if (preLine.chunkParent) { + // Should expand this chunk + newCodeLines.add(CodeLine(preLine.text)); + newCodeLines.addAll(preLine.chunks.sublist(0, preLine.chunks.length - 1)); + newCodeLines.add(baseLine.copyWith( + text: preLine.chunks.last.text + baseLine.text + )); + if (selection.baseIndex + 1 < codeLines.length) { + newCodeLines.addFrom(codeLines, selection.baseIndex + 1); + } + value = value.copyWith( + codeLines: newCodeLines, + selection: CodeLineSelection.collapsed( + index: selection.baseIndex + preLine.chunks.length - 1, + offset: preLine.chunks.last.length, + ) + ); + } else { + newCodeLines.add(baseLine.copyWith( + text: preLine.text + baseLine.text + )); + if (selection.baseIndex + 1 < codeLines.length) { + newCodeLines.addFrom(codeLines, selection.baseIndex + 1); + } + value = value.copyWith( + codeLines: newCodeLines, + selection: CodeLineSelection.collapsed( + index: selection.baseIndex - 1, + offset: preLine.length, + ) + ); + } + } else { + final CodeLines newCodeLines = CodeLines.from(codeLines); + if (_isWrapedByClosureSymbol(baseLine.text, selection.baseOffset)) { + // Delete left and right closure symbols at same time, like this: + // abc{|}123 -> abc123 + newCodeLines[selection.baseIndex] = baseLine.copyWith( + text: baseLine.substring(0, selection.baseOffset - 1) + baseLine.substring(selection.baseOffset + 1) + ); + value = value.copyWith( + codeLines: newCodeLines, + selection: CodeLineSelection.collapsed( + index: selection.baseIndex, + offset: selection.baseOffset - 1 + ) + ); + } else { + String backward = _codeTextBefore(selection.base); + if (_isMultipleIndent(backward)) { + // Delete a indent + backward = backward.substring(indent.length, backward.length); + } else if (backward.isNotEmpty) { + // Delete the previous character normally + final Characters characters = backward.characters; + backward = characters.skipLast(1).string; + } + newCodeLines[selection.baseIndex] = baseLine.copyWith( + text: backward + baseLine.substring(selection.baseOffset) + ); + value = value.copyWith( + codeLines: newCodeLines, + selection: CodeLineSelection.collapsed( + index: selection.baseIndex, + offset: backward.length + ) + ); + } + } + } else { + _deleteSelection(); + } + makeCursorCenterIfInvisible(); + } + + void _deleteForward() { + if (selection.isCollapsed) { + if (selection.extentIndex == codeLines.length - 1 && selection.extentOffset == codeLines.last.length) { + // At the end position of page, nothing to delete + return; + } + if (selection.extentOffset == extentLine.length) { + // Delete next line and merge into the current line + final CodeLines newCodeLines = codeLines.sublines(0, selection.extentIndex); + if (extentLine.chunkParent) { + final CodeLine nextLine = extentLine.chunks.first; + // Should expand this chunk + newCodeLines.add(nextLine.copyWith( + text: extentLine.text + nextLine.text + )); + newCodeLines.addAll(extentLine.chunks.sublist(1)); + if (selection.extentIndex + 1 < codeLines.length) { + newCodeLines.addFrom(codeLines, selection.extentIndex + 1); + } + } else { + newCodeLines.add(codeLines[selection.extentIndex + 1].copyWith( + text: extentLine.text + codeLines[selection.extentIndex + 1].text + )); + if (selection.extentIndex + 2 < codeLines.length) { + newCodeLines.addFrom(codeLines, selection.extentIndex + 2); + } + } + value = value.copyWith( + codeLines: newCodeLines, + selection: CodeLineSelection.collapsed( + index: selection.extentIndex, + offset: extentLine.length, + ) + ); + } else { + final CodeLines newCodeLines = CodeLines.from(codeLines); + String forward = _codeTextAfter(selection.extent); + final int indentSizeInForward = _prefixWhitespaceCount(forward); + if (indentSizeInForward > 0 && indentSizeInForward % indent.length == 0) { + forward = forward.substring(indent.length); + } else { + // Delete the next character normally + final Characters characters = forward.characters; + forward = characters.skip(1).string; + } + newCodeLines[selection.extentIndex] = extentLine.copyWith( + text: _codeTextBefore(selection.extent) + forward + ); + value = value.copyWith( + codeLines: newCodeLines, + selection: CodeLineSelection.collapsed( + index: selection.extentIndex, + offset: selection.extentOffset + ) + ); + } + } else { + _deleteSelection(); + } + makeCursorCenterIfInvisible(); + } + + void _deleteWordBackward() { + if (!selection.isCollapsed) { + _deleteBackward(); + return; + } + if (selection.extentOffset == 0) { + _deleteBackward(); + return; + } + final String current = extentLine.text; + int offset = selection.extentOffset - 1; + while (offset > 0) { + if (current.codeUnitAt(offset) == _kUnitCodeWhitespace) { + offset--; + } else { + break; + } + } + final int codeUnit = current.codeUnitAt(offset); + bool isBeforeAlphanumeric = _isAlphanumeric(codeUnit); + int i = offset - 1; + while (i > 0) { + bool isCurrentAlphanumeric = _isAlphanumeric(current.codeUnitAt(i)); + if (isBeforeAlphanumeric != isCurrentAlphanumeric) { + break; + } + isBeforeAlphanumeric = isCurrentAlphanumeric; + i--; + } + if (i <= 0) { + i = 0; + } else { + i++; + } + final CodeLines newCodeLines = CodeLines.from(codeLines); + newCodeLines[selection.extentIndex] = extentLine.copyWith( + text: _codeTextBefore(selection.extent.copyWith( + offset: i + )) + _codeTextAfter(selection.extent) + ); + value = value.copyWith( + codeLines: newCodeLines, + selection: CodeLineSelection.collapsed( + index: selection.extentIndex, + offset: i, + ), + ); + makeCursorVisible(); + } + + void _deleteWordForward() { + if (!selection.isCollapsed) { + _deleteForward(); + return; + } + if (selection.extentOffset >= extentLine.length) { + _deleteForward(); + return; + } + final String current = extentLine.text; + if (current.isEmpty) { + return; + } + int offset = selection.extentOffset; + while (offset < current.length) { + if (current.codeUnitAt(offset) == _kUnitCodeWhitespace) { + offset++; + } else { + break; + } + } + final int codeUnit = current.codeUnitAt(offset); + bool isBeforeAlphanumeric = _isAlphanumeric(codeUnit); + int i = offset + 1; + while (i < current.length) { + bool isCurrentAlphanumeric = _isAlphanumeric(current.codeUnitAt(i)); + if (isBeforeAlphanumeric != isCurrentAlphanumeric) { + break; + } + isBeforeAlphanumeric = isCurrentAlphanumeric; + i++; + } + final CodeLines newCodeLines = CodeLines.from(codeLines); + newCodeLines[selection.extentIndex] = extentLine.copyWith( + text: _codeTextBefore(selection.extent) + _codeTextAfter(selection.extent.copyWith( + offset: i + )) + ); + value = value.copyWith( + codeLines: newCodeLines, + ); + makeCursorVisible(); + } + + void _applyNewLine() { + final CodeLines newCodeLines = codeLines.sublines(0, selection.startIndex); + final CodeLine before = _codeLineBefore(selection.start); + final CodeLine after = _codeLineAfter(selection.end); + newCodeLines.add(before); + final String alignIndent = before.substring(0, before.text.indentLength); + final int offset; + // If the enter tap in a closure, we should add a new code line inside the closure + // with an addtional indent. + // e.g. + // {|} => { + // | + // } + if (_selectionInClosure) { + newCodeLines.add(CodeLine(alignIndent + indent)); + offset = newCodeLines.last.length; + } else { + offset = alignIndent.length; + } + // Align the next line's intent with pre code line + newCodeLines.add(after.copyWith( + text: alignIndent + after.text + )); + if (selection.endIndex + 1 < codeLines.length) { + newCodeLines.addFrom(codeLines, selection.endIndex + 1); + } + value = value.copyWith( + codeLines: newCodeLines, + selection: CodeLineSelection.collapsed( + index: selection.startIndex + 1, + offset: offset + ), + ); + makeCursorCenterIfInvisible(); + } + + void _applyIndent() { + final CodeLines newCodeLines = CodeLines.from(codeLines); + if (selection.isSameLine) { + if (selection.isCollapsed || selection.startOffset != 0 || selection.endOffset != endLine.length) { + final String textBefore = _codeTextBefore(selection.start); + final int indentLength = indent.length - textBefore.length % indent.length; + newCodeLines[selection.extentIndex] = extentLine.copyWith( + text: textBefore + ' ' * indentLength + _codeTextAfter(selection.end) + ); + value = value.copyWith( + codeLines: newCodeLines, + selection: CodeLineSelection.collapsed( + index: selection.startIndex, + offset: selection.startOffset + indentLength + ) + ); + } else { + // This whole line is selected, just add the indent + newCodeLines[selection.extentIndex] = extentLine.copyWith( + text: _applyTextIndent(extentLine.text) + ); + value = value.copyWith( + codeLines: newCodeLines, + selection: selection.copyWith( + baseOffset: selection.baseOffset == 0 ? 0 : newCodeLines[selection.baseIndex].length, + extentOffset: selection.extentOffset == 0 ? 0 : newCodeLines[selection.extentIndex].length + ) + ); + } + } else { + for (int i = selection.startIndex; i <= selection.endIndex; i++) { + // Do not apply indent to the last line if the offset is 0 + if (i == selection.endIndex && selection.endOffset == 0) { + continue; + } + List chunks = codeLines[i].chunks; + if (chunks.isNotEmpty && i != selection.endIndex) { + // Apply indent to collapsed chunks + chunks = _applyIndents(chunks); + } + newCodeLines[i] = codeLines[i].copyWith( + text: _applyTextIndent(codeLines[i].text), + chunks: chunks + ); + } + value = value.copyWith( + codeLines: newCodeLines, + selection: selection.copyWith( + baseOffset: _whitespaceCountBefore(baseLine.text, selection.baseOffset) == selection.baseOffset ? + selection.baseOffset : selection.baseOffset + (newCodeLines[selection.baseIndex].length - baseLine.text.length), + extentOffset: _whitespaceCountBefore(extentLine.text, selection.extentOffset) == selection.extentOffset ? + selection.extentOffset : selection.extentOffset + (newCodeLines[selection.extentIndex].length - extentLine.text.length), + ) + ); + } + makeCursorCenterIfInvisible(); + } + + void _applyOutdent() { + final CodeLines newCodeLines; + if (selection.isSameLine) { + final CodeLine outdentCodeLine = extentLine.copyWith( + text: _applyTextOutdent(extentLine.text) + ); + if (outdentCodeLine == extentLine) { + // Nothing changed + return; + } + newCodeLines = CodeLines.from(codeLines); + newCodeLines[selection.extentIndex] = outdentCodeLine; + } else { + final CodeLines outdentCodeLines = CodeLines.of([]); + bool lastSkipped = false; + for (int i = selection.startIndex; i <= selection.endIndex; i++) { + // Do not apply outdent to the last line if the offset is 0 + if (i == selection.endIndex && selection.endOffset == 0) { + lastSkipped = true; + continue; + } + List chunks = codeLines[i].chunks; + if (chunks.isNotEmpty && i != selection.endIndex) { + // Apply indent to collapsed chunks + chunks = _applyOutdents(chunks); + } + outdentCodeLines.add(codeLines[i].copyWith( + text: _applyTextOutdent(codeLines[i].text), + chunks: chunks + )); + } + if (outdentCodeLines.equals(codeLines.sublines(selection.startIndex, lastSkipped ? selection.endIndex : selection.endIndex + 1))) { + // Nothing changed + return; + } + newCodeLines = CodeLines.from(codeLines); + for (int i = 0; i < outdentCodeLines.length; i++) { + newCodeLines[i + selection.startIndex] = outdentCodeLines[i]; + } + } + // If there are enough whitespace after the selection, we should keep the selection offset. + final int whitespaceCountAfterBaseLine = max(0, _prefixWhitespaceCount(baseLine.text) - selection.baseOffset); + final int baseOffset = max(0, selection.baseOffset - max(0, baseLine.length - newCodeLines[selection.baseIndex].length - whitespaceCountAfterBaseLine)); + final int whitespaceCountAfterExtentLine = max(0, _prefixWhitespaceCount(extentLine.text) - selection.extentOffset); + final int extentOffset = max(0, selection.extentOffset - max(0, extentLine.length - newCodeLines[selection.extentIndex].length - whitespaceCountAfterExtentLine)); + value = value.copyWith( + codeLines: newCodeLines, + selection: selection.copyWith( + baseOffset: baseOffset, + extentOffset: extentOffset, + ) + ); + makeCursorCenterIfInvisible(); + } + + void _transposeCharacters() { + if (!selection.isCollapsed) { + return; + } + if (selection.baseIndex == 0 && selection.baseOffset == 0) { + return; + } + if (selection.baseOffset == 0) { + final CodeLines newCodeLines; + final int newOffset; + final CodeLine preLine = codeLines[selection.baseIndex - 1]; + if (baseLine.length == 0) { + if (preLine.length == 0) { + return; + } + newCodeLines = CodeLines.from(codeLines); + final String take = preLine.takeLastCharacter(1); + newCodeLines[selection.baseIndex - 1] = preLine.copyWith( + text: preLine.skipLastCharacter(1) + ); + newCodeLines[selection.baseIndex] = baseLine.copyWith( + text: take + ); + newOffset = take.length; + } else { + newCodeLines = CodeLines.from(codeLines); + newCodeLines[selection.baseIndex - 1] = preLine.copyWith( + text: preLine.text + baseLine.takeCharacter(1) + ); + newCodeLines[selection.baseIndex] = baseLine.copyWith( + text: baseLine.skipCharacter(1) + ); + newOffset = 0; + } + value = value.copyWith( + codeLines: newCodeLines, + selection: selection.copyWith( + baseOffset: newOffset, + extentOffset: newOffset, + ) + ); + } else if (selection.baseOffset == baseLine.length && baseLine.characterLength == 1) { + if (selection.baseIndex == 0) { + return; + } + final CodeLine preLine = codeLines[selection.baseIndex - 1]; + final CodeLines newCodeLines = CodeLines.from(codeLines); + newCodeLines[selection.baseIndex - 1] = preLine.copyWith( + text: preLine.text + baseLine.text + ); + newCodeLines[selection.baseIndex] = baseLine.copyWith( + text: '' + ); + value = value.copyWith( + codeLines: newCodeLines, + selection: selection.copyWith( + baseOffset: 0, + extentOffset: 0, + ) + ); + } else if (selection.baseOffset == baseLine.length) { + final CodeLines newCodeLines = CodeLines.from(codeLines); + newCodeLines[selection.baseIndex] = baseLine.copyWith( + text: baseLine.skipLastCharacter(2) + + baseLine.takeCharacterAtLastIndex(0) + + baseLine.takeCharacterAtLastIndex(1) + ); + value = value.copyWith( + codeLines: newCodeLines, + ); + } else { + final CodeLines newCodeLines = CodeLines.from(codeLines); + final Characters characters = baseLine.text.characters; + final int index = baseLine.text.substring(0, selection.baseOffset).characters.length; + final String start = characters.take(index - 1).string; + final String right = characters.elementAt(index); + final String left = characters.elementAt(index - 1); + final String end = characters.takeLast(characters.length - index - 1).string; + newCodeLines[selection.baseIndex] = baseLine.copyWith( + text: start + right + left + end + ); + value = value.copyWith( + codeLines: newCodeLines, + selection: selection.copyWith( + baseOffset: selection.baseOffset + right.length, + extentOffset: selection.extentOffset + right.length, + ) + ); + } + } + + void _replaceRange(String replacement, [CodeLineSelection? range]) { + range ??= selection; + if (replacement.isEmpty && range.isCollapsed) { + return; + } + final List replaceCodeLines = replacement.textLines; + final CodeLines newCodeLines = codeLines.sublines(0, range.startIndex); + int index = 0; + int offset = 0; + if (replaceCodeLines.length == 1) { + newCodeLines.add(codeLines[range.endIndex].copyWith( + text: _codeTextBefore(range.start) + replaceCodeLines.first + _codeTextAfter(range.end) + )); + index = range.startIndex; + offset = range.startOffset + replaceCodeLines.first.length; + } else { + for (int i = 0; i < replaceCodeLines.length; i++) { + final String replaceCodeLine = replaceCodeLines[i]; + if (i == 0) { + newCodeLines.add(CodeLine(_codeTextBefore(range.start) + replaceCodeLine)); + } else if (i == replaceCodeLines.length - 1) { + newCodeLines.add(codeLines[range.endIndex].copyWith( + text: replaceCodeLine + _codeTextAfter(range.end) + )); + index = newCodeLines.length - 1; + offset = replaceCodeLine.length; + } else { + newCodeLines.add(CodeLine(replaceCodeLine)); + } + } + } + if (range.endIndex + 1 < codeLines.length) { + newCodeLines.addFrom(codeLines, range.endIndex + 1); + } + value = CodeLineEditingValue( + codeLines: newCodeLines, + selection: CodeLineSelection.collapsed( + index: index, + offset: offset, + affinity: range.extentAffinity + ) + ); + makeCursorCenterIfInvisible(); + } + + void _replaceAll(Pattern pattern, String replacement) { + if (pattern is String && pattern.isEmpty) { + return; + } + int extentOffset = selection.extentOffset; + for (int i = 0; i < selection.extentIndex; i++) { + extentOffset += codeLines[i].charCount + lineBreak.value.length; + } + final String preText = text; + int delta = 0; + final String newText = text.replaceAllMapped(pattern, (match) { + if (match.end <= extentOffset) { + delta += replacement.length - (match.end - match.start); + } + return replacement; + }); + if (preText == newText) { + return; + } + final CodeLines newCodeLines = newText.codeLines; + int newExtentIndex = 0; + int newExtentOffset = 0; + int start = 0; + extentOffset += delta; + final int length = newCodeLines.length; + for (int i = 0; i < length; i++) { + final int end = start + newCodeLines[i].charCount + lineBreak.value.length; + if (extentOffset >= start && extentOffset < end) { + newExtentIndex = i; + newExtentOffset = extentOffset - start; + break; + } + start = end; + } + value = CodeLineEditingValue( + codeLines: newCodeLines, + selection: CodeLineSelection.collapsed( + index: newExtentIndex, + offset: newExtentOffset + ) + ); + makeCursorCenterIfInvisible(); + } + + List _applyIndents(List children) { + if (children.isEmpty) { + return children; + } + final List newChildren = []; + for (final CodeLine codeLine in children) { + newChildren.add(CodeLine(_applyTextIndent(codeLine.text), _applyIndents(codeLine.chunks))); + } + return newChildren; + } + + List _applyOutdents(List children) { + if (children.isEmpty) { + return children; + } + final List newChildren = []; + for (final CodeLine codeLine in children) { + newChildren.add(CodeLine(_applyTextOutdent(codeLine.text), _applyOutdents(codeLine.chunks))); + } + return newChildren; + } + + String _applyTextIndent(String text) { + // Indent the mod count of whitespace + final int mod = _prefixWhitespaceCount(text) % indent.length; + return ' ' * (mod == 0 ? indent.length : mod) + text; + } + + String _applyTextOutdent(String text) { + final int index = _prefixWhitespaceCount(text); + if (index == 0) { + return text; + } + // Outdent the mod count of whitespace + final int mod = index % indent.length; + return text.substring(mod == 0 ? indent.length : mod); + } + + String _codeTextBefore(CodeLinePosition position) { + return codeLines[position.index].substring(0, position.offset); + } + + String _codeTextAfter(CodeLinePosition position) { + return codeLines[position.index].substring(position.offset); + } + + CodeLine _codeLineBefore(CodeLinePosition position) { + return CodeLine(_codeTextBefore(position)); + } + + CodeLine _codeLineAfter(CodeLinePosition position) { + return CodeLine(_codeTextAfter(position), codeLines[position.index].chunks); + } + + int _prefixWhitespaceCount(String text) { + int index = 0; + for (; index < text.length; index++) { + if (text.codeUnitAt(index) != _kUnitCodeWhitespace) { + break; + } + } + return index; + } + + int _whitespaceCountBefore(String text, int offset) { + int count = 0; + for (int i = offset - 1; i >= 0; i--) { + if (text.codeUnitAt(i) != _kUnitCodeWhitespace) { + break; + } + count++; + } + return count; + } + + bool _isWrapedByClosureSymbol(String text, int offset) { + if (text.isEmpty) { + return false; + } + if (offset - 1 < 0 || offset + 1 > text.length) { + return false; + } + return _kClosureAndQuates.contains(text.substring(offset - 1, offset + 1)); + } + + bool _isMultipleIndent(String text) => text.isNotEmpty && text.length % indent.length == 0 + && _prefixWhitespaceCount(text) == text.length; + + bool get _selectionInClosure { + int? forwardUnitCode; + for (int i = selection.startOffset - 1; i >= 0; i--) { + final int codeUnit = startLine.codeUnitAt(i); + if (codeUnit == _kUnitCodeWhitespace) { + continue; + } + forwardUnitCode = codeUnit; + break; + } + if (forwardUnitCode == null) { + return false; + } + int? backwardUnitCode; + for (int i = selection.endOffset; i < endLine.length; i++) { + final int codeUnit = endLine.codeUnitAt(i); + if (codeUnit == _kUnitCodeWhitespace) { + continue; + } + backwardUnitCode = codeUnit; + break; + } + if (backwardUnitCode == null) { + return false; + } + return _kClosures.contains(String.fromCharCodes([forwardUnitCode, backwardUnitCode])); + } + + @override + TextSpan buildTextSpan({ + required BuildContext context, + required int index, + required TextSpan textSpan, + required TextStyle style, + }) { + return spanBuilder?.call( + context: context, + index: index, + codeLine: codeLines[index], + textSpan: textSpan, + style: style + ) ?? textSpan; + } + +} + +class _CodeLineEditingCache { + + final CodeLineEditingController controller; + late _CodeLineEditingCacheNode _node; + late bool _markNewRecord; + + _CodeLineEditingCache(this.controller) { + controller.addListener(_onValueChanged); + _node = _CodeLineEditingCacheNode(controller.value); + _markNewRecord = false; + } + + bool get canUndo => _node.pre != null; + + bool get canRedo => _node.next != null; + + void undo() { + if (_node.pre != null) { + _node = _node.pre!; + controller.value = _node.value; + } + } + + void redo() { + if (_node.next != null) { + _node = _node.next!; + controller.value = _node.value; + } + } + + void clear() { + _node = _CodeLineEditingCacheNode(controller.value); + _markNewRecord = false; + } + + void dispose() { + controller.removeListener(_onValueChanged); + } + + void markNewRecord(bool flag) { + _markNewRecord = flag; + } + + void _onValueChanged() { + if (_node.value == controller.value) { + return; + } + if (_node.isInitial) { + _appendNewNode(); + return; + } + if (!_node.isTail) { + _appendNewNode(); + return; + } + if (_markNewRecord) { + _markNewRecord = false; + _appendNewNode(); + return; + } + _node.value = controller.value; + } + + void _appendNewNode() { + final _CodeLineEditingCacheNode newNode = _CodeLineEditingCacheNode(controller.value); + if (_node.next != null) { + _node.next!.pre = null; + } + _node.next = newNode; + newNode.pre = _node; + _node = newNode; + } + +} + +class _CodeLineEditingCacheNode { + + _CodeLineEditingCacheNode? pre; + _CodeLineEditingCacheNode? next; + CodeLineEditingValue value; + + _CodeLineEditingCacheNode(this.value); + + bool get isRoot => pre == null; + + bool get isInitial => pre == null && next == null; + + bool get isTail => next == null; + +} + +extension _StringExtension on String { + + int get indentLength { + int index = 0; + for (; index < length; index++) { + if (codeUnitAt(index) != _kUnitCodeWhitespace) { + break; + } + } + return index; + } + + int getOffsetWithoutIndent(String indent) { + int index = 0; + while (startsWith(indent, index)) { + index += indent.length; + } + return index; + } + + String insert(String value, int index) { + return substring(0, index) + value + substring(index); + } + +} + +class _CodeLineEditingControllerDelegate implements CodeLineEditingController { + + late CodeLineEditingController _delegate; + final List _listeners = []; + + CodeLineEditingController get delegate => _delegate; + + set delegate(CodeLineEditingController value) { + for (final listener in _listeners) { + value.addListener(listener); + } + _delegate = value; + notifyListeners(); + } + + @override + CodeLines get codeLines => _delegate.codeLines; + + @override + set codeLines(CodeLines value) { + _delegate.codeLines = value; + } + + @override + ui.TextRange get composing => _delegate.composing; + + @override + set composing(ui.TextRange value) { + _delegate.composing = value; + } + + @override + CodeLineSelection get selection => _delegate.selection; + + @override + set selection(CodeLineSelection value) { + _delegate.selection = value; + } + + @override + String get text => _delegate.text; + + @override + set text(String value) { + _delegate.text = value; + } + + @override + CodeLineEditingValue get value => _delegate.value; + + @override + set value(CodeLineEditingValue value) { + _delegate.value = value; + } + + @override + void addListener(ui.VoidCallback listener) { + _listeners.add(listener); + _delegate.addListener(listener); + } + + @override + void applyIndent() { + _delegate.applyIndent(); + } + + @override + void applyNewLine() { + _delegate.applyNewLine(); + } + + @override + void applyOutdent() { + _delegate.applyOutdent(); + } + + @override + CodeLine get baseLine => _delegate.baseLine; + + @override + void bindEditor(GlobalKey> key) { + _delegate.bindEditor(key); + } + + @override + TextSpan buildTextSpan({ + required BuildContext context, + required int index, + required TextSpan textSpan, + required TextStyle style, + }) { + return _delegate.buildTextSpan( + context: context, + index: index, + textSpan: textSpan, + style: style + ); + } + + @override + bool get canRedo => _delegate.canRedo; + + @override + bool get canUndo => _delegate.canUndo; + + @override + void cancelSelection() { + _delegate.cancelSelection(); + } + + @override + void clearComposing() { + _delegate.clearComposing(); + } + + @override + void clearHistory() { + _delegate.clearHistory(); + } + + @override + void collapseChunk(int index, int end) { + _delegate.collapseChunk(index, end); + } + + @override + Future copy() => _delegate.copy(); + + @override + void cut() { + _delegate.cut(); + } + + @override + void deleteBackward() { + _delegate.deleteBackward(); + } + + @override + void deleteForward() { + _delegate.deleteForward(); + } + + @override + void deleteWordBackward() { + _delegate.deleteWordBackward(); + } + + @override + void deleteWordForward() { + _delegate.deleteWordForward(); + } + + @override + void deleteLineForward() { + _delegate.deleteLineForward(); + } + + @override + void deleteLineBackward() { + _delegate.deleteLineBackward(); + } + + @override + void deleteSelection() { + _delegate.deleteSelection(); + } + + @override + void deleteSelectionLines([bool keepExtentOffset = true]) { + _delegate.deleteSelectionLines(keepExtentOffset); + } + + @override + void dispose() { + _listeners.clear(); + _delegate.dispose(); + } + + @override + void edit(TextEditingValue newValue) { + _delegate.edit(newValue); + } + + @override + CodeLine get endLine => _delegate.endLine; + + @override + void expandChunk(int index) { + _delegate.expandChunk(index); + } + + @override + void extendSelection(AxisDirection direction) { + _delegate.extendSelection(direction); + } + + @override + void extendSelectionToLineEnd() { + _delegate.extendSelectionToLineEnd(); + } + + @override + void extendSelectionToLineStart() { + _delegate.extendSelectionToLineStart(); + } + + @override + void extendSelectionToPageEnd() { + _delegate.extendSelectionToPageEnd(); + } + + @override + void extendSelectionToPageStart() { + _delegate.extendSelectionToPageStart(); + } + + @override + void extendSelectionToWordBoundaryBackward() { + _delegate.extendSelectionToWordBoundaryBackward(); + } + + @override + void extendSelectionToWordBoundaryForward() { + _delegate.extendSelectionToWordBoundaryForward(); + } + + @override + CodeLine get extentLine => _delegate.extentLine; + + @override + bool get hasListeners => _delegate.hasListeners; + + @override + int index2lineIndex(int index) { + return _delegate.index2lineIndex(index); + } + + @override + bool get isAllSelected => _delegate.isAllSelected; + + @override + bool get isComposing => _delegate.isComposing; + + @override + bool get isEmpty => _delegate.isEmpty; + + @override + int get lineCount => _delegate.lineCount; + + @override + CodeLineIndex lineIndex2Index(int lineIndex) { + return _delegate.lineIndex2Index(lineIndex); + } + + @override + void makeCursorCenterIfInvisible() { + _delegate.makeCursorCenterIfInvisible(); + } + + @override + void makeCursorVisible() { + _delegate.makeCursorVisible(); + } + + @override + void makePositionCenterIfInvisible(CodeLinePosition position) { + _delegate.makePositionCenterIfInvisible(position); + } + + @override + void makePositionVisible(CodeLinePosition position) { + _delegate.makePositionVisible(position); + } + + @override + void moveCursor(AxisDirection direction) { + _delegate.moveCursor(direction); + } + + @override + void moveCursorToLineEnd() { + _delegate.moveCursorToLineEnd(); + } + + @override + void moveCursorToLineStart() { + _delegate.moveCursorToLineStart(); + } + + @override + void moveCursorToPageDown() { + _delegate.moveCursorToPageDown(); + } + + @override + void moveCursorToPageEnd() { + _delegate.moveCursorToPageEnd(); + } + + @override + void moveCursorToPageStart() { + _delegate.moveCursorToPageStart(); + } + + @override + void moveCursorToPageUp() { + _delegate.moveCursorToPageUp(); + } + + @override + void moveCursorToWordBoundaryBackward() { + _delegate.moveCursorToWordBoundaryBackward(); + } + + @override + void moveCursorToWordBoundaryForward() { + _delegate.moveCursorToWordBoundaryForward(); + } + + @override + void moveSelectionLinesDown() { + _delegate.moveSelectionLinesDown(); + } + + @override + void moveSelectionLinesUp() { + _delegate.moveSelectionLinesUp(); + } + + @override + void forceRepaint() { + _delegate.forceRepaint(); + } + + @override + void notifyListeners() { + _delegate.notifyListeners(); + } + + @override + CodeLineOptions get options => _delegate.options; + + @override + void paste() { + _delegate.paste(); + } + + @override + CodeLineEditingValue? get preValue => _delegate.preValue; + + @override + CodeLineSelection get unfoldLineSelection => _delegate.unfoldLineSelection; + + @override + void redo() { + _delegate.redo(); + } + + @override + void removeListener(ui.VoidCallback listener) { + _listeners.remove(listener); + _delegate.removeListener(listener); + } + + @override + void replaceAll(Pattern pattern, String replacement) { + _delegate.replaceAll(pattern, replacement); + } + + @override + void replaceSelection(String replacement, [CodeLineSelection? selection]) { + _delegate.replaceSelection(replacement, selection); + } + + @override + void runRevocableOp(ui.VoidCallback op) { + _delegate.runRevocableOp(op); + } + + @override + void selectAll() { + _delegate.selectAll(); + } + + @override + void selectLine(int index) { + _delegate.selectLine(index); + } + + @override + void selectLines(int base, int extent) { + _delegate.selectLines(base, extent); + } + + @override + String get selectedText => _delegate.selectedText; + + @override + CodeLine get startLine => _delegate.startLine; + + @override + set textAsync(String value) { + _delegate.textAsync = value; + } + + @override + void transposeCharacters() { + _delegate.transposeCharacters(); + } + + @override + void undo() { + _delegate.undo(); + } + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/_code_lines.dart b/packages/re_editor/lib/src/_code_lines.dart new file mode 100644 index 0000000..20f39a5 --- /dev/null +++ b/packages/re_editor/lib/src/_code_lines.dart @@ -0,0 +1,36 @@ +part of re_editor; + +class _CodeLineSegmentQuckLineCount extends CodeLineSegment { + + late int _lineCount; + + _CodeLineSegmentQuckLineCount({ + required super.codeLines, + required super.dirty, + }) { + _lineCount = super.lineCount; + } + + @override + int get lineCount => _lineCount; + + @override + set length(int newLength) { + super.length = newLength; + _lineCount = super.lineCount; + } + + @override + void add(CodeLine element) { + super.add(element); + _lineCount = super.lineCount; + } + + @override + void operator []=(int index, CodeLine value) { + super[index] = value; + _lineCount = super.lineCount; + } + +} + diff --git a/packages/re_editor/lib/src/_code_paragraph.dart b/packages/re_editor/lib/src/_code_paragraph.dart new file mode 100644 index 0000000..d975fed --- /dev/null +++ b/packages/re_editor/lib/src/_code_paragraph.dart @@ -0,0 +1,326 @@ +part of re_editor; + +class _ParagraphImpl extends IParagraph { + + // Unicode value for a zero width joiner character. + static const int _zwjUtf16 = 0x200d; + + final String text; + final TextSpan span; + final ui.Paragraph paragraph; + final bool _trucated; + final double _preferredLineHeight; + final int _lineCount; + + // For performance, do not init here + Map? _offsets; + + _ParagraphImpl({ + required this.text, + required this.span, + required this.paragraph, + required bool trucated, + required double preferredLineHeight, + }) : _trucated = trucated, + _preferredLineHeight = preferredLineHeight, + _lineCount = (paragraph.height / preferredLineHeight).ceil(); + + int get runeLength => text.runes.length; + + int? codeUnitAt(int index) { + if (index < 0 || index >= length) { + return null; + } + return text.codeUnitAt(index); + } + + @override + double get width => _applyFloatingPointHack(max(0, paragraph.longestLine)); + + @override + double get height => lineCount * preferredLineHeight; + + @override + double get preferredLineHeight => _preferredLineHeight; + + @override + int get length => text.length; + + @override + int get lineCount => _lineCount; + + @override + bool get trucated => _trucated; + + @override + void draw(Canvas canvas, Offset offset) { + canvas.drawParagraph(paragraph, offset); + } + + @override + TextPosition getPosition(Offset offset) { + final TextPosition position = paragraph.getPositionForOffset(offset); + return position; + } + + @override + InlineSpan? getSpanForPosition(TextPosition position) { + if (position.offset >= length - 1) { + return null; + } + return span.getSpanForPosition(position); + } + + @override + TextRange getRangeForSpan(InlineSpan span) { + int offset = 0; + this.span.visitChildren((child) { + if (identical(child, span)) { + return false; + } + offset += child.length; + return true; + }); + return TextRange( + start: offset, + end: offset + span.length + ); + } + + @override + TextRange getWord(Offset offset) { + return paragraph.getWordBoundary(getPosition(offset)); + } + + @override + TextRange getLineBoundary(TextPosition position) { + return paragraph.getLineBoundary(position); + } + + @override + Offset? getOffset(TextPosition position) { + Offset? offset = _offsets?[position]; + if (offset != null) { + return offset; + } + if (text.isEmpty) { + return Offset.zero; + } + if (position.offset == 0) { + return Offset.zero; + } + if (position.affinity == TextAffinity.downstream) { + offset = _getOffsetDownstream(position.offset) ?? _getOffsetUpstream(position.offset); + } else { + offset = _getOffsetUpstream(position.offset) ?? _getOffsetDownstream(position.offset); + } + (_offsets ??= {})[position] = offset; + return offset; + } + + @override + List getRangeRects(TextRange range) { + if (text.isEmpty) { + return [ + Rect.fromLTWH(0, 0, 0, _preferredLineHeight) + ]; + } + if (range.isCollapsed) { + return const []; + } + return paragraph.getBoxesForRange(range.start, range.end, boxHeightStyle: ui.BoxHeightStyle.max).map((e) => e.toRect()).toList(); + } + + Offset? _getOffsetDownstream(int position) { + final int? nextCodeUnit = codeUnitAt(min(position, text.length - 1)); + if (nextCodeUnit == null) { + return null; + } + // Check for multi-code-unit glyphs such as emojis or zero width joiner. + final int graphemeClusterLength = _isUtf16Surrogate(nextCodeUnit) || + _isUnicodeDirectionality(nextCodeUnit) || codeUnitAt(position) == _zwjUtf16 ? 2 : 1; + final List boxes = paragraph.getBoxesForRange(position, + position + graphemeClusterLength, boxHeightStyle: ui.BoxHeightStyle.strut); + if (boxes.isEmpty) { + return null; + } + return Offset(boxes.first.left, boxes.first.top); + } + + Offset? _getOffsetUpstream(int position) { + final int? prevCodeUnit = codeUnitAt(max(0, position - 1)); + if (prevCodeUnit == null) { + return null; + } + // Check for multi-code-unit glyphs such as emojis or zero width joiner. + final int graphemeClusterLength = _isUtf16Surrogate(prevCodeUnit) || + _isUnicodeDirectionality(prevCodeUnit) || codeUnitAt(position) == _zwjUtf16 ? 2 : 1; + final List boxes = paragraph.getBoxesForRange(position - graphemeClusterLength, + position, boxHeightStyle: ui.BoxHeightStyle.strut); + if (boxes.isEmpty) { + return null; + } + return Offset(boxes.first.right, boxes.first.top); + } + + // Returns true if the given value is a valid UTF-16 surrogate. The value + // must be a UTF-16 code unit, meaning it must be in the range 0x0000-0xFFFF. + // + // See also: + // * https://en.wikipedia.org/wiki/UTF-16#Code_points_from_U+010000_to_U+10FFFF + bool _isUtf16Surrogate(int value) { + return value & 0xF800 == 0xD800; + } + + // Checks if the glyph is either [Unicode.RLM] or [Unicode.LRM]. These values take + // up zero space and do not have valid bounding boxes around them. + // + // We do not directly use the [Unicode] constants since they are strings. + bool _isUnicodeDirectionality(int value) { + return value == 0x200F || value == 0x200E; + } + + // Unfortunately, using full precision floating point here causes bad layouts + // because floating point math isn't associative. If we add and subtract + // padding, for example, we'll get different values when we estimate sizes and + // when we actually compute layout because the operations will end up associated + // differently. To work around this problem for now, we round fractional pixel + // values up to the nearest whole pixel value. The right long-term fix is to do + // layout using fixed precision arithmetic. + double _applyFloatingPointHack(double layoutValue) { + return layoutValue.ceilToDouble(); + } + +} + +class _CodeParagraphProvider { + + final Map _cachedParagraphs; + + ui.TextStyle? _style; + ui.ParagraphConstraints? _constraints; + ui.ParagraphStyle? _paragraphStyle; + double? _preferredLineHeight; + int? _maxLengthSingleLineRendering; + + _CodeParagraphProvider() : _cachedParagraphs = {}; + + void updateBaseStyle(TextStyle style) { + final ui.TextStyle uiStyle = style.getTextStyle(); + if (uiStyle == _style) { + return; + } + _paragraphStyle = style.getParagraphStyle( + textAlign: TextAlign.left, + textDirection: TextDirection.ltr, + strutStyle: StrutStyle( + fontSize: style.fontSize, + fontFamily: style.fontFamily, + height: style.height, + forceStrutHeight: true, + ) + ); + _style = uiStyle; + final TextPainter painter = TextPainter( + textDirection: TextDirection.ltr, + ); + painter.text = TextSpan( + text: '0', + style: style + ); + _preferredLineHeight = painter.preferredLineHeight; + clearCache(); + } + + void updateMaxLengthSingleLineRendering(int? maxLengthSingleLineRendering) { + if (_maxLengthSingleLineRendering == maxLengthSingleLineRendering) { + return; + } + _maxLengthSingleLineRendering = maxLengthSingleLineRendering; + clearCache(); + } + + IParagraph build(TextSpan span, double maxWidth) { + if (maxWidth != _constraints?.width) { + _constraints = ui.ParagraphConstraints( + width: maxWidth + ); + clearCache(); + } + final _ParagraphImpl? cache = _cachedParagraphs[span]; + if (cache != null) { + return cache; + } + final _ParagraphImpl impl; + // Trucate the span if it's too long. + final String plainText = span.toPlainText(); + final int? renderingLength = _maxLengthSingleLineRendering; + if (renderingLength != null && plainText.length > renderingLength) { + impl = _build(trucate(span, renderingLength), plainText.substring(0, renderingLength), true); + } else { + impl = _build(span, plainText, false); + } + _cachedParagraphs[span] = impl; + return impl; + } + + TextSpan trucate(TextSpan span, int maxLength) { + int currentLength = 0; + TextSpan truncateSpan(TextSpan span) { + if (currentLength >= maxLength) { + return const TextSpan(text: ''); + } + String? text = span.text; + if (text != null) { + int remainingLength = maxLength - currentLength; + if (text.length > remainingLength) { + text = text.substring(0, remainingLength); + } + currentLength += text.length; + return TextSpan( + text: text, + style: span.style + ); + } + final List children = []; + for (InlineSpan child in span.children ?? const []) { + if (currentLength >= maxLength) { + break; + } + if (child is TextSpan) { + children.add(truncateSpan(child)); + } else { + children.add(child); + } + } + return TextSpan( + children: children, + style: span.style + ); + } + return truncateSpan(span); + } + + void clearCache() { + _cachedParagraphs.clear(); + } + + _ParagraphImpl _build(TextSpan span, String plainText, bool trucated) { + final ui.ParagraphStyle? style = _paragraphStyle; + if (style == null) { + throw AssertionError('Must call updateBaseStyle before build Paragraph.'); + } + final ui.ParagraphBuilder builder = ui.ParagraphBuilder(style); + span.build(builder); + final ui.Paragraph paragraph = builder.build(); + paragraph.layout(_constraints!); + return _ParagraphImpl( + text: plainText, + span: span, + paragraph: paragraph, + trucated: trucated, + preferredLineHeight: _preferredLineHeight!, + ); + } + +} diff --git a/packages/re_editor/lib/src/_code_scroll.dart b/packages/re_editor/lib/src/_code_scroll.dart new file mode 100644 index 0000000..9ee525c --- /dev/null +++ b/packages/re_editor/lib/src/_code_scroll.dart @@ -0,0 +1,142 @@ +part of re_editor; + +const double _kScrollbarThickness = 8.0; + +class _CodeScrollable extends StatelessWidget { + + final AxisDirection axisDirection; + final ScrollController? controller; + final ViewportBuilder viewportBuilder; + final CodeScrollbarBuilder? scrollbarBuilder; + + const _CodeScrollable({ + required this.axisDirection, + this.controller, + required this.viewportBuilder, + this.scrollbarBuilder + }); + + @override + Widget build(BuildContext context) { + return Scrollable( + excludeFromSemantics: true, + controller: controller, + scrollBehavior: _ScrollBehavior(scrollbarBuilder), + viewportBuilder: viewportBuilder, + axisDirection: axisDirection, + physics: const ClampingScrollPhysics(), + ); + } + +} + +class _ScrollBehavior extends MaterialScrollBehavior { + + final _ScrollPhysics physics; + final CodeScrollbarBuilder? scrollbarBuilder; + + _ScrollBehavior(this.scrollbarBuilder) : physics = _ScrollPhysics(); + + @override + Widget buildScrollbar(BuildContext context, Widget child, ScrollableDetails details) { + final Widget? scrollbar = scrollbarBuilder?.call(context, child, details); + if (scrollbar != null) { + return scrollbar; + } + final ScrollbarOrientation? orientation; + if (details.direction == AxisDirection.down) { + orientation = ScrollbarOrientation.right; + } else if (details.direction == AxisDirection.right) { + orientation = ScrollbarOrientation.bottom; + } else { + orientation = null; + } + if (kIsAndroid || kIsIOS) { + return Scrollbar( + controller: details.controller, + scrollbarOrientation: orientation, + thumbVisibility: details.direction == AxisDirection.down, + child: child, + ); + } + return _RawScrollbar( + physics: physics, + controller: details.controller ?? ScrollController(), + scrollbarOrientation: orientation, + thumbVisibility: details.direction == AxisDirection.down, + child: child, + ); + } + + @override + ScrollPhysics getScrollPhysics(BuildContext context) { + return physics; + } + +} + +class _RawScrollbar extends RawScrollbar { + + final _ScrollPhysics physics; + + const _RawScrollbar({ + required this.physics, + required Widget child, + required ScrollController controller, + ScrollbarOrientation? scrollbarOrientation, + required bool thumbVisibility, + }) : super( + controller: controller, + scrollbarOrientation: scrollbarOrientation, + thumbVisibility: thumbVisibility, + thickness: _kScrollbarThickness, + radius: const Radius.circular(10), + crossAxisMargin: 2, + child: child, + ); + + @override + RawScrollbarState<_RawScrollbar> createState() => _RawScrollbarState(); + +} + +class _RawScrollbarState extends RawScrollbarState<_RawScrollbar> { + + Offset? downPosition; + double? downOffset; + + @override + void handleThumbPressStart(ui.Offset localPosition) { + downPosition = localPosition; + downOffset = widget.controller!.offset; + super.handleThumbPressStart(localPosition); + } + + @override + void handleThumbPressUpdate(Offset localPosition) { + if (getScrollbarDirection() == Axis.vertical) { + widget.physics.setScrollPosition(downOffset! + scrollbarPainter.getTrackToScroll(localPosition.dy - downPosition!.dy)); + } + super.handleThumbPressUpdate(localPosition); + } + +} + +// ignore: must_be_immutable +class _ScrollPhysics extends ScrollPhysics { + + double? _position; + + void setScrollPosition(double position) { + _position = position; + } + + @override + double applyBoundaryConditions(ScrollMetrics position, double value) { + if (_position == null) { + return super.applyBoundaryConditions(position, value); + } + return value - _position!; + } + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/_code_selection.dart b/packages/re_editor/lib/src/_code_selection.dart new file mode 100644 index 0000000..7d963b9 --- /dev/null +++ b/packages/re_editor/lib/src/_code_selection.dart @@ -0,0 +1,1276 @@ +part of re_editor; + +class _CodeSelectionGestureDetector extends StatefulWidget { + + final CodeLineEditingController controller; + final _CodeInputController inputController; + final CodeChunkController chunkController; + final HitTestBehavior? behavior; + final GlobalKey editorKey; + final _SelectionOverlayController selectionOverlayController; + final Widget child; + + const _CodeSelectionGestureDetector({ + required this.controller, + required this.inputController, + required this.chunkController, + this.behavior, + required this.editorKey, + required this.selectionOverlayController, + required this.child, + }); + + @override + State createState() => _CodeSelectionGestureDetectorState(); + +} + +class _CodeSelectionGestureDetectorState extends State<_CodeSelectionGestureDetector> { + Offset? _dragPosition; + bool _dragging = false; + bool _isAutoScrolling = false; + DateTime? _pointerTapTimestamp; + Offset? _pointerTapPosition; + bool? _handleByNextEvent; + bool _longPressOnSelection = false; + CodeLineSelection? _anchorSelection; + + _CodeFieldRender get render => widget.editorKey.currentContext?.findRenderObject() as _CodeFieldRender; + + bool _tapping = false; + + @override + Widget build(BuildContext context) { + if (_isMobile) { + return GestureDetector( + onLongPressMoveUpdate: (details) { + if (_longPressOnSelection == true) { + return; + } + if (details.localOffsetFromOrigin.distance < 1) { + return; + } + _dragging = true; + _onLongPressMove(details); + }, + onLongPressStart: (details) { + _dragPosition = details.globalPosition; + widget.inputController.ensureInput(); + _longPressOnSelection = _isPositionOnSelection(details.globalPosition); + if (_longPressOnSelection != true) { + _onMobileLongPressedStart(details.globalPosition); + _autoScrollWhenDragging(); + } else { + widget.selectionOverlayController.showToolbar(context, details.globalPosition); + } + widget.selectionOverlayController.showHandle(context); + }, + onLongPressEnd: (details) { + if (_longPressOnSelection != true) { + widget.selectionOverlayController.showToolbar(context, details.globalPosition); + } + _dragPosition = null; + _longPressOnSelection = false; + _dragging = false; + render.stopAutoScroll(); + widget.selectionOverlayController.showHandle(context); + }, + onLongPressCancel: () { + _dragPosition = null; + _longPressOnSelection = false; + _dragging = false; + render.stopAutoScroll(); + widget.selectionOverlayController.hideToolbar(); + widget.selectionOverlayController.hideHandle(); + }, + onLongPressUp: () { + _dragPosition = null; + render.stopAutoScroll(); + }, + onTapUp: (details) { + _onMobileTapUp(details.globalPosition); + }, + onTapDown: (details) { + if (!render.hasFocus) { + _onMobileTapDown(details.globalPosition); + } + }, + behavior: widget.behavior, + child: widget.child, + ); + } else { + return GestureDetector( + onVerticalDragUpdate: _onDrag, + onHorizontalDragUpdate: _onDrag, + onVerticalDragStart: (details) { + if (!_tapping) { + return; + } + _dragPosition = details.globalPosition; + _dragging = true; + _autoScrollWhenDragging(); + }, + onVerticalDragEnd: (_) { + _dragPosition = null; + _dragging = false; + render.stopAutoScroll(); + }, + onVerticalDragCancel: () { + _dragPosition = null; + _dragging = false; + render.stopAutoScroll(); + }, + onHorizontalDragStart: (details) { + if (!_tapping) { + return; + } + _dragPosition = details.globalPosition; + _dragging = true; + _autoScrollWhenDragging(); + }, + onHorizontalDragEnd: (_) { + _dragPosition = null; + _dragging = false; + render.stopAutoScroll(); + }, + onHorizontalDragCancel: () { + _dragPosition = null; + _dragging = false; + render.stopAutoScroll(); + }, + behavior: widget.behavior, + onSecondaryTapDown: (detail) { + _onSecondaryTapDown(context, detail); + }, + onTapUp: (_) { + widget.inputController.ensureInput(); + }, + child: Listener( + onPointerDown: (event) { + _tapping = render.isValidPointer2(event.position); + // A trick, delay the focus request here to avoid loss. + Future(widget.inputController.ensureInput); + _onDesktopTapDown(event.position); + }, + onPointerUp: (event) { + _tapping = false; + _onDesktopTapUp(event.position); + }, + onPointerCancel: (event) { + _tapping = false; + _handleByNextEvent = false; + _pointerTapTimestamp = null; + _pointerTapPosition = null; + }, + behavior: widget.behavior ?? HitTestBehavior.translucent, + child: widget.child, + ), + ); + } + } + + bool get _isMobile => kIsAndroid || kIsIOS; + + bool get _isShiftPressed => _isMobile ? false : HardwareKeyboard.instance.logicalKeysPressed + .any({ + LogicalKeyboardKey.shiftLeft, + LogicalKeyboardKey.shiftRight, + }.contains); + + void _onMobileTapDown(Offset position) { + _selectPosition(position, _SelectionChangedCause.tapDown); + widget.selectionOverlayController.hideHandle(); + widget.selectionOverlayController.hideToolbar(); + } + + void _onMobileTapUp(Offset position) { + final DateTime now = DateTime.now(); + if (_pointerTapTimestamp != null && (now.millisecondsSinceEpoch - _pointerTapTimestamp!.millisecondsSinceEpoch) < + kDoubleTapTimeout.inMilliseconds && _pointerTapPosition != null && _pointerTapPosition!.isSamePosition(position)) { + _onDoubleTap(position); + widget.selectionOverlayController.showHandle(context); + widget.selectionOverlayController.showToolbar(context, position); + } else { + _pointerTapTimestamp = now; + _pointerTapPosition = position; + _selectPosition(position, _SelectionChangedCause.tapUp); + widget.selectionOverlayController.hideHandle(); + widget.selectionOverlayController.hideToolbar(); + } + widget.inputController.ensureInput(); + } + + void _onMobileLongPressedStart(Offset position) { + final CodeLineRange? range = render.selectWord( + position: position, + ); + if (range == null) { + return; + } + final CodeLineSelection selection = CodeLineSelection.fromRange( + range: range + ); + widget.controller.selection = selection; + widget.controller.makeCursorVisible(); + _anchorSelection = selection; + widget.selectionOverlayController.hideHandle(); + widget.selectionOverlayController.hideToolbar(); + } + + void _onDesktopTapDown(Offset position) { + if (widget.controller.isComposing) { + return; + } + final DateTime now = DateTime.now(); + if (_pointerTapTimestamp != null && (now.millisecondsSinceEpoch - _pointerTapTimestamp!.millisecondsSinceEpoch) < + kDoubleTapTimeout.inMilliseconds && _pointerTapPosition != null && _pointerTapPosition!.isSamePosition(position)) { + _onDoubleTap(position); + } else { + if (widget.controller.selection.baseOffset != -1) { + if (_isShiftPressed) { + _extendSelection(position, _SelectionChangedCause.tapDown); + return; + } + } + _pointerTapTimestamp = now; + _pointerTapPosition = position; + _selectPosition(position, _SelectionChangedCause.tapDown); + } + } + + void _onDesktopTapUp(Offset position) { + _anchorSelection = null; + if (_dragPosition != null) { + return; + } + if (_handleByNextEvent != true) { + return; + } + _handleByNextEvent = false; + _selectPosition(position, _SelectionChangedCause.tapUp); + } + + void _onDoubleTap(Offset position) { + final CodeLineRange? range = render.selectWord( + position: position, + ); + if (range == null) { + return; + } + final CodeLineSelection selection; + if (_isShiftPressed && widget.controller.selection.base.offset <= range.start) { + selection = widget.controller.selection.copyWith( + extentIndex: range.index, + extentOffset: range.end + ); + } else if (_isShiftPressed && widget.controller.selection.base.offset >= range.end) { + selection = widget.controller.selection.copyWith( + extentIndex: range.index, + extentOffset: range.start + ); + } else { + selection = CodeLineSelection.fromRange( + range: range + ); + } + widget.controller.selection = selection; + widget.controller.makeCursorVisible(); + _anchorSelection = selection; + } + + void _onDrag(DragUpdateDetails details) { + if (!_tapping) { + // https://github.com/flutter/flutter/issues/114889 + return; + } + if (widget.controller.isComposing) { + return; + } + if (_isMobile) { + return; + } + _dragPosition = details.globalPosition; + _extendSelection(details.globalPosition, _SelectionChangedCause.drag); + } + + void _onLongPressMove(LongPressMoveUpdateDetails details) { + if (widget.controller.isComposing) { + return; + } + if (!_isMobile) { + return; + } + _dragPosition = details.globalPosition; + _extendSelection(details.globalPosition, _SelectionChangedCause.drag); + } + + void _onSecondaryTapDown(BuildContext context, TapDownDetails details) { + _handleByNextEvent = false; + if (!render.size.contains(render.globalToLocal(details.globalPosition))) { + return; + } + widget.controller.clearComposing(); + widget.selectionOverlayController.showToolbar(context, details.globalPosition); + } + + void _extendSelection(Offset offset, _SelectionChangedCause cause) { + if (cause == _SelectionChangedCause.tapDown || cause == _SelectionChangedCause.tapUp) { + if (expandChunkIfNeeded(render.chunkIndicatorHitIndex(offset))) { + return; + } + } + final CodeLineSelection? selection = render.extendPositionTo( + oldSelection: widget.controller.selection, + position: offset, + anchor: _isMobile ? null : _anchorSelection, + allowOverflow: cause == _SelectionChangedCause.drag, + ); + if (selection == null) { + return; + } + if (widget.controller.selection == selection) { + return; + } + widget.controller.value = widget.controller.value.copyWith( + selection: selection, + composing: TextRange.empty, + ); + widget.controller.makeCursorVisible(); + } + + void _selectPosition(Offset offset, _SelectionChangedCause cause) { + if (cause == _SelectionChangedCause.tapDown || cause == _SelectionChangedCause.tapUp) { + if (expandChunkIfNeeded(render.chunkIndicatorHitIndex(offset))) { + return; + } + } + final CodeLineSelection? selection = render.setPositionAt( + position: offset, + ); + if (selection == null) { + return; + } + if (widget.controller.selection == selection) { + return; + } + + if (cause == _SelectionChangedCause.tapDown) { + if (!widget.controller.selection.isCollapsed && widget.controller.selection.contains(selection)) { + _handleByNextEvent = true; + return; + } + } + widget.controller.value = widget.controller.value.copyWith( + selection: selection, + composing: TextRange.empty, + ); + widget.controller.makeCursorVisible(); + } + + bool _isPositionOnSelection(Offset position) { + final CodeLineSelection? selection = render.setPositionAt( + position: position, + ); + if (selection == null) { + return false; + } + if (widget.controller.selection == selection) { + return false; + } + return widget.controller.selection.contains(selection); + } + + void _autoScrollWhenDragging() { + if (_isAutoScrolling) { + return; + } + _isAutoScrolling = true; + _runAutoScrollLoop(); + } + + void _runAutoScrollLoop() { + Future.delayed(const Duration(milliseconds: 16), () { + if (!_dragging || _dragPosition == null) { + _isAutoScrolling = false; + render.stopAutoScroll(); + return; + } + render.autoScrollWhenDragging(_dragPosition!); + _extendSelection(_dragPosition!, _SelectionChangedCause.drag); + _runAutoScrollLoop(); + }); + } + + bool expandChunkIfNeeded(int index) { + if (index < 0) { + return false; + } + widget.chunkController.expand(index); + return true; + } + +} + +enum _SelectionChangedCause { + /// The user tapped down on the text and that caused the selection (or the location + /// of the cursor) to change. + tapDown, + + /// The user tapped up on the text and that caused the selection (or the location + /// of the cursor) to change. + tapUp, + + /// The user used the mouse to change the selection by dragging over a piece + /// of text. + drag, + +} + +abstract class _SelectionOverlayController { + + void showHandle(BuildContext context); + + void hideHandle(); + + void showToolbar(BuildContext context, Offset position); + + void hideToolbar(); + + void dispose(); + +} + +typedef OnToolbarShow = void Function(BuildContext context, TextSelectionToolbarAnchors anchors, Rect? renderRect); + +class _DesktopSelectionOverlayController implements _SelectionOverlayController { + + final OnToolbarShow onShowToolbar; + final VoidCallback onHideToolbar; + + const _DesktopSelectionOverlayController({ + required this.onShowToolbar, + required this.onHideToolbar + }); + + @override + void hideHandle() { + } + + @override + void showHandle(BuildContext context) { + } + + @override + void hideToolbar() { + onHideToolbar(); + } + + @override + void showToolbar(BuildContext context, Offset? position) { + if (position == null) { + return; + } + onShowToolbar(context, TextSelectionToolbarAnchors( + primaryAnchor: position + ), null); + } + + @override + void dispose() { + } + +} + +class _MobileSelectionOverlayController implements _SelectionOverlayController { + + final CodeLineEditingController controller; + final GlobalKey editorKey; + final LayerLink startHandleLayerLink; + final LayerLink endHandleLayerLink; + final ValueNotifier toolbarVisibility; + final FocusNode focusNode; + final OnToolbarShow onShowToolbar; + final VoidCallback onHideToolbar; + + bool _inited = false; + bool _handlesVisible = false; + + final ValueNotifier _effectiveStartHandleVisibility = ValueNotifier(false); + final ValueNotifier _effectiveEndHandleVisibility = ValueNotifier(false); + + late BuildContext _context; + // The contact position of the gesture at the current start handle location. + // Updated when the handle moves. + late double _startHandleDragPosition; + late Offset _startHandleDragLastPosition; + bool _startHandleDragging = false; + bool _isStartHandleAutoScrolling = false; + + // The distance from _startHandleDragPosition to the center of the line that + // it corresponds to. + late double _startHandleDragPositionToCenterOfLine; + + // The contact position of the gesture at the current end handle location. + // Updated when the handle moves. + late double _endHandleDragPosition; + late Offset _endHandleDragLastPosition; + bool _endHandleDragging = false; + bool _isEndHandleAutoScrolling = false; + + // The distance from _endHandleDragPosition to the center of the line that it + // corresponds to. + late double _endHandleDragPositionToCenterOfLine; + + List? _handles; + bool? _handleCollapsed; + + _MobileSelectionOverlayController({ + required BuildContext context, + required this.controller, + required this.editorKey, + required this.startHandleLayerLink, + required this.endHandleLayerLink, + required this.toolbarVisibility, + required this.focusNode, + required this.onShowToolbar, + required this.onHideToolbar, + }) { + _context = context; + controller.addListener(_updateTextSelectionHandle); + } + + TextSelectionControls get selectionControls { + if (kIsAndroid) { + return materialTextSelectionControls; + } else { + return cupertinoTextSelectionControls; + } + } + + @override + void showHandle(BuildContext context) { + _context = context; + _handlesVisible = true; + if (!_inited) { + init(); + } + _updateTextSelectionOverlayVisibilities(); + _buildHandles(context); + } + + @override + void hideHandle() { + _handlesVisible = false; + _handleCollapsed = null; + if (_handles != null) { + _handles![0].remove(); + _handles![1].remove(); + _handles = null; + } + } + + @override + void hideToolbar() { + onHideToolbar(); + } + + @override + void showToolbar(BuildContext context, Offset globalPosition) { + globalPosition = _clampPosition(globalPosition); + final Rect editingRegion = Rect.fromPoints( + ensureRender.localToGlobal(Offset.zero), + ensureRender.localToGlobal(ensureRender.size.bottomRight(Offset.zero)), + ); + final CodeLineSelection selection = controller.selection; + final TextSelectionToolbarAnchors anchors; + if (selection.isCollapsed) { + anchors = TextSelectionToolbarAnchors( + primaryAnchor: ensureRender.calculateTextPositionScreenOffset(selection.start, false) ?? globalPosition, + ); + } else { + final Rect? bounds = ensureRender.calculateSelectionBoundingRect(selection); + final double midX; + final double topY; + final double bottomY; + if (bounds != null) { + midX = bounds.center.dx; + topY = bounds.top.clamp(editingRegion.top, editingRegion.bottom); + bottomY = bounds.bottom.clamp(editingRegion.top, editingRegion.bottom); + } else { + Offset startPosition = ensureRender.calculateTextPositionScreenOffset(selection.start, false) ?? editingRegion.topLeft; + Offset endPosition = ensureRender.calculateTextPositionScreenOffset(selection.end, true) ?? editingRegion.bottomRight; + topY = min(startPosition.dy, endPosition.dy).clamp(editingRegion.top, editingRegion.bottom); + bottomY = max(startPosition.dy, endPosition.dy).clamp(editingRegion.top, editingRegion.bottom); + if ((endPosition.dy - startPosition.dy).abs() <= ensureRender.lineHeight * 1.5) { + midX = (startPosition.dx + endPosition.dx) / 2.0; + } else { + midX = globalPosition.dx; + } + } + anchors = TextSelectionToolbarAnchors( + primaryAnchor: Offset(midX, topY), + secondaryAnchor: Offset(midX, bottomY), + ); + } + onShowToolbar(context, anchors, editingRegion); + } + + void init() { + _inited = true; + ensureRender.selectionStartInViewport.addListener(_updateTextSelectionOverlayVisibilities); + ensureRender.selectionEndInViewport.addListener(_updateTextSelectionOverlayVisibilities); + } + + @override + void dispose() { + _startHandleDragging = false; + _endHandleDragging = false; + hideHandle(); + controller.removeListener(_updateTextSelectionHandle); + _effectiveStartHandleVisibility.dispose(); + _effectiveEndHandleVisibility.dispose(); + final _CodeFieldRender? render = editorKey.currentContext?.findRenderObject() as _CodeFieldRender?; + if (render == null) { + return; + } + render.selectionStartInViewport.removeListener(_updateTextSelectionOverlayVisibilities); + render.selectionEndInViewport.removeListener(_updateTextSelectionOverlayVisibilities); + } + + double get lineHeight { + final _CodeFieldRender? render = editorKey.currentContext?.findRenderObject() as _CodeFieldRender?; + if (render == null) { + return 0; + } + return render.lineHeight; + } + + bool get attached { + final _CodeFieldRender? render = editorKey.currentContext?.findRenderObject() as _CodeFieldRender?; + return render != null && render.attached; + } + + _CodeFieldRender get ensureRender => editorKey.currentContext?.findRenderObject() as _CodeFieldRender; + + void _updateTextSelectionHandle() { + if (!_handlesVisible) { + return; + } + if (!focusNode.hasFocus) { + return; + } + showHandle(_context); + } + + void _updateTextSelectionOverlayVisibilities() { + final _CodeFieldRender? render = editorKey.currentContext?.findRenderObject() as _CodeFieldRender?; + if (render == null) { + return; + } + _effectiveStartHandleVisibility.value = _handlesVisible && render.selectionStartInViewport.value; + _effectiveEndHandleVisibility.value = _handlesVisible && render.selectionEndInViewport.value; + } + + void _buildHandles(BuildContext context) { + final bool isCollapsed = controller.selection.isCollapsed; + if (_handleCollapsed == isCollapsed) { + return; + } + _handleCollapsed = isCollapsed; + if (_handles != null) { + _handles![0].remove(); + _handles![1].remove(); + _handles = null; + } + _handles = [ + OverlayEntry(builder: (context) { + return _buildStartHandle(context, isCollapsed ? TextSelectionHandleType.collapsed : TextSelectionHandleType.left); + }), + OverlayEntry(builder: (context) { + return _buildEndHandle(context, isCollapsed ? TextSelectionHandleType.collapsed : TextSelectionHandleType.right); + }), + ]; + Overlay.of(context, rootOverlay: true).insertAll(_handles!); + } + + Widget _buildStartHandle(BuildContext context, TextSelectionHandleType type) { + if (kIsIOS && type == TextSelectionHandleType.collapsed) { + type = TextSelectionHandleType.right; + } + return CodeEditorTapRegion( + child: ExcludeSemantics( + child: _SelectionHandleOverlay( + type: type, + handleLayerLink: startHandleLayerLink, + onSelectionHandleTapped: () { + final Offset? position = ensureRender.calculateTextPositionScreenOffset(controller.selection.start, false); + if (position == null) { + return; + } + showToolbar(_context, position); + }, + onSelectionHandleDragStart: _handleStartHandleDragStart, + onSelectionHandleDragUpdate: (details) { + _handleStartHandleDragUpdate(details.globalPosition); + }, + onSelectionHandleDragEnd: _handleStartHandleDragEnd, + onSelectionHandleDragCancel: () { + _startHandleDragging = false; + }, + selectionControls: selectionControls, + visibility: _effectiveStartHandleVisibility, + preferredLineHeight: lineHeight, + ) + ), + ); + } + + Widget _buildEndHandle(BuildContext context, TextSelectionHandleType type) { + final Widget handle; + if (type == TextSelectionHandleType.collapsed) { + // Hide the second handle when collapsed. + handle = const SizedBox.shrink(); + } else { + handle = _SelectionHandleOverlay( + type: type, + handleLayerLink: endHandleLayerLink, + onSelectionHandleTapped: () { + final Offset? position = ensureRender.calculateTextPositionScreenOffset(controller.selection.end, false); + if (position == null) { + return; + } + showToolbar(_context, position); + }, + onSelectionHandleDragStart: _handleEndHandleDragStart, + onSelectionHandleDragUpdate: (details) { + _handleEndHandleDragUpdate(details.globalPosition); + }, + onSelectionHandleDragEnd: _handleEndHandleDragEnd, + onSelectionHandleDragCancel: () { + _endHandleDragging = false; + }, + selectionControls: selectionControls, + visibility: _effectiveEndHandleVisibility, + preferredLineHeight: lineHeight, + ); + } + return CodeEditorTapRegion( + child: ExcludeSemantics( + child: handle, + ), + ); + } + + void _handleStartHandleDragStart(DragStartDetails details) { + _startHandleDragging = true; + _startHandleDragLastPosition = details.globalPosition; + _startHandleDragPosition = details.globalPosition.dy; + final Offset startPoint = ensureRender.localToGlobal(ensureRender.calculateTextPositionViewportOffset(controller.selection.start)!); + final double centerOfLine = startPoint.dy + ensureRender.lineHeight / 2; + _startHandleDragPositionToCenterOfLine = centerOfLine - _startHandleDragPosition; + toolbarVisibility.value = false; + _autoScrollWhenStartHandleDragging(); + } + + void _handleStartHandleDragUpdate(Offset offset) { + if (!attached) { + return; + } + _startHandleDragPosition = _getHandleDy(offset.dy, _startHandleDragPosition); + _startHandleDragLastPosition = offset; + final Offset adjustedOffset = ensureRender.globalToLocal(Offset( + offset.dx, + _startHandleDragPosition + _startHandleDragPositionToCenterOfLine, + )); + final CodeLinePosition? position = ensureRender.calculateTextPosition(adjustedOffset); + if (position == null) { + return; + } + final CodeLineSelection newSelection; + if (controller.selection.isCollapsed) { + newSelection = CodeLineSelection.fromPosition( + position : position + ); + if (controller.selection != newSelection) { + HapticFeedback.selectionClick(); + } + controller.selection = newSelection; + return; + } + if (kIsAndroid) { + newSelection = CodeLineSelection( + baseIndex: position.index, + baseOffset: position.offset, + baseAffinity: position.affinity, + extentIndex: controller.selection.endIndex, + extentOffset: controller.selection.endOffset, + extentAffinity: controller.selection.end.affinity + ); + if (position.index >= controller.selection.endIndex && position.offset >= controller.selection.endOffset) { + // Don't allow order swapping. + return; + } + if (controller.selection != newSelection) { + HapticFeedback.selectionClick(); + } + } else { + newSelection = CodeLineSelection( + baseIndex: controller.selection.endIndex, + baseOffset: controller.selection.endOffset, + baseAffinity: controller.selection.end.affinity, + extentIndex: position.index, + extentOffset: position.offset, + extentAffinity: position.affinity, + ); + if (newSelection.extentIndex >= controller.selection.endIndex && newSelection.extentOffset >= controller.selection.endOffset) { + // Don't allow order swapping. + return; + } + } + controller.selection = newSelection; + } + + void _handleStartHandleDragEnd(DragEndDetails details) { + _startHandleDragging = false; + _isStartHandleAutoScrolling = false; + ensureRender.stopAutoScroll(); + toolbarVisibility.value = true; + showToolbar(_context, _startHandleDragLastPosition); + } + + void _handleEndHandleDragStart(DragStartDetails details) { + // This adjusts for the fact that the selection handles may not + // perfectly cover the TextPosition that they correspond to. + _endHandleDragging = true; + _endHandleDragPosition = details.globalPosition.dy; + _endHandleDragLastPosition = details.globalPosition; + final Offset endPoint = + ensureRender.localToGlobal(ensureRender.calculateTextPositionViewportOffset(controller.selection.end)!); + final double centerOfLine = endPoint.dy + ensureRender.lineHeight / 2; + _endHandleDragPositionToCenterOfLine = centerOfLine - _endHandleDragPosition; + toolbarVisibility.value = false; + _autoScrollWhenEndHandleDragging(); + } + + void _handleEndHandleDragUpdate(Offset offset) { + if (!attached) { + return; + } + _endHandleDragPosition = _getHandleDy(offset.dy, _endHandleDragPosition); + _endHandleDragLastPosition = offset; + final Offset adjustedOffset = ensureRender.globalToLocal(Offset( + offset.dx, + _endHandleDragPosition + _endHandleDragPositionToCenterOfLine, + )); + final CodeLinePosition? position = ensureRender.calculateTextPosition(adjustedOffset); + if (position == null) { + return; + } + final CodeLineSelection newSelection; + if (controller.selection.isCollapsed) { + newSelection = CodeLineSelection.fromPosition( + position : position + ); + if (controller.selection != newSelection) { + HapticFeedback.selectionClick(); + } + controller.selection = newSelection; + return; + } + + if (kIsAndroid) { + newSelection = CodeLineSelection( + baseIndex: controller.selection.baseIndex, + baseOffset: controller.selection.baseOffset, + baseAffinity: controller.selection.baseAffinity, + extentIndex: position.index, + extentOffset: position.offset, + extentAffinity: position.affinity, + ); + if (newSelection.baseIndex >= newSelection.extentIndex && newSelection.baseOffset >= newSelection.extentOffset) { + // Don't allow order swapping. + return; + } + if (controller.selection != newSelection) { + HapticFeedback.selectionClick(); + } + } else { + newSelection = CodeLineSelection( + extentIndex: position.index, + extentOffset: position.offset, + extentAffinity: position.affinity, + baseIndex: controller.selection.startIndex, + baseOffset: controller.selection.startOffset, + baseAffinity: controller.selection.start.affinity, + ); + if (position.index <= controller.selection.startIndex && position.offset <= controller.selection.startOffset) { + // Don't allow order swapping. + return; + } + } + controller.selection = newSelection; + } + + void _handleEndHandleDragEnd(DragEndDetails details) { + _endHandleDragging = false; + _isEndHandleAutoScrolling = false; + ensureRender.stopAutoScroll(); + toolbarVisibility.value = true; + showToolbar(_context, _endHandleDragLastPosition); + } + + void _autoScrollWhenStartHandleDragging() { + if (_isStartHandleAutoScrolling) { + return; + } + _isStartHandleAutoScrolling = true; + _runStartHandleAutoScrollLoop(); + } + + void _runStartHandleAutoScrollLoop() { + Future.delayed(const Duration(milliseconds: 16), () { + if (!_startHandleDragging) { + _isStartHandleAutoScrolling = false; + ensureRender.stopAutoScroll(); + return; + } + ensureRender.autoScrollWhenDragging(_startHandleDragLastPosition); + _handleStartHandleDragUpdate(_startHandleDragLastPosition); + _runStartHandleAutoScrollLoop(); + }); + } + + void _autoScrollWhenEndHandleDragging() { + if (_isEndHandleAutoScrolling) { + return; + } + _isEndHandleAutoScrolling = true; + _runEndHandleAutoScrollLoop(); + } + + void _runEndHandleAutoScrollLoop() { + Future.delayed(const Duration(milliseconds: 16), () { + if (!_endHandleDragging) { + _isEndHandleAutoScrolling = false; + ensureRender.stopAutoScroll(); + return; + } + ensureRender.autoScrollWhenDragging(_endHandleDragLastPosition); + _handleEndHandleDragUpdate(_endHandleDragLastPosition); + _runEndHandleAutoScrollLoop(); + }); + } + + /// Given a handle position and drag position, returns the position of handle + /// after the drag. + /// + /// The handle jumps instantly between lines when the drag reaches a full + /// line's height away from the original handle position. In other words, the + /// line jump happens when the contact point would be located at the same + /// place on the handle at the new line as when the gesture started. + double _getHandleDy(double dragDy, double handleDy) { + final double distanceDragged = dragDy - handleDy; + final int dragDirection = distanceDragged < 0.0 ? -1 : 1; + final int linesDragged = + dragDirection * (distanceDragged.abs() / ensureRender.lineHeight).floor(); + return handleDy + linesDragged * ensureRender.lineHeight; + } + + Offset _clampPosition(Offset position) { + final RenderBox box = _context.findRenderObject() as RenderBox; + final Offset offset = box.globalToLocal(position); + return box.localToGlobal(Offset(min(max(0, offset.dx), box.size.width), min(max(0, offset.dy), box.size.height))); + } + +} + +class _SelectionHandleOverlay extends StatefulWidget { + /// Create selection overlay. + const _SelectionHandleOverlay({ + required this.type, + required this.handleLayerLink, + this.onSelectionHandleTapped, + this.onSelectionHandleDragStart, + this.onSelectionHandleDragUpdate, + this.onSelectionHandleDragEnd, + this.onSelectionHandleDragCancel, + required this.selectionControls, + this.visibility, + required this.preferredLineHeight, + }); + + final LayerLink handleLayerLink; + final VoidCallback? onSelectionHandleTapped; + final ValueChanged? onSelectionHandleDragStart; + final ValueChanged? onSelectionHandleDragUpdate; + final ValueChanged? onSelectionHandleDragEnd; + final VoidCallback? onSelectionHandleDragCancel; + final TextSelectionControls selectionControls; + final ValueListenable? visibility; + final double preferredLineHeight; + final TextSelectionHandleType type; + + @override + State<_SelectionHandleOverlay> createState() => _SelectionHandleOverlayState(); +} + +class _SelectionHandleOverlayState extends State<_SelectionHandleOverlay> with SingleTickerProviderStateMixin { + + late AnimationController _controller; + Animation get _opacity => _controller.view; + + @override + void initState() { + super.initState(); + _controller = AnimationController(duration: SelectionOverlay.fadeDuration, vsync: this); + + _handleVisibilityChanged(); + widget.visibility?.addListener(_handleVisibilityChanged); + } + + void _handleVisibilityChanged() { + if (widget.visibility?.value ?? true) { + _controller.forward(); + } else { + _controller.reverse(); + } + } + + @override + void didUpdateWidget(_SelectionHandleOverlay oldWidget) { + super.didUpdateWidget(oldWidget); + oldWidget.visibility?.removeListener(_handleVisibilityChanged); + _handleVisibilityChanged(); + widget.visibility?.addListener(_handleVisibilityChanged); + } + + @override + void dispose() { + widget.visibility?.removeListener(_handleVisibilityChanged); + _controller.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + final Offset handleAnchor = widget.selectionControls.getHandleAnchor( + widget.type, + widget.preferredLineHeight, + ); + final Size handleSize = widget.selectionControls.getHandleSize( + widget.preferredLineHeight, + ); + + final Rect handleRect = Rect.fromLTWH( + -handleAnchor.dx, + -handleAnchor.dy, + handleSize.width, + handleSize.height, + ); + + // Make sure the GestureDetector is big enough to be easily interactive. + final Rect interactiveRect = handleRect.expandToInclude( + Rect.fromCircle(center: handleRect.center, radius: kMinInteractiveDimension/ 2), + ); + final RelativeRect padding = RelativeRect.fromLTRB( + max((interactiveRect.width - handleRect.width) / 2, 0), + max((interactiveRect.height - handleRect.height) / 2, 0), + max((interactiveRect.width - handleRect.width) / 2, 0), + max((interactiveRect.height - handleRect.height) / 2, 0), + ); + + return CompositedTransformFollower( + link: widget.handleLayerLink, + offset: interactiveRect.topLeft, + showWhenUnlinked: false, + child: FadeTransition( + opacity: _opacity, + child: Container( + alignment: Alignment.topLeft, + width: interactiveRect.width, + height: interactiveRect.height, + child: RawGestureDetector( + behavior: HitTestBehavior.translucent, + gestures: { + PanGestureRecognizer: GestureRecognizerFactoryWithHandlers( + () => PanGestureRecognizer( + debugOwner: this, + // Mouse events select the text and do not drag the cursor. + supportedDevices: { + PointerDeviceKind.touch, + PointerDeviceKind.stylus, + PointerDeviceKind.unknown, + }, + ), + (PanGestureRecognizer instance) { + instance + ..dragStartBehavior = DragStartBehavior.start + ..onStart = widget.onSelectionHandleDragStart + ..onUpdate = widget.onSelectionHandleDragUpdate + ..onCancel = widget.onSelectionHandleDragCancel + ..onEnd = widget.onSelectionHandleDragEnd; + }, + ), + }, + child: Padding( + padding: EdgeInsets.only( + left: padding.left, + top: padding.top, + right: padding.right, + bottom: padding.bottom, + ), + child: widget.selectionControls.buildHandle( + context, + widget.type, + widget.preferredLineHeight, + widget.onSelectionHandleTapped, + ), + ), + ), + ), + ), + ); + } +} + +class _MobileSelectionToolbarController implements MobileSelectionToolbarController { + + final ToolbarMenuBuilder builder; + OverlayEntry? _entry; + + _MobileSelectionToolbarController({ + required this.builder + }); + + @override + void hide(BuildContext context) { + _entry?.remove(); + _entry = null; + } + + @override + void show({ + required BuildContext context, + required CodeLineEditingController controller, + required TextSelectionToolbarAnchors anchors, + Rect? renderRect, + required LayerLink layerLink, + required ValueNotifier visibility, + }) { + hide(context); + final OverlayState? overlay = Overlay.maybeOf(context, rootOverlay: true); + if (overlay == null) { + return; + } + final OverlayEntry entry = OverlayEntry( + builder: (_) => _SelectionToolbarWrapper( + visibility: visibility, + layerLink: layerLink, + offset: -renderRect!.topLeft, + child: builder( + context: context, + anchors: anchors, + controller: controller, + onDismiss: () { + hide(context); + }, + onRefresh: () { + show( + context: context, + controller: controller, + anchors: anchors, + renderRect: renderRect, + layerLink: layerLink, + visibility: visibility + ); + }, + ) + ) + ); + overlay.insert(entry); + _entry = entry; + } + +} + +// TODO(justinmc): Currently this fades in but not out on all platforms. It +// should follow the correct fading behavior for the current platform, then be +// made public and de-duplicated with widgets/selectable_region.dart. +// https://github.com/flutter/flutter/issues/107732 +// Wrap the given child in the widgets common to both contextMenuBuilder and +// TextSelectionControls.buildToolbar. +class _SelectionToolbarWrapper extends StatefulWidget { + const _SelectionToolbarWrapper({ + this.visibility, + required this.layerLink, + required this.offset, + required this.child, + }); + + final Widget child; + final Offset offset; + final LayerLink layerLink; + final ValueListenable? visibility; + + @override + State<_SelectionToolbarWrapper> createState() => _SelectionToolbarWrapperState(); +} + +class _SelectionToolbarWrapperState extends State<_SelectionToolbarWrapper> with SingleTickerProviderStateMixin { + late AnimationController _controller; + Animation get _opacity => _controller.view; + + @override + void initState() { + super.initState(); + + _controller = AnimationController(duration: SelectionOverlay.fadeDuration, vsync: this); + + _toolbarVisibilityChanged(); + widget.visibility?.addListener(_toolbarVisibilityChanged); + } + + @override + void didUpdateWidget(_SelectionToolbarWrapper oldWidget) { + super.didUpdateWidget(oldWidget); + if (oldWidget.visibility == widget.visibility) { + return; + } + oldWidget.visibility?.removeListener(_toolbarVisibilityChanged); + _toolbarVisibilityChanged(); + widget.visibility?.addListener(_toolbarVisibilityChanged); + } + + @override + void dispose() { + widget.visibility?.removeListener(_toolbarVisibilityChanged); + _controller.dispose(); + super.dispose(); + } + + void _toolbarVisibilityChanged() { + if (widget.visibility?.value ?? true) { + _controller.forward(); + } else { + _controller.reverse(); + } + } + + @override + Widget build(BuildContext context) { + return CodeEditorTapRegion( + child: Directionality( + textDirection: Directionality.of(this.context), + child: FadeTransition( + opacity: _opacity, + child: CompositedTransformFollower( + link: widget.layerLink, + showWhenUnlinked: false, + offset: widget.offset, + child: widget.child, + ), + ), + ), + ); + } +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/_code_shortcuts.dart b/packages/re_editor/lib/src/_code_shortcuts.dart new file mode 100644 index 0000000..76b10be --- /dev/null +++ b/packages/re_editor/lib/src/_code_shortcuts.dart @@ -0,0 +1,334 @@ +part of re_editor; + +class _CodeShortcuts extends StatefulWidget { + final CodeShortcutsActivatorsBuilder builder; + final Widget child; + + const _CodeShortcuts({required this.builder, required this.child}); + + @override + State createState() => _CodeShortcutsState(); +} + +class _CodeShortcutsState extends State<_CodeShortcuts> { + late final Map _shortcuts; + + @override + void initState() { + super.initState(); + _shortcuts = {}; + _buildShortcuts(); + } + + @override + void didUpdateWidget(_CodeShortcuts oldWidget) { + super.didUpdateWidget(oldWidget); + if (oldWidget.builder != widget.builder) { + _buildShortcuts(); + } + } + + @override + Widget build(BuildContext context) { + return Shortcuts(shortcuts: _shortcuts, child: widget.child); + } + + void _buildShortcuts() { + _shortcuts.clear(); + for (final CodeShortcutType type in CodeShortcutType.values) { + if (type == CodeShortcutType.backspace) { + if (kIsAndroid || kIsIOS) { + continue; + } + } + final List? activators = widget.builder.build(type); + if (activators == null || activators.isEmpty) { + continue; + } + for (final ShortcutActivator activator in activators) { + _shortcuts[activator] = kCodeShortcutIntents[type]!; + } + } + // Protect space key go to the IME. + _shortcuts.addAll({ + const SingleActivator(LogicalKeyboardKey.space): + const DoNothingAndStopPropagationTextIntent(), + }); + } +} + +class _CodeShortcutActions extends StatelessWidget { + final CodeLineEditingController editingController; + final _CodeInputController inputController; + final CodeFindController? findController; + final CodeCommentFormatter? commentFormatter; + final Map>? overrideActions; + final bool readOnly; + final Widget child; + + const _CodeShortcutActions({ + required this.editingController, + required this.inputController, + this.findController, + this.commentFormatter, + required this.overrideActions, + required this.readOnly, + required this.child, + }); + + @override + Widget build(BuildContext context) { + final Map> actions = {}; + for (final Intent intent in kCodeShortcutIntents.values) { + // Do not add editable actions when read only. + if (intent is CodeShortcutEditableIntent && readOnly) { + continue; + } + if (intent is CodeShortcutEscIntent) { + // Do not enable ESC key when nothing the eidtor can do. + actions[intent.runtimeType] = _EscCallbackAction( + controller: editingController, + findController: findController, + onInvoke: (intent) { + return _onAction(context, intent); + }, + ); + continue; + } + actions[intent.runtimeType] = _CompoDoNothingCallbackAction( + controller: editingController, + onInvoke: (intent) { + return _onAction(context, intent); + }, + ); + } + return Actions(actions: { + ...actions, + ...{ + DoNothingAndStopPropagationTextIntent: + DoNothingAction(consumesKey: false), + }, + if (overrideActions != null) ...overrideActions! + }, child: child); + } + + static final Map actions = { + CodeShortcutSelectAllIntent: (intent, actions) { + actions.editingController.selectAll(); + }, + CodeShortcutLineSelectIntent: (intent, actions) { + actions.editingController.selectLines( + actions.editingController.selection.baseIndex, + actions.editingController.selection.extentIndex); + }, + CodeShortcutCutIntent: (intent, actions) { + actions.editingController.cut(); + }, + CodeShortcutCopyIntent: (intent, actions) { + actions.editingController.copy(); + }, + CodeShortcutPasteIntent: (intent, actions) { + actions.editingController.paste(); + }, + CodeShortcutUndoIntent: (intent, actions) { + actions.editingController.undo(); + }, + CodeShortcutRedoIntent: (intent, actions) { + actions.editingController.redo(); + }, + ShortcutLineDeleteIntent: (intent, actions) { + actions.editingController.deleteSelectionLines(true); + }, + ShortcutLineDeleteDirectionIntent: (intent, actions) { + if ((intent as ShortcutLineDeleteDirectionIntent).forward) { + actions.editingController.deleteLineForward(); + } else { + actions.editingController.deleteLineBackward(); + } + }, + ShortcutLineMoveIntent: (intent, actions) { + if ((intent as ShortcutLineMoveIntent).direction == + VerticalDirection.up) { + actions.editingController.moveSelectionLinesUp(); + } else { + actions.editingController.moveSelectionLinesDown(); + } + }, + CodeShortcutIndentIntent: (intent, actions) { + actions.editingController.applyIndent(); + }, + CodeShortcutOutdentIntent: (intent, actions) { + actions.editingController.applyOutdent(); + }, + CodeShortcutCommentIntent: (intent, actions) { + final CodeLineEditingValue? value = actions.commentFormatter?.format( + actions.editingController.value, + actions.editingController.options.indent, + (intent as CodeShortcutCommentIntent).single); + if (value != null) { + actions.editingController.runRevocableOp(() { + actions.editingController.value = value; + }); + } + }, + CodeShortcutCursorMoveIntent: (intent, actions) { + actions.editingController + .moveCursor((intent as CodeShortcutCursorMoveIntent).direction); + }, + CodeShortcutCursorMoveLineEdgeIntent: (intent, actions) { + if ((intent as CodeShortcutCursorMoveLineEdgeIntent).forward) { + actions.editingController.moveCursorToLineEnd(); + } else { + actions.editingController.moveCursorToLineStart(); + } + }, + CodeShortcutCursorMoveDocEdgeIntent: (intent, actions) { + if ((intent as CodeShortcutCursorMoveDocEdgeIntent).forward) { + actions.editingController.moveCursorToPageEnd(); + } else { + actions.editingController.moveCursorToPageStart(); + } + }, + CodeShortcutCursorMovePageIntent: (intent, actions) { + if ((intent as CodeShortcutCursorMovePageIntent).forward) { + actions.editingController.moveCursorToPageDown(); + } else { + actions.editingController.moveCursorToPageUp(); + } + }, + CodeShortcutCursorMoveWordBoundaryIntent: (intent, actions) { + if ((intent as CodeShortcutCursorMoveWordBoundaryIntent).forward) { + actions.editingController.moveCursorToWordBoundaryForward(); + } else { + actions.editingController.moveCursorToWordBoundaryBackward(); + } + }, + CodeShortcutSelectionExtendIntent: (intent, actions) { + actions.editingController.extendSelection( + (intent as CodeShortcutSelectionExtendIntent).direction); + }, + CodeShortcutSelectionExtendLineEdgeIntent: (intent, actions) { + if ((intent as CodeShortcutSelectionExtendLineEdgeIntent).forward) { + actions.editingController.extendSelectionToLineEnd(); + } else { + actions.editingController.extendSelectionToLineStart(); + } + }, + CodeShortcutSelectionExtendPageEdgeIntent: (intent, actions) { + if ((intent as CodeShortcutSelectionExtendPageEdgeIntent).forward) { + actions.editingController.extendSelectionToPageEnd(); + } else { + actions.editingController.extendSelectionToPageStart(); + } + }, + CodeShortcutSelectionExtendWordBoundaryIntent: (intent, actions) { + if ((intent as CodeShortcutSelectionExtendWordBoundaryIntent).forward) { + actions.editingController.extendSelectionToWordBoundaryForward(); + } else { + actions.editingController.extendSelectionToWordBoundaryBackward(); + } + }, + ShortcutWordDeleteDirectionIntent: (intent, actions) { + if ((intent as ShortcutWordDeleteDirectionIntent).forward) { + actions.editingController.deleteWordForward(); + } else { + actions.editingController.deleteWordBackward(); + } + }, + CodeShortcutDeleteIntent: (intent, actions) { + if ((intent as CodeShortcutDeleteIntent).forward) { + actions.editingController.deleteForward(); + } else { + actions.editingController.deleteBackward(); + } + actions.inputController.notifyListeners(); + }, + CodeShortcutNewLineIntent: (intent, actions) { + actions.editingController.applyNewLine(); + }, + CodeShortcutTransposeCharactersIntent: (intent, actions) { + actions.editingController.transposeCharacters(); + }, + CodeShortcutFindIntent: (intent, actions) { + actions.findController?.findMode(); + }, + CodeShortcutFindToggleMatchCaseIntent: (intent, actions) { + actions.findController?.toggleCaseSensitive(); + }, + CodeShortcutFindToggleRegexIntent: (intent, actions) { + actions.findController?.toggleRegex(); + }, + CodeShortcutReplaceIntent: (intent, actions) { + actions.findController?.replaceMode(); + }, + CodeShortcutEscIntent: (intent, actions) { + if (actions.findController?.value != null) { + actions.findController?.close(); + } else { + actions.editingController.cancelSelection(); + } + } + }; + + Object? _onAction(BuildContext context, Intent intent) { + final Action? action = Actions.maybeFind(context, intent: intent); + if (action != null && + action.isActionEnabled && + action.consumesKey(intent)) { + if (action is CallbackAction) { + action.invoke(intent); + } + return null; + } + if (intent is CodeShortcutEditableIntent && readOnly) { + return null; + } + if (editingController.isComposing) { + return null; + } + bool keepAutoCompleteState = intent is CodeShortcutDeleteIntent; + final handler = actions[intent.runtimeType]; + if (handler != null) { + handler(intent, this); + } + if (!keepAutoCompleteState) { + final _CodeAutocompleteState? autocompleteState = + context.findAncestorStateOfType<_CodeAutocompleteState>(); + autocompleteState?.dismiss(); + } + return intent; + } +} + +class _CompoDoNothingCallbackAction + extends CallbackAction { + final CodeLineEditingController controller; + + _CompoDoNothingCallbackAction({ + required this.controller, + required super.onInvoke, + }); + + @override + bool consumesKey(T intent) { + return !controller.isComposing; + } +} + +class _EscCallbackAction extends CallbackAction { + final CodeLineEditingController controller; + final CodeFindController? findController; + + _EscCallbackAction({ + required this.controller, + required this.findController, + required super.onInvoke, + }); + + @override + bool isEnabled(T intent) { + return !controller.isComposing && + (findController?.value != null || !controller.selection.isCollapsed); + } +} diff --git a/packages/re_editor/lib/src/_code_span.dart b/packages/re_editor/lib/src/_code_span.dart new file mode 100644 index 0000000..700facc --- /dev/null +++ b/packages/re_editor/lib/src/_code_span.dart @@ -0,0 +1,38 @@ +part of re_editor; + +@immutable +class _MouseTrackerAnnotationTextSpan extends TextSpan { + + final int id; + final MouseTrackerAnnotationTextSpan span; + final List rects; + + const _MouseTrackerAnnotationTextSpan({ + required this.id, + required this.rects, + required this.span, + }); + + @override + PointerEnterEventListener? get onEnter => (event) { + span.onEnterWithRect(event, id, rects); + }; + + @override + PointerExitEventListener? get onExit => (event) { + span.onExitWithRect(event, id, rects); + }; + + @override + int get hashCode => span.hashCode; + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is _MouseTrackerAnnotationTextSpan && span == other.span && + id == other.id; + } + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/_consts.dart b/packages/re_editor/lib/src/_consts.dart new file mode 100644 index 0000000..3d978db --- /dev/null +++ b/packages/re_editor/lib/src/_consts.dart @@ -0,0 +1,5 @@ +part of re_editor; + +final kIsMacOS = defaultTargetPlatform == TargetPlatform.macOS; +final kIsAndroid = defaultTargetPlatform == TargetPlatform.android; +final kIsIOS = defaultTargetPlatform == TargetPlatform.iOS; diff --git a/packages/re_editor/lib/src/_isolate.dart b/packages/re_editor/lib/src/_isolate.dart new file mode 100644 index 0000000..ffd4bae --- /dev/null +++ b/packages/re_editor/lib/src/_isolate.dart @@ -0,0 +1,38 @@ +part of re_editor; + +typedef IsolateRunnable = Res Function(Req req); +typedef IsolateCallback = void Function(Res res); + +class _IsolateTasker { + final String name; + late bool _closed; + + late IsolateManager? _isolateManager; + + _IsolateTasker(this.name, IsolateRunnable runnable) { + _closed = false; + _isolateManager = IsolateManager.create( + runnable, + concurrent: 1, // one is enough + ); + } + + void run(Req req, IsolateCallback callback) async { + if (_closed) { + return; + } + _isolateManager?.compute(req, callback: (message) async { + if (_closed) { + return false; + } + callback(message); + return true; + }); + } + + void close() { + _closed = true; + _isolateManager?.stop(); + _isolateManager = null; + } +} diff --git a/packages/re_editor/lib/src/code_autocomplete.dart b/packages/re_editor/lib/src/code_autocomplete.dart new file mode 100644 index 0000000..4e924c6 --- /dev/null +++ b/packages/re_editor/lib/src/code_autocomplete.dart @@ -0,0 +1,310 @@ +part of re_editor; + +/// Define code autocomplate prompt information. +/// +/// See also [CodeKeywordPrompt], [CodeFieldPrompt] and [CodeFunctionPrompt]. +abstract class CodePrompt { + + const CodePrompt({ + required this.word + }); + + /// Content associated with user input. + /// + /// e.g. User input is 're', the prompt word 'return' will be displayed to user. + final String word; + + /// Get the final auto completion content. In most cases it is equal to [word], but there are some exceptions. + /// For example, for functions, auto completion of parameters may be required. + /// + /// e.g. User input is 'he', 'hello(String name)' will be auto completed. + CodeAutocompleteResult get autocomplete; + + /// Check whether the input meets this prompt condition. + bool match(String input); + +} + +/// The keyword autocomplate prompt. such as 'return', 'class', 'new' and so on. +class CodeKeywordPrompt extends CodePrompt { + + const CodeKeywordPrompt({ + required super.word + }); + + @override + CodeAutocompleteResult get autocomplete => CodeAutocompleteResult.fromWord(word); + + @override + bool match(String input) { + return word != input && word.startsWith(input); + } + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeKeywordPrompt && other.word == word; + } + + @override + int get hashCode => word.hashCode; + +} + +/// The field autocomplate prompt. Compared to [CodeKeywordPrompt], +/// type definitions also need to be provided. +/// +/// If a line of code is 'String foo;', 'foo' is the word and 'String' is the type. +class CodeFieldPrompt extends CodePrompt { + + const CodeFieldPrompt({ + required super.word, + required this.type, + this.customAutocomplete, + }); + + /// The field type name. + final String type; + + /// Will use custom autocomplete rather than word if this is not null. + final CodeAutocompleteResult? customAutocomplete; + + @override + CodeAutocompleteResult get autocomplete => customAutocomplete ?? CodeAutocompleteResult.fromWord(word); + + @override + bool match(String input) { + return word != input && word.startsWith(input); + } + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeFieldPrompt && other.word == word && other.type == type + && other.customAutocomplete == customAutocomplete; + } + + @override + int get hashCode => Object.hash(word, type, customAutocomplete); + +} + +/// The function autocomplate prompt. +class CodeFunctionPrompt extends CodePrompt { + + const CodeFunctionPrompt({ + required super.word, + required this.type, + this.parameters = const {}, + this.optionalParameters = const {}, + this.customAutocomplete, + }); + + /// The function return type. + final String type; + + /// The function required parameters. + final Map parameters; + + /// The function optional parameters. + final Map optionalParameters; + + /// Will use custom autocomplete rather than word if this is not null. + final CodeAutocompleteResult? customAutocomplete; + + @override + CodeAutocompleteResult get autocomplete => customAutocomplete ?? CodeAutocompleteResult.fromWord('$word(${parameters.keys.join(', ')})'); + + @override + bool match(String input) { + return word != input && word.startsWith(input); + } + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeFunctionPrompt && other.word == word && other.type == type && + mapEquals(other.parameters, parameters) && mapEquals(other.optionalParameters, optionalParameters) + && other.customAutocomplete == customAutocomplete; + } + + @override + int get hashCode => Object.hash(word, type, parameters, optionalParameters, customAutocomplete); + +} + +/// The autocomplete result selected by user, the editor will apply this +/// to code content. +class CodeAutocompleteResult { + + const CodeAutocompleteResult({ + required this.input, + required this.word, + required this.selection + }); + + factory CodeAutocompleteResult.fromWord(String word) { + return CodeAutocompleteResult( + input: '', + word: word, + selection: TextSelection.collapsed( + offset: word.length + ) + ); + } + + /// The autocomplete text. + /// e.g. + /// If user inputs `go` and the word is `good`, we will replace `go` with `good`. + final String input; + final String word; + + /// The new selection after the autocompletion. + final TextSelection selection; + +} + +/// The current user input and prompts for editing a run of text. +class CodeAutocompleteEditingValue { + + const CodeAutocompleteEditingValue({ + required this.input, + required this.prompts, + required this.index, + }); + + /// User input content. + final String input; + + /// Matched code prompts. + final List prompts; + + /// Current selected code prompt. + final int index; + + CodeAutocompleteEditingValue copyWith({ + String? input, + List? prompts, + int? index, + }) { + return CodeAutocompleteEditingValue( + input: input ?? this.input, + prompts: prompts ?? this.prompts, + index: index ?? this.index, + ); + } + + CodeAutocompleteResult get autocomplete { + final CodeAutocompleteResult result = prompts[index].autocomplete; + if (result.word.isEmpty) { + return result; + } + final TextSelection finalSelection = result.selection.copyWith( + baseOffset: result.selection.baseOffset - input.length, + extentOffset: result.selection.extentOffset - input.length, + ); + return CodeAutocompleteResult( + input: input, + word: result.word, + selection: finalSelection, + ); + } + +} + +/// Builds the overlay autocomplete prompts view. +typedef CodeAutocompleteWidgetBuilder = PreferredSizeWidget Function( + BuildContext context, + ValueNotifier notifier, + ValueChanged onSelected +); + +/// The autocomplete prompts builder. +abstract class CodeAutocompletePromptsBuilder { + + /// Build the prompts with the current code. + CodeAutocompleteEditingValue? build( + BuildContext context, + CodeLine codeLine, + CodeLineSelection selection, + ); + +} + +/// The default autocomplete prompts builder. +abstract class DefaultCodeAutocompletePromptsBuilder implements CodeAutocompletePromptsBuilder { + + /// Constructs the builder with defined prompts. + factory DefaultCodeAutocompletePromptsBuilder({ + Mode? language, + List keywordPrompts = const [], + List directPrompts = const [], + Map> relatedPrompts = const {}, + }) => _DefaultCodeAutocompletePromptsBuilder( + language: language, + keywordPrompts: keywordPrompts, + directPrompts: directPrompts, + relatedPrompts: relatedPrompts, + ); + +} + +/// A widget enables code autocomplete for [CodeEditor]. +/// +/// Developers can customize the view styles and prompt logic they need. +/// +/// The following is a common usage. +/// +/// ``` +/// CodeAutocomplete( +/// viewBuilder: (context, notifier, onSelected) { +/// // TODO build the options list widget. +/// }, +/// promptsBuilder: DefaultCodeAutocompletePromptsBuilder( +/// language: langDart, +/// directPrompts: [ +/// CodeFieldPrompt( +/// word: 'foo', +/// type: 'String' +/// ), +/// CodeFunctionPrompt( +/// word: 'hello', +/// type: 'void', +/// parameters: { +/// 'value': 'String', +/// } +/// ) +/// ], +/// ), +/// child: CodeEditor() +/// ) +/// ``` +class CodeAutocomplete extends StatelessWidget { + + const CodeAutocomplete({ + super.key, + required this.viewBuilder, + required this.promptsBuilder, + required this.child, + }); + + final CodeAutocompleteWidgetBuilder viewBuilder; + final CodeAutocompletePromptsBuilder promptsBuilder; + final Widget child; + + @override + Widget build(BuildContext context) { + return _CodeAutocomplete( + viewBuilder: viewBuilder, + promptsBuilder: promptsBuilder, + child: child + ); + } + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/code_chunk.dart b/packages/re_editor/lib/src/code_chunk.dart new file mode 100644 index 0000000..f964f99 --- /dev/null +++ b/packages/re_editor/lib/src/code_chunk.dart @@ -0,0 +1,363 @@ +part of re_editor; + +class CodeChunkController extends ValueNotifier> { + + late final CodeLineEditingController _controller; + final CodeChunkAnalyzer _analyzer; + + late final _IsolateTasker<_CodeChunkAnalyzePayload, _CodeChunkAnalyzeResult> _tasker; + + late bool _shouldNotUpdateChunks; + + CodeChunkController(CodeLineEditingController controller, this._analyzer) : super(const []) { + _controller = controller is _CodeLineEditingControllerDelegate ? controller.delegate : controller; + _controller.addListener(_onCodeChanged); + _tasker = _IsolateTasker<_CodeChunkAnalyzePayload, _CodeChunkAnalyzeResult>('CodeChunk', _run); + _shouldNotUpdateChunks = false; + _runChunkAnalyzeTask(); + } + + void collapse(int index) { + final CodeChunk? chunk = findByIndex(index); + if (chunk == null) { + // Not support to collapse + return; + } + if (!chunk.canCollapse) { + // Has collapsed or nothing to collapse + return; + } + final List codeChunks = List.of(value); + // Remove sub chunks + codeChunks.removeWhere((e) => e.index > chunk.index && e.end < chunk.end); + // Chunks after the collapsed should adjust the offset + for (int i = 0; i < codeChunks.length; i++) { + final CodeChunk e = codeChunks[i]; + if (e.index >= index || e.end >= index) { + codeChunks[i] = CodeChunk(e.index > index ? e.index - chunk.collapseSize : e.index, + e.end > index ? e.end - chunk.collapseSize : e.end + ); + } + } + value = codeChunks; + _shouldNotUpdateChunks = true; + _controller.collapseChunk(chunk.index, chunk.end); + _shouldNotUpdateChunks = false; + } + + void expand(int index) { + final CodeLine codeLine = _controller.codeLines[index]; + if (!codeLine.chunkParent) { + // Nothing to expand, this should not happen. + return; + } + final List codeChunks = List.of(value); + bool exists = false; + for (int i = 0; i < codeChunks.length; i++) { + final CodeChunk e = codeChunks[i]; + if (e.index >= index || e.end >= index) { + codeChunks[i] = CodeChunk(e.index > index ? e.index + codeLine.chunks.length : e.index, + e.end > index ? e.end + codeLine.chunks.length : e.end + ); + } + if (e.index == index) { + exists = true; + } + } + // Add self into the chunks if not exists + if (!exists) { + codeChunks.add(CodeChunk(index, index + codeLine.chunks.length + 1)); + // sort by index + codeChunks.sort((a, b) => a.index - b.index); + } + value = codeChunks; + _controller.expandChunk(index); + } + + void toggle(int index) { + if (_controller.codeLines[index].chunkParent) { + expand(index); + } else { + collapse(index); + } + } + + CodeChunk? findByIndex(int index) { + for (final CodeChunk chunk in value) { + if (chunk.index == index) { + return chunk; + } else if (chunk.index > index) { + break; + } + } + return null; + } + + bool canCollapse(int index) { + return findByIndex(index)?.canCollapse ?? false; + } + + @override + void dispose() { + _controller.removeListener(_onCodeChanged); + _tasker.close(); + super.dispose(); + } + + void _onCodeChanged() { + if (_shouldNotUpdateChunks) { + return; + } + if (_controller.codeLines.length < 3 && value.isEmpty) { + value = []; + return; + } + if (_controller.codeLines.equals(_controller.preValue?.codeLines)) { + return; + } + _runChunkAnalyzeTask(); + } + + void _runChunkAnalyzeTask() { + final CodeLines codeLines = _controller.codeLines; + _tasker.run(_CodeChunkAnalyzePayload(_analyzer, codeLines), (result) { + if (_controller.codeLines.equals(codeLines)) { + value = result.chunks; + _expandInvalidCollapsedChunks(result.invalidCollapsedChunkIndexes); + } + }); + } + + void _expandInvalidCollapsedChunks(List indexes) { + // Expand invalid chunks from bottom to top + for (int i = indexes.length - 1; i >=0; i--) { + expand(indexes[i]); + } + } + + @pragma('vm:entry-point') + static _CodeChunkAnalyzeResult _run(_CodeChunkAnalyzePayload payload) { + final List chunks = payload.analyzer.run(payload.codeLines); + final List invalidCollapsedChunkIndexes = []; + for (int i = 0; i < payload.codeLines.length; i++) { + if (!payload.codeLines[i].chunkParent) { + continue; + } + final int index = chunks.indexWhere((e) => e.index == i); + if (index < 0 || chunks[index].canCollapse) { + invalidCollapsedChunkIndexes.add(i); + } + } + return _CodeChunkAnalyzeResult(chunks, invalidCollapsedChunkIndexes); + } + +} + +class CodeChunk { + + final int index; + final int end; + + const CodeChunk(this.index, this.end); + + bool get canCollapse => collapseSize > 0; + + int get collapseSize => end - index - 1; + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeChunk + && other.index == index + && other.end == end; + } + + @override + int get hashCode => Object.hash(index, end); + + @override + String toString() { + return '[$index, $end]'; + } + +} + +abstract class CodeChunkAnalyzer { + + List run(CodeLines codeLines); + +} + +class NonCodeChunkAnalyzer implements CodeChunkAnalyzer { + + const NonCodeChunkAnalyzer(); + + @override + List run(CodeLines codeLines) => const []; + +} + +class DefaultCodeChunkAnalyzer implements CodeChunkAnalyzer { + + static const Map _chunkSymbols = { + '(': ')', + '[': ']', + '{': '}' + }; + static final List _tokens = '"\'()[]{}'.codeUnits; + + const DefaultCodeChunkAnalyzer(); + + @override + List run(CodeLines codeLines) { + final List chunks = []; + final List stack = []; + final List chunkSymbols = parse(codeLines); + for (final CodeChunkSymbol symbol in chunkSymbols) { + if (_chunkSymbols.keys.contains(symbol.value)) { + stack.add(symbol); + continue; + } + while(stack.isNotEmpty) { + final CodeChunkSymbol pop = stack.removeLast(); + if (_chunkSymbols[pop.value] == symbol.value) { + if (symbol.index - pop.index >= 1 && chunks.where((e) => e.index == pop.index).isEmpty) { + chunks.add(CodeChunk(pop.index, symbol.index)); + } + break; + } + } + } + // sort by index + chunks.sort((a, b) => a.index - b.index); + return chunks; + } + + @visibleForTesting + List parse(CodeLines codeLines) { + final List symbols = []; + for (int i = 0; i < codeLines.length; i++) { + final String text = codeLines[i].text.trim(); + if (text.isEmpty) { + continue; + } + symbols.addAll(_parseLine(text, i)); + } + return symbols; + } + + List _parseLine(String text, int index) { + final List symbols = []; + const int normal = 0; + const int inQuote = 1; + const int inDoubleQuote = 2; + bool inEscapeQuote = false; + bool inEscapeDoubleQuote = false; + int state = normal; + final List codeUnits = text.codeUnits; + for (int i = 0; i < codeUnits.length; i++) { + if (!_tokens.contains(codeUnits[i])) { + continue; + } + final String character = String.fromCharCode(codeUnits[i]); + if (state == inQuote) { + if (character == '\'' && !isPreEscapeChar(codeUnits, i)) { + state = normal; + } + } else if (state == inDoubleQuote) { + if (character == '"' && !isPreEscapeChar(codeUnits, i)) { + state = normal; + } + } else { + if (character == '\'') { + if (inEscapeQuote) { + if (isPreEscapeChar(codeUnits, i)) { + inEscapeQuote = false; + } else { + // Unbalanced escape quotes + break; + } + } else { + if (isPreEscapeChar(codeUnits, i)) { + inEscapeQuote = true; + } else { + state = inQuote; + } + } + } else if (character == '"') { + if (inEscapeDoubleQuote) { + if (isPreEscapeChar(codeUnits, i)) { + inEscapeDoubleQuote = false; + } else { + // Unbalanced escape double quotes + break; + } + } else { + if (isPreEscapeChar(codeUnits, i)) { + inEscapeDoubleQuote = true; + } else { + state = inDoubleQuote; + } + } + } else { + if (!inEscapeQuote && !inEscapeDoubleQuote) { + symbols.add(CodeChunkSymbol(character, index)); + } + } + } + } + return symbols; + } + + bool isPreEscapeChar(List codeUnits, int index) { + return index > 0 && codeUnits[index - 1] == '\\'.codeUnits.first; + } + +} + +class CodeChunkSymbol { + + final String value; + final int index; + + const CodeChunkSymbol(this.value, this.index); + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeChunkSymbol + && other.value == value + && other.index == index; + } + + @override + int get hashCode => Object.hash(value, index); + + @override + String toString() { + return '$value@$index'; + } + +} + +class _CodeChunkAnalyzePayload { + + final CodeChunkAnalyzer analyzer; + final CodeLines codeLines; + + const _CodeChunkAnalyzePayload(this.analyzer, this.codeLines); + +} + +class _CodeChunkAnalyzeResult { + + final List chunks; + final List invalidCollapsedChunkIndexes; + + const _CodeChunkAnalyzeResult(this.chunks, this.invalidCollapsedChunkIndexes); + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/code_editor.dart b/packages/re_editor/lib/src/code_editor.dart new file mode 100644 index 0000000..f23d031 --- /dev/null +++ b/packages/re_editor/lib/src/code_editor.dart @@ -0,0 +1,641 @@ +part of re_editor; + +/// An immutable style describing how to format and paint editor content. +class CodeEditorStyle { + + /// Creates a code editor style. + const CodeEditorStyle({ + this.fontSize, + this.fontFamily, + this.fontFamilyFallback, + this.fontHeight, + this.textColor, + this.hintTextColor, + this.backgroundColor, + this.selectionColor, + this.highlightColor, + this.cursorColor, + this.cursorWidth, + this.cursorLineColor, + this.chunkIndicatorColor, + this.codeTheme, + }) : assert(fontSize == null || fontSize > 0), + assert(fontHeight == null || fontHeight >= 1.0), + assert(cursorWidth == null || cursorWidth > 0); + + /// The size of fonts (in logical pixels) to use when painting the text. + /// + /// The value specified matches the dimension of the + /// [em square](https://fonts.google.com/knowledge/glossary/em) of the + /// underlying font, and more often then not isn't exactly the height or the + /// width of glyphs in the font. + /// + /// Default value is 13.0 pixels. + final double? fontSize; + + /// The name of the font to use when painting the text (e.g., Roboto). + /// + /// If the font is defined in a package, this will be prefixed with + /// 'packages/package_name/' (e.g. 'packages/cool_fonts/Roboto'). The + /// prefixing is done by the constructor when the `package` argument is + /// provided. + /// + /// The value provided in [fontFamily] will act as the preferred/first font + /// family that glyphs are looked for in, followed in order by the font families + /// in [fontFamilyFallback]. When [fontFamily] is null or not provided, the + /// first value in [fontFamilyFallback] acts as the preferred/first font + /// family. When neither is provided, then the default platform font will + /// be used. + final String? fontFamily; + + /// The ordered list of font families to fall back on when a glyph cannot be + /// found in a higher priority font family. + /// + /// The value provided in [fontFamily] will act as the preferred/first font + /// family that glyphs are looked for in, followed in order by the font families + /// in [fontFamilyFallback]. If all font families are exhausted and no match + /// was found, the default platform font family will be used instead. + /// + /// When [fontFamily] is null or not provided, the first value in [fontFamilyFallback] + /// acts as the preferred/first font family. When neither is provided, then + /// the default platform font will be used. Providing an empty list or null + /// for this property is the same as omitting it. + /// + /// For example, if a glyph is not found in [fontFamily], then each font family + /// in [fontFamilyFallback] will be searched in order until it is found. If it + /// is not found, then a box will be drawn in its place. + /// + /// If the font is defined in a package, each font family in the list will be + /// prefixed with 'packages/package_name/' (e.g. 'packages/cool_fonts/Roboto'). + /// The package name should be provided by the `package` argument in the + /// constructor. + final List? fontFamilyFallback; + + /// The height of this text span, as a multiple of the font size. + /// + /// When [fontHeight] is null or omitted, the line height will be determined + /// by the font's metrics directly, which may differ from the fontSize. + /// When [fontHeight] is non-null, the line height of the span of text will be a + /// multiple of [fontSize] and be exactly `fontSize * height` logical pixels + /// tall. + /// + /// For most fonts, setting [fontHeight] to 1.0 is not the same as omitting or + /// setting height to null because the [fontSize] sets the height of the EM-square, + /// which is different than the font provided metrics for line height. The + /// following diagram illustrates the difference between the font-metrics + /// defined line height and the line height produced with `height: 1.0` + /// (which forms the upper and lower edges of the EM-square): + /// + /// See [StrutStyle] and [TextHeightBehavior] for further control of line + /// height at the paragraph level. + final double? fontHeight; + + /// The color to use when painting the text. + /// + /// The [textColor] property is shorthand for `Paint()..color = color`. + final Color? textColor; + + /// The color to use when painting the hint text. + /// + /// The [hintTextColor] property is shorthand for `Paint()..color = color`. + final Color? hintTextColor; + + /// The color to use as the background for the editor. + /// + /// Note, this is not the text background color. + final Color? backgroundColor; + + /// The color to use as the background for the selected text. + /// + /// The paint layer is under [highlightColor]. + final Color? selectionColor; + + /// The color to use as the background for the highlighted text, such as + /// the search matched text. + /// + /// The paint layer is above [selectionColor]. + final Color? highlightColor; + + /// The color of the cursor. + /// + /// The cursor indicates the current location of text insertion point in + /// the field. + /// + /// If this is null it will default to the ambient + /// [DefaultSelectionStyle.cursorColor]. If that is null, and the + /// [ThemeData.platform] is [TargetPlatform.iOS] or [TargetPlatform.macOS] + /// it will use [CupertinoThemeData.primaryColor]. Otherwise it will use + /// the value of [ColorScheme.primary] of [ThemeData.colorScheme]. + final Color? cursorColor; + + /// How thick the cursor will be. + /// + /// Defaults to 2.0. + /// + /// The cursor will draw under the text. The cursor width will extend + /// to the right of the boundary between characters for left-to-right text + /// and to the left for right-to-left text. This corresponds to extending + /// downstream relative to the selected position. Negative values may be used + /// to reverse this behavior. + final double? cursorWidth; + + /// The color to use as the border for the focused line. + final Color? cursorLineColor; + + /// The color of the chunked indicator at the end of the line. + final Color? chunkIndicatorColor; + + /// The code syntax highlighting rules and styles. + final CodeHighlightTheme? codeTheme; + +} + +/// Creates a code editor. +/// +/// You can freely define the styles of the editor, such as text style, +/// line number view, search view, scroll bar, etc. +/// +/// Similar to [TextField], editor uses [CodeLineEditingController] as the content controller. +/// You can create a controller using the following code. +/// +/// ```dart +/// final controller = CodeLineEditingController.fromText('Hello World'); +/// ``` +/// or +/// ```dart +/// final controller = CodeLineEditingController.fromFile('/Users/megatronking/hello.py'); +/// ``` +/// +/// If [wordWrap] mode is turned off, the editor will support both horizontal and vertical scrolling, +/// and you can use [CodeScrollController] to control the scrolling. +/// +/// You can use [CodeFindBuilder] to create search widget and use [CodeFindController] to control the widget and +/// search actions. +/// +/// The editor has many built-in shortcut key actions. If you need to customize shortcut keys, you can use +/// [shortcutsActivatorsBuilder] or [shortcutOverrideActions]. By default, the editor will use [DefaultCodeShortcutsActivatorsBuilder]. +/// +/// Regarding code folding, you can write a custom code folding analyzer with [chunkAnalyzer]. +/// By default, the editor will use [DefaultCodeChunkAnalyzer]. This works for some commonly used languages, +/// but may not work for some languages (such as python). +class CodeEditor extends StatefulWidget { + + const CodeEditor({ + super.key, + this.controller, + this.scrollController, + this.findController, + this.toolbarController, + this.onChanged, + this.style, + this.hint, + this.padding, + this.margin, + this.indicatorBuilder, + this.scrollbarBuilder, + this.verticalScrollbarWidth, + this.horizontalScrollbarHeight, + this.findBuilder, + this.shortcutsActivatorsBuilder, + this.shortcutOverrideActions, + this.leadingDivider, + this.border, + this.borderRadius, + this.clipBehavior = Clip.none, + this.readOnly, + this.showCursorWhenReadOnly, + this.wordWrap, + this.autocompleteSymbols, + this.autofocus, + this.focusNode, + this.maxLengthSingleLineRendering, + this.chunkAnalyzer, + this.commentFormatter, + }) : assert(indicatorBuilder != null || (indicatorBuilder == null && leadingDivider == null)); + + /// Similar to [TextField], editor uses [CodeLineEditingController] as the content controller. + final CodeLineEditingController? controller; + + /// Controls horizontal and vertical scrolling. + final CodeScrollController? scrollController; + + /// Controls the search widget and actions. + final CodeFindController? findController; + + /// Controls the selection toolbar. + final SelectionToolbarController? toolbarController; + + /// Called when the user initiates a change to the editor's + /// value was changed, such as insertion or deletion. + /// + /// Same as [CodeLineEditingController.addListener]. + final ValueChanged? onChanged; + + /// The style to use for the editor. + final CodeEditorStyle? style; + + /// Text that suggests what sort of input the field accepts. + final String? hint; + + /// The padding of the editor field, excludes the addtional wdigets like line number widget. + final EdgeInsetsGeometry? padding; + + /// The margin value of the whole editor, includes the addtional wdigets like line number widget. + final EdgeInsetsGeometry? margin; + + /// Use this to build your own indicator widget like line number widget. + /// See [DefaultCodeLineNumber] and [DefaultCodeChunkIndicator]. + final CodeIndicatorBuilder? indicatorBuilder; + + /// Use this to build your own scroll bar widget. + final CodeScrollbarBuilder? scrollbarBuilder; + + /// The width of the vertical scrollbar. + final double? verticalScrollbarWidth; + + /// The height of the horizontal scrollbar. + final double? horizontalScrollbarHeight; + + /// Use this to build your own search widget. + /// The search widget will appear on the top of editor field. + final CodeFindBuilder? findBuilder; + + /// Customize your shortcut keys. + final CodeShortcutsActivatorsBuilder? shortcutsActivatorsBuilder; + + /// Override built-in shortcut key actions. + final Map>? shortcutOverrideActions; + + /// A leadingDivider widget between indicator and editor field. + final Widget? leadingDivider; + + /// The border of the editor. + final Border? border; + + /// The radius of the editor's border corners. + /// + /// This defines how rounded the corners of the editor's border will appear. + /// + /// If null, the corners will not be rounded. + final BorderRadius? borderRadius; + + + /// How the content should be clipped if it overflows the editor's bounds. + final Clip clipBehavior; + + /// Whether the text can be changed. + /// + /// When this is set to true, the text cannot be modified + /// by any shortcut or keyboard operation. The text is still selectable. + /// + /// Defaults to false. + final bool? readOnly; + + /// Whether to show cursor when in readonly mode. + /// + /// The cursor refers to the blinking caret when the editor is focused. + final bool? showCursorWhenReadOnly; + + /// Should wrap the word. + final bool? wordWrap; + + /// When entering a closed symbol, should the other half be automatically completed. + /// For example, when entering a double quote, the other half will be automatically added. + /// Defaults to true. + final bool? autocompleteSymbols; + + /// Whether this editor field should focus itself if nothing else is already + /// focused. + /// + /// If true, the keyboard will open as soon as this text field obtains focus. + /// Otherwise, the keyboard is only shown after the user taps the editor field. + /// + /// Defaults to false. + final bool? autofocus; + + /// Controls whether this widget has keyboard focus. + final FocusNode? focusNode; + + /// The maximum number of characters per line to render. + /// + /// Due to the performance limitations of the Skia text engine, + /// setting a reasonable length can improve the performance of the editor. + /// + /// If null, there is no limit. + final int? maxLengthSingleLineRendering; + + /// Decide which parts of code can be folded. + /// + /// Defaults to [DefaultCodeChunkAnalyzer]. + /// + /// If you wish to turn off code folding, you can use [NonCodeChunkAnalyzer]. + final CodeChunkAnalyzer? chunkAnalyzer; + + /// Control how one or more lines of code are commented. + final CodeCommentFormatter? commentFormatter; + + @override + State createState() => _CodeEditorState(); + +} + +class _CodeEditorState extends State { + + late final GlobalKey _editorKey; + late FocusNode _focusNode; + late _CodeLineEditingControllerDelegate _editingController; + late final _CodeInputController _inputController; + late final _CodeFloatingCursorController _floatingCursorController; + late CodeScrollController _scrollController; + late CodeFindController _findController; + late CodeChunkController _chunkController; + + final LayerLink _startHandleLayerLink = LayerLink(); + final LayerLink _endHandleLayerLink = LayerLink(); + final LayerLink _toolbarLayerLink = LayerLink(); + final ValueNotifier _effectiveToolbarVisibility = ValueNotifier(true); + + late _SelectionOverlayController _selectionOverlayController; + + @override + void initState() { + super.initState(); + _editorKey = GlobalKey(); + _focusNode = widget.focusNode ?? FocusNode(); + _editingController = _CodeLineEditingControllerDelegate(); + _editingController.delegate = widget.controller ?? CodeLineEditingController(); + _editingController.bindEditor(_editorKey); + + _floatingCursorController = _CodeFloatingCursorController(); + + _inputController = _CodeInputController( + controller: _editingController, + floatingCursorController: _floatingCursorController, + focusNode: _focusNode, + readOnly: widget.readOnly ?? false, + autocompleteSymbols: widget.autocompleteSymbols ?? true, + ); + _inputController.bindEditor(_editorKey); + + _findController = widget.findController ?? CodeFindController(_editingController); + _findController.addListener(_updateWidget); + _scrollController = widget.scrollController ?? CodeScrollController(); + _scrollController.bindEditor(_editorKey); + _chunkController = CodeChunkController(_editingController, widget.chunkAnalyzer ?? const DefaultCodeChunkAnalyzer()); + + _selectionOverlayController = kIsAndroid || kIsIOS ? _MobileSelectionOverlayController( + context: context, + controller: _editingController, + editorKey: _editorKey, + startHandleLayerLink: _startHandleLayerLink, + endHandleLayerLink: _endHandleLayerLink, + toolbarVisibility: _effectiveToolbarVisibility, + focusNode: _focusNode, + onShowToolbar: (context, anchors, renderRect) { + widget.toolbarController?.show( + context: _editorKey.currentContext ?? context, + controller: _editingController, + anchors: anchors, + renderRect: renderRect, + layerLink: _toolbarLayerLink, + visibility: _effectiveToolbarVisibility, + ); + }, + onHideToolbar: () { + widget.toolbarController?.hide(context); + }, + ) : _DesktopSelectionOverlayController( + onShowToolbar: (context, anchors, renderRect) { + widget.toolbarController?.show( + context: context, + controller: _editingController, + anchors: anchors, + renderRect: renderRect, + layerLink: _toolbarLayerLink, + visibility: _effectiveToolbarVisibility, + ); + }, + onHideToolbar: () { + widget.toolbarController?.hide(context); + }, + ); + } + + @override + void dispose() { + _findController.removeListener(_updateWidget); + if (widget.focusNode == null) { + _focusNode.dispose(); + } + if (widget.controller == null) { + _editingController.dispose(); + } + _inputController.dispose(); + if (widget.findController == null) { + _findController.dispose(); + } + if (widget.scrollController== null) { + _scrollController.dispose(); + } + _chunkController.dispose(); + _selectionOverlayController.dispose(); + _floatingCursorController.dispose(); + super.dispose(); + } + + @override + void didUpdateWidget(covariant CodeEditor oldWidget) { + if (oldWidget.focusNode != widget.focusNode) { + if (oldWidget.focusNode == null) { + _focusNode.dispose(); + } + _focusNode = widget.focusNode ?? FocusNode(); + _inputController.focusNode = _focusNode; + } + if (oldWidget.controller != widget.controller) { + if (oldWidget.controller == null) { + _editingController.dispose(); + } + _editingController.delegate = widget.controller ?? CodeLineEditingController(); + _editingController.bindEditor(_editorKey); + } + if (oldWidget.findController != widget.findController || oldWidget.controller != widget.controller) { + final CodeFindController oldFindController = _findController; + if (oldWidget.findController == null) { + oldFindController.dispose(); + } else { + oldFindController.removeListener(_updateWidget); + } + _findController = widget.findController ?? CodeFindController(_editingController); + _findController.addListener(_updateWidget); + } + if (oldWidget.scrollController != widget.scrollController) { + if (oldWidget.scrollController == null) { + _scrollController.dispose(); + } + _scrollController = widget.scrollController ?? CodeScrollController(); + _scrollController.bindEditor(_editorKey); + } + if (oldWidget.chunkAnalyzer != widget.chunkAnalyzer || oldWidget.controller != widget.controller) { + _chunkController.dispose(); + _chunkController = CodeChunkController(_editingController, widget.chunkAnalyzer ?? const DefaultCodeChunkAnalyzer()); + } + if (oldWidget.readOnly != widget.readOnly) { + _inputController.readOnly = widget.readOnly ?? false; + } + if (oldWidget.autocompleteSymbols != widget.autocompleteSymbols) { + _inputController.autocompleteSymbols = widget.autocompleteSymbols ?? true; + } + super.didUpdateWidget(oldWidget); + } + + @override + Widget build(BuildContext context) { + final ThemeData theme = Theme.of(context); + final TextSelectionThemeData selectionTheme = TextSelectionTheme.of(context); + final TextStyle baseStyle = TextStyle( + fontSize: widget.style?.fontSize ?? _kDefaultTextSize, + fontFamily: widget.style?.fontFamily, + fontFamilyFallback: widget.style?.fontFamilyFallback, + height: widget.style?.fontHeight ?? _kDefaultFontHeight, + ); + final bool readOnly = widget.readOnly ?? false; + final bool autofocus = widget.autofocus ?? true; + final bool wordWrap = widget.wordWrap ?? true; + final PreferredSizeWidget? find = widget.findBuilder?.call(context, _findController, readOnly); + final Widget editable = _CodeEditable( + editorKey: _editorKey, + hint: widget.hint, + indicatorBuilder: widget.indicatorBuilder, + scrollbarBuilder: widget.scrollbarBuilder, + verticalScrollbarWidth: widget.verticalScrollbarWidth, + horizontalScrollbarHeight: widget.horizontalScrollbarHeight, + textStyle: baseStyle.copyWith( + color: widget.style?.textColor ?? theme.textTheme.bodyLarge?.color, + ), + hintTextColor: widget.style?.hintTextColor, + backgroundColor: widget.style?.backgroundColor, + selectionColor: widget.style?.selectionColor ?? selectionTheme.selectionColor ?? theme.colorScheme.primary.withOpacity(0.4), + highlightColor: widget.style?.highlightColor ?? selectionTheme.selectionColor ?? theme.colorScheme.primary.withOpacity(0.4), + cursorColor: widget.style?.cursorColor ?? selectionTheme.cursorColor ?? theme.colorScheme.primary, + cursorLineColor: widget.style?.cursorLineColor, + chunkIndicatorColor: widget.style?.chunkIndicatorColor, + cursorWidth: widget.style?.cursorWidth ?? _kDefaultCaretWidth, + showCursorWhenReadOnly: widget.showCursorWhenReadOnly ?? true, + leadingDivider: widget.leadingDivider, + border: widget.border, + borderRadius: widget.borderRadius, + clipBehavior: widget.clipBehavior, + onChanged: widget.onChanged, + focusNode: _focusNode, + padding: (widget.padding ?? _kDefaultPadding).add(EdgeInsets.only( + top: find == null ? 0 : find.preferredSize.height + )), + margin: widget.margin ?? EdgeInsets.zero, + controller: _editingController, + inputController: _inputController, + codeTheme: widget.style?.codeTheme, + readOnly: readOnly, + autofocus: autofocus, + wordWrap: wordWrap, + maxLengthSingleLineRendering: widget.maxLengthSingleLineRendering, + findController: _findController, + scrollController: _scrollController, + chunkController: _chunkController, + floatingCursorController: _floatingCursorController, + startHandleLayerLink: _startHandleLayerLink, + endHandleLayerLink: _endHandleLayerLink, + toolbarLayerLink: _toolbarLayerLink, + selectionOverlayController: _selectionOverlayController, + ); + final Widget detector = _CodeSelectionGestureDetector( + controller: _editingController, + inputController: _inputController, + chunkController: _chunkController, + selectionOverlayController: _selectionOverlayController, + behavior: HitTestBehavior.translucent, + editorKey: _editorKey, + child: editable + ); + final Widget child; + if (kIsAndroid || kIsIOS) { + child = Focus( + autofocus: autofocus, + focusNode: _focusNode, + onKey: (node, event) { + if (event.isKeyPressed(LogicalKeyboardKey.backspace)) { + _editingController.deleteBackward(); + return KeyEventResult.handled; + } else if (event.isKeyPressed(LogicalKeyboardKey.enter)) { + _editingController.applyNewLine(); + return KeyEventResult.handled; + } + return KeyEventResult.ignored; + }, + includeSemantics: false, + debugLabel: 'CodeEditor', + child: detector + ); + } else { + child = _CodeShortcuts( + builder: widget.shortcutsActivatorsBuilder ?? const DefaultCodeShortcutsActivatorsBuilder(), + child: _CodeShortcutActions( + editingController: _editingController, + inputController: _inputController, + findController: find != null ? _findController : null, + commentFormatter: widget.commentFormatter, + overrideActions: widget.shortcutOverrideActions, + readOnly: readOnly, + child: Focus( + autofocus: autofocus, + focusNode: _focusNode, + includeSemantics: false, + debugLabel: 'CodeEditor', + child: detector + ) + ), + ); + } + return Stack( + children: [ + child, + if (find != null) + find, + ], + ); + } + + void _updateWidget() { + setState(() { + }); + } + +} + +/// A [TapRegion] that adds its children to the tap region group for widgets +/// based on the [CodeEditor] widget. +/// +/// Widgets that are wrapped with a [CodeEditorTapRegion] are considered to be +/// part of the editor for purposes of unfocus behavior. So, when the user +/// taps on them, the currently focused editor won't be unfocused by +/// default. +/// +/// See also: +/// +/// * [TapRegion], the widget that this widget uses to add widgets to the group +/// of text fields. +class CodeEditorTapRegion extends TapRegion { + + /// Creates a const [CodeEditorTapRegion]. + /// + /// The [child] field is required. + const CodeEditorTapRegion({ + super.key, + required super.child, + super.enabled = true, + super.behavior = HitTestBehavior.deferToChild, + super.onTapOutside, + super.onTapInside, + }) : super(groupId: CodeEditor); + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/code_find.dart b/packages/re_editor/lib/src/code_find.dart new file mode 100644 index 0000000..911aaa5 --- /dev/null +++ b/packages/re_editor/lib/src/code_find.dart @@ -0,0 +1,224 @@ +part of re_editor; + +typedef CodeFindBuilder = PreferredSizeWidget Function(BuildContext context, CodeFindController controller, bool readonly); + +class CodeFindValue { + + final CodeFindOption option; + final bool replaceMode; + final CodeFindResult? result; + final bool searching; + + const CodeFindValue({ + required this.option, + required this.replaceMode, + this.result, + this.searching = false, + }); + + const CodeFindValue.empty() : this( + option: const CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + replaceMode: false, + ); + + CodeFindValue copyWith({ + CodeFindOption? option, + bool? replaceMode, + required CodeFindResult? result, + bool? searching, + }) { + return CodeFindValue( + option: option ?? this.option, + replaceMode: replaceMode ?? this.replaceMode, + result: result, + searching: searching ?? this.searching, + ); + } + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeFindValue + && other.option == option + && other.replaceMode == replaceMode + && other.result == result + && other.searching == searching; + } + + @override + int get hashCode => Object.hash(option, replaceMode, result, searching); + + @override + String toString() { + return '{option: $option replaceMode: $replaceMode result: $result searching:$searching}'; + } + +} + +class CodeFindOption { + + final String pattern; + final bool caseSensitive; + final bool regex; + + const CodeFindOption({ + required this.pattern, + required this.caseSensitive, + required this.regex, + }); + + CodeFindOption copyWith({ + String? pattern, + bool? caseSensitive, + bool? regex, + }) { + return CodeFindOption( + pattern: pattern ?? this.pattern, + caseSensitive: caseSensitive ?? this.caseSensitive, + regex: regex ?? this.regex, + ); + } + + RegExp? get regExp { + if (regex) { + try { + return RegExp(pattern, caseSensitive: caseSensitive); + } on FormatException { + return null; + } + } else { + return RegExp(RegExp.escape(pattern), caseSensitive: caseSensitive); + } + } + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeFindOption + && other.pattern == pattern + && other.caseSensitive == caseSensitive + && other.regex == regex; + } + + @override + int get hashCode => Object.hash(pattern, caseSensitive, regex); + + @override + String toString() { + return '{pattern: $pattern caseSensitive: $caseSensitive regex: $regex}'; + } + +} + +class CodeFindResult { + + final int index; + final List matches; + final CodeFindOption option; + final CodeLines codeLines; + final bool dirty; + + const CodeFindResult({ + required this.index, + required this.matches, + required this.option, + required this.codeLines, + required this.dirty, + }); + + CodeFindResult get previous => copyWith( + index: index == 0 ? matches.length - 1 : index - 1 + ); + + CodeFindResult get next => copyWith( + index: index == matches.length - 1 ? 0 : index + 1 + ); + + CodeLineSelection? get currentMatch => index == -1 ? null : matches[index]; + + CodeFindResult copyWith({ + int? index, + List? matches, + CodeFindOption? option, + CodeLines? codeLines, + bool? dirty, + }) { + return CodeFindResult( + index: index ?? this.index, + matches: matches ?? this.matches, + option: option ?? this.option, + codeLines: codeLines ?? this.codeLines, + dirty: dirty ?? this.dirty, + ); + } + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeFindResult + && other.index == index + && listEquals(other.matches, matches) + && other.option == option + && other.codeLines.equals(codeLines) + && other.dirty == dirty; + } + + @override + int get hashCode => Object.hash(index, matches, option, codeLines, dirty); + +} + +abstract class CodeFindController extends ValueNotifier { + + factory CodeFindController(CodeLineEditingController controller, [CodeFindValue? value]) + => _CodeFindControllerImpl(controller, value); + + TextEditingController get findInputController; + + TextEditingController get replaceInputController; + + FocusNode get findInputFocusNode; + + FocusNode get replaceInputFocusNode; + + List? get allMatchSelections; + + CodeLineSelection? get currentMatchSelection; + + void findMode(); + + void replaceMode(); + + void focusOnFindInput(); + + void focusOnReplaceInput(); + + void toggleMode(); + + void close(); + + void toggleRegex(); + + void toggleCaseSensitive(); + + void previousMatch(); + + void nextMatch(); + + void replaceMatch(); + + void replaceAllMatches(); + + CodeLineSelection? convertMatchToSelection(CodeLineSelection match); + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/code_formatter.dart b/packages/re_editor/lib/src/code_formatter.dart new file mode 100644 index 0000000..2df6422 --- /dev/null +++ b/packages/re_editor/lib/src/code_formatter.dart @@ -0,0 +1,21 @@ +part of re_editor; + +abstract class CodeCommentFormatter { + + CodeLineEditingValue format(CodeLineEditingValue value, String indent, bool single); + +} + +abstract class DefaultCodeCommentFormatter implements CodeCommentFormatter { + + factory DefaultCodeCommentFormatter({ + String? singleLinePrefix, + String? multiLinePrefix, + String? multiLineSuffix + }) => _DefaultCodeCommentFormatter( + singleLinePrefix: singleLinePrefix, + multiLinePrefix: multiLinePrefix, + multiLineSuffix: multiLineSuffix + ); + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/code_indicator.dart b/packages/re_editor/lib/src/code_indicator.dart new file mode 100644 index 0000000..63fc81a --- /dev/null +++ b/packages/re_editor/lib/src/code_indicator.dart @@ -0,0 +1,202 @@ +part of re_editor; + +const int _kDefaultMinNumberCount = 3; +const Size _kDefaultChunkIndicatorSize = Size(7, 7); + +typedef CodeIndicatorValueNotifier = ValueNotifier; +typedef CodeIndicatorBuilder = Widget Function( + BuildContext context, + CodeLineEditingController editingController, + CodeChunkController chunkController, + CodeIndicatorValueNotifier notifier, +); + +class CodeIndicatorValue { + + final List paragraphs; + final int focusedIndex; + + CodeIndicatorValue({ + required this.paragraphs, + this.focusedIndex = -1, + }); + + @override + int get hashCode => Object.hashAll([paragraphs, focusedIndex]); + + @override + bool operator ==(Object other) { + if (other is! CodeIndicatorValue) { + return false; + } + return listEquals(other.paragraphs, paragraphs) && + other.focusedIndex == focusedIndex; + } + + CodeIndicatorValue copyWith({ + List? paragraphs, + int? focusedIndex, + }) { + return CodeIndicatorValue( + paragraphs: paragraphs ?? this.paragraphs, + focusedIndex: focusedIndex ?? this.focusedIndex, + ); + } + +} + +class DefaultCodeLineNumber extends LeafRenderObjectWidget { + + final CodeLineEditingController controller; + final CodeIndicatorValueNotifier notifier; + final TextStyle? textStyle; + final TextStyle? focusedTextStyle; + final int? minNumberCount; + final String Function(int lineIndex)? customLineIndex2Text; + + const DefaultCodeLineNumber({ + super.key, + required this.notifier, + required this.controller, + this.textStyle, + this.focusedTextStyle, + this.minNumberCount, + this.customLineIndex2Text, + }); + + @override + RenderObject createRenderObject(BuildContext context) => CodeLineNumberRenderObject( + controller: controller, + notifier: notifier, + textStyle: textStyle ?? _useCodeTextStyle(context, false), + focusedTextStyle: focusedTextStyle ?? _useCodeTextStyle(context, true), + minNumberCount: minNumberCount ?? _kDefaultMinNumberCount, + custonLineIndex2Text: customLineIndex2Text, + ); + + @override + void updateRenderObject(BuildContext context, covariant CodeLineNumberRenderObject renderObject) { + renderObject + ..controller = controller + ..notifier = notifier + ..textStyle = textStyle ?? _useCodeTextStyle(context, false) + ..focusedTextStyle = focusedTextStyle ?? _useCodeTextStyle(context, true) + ..minNumberCount = minNumberCount ?? _kDefaultMinNumberCount; + super.updateRenderObject(context, renderObject); + } + + TextStyle _useCodeTextStyle(BuildContext context, bool focused) { + final _CodeEditable? editor = context.findAncestorWidgetOfExactType<_CodeEditable>(); + assert(editor != null); + return editor!.textStyle.copyWith( + color: focused ? null : editor.textStyle.color?.withAlpha(128) + ); + } + +} + +class DefaultCodeChunkIndicator extends LeafRenderObjectWidget { + + final double width; + final CodeChunkController controller; + final CodeIndicatorValueNotifier notifier; + final CodeChunkIndicatorPainter? painter; + final bool collapseIndicatorVisible; + final bool expandIndicatorVisible; + + const DefaultCodeChunkIndicator({ + super.key, + required this.width, + required this.controller, + required this.notifier, + this.painter, + this.collapseIndicatorVisible = true, + this.expandIndicatorVisible = true, + }); + + @override + RenderObject createRenderObject(BuildContext context) => CodeChunkIndicatorRenderObject( + width: width, + controller: controller, + notifier: notifier, + painter: painter ?? DefaultCodeChunkIndicatorPainter( + color: _useCodeTextColor(context), + ), + collapseIndicatorVisible: collapseIndicatorVisible, + expandIndicatorVisible: expandIndicatorVisible, + ); + + @override + void updateRenderObject(BuildContext context, covariant CodeChunkIndicatorRenderObject renderObject) { + renderObject + ..width = width + ..controller = controller + ..notifier = notifier + ..painter = painter ?? DefaultCodeChunkIndicatorPainter( + color: _useCodeTextColor(context), + ) + ..collapseIndicatorVisible = collapseIndicatorVisible + ..expandIndicatorVisible = expandIndicatorVisible; + super.updateRenderObject(context, renderObject); + } + + Color? _useCodeTextColor(BuildContext context) { + final _CodeEditable? editor = context.findAncestorWidgetOfExactType<_CodeEditable>(); + assert(editor != null); + return editor!.textStyle.color?.withAlpha(128); + } + +} + +abstract class CodeChunkIndicatorPainter { + + void paintCollapseIndicator(Canvas canvas, Size container); + + void paintExpandIndicator(Canvas canvas, Size container); + +} + +class DefaultCodeChunkIndicatorPainter implements CodeChunkIndicatorPainter { + + final Color? color; + final Size size; + + late final Paint _paint; + + DefaultCodeChunkIndicatorPainter({ + this.color, + this.size = _kDefaultChunkIndicatorSize + }) { + _paint = Paint(); + if (color != null) { + _paint.color = color!; + } + } + + @override + void paintCollapseIndicator(Canvas canvas, Size container) { + if (color == null || color == Colors.transparent || container.isEmpty) { + return; + } + final Path path = Path(); + path.moveTo((container.width - size.width) / 2, (container.height - size.height) / 2); + path.lineTo((container.width + size.width) / 2, (container.height - size.height) / 2); + path.lineTo(container.width / 2, (container.height + size.height) / 2); + path.lineTo((container.width - size.width) / 2, (container.height - size.height) / 2); + canvas.drawPath(path, _paint); + } + + @override + void paintExpandIndicator(Canvas canvas, Size container) { + if (color == null || color == Colors.transparent || container.isEmpty) { + return; + } + final Path path = Path(); + path.moveTo((container.width - size.width) / 2, (container.height - size.height) / 2); + path.lineTo((container.width + size.width) / 2, container.height / 2); + path.lineTo((container.width - size.width) / 2, (container.height + size.height) / 2); + path.lineTo((container.width - size.width) / 2, (container.height - size.height) / 2); + canvas.drawPath(path, _paint); + } + +} diff --git a/packages/re_editor/lib/src/code_line.dart b/packages/re_editor/lib/src/code_line.dart new file mode 100644 index 0000000..4f7d107 --- /dev/null +++ b/packages/re_editor/lib/src/code_line.dart @@ -0,0 +1,1192 @@ +part of re_editor; + +typedef CodeLineSpanBuilder = TextSpan Function({ + required BuildContext context, + required int index, + required CodeLine codeLine, + required TextSpan textSpan, + required TextStyle style, +}); + +/// A controller for an editor field. +/// +/// Whenever the user modifies a editor field with an associated +/// [CodeLineEditingController], the editor field updates [value] and the controller +/// notifies its listeners. Listeners can then read the [codeLines] and [selection] +/// properties to learn what the user has typed or how the selection has been +/// updated. +/// +/// Similarly, if you modify the [codeLines] or [selection] properties, the editor +/// field will be notified and will update itself appropriately. +/// +/// A [CodeLineEditingController] can also be used to provide an initial value for a +/// editor field. If you build a editor field with a controller that already has +/// [codeLines], the editor field will use that text as its initial value. +/// +/// The [value] (as well as [codeLines] and [selection]) of this controller can be +/// updated from within a listener added to this controller. Be aware of +/// infinite loops since the listener will also be notified of the changes made +/// from within itself. Modifying the composing region from within a listener +/// can also have a bad interaction with some input methods. Gboard, for +/// example, will try to restore the composing region of the text if it was +/// modified programmatically, creating an infinite loop of communications +/// between the framework and the input method. +/// +/// If both the [codeLines] or [selection] properties need to be changed, set the +/// controller's [value] instead. +/// +/// Remember to [dispose] of the [CodeLineEditingController] when it is no longer +/// needed. This will ensure we discard any resources used by the object. +/// +abstract class CodeLineEditingController extends ValueNotifier { + + /// Creates a controller for an editor field. + /// + /// This constructor treats an empty [codeLines] argument as if it were the empty + /// string. + /// + /// Use [options] to define the linebreak and indent. + /// + /// Also, you can use [spanBuilder] to customize and override the code line style. + /// + factory CodeLineEditingController({ + CodeLines codeLines = _kInitialCodeLines, + CodeLineOptions options = const CodeLineOptions(), + CodeLineSpanBuilder? spanBuilder, + }) => _CodeLineEditingControllerImpl( + codeLines: codeLines, + options: options, + spanBuilder: spanBuilder, + ); + + /// Creates a controller for a given text. + factory CodeLineEditingController.fromText(String? text, [ + CodeLineOptions options = const CodeLineOptions() + ]) => _CodeLineEditingControllerImpl.fromText(text, options); + + /// Creates a controller for a given file path. The file content will read async. + factory CodeLineEditingController.fromTextAsync(String? text, [ + CodeLineOptions options = const CodeLineOptions() + ]) => _CodeLineEditingControllerImpl.fromTextAsync(text, options); + + /// Set the current editor codes. + /// + /// Setting this will notify all the listeners of this [CodeLineEditingController] + /// that they need to update (it calls [notifyListeners]). For this reason, + /// this value should only be set between frames, e.g. in response to user + /// actions, not during the build, layout, or paint phases. + set codeLines(CodeLines newCodeLines); + + /// Set the current editor code selections. + /// + /// Setting this will notify all the listeners of this [CodeLineEditingController] + /// that they need to update (it calls [notifyListeners]). For this reason, + /// this value should only be set between frames, e.g. in response to user + /// actions, not during the build, layout, or paint phases. + /// + /// This property can be set from a listener added to this + /// [CodeLineEditingController]; however, one should not also set [codeLines] + /// in a separate statement. To change both the [codeLines] and the [selection] + /// change the controller's [value]. + /// + /// If the new selection is of non-zero length, or is outside the composing + /// range, the composing range is cleared. + set selection(CodeLineSelection newSelection); + + /// Set the current editor code composing. + /// + /// Setting this will notify all the listeners of this [CodeLineEditingController] + /// that they need to update (it calls [notifyListeners]). For this reason, + /// this value should only be set between frames, e.g. in response to user + /// actions, not during the build, layout, or paint phases. + set composing(TextRange newComposing); + + /// Get the previous editing value. + CodeLineEditingValue? get preValue; + + /// Get the code line options. + CodeLineOptions get options; + + /// The current codes the user is editing. + CodeLines get codeLines; + + /// Get the current editor code selections. + CodeLineSelection get selection; + + /// Get the range of code that is still being composed. + TextRange get composing; + + /// The code line at which the selection originates. + CodeLine get baseLine; + + /// The code line at which the selection terminates. + CodeLine get extentLine; + + /// The code line at which the selection starts. + CodeLine get startLine; + + /// The code line at which the selection ends. + CodeLine get endLine; + + /// Whether the code that is still being composed. + bool get isComposing; + + /// The current text being edited. + /// + /// This Will convert all the code lines into a whole text. + String get text; + + /// The current text being selected. + String get selectedText; + + /// How many lines in the editor. + int get lineCount; + + /// Expanded code selections. + CodeLineSelection get unfoldLineSelection; + + /// Whether the code is empty. + bool get isEmpty; + + /// Whether all the codes are selected. + bool get isAllSelected; + + /// Whether the undo action can be performed. + bool get canUndo; + + /// Whether the redo action can be performed. + bool get canRedo; + + /// Set the current editor text. + /// + /// Setting this will notify all the listeners of this [CodeLineEditingController] + /// that they need to update (it calls [notifyListeners]). For this reason, + /// this value should only be set between frames, e.g. in response to user + /// actions, not during the build, layout, or paint phases. + set text(String value); + + /// Set the current editor text async. + /// + /// Setting this will notify all the listeners of this [CodeLineEditingController] + /// that they need to update (it calls [notifyListeners]). For this reason, + /// this value should only be set between frames, e.g. in response to user + /// actions, not during the build, layout, or paint phases. + set textAsync(String value); + + /// Only used in internal. + void bindEditor(GlobalKey key); + + /// Set the current editor value. + /// + /// Setting this will notify all the listeners of this [CodeLineEditingController] + /// that they need to update (it calls [notifyListeners]). For this reason, + /// this value should only be set between frames, e.g. in response to user + /// actions, not during the build, layout, or paint phases. + void edit(TextEditingValue newValue); + + /// Select a code line at the given index. + void selectLine(int index); + + /// Select some code lines at the given start and end index. + void selectLines(int base, int extent); + + /// Select all the codes. + void selectAll(); + + /// The selection will be collaposed at the terminate position. + void cancelSelection(); + + /// Move up the selected code lines. + void moveSelectionLinesUp(); + + /// Move down the selected code lines. + void moveSelectionLinesDown(); + + /// Move the cursor to a direction. + void moveCursor(AxisDirection direction); + + /// Move the cursor to the start of current line. + void moveCursorToLineStart(); + + /// Move the cursor to the end of current line. + void moveCursorToLineEnd(); + + /// Move the cursor to the start of document. + void moveCursorToPageStart(); + + /// Move the cursor to the end of document. + void moveCursorToPageEnd(); + + /// TODO + void moveCursorToPageUp(); + + /// TODO + void moveCursorToPageDown(); + + /// Move the cursor to the start of the word. + void moveCursorToWordBoundaryForward(); + + /// Move the cursor to the end of the word. + void moveCursorToWordBoundaryBackward(); + + /// Extend the selection to a direction. + void extendSelection(AxisDirection direction); + + /// Extend the selection to the start of current line. + void extendSelectionToLineStart(); + + /// Extend the selection to the end of current line. + void extendSelectionToLineEnd(); + + /// Extend the selection to the start of document. + void extendSelectionToPageStart(); + + /// Extend the selection to the end of document. + void extendSelectionToPageEnd(); + + /// Extend the selection to the start of the word. + void extendSelectionToWordBoundaryForward(); + + /// Extend the selection to the end of the word. + void extendSelectionToWordBoundaryBackward(); + + /// Delete the selected lines. + void deleteSelectionLines([bool keepExtentOffset = true]); + + /// Delete content before the cursor at the current line. + void deleteLineForward(); + + /// Delete content after the cursor at the current line. + void deleteLineBackward(); + + /// Delete the selected codes. + /// + /// Note that this operation will have no effect if the selection is collapsed. + void deleteSelection(); + + /// If the selection is currently collapsed, the character behind the cursor will be deleted. + /// Otherwise, will delete the selection, same as [deleteSelection]. + /// + /// Note that if the cursor is between closing symbols, such as braces, + /// the left and right brace will be deleted together. + void deleteBackward(); + + /// If the selection is currently collapsed, the character in front of the cursor will be deleted. + /// Otherwise, will delete the selection, same as [deleteSelection]. + /// + /// Note that if the cursor is between closing symbols, such as braces, + /// the left and right brace will be deleted together. + void deleteForward(); + + /// Delete the word behind the cursor. + void deleteWordBackward(); + + /// Delete the word in front of the cursor. + void deleteWordForward(); + + /// Insert a newline character. + void applyNewLine(); + + /// Insert a indent. + void applyIndent(); + + /// Delete a indent. + void applyOutdent(); + + /// Transpose characters. + void transposeCharacters(); + + /// Replace the selected code with a new string [replacement]. + void replaceSelection(String replacement, [CodeLineSelection? selection]); + + /// Replaces all substrings that match [pattern] with [replacement]. + void replaceAll(Pattern pattern, String replacement); + + /// Reverts the value on the stack to the previous value. + void undo(); + + /// Updates the value on the stack to the next value. + void redo(); + + /// If the selection is currently collapsed, the whole line will be copied. + /// Otherwise, copy the selected codes. + Future copy(); + + /// If the selection is currently collapsed, the whole line will be cut. + /// Otherwise, cut the selected codes. + void cut(); + + /// Paste text from [Clipboard]. + void paste(); + + /// Set the composing region to an empty range. + /// + /// The composing region is the range of text that is still being composed. + /// Calling this function indicates that the user is done composing that + /// region. + /// + /// Calling this will notify all the listeners of this [CodeLineEditingController] + /// that they need to update (it calls [notifyListeners]). For this reason, + /// this method should only be called between frames, e.g. in response to user + /// actions, not during the build, layout, or paint phases. + void clearComposing(); + + /// Clear the undo and redo history. + void clearHistory(); + + /// Collapse codes form [start] to [end]. + void collapseChunk(int start, int end); + + /// Expand the codes at [index] of lines. + void expandChunk(int index); + + /// Convert the [index] to the unfold line index. + int index2lineIndex(int index); + + /// Get code line information at [lineIndex]. + CodeLineIndex lineIndex2Index(int lineIndex); + + /// Scroll the editor to make sure the cursor is visible at center. + void makeCursorCenterIfInvisible(); + + /// Scroll the editor to make sure the cursor is visible. + void makeCursorVisible(); + + /// Scroll the editor to make sure the given position is visible at center. + void makePositionCenterIfInvisible(CodeLinePosition position); + + /// Scroll the editor to make sure the given position is visible. + void makePositionVisible(CodeLinePosition position); + + /// Force the render to repaint. + void forceRepaint(); + + /// Perform an operation. If the editor content changes, it will + /// be recorded in the undo history. + void runRevocableOp(VoidCallback op); + + /// Builds [TextSpan] from current editing value. + /// This can override the code syntax highlighting styles. + TextSpan buildTextSpan({ + required BuildContext context, + required int index, + required TextSpan textSpan, + required TextStyle style, + }); +} + +/// A delegate controller for an editor field. +/// +/// We can override some default behaviors of the controller. +class CodeLineEditingControllerDelegate extends _CodeLineEditingControllerDelegate { + + CodeLineEditingControllerDelegate({ + required CodeLineEditingController delegate, + }) { + super.delegate = delegate; + } + +} + +class CodeLine { + + static const CodeLine empty = CodeLine(''); + + final String text; + final List chunks; + + const CodeLine(this.text, [this.chunks = const[]]); + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeLine + && other.text == text + && listEquals(other.chunks, chunks); + } + + @override + int get hashCode => Object.hash(text, chunks); + + int get length => text.length; + + int get characterLength => text.characters.length; + + bool get chunkParent => chunks.isNotEmpty; + + int get lineCount { + int count = 1; + for (final CodeLine codeLine in chunks) { + count += codeLine.lineCount; + } + return count; + } + + int get charCount { + int count = length; + for (final CodeLine codeLine in chunks) { + count += codeLine.charCount; + } + return count; + } + + @override + String toString() { + return text; + } + + String substring(int start, [int? end]) { + if (end != null) { + if (end < start) { + end = start; + } else if (end > length) { + end = length; + } + } + return start >= length ? '' : text.substring(start, end); + } + + String takeCharacter(int count) { + return text.characters.take(count).string; + } + + String takeLastCharacter(int count) { + return text.characters.takeLast(count).string; + } + + String takeCharacterAtLastIndex(int index) { + return text.characters.elementAt(text.characters.length - 1 - index); + } + + String takeCharacterAt(int index) { + return text.characters.elementAt(index); + } + + String skipCharacter(int count) { + return text.characters.skip(count).string; + } + + String skipLastCharacter(int count) { + return text.characters.skipLast(count).string; + } + + int codeUnitAt(int index) => text.codeUnitAt(index); + + CodeLine copyWith({ + String? text, + List? chunks + }) { + return CodeLine( + text ?? this.text, + chunks ?? this.chunks + ); + } + + String asString(int start, TextLineBreak lineBreak) { + return [substring(start), ...chunks.map((e) => e.asString(0, lineBreak))].join(lineBreak.value); + } + + List flat() { + final List codeLines = [text]; + for (final CodeLine child in chunks) { + codeLines.addAll(child.flat()); + } + return codeLines; + } + +} + +/// The current codes, selection, and composing state for editing a run of text. +class CodeLineEditingValue { + + /// Creates information for editing a run of codes. + /// + /// The selection and composing range must be within the codes. This is not + /// checked during construction, and must be guaranteed by the caller. + /// + /// The default value of [selection] is `CodeLineSelection.zero()`. + /// This indicates that there is no selection at all. + const CodeLineEditingValue({ + required this.codeLines, + this.selection = const CodeLineSelection.zero(), + this.composing = TextRange.empty, + }); + + const CodeLineEditingValue.empty() : this( + codeLines: _kInitialCodeLines + ); + + /// The current codes being edited. + final CodeLines codeLines; + + /// The range of codes that is currently selected. + /// + /// When [selection] is a [CodeLineSelection] that has the same + /// `base` and `extent` position, the [selection] property represents the + /// caret position. + final CodeLineSelection selection; + + /// The range of text that is still being composed. + /// + /// Composing regions are created by input methods (IMEs) to indicate the text + /// within a certain range is provisional. For instance, the Android Gboard + /// app's English keyboard puts the current word under the caret into a + /// composing region to indicate the word is subject to autocorrect or + /// prediction changes. + /// + /// Composing regions can also be used for performing multistage input, which + /// is typically used by IMEs designed for phonetic keyboard to enter + /// ideographic symbols. As an example, many CJK keyboards require the user to + /// enter a Latin alphabet sequence and then convert it to CJK characters. On + /// iOS, the default software keyboards do not have a dedicated view to show + /// the unfinished Latin sequence, so it's displayed directly in the text + /// field, inside of a composing region. + /// + /// The composing region should typically only be changed by the IME, or the + /// user via interacting with the IME. + /// + /// If the range represented by this property is [TextRange.empty], then the + /// text is not currently being composed. + final TextRange composing; + + CodeLineEditingValue copyWith({ + CodeLines? codeLines, + CodeLineSelection? selection, + TextRange? composing, + }) { + return CodeLineEditingValue( + codeLines: codeLines ?? this.codeLines, + selection: selection ?? this.selection, + composing: composing ?? this.composing + ); + } + + bool get isInitial => codeLines == _kInitialCodeLines; + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeLineEditingValue + && other.codeLines.equals(codeLines) + && other.selection == selection + && other.composing == composing; + } + + @override + int get hashCode => Object.hash(codeLines, selection, composing); + + @override + String toString() { + return 'codeLines: $codeLines, selection: $selection, composing: $composing'; + } + +} + +/// A range of code lines that represents a selection. +class CodeLineSelection { + + /// The line index at which the selection originates. + final int baseIndex; + + /// The line index at which the selection terminates. + final int extentIndex; + + /// The offset at which the selection originates. + /// + /// Might be larger than, smaller than, or equal to extent. + final int baseOffset; + + /// The offset at which the selection terminates. + /// + /// When the user uses the arrow keys to adjust the selection, this is the + /// value that changes. Similarly, if the current theme paints a caret on one + /// side of the selection, this is the location at which to paint the caret. + /// + /// Might be larger than, smaller than, or equal to base. + final int extentOffset; + + /// If the code range is collapsed and has more than one visual location + /// (e.g., occurs at a line break), which of the two locations to use when + /// painting the caret. + final TextAffinity baseAffinity; + + /// If the code range is collapsed and has more than one visual location + /// (e.g., occurs at a line break), which of the two locations to use when + /// painting the caret. + final TextAffinity extentAffinity; + + /// Creates a code selection. + const CodeLineSelection({ + required this.baseIndex, + required this.baseOffset, + required this.extentIndex, + required this.extentOffset, + this.baseAffinity = TextAffinity.downstream, + this.extentAffinity = TextAffinity.downstream, + }); + + /// Creates a collapsed selection at the given line index and offset. + /// + /// A collapsed selection starts and ends at the same offset, which means it + /// contains zero characters but instead serves as an insertion point in the + /// text. + const CodeLineSelection.collapsed({ + required int index, + required int offset, + TextAffinity affinity = TextAffinity.downstream, + }) : this( + baseIndex: index, + baseOffset: offset, + extentIndex: index, + extentOffset: offset, + baseAffinity: affinity, + extentAffinity: affinity + ); + + /// Creates a collapsed selection at the given code position. + /// + /// A collapsed selection starts and ends at the same offset, which means it + /// contains zero characters but instead serves as an insertion point in the + /// text. + CodeLineSelection.fromPosition({ + required CodeLinePosition position + }) : this.collapsed( + index: position.index, + offset: position.offset, + affinity: position.affinity, + ); + + /// Creates a selection at the given line index and range. + CodeLineSelection.fromRange({ + required CodeLineRange range + }) : this( + baseIndex: range.index, + baseOffset: range.start, + extentIndex: range.index, + extentOffset: range.end, + ); + + /// Creates a selection at the given line index and selection. + CodeLineSelection.fromTextSelection({ + required int index, + required TextSelection selection + }) : this( + baseIndex: index, + baseOffset: selection.baseOffset, + baseAffinity: selection.affinity, + extentIndex: index, + extentOffset: selection.extentOffset, + extentAffinity: selection.affinity, + ); + + /// Creates a collapsed selection at the beginning. + const CodeLineSelection.zero() : this( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 0, + ); + + /// The position at which the selection originates. + CodeLinePosition get base { + return CodeLinePosition( + index: baseIndex, + offset: baseOffset, + affinity: baseAffinity + ); + } + + /// The position at which the selection terminates. + CodeLinePosition get extent { + return CodeLinePosition( + index: extentIndex, + offset: extentOffset, + affinity: extentAffinity + ); + } + + /// The position at which the selection starts. + CodeLinePosition get start { + if (baseIndex < extentIndex) { + return base; + } else if (baseIndex > extentIndex) { + return extent; + } else { + if (baseOffset < extentOffset) { + return base; + } else { + return extent; + } + } + } + + /// The position at which the selection ends. + CodeLinePosition get end { + if (baseIndex < extentIndex) { + return extent; + } else if (baseIndex > extentIndex) { + return base; + } else { + if (baseOffset < extentOffset) { + return extent; + } else { + return base; + } + } + } + + /// The line index at which the selection starts. + int get startIndex => start.index; + + /// The offset at which the selection starts. + int get startOffset => start.offset; + + /// The line index at which the selection ends. + int get endIndex => end.index; + + /// The offset at which the selection ends. + int get endOffset => end.offset; + + /// Whether this range is empty (but still potentially placed inside the text). + bool get isCollapsed => isSameLine && baseOffset == extentOffset; + + /// Whether this selection is in a same line. + bool get isSameLine => baseIndex == extentIndex; + + /// Whether this selection contains another selection. + bool contains(CodeLineSelection selection) { + if (startIndex < selection.startIndex && endIndex > selection.endIndex) { + return true; + } + if (startIndex > selection.startIndex || endIndex < selection.endIndex) { + return false; + } + final bool startInside; + if (startIndex == selection.startIndex) { + startInside = startOffset <= selection.startOffset; + } else { + startInside = true; + } + final bool endInside; + if (endIndex == selection.endIndex) { + endInside = endOffset >= selection.endOffset; + } else { + endInside = true; + } + return startInside && endInside; + } + + CodeLineSelection copyWith({ + int? baseIndex, + int? extentIndex, + int? baseOffset, + int? extentOffset, + TextAffinity? baseAffinity, + TextAffinity? extentAffinity, + }) { + return CodeLineSelection( + baseIndex: baseIndex ?? this.baseIndex, + baseOffset: baseOffset ?? this.baseOffset, + baseAffinity: baseAffinity ?? this.baseAffinity, + extentIndex: extentIndex ?? this.extentIndex, + extentOffset: extentOffset ?? this.extentOffset, + extentAffinity: extentAffinity ?? this.extentAffinity, + ); + } + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + if (other is! CodeLineSelection) { + return false; + } + return other.baseIndex == baseIndex + && other.extentIndex == extentIndex + && other.baseOffset == baseOffset + && other.extentOffset == extentOffset + && other.baseAffinity == baseAffinity + && other.extentAffinity == extentAffinity; + } + + @override + int get hashCode { + return Object.hash(baseIndex, extentIndex, baseOffset, extentOffset, baseAffinity, extentAffinity); + } + + @override + String toString() { + return 'CodeLineSelection(baseIndex: $baseIndex, baseOffset: $baseOffset, baseAffinity: $baseAffinity, ' + 'extentIndex: $extentIndex, extentOffset: $extentOffset, extentAffinity: $extentAffinity)'; + } + +} + +/// A position in a string of code. +/// +/// A CodeLinePosition can be used to describe a caret position in between +/// characters. The [index] points to the line index and the [offset] points +/// to the position between `offset - 1` and `offset` characters of the string, +/// and the [affinity] is used to describe which character this position affiliates +/// with. +class CodeLinePosition extends TextPosition { + + /// Creates an object representing a particular position in a code. + const CodeLinePosition({ + required this.index, + required super.offset, + super.affinity = TextAffinity.downstream, + }); + + /// Line index in the codes. + final int index; + + /// Creates the CodeLinePosition with the line index and text position. + CodeLinePosition.from({ + required int index, + required TextPosition position + }) : this( + index: index, + offset: position.offset, + affinity: position.affinity + ); + + CodeLinePosition copyWith({ + int? index, + int? offset, + TextAffinity? affinity + }) { + return CodeLinePosition( + index: index ?? this.index, + offset: offset ?? this.offset, + affinity: affinity ?? this.affinity, + ); + } + + /// Get the text position withou line index. + TextPosition get textPosition => TextPosition(offset: offset, affinity: affinity); + + /// Whether the current code position is before the given position. + bool isBefore(CodeLinePosition position) { + if (index < position.index) { + return true; + } + if (index > position.index) { + return false; + } + return offset < position.offset; + } + + /// Whether the current code position is after the given position. + bool isAfter(CodeLinePosition position) { + if (index > position.index) { + return true; + } + if (index < position.index) { + return false; + } + return offset > position.offset; + } + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeLinePosition + && other.index == index + && other.offset == offset + && other.affinity == affinity; + } + + @override + int get hashCode => Object.hash(index, offset, affinity); + + @override + String toString() { + return 'CodeLinePosition(index: $index, offset: $offset, affinity: $affinity)'; + } + +} + +/// A range of code that represents a selection. +class CodeLineRange extends TextRange { + + /// Creates a code range. + const CodeLineRange({ + required this.index, + required super.start, + required super.end, + }); + + /// Line index in the codes. + final int index; + + /// Creates a code range at the given line index and text range. + factory CodeLineRange.from({ + required int index, + required TextRange range + }) { + return CodeLineRange( + index: index, + start: range.start, + end: range.end + ); + } + + /// Creates a collapsed range at the given offset. + /// + /// A collapsed range starts and ends at the same offset, which means it + /// contains zero characters but instead serves as an insertion point in the + /// text. + const CodeLineRange.collapsed({ + required int index, + required int offset + }) : this( + index: index, + start: offset, + end: offset + ); + + /// Creates a collapsed range with negative offset. + const CodeLineRange.empty() : this( + index: 0, + start: -1, + end: -1 + ); + + /// Creates a new [CodeLineRange] based on the current selection, with the + /// provided parameters overridden. + CodeLineRange copyWith({ + int? index, + int? start, + int? end + }) { + return CodeLineRange( + index: index ?? this.index, + start: start ?? this.start, + end: end ?? this.end, + ); + } + + @override + int get hashCode => Object.hash(index, start, end); + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeLineRange + && other.index == index + && other.start == start + && other.end == end; + } + + @override + String toString() => 'CodeLineRange(index: $index start: $start, end: $end)'; + +} + +/// Some options of the code lines. +class CodeLineOptions { + + static const int _defaultIndentSize = 2; + + const CodeLineOptions({ + this.lineBreak = TextLineBreak.lf, + this.indentSize = _defaultIndentSize + }); + + /// Line break symbols, like LF, CRLF. + /// + /// Defaults to [TextLineBreak.lf]. + final TextLineBreak lineBreak; + + /// Indent length, default value is 2. + final int indentSize; + + CodeLineOptions copyWith({ + TextLineBreak? lineBreak, + int? indentSize, + }) { + return CodeLineOptions( + lineBreak: lineBreak ?? this.lineBreak, + indentSize: indentSize ?? this.indentSize, + ); + } + + @override + int get hashCode => Object.hash(lineBreak, indentSize); + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeLineOptions + && other.lineBreak == lineBreak + && other.indentSize == indentSize; + } + + String get indent => ' ' * indentSize; + +} + +class CodeLineIndex { + + final int index; + final int chunkIndex; + + const CodeLineIndex(this.index, this.chunkIndex); + + @override + int get hashCode => Object.hash(index, chunkIndex); + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeLineIndex + && other.index == index + && other.chunkIndex == chunkIndex; + } + + @override + String toString() => 'CodeLineIndex(index: $index chunkIndex: $chunkIndex)'; +} + +class CodeLineRenderParagraph { + + static const double _chunkIndicatorWidth = 15; + + final int index; + final IParagraph paragraph; + final Offset offset; + final bool chunkParent; + final bool chunkLongText; + + const CodeLineRenderParagraph({ + required this.index, + required this.paragraph, + required this.offset, + required this.chunkParent, + required this.chunkLongText, + }); + + double get preferredLineHeight => paragraph.preferredLineHeight; + + double get top => offset.dy; + + double get bottom => offset.dy + height; + + double get width => paragraph.width + (chunkParent ? _chunkIndicatorWidth : 0); + + double get height => paragraph.height; + + int get length => paragraph.length; + + bool inVerticalRange(Offset coordinate) => coordinate.dy >= top && coordinate.dy < bottom; + + CodeLinePosition getPosition(Offset offset) => CodeLinePosition.from( + index: index, + position: paragraph.getPosition(offset) + ); + + CodeLineRange getWord(Offset offset) => CodeLineRange.from( + index: index, + range: paragraph.getWord(offset) + ); + + InlineSpan? getSpanForPosition(Offset offset) => paragraph.getSpanForPosition(getPosition(offset)); + + TextRange getRangeForSpan(InlineSpan span) => paragraph.getRangeForSpan(span); + + Offset? getOffset(TextPosition position) => paragraph.getOffset(position); + + List getRangeRects(TextRange range) => paragraph.getRangeRects(range); + + void draw(Canvas canvas, Offset offset) { + paragraph.draw(canvas, offset); + } + + @override + int get hashCode => Object.hash(index, paragraph, offset, chunkParent); + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeLineRenderParagraph + && other.index == index + && other.paragraph == paragraph + && other.offset == offset + && other.chunkParent == chunkParent; + } + + CodeLineRenderParagraph copyWith({ + int? index, + IParagraph? paragraph, + Offset? offset, + bool? chunkParent, + bool? chunkLongText, + }) { + return CodeLineRenderParagraph( + index: index ?? this.index, + paragraph: paragraph ?? this.paragraph, + offset: offset ?? this.offset, + chunkParent: chunkParent ?? this.chunkParent, + chunkLongText: chunkLongText ?? this.chunkLongText, + ); + } + +} + +enum TextLineBreak { + + crlf, + + cr, + + lf, + +} + +extension TextLineBreakExtension on TextLineBreak { + + String get value => const ['\r\n', '\r', '\n'][index]; + +} + +extension CodeLineExtension on String { + + bool get isMultiline { + return contains('\n') || contains('\r'); + } + + List get textLines { + return replaceAll('\r\n', '\n').replaceAll('\r', '\n').split('\n'); + } + + CodeLines get codeLines { + if (isEmpty) { + return _kInitialCodeLines; + } + return CodeLines.of(textLines.map(CodeLine.new)); + } + + Future get codeLinesAsync async { + if (isEmpty) { + return _kInitialCodeLines; + } + return compute((message) => message.codeLines, this); + } + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/code_lines.dart b/packages/re_editor/lib/src/code_lines.dart new file mode 100644 index 0000000..d07a77d --- /dev/null +++ b/packages/re_editor/lib/src/code_lines.dart @@ -0,0 +1,461 @@ +part of re_editor; + +const int _kCodeLineSegamentDefaultSize = 256; + +class CodeLines { + + final List segments; + + const CodeLines(this.segments); + + factory CodeLines.empty() { + return CodeLines.of([]); + } + + factory CodeLines.fromText(String text) { + return text.codeLines; + } + + factory CodeLines.from(CodeLines codeLines) { + final List segments = []; + for (final CodeLineSegment segment in codeLines.segments) { + if (segment.isEmpty) { + continue; + } + segments.add(segment.copyWith( + dirty: true + )); + } + return CodeLines(segments); + } + + factory CodeLines.of(Iterable elements) { + final List segments = []; + int count = 0; + for (int i = 0; i < elements.length; i++) { + if (count == 0) { + segments.add(CodeLineSegment.of(codeLines: [])); + } + segments.last.add(elements.elementAt(i)); + count++; + if (count >= _kCodeLineSegamentDefaultSize) { + count = 0; + } + } + return CodeLines(segments); + } + + CodeLine get first => segments.first.first; + + CodeLine get last => segments.last.last; + + int get length => segments.fold(0, (previousValue, element) => previousValue += element.length); + + bool get isEmpty => segments.isEmpty || length == 0; + + bool get isNotEmpty => !isEmpty; + + int get lineCount => segments.fold(0, (previousValue, element) => previousValue += element.lineCount); + + CodeLine operator [](int index) { + int offset = 0; + for (final CodeLineSegment segment in segments) { + if (index - offset >= segment.length) { + offset += segment.length; + } else { + return segment[index - offset]; + } + } + throw RangeError.range(index, 0, length - 1); + } + + void operator []=(int index, CodeLine value) { + int offset = 0; + for (int i = 0; i < segments.length; i++) { + CodeLineSegment segment = segments[i]; + if (index - offset >= segment.length) { + offset += segment.length; + } else { + if (segment.dirty) { + segment = segment.clone(); + segments[i] = segment; + } + segment[index - offset] = value; + return; + } + } + throw RangeError.range(index, 0, length - 1); + } + + void add(CodeLine value) { + if (isEmpty || segments.last.length >= _kCodeLineSegamentDefaultSize) { + segments.add(CodeLineSegment.of( + codeLines: [ + value + ] + )); + } else { + CodeLineSegment segment = segments.last; + if (segment.dirty) { + segment = segment.clone(); + segments.last = segment; + } + segment.add(value); + } + } + + void addAll(Iterable iterable) { + if (isEmpty) { + segments.addAll(CodeLines.of(iterable).segments); + return; + } + final CodeLineSegment segment = segments.last; + int count; + if (segment.length >= _kCodeLineSegamentDefaultSize) { + count = 0; + } else { + count = segment.length; + if (segment.dirty) { + segments.last = segment.clone(); + } + } + for (int i = 0; i < iterable.length; i++) { + if (count == 0) { + segments.add(CodeLineSegment.of(codeLines: [])); + } + segments.last.add(iterable.elementAt(i)); + count++; + if (count >= _kCodeLineSegamentDefaultSize) { + count = 0; + } + } + } + + void addFrom(CodeLines codeLines, int start, [int? end]) { + final CodeLines sub = codeLines.sublines(start, end); + if (sub.isEmpty) { + return; + } + if (isEmpty) { + segments.addAll(sub.segments); + return; + } + final List appendSegments = sub.segments; + for (int i = 0; i < appendSegments.length; i++) { + CodeLineSegment tail = segments.last; + final CodeLineSegment appendSegment = appendSegments[i]; + if (tail.length + appendSegment.length <= _kCodeLineSegamentDefaultSize) { + if (tail.dirty) { + tail = tail.clone(); + segments.last = tail; + } + tail.addAll(appendSegment); + } else { + segments.add(appendSegment); + } + } + } + + bool equals(CodeLines? codeLines) { + if (codeLines == null) { + return false; + } + // Quick comparation + if (isEmpty && codeLines.isEmpty) { + return true; + } + if (isEmpty && codeLines.isNotEmpty) { + return false; + } + if (isNotEmpty && codeLines.isEmpty) { + return false; + } + if (first != codeLines.first) { + return false; + } + if (last != codeLines.last) { + return false; + } + final int length1 = length; + final int length2 = codeLines.length; + if (length1 != length2) { + return false; + } + final int minSegmentLength = min(segments.length, codeLines.segments.length); + int offset = 0; + for (int i = 0; i < minSegmentLength; i++) { + if (segments[i].length != codeLines.segments[i].length) { + break; + } + if (!listEquals(segments[i].codeLines, codeLines.segments[i].codeLines)) { + return false; + } + offset += segments[i].length; + } + // The worst is the distributions are different, we should compare them one by one + for (int i = offset; i < length1; i++) { + if (this[i] != codeLines[i]) { + return false; + } + } + return true; + } + + CodeLines sublines(int start, [int? end]) { + end ??= length; + if (end > length) { + throw RangeError.range(end, 0, length - 1); + } + if (start > end) { + throw RangeError('start $start should be less than end $end'); + } + if (start == end) { + return CodeLines.empty(); + } + final List newSegments = []; + int offset = 0; + for (final CodeLineSegment segment in segments) { + if (start - offset >= segment.length) { + offset += segment.length; + continue; + } + if (start <= offset) { + if (end - offset >= segment.length) { + newSegments.add(segment.copyWith( + dirty: true + )); + offset += segment.length; + continue; + } else { + if (end > offset) { + newSegments.add(segment.clone(0, end - offset)); + } + break; + } + } else { + if (end - offset >= segment.length) { + newSegments.add(segment.clone(start - offset, segment.length)); + offset += segment.length; + continue; + } else { + newSegments.add(segment.clone(start - offset, end - offset)); + break; + } + } + } + return CodeLines(newSegments); + } + + void clear() { + segments.clear(); + } + + String asString(TextLineBreak lineBreak, [bool expandChunks = true]) { + final StringBuffer sb = StringBuffer(); + final int length = this.length; + int count = 0; + for (final CodeLineSegment segment in segments) { + for (final CodeLine codeLine in segment.codeLines) { + count++; + if (expandChunks) { + sb.write(codeLine.asString(0, lineBreak)); + } else { + sb.write(codeLine.text); + } + if (count != length) { + sb.write(lineBreak.value); + } + } + } + return sb.toString(); + } + + int index2lineIndex(int index) { + if (index < 0 || index >= length) { + return -1; + } + int lineIndex = 0; + int offset = 0; + for (final CodeLineSegment segment in segments) { + if (index - offset >= segment.length) { + offset += segment.length; + lineIndex += segment.lineCount; + } else { + for (int j = 0; j < index - offset; j++) { + lineIndex += segment[j].lineCount; + } + break; + } + } + return lineIndex; + } + + CodeLineIndex lineIndex2Index(int lineIndex) { + if (lineIndex < 0) { + return const CodeLineIndex(-1, -1); + } + // Find the segment first + int segmentIndex = -1; + int lineCount = 0; + for (int i = 0, start = 0; i < segments.length; i++) { + final int end = start + segments[i].lineCount; + if (lineIndex >= start && lineIndex < end) { + segmentIndex = i; + lineIndex -= start; + break; + } + start = end; + lineCount += segments[i].length; + } + if (segmentIndex < 0) { + return const CodeLineIndex(-1, -1); + } + // Find the index in the segment + final List codeLines = segments[segmentIndex].codeLines; + int index = -1; + int start = 0; + for (int i = 0; i < codeLines.length; i++) { + final int end = start + codeLines[i].lineCount; + if (lineIndex >= start && lineIndex < end) { + index = i; + start++; + break; + } + start = end; + } + if (index == -1) { + return const CodeLineIndex(-1, -1); + } + // Find the index in the chunk + int chunkIndex = -1; + final List chunks = codeLines[index].chunks; + for (int i = 0; i < chunks.length; i++) { + final int end = start + chunks[i].lineCount; + if (lineIndex >= start && lineIndex < end) { + chunkIndex = i; + break; + } + start = end; + } + return CodeLineIndex(index + lineCount, chunkIndex); + } + + List toList() { + final List codeLines = []; + for (final CodeLineSegment segment in segments) { + codeLines.addAll(segment.codeLines); + } + return codeLines; + } + + @override + int get hashCode => segments.hashCode; + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeLines + && listEquals(other.segments, segments); + } + + @override + String toString() { + return '[ ${segments.join(',')} ]'; + } + +} + +class CodeLineSegment with ListMixin { + + final List codeLines; + final bool dirty; + + const CodeLineSegment({ + required this.codeLines, + this.dirty = false + }); + + factory CodeLineSegment.of({ + required List codeLines, + bool dirty = false + }) => _CodeLineSegmentQuckLineCount( + codeLines: codeLines, + dirty: dirty + ); + + @override + int get length => codeLines.length; + + int get lineCount => codeLines.fold(0, (previousValue, element) => previousValue += element.lineCount); + + @override + CodeLine operator [](int index) { + return codeLines[index]; + } + + @override + void operator []=(int index, CodeLine value) { + if (dirty) { + // Not support write operation + throw UnimplementedError(); + } else { + codeLines[index] = value; + } + } + + @override + set length(int newLength) { + if (dirty) { + // Not support write operation + throw UnimplementedError(); + } else { + codeLines.length = newLength; + } + } + + @override + void add(CodeLine element) { + if (dirty) { + // Not support write operation + throw UnimplementedError(); + } else { + codeLines.add(element); + } + } + + CodeLineSegment clone([int start = 0, int? end]) => CodeLineSegment.of( + codeLines: codeLines.sublist(start, end) + ); + + CodeLineSegment copyWith({ + List? codeLines, + bool? dirty, + }) { + return CodeLineSegment.of( + codeLines: codeLines ?? this.codeLines, + dirty: dirty ?? this.dirty + ); + } + + @override + int get hashCode => Object.hash(codeLines, lineCount, dirty); + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeLineSegment + && listEquals(other.codeLines, codeLines) + && other.lineCount == lineCount + && other.dirty == dirty; + } + + @override + String toString() { + return '[ ${join(',')} ]'; + } + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/code_paragraph.dart b/packages/re_editor/lib/src/code_paragraph.dart new file mode 100644 index 0000000..67021ed --- /dev/null +++ b/packages/re_editor/lib/src/code_paragraph.dart @@ -0,0 +1,28 @@ +part of re_editor; + +abstract class IParagraph { + + double get width; + double get height; + double get preferredLineHeight; + bool get trucated; + int get length; + int get lineCount; + + void draw(Canvas canvas, Offset offset); + + TextPosition getPosition(Offset offset); + + TextRange getWord(Offset offset); + + InlineSpan? getSpanForPosition(TextPosition position); + + TextRange getRangeForSpan(InlineSpan span); + + TextRange getLineBoundary(TextPosition position); + + Offset? getOffset(TextPosition position); + + List getRangeRects(TextRange range); + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/code_scroll.dart b/packages/re_editor/lib/src/code_scroll.dart new file mode 100644 index 0000000..a8d15e7 --- /dev/null +++ b/packages/re_editor/lib/src/code_scroll.dart @@ -0,0 +1,36 @@ +part of re_editor; + +typedef CodeScrollbarBuilder = Widget Function(BuildContext context, Widget child, ScrollableDetails details); + +class CodeScrollController { + + final ScrollController verticalScroller; + final ScrollController horizontalScroller; + + GlobalKey? _editorKey; + + CodeScrollController({ + ScrollController? verticalScroller, + ScrollController? horizontalScroller, + }) : verticalScroller = verticalScroller ?? ScrollController(), + horizontalScroller = horizontalScroller ?? ScrollController(); + + void makeCenterIfInvisible(CodeLinePosition position) { + _render?.makePositionCenterIfInvisible(position); + } + + void makeVisible(CodeLinePosition position) { + _render?.makePositionVisible(position); + } + + void bindEditor(GlobalKey key) { + _editorKey = key; + } + + _CodeFieldRender? get _render => _editorKey?.currentContext?.findRenderObject() as _CodeFieldRender?; + + void dispose() { + _editorKey = null; + } + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/code_shortcuts.dart b/packages/re_editor/lib/src/code_shortcuts.dart new file mode 100644 index 0000000..8a5c643 --- /dev/null +++ b/packages/re_editor/lib/src/code_shortcuts.dart @@ -0,0 +1,605 @@ +part of re_editor; + +enum CodeShortcutType { + selectAll, + cut, + copy, + paste, + delete, + backspace, + undo, + redo, + lineSelect, + lineDelete, + lineDeleteForward, + lineDeleteBackward, + lineMoveUp, + lineMoveDown, + cursorMoveUp, + cursorMoveDown, + cursorMoveForward, + cursorMoveBackward, + cursorMoveLineStart, + cursorMoveLineEnd, + cursorMovePageStart, + cursorMovePageEnd, + cursorMovePageUp, + cursorMovePageDown, + cursorMoveWordBoundaryForward, + cursorMoveWordBoundaryBackward, + selectionExtendUp, + selectionExtendDown, + selectionExtendForward, + selectionExtendBackward, + selectionExtendLineStart, + selectionExtendLineEnd, + selectionExtendPageStart, + selectionExtendPageEnd, + selectionExtendWordBoundaryForward, + selectionExtendWordBoundaryBackward, + wordDeleteForward, + wordDeleteBackward, + indent, + outdent, + newLine, + transposeCharacters, + singleLineComment, + multiLineComment, + find, + findToggleMatchCase, + findToggleRegex, + replace, + save, + esc, +} + +abstract class CodeShortcutsActivatorsBuilder { + + const CodeShortcutsActivatorsBuilder(); + + List? build(CodeShortcutType type); + +} + +class DefaultCodeShortcutsActivatorsBuilder extends CodeShortcutsActivatorsBuilder { + + const DefaultCodeShortcutsActivatorsBuilder(); + + @override + List? build(CodeShortcutType type) { + return kIsMacOS ? _kDefaultMacCodeShortcutsActivators[type] : + _kDefaultCommonCodeShortcutsActivators[type]; + } + +} + +abstract class CodeShortcutEditableIntent extends Intent { + const CodeShortcutEditableIntent(); +} + +class CodeShortcutSelectAllIntent extends Intent { + const CodeShortcutSelectAllIntent(); +} + +class CodeShortcutCopyIntent extends Intent { + const CodeShortcutCopyIntent(); +} + +class CodeShortcutCutIntent extends CodeShortcutEditableIntent { + const CodeShortcutCutIntent(); +} + +class CodeShortcutPasteIntent extends CodeShortcutEditableIntent { + const CodeShortcutPasteIntent(); +} + +class CodeShortcutUndoIntent extends CodeShortcutEditableIntent { + const CodeShortcutUndoIntent(); +} + +class CodeShortcutRedoIntent extends CodeShortcutEditableIntent { + const CodeShortcutRedoIntent(); +} + +class CodeShortcutLineSelectIntent extends Intent { + const CodeShortcutLineSelectIntent(); +} + +class ShortcutLineDeleteIntent extends CodeShortcutEditableIntent { + const ShortcutLineDeleteIntent(); +} + +class ShortcutLineMoveIntent extends CodeShortcutEditableIntent { + final VerticalDirection direction; + const ShortcutLineMoveIntent(this.direction); +} + +class ShortcutLineDeleteDirectionIntent extends CodeShortcutEditableIntent { + final bool forward; + const ShortcutLineDeleteDirectionIntent(this.forward); +} + +class CodeShortcutIndentIntent extends CodeShortcutEditableIntent { + const CodeShortcutIndentIntent(); +} + +class CodeShortcutOutdentIntent extends CodeShortcutEditableIntent { + const CodeShortcutOutdentIntent(); +} + +class CodeShortcutCommentIntent extends CodeShortcutEditableIntent { + final bool single; + const CodeShortcutCommentIntent(this.single); +} + +class CodeShortcutCursorMoveIntent extends Intent { + final AxisDirection direction; + const CodeShortcutCursorMoveIntent(this.direction); +} + +class CodeShortcutCursorMoveLineEdgeIntent extends Intent { + final bool forward; + const CodeShortcutCursorMoveLineEdgeIntent(this.forward); +} + +class CodeShortcutCursorMoveDocEdgeIntent extends Intent { + final bool forward; + const CodeShortcutCursorMoveDocEdgeIntent(this.forward); +} + +class CodeShortcutCursorMovePageIntent extends Intent { + final bool forward; + const CodeShortcutCursorMovePageIntent(this.forward); +} + +class CodeShortcutCursorMoveWordBoundaryIntent extends Intent { + final bool forward; + const CodeShortcutCursorMoveWordBoundaryIntent(this.forward); +} + +class CodeShortcutSelectionExtendIntent extends Intent { + final AxisDirection direction; + const CodeShortcutSelectionExtendIntent(this.direction); +} + +class CodeShortcutSelectionExtendLineEdgeIntent extends Intent { + final bool forward; + const CodeShortcutSelectionExtendLineEdgeIntent(this.forward); +} + +class CodeShortcutSelectionExtendPageEdgeIntent extends Intent { + final bool forward; + const CodeShortcutSelectionExtendPageEdgeIntent(this.forward); +} + +class CodeShortcutSelectionExtendWordBoundaryIntent extends Intent { + final bool forward; + const CodeShortcutSelectionExtendWordBoundaryIntent(this.forward); +} + +class ShortcutWordDeleteDirectionIntent extends CodeShortcutEditableIntent { + final bool forward; + const ShortcutWordDeleteDirectionIntent(this.forward); +} + +class CodeShortcutDeleteIntent extends CodeShortcutEditableIntent { + final bool forward; + const CodeShortcutDeleteIntent(this.forward); +} + +class CodeShortcutNewLineIntent extends CodeShortcutEditableIntent { + const CodeShortcutNewLineIntent(); +} + +class CodeShortcutTransposeCharactersIntent extends CodeShortcutEditableIntent { + const CodeShortcutTransposeCharactersIntent(); +} + +class CodeShortcutFindIntent extends Intent { + const CodeShortcutFindIntent(); +} + +class CodeShortcutFindToggleMatchCaseIntent extends Intent { + const CodeShortcutFindToggleMatchCaseIntent(); +} + +class CodeShortcutFindToggleRegexIntent extends Intent { + const CodeShortcutFindToggleRegexIntent(); +} + +class CodeShortcutReplaceIntent extends CodeShortcutEditableIntent { + const CodeShortcutReplaceIntent(); +} + +class CodeShortcutSaveIntent extends Intent { + const CodeShortcutSaveIntent(); +} + +class CodeShortcutEscIntent extends Intent { + const CodeShortcutEscIntent(); +} + +const Map kCodeShortcutIntents = { + CodeShortcutType.selectAll: CodeShortcutSelectAllIntent(), + CodeShortcutType.cut: CodeShortcutCutIntent(), + CodeShortcutType.copy: CodeShortcutCopyIntent(), + CodeShortcutType.paste: CodeShortcutPasteIntent(), + CodeShortcutType.delete: CodeShortcutDeleteIntent(true), + CodeShortcutType.backspace: CodeShortcutDeleteIntent(false), + CodeShortcutType.undo: CodeShortcutUndoIntent(), + CodeShortcutType.redo: CodeShortcutRedoIntent(), + CodeShortcutType.lineSelect: CodeShortcutLineSelectIntent(), + CodeShortcutType.lineDelete: ShortcutLineDeleteIntent(), + CodeShortcutType.lineDeleteForward: ShortcutLineDeleteDirectionIntent(true), + CodeShortcutType.lineDeleteBackward: ShortcutLineDeleteDirectionIntent(false), + CodeShortcutType.lineMoveUp: ShortcutLineMoveIntent(VerticalDirection.up), + CodeShortcutType.lineMoveDown: ShortcutLineMoveIntent(VerticalDirection.down), + CodeShortcutType.cursorMoveUp: CodeShortcutCursorMoveIntent(AxisDirection.up), + CodeShortcutType.cursorMoveDown: CodeShortcutCursorMoveIntent(AxisDirection.down), + CodeShortcutType.cursorMoveForward: CodeShortcutCursorMoveIntent(AxisDirection.right), + CodeShortcutType.cursorMoveBackward: CodeShortcutCursorMoveIntent(AxisDirection.left), + CodeShortcutType.cursorMoveLineStart: CodeShortcutCursorMoveLineEdgeIntent(false), + CodeShortcutType.cursorMoveLineEnd: CodeShortcutCursorMoveLineEdgeIntent(true), + CodeShortcutType.cursorMovePageStart: CodeShortcutCursorMoveDocEdgeIntent(false), + CodeShortcutType.cursorMovePageEnd: CodeShortcutCursorMoveDocEdgeIntent(true), + CodeShortcutType.cursorMovePageUp: CodeShortcutCursorMovePageIntent(false), + CodeShortcutType.cursorMovePageDown: CodeShortcutCursorMovePageIntent(true), + CodeShortcutType.cursorMoveWordBoundaryForward: CodeShortcutCursorMoveWordBoundaryIntent(true), + CodeShortcutType.cursorMoveWordBoundaryBackward: CodeShortcutCursorMoveWordBoundaryIntent(false), + CodeShortcutType.selectionExtendUp: CodeShortcutSelectionExtendIntent(AxisDirection.up), + CodeShortcutType.selectionExtendDown: CodeShortcutSelectionExtendIntent(AxisDirection.down), + CodeShortcutType.selectionExtendForward: CodeShortcutSelectionExtendIntent(AxisDirection.right), + CodeShortcutType.selectionExtendBackward: CodeShortcutSelectionExtendIntent(AxisDirection.left), + CodeShortcutType.selectionExtendLineStart: CodeShortcutSelectionExtendLineEdgeIntent(false), + CodeShortcutType.selectionExtendLineEnd: CodeShortcutSelectionExtendLineEdgeIntent(true), + CodeShortcutType.selectionExtendPageStart: CodeShortcutSelectionExtendPageEdgeIntent(false), + CodeShortcutType.selectionExtendPageEnd: CodeShortcutSelectionExtendPageEdgeIntent(true), + CodeShortcutType.selectionExtendWordBoundaryForward: CodeShortcutSelectionExtendWordBoundaryIntent(true), + CodeShortcutType.selectionExtendWordBoundaryBackward: CodeShortcutSelectionExtendWordBoundaryIntent(false), + CodeShortcutType.wordDeleteForward: ShortcutWordDeleteDirectionIntent(true), + CodeShortcutType.wordDeleteBackward: ShortcutWordDeleteDirectionIntent(false), + CodeShortcutType.indent: CodeShortcutIndentIntent(), + CodeShortcutType.outdent: CodeShortcutOutdentIntent(), + CodeShortcutType.newLine: CodeShortcutNewLineIntent(), + CodeShortcutType.transposeCharacters: CodeShortcutTransposeCharactersIntent(), + CodeShortcutType.singleLineComment: CodeShortcutCommentIntent(true), + CodeShortcutType.multiLineComment: CodeShortcutCommentIntent(false), + CodeShortcutType.find: CodeShortcutFindIntent(), + CodeShortcutType.findToggleMatchCase: CodeShortcutFindToggleMatchCaseIntent(), + CodeShortcutType.findToggleRegex: CodeShortcutFindToggleRegexIntent(), + CodeShortcutType.replace: CodeShortcutReplaceIntent(), + CodeShortcutType.save: CodeShortcutSaveIntent(), + CodeShortcutType.esc: CodeShortcutEscIntent(), +}; + +const Map> _kDefaultMacCodeShortcutsActivators = { + CodeShortcutType.selectAll: [ + SingleActivator(LogicalKeyboardKey.keyA, meta: true) + ], + CodeShortcutType.cut: [ + SingleActivator(LogicalKeyboardKey.keyX, meta: true) + ], + CodeShortcutType.copy: [ + SingleActivator(LogicalKeyboardKey.keyC, meta: true) + ], + CodeShortcutType.paste: [ + SingleActivator(LogicalKeyboardKey.keyV, meta: true) + ], + CodeShortcutType.delete: [ + SingleActivator(LogicalKeyboardKey.delete,), + SingleActivator(LogicalKeyboardKey.delete, shift: true), + ], + CodeShortcutType.backspace: [ + SingleActivator(LogicalKeyboardKey.backspace,), + SingleActivator(LogicalKeyboardKey.backspace, shift: true), + ], + CodeShortcutType.undo: [ + SingleActivator(LogicalKeyboardKey.keyZ, meta: true) + ], + CodeShortcutType.redo: [ + SingleActivator(LogicalKeyboardKey.keyZ, meta: true, shift: true) + ], + CodeShortcutType.lineSelect: [ + SingleActivator(LogicalKeyboardKey.keyL, meta: true) + ], + CodeShortcutType.lineDelete: [ + SingleActivator(LogicalKeyboardKey.keyD, meta: true) + ], + CodeShortcutType.lineDeleteForward: [ + SingleActivator(LogicalKeyboardKey.delete, meta: true) + ], + CodeShortcutType.lineDeleteBackward: [ + SingleActivator(LogicalKeyboardKey.backspace, meta: true) + ], + CodeShortcutType.lineMoveUp: [ + SingleActivator(LogicalKeyboardKey.arrowUp, alt: true) + ], + CodeShortcutType.lineMoveDown: [ + SingleActivator(LogicalKeyboardKey.arrowDown, alt: true) + ], + CodeShortcutType.cursorMoveUp: [ + SingleActivator(LogicalKeyboardKey.arrowUp) + ], + CodeShortcutType.cursorMoveDown: [ + SingleActivator(LogicalKeyboardKey.arrowDown) + ], + CodeShortcutType.cursorMoveForward: [ + SingleActivator(LogicalKeyboardKey.arrowRight) + ], + CodeShortcutType.cursorMoveBackward: [ + SingleActivator(LogicalKeyboardKey.arrowLeft) + ], + CodeShortcutType.cursorMoveLineStart: [ + SingleActivator(LogicalKeyboardKey.arrowLeft, meta: true), + SingleActivator(LogicalKeyboardKey.home) + ], + CodeShortcutType.cursorMoveLineEnd: [ + SingleActivator(LogicalKeyboardKey.arrowRight, meta: true), + SingleActivator(LogicalKeyboardKey.end), + ], + CodeShortcutType.cursorMovePageStart: [ + SingleActivator(LogicalKeyboardKey.arrowUp, meta: true), + SingleActivator(LogicalKeyboardKey.home, control: true) + ], + CodeShortcutType.cursorMovePageEnd: [ + SingleActivator(LogicalKeyboardKey.arrowDown, meta: true), + SingleActivator(LogicalKeyboardKey.end, control: true) + ], + CodeShortcutType.cursorMoveWordBoundaryBackward: [ + SingleActivator(LogicalKeyboardKey.arrowLeft, alt: true) + ], + CodeShortcutType.cursorMoveWordBoundaryForward: [ + SingleActivator(LogicalKeyboardKey.arrowRight, alt: true) + ], + CodeShortcutType.selectionExtendUp: [ + SingleActivator(LogicalKeyboardKey.arrowUp, shift: true) + ], + CodeShortcutType.selectionExtendDown: [ + SingleActivator(LogicalKeyboardKey.arrowDown, shift: true) + ], + CodeShortcutType.selectionExtendForward: [ + SingleActivator(LogicalKeyboardKey.arrowRight, shift: true) + ], + CodeShortcutType.selectionExtendBackward: [ + SingleActivator(LogicalKeyboardKey.arrowLeft, shift: true) + ], + CodeShortcutType.selectionExtendPageStart: [ + SingleActivator(LogicalKeyboardKey.arrowUp, shift: true, meta: true), + SingleActivator(LogicalKeyboardKey.home, shift: true, meta: true) + ], + CodeShortcutType.selectionExtendPageEnd: [ + SingleActivator(LogicalKeyboardKey.arrowDown, shift: true, meta: true), + SingleActivator(LogicalKeyboardKey.end, shift: true, meta: true) + ], + CodeShortcutType.selectionExtendLineStart: [ + SingleActivator(LogicalKeyboardKey.arrowLeft, shift: true, meta: true), + SingleActivator(LogicalKeyboardKey.home, shift: true) + ], + CodeShortcutType.selectionExtendLineEnd: [ + SingleActivator(LogicalKeyboardKey.arrowRight, shift: true, meta: true), + SingleActivator(LogicalKeyboardKey.end, shift: true) + ], + CodeShortcutType.selectionExtendWordBoundaryForward: [ + SingleActivator(LogicalKeyboardKey.arrowLeft, shift: true, alt: true) + ], + CodeShortcutType.selectionExtendWordBoundaryBackward: [ + SingleActivator(LogicalKeyboardKey.arrowRight, shift: true, alt: true) + ], + CodeShortcutType.wordDeleteForward: [ + SingleActivator(LogicalKeyboardKey.delete, alt: true), + SingleActivator(LogicalKeyboardKey.delete, alt: true, shift: true), + SingleActivator(LogicalKeyboardKey.delete, meta: true, shift: true) + ], + CodeShortcutType.wordDeleteBackward: [ + SingleActivator(LogicalKeyboardKey.backspace, alt: true), + SingleActivator(LogicalKeyboardKey.backspace, alt: true, shift: true), + SingleActivator(LogicalKeyboardKey.backspace, meta: true, shift: true) + ], + CodeShortcutType.indent: [ + SingleActivator(LogicalKeyboardKey.tab) + ], + CodeShortcutType.outdent: [ + SingleActivator(LogicalKeyboardKey.tab, shift: true) + ], + CodeShortcutType.newLine: [ + SingleActivator(LogicalKeyboardKey.enter), + SingleActivator(LogicalKeyboardKey.enter, shift: true), + SingleActivator(LogicalKeyboardKey.enter, meta: true), + SingleActivator(LogicalKeyboardKey.enter, meta: true, shift: true), + SingleActivator(LogicalKeyboardKey.numpadEnter), + SingleActivator(LogicalKeyboardKey.numpadEnter, shift: true), + SingleActivator(LogicalKeyboardKey.numpadEnter, meta: true), + SingleActivator(LogicalKeyboardKey.numpadEnter, meta: true, shift: true) + ], + CodeShortcutType.transposeCharacters: [ + SingleActivator(LogicalKeyboardKey.keyT, control: true) + ], + CodeShortcutType.singleLineComment: [ + SingleActivator(LogicalKeyboardKey.slash, meta: true) + ], + CodeShortcutType.multiLineComment: [ + SingleActivator(LogicalKeyboardKey.slash, meta: true, shift: true) + ], + CodeShortcutType.find: [ + SingleActivator(LogicalKeyboardKey.keyF, meta: true) + ], + CodeShortcutType.findToggleMatchCase: [ + SingleActivator(LogicalKeyboardKey.keyC, meta: true, alt: true) + ], + CodeShortcutType.findToggleRegex: [ + SingleActivator(LogicalKeyboardKey.keyR, meta: true, alt: true) + ], + CodeShortcutType.replace: [ + SingleActivator(LogicalKeyboardKey.keyF, meta: true, alt: true) + ], + CodeShortcutType.save: [ + SingleActivator(LogicalKeyboardKey.keyS, meta: true) + ], + CodeShortcutType.esc: [ + SingleActivator(LogicalKeyboardKey.escape) + ], +}; + +const Map> _kDefaultCommonCodeShortcutsActivators = { + CodeShortcutType.selectAll: [ + SingleActivator(LogicalKeyboardKey.keyA, control: true) + ], + CodeShortcutType.cut: [ + SingleActivator(LogicalKeyboardKey.keyX, control: true) + ], + CodeShortcutType.copy: [ + SingleActivator(LogicalKeyboardKey.keyC, control: true) + ], + CodeShortcutType.paste: [ + SingleActivator(LogicalKeyboardKey.keyV, control: true) + ], + CodeShortcutType.delete: [ + SingleActivator(LogicalKeyboardKey.delete,), + SingleActivator(LogicalKeyboardKey.delete, shift: true), + ], + CodeShortcutType.backspace: [ + SingleActivator(LogicalKeyboardKey.backspace,), + SingleActivator(LogicalKeyboardKey.backspace, shift: true), + ], + CodeShortcutType.undo: [ + SingleActivator(LogicalKeyboardKey.keyZ, control: true) + ], + CodeShortcutType.redo: [ + SingleActivator(LogicalKeyboardKey.keyZ, control: true, shift: true) + ], + CodeShortcutType.lineSelect: [ + SingleActivator(LogicalKeyboardKey.keyL, control: true) + ], + CodeShortcutType.lineDelete: [ + SingleActivator(LogicalKeyboardKey.keyD, control: true) + ], + CodeShortcutType.lineDeleteForward: [ + SingleActivator(LogicalKeyboardKey.delete, control: true) + ], + CodeShortcutType.lineDeleteBackward: [ + SingleActivator(LogicalKeyboardKey.backspace, control: true) + ], + CodeShortcutType.lineMoveUp: [ + SingleActivator(LogicalKeyboardKey.arrowUp, alt: true) + ], + CodeShortcutType.lineMoveDown: [ + SingleActivator(LogicalKeyboardKey.arrowDown, alt: true) + ], + CodeShortcutType.cursorMoveUp: [ + SingleActivator(LogicalKeyboardKey.arrowUp) + ], + CodeShortcutType.cursorMoveDown: [ + SingleActivator(LogicalKeyboardKey.arrowDown) + ], + CodeShortcutType.cursorMoveForward: [ + SingleActivator(LogicalKeyboardKey.arrowRight) + ], + CodeShortcutType.cursorMoveBackward: [ + SingleActivator(LogicalKeyboardKey.arrowLeft) + ], + CodeShortcutType.cursorMoveLineStart: [ + SingleActivator(LogicalKeyboardKey.arrowLeft, control: true), + SingleActivator(LogicalKeyboardKey.home) + ], + CodeShortcutType.cursorMoveLineEnd: [ + SingleActivator(LogicalKeyboardKey.arrowRight, control: true), + SingleActivator(LogicalKeyboardKey.end) + ], + CodeShortcutType.cursorMovePageStart: [ + SingleActivator(LogicalKeyboardKey.arrowUp, control: true), + SingleActivator(LogicalKeyboardKey.home, control: true) + ], + CodeShortcutType.cursorMovePageEnd: [ + SingleActivator(LogicalKeyboardKey.arrowDown, control: true), + SingleActivator(LogicalKeyboardKey.end, control: true) + ], + CodeShortcutType.cursorMoveWordBoundaryBackward: [ + SingleActivator(LogicalKeyboardKey.arrowLeft, alt: true) + ], + CodeShortcutType.cursorMoveWordBoundaryForward: [ + SingleActivator(LogicalKeyboardKey.arrowRight, alt: true) + ], + CodeShortcutType.selectionExtendUp: [ + SingleActivator(LogicalKeyboardKey.arrowUp, shift: true) + ], + CodeShortcutType.selectionExtendDown: [ + SingleActivator(LogicalKeyboardKey.arrowDown, shift: true) + ], + CodeShortcutType.selectionExtendForward: [ + SingleActivator(LogicalKeyboardKey.arrowRight, shift: true) + ], + CodeShortcutType.selectionExtendBackward: [ + SingleActivator(LogicalKeyboardKey.arrowLeft, shift: true) + ], + CodeShortcutType.selectionExtendPageStart: [ + SingleActivator(LogicalKeyboardKey.home, shift: true, control: true) + ], + CodeShortcutType.selectionExtendPageEnd: [ + SingleActivator(LogicalKeyboardKey.end, shift: true, control: true) + ], + CodeShortcutType.selectionExtendLineStart: [ + SingleActivator(LogicalKeyboardKey.home, shift: true) + ], + CodeShortcutType.selectionExtendLineEnd: [ + SingleActivator(LogicalKeyboardKey.end, shift: true) + ], + CodeShortcutType.selectionExtendWordBoundaryForward: [ + SingleActivator(LogicalKeyboardKey.arrowLeft, shift: true, alt: true) + ], + CodeShortcutType.selectionExtendWordBoundaryBackward: [ + SingleActivator(LogicalKeyboardKey.arrowRight, shift: true, alt: true) + ], + CodeShortcutType.wordDeleteForward: [ + SingleActivator(LogicalKeyboardKey.delete, alt: true), + SingleActivator(LogicalKeyboardKey.delete, alt: true, shift: true), + SingleActivator(LogicalKeyboardKey.delete, control: true), + ], + CodeShortcutType.wordDeleteBackward: [ + SingleActivator(LogicalKeyboardKey.backspace, alt: true), + SingleActivator(LogicalKeyboardKey.backspace, alt: true, shift: true), + SingleActivator(LogicalKeyboardKey.backspace, control: true), + ], + CodeShortcutType.indent: [ + SingleActivator(LogicalKeyboardKey.tab) + ], + CodeShortcutType.outdent: [ + SingleActivator(LogicalKeyboardKey.tab, shift: true) + ], + CodeShortcutType.newLine: [ + SingleActivator(LogicalKeyboardKey.enter), + SingleActivator(LogicalKeyboardKey.enter, shift: true), + SingleActivator(LogicalKeyboardKey.enter, control: true), + SingleActivator(LogicalKeyboardKey.enter, control: true, shift: true), + SingleActivator(LogicalKeyboardKey.numpadEnter), + SingleActivator(LogicalKeyboardKey.numpadEnter, shift: true), + SingleActivator(LogicalKeyboardKey.numpadEnter, control: true), + SingleActivator(LogicalKeyboardKey.numpadEnter, control: true, shift: true) + ], + CodeShortcutType.transposeCharacters: [ + SingleActivator(LogicalKeyboardKey.keyT, control: true) + ], + CodeShortcutType.singleLineComment: [ + SingleActivator(LogicalKeyboardKey.slash, control: true) + ], + CodeShortcutType.multiLineComment: [ + SingleActivator(LogicalKeyboardKey.slash, control: true, shift: true) + ], + CodeShortcutType.find: [ + SingleActivator(LogicalKeyboardKey.keyF, control: true) + ], + CodeShortcutType.findToggleMatchCase: [ + SingleActivator(LogicalKeyboardKey.keyC, control: true, alt: true) + ], + CodeShortcutType.findToggleRegex: [ + SingleActivator(LogicalKeyboardKey.keyR, control: true, alt: true) + ], + CodeShortcutType.replace: [ + SingleActivator(LogicalKeyboardKey.keyF, control: true, alt: true) + ], + CodeShortcutType.save: [ + SingleActivator(LogicalKeyboardKey.keyS, control: true) + ], + CodeShortcutType.esc: [ + SingleActivator(LogicalKeyboardKey.escape) + ], +}; \ No newline at end of file diff --git a/packages/re_editor/lib/src/code_span.dart b/packages/re_editor/lib/src/code_span.dart new file mode 100644 index 0000000..f01d9a3 --- /dev/null +++ b/packages/re_editor/lib/src/code_span.dart @@ -0,0 +1,26 @@ +part of re_editor; + +typedef PointerEnterEventWithRectListener = void Function(PointerEnterEvent event, int id, List rects); + +typedef PointerExitEventWithRectListener = void Function(PointerExitEvent event, int id, List rects); + +@immutable +class MouseTrackerAnnotationTextSpan extends TextSpan { + + final PointerEnterEventWithRectListener onEnterWithRect; + final PointerExitEventWithRectListener onExitWithRect; + + const MouseTrackerAnnotationTextSpan({ + super.text, + super.children, + super.style, + super.recognizer, + super.mouseCursor, + super.semanticsLabel, + super.locale, + super.spellOut, + required this.onEnterWithRect, + required this.onExitWithRect, + }); + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/code_theme.dart b/packages/re_editor/lib/src/code_theme.dart new file mode 100644 index 0000000..545d531 --- /dev/null +++ b/packages/re_editor/lib/src/code_theme.dart @@ -0,0 +1,90 @@ +part of re_editor; + +/// The code syntax highlighting theme. We use Re-Highlight as the syntax highlighting rule. +/// Re-Highlight provides some built-in syntax highlighting rules for dozens of programming languages, +/// and many theme styles. +/// +/// Please see [Re-Highlight](https://reqable/re-highlight). +class CodeHighlightTheme { + + const CodeHighlightTheme({ + required this.languages, + required this.theme, + this.plugins = const [], + }); + + /// Supported syntax highlighting language rules. + final Map languages; + + /// The syntax highlighting style theme. + final Map theme; + + /// The plugins for syntax highlighting. + final List plugins; + + @override + int get hashCode => Object.hash(languages, theme, plugins); + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeHighlightTheme + && mapEquals(other.languages, languages) + && mapEquals(other.theme, theme) + && listEquals(other.plugins, plugins); + } + +} + +/// Define language rules and restrictions for highlighting. +/// +/// Since the dart stack capacity is relatively small, stack overflow may occur +/// when executing syntax highlighting, so we added some restrictions to disable +/// syntax highlighting. +/// +/// The issue see https://github.com/dart-lang/sdk/issues/48425 +class CodeHighlightThemeMode { + + const CodeHighlightThemeMode({ + required this.mode, + this.maxSize = 4 * 1024 * 1024, + this.maxLineLength = 1 * 1024 * 1024, + }); + + /// Syntax highlighting language rule. + final Mode mode; + + /// If the total text length is higher than this value, syntax highlighting + /// will not be performed. + /// + /// The default value is 4MB. + final int maxSize; + + /// If the text length of a line is higher than this value, syntax highlighting + /// will not be performed. + /// + /// The default value is 1MB. + final int maxLineLength; + + @override + int get hashCode => Object.hash(mode, maxSize, maxLineLength); + + @override + bool operator ==(Object other) { + if (identical(this, other)) { + return true; + } + return other is CodeHighlightThemeMode + && mode == other.mode && maxSize == other.maxSize + && maxLineLength == other.maxLineLength; + } + +} + +extension CodeHighlightThemeModeExtension on Mode { + + CodeHighlightThemeMode get themeMode => CodeHighlightThemeMode(mode: this); + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/code_toolbar.dart b/packages/re_editor/lib/src/code_toolbar.dart new file mode 100644 index 0000000..5b2948f --- /dev/null +++ b/packages/re_editor/lib/src/code_toolbar.dart @@ -0,0 +1,34 @@ +part of re_editor; + +typedef ToolbarMenuBuilder = Widget Function({ + required BuildContext context, + required TextSelectionToolbarAnchors anchors, + required CodeLineEditingController controller, + required VoidCallback onDismiss, + required VoidCallback onRefresh, +}); + +abstract class SelectionToolbarController { + + void show({ + required BuildContext context, + required CodeLineEditingController controller, + required TextSelectionToolbarAnchors anchors, + Rect? renderRect, + required LayerLink layerLink, + required ValueNotifier visibility, + }); + + void hide(BuildContext context); + +} + +abstract class MobileSelectionToolbarController implements SelectionToolbarController { + + factory MobileSelectionToolbarController({ + required ToolbarMenuBuilder builder + }) => _MobileSelectionToolbarController( + builder: builder + ); + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/debug/_trace.dart b/packages/re_editor/lib/src/debug/_trace.dart new file mode 100644 index 0000000..496ed30 --- /dev/null +++ b/packages/re_editor/lib/src/debug/_trace.dart @@ -0,0 +1,22 @@ +part of re_editor; + +class _Trace { + + static final Map _timestamps = {}; + + static void begin(String name) { + _timestamps[name] = DateTime.now(); + } + + static void end(String name, [bool microsecond = false]) { + final DateTime? time = _timestamps.remove(name); + if (time != null) { + if (microsecond) { + print('[${DateTime.now()}] $name costs ${DateTime.now().microsecondsSinceEpoch - time.microsecondsSinceEpoch} us'); + } else { + print('[${DateTime.now()}] $name costs ${DateTime.now().millisecondsSinceEpoch - time.millisecondsSinceEpoch} ms'); + } + } + } + +} \ No newline at end of file diff --git a/packages/re_editor/lib/src/re_editor.dart b/packages/re_editor/lib/src/re_editor.dart new file mode 100644 index 0000000..72a8a90 --- /dev/null +++ b/packages/re_editor/lib/src/re_editor.dart @@ -0,0 +1,52 @@ +library re_editor; + +import 'dart:async'; +import 'dart:math'; +import 'dart:ui' as ui; +import 'dart:collection'; + +import 'package:flutter/cupertino.dart'; +import 'package:flutter/foundation.dart'; +import 'package:flutter/gestures.dart'; +import 'package:flutter/material.dart'; +import 'package:flutter/rendering.dart'; +import 'package:flutter/scheduler.dart'; +import 'package:flutter/services.dart'; + +import 'package:re_highlight/re_highlight.dart'; +import 'package:isolate_manager/isolate_manager.dart'; + +part '_code_floating_cursor.dart'; +part '_code_autocomplete.dart'; +part '_code_editable.dart'; +part '_code_extensions.dart'; +part '_code_field.dart'; +part '_code_find.dart'; +part '_code_formatter.dart'; +part '_code_highlight.dart'; +part '_code_indicator.dart'; +part '_code_input.dart'; +part '_code_line.dart'; +part '_code_lines.dart'; +part '_code_paragraph.dart'; +part '_code_scroll.dart'; +part '_code_selection.dart'; +part '_code_shortcuts.dart'; +part '_code_span.dart'; +part '_consts.dart'; +part '_isolate.dart'; +part 'code_autocomplete.dart'; +part 'code_chunk.dart'; +part 'code_editor.dart'; +part 'code_find.dart'; +part 'code_formatter.dart'; +part 'code_indicator.dart'; +part 'code_line.dart'; +part 'code_lines.dart'; +part 'code_paragraph.dart'; +part 'code_shortcuts.dart'; +part 'code_scroll.dart'; +part 'code_span.dart'; +part 'code_theme.dart'; +part 'code_toolbar.dart'; +part 'debug/_trace.dart'; \ No newline at end of file diff --git a/packages/re_editor/pubspec.yaml b/packages/re_editor/pubspec.yaml new file mode 100644 index 0000000..99678a6 --- /dev/null +++ b/packages/re_editor/pubspec.yaml @@ -0,0 +1,20 @@ +name: re_editor +description: Re-Editor is a powerful lightweight text and code editor widget. +version: 0.10.0 +homepage: https://reqable.com +repository: https://github.com/reqable/re-editor + +environment: + sdk: ">=2.17.3 <4.0.0" + +dependencies: + flutter: + sdk: flutter + re_highlight: ^0.0.3 + isolate_manager: ^4.1.5+1 + +dev_dependencies: + flutter_test: + sdk: flutter + flutter_lints: ^2.0.1 + path: ^1.8.2 \ No newline at end of file diff --git a/packages/re_editor/test/code_chunk_default_analyzer_test.dart b/packages/re_editor/test/code_chunk_default_analyzer_test.dart new file mode 100644 index 0000000..3baec61 --- /dev/null +++ b/packages/re_editor/test/code_chunk_default_analyzer_test.dart @@ -0,0 +1,609 @@ +import 'dart:io'; + +import 'package:flutter_test/flutter_test.dart'; +import 'package:path/path.dart'; +import 'package:re_editor/re_editor.dart'; + +void main() { + const DefaultCodeChunkAnalyzer analyzer = DefaultCodeChunkAnalyzer(); + group('DefaultCodeChunkAnalyzer.parse()', () { + test('A single code line with empty content', () { + { + final CodeLines codeLines = CodeLines.of([ + CodeLine.empty + ]); + expect(analyzer.parse(codeLines), const []); + } + }); + test('A single code line without quota', () { + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc') + ]); + expect(analyzer.parse(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('(') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('(', 0) + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine(')') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol(')', 0) + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('[') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('[', 0) + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine(']') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol(']', 0) + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('{') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('{', 0) + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('}') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('}', 0) + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('()') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('(', 0), + CodeChunkSymbol(')', 0) + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('[]') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('[', 0), + CodeChunkSymbol(']', 0) + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('{}') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('{', 0), + CodeChunkSymbol('}', 0) + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('()[]{}') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('(', 0), + CodeChunkSymbol(')', 0), + CodeChunkSymbol('[', 0), + CodeChunkSymbol(']', 0), + CodeChunkSymbol('{', 0), + CodeChunkSymbol('}', 0) + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('123{[foo]((abc))[[]]{{bar}}()}') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('{', 0), + CodeChunkSymbol('[', 0), + CodeChunkSymbol(']', 0), + CodeChunkSymbol('(', 0), + CodeChunkSymbol('(', 0), + CodeChunkSymbol(')', 0), + CodeChunkSymbol(')', 0), + CodeChunkSymbol('[', 0), + CodeChunkSymbol('[', 0), + CodeChunkSymbol(']', 0), + CodeChunkSymbol(']', 0), + CodeChunkSymbol('{', 0), + CodeChunkSymbol('{', 0), + CodeChunkSymbol('}', 0), + CodeChunkSymbol('}', 0), + CodeChunkSymbol('(', 0), + CodeChunkSymbol(')', 0), + CodeChunkSymbol('}', 0), + ]); + } + }); + + test('A single code line with quotas', () { + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('"') + ]); + expect(analyzer.parse(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('\'') + ]); + expect(analyzer.parse(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('\\"\\"') + ]); + expect(analyzer.parse(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('\\\'\\\'') + ]); + expect(analyzer.parse(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('"abc"') + ]); + expect(analyzer.parse(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('\'abc\'') + ]); + expect(analyzer.parse(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('"\'abc\'"') + ]); + expect(analyzer.parse(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('"("') + ]); + expect(analyzer.parse(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('\'(\'') + ]); + expect(analyzer.parse(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('"()[]{}"') + ]); + expect(analyzer.parse(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('\'()[]{}\'') + ]); + expect(analyzer.parse(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('"\'()[]{}\'"') + ]); + expect(analyzer.parse(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('\\"\'()[]{}\'\\"') + ]); + expect(analyzer.parse(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('""(') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('(', 0), + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('""(""') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('(', 0), + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('""("")') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('(', 0), + CodeChunkSymbol(')', 0), + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('\'\'(') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('(', 0), + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('\'\'(\'\'') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('(', 0), + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('\'\'(\'\')') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('(', 0), + CodeChunkSymbol(')', 0), + ]); + } + }); + + test('A single code line with unbalanced quotas', () { + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('\'(') + ]); + expect(analyzer.parse(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('"(') + ]); + expect(analyzer.parse(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('\'(\'\')') + ]); + expect(analyzer.parse(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('"\'()[]{}') + ]); + expect(analyzer.parse(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('"\'()"[]') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('[', 0), + CodeChunkSymbol(']', 0), + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('"\\"()"[]') + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('[', 0), + CodeChunkSymbol(']', 0), + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('\\"()"[]') + ]); + expect(analyzer.parse(codeLines), const []); + } + }); + + test('Multi code lines', () { + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('()'), + CodeLine('[]'), + CodeLine('{}'), + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('(', 0), + CodeChunkSymbol(')', 0), + CodeChunkSymbol('[', 1), + CodeChunkSymbol(']', 1), + CodeChunkSymbol('{', 2), + CodeChunkSymbol('}', 2), + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('('), + CodeLine('{'), + CodeLine('['), + CodeLine('inner1'), + CodeLine('inner2'), + CodeLine('inner3'), + CodeLine(']'), + CodeLine('{'), + CodeLine('inner'), + CodeLine('inner4'), + CodeLine('inner5'), + CodeLine('inner6'), + CodeLine('inner7'), + CodeLine('}'), + CodeLine('}'), + CodeLine(')'), + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('(', 0), + CodeChunkSymbol('{', 1), + CodeChunkSymbol('[', 2), + CodeChunkSymbol(']', 6), + CodeChunkSymbol('{', 7), + CodeChunkSymbol('}', 13), + CodeChunkSymbol('}', 14), + CodeChunkSymbol(')', 15), + ]); + } + // Half collapsed code lines + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('('), + CodeLine('[', [ + CodeLine('inner1'), + CodeLine('inner2'), + CodeLine('inner3'), + ]), + CodeLine(']'), + CodeLine(')'), + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('(', 0), + CodeChunkSymbol('[', 1), + CodeChunkSymbol(']', 2), + CodeChunkSymbol(')', 3), + ]); + } + // All collapsed code lines + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('(', [ + CodeLine('{', [ + CodeLine('[', [ + CodeLine('inner1'), + CodeLine('inner2'), + CodeLine('inner3'), + ]) + ]), + CodeLine(']'), + CodeLine('{', [ + CodeLine('inner', [ + CodeLine('inner4'), + CodeLine('inner5'), + CodeLine('inner6'), + CodeLine('inner7'), + ]) + ]), + CodeLine('}'), + CodeLine('}'), + ]), + CodeLine(')'), + ]); + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('(', 0), + CodeChunkSymbol(')', 1), + ]); + } + }); + + test('Parse a json string', () { + { + final CodeLines codeLines = File(join('test', 'data', 'json_pretty.json')).readAsStringSync().codeLines; + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('{', 0), + CodeChunkSymbol('{', 1), + CodeChunkSymbol('[', 2), + CodeChunkSymbol(']', 4), + CodeChunkSymbol('}', 5), + CodeChunkSymbol('[', 6), + CodeChunkSymbol('{', 7), + CodeChunkSymbol('}', 10), + CodeChunkSymbol('{', 11), + CodeChunkSymbol('}', 14), + CodeChunkSymbol(']', 15), + CodeChunkSymbol('}', 17), + ]); + } + { + final CodeLines codeLines = File(join('test', 'data', 'json_flatted.json')).readAsStringSync().codeLines; + expect(analyzer.parse(codeLines), const [ + CodeChunkSymbol('{', 0), + CodeChunkSymbol('{', 0), + CodeChunkSymbol('[', 0), + CodeChunkSymbol(']', 0), + CodeChunkSymbol('}', 0), + CodeChunkSymbol('[', 0), + CodeChunkSymbol('{', 0), + CodeChunkSymbol('}', 0), + CodeChunkSymbol('{', 0), + CodeChunkSymbol('}', 0), + CodeChunkSymbol(']', 0), + CodeChunkSymbol('}', 0), + ]); + } + }); + }); + + group('DefaultCodeChunkAnalyzer.run()', () { + test('A single code line', () { + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine.empty + ]); + expect(analyzer.run(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc') + ]); + expect(analyzer.run(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc(){}[]') + ]); + expect(analyzer.run(codeLines), const []); + } + }); + test('Multi code lines', () { + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine.empty, + CodeLine.empty, + CodeLine.empty, + CodeLine.empty, + CodeLine.empty, + ]); + expect(analyzer.run(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('abc'), + CodeLine('abc'), + CodeLine('abc'), + CodeLine('abc'), + ]); + expect(analyzer.run(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc(){}[]'), + CodeLine('abc(){}[]'), + CodeLine('abc(){}[]'), + CodeLine('abc(){}[]'), + CodeLine('abc(){}[]'), + ]); + expect(analyzer.run(codeLines), const []); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc('), + CodeLine('abc'), + CodeLine('abc'), + CodeLine('abc'), + CodeLine('abc)'), + ]); + expect(analyzer.run(codeLines), const [ + CodeChunk(0, 4) + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc('), + CodeLine('abc['), + CodeLine('abc{}'), + CodeLine('abc]'), + CodeLine('abc)'), + ]); + expect(analyzer.run(codeLines), const [ + CodeChunk(0, 4), + CodeChunk(1, 3) + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('{'), + CodeLine('}'), + CodeLine('{'), + CodeLine('}'), + CodeLine('{'), + CodeLine('}'), + ]); + expect(analyzer.run(codeLines), const [ + CodeChunk(0, 1), + CodeChunk(2, 3), + CodeChunk(4, 5) + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc('), + CodeLine('abc[[[['), + CodeLine('abc'), + CodeLine('abc]]]]'), + CodeLine('abc)'), + ]); + expect(analyzer.run(codeLines), const [ + CodeChunk(0, 4), + CodeChunk(1, 3) + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc('), + CodeLine('[[[['), + CodeLine('abc'), + CodeLine(']'), + CodeLine(']'), + CodeLine(']'), + CodeLine(']'), + CodeLine('abc)'), + ]); + expect(analyzer.run(codeLines), const [ + CodeChunk(0, 7), + CodeChunk(1, 3) + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc('), + CodeLine('abc['), + CodeLine('abc'), + CodeLine('abc['), + CodeLine('abc)'), + ]); + expect(analyzer.run(codeLines), const [ + CodeChunk(0, 4), + ]); + } + }); + test('Parse a json string', () { + { + final CodeLines codeLines = File(join('test', 'data', 'json_pretty.json')).readAsStringSync().codeLines; + expect(analyzer.run(codeLines), const [ + CodeChunk(0, 17), + CodeChunk(1, 5), + CodeChunk(2, 4), + CodeChunk(6, 15), + CodeChunk(7, 10), + CodeChunk(11, 14) + ]); + } + { + final CodeLines codeLines = File(join('test', 'data', 'json_flatted.json')).readAsStringSync().codeLines; + expect(analyzer.run(codeLines), const []); + } + }); + }); +} \ No newline at end of file diff --git a/packages/re_editor/test/code_chunk_test.dart b/packages/re_editor/test/code_chunk_test.dart new file mode 100644 index 0000000..5e67ee9 --- /dev/null +++ b/packages/re_editor/test/code_chunk_test.dart @@ -0,0 +1,936 @@ +import 'package:flutter_test/flutter_test.dart'; +import 'package:re_editor/re_editor.dart'; + +void main() { + group('CodeChunkController constructor', () { + test('CodeChunkController()', () async { + { + final CodeChunkController controller = CodeChunkController(CodeLineEditingController(), + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200), () { + expect(controller.value, const []); + controller.dispose(); + }); + } + { + final CodeChunkController controller = CodeChunkController(CodeLineEditingController.fromText('{\n\n}'), + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.value, const [ + CodeChunk(0, 2) + ]); + controller.dispose(); + } + }); + }); + + group('CodeChunkController method', () { + + test('collapse()', () async { + // Empty content, and no chunk + { + final CodeChunkController controller = CodeChunkController(CodeLineEditingController(), + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + controller.collapse(0); + expect(controller.value, const []); + controller.dispose(); + } + // Non-Empty content, but no chunk + { + final CodeChunkController controller = CodeChunkController(CodeLineEditingController.fromText('abc'), + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + controller.collapse(0); + expect(controller.value, const []); + controller.dispose(); + } + // Have a chunk, but nothing to collapse + { + final CodeChunkController controller = CodeChunkController(CodeLineEditingController.fromText('{\n}'), + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.value, const [ + CodeChunk(0, 1) + ]); + controller.collapse(0); + expect(controller.value, const [ + CodeChunk(0, 1) + ]); + controller.dispose(); + } + // Have only a chunk + { + final CodeLineEditingController editingController = CodeLineEditingController.fromText('{\nabc\n}'); + final CodeChunkController controller = CodeChunkController(editingController, + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.value, const [ + CodeChunk(0, 2) + ]); + controller.collapse(0); + expect(controller.value, const [ + CodeChunk(0, 1) + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{', [ + CodeLine('abc') + ]), + CodeLine('}') + ])); + controller.dispose(); + } + // Have multi chunks, collapse from inside one by one + { + final CodeLineEditingController editingController = CodeLineEditingController.fromText('{\n\n{\n[\nabc\n(foo)\nbar\n]\n}\n\n}'); + final CodeChunkController controller = CodeChunkController(editingController, + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.value, const [ + CodeChunk(0, 10), + CodeChunk(2, 8), + CodeChunk(3, 7), + ]); + controller.collapse(3); + expect(controller.value, const [ + CodeChunk(0, 7), + CodeChunk(2, 5), + CodeChunk(3, 4), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(''), + CodeLine('{'), + CodeLine('[', [ + CodeLine('abc'), + CodeLine('(foo)'), + CodeLine('bar'), + ]), + CodeLine(']'), + CodeLine('}'), + CodeLine(''), + CodeLine('}') + ])); + controller.collapse(2); + expect(controller.value, const [ + CodeChunk(0, 5), + CodeChunk(2, 3) + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(''), + CodeLine('{', [ + CodeLine('[', [ + CodeLine('abc'), + CodeLine('(foo)'), + CodeLine('bar'), + ]), + CodeLine(']') + ]), + CodeLine('}'), + CodeLine(''), + CodeLine('}') + ])); + controller.collapse(0); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{', [ + CodeLine(''), + CodeLine('{', [ + CodeLine('[', [ + CodeLine('abc'), + CodeLine('(foo)'), + CodeLine('bar'), + ]), + CodeLine(']') + ]), + CodeLine('}'), + CodeLine(''), + ]), + CodeLine('}') + ])); + controller.collapse(0); + expect(controller.value, const [ + CodeChunk(0, 1) + ]); + controller.dispose(); + } + // Have multi chunks, collapse from top one by one + { + final CodeLineEditingController editingController = CodeLineEditingController.fromText('{\n\n}{\n\n}{\n\n}{\n\n}'); + final CodeChunkController controller = CodeChunkController(editingController, + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.value, const [ + CodeChunk(0, 2), + CodeChunk(2, 4), + CodeChunk(4, 6), + CodeChunk(6, 8), + ]); + controller.collapse(0); + expect(controller.value, const [ + CodeChunk(0, 1), + CodeChunk(1, 3), + CodeChunk(3, 5), + CodeChunk(5, 7), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{', [ + CodeLine('') + ]), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}'), + ])); + controller.collapse(1); + expect(controller.value, const [ + CodeChunk(0, 1), + CodeChunk(1, 2), + CodeChunk(2, 4), + CodeChunk(4, 6), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}'), + ])); + controller.collapse(2); + expect(controller.value, const [ + CodeChunk(0, 1), + CodeChunk(1, 2), + CodeChunk(2, 3), + CodeChunk(3, 5), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}{'), + CodeLine(''), + CodeLine('}'), + ])); + controller.collapse(3); + expect(controller.value, const [ + CodeChunk(0, 1), + CodeChunk(1, 2), + CodeChunk(2, 3), + CodeChunk(3, 4), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}'), + ])); + } + // Have multi chunks, collapse from bottom one by one + { + final CodeLineEditingController editingController = CodeLineEditingController.fromText('{\n\n}{\n\n}{\n\n}{\n\n}'); + final CodeChunkController controller = CodeChunkController(editingController, + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.value, const [ + CodeChunk(0, 2), + CodeChunk(2, 4), + CodeChunk(4, 6), + CodeChunk(6, 8), + ]); + controller.collapse(6); + expect(controller.value, const [ + CodeChunk(0, 2), + CodeChunk(2, 4), + CodeChunk(4, 6), + CodeChunk(6, 7), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{', [ + CodeLine(''), + ]), + CodeLine('}'), + ])); + controller.collapse(4); + expect(controller.value, const [ + CodeChunk(0, 2), + CodeChunk(2, 4), + CodeChunk(4, 5), + CodeChunk(5, 6), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{', [ + CodeLine(''), + ]), + CodeLine('}{', [ + CodeLine(''), + ]), + CodeLine('}'), + ])); + controller.collapse(2); + expect(controller.value, const [ + CodeChunk(0, 2), + CodeChunk(2, 3), + CodeChunk(3, 4), + CodeChunk(4, 5), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(''), + CodeLine('}{', [ + CodeLine(''), + ]), + CodeLine('}{', [ + CodeLine(''), + ]), + CodeLine('}{', [ + CodeLine(''), + ]), + CodeLine('}'), + ])); + controller.collapse(0); + expect(controller.value, const [ + CodeChunk(0, 1), + CodeChunk(1, 2), + CodeChunk(2, 3), + CodeChunk(3, 4), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}'), + ])); + } + }); + + test('expand()', () async { + // Empty content, and no chunk + { + final CodeChunkController controller = CodeChunkController(CodeLineEditingController(), + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + controller.expand(0); + expect(controller.value, const []); + controller.dispose(); + } + // Non-Empty content, but no chunk + { + final CodeChunkController controller = CodeChunkController(CodeLineEditingController.fromText('abc'), + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + controller.expand(0); + expect(controller.value, const []); + controller.dispose(); + } + // Have a chunk, but nothing to expand + { + final CodeChunkController controller = CodeChunkController(CodeLineEditingController.fromText('{\n}'), + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.value, const [ + CodeChunk(0, 1) + ]); + controller.expand(0); + expect(controller.value, const [ + CodeChunk(0, 1) + ]); + controller.dispose(); + } + // Have only a collapsed chunk + { + final CodeLineEditingController editingController = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('{', [ + CodeLine('abc'), + ]), + CodeLine('}'), + ] + )); + final CodeChunkController controller = CodeChunkController(editingController, const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.value, const [ + CodeChunk(0, 1), + ]); + controller.expand(0); + expect(controller.value, const [ + CodeChunk(0, 2) + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine('abc'), + CodeLine('}'), + ])); + controller.dispose(); + } + // Have multi collapsed chunks, expand from outside one by one + { + final CodeLineEditingController editingController = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('{', [ + CodeLine(''), + CodeLine('{', [ + CodeLine('[', [ + CodeLine('abc'), + CodeLine('(foo)'), + CodeLine('bar'), + ]), + CodeLine(']') + ]), + CodeLine('}'), + CodeLine(''), + ]), + CodeLine('}') + ] + )); + final CodeChunkController controller = CodeChunkController(editingController, + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.value, const [ + CodeChunk(0, 1), + ]); + controller.expand(0); + expect(controller.value, const [ + CodeChunk(0, 5), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(''), + CodeLine('{', [ + CodeLine('[', [ + CodeLine('abc'), + CodeLine('(foo)'), + CodeLine('bar'), + ]), + CodeLine(']') + ]), + CodeLine('}'), + CodeLine(''), + CodeLine('}') + ])); + controller.expand(2); + expect(controller.value, const [ + CodeChunk(0, 7), + CodeChunk(2, 5), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(''), + CodeLine('{'), + CodeLine('[', [ + CodeLine('abc'), + CodeLine('(foo)'), + CodeLine('bar'), + ]), + CodeLine(']'), + CodeLine('}'), + CodeLine(''), + CodeLine('}') + ])); + controller.expand(3); + expect(controller.value, const [ + CodeChunk(0, 10), + CodeChunk(2, 8), + CodeChunk(3, 7), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(''), + CodeLine('{'), + CodeLine('['), + CodeLine('abc'), + CodeLine('(foo)'), + CodeLine('bar'), + CodeLine(']'), + CodeLine('}'), + CodeLine(''), + CodeLine('}') + ])); + controller.dispose(); + } + // Have multi collapsed chunks, expand from top one by one + { + final CodeLineEditingController editingController = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}'), + ] + )); + final CodeChunkController controller = CodeChunkController(editingController, + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.value, const [ + CodeChunk(0, 1), + CodeChunk(1, 2), + CodeChunk(2, 3), + CodeChunk(3, 4), + ]); + controller.expand(0); + expect(controller.value, const [ + CodeChunk(0, 2), + CodeChunk(2, 3), + CodeChunk(3, 4), + CodeChunk(4, 5), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(''), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}'), + ])); + controller.expand(2); + expect(controller.value, const [ + CodeChunk(0, 2), + CodeChunk(2, 4), + CodeChunk(4, 5), + CodeChunk(5, 6), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}'), + ])); + controller.expand(4); + expect(controller.value, const [ + CodeChunk(0, 2), + CodeChunk(2, 4), + CodeChunk(4, 6), + CodeChunk(6, 7), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}'), + ])); + controller.expand(6); + expect(controller.value, const [ + CodeChunk(0, 2), + CodeChunk(2, 4), + CodeChunk(4, 6), + CodeChunk(6, 8), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}'), + ])); + controller.dispose(); + } + // Have multi collapsed chunks, expand from bottom one by one + { + final CodeLineEditingController editingController = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}'), + ] + )); + final CodeChunkController controller = CodeChunkController(editingController, + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.value, const [ + CodeChunk(0, 1), + CodeChunk(1, 2), + CodeChunk(2, 3), + CodeChunk(3, 4), + ]); + controller.expand(3); + expect(controller.value, const [ + CodeChunk(0, 1), + CodeChunk(1, 2), + CodeChunk(2, 3), + CodeChunk(3, 5), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}{',), + CodeLine(''), + CodeLine('}'), + ])); + controller.expand(2); + expect(controller.value, const [ + CodeChunk(0, 1), + CodeChunk(1, 2), + CodeChunk(2, 4), + CodeChunk(4, 6), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{', [ + CodeLine('') + ]), + CodeLine('}{', [ + CodeLine('') + ]), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{',), + CodeLine(''), + CodeLine('}'), + ])); + controller.expand(1); + expect(controller.value, const [ + CodeChunk(0, 1), + CodeChunk(1, 3), + CodeChunk(3, 5), + CodeChunk(5, 7), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{', [ + CodeLine('') + ]), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{',), + CodeLine(''), + CodeLine('}'), + ])); + controller.expand(0); + expect(controller.value, const [ + CodeChunk(0, 2), + CodeChunk(2, 4), + CodeChunk(4, 6), + CodeChunk(6, 8), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}'), + ])); + controller.dispose(); + } + }); + + test('collapse() and expand()', () async { + final CodeLineEditingController editingController = CodeLineEditingController.fromText('{\n\n}{\n\n}{\n\n}{\n\n}'); + final CodeChunkController controller = CodeChunkController(editingController, + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + controller.collapse(2); + expect(controller.value, const [ + CodeChunk(0, 2), + CodeChunk(2, 3), + CodeChunk(3, 5), + CodeChunk(5, 7), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(''), + CodeLine('}{', [ + CodeLine(''), + ]), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}'), + ])); + controller.collapse(3); + expect(controller.value, const [ + CodeChunk(0, 2), + CodeChunk(2, 3), + CodeChunk(3, 4), + CodeChunk(4, 6), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(''), + CodeLine('}{', [ + CodeLine(''), + ]), + CodeLine('}{', [ + CodeLine(''), + ]), + CodeLine('}{'), + CodeLine(''), + CodeLine('}'), + ])); + controller.expand(2); + expect(controller.value, const [ + CodeChunk(0, 2), + CodeChunk(2, 4), + CodeChunk(4, 5), + CodeChunk(5, 7), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{', [ + CodeLine(''), + ]), + CodeLine('}{'), + CodeLine(''), + CodeLine('}'), + ])); + controller.expand(4); + expect(controller.value, const [ + CodeChunk(0, 2), + CodeChunk(2, 4), + CodeChunk(4, 6), + CodeChunk(6, 8), + ]); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}{'), + CodeLine(''), + CodeLine('}'), + ])); + controller.dispose(); + }); + + test('findByIndex()', () async { + { + final CodeChunkController controller = CodeChunkController(CodeLineEditingController(), + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.findByIndex(0), null); + expect(controller.findByIndex(1), null); + controller.dispose(); + } + { + final CodeChunkController controller = CodeChunkController(CodeLineEditingController.fromText('{\n\n}'), + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.findByIndex(0), const CodeChunk(0, 2)); + expect(controller.findByIndex(1), null); + controller.dispose(); + } + { + final CodeChunkController controller = CodeChunkController(CodeLineEditingController.fromText('{\n{\n{\n\n}\n}\n}'), + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.findByIndex(0), const CodeChunk(0, 6)); + expect(controller.findByIndex(1), const CodeChunk(1, 5)); + expect(controller.findByIndex(2), const CodeChunk(2, 4)); + expect(controller.findByIndex(3), null); + expect(controller.findByIndex(4), null); + expect(controller.findByIndex(5), null); + controller.dispose(); + } + }); + + test('canCollapse()', () async { + { + final CodeChunkController controller = CodeChunkController(CodeLineEditingController.fromText('{\n}'), + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.canCollapse(0), false); + controller.dispose(); + } + { + final CodeChunkController controller = CodeChunkController(CodeLineEditingController.fromText('{\n\n}'), + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.canCollapse(0), true); + expect(controller.canCollapse(1), false); + controller.dispose(); + } + { + final CodeChunkController controller = CodeChunkController(CodeLineEditingController.fromText('{\n{\n{\n\n}\n}\n}'), + const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.canCollapse(0), true); + expect(controller.canCollapse(1), true); + expect(controller.canCollapse(2), true); + expect(controller.canCollapse(3), false); + controller.dispose(); + } + }); + + test('auto expand invalid collapsed chunks()', () async { + { + final CodeLineEditingController editingController = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('123'), + ]) + ); + final CodeChunkController controller = CodeChunkController(editingController, const DefaultCodeChunkAnalyzer()); + await Future.delayed(const Duration(milliseconds: 200)); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + CodeLine('123'), + ])); + // Edit the code line to create invalid chunks + editingController.codeLines = CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]) + ]); + await Future.delayed(const Duration(milliseconds: 200)); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ])); + // Edit the code line to create two invalid chunks and one valid chunk + editingController.codeLines = CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('}'), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]) + ]); + await Future.delayed(const Duration(milliseconds: 200)); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('}'), + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ])); + controller.dispose(); + } + }); + + }); + +} \ No newline at end of file diff --git a/packages/re_editor/test/code_line_editing_controller_test.dart b/packages/re_editor/test/code_line_editing_controller_test.dart new file mode 100644 index 0000000..4e56854 --- /dev/null +++ b/packages/re_editor/test/code_line_editing_controller_test.dart @@ -0,0 +1,4694 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_test/flutter_test.dart'; +import 'package:re_editor/re_editor.dart'; + +void main() { + WidgetsFlutterBinding.ensureInitialized(); + group('CodeLineEditingController constructor ', () { + test('`CodeLineEditingController()`', () { + { + final CodeLineEditingController controller = CodeLineEditingController(); + expect(controller.value, const CodeLineEditingValue.empty()); + expect(controller.options, const CodeLineOptions()); + } + { + final CodeLineEditingController controller = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]) + ); + expect(controller.value, CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]) + )); + expect(controller.options, const CodeLineOptions()); + } + { + final CodeLineEditingController controller = CodeLineEditingController( + options: const CodeLineOptions( + lineBreak: TextLineBreak.crlf, + indentSize: 4 + ) + ); + expect(controller.value, const CodeLineEditingValue.empty()); + expect(controller.options, const CodeLineOptions( + lineBreak: TextLineBreak.crlf, + indentSize: 4 + )); + } + { + final CodeLineEditingController controller = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]), + options: const CodeLineOptions( + lineBreak: TextLineBreak.crlf, + indentSize: 4 + ) + ); + expect(controller.value, CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]) + )); + expect(controller.options, const CodeLineOptions( + lineBreak: TextLineBreak.crlf, + indentSize: 4 + )); + } + }); + + test('`CodeLineEditingController.fromText()`', () { + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + expect(controller.value, const CodeLineEditingValue.empty()); + expect(controller.options, const CodeLineOptions()); + } + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar', const CodeLineOptions( + lineBreak: TextLineBreak.crlf, + indentSize: 4 + )); + expect(controller.value, CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]) + )); + expect(controller.options, const CodeLineOptions( + lineBreak: TextLineBreak.crlf, + indentSize: 4 + )); + } + }); + }); + + group('CodeLineEditingController setter & getter ', () { + test('`value`', () { + final CodeLineEditingController controller = CodeLineEditingController(); + expect(controller.value, const CodeLineEditingValue.empty()); + final CodeLineEditingValue value = CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]) + ); + controller.value = value; + expect(controller.value, value); + }); + + test('`codeLines`', () { + final CodeLineEditingController controller = CodeLineEditingController(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine.empty + ])); + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]); + controller.codeLines = codeLines; + expect(controller.codeLines, codeLines); + }); + + test('`selection`', () { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + expect(controller.selection, const CodeLineSelection.zero()); + const CodeLineSelection selection = CodeLineSelection.collapsed( + index: 0, + offset: 1 + ); + controller.selection = selection; + expect(controller.selection, selection); + }); + + test('`composing`', () { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + expect(controller.composing, TextRange.empty); + const TextRange composing = TextRange.collapsed(1); + controller.composing = composing; + expect(controller.composing, composing); + }); + + test('`baseLine`', () { + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + expect(controller.baseLine, controller.codeLines[0]); + } + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 2, + extentOffset: 0 + ); + expect(controller.baseLine, controller.codeLines[1]); + } + }); + + test('`extentLine`', () { + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + expect(controller.extentLine, controller.codeLines[0]); + } + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 2, + extentOffset: 0 + ); + expect(controller.extentLine, controller.codeLines[2]); + } + }); + + test('`startLine`', () { + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + expect(controller.startLine, controller.codeLines[0]); + } + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 2, + extentOffset: 0 + ); + expect(controller.startLine, controller.codeLines[1]); + } + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selection = const CodeLineSelection( + baseIndex: 2, + baseOffset: 0, + extentIndex: 1, + extentOffset: 0 + ); + expect(controller.startLine, controller.codeLines[1]); + } + }); + + test('`endLine`', () { + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + expect(controller.endLine, controller.codeLines[0]); + } + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 2, + extentOffset: 0 + ); + expect(controller.endLine, controller.codeLines[2]); + } + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selection = const CodeLineSelection( + baseIndex: 2, + baseOffset: 0, + extentIndex: 1, + extentOffset: 0 + ); + expect(controller.endLine, controller.codeLines[2]); + } + }); + + test('`isComposing`', () { + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + expect(controller.isComposing, false); + } + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.composing = const TextRange.collapsed(0); + expect(controller.isComposing, false); + } + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.composing = const TextRange( + start: 0, + end: 1 + ); + expect(controller.isComposing, true); + } + }); + + test('`text`', () { + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + expect(controller.text, 'abc'); + } + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + expect(controller.text, 'abc\nfoo\nbar'); + } + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar', const CodeLineOptions( + lineBreak: TextLineBreak.crlf + )); + expect(controller.text, 'abc\r\nfoo\r\nbar'); + } + }); + + test('`selectedText`', () { + // Empty + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + expect(controller.selectedText, ''); + } + // Single code line + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + expect(controller.selectedText, ''); + controller.selection = CodeLineSelection.fromRange( + range: const CodeLineRange( + index: 0, + start: 0, + end: 1 + ) + ); + expect(controller.selectedText, 'a'); + controller.selection = CodeLineSelection.fromRange( + range: const CodeLineRange( + index: 0, + start: 0, + end: 3 + ) + ); + expect(controller.selectedText, 'abc'); + } + // Multi code lines and LF linebreak + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + expect(controller.selectedText, ''); + controller.selection = CodeLineSelection.fromRange( + range: const CodeLineRange( + index: 1, + start: 0, + end: 1 + ) + ); + expect(controller.selectedText, 'f'); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 1, + extentOffset: 3 + ); + expect(controller.selectedText, 'foo'); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 3, + extentIndex: 1, + extentOffset: 0, + ); + expect(controller.selectedText, 'foo'); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 3, + ); + expect(controller.selectedText, 'abc\nfoo'); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 2, + extentOffset: 3, + ); + expect(controller.selectedText, 'abc\nfoo\nbar'); + } + // Multi code lines and CRLF linebreak + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar', const CodeLineOptions( + lineBreak: TextLineBreak.crlf + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 3, + ); + expect(controller.selectedText, 'abc\r\nfoo'); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 2, + extentOffset: 3, + ); + expect(controller.selectedText, 'abc\r\nfoo\r\nbar'); + } + }); + + + test('`unfoldLineSelection`', () { + // Empty + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + expect(controller.unfoldLineSelection, controller.selection); + } + // Single code line + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 1 + ); + expect(controller.unfoldLineSelection, controller.selection); + } + // Multi code lines + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selection = const CodeLineSelection.collapsed( + index: 1, + offset: 1 + ); + expect(controller.unfoldLineSelection, controller.selection); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 2, + extentOffset: 3, + ); + expect(controller.unfoldLineSelection, controller.selection); + } + // Collapsed code lines + { + final CodeLineEditingController controller = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + ]) + ); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 1 + ); + expect(controller.unfoldLineSelection, controller.selection); + } + // More collapsed code lines + { + final CodeLineEditingController controller = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('123'), + CodeLine('456'), + CodeLine('789'), + ]), + CodeLine('foo', [ + CodeLine('123'), + CodeLine('456'), + CodeLine('789'), + ]), + CodeLine('bar', [ + CodeLine('123'), + CodeLine('456'), + CodeLine('789'), + ]), + ]) + ); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 2, + extentOffset: 3, + ); + expect(controller.unfoldLineSelection, const CodeLineSelection( + baseIndex: 4, + baseOffset: 0, + extentIndex: 8, + extentOffset: 3, + )); + } + }); + }); + + group('CodeLineEditingController method ', () { + test('`edit()`', () { + // Starts with empty content + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + // Input a letter 'a' + controller.edit(const TextEditingValue( + text: 'a', + selection: TextSelection.collapsed( + offset: 1 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('a') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )); + expect(controller.composing, TextRange.empty); + // Replace with a letter 'b' + controller.edit(const TextEditingValue( + text: 'b', + selection: TextSelection.collapsed( + offset: 1 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('b') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )); + expect(controller.composing, TextRange.empty); + // Replace with letters 'abc' + controller.edit(const TextEditingValue( + text: 'abc', + selection: TextSelection.collapsed( + offset: 3 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + expect(controller.composing, TextRange.empty); + // Input a letter 'd' and select letter 'd' + controller.edit(const TextEditingValue( + text: 'abcd', + selection: TextSelection( + baseOffset: 3, + extentOffset: 4 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abcd') + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 3, + extentIndex: 0, + extentOffset: 4 + )); + expect(controller.composing, TextRange.empty); + // Have a composing + controller.edit(const TextEditingValue( + text: 'abca a a a a', + selection: TextSelection.collapsed( + offset: 12 + ), + composing: TextRange( + start: 3, + end: 12 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abca a a a a') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 12 + )); + expect(controller.composing, const TextRange( + start: 3, + end: 12 + )); + } + // Starts with a single line and has a selection range + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.selection = CodeLineSelection.fromRange( + range: const CodeLineRange( + index: 0, + start: 0, + end: 1 + ) + ); + // Replace selection 'a' with a letter 'c' + controller.edit(const TextEditingValue( + text: 'cbc', + selection: TextSelection.collapsed( + offset: 1 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('cbc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )); + expect(controller.composing, TextRange.empty); + // Select all + controller.selection = CodeLineSelection.fromRange( + range: const CodeLineRange( + index: 0, + start: 0, + end: 3 + ) + ); + // Replace selection 'cbc' with a letter 'a' + controller.edit(const TextEditingValue( + text: 'a', + selection: TextSelection.collapsed( + offset: 1 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('a') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )); + expect(controller.composing, TextRange.empty); + } + // Starts with multi lines + { + final CodeLineEditingController controller = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]) + ); + // Edit line index 0 + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 3 + ); + controller.edit(const TextEditingValue( + text: 'abc1', + selection: TextSelection.collapsed( + offset: 4 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc1'), + CodeLine('foo'), + CodeLine('bar'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 4 + )); + expect(controller.composing, TextRange.empty); + // Edit line index 1 + controller.selection = const CodeLineSelection.collapsed( + index: 1, + offset: 3 + ); + controller.edit(const TextEditingValue( + text: 'foo1', + selection: TextSelection.collapsed( + offset: 4 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc1'), + CodeLine('foo1'), + CodeLine('bar'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 4 + )); + expect(controller.composing, const TextRange( + start: -1, + end: -1 + )); + // Edit line index 2 + controller.selection = const CodeLineSelection.collapsed( + index: 2, + offset: 3 + ); + controller.edit(const TextEditingValue( + text: 'bar1', + selection: TextSelection.collapsed( + offset: 4 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc1'), + CodeLine('foo1'), + CodeLine('bar1'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 2, + offset: 4 + )); + expect(controller.composing, TextRange.empty); + // Edit line index 2 and select the input + controller.edit(const TextEditingValue( + text: 'bar2', + selection: TextSelection( + baseOffset: 3, + extentOffset: 4 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc1'), + CodeLine('foo1'), + CodeLine('bar2'), + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 2, + baseOffset: 3, + extentIndex: 2, + extentOffset: 4 + )); + expect(controller.composing, TextRange.empty); + // Have a composing + controller.edit(const TextEditingValue( + text: 'bara a a a a', + selection: TextSelection.collapsed( + offset: 12 + ), + composing: TextRange( + start: 3, + end: 12 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc1'), + CodeLine('foo1'), + CodeLine('bara a a a a'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 2, + offset: 12 + )); + expect(controller.composing, const TextRange( + start: 3, + end: 12 + )); + } + // Starts with multi lines and has a selection range + { + final CodeLineEditingController controller = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]) + ); + // Replace 'abc' with '1' + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 3 + ); + controller.edit(const TextEditingValue( + text: '1', + selection: TextSelection.collapsed( + offset: 1 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('1'), + CodeLine('foo'), + CodeLine('bar'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )); + expect(controller.composing, TextRange.empty); + // Replace 'foo' with '2' + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 1, + extentOffset: 3 + ); + controller.edit(const TextEditingValue( + text: '2', + selection: TextSelection.collapsed( + offset: 1 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('1'), + CodeLine('2'), + CodeLine('bar'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 1 + )); + expect(controller.composing, TextRange.empty); + // Reset codeLines + controller.codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]); + // Select two line 'abc' and 'foo' + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 3 + ); + controller.edit(const TextEditingValue( + text: 'a', + selection: TextSelection.collapsed( + offset: 1 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('a'), + CodeLine('bar'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )); + expect(controller.composing, TextRange.empty); + // Reset codeLines + controller.codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]); + // Select three line, and base before extent + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 2, + extentIndex: 2, + extentOffset: 1 + ); + // Input 'a' + controller.edit(const TextEditingValue( + text: 'ab1', + selection: TextSelection.collapsed( + offset: 3 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('ab1ar'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + expect(controller.composing, TextRange.empty); + // Reset codeLines + controller.codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]); + // Select three line, and extent before base + controller.selection = const CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ); + // Input '1' + controller.edit(const TextEditingValue( + text: '1ar', + selection: TextSelection.collapsed( + offset: 1 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('ab1ar'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + expect(controller.composing, TextRange.empty); + // Reset codeLines + controller.codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]); + // Select three line, and base before extent + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 2, + extentIndex: 2, + extentOffset: 1 + ); + // Input 'a' with a composing + controller.edit(const TextEditingValue( + text: 'aba ', + selection: TextSelection.collapsed( + offset: 4 + ), + composing: TextRange( + start: 2, + end: 4 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('aba ar'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 4 + )); + expect(controller.composing, const TextRange( + start: 2, + end: 4 + )); + // Reset codeLines + controller.codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]); + // Select three line, and extent before base + controller.selection = const CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ); + // Input 'a' + controller.edit(const TextEditingValue( + text: 'a ar', + selection: TextSelection.collapsed( + offset: 2 + ), + composing: TextRange( + start: 0, + end: 2 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('aba ar'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 4 + )); + expect(controller.composing, const TextRange( + start: 2, + end: 4 + )); + } + // Starts with multi lines and has collapsed chunks + { + final CodeLineEditingController controller = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('123'), + CodeLine('456') + ]), + CodeLine('foo'), + CodeLine('bar'), + ]) + ); + // Replace 'abc' with '1' + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 3 + ); + controller.edit(const TextEditingValue( + text: '1', + selection: TextSelection.collapsed( + offset: 1 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('1', [ + CodeLine('123'), + CodeLine('456') + ]), + CodeLine('foo'), + CodeLine('bar'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )); + expect(controller.composing, TextRange.empty); + // Replace 'foo' with '2' + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 1, + extentOffset: 3 + ); + controller.edit(const TextEditingValue( + text: '2', + selection: TextSelection.collapsed( + offset: 1 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('1', [ + CodeLine('123'), + CodeLine('456') + ]), + CodeLine('2'), + CodeLine('bar'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 1 + )); + expect(controller.composing, TextRange.empty); + // Select line '1' and '2' and replace with '3' + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 1 + ); + controller.edit(const TextEditingValue( + text: '3', + selection: TextSelection.collapsed( + offset: 1 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('3'), + CodeLine('bar'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )); + expect(controller.composing, TextRange.empty); + // Reset code lines + controller.value = CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('123'), + CodeLine('456') + ]), + CodeLine('foo'), + CodeLine('bar'), + ]) + ); + // Select three line, and base before extent + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 2, + extentIndex: 2, + extentOffset: 1 + ); + controller.edit(const TextEditingValue( + text: 'ab1', + selection: TextSelection.collapsed( + offset: 3 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('ab1ar'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + expect(controller.composing, TextRange.empty); + // Reset code lines + controller.value = CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('123'), + CodeLine('456') + ]), + CodeLine('foo'), + CodeLine('bar'), + ]) + ); + // Select three line, and extent before base + controller.selection = const CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ); + controller.edit(const TextEditingValue( + text: '1ar', + selection: TextSelection.collapsed( + offset: 1 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('ab1ar'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + expect(controller.composing, TextRange.empty); + // Test more chunks + controller.value = CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('123'), + CodeLine('123') + ]), + CodeLine('foo', [ + CodeLine('456'), + CodeLine('456') + ]), + CodeLine('bar', [ + CodeLine('789'), + CodeLine('789') + ]), + ]) + ); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 2, + extentIndex: 1, + extentOffset: 1 + ); + controller.edit(const TextEditingValue( + text: 'ab1', + selection: TextSelection.collapsed( + offset: 3 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('ab1oo', [ + CodeLine('456'), + CodeLine('456') + ]), + CodeLine('bar', [ + CodeLine('789'), + CodeLine('789') + ]), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + expect(controller.composing, TextRange.empty); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 0, + extentOffset: 1 + ); + controller.edit(const TextEditingValue( + text: '2ar', + selection: TextSelection.collapsed( + offset: 1 + ) + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('a2ar', [ + CodeLine('789'), + CodeLine('789') + ]), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2 + )); + expect(controller.composing, TextRange.empty); + } + }); + + test('`selectLine()`', () { + // Single code line + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.selectLine(0); + expect(controller.selection, CodeLineSelection.fromRange( + range: const CodeLineRange( + index: 0, + start: 0, + end: 3 + ) + )); + } + // Multi code lines + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selectLine(0); + expect(controller.selection, CodeLineSelection.fromRange( + range: const CodeLineRange( + index: 0, + start: 0, + end: 3 + ) + )); + controller.selectLine(1); + expect(controller.selection, CodeLineSelection.fromRange( + range: const CodeLineRange( + index: 1, + start: 0, + end: 3 + ) + )); + controller.selectLine(2); + expect(controller.selection, CodeLineSelection.fromRange( + range: const CodeLineRange( + index: 2, + start: 0, + end: 3 + ) + )); + } + // Out of range + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selectLine(-1); + expect(controller.selection, const CodeLineSelection.zero()); + controller.selectLine(3); + expect(controller.selection, const CodeLineSelection.zero()); + } + }); + + test('`selectLines()`', () { + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selectLines(0, 1); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 3 + )); + controller.selectLines(1, 0); + expect(controller.selection, const CodeLineSelection( + baseIndex: 1, + baseOffset: 3, + extentIndex: 0, + extentOffset: 0 + )); + // Out of range + controller.selectLines(0, 3); + expect(controller.selection, const CodeLineSelection( + baseIndex: 1, + baseOffset: 3, + extentIndex: 0, + extentOffset: 0 + )); + } + }); + + test('`selectAll()`', () { + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + controller.selectAll(); + expect(controller.selection, const CodeLineSelection.zero()); + } + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.selectAll(); + expect(controller.selection, CodeLineSelection.fromRange( + range: const CodeLineRange( + index: 0, + start: 0, + end: 3 + ) + )); + } + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selectAll(); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 2, + extentOffset: 3 + )); + } + }); + + test('`cancelSelection()`', () { + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + controller.cancelSelection(); + expect(controller.selection, const CodeLineSelection.zero()); + } + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.selectAll(); + controller.cancelSelection(); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3, + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ); + controller.cancelSelection(); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2, + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 2, + extentIndex: 0, + extentOffset: 1 + ); + controller.cancelSelection(); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1, + )); + } + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selectAll(); + controller.cancelSelection(); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 2, + offset: 3, + )); + } + }); + + test('`moveSelectionLinesUp()`', () { + // Empty content + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + controller.moveSelectionLinesUp(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine.empty + ])); + } + // Single code line + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.moveSelectionLinesUp(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc') + ])); + } + // Multi code lines + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selection = const CodeLineSelection.collapsed( + index: 1, + offset: 0 + ); + controller.moveSelectionLinesUp(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('foo'), + CodeLine('abc'), + CodeLine('bar'), + ])); + controller.selection = const CodeLineSelection.collapsed( + index: 2, + offset: 0 + ); + controller.moveSelectionLinesUp(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('foo'), + CodeLine('bar'), + CodeLine('abc'), + ])); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 2, + extentOffset: 1 + ); + controller.moveSelectionLinesUp(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('bar'), + CodeLine('abc'), + CodeLine('foo'), + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 1, + extentOffset: 1 + )); + controller.selection = const CodeLineSelection( + baseIndex: 2, + baseOffset: 2, + extentIndex: 1, + extentOffset: 1 + ); + controller.moveSelectionLinesUp(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 1, + baseOffset: 2, + extentIndex: 0, + extentOffset: 1 + )); + } + }); + + test('`moveSelectionLinesDown()`', () { + // Empty content + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + controller.moveSelectionLinesDown(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine.empty + ])); + } + // Single code line + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.moveSelectionLinesDown(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc') + ])); + } + // Multi code lines + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.moveSelectionLinesDown(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('foo'), + CodeLine('abc'), + CodeLine('bar'), + ])); + controller.selection = const CodeLineSelection.collapsed( + index: 2, + offset: 0 + ); + controller.moveSelectionLinesDown(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('foo'), + CodeLine('abc'), + CodeLine('bar'), + ])); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 1, + extentOffset: 1 + ); + controller.moveSelectionLinesDown(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('bar'), + CodeLine('foo'), + CodeLine('abc'), + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 2, + extentOffset: 1 + )); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 2, + extentIndex: 0, + extentOffset: 1 + ); + controller.moveSelectionLinesDown(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine('bar'), + CodeLine('foo'), + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 2, + baseOffset: 2, + extentIndex: 1, + extentOffset: 1 + )); + } + }); + + test('`moveCursor(left)`', () { + // Empty content + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + controller.moveCursor(AxisDirection.left); + expect(controller.selection, const CodeLineSelection.zero()); + } + // Single code line + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 1 + ); + controller.moveCursor(AxisDirection.left); + expect(controller.selection, const CodeLineSelection.zero()); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 2 + ); + controller.moveCursor(AxisDirection.left); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1, + affinity: TextAffinity.downstream + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ); + controller.moveCursor(AxisDirection.left); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1, + affinity: TextAffinity.downstream + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 2, + extentIndex: 0, + extentOffset: 1 + ); + controller.moveCursor(AxisDirection.left); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1, + affinity: TextAffinity.downstream + )); + } + // Multi code lines + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\bar'); + controller.selection = const CodeLineSelection.collapsed( + index: 1, + offset: 1 + ); + controller.moveCursor(AxisDirection.left); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 0, + affinity: TextAffinity.downstream + )); + controller.moveCursor(AxisDirection.left); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3, + affinity: TextAffinity.downstream + )); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ); + controller.moveCursor(AxisDirection.left); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 1, + affinity: TextAffinity.downstream + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 2, + extentIndex: 1, + extentOffset: 1 + ); + controller.moveCursor(AxisDirection.left); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2, + affinity: TextAffinity.downstream + )); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ); + controller.moveCursor(AxisDirection.left); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2, + affinity: TextAffinity.downstream + )); + } + // Affinity change + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 2, + affinity: TextAffinity.upstream + ); + controller.moveCursor(AxisDirection.left); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1, + affinity: TextAffinity.downstream + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 2, + baseAffinity: TextAffinity.downstream, + extentIndex: 0, + extentOffset: 2, + extentAffinity: TextAffinity.upstream, + ); + controller.moveCursor(AxisDirection.left); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2, + affinity: TextAffinity.upstream + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 2, + baseAffinity: TextAffinity.upstream, + extentIndex: 0, + extentOffset: 2, + extentAffinity: TextAffinity.downstream, + ); + controller.moveCursor(AxisDirection.left); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2, + affinity: TextAffinity.upstream + )); + } + + }); + + test('`moveCursor(right)`', () { + // Empty content + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + controller.moveCursor(AxisDirection.right); + expect(controller.selection, const CodeLineSelection.zero()); + } + // Single code line + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 0 + ); + controller.moveCursor(AxisDirection.right); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1, + affinity: TextAffinity.upstream + )); + controller.moveCursor(AxisDirection.right); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2, + affinity: TextAffinity.upstream + )); + controller.moveCursor(AxisDirection.right); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3, + affinity: TextAffinity.upstream + )); + controller.moveCursor(AxisDirection.right); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3, + affinity: TextAffinity.upstream + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ); + controller.moveCursor(AxisDirection.right); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2, + affinity: TextAffinity.downstream + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 2, + extentIndex: 0, + extentOffset: 1 + ); + controller.moveCursor(AxisDirection.right); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2, + affinity: TextAffinity.downstream + )); + } + // Multi code lines + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nar'); + controller.selection = const CodeLineSelection.collapsed( + index: 1, + offset: 1 + ); + controller.moveCursor(AxisDirection.right); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 2, + affinity: TextAffinity.upstream + )); + controller.moveCursor(AxisDirection.right); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 3, + affinity: TextAffinity.upstream + )); + controller.moveCursor(AxisDirection.right); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 2, + offset: 0, + affinity: TextAffinity.upstream + )); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ); + controller.moveCursor(AxisDirection.right); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 2, + affinity: TextAffinity.downstream + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 2, + extentIndex: 1, + extentOffset: 1 + ); + controller.moveCursor(AxisDirection.right); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 1, + affinity: TextAffinity.downstream + )); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ); + controller.moveCursor(AxisDirection.right); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 1, + affinity: TextAffinity.downstream + )); + } + // Affinity change + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 2, + affinity: TextAffinity.downstream + ); + controller.moveCursor(AxisDirection.right); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3, + affinity: TextAffinity.upstream + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 2, + baseAffinity: TextAffinity.downstream, + extentIndex: 0, + extentOffset: 2, + extentAffinity: TextAffinity.upstream, + ); + controller.moveCursor(AxisDirection.right); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2, + affinity: TextAffinity.downstream + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 2, + baseAffinity: TextAffinity.upstream, + extentIndex: 0, + extentOffset: 2, + extentAffinity: TextAffinity.downstream, + ); + controller.moveCursor(AxisDirection.right); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2, + affinity: TextAffinity.downstream + )); + } + }); + + test('`moveCursor(up)`', () { + // Empty content + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + controller.moveCursor(AxisDirection.up); + expect(controller.selection, const CodeLineSelection.zero()); + } + // Single code line + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 1 + ); + controller.moveCursor(AxisDirection.up); + expect(controller.selection, const CodeLineSelection.zero()); + } + // Multi code lines + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoofoo\nbar'); + controller.selection = const CodeLineSelection.collapsed( + index: 1, + offset: 1 + ); + controller.moveCursor(AxisDirection.up); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )); + controller.moveCursor(AxisDirection.up); + expect(controller.selection, const CodeLineSelection.zero()); + controller.selection = const CodeLineSelection.collapsed( + index: 1, + offset: 6 + ); + controller.moveCursor(AxisDirection.up); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ); + controller.moveCursor(AxisDirection.up); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )); + controller.selection = const CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 1, + extentOffset: 1 + ); + controller.moveCursor(AxisDirection.up); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 1, + extentOffset: 1 + ); + controller.moveCursor(AxisDirection.up); + expect(controller.selection, const CodeLineSelection.zero()); + } + }); + + test('`moveCursor(down)`', () { + // Empty content + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + controller.moveCursor(AxisDirection.down); + expect(controller.selection, const CodeLineSelection.zero()); + } + // Single code line + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 1 + ); + controller.moveCursor(AxisDirection.down); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + } + // Multi code lines + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoofoo\nbar'); + controller.selection = const CodeLineSelection.collapsed( + index: 1, + offset: 2 + ); + controller.moveCursor(AxisDirection.down); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 2, + offset: 2 + )); + controller.moveCursor(AxisDirection.down); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 2, + offset: 3 + )); + controller.selection = const CodeLineSelection.collapsed( + index: 1, + offset: 6 + ); + controller.moveCursor(AxisDirection.down); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 2, + offset: 3 + )); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ); + controller.moveCursor(AxisDirection.down); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 2, + offset: 2 + )); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 2, + extentIndex: 1, + extentOffset: 1 + ); + controller.moveCursor(AxisDirection.down); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 2, + offset: 2 + )); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 2, + extentIndex: 2, + extentOffset: 1 + ); + controller.moveCursor(AxisDirection.down); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 2, + offset: 3 + )); + } + }); + + test('`moveCursorToLineStart() & moveCursorToLineEnd() & moveCursorToPageStart() & moveCursorToPageEnd()`', () { + // Empty content + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + controller.moveCursorToLineStart(); + expect(controller.selection, const CodeLineSelection.zero()); + controller.moveCursorToLineEnd(); + expect(controller.selection, const CodeLineSelection.zero()); + controller.moveCursorToPageStart(); + expect(controller.selection, const CodeLineSelection.zero()); + controller.moveCursorToPageEnd(); + expect(controller.selection, const CodeLineSelection.zero()); + } + // Single code line + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.moveCursorToLineEnd(); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + controller.moveCursorToLineStart(); + expect(controller.selection, const CodeLineSelection.zero()); + controller.moveCursorToPageEnd(); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + controller.moveCursorToPageStart(); + expect(controller.selection, const CodeLineSelection.zero()); + } + // Multi code lines + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selection = const CodeLineSelection.collapsed( + index: 1, + offset: 1 + ); + controller.moveCursorToLineEnd(); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 3 + )); + controller.moveCursorToLineStart(); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 0 + )); + controller.moveCursorToPageEnd(); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 2, + offset: 3 + )); + controller.moveCursorToPageStart(); + expect(controller.selection, const CodeLineSelection.zero()); + } + }); + + test('`deleteSelectionLines()`', () { + // Empty content + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + controller.deleteSelectionLines(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine.empty + ])); + } + // Single code line + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.deleteSelectionLines(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine.empty + ])); + } + // Multi code lines + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.deleteSelectionLines(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('foo'), + CodeLine('bar'), + ])); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 0 + ); + controller.deleteSelectionLines(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine.empty + ])); + controller.deleteSelectionLines(); + } + // Multi code lines, keep extent offset + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 1 + ); + controller.deleteSelectionLines(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('foo'), + CodeLine('bar'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )); + } + // Multi code lines, failed to keep extent offset + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo123\nbar'); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 6 + ); + controller.deleteSelectionLines(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('bar'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + } + }); + + test('`deleteSelection()`', () { + // Empty content + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + controller.deleteSelection(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine.empty + ])); + } + // Single code line + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.deleteSelection(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc') + ])); + expect(controller.selection, const CodeLineSelection.zero()); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ); + controller.deleteSelection(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('ac') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )); + } + // Multi code lines + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ); + controller.deleteSelection(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine('fo'), + CodeLine('bar') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 1 + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 1, + extentOffset: 1 + ); + controller.deleteSelection(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('ao'), + CodeLine('bar') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )); + controller.selectAll(); + controller.deleteSelection(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine.empty + ])); + expect(controller.selection, const CodeLineSelection.zero()); + } + // Multi code lines (have chunks) + { + final CodeLineEditingController controller = CodeLineEditingController(); + controller.codeLines = CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('123') + ]), + CodeLine('foo', [ + CodeLine('456') + ]), + CodeLine('bar', [ + CodeLine('789') + ]) + ]); + controller.deleteSelection(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('123') + ]), + CodeLine('foo', [ + CodeLine('456') + ]), + CodeLine('bar', [ + CodeLine('789') + ]) + ])); + expect(controller.selection, const CodeLineSelection.zero()); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ); + controller.deleteSelection(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('ac', [ + CodeLine('123') + ]), + CodeLine('foo', [ + CodeLine('456') + ]), + CodeLine('bar', [ + CodeLine('789') + ]) + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 2, + extentOffset: 1 + ); + controller.deleteSelection(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('ac', [ + CodeLine('123') + ]), + CodeLine('far', [ + CodeLine('789') + ]) + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 1 + )); + } + }); + + test('`deleteBackward()`', () { + // Empty content + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + controller.deleteBackward(); + } + // Single code line + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 3 + ); + controller.deleteBackward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('ab') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2 + )); + controller.deleteBackward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('a') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )); + controller.deleteBackward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine.empty + ])); + expect(controller.selection, const CodeLineSelection.zero()); + controller.deleteBackward(); + // Rest code lines + controller.codeLines = CodeLines.of(const [ + CodeLine('abc{}') + ]); + // Delete the {} at same time + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 4 + ); + controller.deleteBackward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + // Rest code lines + controller.codeLines = CodeLines.of([ + CodeLine('${controller.options.indent}${controller.options.indent}abc') + ]); + // Delete an indent + controller.selection = CodeLineSelection.collapsed( + index: 0, + offset: controller.options.indentSize + ); + controller.deleteBackward(); + expect(controller.codeLines, CodeLines.of([ + CodeLine('${controller.options.indent}abc') + ])); + expect(controller.selection, const CodeLineSelection.zero()); + } + // Multi code lines + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selection = const CodeLineSelection.collapsed( + index: 1, + offset: 0 + ); + controller.deleteBackward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abcfoo'), + CodeLine('bar') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + } + // Multi code lines (have chunks) + { + final CodeLineEditingController controller = CodeLineEditingController(); + controller.codeLines = CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('123') + ]), + CodeLine('foo', [ + CodeLine('456') + ]), + CodeLine('bar', [ + CodeLine('789') + ]) + ]); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 3 + ); + controller.deleteBackward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('ab', [ + CodeLine('123') + ]), + CodeLine('foo', [ + CodeLine('456') + ]), + CodeLine('bar', [ + CodeLine('789') + ]) + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2 + )); + controller.selection = const CodeLineSelection.collapsed( + index: 1, + offset: 0 + ); + controller.deleteBackward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('ab'), + CodeLine('123foo', [ + CodeLine('456') + ]), + CodeLine('bar', [ + CodeLine('789') + ]) + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 3 + )); + } + // Multi code lines (have nested chunks) + { + final CodeLineEditingController controller = CodeLineEditingController(); + controller.codeLines = CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('{', [ + CodeLine('123') + ]), + CodeLine('}') + ]), + CodeLine('foo', [ + CodeLine('{', [ + CodeLine('456') + ]), + CodeLine('}') + ]), + CodeLine('bar', [ + CodeLine('{', [ + CodeLine('789') + ]), + CodeLine('}') + ]) + ]); + controller.selection = const CodeLineSelection.collapsed( + index: 1, + offset: 0 + ); + controller.deleteBackward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine('{', [ + CodeLine('123') + ]), + CodeLine('}foo', [ + CodeLine('{', [ + CodeLine('456') + ]), + CodeLine('}') + ]), + CodeLine('bar', [ + CodeLine('{', [ + CodeLine('789') + ]), + CodeLine('}') + ]) + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 2, + offset: 1 + )); + controller.deleteBackward(); + controller.deleteBackward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine('{'), + CodeLine('123foo', [ + CodeLine('{', [ + CodeLine('456') + ]), + CodeLine('}') + ]), + CodeLine('bar', [ + CodeLine('{', [ + CodeLine('789') + ]), + CodeLine('}') + ]) + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 2, + offset: 3 + )); + } + }); + + test('`deleteForward()`', () { + // Empty content + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + controller.deleteForward(); + } + // Single code line + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 3 + ); + controller.deleteForward(); + controller.selection = const CodeLineSelection.zero(); + controller.deleteForward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('bc') + ])); + expect(controller.selection, const CodeLineSelection.zero()); + controller.deleteForward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('c') + ])); + expect(controller.selection, const CodeLineSelection.zero()); + controller.deleteForward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine.empty + ])); + expect(controller.selection, const CodeLineSelection.zero()); + controller.deleteForward(); + // Rest code lines + controller.codeLines = CodeLines.of(const [ + CodeLine('abc{}') + ]); + // Delete the {} at same time + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 4 + ); + controller.deleteForward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + // Rest code lines + controller.codeLines = CodeLines.of([ + CodeLine('${controller.options.indent}${controller.options.indent}abc') + ]); + // Delete an indent + controller.selection = CodeLineSelection.collapsed( + index: 0, + offset: controller.options.indentSize + ); + controller.deleteForward(); + expect(controller.codeLines, CodeLines.of([ + CodeLine('${controller.options.indent}abc') + ])); + expect(controller.selection, CodeLineSelection.collapsed( + index: 0, + offset: controller.options.indentSize + )); + } + // Multi code lines + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 3 + ); + controller.deleteForward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abcfoo'), + CodeLine('bar') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + controller.selection = const CodeLineSelection.collapsed( + index: 1, + offset: 0 + ); + controller.deleteForward(); + controller.deleteForward(); + controller.deleteForward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abcfoo'), + CodeLine.empty + ])); + controller.deleteForward(); + } + // Multi code lines (have chunks) + { + final CodeLineEditingController controller = CodeLineEditingController(); + controller.codeLines = CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('123') + ]), + CodeLine('foo', [ + CodeLine('456') + ]), + CodeLine('bar', [ + CodeLine('789') + ]) + ]); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 2 + ); + controller.deleteForward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('ab', [ + CodeLine('123') + ]), + CodeLine('foo', [ + CodeLine('456') + ]), + CodeLine('bar', [ + CodeLine('789') + ]) + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2 + )); + controller.deleteForward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('ab123'), + CodeLine('foo', [ + CodeLine('456') + ]), + CodeLine('bar', [ + CodeLine('789') + ]) + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2 + )); + } + // Multi code lines (have nested chunks) + { + final CodeLineEditingController controller = CodeLineEditingController(); + controller.codeLines = CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('{', [ + CodeLine('123') + ]), + CodeLine('}') + ]), + CodeLine('foo', [ + CodeLine('{', [ + CodeLine('456') + ]), + CodeLine('}') + ]), + CodeLine('bar', [ + CodeLine('{', [ + CodeLine('789') + ]), + CodeLine('}') + ]) + ]); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 3 + ); + controller.deleteForward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc{', [ + CodeLine('123') + ]), + CodeLine('}'), + CodeLine('foo', [ + CodeLine('{', [ + CodeLine('456') + ]), + CodeLine('}') + ]), + CodeLine('bar', [ + CodeLine('{', [ + CodeLine('789') + ]), + CodeLine('}') + ]) + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + controller.deleteForward(); + controller.deleteForward(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc123'), + CodeLine('}'), + CodeLine('foo', [ + CodeLine('{', [ + CodeLine('456') + ]), + CodeLine('}') + ]), + CodeLine('bar', [ + CodeLine('{', [ + CodeLine('789') + ]), + CodeLine('}') + ]) + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + } + }); + + test('`applyNewLine()`', () { + // Empty content + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + controller.applyNewLine(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine.empty, + CodeLine.empty + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 0 + )); + controller.applyNewLine(); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 2, + offset: 0 + )); + } + // Single code line, cursor at begin + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.applyNewLine(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine.empty, + CodeLine('abc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 0 + )); + } + // Single code line, cursor at end + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 3 + ); + controller.applyNewLine(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine.empty, + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 0 + )); + } + // Single code line, has a selection + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ); + controller.applyNewLine(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('a'), + CodeLine('c'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 0 + )); + } + // Single code line, all have selected + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.selectAll(); + controller.applyNewLine(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine.empty, + CodeLine.empty, + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 0 + )); + } + // Multi code lines, select lines 0 - 1 + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 2, + extentIndex: 1, + extentOffset: 2 + ); + controller.applyNewLine(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('ab'), + CodeLine('o'), + CodeLine('bar'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 0 + )); + } + // Multi code lines, have a chunk + { + final CodeLineEditingController controller = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}') + ]) + ); + controller.applyNewLine(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine.empty, + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 0 + )); + } + // Multi code lines, have a few of chunks + { + final CodeLineEditingController controller = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}'), + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}'), + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}') + ]) + ); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 4, + extentOffset: 1 + ); + controller.applyNewLine(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine('', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('}') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 0 + )); + } + // Test auto indent + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(' abc'); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 5 + ); + controller.applyNewLine(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine(' abc'), + CodeLine(' ') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 2 + )); + } + // Test auto indent in closure + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('{}'); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 1 + ); + controller.applyNewLine(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(' '), + CodeLine('}') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 2 + )); + } + // Test auto indent size in closure + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('{}', + const CodeLineOptions( + indentSize: 6 + ) + ); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 1 + ); + controller.applyNewLine(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('{'), + CodeLine(' '), + CodeLine('}') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 6 + )); + } + // Test indent align + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(' {}'); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 3 + ); + controller.applyNewLine(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine(' {'), + CodeLine(' '), + CodeLine(' }') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 4 + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 3, + extentIndex: 2, + extentOffset: 2 + ); + controller.applyNewLine(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine(' {'), + CodeLine(' '), + CodeLine(' }') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 4 + )); + } + }); + + test('`applyIndent()`', () { + // Empty content + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of([ + CodeLine(controller.options.indent) + ])); + expect(controller.selection, CodeLineSelection.collapsed( + index: 0, + offset: controller.options.indentSize + )); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of([ + CodeLine(controller.options.indent * 2) + ])); + expect(controller.selection, CodeLineSelection.collapsed( + index: 0, + offset: controller.options.indentSize * 2 + )); + } + // Single code line + { + // Assign indent size is 2 + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc', + const CodeLineOptions( + indentSize: 2 + ) + ); + // cursor at begin + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of([ + const CodeLine(' abc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2 + )); + // cursor at end + controller.selection = CodeLineSelection.collapsed( + index: 0, + offset: controller.codeLines.first.length + ); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of([ + const CodeLine(' abc ') + ])); + expect(controller.selection, CodeLineSelection.collapsed( + index: 0, + offset: controller.codeLines.first.length + )); + // cursor at mid (after 'a') + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 3 + ); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of([ + const CodeLine(' a bc ') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 4 + )); + // Reset code lines, and select 'a' + controller.codeLines = CodeLines.of(const [ + CodeLine('abc') + ]); + controller.selection = CodeLineSelection.fromRange( + range: const CodeLineRange( + index: 0, + start: 0, + end: 1 + ) + ); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of([ + const CodeLine(' bc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2 + )); + // Reset code lines, and select 'b' + controller.codeLines = CodeLines.of(const [ + CodeLine('abc') + ]); + controller.selection = CodeLineSelection.fromRange( + range: const CodeLineRange( + index: 0, + start: 1, + end: 2 + ) + ); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of([ + const CodeLine('a c') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2 + )); + // Reset code lines, and select 'c' + controller.codeLines = CodeLines.of(const [ + CodeLine('abc') + ]); + controller.selection = CodeLineSelection.fromRange( + range: const CodeLineRange( + index: 0, + start: 2, + end: 3 + ) + ); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of([ + const CodeLine('ab ') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 4 + )); + // Reset code lines, and select all + controller.codeLines = CodeLines.of(const [ + CodeLine('abc') + ]); + controller.selectAll(); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine(' abc') + ])); + expect(controller.selection, CodeLineSelection.fromRange( + range: const CodeLineRange( + index: 0, + start: 0, + end: 5 + ) + )); + // Reset code lines, with a whitespace as prefix and selection offset is at 0 + controller.codeLines = CodeLines.of(const [ + CodeLine(' abc') + ]); + controller.selection = const CodeLineSelection.zero(); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of([ + const CodeLine(' abc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2, + )); + // Reset code lines, with a whitespace as prefix and selection offset is at 1 + controller.codeLines = CodeLines.of(const [ + CodeLine(' abc') + ]); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 1 + ); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of([ + const CodeLine(' abc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2, + )); + // Reset code lines, with a whitespace as prefix and selected + controller.codeLines = CodeLines.of(const [ + CodeLine(' abc') + ]); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1 + ); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of([ + const CodeLine(' abc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2, + )); + // Reset code lines, with a whitespace as prefix and select all + controller.codeLines = CodeLines.of(const [ + CodeLine(' abc') + ]); + controller.selectAll(); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of([ + const CodeLine(' abc') + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 5 + )); + } + // Multi code lines + { + // Assign indent size is 2 + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar', + const CodeLineOptions( + indentSize: 2 + ) + ); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine(' abc'), + CodeLine('foo'), + CodeLine('bar'), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2 + )); + // select line 1-2 (all letters) + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 2, + extentOffset: 3 + ); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine(' abc'), + CodeLine(' foo'), + CodeLine(' bar'), + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 2, + extentOffset: 5 + )); + // Reset code lines + controller.codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]); + // select line 1-2 (not all letters), base before extent + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine(' foo'), + CodeLine(' bar'), + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 1, + baseOffset: 3, + extentIndex: 2, + extentOffset: 4 + )); + // Reset code lines + controller.codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]); + // select line 1-2 (not all letters), base after extent + controller.selection = const CodeLineSelection( + baseIndex: 2, + baseOffset: 2, + extentIndex: 1, + extentOffset: 1 + ); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine(' foo'), + CodeLine(' bar'), + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 2, + baseOffset: 4, + extentIndex: 1, + extentOffset: 3 + )); + // Reset code lines + controller.codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]); + // select line 1-2 (not all letters), the offset of line 2 is at 0 position + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 2, + extentOffset: 0 + ); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine(' foo'), + CodeLine('bar'), + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 1, + baseOffset: 3, + extentIndex: 2, + extentOffset: 0 + )); + // Reset code lines, add one whitespace at begin + controller.codeLines = CodeLines.of(const [ + CodeLine(' abc'), + CodeLine(' foo'), + CodeLine(' bar'), + ]); + // select three lines and offset both at 1 + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 2, + extentOffset: 1 + ); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine(' abc'), + CodeLine(' foo'), + CodeLine(' bar'), + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 2, + extentOffset: 1 + )); + // Reset code lines, add three whitespace at begin + controller.codeLines = CodeLines.of(const [ + CodeLine(' abc'), + CodeLine(' foo'), + CodeLine(' bar'), + ]); + // select three lines and offset both at 1 + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 2, + extentOffset: 1 + ); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine(' abc'), + CodeLine(' foo'), + CodeLine(' bar'), + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 2, + extentOffset: 1 + )); + } + // Multi code lines, have a chunk. + { + final CodeLineEditingController controller = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}') + ]), + options: const CodeLineOptions( + indentSize: 2 + ) + ); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine(' {', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2 + )); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 3 + ); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine(' { ', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 4 + )); + // Reset code lines and select all + controller.codeLines = CodeLines.of(const [ + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}') + ]); + controller.selectAll(); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine(' {', [ + CodeLine(' foo'), + CodeLine(' bar') + ]), + CodeLine(' }') + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 3 + )); + } + // Multi code lines, have a few of chunks + { + final CodeLineEditingController controller = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}'), + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}'), + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}') + ]) + ); + controller.selectAll(); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of([ + CodeLine('${controller.options.indent}{', [ + CodeLine('${controller.options.indent}foo'), + CodeLine('${controller.options.indent}bar') + ]), + CodeLine('${controller.options.indent}}'), + CodeLine('${controller.options.indent}{', [ + CodeLine('${controller.options.indent}foo'), + CodeLine('${controller.options.indent}bar') + ]), + CodeLine('${controller.options.indent}}'), + CodeLine('${controller.options.indent}{', [ + CodeLine('${controller.options.indent}foo'), + CodeLine('${controller.options.indent}bar') + ]), + CodeLine('${controller.options.indent}}') + ])); + expect(controller.selection, CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 5, + extentOffset: controller.options.indentSize + 1 + )); + // Reset code lines + controller.codeLines = CodeLines.of(const [ + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}'), + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}'), + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}') + ]); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 4, + extentOffset: 1, + ); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of([ + CodeLine('${controller.options.indent}{', [ + CodeLine('${controller.options.indent}foo'), + CodeLine('${controller.options.indent}bar') + ]), + CodeLine('${controller.options.indent}}'), + CodeLine('${controller.options.indent}{', [ + CodeLine('${controller.options.indent}foo'), + CodeLine('${controller.options.indent}bar') + ]), + CodeLine('${controller.options.indent}}'), + CodeLine('${controller.options.indent}{', [ + const CodeLine('foo'), + const CodeLine('bar') + ]), + const CodeLine('}') + ])); + expect(controller.selection, CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 4, + extentOffset: controller.options.indentSize + 1 + )); + } + // Multi code lines, have nested chunks + { + final CodeLineEditingController controller = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar', [ + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}') + ]) + ]), + CodeLine('}'), + ]) + ); + controller.selectAll(); + controller.applyIndent(); + expect(controller.codeLines, CodeLines.of([ + CodeLine('${controller.options.indent}{', [ + CodeLine('${controller.options.indent}foo'), + CodeLine('${controller.options.indent}bar', [ + CodeLine('${controller.options.indent}{', [ + CodeLine('${controller.options.indent}foo'), + CodeLine('${controller.options.indent}bar') + ]), + CodeLine('${controller.options.indent}}') + ]) + ]), + CodeLine('${controller.options.indent}}'), + ])); + expect(controller.selection, CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: controller.options.indentSize + 1 + )); + } + }); + + test('`applyOutdent()`', () { + // Empty content + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine.empty + ])); + expect(controller.selection, const CodeLineSelection.zero()); + } + // Single code line + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc') + ])); + expect(controller.selection, const CodeLineSelection.zero()); + // have one whitespace + controller.codeLines = CodeLines.of(const [ + CodeLine(' abc') + ]); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc') + ])); + expect(controller.selection, const CodeLineSelection.zero()); + // have one whitespace + one indent + controller.codeLines = CodeLines.of([ + CodeLine(' ${controller.options.indent}abc') + ]); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of([ + CodeLine('${controller.options.indent}abc') + ])); + expect(controller.selection, const CodeLineSelection.zero()); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc') + ])); + expect(controller.selection, const CodeLineSelection.zero()); + // have one whitespace + one indent and selection position is after 'a' + controller.codeLines = CodeLines.of([ + CodeLine(' ${controller.options.indent}abc') + ]); + controller.selection = CodeLineSelection.collapsed( + index: 0, + offset: 2 + controller.options.indentSize + ); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of([ + CodeLine('${controller.options.indent}abc') + ])); + expect(controller.selection, CodeLineSelection.collapsed( + index: 0, + offset: 1 + controller.options.indentSize + )); + // have two indent and selection position is in the mid of intents + controller.codeLines = CodeLines.of([ + CodeLine('${controller.options.indent}${controller.options.indent}abc') + ]); + controller.selection = CodeLineSelection.collapsed( + index: 0, + offset: controller.options.indentSize + ); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of([ + CodeLine('${controller.options.indent}abc') + ])); + expect(controller.selection, CodeLineSelection.collapsed( + index: 0, + offset: controller.options.indentSize + )); + // have two indent and have selected the first + controller.codeLines = CodeLines.of([ + CodeLine('${controller.options.indent}${controller.options.indent}abc') + ]); + controller.selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: controller.options.indentSize + ); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of([ + CodeLine('${controller.options.indent}abc') + ])); + expect(controller.selection, CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: controller.options.indentSize + )); + // have two indent and have selected the second + controller.codeLines = CodeLines.of([ + CodeLine('${controller.options.indent}${controller.options.indent}abc') + ]); + controller.selection = CodeLineSelection( + baseIndex: 0, + baseOffset: controller.options.indentSize, + extentIndex: 0, + extentOffset: controller.options.indentSize * 2 + ); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of([ + CodeLine('${controller.options.indent}abc') + ])); + expect(controller.selection, CodeLineSelection.collapsed( + index: 0, + offset: controller.options.indentSize + )); + // have three whitespace and have selected the first (one indent = two whitespace) + controller.codeLines = CodeLines.of(const [ + CodeLine(' abc') + ]); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1 + ); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine(' abc') + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1 + )); + // have three whitespace and have selected the second (one indent = two whitespace) + controller.codeLines = CodeLines.of(const [ + CodeLine(' abc') + ]); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine(' abc') + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + )); + // have three whitespace and have selected the third (one indent = two whitespace) + controller.codeLines = CodeLines.of(const [ + CodeLine(' abc') + ]); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 2, + extentIndex: 0, + extentOffset: 3 + ); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine(' abc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2 + )); + } + // Multi code lines without indent + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.applyOutdent(); + // select line 1-2 (all letters) + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 2, + extentOffset: 3 + ); + controller.applyOutdent(); + // select all + controller.selectAll(); + controller.applyOutdent(); + } + // Multi code lines with indents + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(' abc \n foo \n bar '); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc '), + CodeLine(' foo '), + CodeLine(' bar '), + ])); + expect(controller.selection, const CodeLineSelection.zero()); + // select line 1-2 (all letters) + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 2, + extentOffset: 5 + ); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc '), + CodeLine('foo '), + CodeLine('bar '), + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 2, + extentOffset: 4 + )); + // Rest code lines + controller.codeLines = CodeLines.of(const [ + CodeLine(' abc '), + CodeLine(' foo '), + CodeLine(' bar '), + ]); + // select all + controller.selectAll(); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc '), + CodeLine('foo '), + CodeLine('bar '), + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 2, + extentOffset: 4 + )); + // Rest code lines + controller.codeLines = CodeLines.of([ + CodeLine(' ${controller.options.indent}abc'), + CodeLine(' ${controller.options.indent}${controller.options.indent}foo'), + CodeLine(' ${controller.options.indent}${controller.options.indent}${controller.options.indent}bar'), + ]); + controller.selectAll(); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of([ + CodeLine('${controller.options.indent}abc'), + CodeLine('${controller.options.indent}${controller.options.indent}foo'), + CodeLine('${controller.options.indent}${controller.options.indent}${controller.options.indent}bar'), + ])); + expect(controller.selection, CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 2, + extentOffset: 3 + controller.options.indentSize * 3 + )); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of([ + const CodeLine('abc'), + CodeLine('${controller.options.indent}foo'), + CodeLine('${controller.options.indent}${controller.options.indent}bar'), + ])); + expect(controller.selection, CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 2, + extentOffset: 3 + controller.options.indentSize * 2 + )); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of([ + const CodeLine('abc'), + const CodeLine('foo'), + CodeLine('${controller.options.indent}bar'), + ])); + expect(controller.selection, CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 2, + extentOffset: 3 + controller.options.indentSize + )); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 2, + extentOffset: 3 + )); + } + // Multi code lines, have a chunk. + { + final CodeLineEditingController controller = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine(' {', [ + CodeLine(' foo'), + CodeLine(' bar') + ]), + CodeLine('}') + ]) + ); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('{', [ + CodeLine(' foo'), + CodeLine(' bar') + ]), + CodeLine('}') + ])); + expect(controller.selection, const CodeLineSelection.zero()); + // Rest code lines + controller.codeLines = CodeLines.of(const [ + CodeLine(' {', [ + CodeLine(' foo'), + CodeLine(' bar') + ]), + CodeLine(' }') + ]); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 0 + ); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine(' }') + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 0 + )); + // Rest code lines + controller.codeLines = CodeLines.of(const [ + CodeLine(' {', [ + CodeLine(' foo'), + CodeLine(' bar') + ]), + CodeLine(' }') + ]); + controller.selectAll(); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}') + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 1 + )); + controller.applyOutdent(); + // Rest code lines + controller.codeLines = CodeLines.of(const [ + CodeLine('{', [ + CodeLine(' foo'), + CodeLine(' bar') + ]), + CodeLine('}') + ]); + controller.selectAll(); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}') + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 1 + )); + } + // Multi code lines, have a few of chunks + { + final CodeLineEditingController controller = CodeLineEditingController(); + controller.codeLines = CodeLines.of([ + CodeLine('${controller.options.indent}{', [ + CodeLine('${controller.options.indent}foo'), + CodeLine('${controller.options.indent}bar') + ]), + CodeLine('${controller.options.indent}}'), + CodeLine('${controller.options.indent}{', [ + CodeLine('${controller.options.indent}foo'), + CodeLine('${controller.options.indent}bar') + ]), + CodeLine('${controller.options.indent}}'), + CodeLine('${controller.options.indent}{', [ + CodeLine('${controller.options.indent}foo'), + CodeLine('${controller.options.indent}bar') + ]), + CodeLine('${controller.options.indent}}') + ]); + controller.selectAll(); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}'), + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}'), + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}') + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 5, + extentOffset: 1 + )); + // Reset code lines + controller.codeLines = CodeLines.of([ + CodeLine('${controller.options.indent}{', [ + CodeLine('${controller.options.indent}foo'), + CodeLine('${controller.options.indent}bar') + ]), + CodeLine('${controller.options.indent}}'), + CodeLine('${controller.options.indent}{', [ + CodeLine('${controller.options.indent}foo'), + CodeLine('${controller.options.indent}bar') + ]), + CodeLine('${controller.options.indent}}'), + CodeLine('${controller.options.indent}{', [ + CodeLine('${controller.options.indent}foo'), + CodeLine('${controller.options.indent}bar') + ]), + CodeLine('${controller.options.indent}}') + ]); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 4, + extentOffset: 1, + ); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of([ + const CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + const CodeLine('}'), + const CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + const CodeLine('}'), + CodeLine('{', [ + CodeLine('${controller.options.indent}foo'), + CodeLine('${controller.options.indent}bar') + ]), + CodeLine('${controller.options.indent}}') + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 4, + extentOffset: 0 + )); + controller.applyOutdent(); + } + // Multi code lines, have nested chunks + { + final CodeLineEditingController controller = CodeLineEditingController(); + controller.codeLines = CodeLines.of([ + CodeLine('${controller.options.indent}{', [ + CodeLine('${controller.options.indent}foo'), + CodeLine('${controller.options.indent}bar', [ + CodeLine('${controller.options.indent}{', [ + CodeLine('${controller.options.indent}foo'), + CodeLine('${controller.options.indent}bar') + ]), + CodeLine('${controller.options.indent}}') + ]) + ]), + CodeLine('${controller.options.indent}}'), + ]); + controller.selectAll(); + controller.applyOutdent(); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar', [ + CodeLine('{', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('}') + ]) + ]), + CodeLine('}'), + ])); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 1 + )); + } + }); + + test('`collapseChunk() && expandChunk()`', () { + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.collapseChunk(0, 3); + expect(controller.value, CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + ]) + )); + controller.expandChunk(0); + expect(controller.value, CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]) + )); + } + { + const String json = '{\n' + ' "start": "foo",\n' + ' "abc": [\n' + ' 0,\n' + ' 1,\n' + ' 2,\n' + ' ],\n' + ' "end": "bar"\n' + '}'; + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + // Collapse inner array + controller.collapseChunk(2, 6); + expect(controller.value, CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('{'), + CodeLine(' "start": "foo",'), + CodeLine(' "abc": [', [ + CodeLine(' 0,'), + CodeLine(' 1,'), + CodeLine(' 2,'), + ]), + CodeLine(' ],'), + CodeLine(' "end": "bar"'), + CodeLine('}'), + ]) + )); + // Collapse the root object + controller.collapseChunk(0, 5); + expect(controller.value, CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('{', [ + CodeLine(' "start": "foo",'), + CodeLine(' "abc": [', [ + CodeLine(' 0,'), + CodeLine(' 1,'), + CodeLine(' 2,'), + ]), + CodeLine(' ],'), + CodeLine(' "end": "bar"'), + ]), + CodeLine('}'), + ]) + )); + // Expand the root object + controller.expandChunk(0); + expect(controller.value, CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('{'), + CodeLine(' "start": "foo",'), + CodeLine(' "abc": [', [ + CodeLine(' 0,'), + CodeLine(' 1,'), + CodeLine(' 2,'), + ]), + CodeLine(' ],'), + CodeLine(' "end": "bar"'), + CodeLine('}'), + ]) + )); + // Expand the inner array + controller.expandChunk(2); + expect(controller.value, CodeLineEditingController.fromText(json).value); + } + // Test selection + { + const String json = '{\n' + ' "start": "foo",\n' + ' "abc": [\n' + ' 0,\n' + ' 1,\n' + ' 2,\n' + ' ],\n' + ' "end": "bar"\n' + '}'; + // Selection position before array + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + controller.selection = const CodeLineSelection.collapsed( + index: 1, + offset: 0 + ); + controller.collapseChunk(2, 6); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 0 + )); + } + // Selection range before array (base before extent) + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 0 + ); + controller.collapseChunk(2, 6); + expect(controller.selection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 0 + )); + } + // Selection range before array (base after extent) + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 0, + extentOffset: 0 + ); + controller.collapseChunk(2, 6); + expect(controller.selection, const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 0, + extentOffset: 0 + )); + } + // Selection position is inside the collapse region, should move position to parent end. + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + controller.selection = const CodeLineSelection.collapsed( + index: 3, + offset: 0 + ); + controller.collapseChunk(2, 6); + expect(controller.selection, CodeLineSelection.collapsed( + index: 2, + offset: controller.codeLines[2].text.length + )); + } + // Selection range is included in collapse region, should move position to parent end. + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + controller.selection = const CodeLineSelection( + baseIndex: 3, + baseOffset: 0, + extentIndex: 5, + extentOffset: 0 + ); + controller.collapseChunk(2, 6); + expect(controller.selection, CodeLineSelection.collapsed( + index: 2, + offset: controller.codeLines[2].text.length + )); + } + // Selection base is before collapse region and extent is after collapse region + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 7, + extentOffset: 0 + ); + controller.collapseChunk(2, 6); + expect(controller.selection, const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 4, + extentOffset: 0 + )); + } + // Selection base is before collapse region and extent is inside collapse region + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 4, + extentOffset: 0 + ); + controller.collapseChunk(2, 6); + expect(controller.selection, CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 2, + extentOffset: controller.codeLines[2].text.length + )); + } + // Selection base is inside collapse region and extent is after collapse region + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + controller.selection = const CodeLineSelection( + baseIndex: 4, + baseOffset: 0, + extentIndex: 7, + extentOffset: 0 + ); + controller.collapseChunk(2, 6); + expect(controller.selection, CodeLineSelection( + baseIndex: 2, + baseOffset: controller.codeLines[2].text.length, + extentIndex: 4, + extentOffset: 0 + )); + } + // Selection extent is before collapse region and base is after collapse region + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + controller.selection = const CodeLineSelection( + baseIndex: 7, + baseOffset: 0, + extentIndex: 1, + extentOffset: 0 + ); + controller.collapseChunk(2, 6); + expect(controller.selection, const CodeLineSelection( + baseIndex: 4, + baseOffset: 0, + extentIndex: 1, + extentOffset: 0 + )); + } + // Selection extent is before collapse region and base is inside collapse region + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + controller.selection = const CodeLineSelection( + baseIndex: 4, + baseOffset: 0, + extentIndex: 1, + extentOffset: 0 + ); + controller.collapseChunk(2, 6); + expect(controller.selection, CodeLineSelection( + baseIndex: 2, + baseOffset: controller.codeLines[2].text.length, + extentIndex: 1, + extentOffset: 0 + )); + } + // Selection extent is inside collapse region and base is after collapse region + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + controller.selection = const CodeLineSelection( + baseIndex: 7, + baseOffset: 0, + extentIndex: 4, + extentOffset: 0 + ); + controller.collapseChunk(2, 6); + expect(controller.selection, CodeLineSelection( + baseIndex: 4, + baseOffset: 0, + extentIndex: 2, + extentOffset: controller.codeLines[2].text.length, + )); + } + // Selection position after array + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + controller.selection = const CodeLineSelection.collapsed( + index: 7, + offset: 0 + ); + controller.collapseChunk(2, 6); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 4, + offset: 0 + )); + } + // Selection range after array (base before extent) + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + controller.selection = const CodeLineSelection( + baseIndex: 7, + baseOffset: 0, + extentIndex: 8, + extentOffset: 0 + ); + controller.collapseChunk(2, 6); + expect(controller.selection, const CodeLineSelection( + baseIndex: 4, + baseOffset: 0, + extentIndex: 5, + extentOffset: 0 + )); + } + // Selection range after array (base after extent) + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + controller.selection = const CodeLineSelection( + baseIndex: 8, + baseOffset: 0, + extentIndex: 7, + extentOffset: 0 + ); + controller.collapseChunk(2, 6); + expect(controller.selection, const CodeLineSelection( + baseIndex: 5, + baseOffset: 0, + extentIndex: 4, + extentOffset: 0 + )); + } + } + // Test composing + { + const String json = '{\n' + ' "start": "foo",\n' + ' "abc": [\n' + ' 0,\n' + ' 1,\n' + ' 2,\n' + ' ],\n' + ' "end": "bar"\n' + '}'; + // Composing is before the collapsed chunk + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + controller.composing = TextRange.empty; + controller.collapseChunk(2, 6); + expect(controller.composing, TextRange.empty); + controller.expandChunk(2); + expect(controller.composing, TextRange.empty); + } + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + controller.composing = const TextRange.collapsed(1); + controller.collapseChunk(2, 6); + expect(controller.composing, const TextRange.collapsed(1)); + controller.expandChunk(2); + expect(controller.composing, const TextRange.collapsed(1)); + } + // Composing is in the collapsed chunk + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + controller.selection = CodeLineSelection.fromPosition( + position: const CodeLinePosition( + index: 3, + offset: 0 + ) + ); + controller.composing = const TextRange.collapsed(1); + controller.collapseChunk(2, 6); + expect(controller.composing, TextRange.empty); + } + // Composing is after the collapsed chunk + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(json); + controller.selection = CodeLineSelection.fromPosition( + position: const CodeLinePosition( + index: 7, + offset: 0 + ) + ); + controller.composing = const TextRange.collapsed(1); + controller.collapseChunk(2, 6); + expect(controller.composing, const TextRange.collapsed(1)); + controller.expandChunk(2); + expect(controller.composing, const TextRange.collapsed(1)); + } + } + }); + + test('`replaceSelection()`', () { + // Empty content + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + controller.replaceSelection('abc'); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + } + // Single code line + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.replaceSelection('abc'); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abcabc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + controller.replaceSelection('foo'); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abcfooabc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 6 + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 3, + extentIndex: 0, + extentOffset: 6 + ); + controller.replaceSelection('bar'); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abcbarabc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 6 + )); + controller.replaceSelection(''); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abcbarabc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 6 + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 3, + extentIndex: 0, + extentOffset: 6 + ); + controller.replaceSelection(''); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abcabc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 3 + )); + controller.replaceSelection('foo\nbar'); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abcfoo'), + CodeLine('barabc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 3 + )); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 1, + extentOffset: 3 + ); + controller.replaceSelection('123\n456\n789'); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abcfoo'), + CodeLine('123'), + CodeLine('456'), + CodeLine('789abc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 3, + offset: 3 + )); + controller.replaceSelection('456', const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 1, + extentOffset: 3 + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abcfoo'), + CodeLine('456'), + CodeLine('456'), + CodeLine('789abc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 3 + )); + controller.replaceSelection('123\n123', const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 2, + extentOffset: 3 + )); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('abcfoo'), + CodeLine('123'), + CodeLine('123'), + CodeLine('789abc') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 2, + offset: 3 + )); + } + // Multi code lines + { + final CodeLineEditingController controller = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('123') + ]), + CodeLine('foo', [ + CodeLine('456') + ]), + CodeLine('bar', [ + CodeLine('789') + ]), + ]) + ); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ); + controller.replaceSelection(' '); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('a c', [ + CodeLine('123') + ]), + CodeLine('foo', [ + CodeLine('456') + ]), + CodeLine('bar', [ + CodeLine('789') + ]), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2 + )); + controller.selection = const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 1, + extentOffset: 3 + ); + controller.replaceSelection('hello\nreqable\n'); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('a c', [ + CodeLine('123') + ]), + CodeLine('hello'), + CodeLine('reqable'), + CodeLine('', [ + CodeLine('456') + ]), + CodeLine('bar', [ + CodeLine('789') + ]), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 3, + offset: 0 + )); + controller.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 4, + extentOffset: 3 + ); + controller.replaceSelection('b'); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('ab', [ + CodeLine('789') + ]), + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 2 + )); + } + }); + + test('`replaceAll()`', () { + // Empty content + { + final CodeLineEditingController controller = CodeLineEditingController.fromText(''); + controller.replaceAll('', 'abc'); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine.empty + ])); + controller.replaceAll('abc', 'abc'); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine.empty + ])); + } + // Single code line + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + controller.replaceAll('abc', 'foo'); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('foo') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 0 + )); + controller.selection = const CodeLineSelection.collapsed( + index: 0, + offset: 2 + ); + controller.replaceAll('o', '123'); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('f123123') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 4 + )); + controller.replaceAll('123', '123456789'); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('f123456789123456789') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 10 + )); + controller.replaceAll('123456789', '\n'); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('f'), + CodeLine(''), + CodeLine('') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 0 + )); + } + // Multi code lines + { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc\nfoo\nbar'); + controller.replaceAll('a', '123'); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('123bc'), + CodeLine('foo'), + CodeLine('b123r') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 0 + )); + controller.selection = const CodeLineSelection.collapsed( + index: 1, + offset: 0 + ); + controller.replaceAll('b', '456'); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('123456c'), + CodeLine('foo'), + CodeLine('456123r') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 1, + offset: 0 + )); + controller.selection = const CodeLineSelection.collapsed( + index: 2, + offset: 7 + ); + controller.replaceAll(RegExp('\\d'), 'zzz'); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine('zzzzzzzzzzzzzzzzzzc'), + CodeLine('foo'), + CodeLine('zzzzzzzzzzzzzzzzzzr') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 2, + offset: 19 + )); + controller.replaceAll('zzzzz', '\n'); + expect(controller.codeLines, CodeLines.of(const [ + CodeLine(''), + CodeLine(''), + CodeLine(''), + CodeLine('zzzc'), + CodeLine('foo'), + CodeLine(''), + CodeLine(''), + CodeLine(''), + CodeLine('zzzr') + ])); + expect(controller.selection, const CodeLineSelection.collapsed( + index: 8, + offset: 4 + )); + } + }); + + test('`clearComposing()`', () { + final CodeLineEditingController controller = CodeLineEditingController.fromText('abc'); + const TextRange composing = TextRange( + start: 0, + end: 1 + ); + controller.composing = composing; + expect(controller.composing, composing); + expect(controller.isComposing, true); + controller.clearComposing(); + expect(controller.composing, TextRange.empty); + expect(controller.isComposing, false); + }); + + }); +} \ No newline at end of file diff --git a/packages/re_editor/test/code_line_editing_value_test.dart b/packages/re_editor/test/code_line_editing_value_test.dart new file mode 100644 index 0000000..7743692 --- /dev/null +++ b/packages/re_editor/test/code_line_editing_value_test.dart @@ -0,0 +1,253 @@ +import 'dart:ui'; + +import 'package:flutter_test/flutter_test.dart'; +import 'package:re_editor/re_editor.dart'; + +void main() { + group('CodeLineEditingValue constructor ', () { + test('`CodeLineEditingValue()`', () { + { + final CodeLineEditingValue value = CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc') + ]) + ); + expect(value.codeLines, CodeLines.of(const [ + CodeLine('abc') + ])); + expect(value.selection, const CodeLineSelection.zero()); + expect(value.composing, TextRange.empty); + } + { + final CodeLineEditingValue value = CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc') + ]), + selection: const CodeLineSelection.collapsed( + index: 0, + offset: 1 + ), + composing: const TextRange( + start: 1, + end: 2 + ) + ); + expect(value.codeLines, CodeLines.of(const [ + CodeLine('abc') + ])); + expect(value.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )); + expect(value.composing, const TextRange( + start: 1, + end: 2 + )); + } + }); + + test('`CodeLineEditingValue.empty()`', () { + const CodeLineEditingValue value = CodeLineEditingValue.empty(); + expect(value.codeLines, CodeLines.of(const [ + CodeLine.empty + ])); + expect(value.selection, const CodeLineSelection.zero()); + expect(value.composing, TextRange.empty); + }); + }); + + group('CodeLineEditingValue method ', () { + test('`copyWith()`', () { + final CodeLineEditingValue value = CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc') + ]), + selection: const CodeLineSelection.collapsed( + index: 0, + offset: 1 + ), + composing: const TextRange( + start: 1, + end: 2 + ) + ); + expect(value.copyWith(), value); + expect(value.copyWith( + codeLines: CodeLines.of(const [ + CodeLine('foo'), + CodeLine('bar') + ]) + ), CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('foo'), + CodeLine('bar') + ]), + selection: const CodeLineSelection.collapsed( + index: 0, + offset: 1 + ), + composing: const TextRange( + start: 1, + end: 2 + ) + )); + expect(value.copyWith( + selection: const CodeLineSelection.collapsed( + index: 0, + offset: 2 + ), + ), CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc') + ]), + selection: const CodeLineSelection.collapsed( + index: 0, + offset: 2 + ), + composing: const TextRange( + start: 1, + end: 2 + ) + )); + expect(value.copyWith( + composing: const TextRange( + start: 2, + end: 3 + ) + ), CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc') + ]), + selection: const CodeLineSelection.collapsed( + index: 0, + offset: 1 + ), + composing: const TextRange( + start: 2, + end: 3 + ) + )); + }); + }); + + group('CodeLineEditingValue operator ', () { + test('`==`', () { + { + final CodeLineEditingValue value1 = CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc') + ]), + selection: const CodeLineSelection.collapsed( + index: 0, + offset: 0 + ), + composing: const TextRange( + start: 0, + end: 0 + ) + ); + final CodeLineEditingValue value2 = CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc') + ]), + selection: const CodeLineSelection.collapsed( + index: 0, + offset: 0 + ), + composing: const TextRange( + start: 0, + end: 0 + ) + ); + expect(value1, value2); + } + { + final CodeLineEditingValue value1 = CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc') + ]), + selection: const CodeLineSelection.collapsed( + index: 0, + offset: 0 + ), + composing: const TextRange( + start: 0, + end: 0 + ) + ); + final CodeLineEditingValue value2 = CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('foobar') + ]), + selection: const CodeLineSelection.collapsed( + index: 0, + offset: 0 + ), + composing: const TextRange( + start: 0, + end: 0 + ) + ); + expect(value1 != value2, true); + } + { + final CodeLineEditingValue value1 = CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc') + ]), + selection: const CodeLineSelection.collapsed( + index: 0, + offset: 0 + ), + composing: const TextRange( + start: 0, + end: 0 + ) + ); + final CodeLineEditingValue value2 = CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc') + ]), + selection: const CodeLineSelection.collapsed( + index: 0, + offset: 1 + ), + composing: const TextRange( + start: 0, + end: 0 + ) + ); + expect(value1 != value2, true); + } + { + final CodeLineEditingValue value1 = CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc') + ]), + selection: const CodeLineSelection.collapsed( + index: 0, + offset: 0 + ), + composing: const TextRange( + start: 0, + end: 0 + ) + ); + final CodeLineEditingValue value2 = CodeLineEditingValue( + codeLines: CodeLines.of(const [ + CodeLine('abc') + ]), + selection: const CodeLineSelection.collapsed( + index: 0, + offset: 0 + ), + composing: const TextRange( + start: 1, + end: 0 + ) + ); + expect(value1 != value2, true); + } + }); + }); +} \ No newline at end of file diff --git a/packages/re_editor/test/code_line_extension_test.dart b/packages/re_editor/test/code_line_extension_test.dart new file mode 100644 index 0000000..5bae15b --- /dev/null +++ b/packages/re_editor/test/code_line_extension_test.dart @@ -0,0 +1,40 @@ +import 'package:flutter_test/flutter_test.dart'; +import 'package:re_editor/re_editor.dart'; + +void main() { + group('CodeLineExtension', () { + test('get textLines', () { + expect(''.textLines, const [ + '' + ]); + expect('abc'.textLines, const [ + 'abc' + ]); + expect('abc\nfoo\nbar'.textLines, const [ + 'abc', + 'foo', + 'bar' + ]); + expect('abc\r\nfoo\rbar'.textLines, const [ + 'abc', + 'foo', + 'bar' + ]); + }); + test('get codeLines', () { + expect('abc\nfoo\nbar'.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ])); + }); + + test('get codeLinesAsync', () async { + expect(await 'abc\nfoo\nbar'.codeLinesAsync, CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ])); + }); + }); +} diff --git a/packages/re_editor/test/code_line_position_test.dart b/packages/re_editor/test/code_line_position_test.dart new file mode 100644 index 0000000..7ba99cb --- /dev/null +++ b/packages/re_editor/test/code_line_position_test.dart @@ -0,0 +1,110 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_test/flutter_test.dart'; +import 'package:re_editor/re_editor.dart'; + +void main() { + group('CodeLinePosition constructor ', () { + test('`CodeLinePosition()`', () { + const CodeLinePosition position = CodeLinePosition( + index: 1, + offset: 2, + affinity: TextAffinity.upstream + ); + expect(position.index, 1); + expect(position.offset, 2); + expect(position.affinity, TextAffinity.upstream); + }); + test('`CodeLinePosition.from()`', () { + final CodeLinePosition position = CodeLinePosition.from( + index: 1, + position: const TextPosition( + offset: 2, + affinity: TextAffinity.upstream + ) + ); + expect(position.index, 1); + expect(position.offset, 2); + expect(position.affinity, TextAffinity.upstream); + }); + }); + + group('CodeLinePosition method ', () { + test('`copyWith`', () { + const CodeLinePosition position = CodeLinePosition( + index: 1, + offset: 2, + affinity: TextAffinity.downstream + ); + expect(position.copyWith(), position); + expect(position.copyWith( + index: 0 + ), const CodeLinePosition( + index: 0, + offset: 2, + affinity: TextAffinity.downstream + )); + expect(position.copyWith( + offset: 0 + ), const CodeLinePosition( + index: 1, + offset: 0, + affinity: TextAffinity.downstream + )); + expect(position.copyWith( + affinity: TextAffinity.upstream + ), const CodeLinePosition( + index: 1, + offset: 2, + affinity: TextAffinity.upstream + )); + expect(position.copyWith( + index: 0, + offset: 0, + affinity: TextAffinity.downstream + ), const CodeLinePosition( + index: 0, + offset: 0, + affinity: TextAffinity.downstream + )); + }); + }); + + group('CodeLinePosition operator ', () { + test('`==`', () { + { + final CodeLinePosition position1 = CodeLinePosition.from( + index: 1, + position: const TextPosition( + offset: 2, + affinity: TextAffinity.upstream + ) + ); + final CodeLinePosition position2 = CodeLinePosition.from( + index: 1, + position: const TextPosition( + offset: 2, + affinity: TextAffinity.upstream + ) + ); + expect(position1, position2); + } + { + final CodeLinePosition position1 = CodeLinePosition.from( + index: 1, + position: const TextPosition( + offset: 1, + affinity: TextAffinity.upstream + ) + ); + final CodeLinePosition position2 = CodeLinePosition.from( + index: 2, + position: const TextPosition( + offset: 2, + affinity: TextAffinity.upstream + ) + ); + expect(position1 == position2, false); + } + }); + }); +} \ No newline at end of file diff --git a/packages/re_editor/test/code_line_range_test.dart b/packages/re_editor/test/code_line_range_test.dart new file mode 100644 index 0000000..0558ce0 --- /dev/null +++ b/packages/re_editor/test/code_line_range_test.dart @@ -0,0 +1,128 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_test/flutter_test.dart'; +import 'package:re_editor/re_editor.dart'; + +void main() { + group('CodeLineRange constructor ', () { + test('`CodeLineRange()`', () { + const CodeLineRange range = CodeLineRange( + index: 1, + start: 2, + end: 3 + ); + expect(range.index, 1); + expect(range.start, 2); + expect(range.end, 3); + }); + + test('`CodeLineRange.from()`', () { + final CodeLineRange range = CodeLineRange.from( + index: 1, + range: const TextRange( + start: 2, + end: 3 + ) + ); + expect(range.index, 1); + expect(range.start, 2); + expect(range.end, 3); + }); + + test('`CodeLineRange.collapsed()`', () { + const CodeLineRange range = CodeLineRange.collapsed( + index: 1, + offset: 2 + ); + expect(range.index, 1); + expect(range.start, 2); + expect(range.end, 2); + }); + + test('`CodeLineRange.empty()`', () { + const CodeLineRange range = CodeLineRange.empty(); + expect(range.index, 0); + expect(range.start, -1); + expect(range.end, -1); + }); + }); + + group('CodeLineRange method ', () { + test('`copyWith`', () { + const CodeLineRange range = CodeLineRange( + index: 1, + start: 2, + end: 3 + ); + expect(range.copyWith(), range); + expect(range.copyWith( + index: 0 + ), const CodeLineRange( + index: 0, + start: 2, + end: 3 + )); + expect(range.copyWith( + start: 0 + ), const CodeLineRange( + index: 1, + start: 0, + end: 3 + )); + expect(range.copyWith( + end: 0 + ), const CodeLineRange( + index: 1, + start: 2, + end: 0 + )); + expect(range.copyWith( + index: 0, + start: 0, + end: 0 + ), const CodeLineRange( + index: 0, + start: 0, + end: 0 + )); + }); + }); + + group('CodeLineRange operator ', () { + test('`==`', () { + { + final CodeLineRange range1 = CodeLineRange.from( + index: 1, + range: const TextRange( + start: 2, + end: 3 + ) + ); + final CodeLineRange range2 = CodeLineRange.from( + index: 1, + range: const TextRange( + start: 2, + end: 3 + ) + ); + expect(range1, range2); + } + { + final CodeLineRange range1 = CodeLineRange.from( + index: 1, + range: const TextRange( + start: 2, + end: 3 + ) + ); + final CodeLineRange range2 = CodeLineRange.from( + index: 2, + range: const TextRange( + start: 2, + end: 3 + ) + ); + expect(range1 == range2, false); + } + }); + }); +} \ No newline at end of file diff --git a/packages/re_editor/test/code_line_selection_test.dart b/packages/re_editor/test/code_line_selection_test.dart new file mode 100644 index 0000000..69920e8 --- /dev/null +++ b/packages/re_editor/test/code_line_selection_test.dart @@ -0,0 +1,647 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_test/flutter_test.dart'; +import 'package:re_editor/re_editor.dart'; + +void main() { + group('CodeLineSelection constructor ', () { + test('`CodeLineSelection()`', () { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 1, + baseOffset: 2, + extentIndex: 3, + extentOffset: 4, + baseAffinity: TextAffinity.upstream + ); + expect(selection.baseIndex, 1); + expect(selection.baseOffset, 2); + expect(selection.extentIndex, 3); + expect(selection.extentOffset, 4); + expect(selection.baseAffinity, TextAffinity.upstream); + }); + test('`CodeLineSelection.collapsed()`', () { + const CodeLineSelection selection = CodeLineSelection.collapsed( + index: 1, + offset: 2, + affinity: TextAffinity.upstream + ); + expect(selection.baseIndex, 1); + expect(selection.baseOffset, 2); + expect(selection.extentIndex, 1); + expect(selection.extentOffset, 2); + expect(selection.baseAffinity, TextAffinity.upstream); + }); + test('`CodeLineSelection.fromPosition()`', () { + final CodeLineSelection selection = CodeLineSelection.fromPosition( + position: const CodeLinePosition( + index: 1, + offset: 2, + affinity: TextAffinity.upstream + ) + ); + expect(selection.baseIndex, 1); + expect(selection.baseOffset, 2); + expect(selection.extentIndex, 1); + expect(selection.extentOffset, 2); + expect(selection.baseAffinity, TextAffinity.upstream); + }); + test('`CodeLineSelection.fromRange()`', () { + final CodeLineSelection selection = CodeLineSelection.fromRange( + range: const CodeLineRange( + index: 1, + start: 2, + end: 3 + ) + ); + expect(selection.baseIndex, 1); + expect(selection.baseOffset, 2); + expect(selection.extentIndex, 1); + expect(selection.extentOffset, 3); + expect(selection.baseAffinity, TextAffinity.downstream); + }); + test('`CodeLineSelection.fromTextSelection()`', () { + final CodeLineSelection selection = CodeLineSelection.fromTextSelection( + index: 1, + selection: const TextSelection( + baseOffset: 2, + extentOffset: 3, + affinity: TextAffinity.upstream + ) + ); + expect(selection.baseIndex, 1); + expect(selection.baseOffset, 2); + expect(selection.extentIndex, 1); + expect(selection.extentOffset, 3); + expect(selection.baseAffinity, TextAffinity.upstream); + }); + test('`CodeLineSelection.zero()`', () { + const CodeLineSelection selection = CodeLineSelection.zero(); + expect(selection.baseIndex, 0); + expect(selection.baseOffset, 0); + expect(selection.extentIndex, 0); + expect(selection.extentOffset, 0); + expect(selection.baseAffinity, TextAffinity.downstream); + }); + }); + + group('CodeLineSelection getter ', () { + test('`base`', () { + // Multi code line selected and base before extent + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 1, + ); + expect(selection.base, const CodeLinePosition( + index: 0, + offset: 0, + affinity: TextAffinity.downstream + )); + } + // Multi code line selected and base after extent + { + const CodeLineSelection selection = CodeLineSelection( + extentIndex: 0, + extentOffset: 0, + baseIndex: 1, + baseOffset: 1, + ); + expect(selection.base, const CodeLinePosition( + index: 1, + offset: 1, + affinity: TextAffinity.downstream + )); + } + // Single code line selected and base before extent + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1, + ); + expect(selection.base, const CodeLinePosition( + index: 0, + offset: 0, + affinity: TextAffinity.downstream + )); + } + // Single code line selected and base after extent + { + const CodeLineSelection selection = CodeLineSelection( + extentIndex: 0, + extentOffset: 0, + baseIndex: 0, + baseOffset: 1, + ); + expect(selection.base, const CodeLinePosition( + index: 0, + offset: 1, + affinity: TextAffinity.downstream + )); + } + // collapsed and upstream + { + const CodeLineSelection selection = CodeLineSelection.collapsed( + index: 0, + offset: 0, + affinity: TextAffinity.upstream + ); + expect(selection.base, const CodeLinePosition( + index: 0, + offset: 0, + affinity: TextAffinity.upstream + )); + } + // collapsed and downstream + { + const CodeLineSelection selection = CodeLineSelection.collapsed( + index: 0, + offset: 0, + affinity: TextAffinity.downstream + ); + expect(selection.base, const CodeLinePosition( + index: 0, + offset: 0, + affinity: TextAffinity.downstream + )); + } + }); + + test('`extent`', () { + // Multi code line selected and base before extent + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 1, + ); + expect(selection.extent, const CodeLinePosition( + index: 1, + offset: 1, + affinity: TextAffinity.downstream + )); + } + // Multi code line selected and base after extent + { + const CodeLineSelection selection = CodeLineSelection( + extentIndex: 0, + extentOffset: 0, + baseIndex: 1, + baseOffset: 1, + ); + expect(selection.extent, const CodeLinePosition( + index: 0, + offset: 0, + affinity: TextAffinity.downstream + )); + } + // Single code line selected and base before extent + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1, + ); + expect(selection.extent, const CodeLinePosition( + index: 0, + offset: 1, + affinity: TextAffinity.downstream + )); + } + // Single code line selected and base after extent + { + const CodeLineSelection selection = CodeLineSelection( + extentIndex: 0, + extentOffset: 0, + baseIndex: 0, + baseOffset: 1, + ); + expect(selection.extent, const CodeLinePosition( + index: 0, + offset: 0, + affinity: TextAffinity.downstream + )); + } + // collapsed and upstream + { + const CodeLineSelection selection = CodeLineSelection.collapsed( + index: 0, + offset: 0, + affinity: TextAffinity.upstream + ); + expect(selection.extent, const CodeLinePosition( + index: 0, + offset: 0, + affinity: TextAffinity.upstream + )); + } + // collapsed and downstream + { + const CodeLineSelection selection = CodeLineSelection.collapsed( + index: 0, + offset: 0, + affinity: TextAffinity.downstream + ); + expect(selection.extent, const CodeLinePosition( + index: 0, + offset: 0, + affinity: TextAffinity.downstream + )); + } + }); + + test('`start`', () { + // Multi code line selected and base before extent + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 1, + ); + expect(selection.start, selection.base); + } + // Multi code line selected and base after extent + { + const CodeLineSelection selection = CodeLineSelection( + extentIndex: 0, + extentOffset: 0, + baseIndex: 1, + baseOffset: 1, + ); + expect(selection.start, selection.extent); + } + // Single code line selected and base before extent + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1, + ); + expect(selection.start, selection.base); + } + // Single code line selected and base after extent + { + const CodeLineSelection selection = CodeLineSelection( + extentIndex: 0, + extentOffset: 0, + baseIndex: 0, + baseOffset: 1, + ); + expect(selection.start, selection.extent); + } + // collapsed + { + const CodeLineSelection selection = CodeLineSelection.collapsed( + index: 0, + offset: 0, + ); + expect(selection.start, selection.base); + expect(selection.start, selection.extent); + } + }); + + test('`end`', () { + // Multi code line selected and base before extent + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 1, + ); + expect(selection.start, selection.base); + } + // Multi code line selected and base after extent + { + const CodeLineSelection selection = CodeLineSelection( + extentIndex: 0, + extentOffset: 0, + baseIndex: 1, + baseOffset: 1, + ); + expect(selection.start, selection.extent); + } + // Single code line selected and base before extent + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1, + ); + expect(selection.start, selection.base); + } + // Single code line selected and base after extent + { + const CodeLineSelection selection = CodeLineSelection( + extentIndex: 0, + extentOffset: 0, + baseIndex: 0, + baseOffset: 1, + ); + expect(selection.start, selection.extent); + } + // collapsed + { + const CodeLineSelection selection = CodeLineSelection.collapsed( + index: 0, + offset: 0, + ); + expect(selection.start, selection.base); + expect(selection.start, selection.extent); + } + }); + + test('`startIndex`', () { + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 1, + ); + expect(selection.startIndex, 0); + } + { + const CodeLineSelection selection = CodeLineSelection( + extentIndex: 0, + extentOffset: 0, + baseIndex: 1, + baseOffset: 1, + ); + expect(selection.startIndex, 0); + } + }); + + test('`startOffset`', () { + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 1, + ); + expect(selection.startOffset, 0); + } + { + const CodeLineSelection selection = CodeLineSelection( + extentIndex: 0, + extentOffset: 0, + baseIndex: 1, + baseOffset: 1, + ); + expect(selection.startOffset, 0); + } + }); + + test('`endIndex`', () { + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 1, + ); + expect(selection.endIndex, 1); + } + { + const CodeLineSelection selection = CodeLineSelection( + extentIndex: 0, + extentOffset: 0, + baseIndex: 1, + baseOffset: 1, + ); + expect(selection.endIndex, 1); + } + }); + + test('`endOffset`', () { + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 1, + ); + expect(selection.endOffset, 1); + } + { + const CodeLineSelection selection = CodeLineSelection( + extentIndex: 0, + extentOffset: 0, + baseIndex: 1, + baseOffset: 1, + ); + expect(selection.endOffset, 1); + } + }); + + test('`isCollapsed`', () { + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 0, + ); + expect(selection.isCollapsed, true); + } + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1, + ); + expect(selection.isCollapsed, false); + } + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 0, + ); + expect(selection.isCollapsed, false); + } + }); + + test('`isSameLine`', () { + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 0, + ); + expect(selection.isSameLine, true); + } + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1, + ); + expect(selection.isSameLine, true); + } + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 1, + extentOffset: 0, + ); + expect(selection.isSameLine, false); + } + }); + }); + + group('CodeLineSelection method ', () { + test('`contains()`', () { + // Collapsed + { + const CodeLineSelection selection = CodeLineSelection.collapsed( + index: 0, + offset: 0 + ); + expect(selection.contains(selection), true); + expect(selection.contains(const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )), false); + } + // Single code line + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 3, + ); + expect(selection.contains(selection), true); + expect(selection.contains(const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )), true); + expect(selection.contains(const CodeLineSelection.collapsed( + index: 0, + offset: 4 + )), false); + expect(selection.contains(const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1 + )), true); + } + // Multi code line + { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 3, + extentOffset: 3, + ); + expect(selection.contains(selection), true); + expect(selection.contains(const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )), true); + expect(selection.contains(const CodeLineSelection.collapsed( + index: 0, + offset: 4 + )), true); + expect(selection.contains(const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 1, + extentOffset: 1000 + )), true); + expect(selection.contains(const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 2, + extentOffset: 1000 + )), true); + expect(selection.contains(const CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 3, + extentOffset: 1000 + )), false); + } + }); + + test('`copyWith()`', () { + const CodeLineSelection selection = CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 3, + extentOffset: 3, + ); + expect(selection.copyWith(), selection); + expect(selection.copyWith( + baseIndex: 3, + baseOffset: 3, + extentIndex: 0, + extentOffset: 0, + baseAffinity: TextAffinity.upstream, + extentAffinity: TextAffinity.upstream + ), const CodeLineSelection( + baseIndex: 3, + baseOffset: 3, + extentIndex: 0, + extentOffset: 0, + baseAffinity: TextAffinity.upstream, + extentAffinity: TextAffinity.upstream + )); + expect(selection.copyWith( + baseIndex: 3, + baseAffinity: TextAffinity.upstream + ), const CodeLineSelection( + baseIndex: 3, + baseOffset: 0, + extentIndex: 3, + extentOffset: 3, + baseAffinity: TextAffinity.upstream + )); + expect(selection.copyWith( + baseOffset: 3, + baseAffinity: TextAffinity.upstream + ), const CodeLineSelection( + baseIndex: 0, + baseOffset: 3, + extentIndex: 3, + extentOffset: 3, + baseAffinity: TextAffinity.upstream + )); + expect(selection.copyWith( + extentIndex: 0, + extentAffinity: TextAffinity.upstream + ), const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 3, + extentAffinity: TextAffinity.upstream + )); + expect(selection.copyWith( + extentOffset: 0, + extentAffinity: TextAffinity.upstream + ), const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 3, + extentOffset: 0, + extentAffinity: TextAffinity.upstream + )); + }); + }); +} \ No newline at end of file diff --git a/packages/re_editor/test/code_line_test.dart b/packages/re_editor/test/code_line_test.dart new file mode 100644 index 0000000..0a31e5a --- /dev/null +++ b/packages/re_editor/test/code_line_test.dart @@ -0,0 +1,266 @@ +import 'package:flutter_test/flutter_test.dart'; +import 'package:re_editor/re_editor.dart'; + +void main() { + group('CodeLine getter ', () { + test('`length`', () { + { + const CodeLine codeLine = CodeLine.empty; + expect(codeLine.length, 0); + } + { + const CodeLine codeLine = CodeLine('abc'); + expect(codeLine.length, 3); + } + { + const CodeLine codeLine = CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]); + expect(codeLine.length, 3); + } + }); + + test('`chunkParent`', () { + { + const CodeLine codeLine = CodeLine('abc'); + expect(codeLine.chunkParent, false); + } + { + const CodeLine codeLine = CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]); + expect(codeLine.chunkParent, true); + } + }); + + test('`lineCount`', () { + { + const CodeLine codeLine = CodeLine.empty; + expect(codeLine.lineCount, 1); + } + { + const CodeLine codeLine = CodeLine('abc'); + expect(codeLine.lineCount, 1); + } + { + const CodeLine codeLine = CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]); + expect(codeLine.lineCount, 3); + } + { + const CodeLine codeLine = CodeLine('abc', [ + CodeLine('foo', [ + CodeLine('inner', [ + CodeLine('inner1'), + CodeLine('inner2'), + CodeLine('inner3'), + ]) + ]), + CodeLine('bar', [ + CodeLine('inner', [ + CodeLine('inner4'), + CodeLine('inner5'), + CodeLine('inner6'), + CodeLine('inner7'), + ]) + ]), + ]); + expect(codeLine.lineCount, 12); + } + }); + + test('`charCount`', () { + { + const CodeLine codeLine = CodeLine.empty; + expect(codeLine.charCount, 0); + } + { + const CodeLine codeLine = CodeLine('abc'); + expect(codeLine.charCount, 3); + } + { + const CodeLine codeLine = CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]); + expect(codeLine.charCount, 9); + } + { + const CodeLine codeLine = CodeLine('abc', [ + CodeLine('foo', [ + CodeLine('inner', [ + CodeLine('inner1'), + CodeLine('inner2'), + CodeLine('inner3'), + ]) + ]), + CodeLine('bar', [ + CodeLine('inner', [ + CodeLine('inner4'), + CodeLine('inner5'), + CodeLine('inner6'), + CodeLine('inner7'), + ]) + ]), + ]); + expect(codeLine.charCount, 61); + } + }); + }); + + group('CodeLine method ', () { + test('`toString()`', () { + { + const CodeLine codeLine = CodeLine('abc'); + expect(codeLine.toString(), 'abc'); + } + { + const CodeLine codeLine = CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]); + expect(codeLine.toString(), 'abc'); + } + }); + + test('`asString()`', () { + { + const CodeLine codeLine = CodeLine('abc'); + expect(codeLine.asString(0, TextLineBreak.lf), 'abc'); + expect(codeLine.asString(1, TextLineBreak.lf), 'bc'); + expect(codeLine.asString(3, TextLineBreak.lf), ''); + } + { + const CodeLine codeLine = CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]); + expect(codeLine.asString(0, TextLineBreak.lf), 'abc\nfoo\nbar'); + expect(codeLine.asString(0, TextLineBreak.crlf), 'abc\r\nfoo\r\nbar'); + expect(codeLine.asString(1, TextLineBreak.lf), 'bc\nfoo\nbar'); + expect(codeLine.asString(3, TextLineBreak.lf), '\nfoo\nbar'); + } + { + const CodeLine codeLine = CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + CodeLine('123', [ + CodeLine('foo'), + CodeLine('bar'), + ]) + ]); + expect(codeLine.asString(0, TextLineBreak.lf), 'abc\nfoo\nbar\n123\nfoo\nbar'); + } + }); + + test('`flat()`', () { + { + const CodeLine codeLine = CodeLine('abc'); + expect(codeLine.flat(), const ['abc']); + } + { + const CodeLine codeLine = CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]); + expect(codeLine.flat(), const ['abc', 'foo', 'bar']); + } + { + const CodeLine codeLine = CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + CodeLine('123', [ + CodeLine('foo'), + CodeLine('bar'), + ]) + ]); + expect(codeLine.flat(), const ['abc', 'foo', 'bar', '123', 'foo', 'bar']); + } + }); + + test('`copyWith()`', () { + { + const CodeLine codeLine = CodeLine('abc'); + expect(codeLine.copyWith(), codeLine); + } + { + const CodeLine codeLine = CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]); + expect(codeLine.copyWith(), codeLine); + } + { + final CodeLine codeLine = const CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]).copyWith( + text: '123', + ); + expect(codeLine.text, '123'); + expect(codeLine.chunks, const [ + CodeLine('foo'), + CodeLine('bar') + ]); + } + { + final CodeLine codeLine = const CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]).copyWith( + text: '123', + chunks: const [] + ); + expect(codeLine.text, '123'); + expect(codeLine.chunks, const []); + } + }); + }); + + group('CodeLine operator ', () { + test('`==`', () { + { + final CodeLine codeLine1 = CodeLine('abc' * 1); + final CodeLine codeLine2 = CodeLine('abc' * 1); + expect(codeLine1, codeLine2); + } + { + final CodeLine codeLine1 = CodeLine('abc' * 1, [ + CodeLine('foo' * 1), + CodeLine('bar' * 1) + ]); + final CodeLine codeLine2 = CodeLine('abc' * 1, [ + CodeLine('foo' * 1), + CodeLine('bar' * 1) + ]); + expect(codeLine1, codeLine2); + } + { + final CodeLine codeLine1 = CodeLine('abc' * 1, [ + const CodeLine('foo'), + const CodeLine('bar') + ]); + final CodeLine codeLine2 = CodeLine('abc' * 2, [ + const CodeLine('foo'), + const CodeLine('bar') + ]); + expect(codeLine1 == codeLine2, false); + } + { + final CodeLine codeLine1 = CodeLine('abc' * 1, [ + CodeLine('foo' * 1), + CodeLine('bar' * 1) + ]); + final CodeLine codeLine2 = CodeLine('abc' * 1, [ + CodeLine('foo' * 2), + CodeLine('bar' * 2) + ]); + expect(codeLine1 == codeLine2, false); + } + }); + }); +} \ No newline at end of file diff --git a/packages/re_editor/test/code_lines_test.dart b/packages/re_editor/test/code_lines_test.dart new file mode 100644 index 0000000..44e1f38 --- /dev/null +++ b/packages/re_editor/test/code_lines_test.dart @@ -0,0 +1,1075 @@ +import 'package:flutter/foundation.dart'; +import 'package:flutter_test/flutter_test.dart'; +import 'package:re_editor/re_editor.dart'; + +void main() { + group('CodeLines constructor ', () { + test('`CodeLines()`', () { + { + const CodeLines codeLines = CodeLines([]); + expect(listEquals(codeLines.segments, const []), true); + } + { + const CodeLines codeLines = CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ] + ) + ]); + expect(listEquals(codeLines.segments, const [ + CodeLineSegment( + codeLines: [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ] + ) + ]), true); + } + }); + + test('`CodeLines.empty()`', () { + final CodeLines codeLines = CodeLines.empty(); + expect(listEquals(codeLines.segments, const []), true); + }); + + test('`CodeLines.of()`', () { + { + final CodeLines codeLines = CodeLines.of(const []); + expect(listEquals(codeLines.segments, const []), true); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ]); + expect(listEquals(codeLines.segments, const [ + CodeLineSegment( + codeLines: [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ] + ) + ]), true); + } + { + final CodeLines codeLines = CodeLines.of(List.generate(512, (index) => CodeLine('$index'))); + expect(codeLines.segments.length, 2); + for (int i = 0; i < codeLines.segments.length; i++) { + expect(codeLines.segments[i].dirty, false); + expect(codeLines.segments[i].first, CodeLine('${i * 256}')); + expect(codeLines.segments[i].last, CodeLine('${(i + 1) * 256 - 1}')); + } + } + }); + + test('`CodeLines.from()`', () { + { + final CodeLines codeLines = CodeLines.from(CodeLines.empty()); + expect(listEquals(codeLines.segments, const []), true); + } + { + final CodeLines codeLines = CodeLines.from(const CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ] + ) + ])); + expect(listEquals(codeLines.segments, const [ + CodeLineSegment( + codeLines: [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ], + dirty: true + ) + ]), true); + } + { + final CodeLines codeLines = CodeLines.from(const CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('abc'), + ] + ), + CodeLineSegment( + codeLines: [ + CodeLine('foo'), + ] + ), + CodeLineSegment( + codeLines: [ + CodeLine('bar'), + ] + ) + ])); + expect(listEquals(codeLines.segments, const [ + CodeLineSegment( + codeLines: [ + CodeLine('abc'), + ], + dirty: true + ), + CodeLineSegment( + codeLines: [ + CodeLine('foo'), + ], + dirty: true + ), + CodeLineSegment( + codeLines: [ + CodeLine('bar'), + ], + dirty: true + ) + ]), true); + } + }); + }); + + group('CodeLines getter ', () { + test('`first` and `last`', () { + { + final CodeLines codeLines = CodeLines.empty(); + expect(() => codeLines.first, throwsA(isA())); + expect(() => codeLines.last, throwsA(isA())); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc') + ]); + expect(codeLines.first, const CodeLine('abc')); + expect(codeLines.last, const CodeLine('abc')); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ]); + expect(codeLines.first, const CodeLine('abc')); + expect(codeLines.last, const CodeLine('bar')); + } + { + final CodeLines codeLines = CodeLines.of(List.generate(3000, (index) => CodeLine('$index'))); + expect(codeLines.first, const CodeLine('0')); + expect(codeLines.last, const CodeLine('2999')); + } + }); + + test('`length`', () { + { + final CodeLines codeLines = CodeLines.empty(); + expect(codeLines.length, 0); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc') + ]); + expect(codeLines.length, 1); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ]); + expect(codeLines.length, 3); + } + { + final CodeLines codeLines = CodeLines.of(List.generate(3000, (index) => CodeLine('$index'))); + expect(codeLines.length, 3000); + } + }); + + test('`isEmpty` and `isNotEmpty`', () { + { + final CodeLines codeLines = CodeLines.empty(); + expect(codeLines.isEmpty, true); + expect(codeLines.isNotEmpty, false); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc') + ]); + expect(codeLines.isEmpty, false); + expect(codeLines.isNotEmpty, true); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ]); + expect(codeLines.isEmpty, false); + expect(codeLines.isNotEmpty, true); + } + { + final CodeLines codeLines = CodeLines.of(List.generate(3000, (index) => CodeLine('$index'))); + expect(codeLines.isEmpty, false); + expect(codeLines.isNotEmpty, true); + } + }); + + test('`lineCount`', () { + { + final CodeLines codeLines = CodeLines.empty(); + expect(codeLines.lineCount, 0); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc') + ]); + expect(codeLines.lineCount, 1); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ]); + expect(codeLines.lineCount, 3); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('123'), + CodeLine('456'), + CodeLine('789'), + ]), + CodeLine('foo', [ + CodeLine('123'), + CodeLine('456'), + CodeLine('789'), + ]), + CodeLine('bar', [ + CodeLine('123'), + CodeLine('456'), + CodeLine('789'), + ]) + ]); + expect(codeLines.lineCount, 12); + } + { + final CodeLines codeLines = CodeLines.of(List.generate(3000, (index) => CodeLine('$index'))); + expect(codeLines.lineCount, 3000); + } + }); + }); + + group('CodeLines operator ', () { + test('`[]`', () { + { + final CodeLines codeLines = CodeLines.empty(); + expect(() => codeLines[0], throwsA(isA())); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc') + ]); + expect(codeLines[0], const CodeLine('abc')); + expect(() => codeLines[1], throwsA(isA())); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ]); + expect(codeLines[0], const CodeLine('abc')); + expect(codeLines[1], const CodeLine('foo')); + expect(codeLines[2], const CodeLine('bar')); + expect(() => codeLines[3], throwsA(isA())); + } + { + final CodeLines codeLines = CodeLines.of(List.generate(3000, (index) => CodeLine('$index'))); + expect(codeLines[0], const CodeLine('0')); + expect(codeLines[1024], const CodeLine('1024')); + expect(codeLines[2047], const CodeLine('2047')); + expect(codeLines[2999], const CodeLine('2999')); + expect(() => codeLines[3000], throwsA(isA())); + } + }); + + test('`[]=`', () { + { + final CodeLines codeLines = CodeLines.empty(); + expect(() => codeLines[0] = const CodeLine('abc'), throwsA(isA())); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc') + ]); + codeLines[0] = const CodeLine('foo'); + expect(codeLines[0], const CodeLine('foo')); + expect(() => codeLines[1] = const CodeLine('abc'), throwsA(isA())); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ]); + codeLines[0] = const CodeLine('123'); + expect(codeLines[0], const CodeLine('123')); + codeLines[1] = const CodeLine('456'); + expect(codeLines[1], const CodeLine('456')); + codeLines[2] = const CodeLine('789'); + expect(codeLines[2], const CodeLine('789')); + } + { + final CodeLines codeLines = CodeLines.of(List.generate(3000, (index) => CodeLine('$index'))); + codeLines[0] = const CodeLine('a'); + expect(codeLines[0], const CodeLine('a')); + codeLines[1024] = const CodeLine('b'); + expect(codeLines[1024], const CodeLine('b')); + codeLines[2047] = const CodeLine('c'); + expect(codeLines[2047], const CodeLine('c')); + codeLines[2999] = const CodeLine('d'); + expect(codeLines[2999], const CodeLine('d')); + } + { + final CodeLines codeLines = CodeLines([ + CodeLineSegment( + codeLines: List.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ]), + dirty: true + ) + ]); + codeLines[0] = const CodeLine('a'); + expect(codeLines.segments.last.dirty, false); + } + { + final CodeLines codeLines = CodeLines([ + CodeLineSegment( + codeLines: List.generate(1024, (index) => CodeLine('$index')), + dirty: true + ) + ]); + codeLines[1023] = const CodeLine('a'); + expect(codeLines[1023], const CodeLine('a')); + expect(codeLines.segments.last.dirty, false); + } + }); + + test('`==`', () { + expect(CodeLines.empty() == CodeLines.empty(), true); + expect(CodeLines.empty() == CodeLines.of(const [ + CodeLine('abc') + ]), false); + expect(CodeLines.of(const [ + CodeLine('abc') + ]) == CodeLines.of(const [ + CodeLine('abc') + ]), true); + expect(CodeLines.of(const [ + CodeLine('foo') + ]) == CodeLines.of(const [ + CodeLine('abc') + ]), false); + expect(const CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('abc') + ] + ) + ]) == const CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('abc') + ] + ) + ]), true); + expect(const CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('abc') + ] + ), + CodeLineSegment( + codeLines: [ + CodeLine('foo') + ] + ), + CodeLineSegment( + codeLines: [ + CodeLine('bar') + ] + ) + ]) == const CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('abc') + ] + ), + CodeLineSegment( + codeLines: [ + CodeLine('foo') + ] + ), + CodeLineSegment( + codeLines: [ + CodeLine('bar') + ] + ) + ]), true); + expect(const CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('abc') + ], + dirty: true + ), + CodeLineSegment( + codeLines: [ + CodeLine('foo') + ] + ), + CodeLineSegment( + codeLines: [ + CodeLine('bar') + ] + ) + ]) == const CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('abc') + ] + ), + CodeLineSegment( + codeLines: [ + CodeLine('foo') + ] + ), + CodeLineSegment( + codeLines: [ + CodeLine('bar') + ] + ) + ]), false); + }); + }); + + group('CodeLines method ', () { + test('`add()`', () { + { + final CodeLines codeLines = CodeLines.empty(); + codeLines.add(const CodeLine('abc')); + expect(codeLines.length, 1); + expect(codeLines.first, const CodeLine('abc')); + expect(codeLines.last, const CodeLine('abc')); + codeLines.add(const CodeLine('foo')); + expect(codeLines.length, 2); + expect(codeLines.first, const CodeLine('abc')); + expect(codeLines.last, const CodeLine('foo')); + codeLines.add(const CodeLine('bar')); + expect(codeLines.length, 3); + expect(codeLines.first, const CodeLine('abc')); + expect(codeLines.last, const CodeLine('bar')); + } + { + final CodeLines codeLines = CodeLines.of(List.generate(1024, (index) => CodeLine('$index'))); + codeLines.add(const CodeLine('abc')); + expect(codeLines.length, 1025); + expect(codeLines.last, const CodeLine('abc')); + expect(codeLines.segments.length, 5); + expect(codeLines.segments.last, const CodeLineSegment( + codeLines: [ + CodeLine('abc') + ] + )); + } + { + final CodeLines codeLines = CodeLines([ + CodeLineSegment( + codeLines: List.of(const [ + CodeLine('abc') + ]), + dirty: true + ) + ]); + codeLines.add(const CodeLine('foo')); + codeLines.add(const CodeLine('bar')); + expect(codeLines.length, 3); + expect(codeLines.first, const CodeLine('abc')); + expect(codeLines.last, const CodeLine('bar')); + expect(codeLines.segments.last.dirty, false); + } + }); + + test('`addAll()`', () { + { + final CodeLines codeLines = CodeLines.empty(); + codeLines.addAll(const [ + CodeLine('abc') + ]); + expect(codeLines.length, 1); + expect(codeLines.first, const CodeLine('abc')); + expect(codeLines.last, const CodeLine('abc')); + codeLines.addAll(const [ + CodeLine('foo'), + CodeLine('bar') + ]); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc') + ]); + codeLines.addAll(List.generate(512, (index) => CodeLine('$index'))); + expect(codeLines.length, 513); + expect(codeLines.last, const CodeLine('511')); + expect(codeLines.segments.length, 3); + expect(codeLines.segments[0].length, 256); + expect(codeLines.segments[1].length, 256); + expect(codeLines.segments[2].length, 1); + } + { + final CodeLines codeLines = CodeLines([ + CodeLineSegment( + codeLines: List.of(const [ + CodeLine('abc') + ]), + dirty: true + ) + ]); + codeLines.addAll(List.generate(512, (index) => CodeLine('$index'))); + expect(codeLines.length, 513); + expect(codeLines.last, const CodeLine('511')); + expect(codeLines.segments.length, 3); + expect(codeLines.segments[0].length, 256); + expect(codeLines.segments[0].dirty, false); + expect(codeLines.segments[1].length, 256); + expect(codeLines.segments[1].dirty, false); + expect(codeLines.segments[2].length, 1); + expect(codeLines.segments[2].dirty, false); + } + }); + + test('`addFrom()`', () { + { + final CodeLines codeLines1 = CodeLines.empty(); + final CodeLines codeLines2 = CodeLines.of(const [ + CodeLine('abc') + ]); + codeLines1.addFrom(codeLines2, 0); + expect(listEquals(codeLines1.segments, const [ + CodeLineSegment( + codeLines: [ + CodeLine('abc') + ], + dirty: true + ) + ]), true); + } + { + const CodeLines codeLines1 = CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ], + ) + ]); + final CodeLines codeLines2 = CodeLines([ + CodeLineSegment( + codeLines: List.of([ + const CodeLine('123'), + ]), + ) + ]); + codeLines2.addFrom(codeLines1, 1, 2); + expect(listEquals(codeLines2.segments, const [ + CodeLineSegment( + codeLines: [ + CodeLine('123'), + CodeLine('foo') + ], + ), + ]), true); + codeLines2.addFrom(codeLines1, 0); + expect(listEquals(codeLines2.segments, const [ + CodeLineSegment( + codeLines: [ + CodeLine('123'), + CodeLine('foo'), + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ], + ), + ]), true); + } + { + final CodeLines codeLines1 = CodeLines.of(const [ + CodeLine('abc') + ]); + final CodeLines codeLines2 = CodeLines.of(List.generate(512, (index) => CodeLine('$index'))); + codeLines1.addFrom(codeLines2, 0); + expect(listEquals(codeLines1.segments, [ + const CodeLineSegment( + codeLines: [ + CodeLine('abc') + ], + ), + CodeLineSegment( + codeLines: List.generate(256, (index) => CodeLine('$index')), + dirty: true + ), + CodeLineSegment( + codeLines: List.generate(256, (index) => CodeLine('${index + 256}')), + dirty: true + ), + ]), true); + } + { + final CodeLines codeLines1 = CodeLines.of(const [ + CodeLine('abc') + ]); + final CodeLines codeLines2 = CodeLines([ + const CodeLineSegment( + codeLines: [ + CodeLine('foo') + ], + ), + const CodeLineSegment( + codeLines: [ + CodeLine('bar') + ], + ), + CodeLineSegment( + codeLines: List.generate(256, (index) => CodeLine('$index')), + ), + const CodeLineSegment( + codeLines: [ + CodeLine('abc') + ], + ), + ]); + codeLines1.addFrom(codeLines2, 0); + expect(listEquals(codeLines1.segments, [ + const CodeLineSegment( + codeLines: [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ], + ), + CodeLineSegment( + codeLines: List.generate(256, (index) => CodeLine('$index')), + dirty: true + ), + const CodeLineSegment( + codeLines: [ + CodeLine('abc') + ], + dirty: true + ), + ]), true); + } + }); + + test('`asString`', () { + { + final CodeLines codeLines = CodeLines.empty(); + expect(codeLines.asString(TextLineBreak.lf), ''); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc') + ]); + expect(codeLines.asString(TextLineBreak.lf), 'abc'); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ]); + expect(codeLines.asString(TextLineBreak.lf), 'abc\nfoo\nbar'); + expect(codeLines.asString(TextLineBreak.crlf), 'abc\r\nfoo\r\nbar'); + expect(codeLines.asString(TextLineBreak.cr), 'abc\rfoo\rbar'); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('123'), + CodeLine('456'), + CodeLine('789'), + ]), + CodeLine('foo', [ + CodeLine('123'), + CodeLine('456'), + CodeLine('789'), + ]), + CodeLine('bar', [ + CodeLine('123'), + CodeLine('456'), + CodeLine('789'), + ]) + ]); + expect(codeLines.asString(TextLineBreak.lf), 'abc\n123\n456\n789\nfoo\n123\n456\n789\nbar\n123\n456\n789'); + expect(codeLines.asString(TextLineBreak.crlf), 'abc\r\n123\r\n456\r\n789\r\nfoo\r\n123\r\n456\r\n789\r\nbar\r\n123\r\n456\r\n789'); + expect(codeLines.asString(TextLineBreak.cr), 'abc\r123\r456\r789\rfoo\r123\r456\r789\rbar\r123\r456\r789'); + expect(codeLines.asString(TextLineBreak.lf, false), 'abc\nfoo\nbar'); + } + }); + + test('`equals()`', () { + expect(CodeLines.empty().equals(CodeLines.empty()), true); + expect(CodeLines.empty().equals(CodeLines.of(const [ + CodeLine('abc') + ])), false); + expect(CodeLines.of(const [ + CodeLine('abc') + ]).equals(CodeLines.empty()), false); + expect(CodeLines.of(const [ + CodeLine('abc') + ]).equals(CodeLines.of(const [ + CodeLine('abc') + ])), true); + expect(CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ]).equals(CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ])), true); + expect(CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ]).equals(CodeLines.of(const [ + CodeLine('abc'), + CodeLine('bar'), + CodeLine('foo'), + ])), false); + expect(const CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('abc'), + ], + ), + CodeLineSegment( + codeLines: [ + CodeLine('foo'), + ], + ), + CodeLineSegment( + codeLines: [ + CodeLine('bar'), + ], + ) + ]).equals(CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ])), true); + }); + + test('`sublines()`', () { + { + final CodeLines codeLines = CodeLines.empty(); + expect(codeLines.sublines(0), CodeLines.empty()); + expect(() => codeLines.sublines(1), throwsA(isA())); + expect(() => codeLines.sublines(0, 1), throwsA(isA())); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc') + ]); + expect(codeLines.sublines(0).equals(codeLines), true); + expect(codeLines.sublines(0) != codeLines, true); + expect(codeLines.sublines(1), CodeLines.empty()); + expect(codeLines.sublines(0, 1).equals(codeLines), true); + expect(codeLines.sublines(0, 1) != codeLines, true); + expect(() => codeLines.sublines(2), throwsA(isA())); + expect(() => codeLines.sublines(0, 2), throwsA(isA())); + expect(() => codeLines.sublines(1, 2), throwsA(isA())); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ]); + expect(codeLines.sublines(0).equals(codeLines), true); + expect(codeLines.sublines(0) != codeLines, true); + expect(codeLines.sublines(1), const CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('foo'), + CodeLine('bar') + ], + ) + ])); + expect(codeLines.sublines(0, 1), const CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('abc'), + ], + ) + ])); + expect(codeLines.sublines(0, 2), const CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('abc'), + CodeLine('foo'), + ], + ) + ])); + expect(codeLines.sublines(1, 2), const CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('foo'), + ], + ) + ])); + expect(codeLines.sublines(2, 3), const CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('bar'), + ], + ) + ])); + expect(codeLines.sublines(0, 3), const CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ], + dirty: true + ) + ])); + expect(() => codeLines.sublines(4), throwsA(isA())); + } + { + final CodeLines codeLines = CodeLines.of(List.generate(3000, (index) => CodeLine('$index'))); + expect(codeLines.sublines(512, 1024 + 512), CodeLines([ + CodeLineSegment( + codeLines: List.generate(256, (index) => CodeLine('${index + 512}')), + dirty: true + ), + CodeLineSegment( + codeLines: List.generate(256, (index) => CodeLine('${index + 512 + 256 * 1}')), + dirty: true + ), + CodeLineSegment( + codeLines: List.generate(256, (index) => CodeLine('${index + 512 + 256 * 2}')), + dirty: true + ), + CodeLineSegment( + codeLines: List.generate(256, (index) => CodeLine('${index + 512 + 256 * 3}')), + dirty: true + ) + ])); + expect(codeLines.sublines(512, 2048 + 512), CodeLines([ + CodeLineSegment( + codeLines: List.generate(256, (index) => CodeLine('${index + 512}')), + dirty: true + ), + CodeLineSegment( + codeLines: List.generate(256, (index) => CodeLine('${index + 512 + 256 * 1}')), + dirty: true + ), + CodeLineSegment( + codeLines: List.generate(256, (index) => CodeLine('${index + 512 + 256 * 2}')), + dirty: true + ), + CodeLineSegment( + codeLines: List.generate(256, (index) => CodeLine('${index + 512 + 256 * 3}')), + dirty: true + ), + CodeLineSegment( + codeLines: List.generate(256, (index) => CodeLine('${index + 512 + 256 * 4}')), + dirty: true + ), + CodeLineSegment( + codeLines: List.generate(256, (index) => CodeLine('${index + 512 + 256 * 5}')), + dirty: true + ), + CodeLineSegment( + codeLines: List.generate(256, (index) => CodeLine('${index + 512 + 256 * 6}')), + dirty: true + ), + CodeLineSegment( + codeLines: List.generate(256, (index) => CodeLine('${index + 512 + 256 * 7}')), + dirty: true + ) + ])); + } + }); + + test('`clear()`', () { + { + final CodeLines codeLines = CodeLines.empty(); + codeLines.clear(); + expect(codeLines.isEmpty, true); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc') + ]); + codeLines.clear(); + expect(codeLines.isEmpty, true); + } + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar') + ]); + codeLines.clear(); + expect(codeLines.isEmpty, true); + } + }); + + test('`index2lineIndex()`', () { + // Single code line + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc') + ]); + expect(codeLines.index2lineIndex(0), 0); + expect(codeLines.index2lineIndex(1), -1); + expect(codeLines.index2lineIndex(-1), -1); + } + // Multi code lines + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]); + expect(codeLines.index2lineIndex(0), 0); + expect(codeLines.index2lineIndex(1), 1); + expect(codeLines.index2lineIndex(2), 2); + } + // Multi code lines in different segments + { + const CodeLines codeLines = CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('abc'), + ], + ), + CodeLineSegment( + codeLines: [ + CodeLine('foo'), + ], + ), + CodeLineSegment( + codeLines: [ + CodeLine('bar') + ], + ) + ]); + expect(codeLines.index2lineIndex(0), 0); + expect(codeLines.index2lineIndex(1), 1); + expect(codeLines.index2lineIndex(2), 2); + } + // Multi code lines with collapsed chunks + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('{', [ + CodeLine(' "start": "foo",'), + CodeLine(' "abc": [', [ + CodeLine(' 0,'), + CodeLine(' 1,'), + CodeLine(' 2,'), + ]), + CodeLine(' ],'), + CodeLine(' "end": "bar"'), + ]), + CodeLine('}'), + ]); + expect(codeLines.index2lineIndex(0), 0); + expect(codeLines.index2lineIndex(1), 8); + } + }); + + test('`lineIndex2index()`', () { + // Single code line + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc') + ]); + expect(codeLines.lineIndex2Index(0), const CodeLineIndex(0, -1)); + expect(codeLines.lineIndex2Index(1), const CodeLineIndex(-1, -1)); + expect(codeLines.lineIndex2Index(-1), const CodeLineIndex(-1, -1)); + } + // Multi code lines + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ]); + expect(codeLines.lineIndex2Index(0), const CodeLineIndex(0, -1)); + expect(codeLines.lineIndex2Index(1), const CodeLineIndex(1, -1)); + expect(codeLines.lineIndex2Index(2), const CodeLineIndex(2, -1)); + } + // Multi code lines in different segments + { + const CodeLines codeLines = CodeLines([ + CodeLineSegment( + codeLines: [ + CodeLine('abc'), + ], + ), + CodeLineSegment( + codeLines: [ + CodeLine('foo'), + ], + ), + CodeLineSegment( + codeLines: [ + CodeLine('bar') + ], + ) + ]); + expect(codeLines.lineIndex2Index(0), const CodeLineIndex(0, -1)); + expect(codeLines.lineIndex2Index(1), const CodeLineIndex(1, -1)); + expect(codeLines.lineIndex2Index(2), const CodeLineIndex(2, -1)); + } + // Multi code lines with collapsed chunks + { + final CodeLines codeLines = CodeLines.of(const [ + CodeLine('{', [ + CodeLine(' "start": "foo",'), + CodeLine(' "abc": [', [ + CodeLine(' 0,'), + CodeLine(' 1,'), + CodeLine(' 2,'), + ]), + CodeLine(' ],'), + CodeLine(' "end": "bar"'), + ]), + CodeLine('}'), + ]); + expect(codeLines.lineIndex2Index(0), const CodeLineIndex(0, -1)); + expect(codeLines.lineIndex2Index(1), const CodeLineIndex(0, 0)); + expect(codeLines.lineIndex2Index(2), const CodeLineIndex(0, 1)); + expect(codeLines.lineIndex2Index(3), const CodeLineIndex(0, 1)); + expect(codeLines.lineIndex2Index(6), const CodeLineIndex(0, 2)); + expect(codeLines.lineIndex2Index(8), const CodeLineIndex(1, -1)); + } + }); + }); + +} \ No newline at end of file diff --git a/packages/re_editor/test/code_search_controller_test.dart b/packages/re_editor/test/code_search_controller_test.dart new file mode 100644 index 0000000..ba6df0d --- /dev/null +++ b/packages/re_editor/test/code_search_controller_test.dart @@ -0,0 +1,986 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_test/flutter_test.dart'; +import 'package:re_editor/re_editor.dart'; + +void main() { + group('CodeFindController getter ', () { + test('`allMatchSelections`', () async { + { + final CodeFindController controller = CodeFindController(CodeLineEditingController()); + expect(controller.allMatchSelections, null); + controller.close(); + } + { + final CodeFindController controller = CodeFindController(CodeLineEditingController.fromText('abc'), const CodeFindValue( + option: CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false + ), + replaceMode: false + )); + expect(controller.allMatchSelections, null); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.allMatchSelections, const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1 + ) + ]); + controller.close(); + } + { + final CodeFindController controller = CodeFindController(CodeLineEditingController.fromText('abc\nfoo\nbar'), const CodeFindValue( + option: CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false + ), + replaceMode: false + )); + expect(controller.allMatchSelections, null); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.allMatchSelections, const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ) + ]); + controller.close(); + } + { + final CodeFindController controller = CodeFindController(CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]) + ]) + ), const CodeFindValue( + option: CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false + ), + replaceMode: false + )); + expect(controller.allMatchSelections, null); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.allMatchSelections, const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 0, + extentIndex: 1, + extentOffset: 1 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 0, + extentIndex: 2, + extentOffset: 1 + ), + ]); + controller.close(); + } + }); + + test('`currentMatchSelection`', () async { + { + final CodeFindController controller = CodeFindController(CodeLineEditingController()); + expect(controller.currentMatchSelection, null); + controller.close(); + } + { + final CodeFindController controller = CodeFindController(CodeLineEditingController.fromText('abc'), const CodeFindValue( + option: CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false + ), + replaceMode: false + )); + expect(controller.currentMatchSelection, null); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.currentMatchSelection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1 + )); + controller.close(); + } + { + final CodeFindController controller = CodeFindController(CodeLineEditingController.fromText('abc\nfoo\nbar'), const CodeFindValue( + option: CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false + ), + replaceMode: false + )); + expect(controller.currentMatchSelection, null); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.currentMatchSelection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1 + )); + controller.nextMatch(); + expect(controller.currentMatchSelection, const CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + )); + controller.close(); + } + { + final CodeFindController controller = CodeFindController(CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]) + ]) + ), const CodeFindValue( + option: CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false + ), + replaceMode: false + )); + expect(controller.currentMatchSelection, null); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.currentMatchSelection, const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1 + )); + } + }); + }); + + group('CodeFindController method ', () { + test('`findMode`', () async { + { + final CodeFindController controller = CodeFindController(CodeLineEditingController.fromText('abc')); + expect(controller.value, null); + controller.findMode(); + expect(controller.value, const CodeFindValue( + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false + ), + replaceMode: false + )); + } + { + final CodeLineEditingController editingController = CodeLineEditingController.fromText('abc'); + editingController.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ); + final CodeFindController controller = CodeFindController(editingController); + expect(controller.value, null); + controller.findMode(); + expect(controller.value, const CodeFindValue( + option: CodeFindOption( + pattern: 'b', + caseSensitive: false, + regex: false + ), + replaceMode: false, + searching: true + )); + expect(controller.findInputController.text, 'b'); + expect(controller.findInputController.selection, const TextSelection( + baseOffset: 0, + extentOffset: 1 + )); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.value, CodeFindValue( + option: const CodeFindOption( + pattern: 'b', + caseSensitive: false, + regex: false + ), + replaceMode: false, + result: CodeFindResult( + index: 0, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ) + ], + option: const CodeFindOption( + pattern: 'b', + caseSensitive: false, + regex: false + ), + codeLines: CodeLines.of([ + const CodeLine('abc') + ]), + dirty: false + ) + )); + } + }); + + test('`replaceMode`', () async { + { + final CodeFindController controller = CodeFindController(CodeLineEditingController.fromText('abc')); + expect(controller.value, null); + controller.replaceMode(); + expect(controller.value, const CodeFindValue( + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false + ), + replaceMode: true, + )); + } + { + final CodeLineEditingController editingController = CodeLineEditingController.fromText('abc'); + editingController.selection = const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ); + final CodeFindController controller = CodeFindController(editingController); + expect(controller.value, null); + controller.replaceMode(); + expect(controller.value, const CodeFindValue( + option: CodeFindOption( + pattern: 'b', + caseSensitive: false, + regex: false + ), + replaceMode: true, + searching: true + )); + expect(controller.findInputController.text, 'b'); + expect(controller.findInputController.selection, const TextSelection( + baseOffset: 0, + extentOffset: 1 + )); + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.value, CodeFindValue( + option: const CodeFindOption( + pattern: 'b', + caseSensitive: false, + regex: false + ), + replaceMode: true, + result: CodeFindResult( + index: 0, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ) + ], + option: const CodeFindOption( + pattern: 'b', + caseSensitive: false, + regex: false + ), + codeLines: CodeLines.of([ + const CodeLine('abc') + ]), + dirty: false + ) + )); + } + }); + + test('`focusOnFindInput`', () { + final CodeFindController controller = CodeFindController(CodeLineEditingController()); + controller.findInputController.text = 'abc'; + controller.focusOnFindInput(); + expect(controller.findInputController.selection, const TextSelection( + baseOffset: 0, + extentOffset: 3 + )); + }); + + test('`focusOnReplaceInput`', () { + final CodeFindController controller = CodeFindController(CodeLineEditingController()); + controller.replaceInputController.text = 'abc'; + controller.focusOnReplaceInput(); + expect(controller.replaceInputController.selection, const TextSelection( + baseOffset: 0, + extentOffset: 3 + )); + }); + + test('`toggleMode`', () { + final CodeFindController controller = CodeFindController(CodeLineEditingController.fromText('abc')); + controller.findMode(); + expect(controller.value?.replaceMode, false); + controller.toggleMode(); + expect(controller.value?.replaceMode, true); + controller.toggleMode(); + expect(controller.value?.replaceMode, false); + controller.toggleMode(); + expect(controller.value?.replaceMode, true); + }); + + test('`close`', () { + final CodeFindController controller = CodeFindController(CodeLineEditingController.fromText('abc')); + controller.findMode(); + expect(controller.value != null, true); + controller.close(); + expect(controller.value != null, false); + controller.findMode(); + expect(controller.value != null, true); + controller.close(); + expect(controller.value != null, false); + }); + + test('`toggleRegex`', () { + final CodeFindController controller = CodeFindController(CodeLineEditingController.fromText('abc')); + controller.findMode(); + expect(controller.value?.option.regex, false); + controller.toggleRegex(); + expect(controller.value?.option.regex, true); + controller.toggleRegex(); + expect(controller.value?.option.regex, false); + controller.toggleRegex(); + expect(controller.value?.option.regex, true); + }); + + test('`toggleCaseSensitive`', () { + final CodeFindController controller = CodeFindController(CodeLineEditingController.fromText('abc')); + controller.findMode(); + expect(controller.value?.option.caseSensitive, false); + controller.toggleCaseSensitive(); + expect(controller.value?.option.caseSensitive, true); + controller.toggleCaseSensitive(); + expect(controller.value?.option.caseSensitive, false); + controller.toggleCaseSensitive(); + expect(controller.value?.option.caseSensitive, true); + }); + + test('`previousMatch & nextMatch`', () async { + { + final CodeFindController controller = CodeFindController(CodeLineEditingController.fromText('abcabcabc')); + controller.findMode(); + controller.findInputController.text = 'a'; + await Future.delayed(const Duration(milliseconds: 200)); + expect(controller.value, CodeFindValue( + option: const CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false + ), + replaceMode: false, + result: CodeFindResult( + index: 0, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1 + ), + CodeLineSelection( + baseIndex: 0, + baseOffset: 3, + extentIndex: 0, + extentOffset: 4 + ), + CodeLineSelection( + baseIndex: 0, + baseOffset: 6, + extentIndex: 0, + extentOffset: 7 + ) + ], + option: const CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false + ), + codeLines: CodeLines.of([ + const CodeLine('abcabcabc') + ]), + dirty: false + ) + )); + controller.previousMatch(); + expect(controller.value, CodeFindValue( + option: const CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false + ), + replaceMode: false, + result: CodeFindResult( + index: 2, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1 + ), + CodeLineSelection( + baseIndex: 0, + baseOffset: 3, + extentIndex: 0, + extentOffset: 4 + ), + CodeLineSelection( + baseIndex: 0, + baseOffset: 6, + extentIndex: 0, + extentOffset: 7 + ) + ], + option: const CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false + ), + codeLines: CodeLines.of([ + const CodeLine('abcabcabc') + ]), + dirty: false + ) + )); + controller.previousMatch(); + expect(controller.value, CodeFindValue( + option: const CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false + ), + replaceMode: false, + result: CodeFindResult( + index: 1, + matches: [ + const CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1 + ), + const CodeLineSelection( + baseIndex: 0, + baseOffset: 3, + extentIndex: 0, + extentOffset: 4 + ), + const CodeLineSelection( + baseIndex: 0, + baseOffset: 6, + extentIndex: 0, + extentOffset: 7 + ) + ], + option: const CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false + ), + codeLines: CodeLines.of([ + const CodeLine('abcabcabc') + ]), + dirty: false + ) + )); + controller.nextMatch(); + expect(controller.value, CodeFindValue( + option: const CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false + ), + replaceMode: false, + result: CodeFindResult( + index: 2, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1 + ), + CodeLineSelection( + baseIndex: 0, + baseOffset: 3, + extentIndex: 0, + extentOffset: 4 + ), + CodeLineSelection( + baseIndex: 0, + baseOffset: 6, + extentIndex: 0, + extentOffset: 7 + ) + ], + option: const CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false + ), + codeLines: CodeLines.of(const [ + CodeLine('abcabcabc') + ]), + dirty: false + ) + )); + controller.nextMatch(); + expect(controller.value, CodeFindValue( + option: const CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false + ), + replaceMode: false, + result: CodeFindResult( + index: 0, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 0, + extentIndex: 0, + extentOffset: 1 + ), + CodeLineSelection( + baseIndex: 0, + baseOffset: 3, + extentIndex: 0, + extentOffset: 4 + ), + CodeLineSelection( + baseIndex: 0, + baseOffset: 6, + extentIndex: 0, + extentOffset: 7 + ) + ], + option: const CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false + ), + codeLines: CodeLines.of(const [ + CodeLine('abcabcabc') + ]), + dirty: false + ) + )); + } + // Test auto expand chubnk + { + final CodeLineEditingController editingController = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]) + ] + )); + final CodeFindController controller = CodeFindController(editingController); + controller.findMode(); + controller.findInputController.text = 'a'; + await Future.delayed(const Duration(milliseconds: 200)); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]) + ])); + controller.nextMatch(); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]) + ])); + controller.nextMatch(); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]) + ])); + controller.previousMatch(); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]) + ])); + controller.previousMatch(); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]) + ])); + controller.previousMatch(); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar'), + ]), + CodeLine('abc'), + CodeLine('foo'), + CodeLine('bar'), + ])); + } + }); + + test('`replaceMatch`', () async { + { + final CodeLineEditingController editingController = CodeLineEditingController.fromText('abcabcabc'); + final CodeFindController controller = CodeFindController(editingController); + controller.replaceMode(); + controller.findInputController.text = 'a'; + controller.replaceInputController.text = 'b'; + await Future.delayed(const Duration(milliseconds: 200)); + controller.replaceMatch(); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('bbcabcabc') + ])); + await Future.delayed(const Duration(milliseconds: 200)); + controller.replaceMatch(); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('bbcbbcabc') + ])); + await Future.delayed(const Duration(milliseconds: 200)); + controller.replaceMatch(); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('bbcbbcbbc') + ])); + } + // replace with same text + { + final CodeLineEditingController editingController = CodeLineEditingController.fromText('abcabcabc'); + final CodeFindController controller = CodeFindController(editingController); + controller.replaceMode(); + controller.findInputController.text = 'a'; + controller.replaceInputController.text = 'a'; + await Future.delayed(const Duration(milliseconds: 200)); + controller.replaceMatch(); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('abcabcabc') + ])); + expect(editingController.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 1 + )); + expect(controller.value?.result?.index, 1); + expect(controller.value?.result?.dirty, false); + await Future.delayed(const Duration(milliseconds: 200)); + controller.replaceMatch(); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('abcabcabc') + ])); + expect(editingController.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 4 + )); + expect(controller.value?.result?.index, 2); + expect(controller.value?.result?.dirty, false); + await Future.delayed(const Duration(milliseconds: 200)); + controller.replaceMatch(); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('abcabcabc') + ])); + expect(editingController.selection, const CodeLineSelection.collapsed( + index: 0, + offset: 7 + )); + expect(controller.value?.result?.index, 0); + expect(controller.value?.result?.dirty, false); + } + // Test code line chunks + { + final CodeLineEditingController editingController = CodeLineEditingController( + codeLines: CodeLines.of(const [ + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]) + ]) + ); + final CodeFindController controller = CodeFindController(editingController); + controller.replaceMode(); + controller.findInputController.text = 'a'; + controller.replaceInputController.text = 'b'; + await Future.delayed(const Duration(milliseconds: 200)); + controller.replaceMatch(); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('bbc'), + CodeLine('foo'), + CodeLine('bar'), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]) + ])); + await Future.delayed(const Duration(milliseconds: 200)); + controller.replaceMatch(); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('bbc'), + CodeLine('foo'), + CodeLine('bbr'), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]) + ])); + await Future.delayed(const Duration(milliseconds: 200)); + controller.replaceMatch(); + expect(editingController.codeLines, CodeLines.of(const [ + CodeLine('bbc'), + CodeLine('foo'), + CodeLine('bbr'), + CodeLine('bbc'), + CodeLine('foo'), + CodeLine('bar'), + CodeLine('abc', [ + CodeLine('foo'), + CodeLine('bar') + ]) + ])); + } + }); + }); + + group('CodeEditor ', () { + testWidgets('ignores notifications from a previous findController after swap', (tester) async { + final CodeLineEditingController editingController = CodeLineEditingController.fromText('abc'); + final CodeFindController oldFindController = CodeFindController(editingController); + final CodeFindController newFindController = CodeFindController(editingController); + int buildCount = 0; + CodeFindController? lastBuiltController; + + PreferredSizeWidget buildFindWidget( + BuildContext context, + CodeFindController controller, + bool readonly, + ) { + buildCount++; + lastBuiltController = controller; + return const PreferredSize( + preferredSize: Size.zero, + child: SizedBox.shrink(), + ); + } + + await tester.pumpWidget(MaterialApp( + home: CodeEditor( + controller: editingController, + findController: oldFindController, + findBuilder: buildFindWidget, + autofocus: false, + ), + )); + + expect(lastBuiltController, same(oldFindController)); + + await tester.pumpWidget(MaterialApp( + home: CodeEditor( + controller: editingController, + findController: newFindController, + findBuilder: buildFindWidget, + autofocus: false, + ), + )); + + expect(lastBuiltController, same(newFindController)); + final int buildCountAfterSwap = buildCount; + + oldFindController.findMode(); + await tester.pump(); + + expect(buildCount, buildCountAfterSwap); + expect(lastBuiltController, same(newFindController)); + + newFindController.findMode(); + await tester.pump(); + + expect(buildCount, greaterThan(buildCountAfterSwap)); + expect(lastBuiltController, same(newFindController)); + + await tester.pumpWidget(const MaterialApp(home: SizedBox.shrink())); + + oldFindController.dispose(); + newFindController.dispose(); + editingController.dispose(); + }); + + testWidgets('ignores stale findController notifications after the editor is removed', (tester) async { + final CodeLineEditingController editingController = CodeLineEditingController.fromText('abc'); + final CodeFindController oldFindController = CodeFindController(editingController); + final CodeFindController newFindController = CodeFindController(editingController); + + await tester.pumpWidget(MaterialApp( + home: CodeEditor( + controller: editingController, + findController: oldFindController, + autofocus: false, + ), + )); + + await tester.pumpWidget(MaterialApp( + home: CodeEditor( + controller: editingController, + findController: newFindController, + autofocus: false, + ), + )); + + await tester.pumpWidget(const MaterialApp(home: SizedBox.shrink())); + + oldFindController.findMode(); + await tester.pump(); + + expect(tester.takeException(), isNull); + + oldFindController.dispose(); + newFindController.dispose(); + editingController.dispose(); + }); + }); +} \ No newline at end of file diff --git a/packages/re_editor/test/code_search_option_test.dart b/packages/re_editor/test/code_search_option_test.dart new file mode 100644 index 0000000..c357f08 --- /dev/null +++ b/packages/re_editor/test/code_search_option_test.dart @@ -0,0 +1,121 @@ +import 'package:flutter_test/flutter_test.dart'; +import 'package:re_editor/re_editor.dart'; + +void main() { + group('CodeFindOption getter ', () { + test('`regExp`', () async { + { + const CodeFindOption option = CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false + ); + expect(option.regExp, RegExp('a', caseSensitive: false)); + } + { + const CodeFindOption option = CodeFindOption( + pattern: 'a', + caseSensitive: true, + regex: false + ); + expect(option.regExp, RegExp('a', caseSensitive: true)); + } + { + const CodeFindOption option = CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: true + ); + expect(option.regExp, RegExp('a', caseSensitive: false)); + } + { + const CodeFindOption option = CodeFindOption( + pattern: '*', + caseSensitive: false, + regex: false + ); + expect(option.regExp, RegExp('\\*', caseSensitive: false)); + } + }); + }); + group('CodeFindOption method ', () { + test('`copyWith`', () async { + const CodeFindOption option = CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false + ); + expect(option.copyWith(), option); + expect(option.copyWith( + pattern: 'a' + ), const CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false + )); + expect(option.copyWith( + caseSensitive: true, + ), const CodeFindOption( + pattern: '', + caseSensitive: true, + regex: false + )); + expect(option.copyWith( + regex: true, + ), const CodeFindOption( + pattern: '', + caseSensitive: false, + regex: true + )); + expect(option.copyWith( + pattern: 'abc', + caseSensitive: true, + regex: true + ), const CodeFindOption( + pattern: 'abc', + caseSensitive: true, + regex: true + )); + }); + }); + group('CodeFindOption operator ', () { + test('`==`', () async { + expect(const CodeFindOption( + pattern: 'a', + caseSensitive: true, + regex: true + ) == const CodeFindOption( + pattern: 'a', + caseSensitive: true, + regex: true + ), true); + expect(const CodeFindOption( + pattern: 'a', + caseSensitive: true, + regex: true + ) == const CodeFindOption( + pattern: 'b', + caseSensitive: true, + regex: true + ), false); + expect(const CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: true + ) == const CodeFindOption( + pattern: 'a', + caseSensitive: true, + regex: true + ), false); + expect(const CodeFindOption( + pattern: 'a', + caseSensitive: true, + regex: false + ) == const CodeFindOption( + pattern: 'a', + caseSensitive: true, + regex: true + ), false); + }); + }); +} \ No newline at end of file diff --git a/packages/re_editor/test/code_search_result_test.dart b/packages/re_editor/test/code_search_result_test.dart new file mode 100644 index 0000000..98b405a --- /dev/null +++ b/packages/re_editor/test/code_search_result_test.dart @@ -0,0 +1,661 @@ +import 'package:flutter_test/flutter_test.dart'; +import 'package:re_editor/re_editor.dart'; + +void main() { + group('CodeFindResult getter ', () { + test('`previous & next & current`', () async { + const CodeFindResult result = CodeFindResult( + index: 0, + matches: [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ) + ], + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines([]), + dirty: false + ); + expect(result.currentMatch, const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + )); + expect(result.next, result.copyWith( + index: 1 + )); + expect(result.next.currentMatch, const CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + )); + expect(result.next.next, result.copyWith( + index: 2 + )); + expect(result.next.next.currentMatch, const CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + )); + expect(result.next.next.next, result.copyWith( + index: 0 + )); + expect(result.next.next.next.currentMatch, const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + )); + expect(result.previous, result.copyWith( + index: 2 + )); + expect(result.previous.currentMatch, const CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + )); + expect(result.previous.previous, result.copyWith( + index: 1 + )); + expect(result.previous.previous.currentMatch, const CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + )); + expect(result.previous.previous.previous, result.copyWith( + index: 0 + )); + expect(result.previous.previous.previous.currentMatch, const CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + )); + }); + }); + + group('CodeFindResult method ', () { + test('`copyWith`', () async { + const CodeFindResult result = CodeFindResult( + index: 0, + matches: [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ) + ], + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines([]), + dirty: false + ); + expect(result.copyWith(), result); + expect(result.copyWith( + index: 1 + ), const CodeFindResult( + index: 1, + matches: [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ) + ], + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines([]), + dirty: false + )); + expect(result.copyWith( + matches: [] + ), const CodeFindResult( + index: 0, + matches: [], + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines([]), + dirty: false + )); + expect(result.copyWith( + option: const CodeFindOption( + pattern: 'a', + caseSensitive: true, + regex: true, + ), + ), const CodeFindResult( + index: 0, + matches: [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ) + ], + option: CodeFindOption( + pattern: 'a', + caseSensitive: true, + regex: true, + ), + codeLines: CodeLines([]), + dirty: false + )); + expect(result.copyWith( + codeLines: CodeLines.of([ + const CodeLine('abc') + ]) + ), CodeFindResult( + index: 0, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ) + ], + option: const CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines.of([ + const CodeLine('abc') + ]), + dirty: false + )); + expect(result.copyWith( + dirty: true + ), const CodeFindResult( + index: 0, + matches: [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ) + ], + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines([]), + dirty: true + )); + }); + }); + + group('CodeFindResult operator ', () { + test('`==`', () async { + expect(CodeFindResult( + index: 0, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ) + ], + option: const CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines.of([ + const CodeLine('abc') + ]), + dirty: true + ) == CodeFindResult( + index: 0, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ) + ], + option: const CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines.of([ + const CodeLine('abc') + ]), + dirty: true + ), true); + expect(CodeFindResult( + index: 1, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ) + ], + option: const CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines.of([ + const CodeLine('abc') + ]), + dirty: true + ) == CodeFindResult( + index: 0, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ) + ], + option: const CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines.of([ + const CodeLine('abc') + ]), + dirty: true + ), false); + expect(CodeFindResult( + index: 0, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ), + ], + option: const CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines.of([ + const CodeLine('abc') + ]), + dirty: true + ) == CodeFindResult( + index: 0, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ) + ], + option: const CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines.of([ + const CodeLine('abc') + ]), + dirty: true + ), false); + expect(CodeFindResult( + index: 0, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ) + ], + option: const CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines.of([ + const CodeLine('abc') + ]), + dirty: true + ) == CodeFindResult( + index: 0, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ) + ], + option: const CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines.of([ + const CodeLine('abc') + ]), + dirty: true + ), false); + expect(CodeFindResult( + index: 0, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ) + ], + option: const CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines.of([ + const CodeLine('a') + ]), + dirty: true + ) == CodeFindResult( + index: 0, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ) + ], + option: const CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines.of([ + const CodeLine('abc') + ]), + dirty: true + ), false); + expect(CodeFindResult( + index: 0, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ) + ], + option: const CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines.of([ + const CodeLine('abc') + ]), + dirty: true + ) == CodeFindResult( + index: 0, + matches: const [ + CodeLineSelection( + baseIndex: 0, + baseOffset: 1, + extentIndex: 0, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 1, + baseOffset: 1, + extentIndex: 1, + extentOffset: 2 + ), + CodeLineSelection( + baseIndex: 2, + baseOffset: 1, + extentIndex: 2, + extentOffset: 2 + ) + ], + option: const CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines.of([ + const CodeLine('abc') + ]), + dirty: false + ), false); + }); + }); +} \ No newline at end of file diff --git a/packages/re_editor/test/code_search_value_test.dart b/packages/re_editor/test/code_search_value_test.dart new file mode 100644 index 0000000..161f988 --- /dev/null +++ b/packages/re_editor/test/code_search_value_test.dart @@ -0,0 +1,221 @@ +import 'package:flutter_test/flutter_test.dart'; +import 'package:re_editor/re_editor.dart'; + +void main() { + group('CodeFindValue constructor ', () { + test('`empty`', () async { + const CodeFindValue value = CodeFindValue.empty(); + expect(value.option, const CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + )); + expect(value.replaceMode, false); + expect(value.result, null); + }); + }); + group('CodeFindValue method ', () { + test('`copyWith`', () async { + const CodeFindValue value = CodeFindValue.empty(); + { + final CodeFindValue newValue = value.copyWith( + result: CodeFindResult( + index: 0, + matches: [], + option: value.option, + codeLines: const CodeLines([]), + dirty: false + ) + ); + expect(newValue.result, CodeFindResult( + index: 0, + matches: [], + option: value.option, + codeLines: const CodeLines([]), + dirty: false + )); + expect(newValue.replaceMode, value.replaceMode); + expect(newValue.option, value.option); + } + { + final CodeFindValue newValue = value.copyWith( + replaceMode: true, + result: null + ); + expect(newValue.result, null); + expect(newValue.replaceMode, true); + expect(newValue.option, value.option); + } + { + final CodeFindValue newValue = value.copyWith( + option: const CodeFindOption( + pattern: 'a', + caseSensitive: true, + regex: true + ), + result: null + ); + expect(newValue.result, null); + expect(newValue.replaceMode, value.replaceMode); + expect(newValue.option, const CodeFindOption( + pattern: 'a', + caseSensitive: true, + regex: true + )); + } + + }); + }); + group('CodeFindValue operator ', () { + test('`==`', () async { + expect(const CodeFindValue( + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + replaceMode: false, + result: CodeFindResult( + index: 0, + matches: [], + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines([]), + dirty: false + ) + ) == const CodeFindValue( + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + replaceMode: false, + result: CodeFindResult( + index: 0, + matches: [], + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines([]), + dirty: false + ) + ), true); + expect(const CodeFindValue( + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + replaceMode: false, + result: CodeFindResult( + index: 0, + matches: [], + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines([]), + dirty: false + ) + ) == const CodeFindValue( + option: CodeFindOption( + pattern: 'a', + caseSensitive: false, + regex: false, + ), + replaceMode: false, + result: CodeFindResult( + index: 0, + matches: [], + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines([]), + dirty: false + ) + ), false); + expect(const CodeFindValue( + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + replaceMode: false, + result: CodeFindResult( + index: 0, + matches: [], + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines([]), + dirty: false + ) + ) == const CodeFindValue( + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + replaceMode: true, + result: CodeFindResult( + index: 0, + matches: [], + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines([]), + dirty: false + ) + ), false); + expect(const CodeFindValue( + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + replaceMode: false, + result: CodeFindResult( + index: 0, + matches: [], + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines([]), + dirty: false + ) + ) == const CodeFindValue( + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + replaceMode: false, + result: CodeFindResult( + index: 1, + matches: [], + option: CodeFindOption( + pattern: '', + caseSensitive: false, + regex: false, + ), + codeLines: CodeLines([]), + dirty: false + ) + ), false); + }); + }); +} \ No newline at end of file diff --git a/packages/re_editor/test/data/json_flatted.json b/packages/re_editor/test/data/json_flatted.json new file mode 100644 index 0000000..0c0a3f9 --- /dev/null +++ b/packages/re_editor/test/data/json_flatted.json @@ -0,0 +1 @@ +{"abc": {"foo": ["bar"]},"123": [{"foo": "bar","bar": "foo"},{"foo": "bar","bar": "foo"}],"foo": "bar"} \ No newline at end of file diff --git a/packages/re_editor/test/data/json_pretty.json b/packages/re_editor/test/data/json_pretty.json new file mode 100644 index 0000000..c62e53a --- /dev/null +++ b/packages/re_editor/test/data/json_pretty.json @@ -0,0 +1,18 @@ +{ + "abc": { + "foo": [ + "bar" + ] + }, + "123": [ + { + "foo": "bar", + "bar": "foo" + }, + { + "foo": "bar", + "bar": "foo" + } + ], + "foo": "bar" +} \ No newline at end of file diff --git a/pubspec.lock b/pubspec.lock index 105fb5c..add1e89 100644 --- a/pubspec.lock +++ b/pubspec.lock @@ -472,10 +472,9 @@ packages: re_editor: dependency: "direct main" description: - name: re_editor - sha256: "66671c4774a6b4c5254c9a53ab35a083e7e7da9ae371c519bcf491c70a2a4e56" - url: "https://pub.dev" - source: hosted + path: "packages/re_editor" + relative: true + source: path version: "0.10.0" re_highlight: dependency: "direct main" diff --git a/pubspec.yaml b/pubspec.yaml index 4386511..e63aac4 100644 --- a/pubspec.yaml +++ b/pubspec.yaml @@ -21,7 +21,8 @@ dependencies: path: ^1.9.0 file_picker: ^8.1.7 provider: ^6.1.2 - re_editor: ^0.10.0 + re_editor: + path: packages/re_editor re_highlight: ^0.0.3 permission_handler: ^13.0.2 path_provider: ^2.1.5 diff --git a/test/run_system_test.dart b/test/run_system_test.dart new file mode 100644 index 0000000..3e203a7 --- /dev/null +++ b/test/run_system_test.dart @@ -0,0 +1,82 @@ +import 'dart:io'; +import 'package:flutter_test/flutter_test.dart'; +import 'package:code_editor/models/run_task.dart'; +import 'package:code_editor/services/run_task_storage_service.dart'; +import 'package:code_editor/services/project_task_detector.dart'; + +void main() { + TestWidgetsFlutterBinding.ensureInitialized(); + + group('RunTask & RunTaskStorageService Tests', () { + late Directory tempDir; + late RunTaskStorageService storageService; + + setUp(() async { + tempDir = await Directory.systemTemp.createTemp('run_task_test_'); + storageService = RunTaskStorageService(); + }); + + tearDown(() async { + if (await tempDir.exists()) { + await tempDir.delete(recursive: true); + } + }); + + test('save and load custom tasks', () async { + final initialTasks = await storageService.loadTasks(tempDir.path); + expect(initialTasks, isEmpty); + + final customTask = const RunTask( + id: 'task_1', + name: 'Debug Build', + command: 'cmake -B build && cmake --build build', + source: TaskSource.custom, + description: 'Test description', + clearBeforeRun: true, + ); + + await storageService.saveTasks(tempDir.path, [customTask]); + + final loadedTasks = await storageService.loadTasks(tempDir.path); + expect(loadedTasks.length, 1); + expect(loadedTasks.first.id, 'task_1'); + expect(loadedTasks.first.name, 'Debug Build'); + expect(loadedTasks.first.command, 'cmake -B build && cmake --build build'); + expect(loadedTasks.first.source, TaskSource.custom); + + // 测试 lastRunTaskId 持久化与读取 + await storageService.saveConfig( + projectRoot: tempDir.path, + tasks: [customTask], + lastRunTaskId: 'task_1', + ); + final config = await storageService.loadConfig(tempDir.path); + expect(config.lastRunTaskId, 'task_1'); + expect(config.tasks.length, 1); + }); + + test('ProjectTaskDetector detects CMake and single file', () async { + // 模拟 CMakeLists.txt + final cmakeFile = File('${tempDir.path}/CMakeLists.txt'); + await cmakeFile.writeAsString('cmake_minimum_required(VERSION 3.10)'); + + // 模拟 main.py + final pyFile = File('${tempDir.path}/main.py'); + await pyFile.writeAsString('print("hello")'); + + final tasks = await ProjectTaskDetector.detect( + projectRoot: tempDir.path, + currentFilePath: pyFile.path, + ); + + expect(tasks.isNotEmpty, isTrue); + // 首项为当前打开的 Python 文件单文件任务 + expect(tasks.first.id, 'detected_single_python'); + expect(tasks.first.command, contains('python3')); + + // 包含 CMake 相关构建任务 + expect(tasks.any((t) => t.id == 'detected_cmake_build_run'), isTrue); + expect(tasks.any((t) => t.id == 'detected_cmake_clean'), isTrue); + }); + }); +} diff --git a/test/terminal_test.dart b/test/terminal_test.dart index 45e9c88..61b1392 100644 --- a/test/terminal_test.dart +++ b/test/terminal_test.dart @@ -1,13 +1,16 @@ import 'package:code_editor/l10n/app_localizations.dart'; +import 'package:code_editor/models/virtual_keyboard_config.dart'; import 'package:code_editor/providers/distro_provider.dart'; import 'package:code_editor/providers/settings_provider.dart'; import 'package:code_editor/providers/terminal_provider.dart'; import 'package:code_editor/views/terminal_view.dart'; import 'package:code_editor/widgets/terminal_session_item_widget.dart'; +import 'package:code_editor/widgets/virtual_keyboard_widget.dart'; import 'package:flutter/material.dart'; import 'package:flutter_test/flutter_test.dart'; import 'package:provider/provider.dart'; import 'package:shared_preferences/shared_preferences.dart'; +import 'package:xterm/xterm.dart' as xterm; class FakeDistroProvider extends DistroProvider { final List _systems; @@ -113,9 +116,9 @@ void main() { expect(provider.activeIndex, equals(0)); expect(provider.activeSession?.name, equals('会话')); - // Check AppBar title and subtitle + // Check AppBar title and subtitle: without a project open, no subtitle is displayed expect(find.text('会话'), findsWidgets); - expect(find.textContaining('终端'), findsOneWidget); + expect(find.textContaining('终端'), findsNothing); }); testWidgets('Right drawer can be opened and shows title "会话" with add button', (tester) async { @@ -136,12 +139,17 @@ void main() { // Verify item text format: (1) 会话 expect(find.text('(1) 会话'), findsOneWidget); - // Tap Add button in drawer: creates session but does NOT switch + // Tap Add button in drawer: creates session, activates it and closes drawer await tester.tap(find.byIcon(Icons.add)); await tester.pumpAndSettle(); expect(provider.sessions.length, equals(2)); - expect(provider.activeIndex, equals(0)); // Did not switch! + expect(provider.activeIndex, equals(1)); // Activated! + expect(find.byType(Drawer), findsNothing); // Drawer closed! + + // Re-open drawer to verify item 2 is present + await tester.tap(find.byIcon(Icons.format_list_bulleted)); + await tester.pumpAndSettle(); expect(find.text('(2) 会话'), findsOneWidget); }); @@ -154,18 +162,21 @@ void main() { await tester.tap(find.byIcon(Icons.format_list_bulleted)); await tester.pumpAndSettle(); - // Add session 2 + // Add session 2 (creates and switches to session 2, closing drawer) await tester.tap(find.byIcon(Icons.add)); await tester.pumpAndSettle(); - expect(provider.activeIndex, equals(0)); + expect(provider.activeIndex, equals(1)); + expect(find.byType(Drawer), findsNothing); - // Tap session 2 item - await tester.tap(find.text('(2) 会话')); + // Re-open drawer and tap session 1 item + await tester.tap(find.byIcon(Icons.format_list_bulleted)); + await tester.pumpAndSettle(); + await tester.tap(find.text('(1) 会话')); await tester.pumpAndSettle(); - // Drawer should be closed and activeIndex is now 1 + // Drawer should be closed and activeIndex is now 0 expect(find.byType(Drawer), findsNothing); - expect(provider.activeIndex, equals(1)); + expect(provider.activeIndex, equals(0)); }); testWidgets('Long press on session item opens context menu with rename and delete', (tester) async { @@ -277,11 +288,15 @@ void main() { await tester.tap(find.byIcon(Icons.format_list_bulleted)); await tester.pumpAndSettle(); - // Add second session + // Add second session (which automatically closes the drawer) await tester.tap(find.byIcon(Icons.add)); await tester.pumpAndSettle(); expect(provider.sessions.length, equals(2)); + // Re-open drawer + await tester.tap(find.byIcon(Icons.format_list_bulleted)); + await tester.pumpAndSettle(); + // Long press second session final items = find.byType(TerminalSessionItemWidget); expect(items, findsNWidgets(2)); @@ -311,10 +326,14 @@ void main() { await tester.tap(find.byIcon(Icons.format_list_bulleted)); await tester.pumpAndSettle(); - // Add second session + // Add second session (which automatically closes the drawer) await tester.tap(find.byIcon(Icons.add)); await tester.pumpAndSettle(); + // Re-open drawer + await tester.tap(find.byIcon(Icons.format_list_bulleted)); + await tester.pumpAndSettle(); + provider.renameSession(provider.sessions[0].id, '第一项'); provider.renameSession(provider.sessions[1].id, '第二项'); await tester.pumpAndSettle(); @@ -333,7 +352,7 @@ void main() { expect(find.text('(2) 第一项'), findsOneWidget); }); - testWidgets('English locale renders "Session", "Terminal · alpine", and "Sessions" dynamically', (tester) async { + testWidgets('English locale renders "Session" and "Sessions" dynamically', (tester) async { final provider = TerminalProvider(); await tester.pumpWidget( MultiProvider( @@ -351,9 +370,8 @@ void main() { ); await tester.pumpAndSettle(); - // Check AppBar title "Session" and subtitle "Terminal · alpine" + // Check AppBar title "Session" (no project open, so subtitle is null) expect(find.text('Session'), findsOneWidget); - expect(find.text('Terminal · alpine'), findsOneWidget); // Open drawer await tester.tap(find.byIcon(Icons.format_list_bulleted)); @@ -401,9 +419,91 @@ void main() { ); await tester.pumpAndSettle(); - // The created session's name is FIXED as "Session", while subtitle translates to Chinese + // The created session's name is FIXED as "Session" expect(find.text('Session'), findsOneWidget); - expect(find.text('终端 · alpine'), findsOneWidget); + }); + + testWidgets('Active modifier also applies to soft-keyboard input', (tester) async { + final terminalProvider = TerminalProvider(); + final settingsProvider = SettingsProvider(); + await settingsProvider.init(); + await settingsProvider.setKeyboardEnabled(KeyboardScope.terminal, true); + + // 先建会话并接管输出,便于观察终端最终发出的字节 + terminalProvider.ensureInitialized(defaultName: 'Session', defaultDistroId: 'alpine'); + final session = terminalProvider.activeSession!; + final emitted = []; + session.terminal.onOutput = emitted.add; + + await tester.pumpWidget( + MultiProvider( + providers: [ + ChangeNotifierProvider.value(value: terminalProvider), + ChangeNotifierProvider.value(value: settingsProvider), + ChangeNotifierProvider.value(value: FakeDistroProvider()), + ], + child: MaterialApp( + locale: const Locale('zh'), + localizationsDelegates: AppLocalizations.localizationsDelegates, + supportedLocales: AppLocalizations.supportedLocales, + home: const TerminalView(), + ), + ), + ); + await tester.pumpAndSettle(); + + // 展开小键盘(默认折叠只露第一行),点亮 Ctrl + await tester.drag(find.byType(VirtualKeyboardWidget), const Offset(0, -90)); + await tester.pumpAndSettle(); + await tester.tap(find.text('Ctrl')); + await tester.pumpAndSettle(); + + // 模拟软键盘/IME 打进一个字符:它不产生 KeyEvent,只能在 onOutput 层被改写 + session.terminal.textInput('c'); + expect(emitted.last, '\x03', reason: '点亮 Ctrl 后软键盘输入的 c 应变成 ^C'); + + // 一次性状态已被消耗,再打一次就是普通字母 + session.terminal.textInput('c'); + expect(emitted.last, 'c'); + + // 未点修饰键时不应改写 + session.terminal.textInput('d'); + expect(emitted.last, 'd'); + }); + + testWidgets('terminal background color follows the setting', (tester) async { + final terminalProvider = TerminalProvider(); + final settingsProvider = SettingsProvider(); + await settingsProvider.init(); + await settingsProvider.setTerminalBackgroundColor(const Color(0xFF002B36)); + + await tester.pumpWidget( + MultiProvider( + providers: [ + ChangeNotifierProvider.value(value: terminalProvider), + ChangeNotifierProvider.value(value: settingsProvider), + ChangeNotifierProvider.value(value: FakeDistroProvider()), + ], + child: MaterialApp( + locale: const Locale('zh'), + localizationsDelegates: AppLocalizations.localizationsDelegates, + supportedLocales: AppLocalizations.supportedLocales, + home: const TerminalView(), + ), + ), + ); + await tester.pumpAndSettle(); + + // 容器与 xterm 主题都应使用设置的背景色 + final terminalView = tester.widget(find.byType(xterm.TerminalView)); + expect(terminalView.theme.background.toARGB32(), 0xFF002B36); + + // 浅色背景时前景自动切成深色,保证可读 + await settingsProvider.setTerminalBackgroundColor(const Color(0xFFFFFFFF)); + await tester.pumpAndSettle(); + final lightView = tester.widget(find.byType(xterm.TerminalView)); + expect(lightView.theme.background.toARGB32(), 0xFFFFFFFF); + expect(lightView.theme.foreground.computeLuminance(), lessThan(0.5)); }); test('SettingsProvider manages UI, Editor, and Terminal font choices correctly', () async { @@ -424,6 +524,82 @@ void main() { expect(settings.terminalFont.id, equals('consolas')); expect(settings.terminalFont.fontFamily, equals('Consolas')); }); + + testWidgets('Terminal accessory keyboard sends real keys through the PTY channel', (tester) async { + final terminalProvider = TerminalProvider(); + final settingsProvider = SettingsProvider(); + await settingsProvider.init(); + // 与编辑区开关相互独立:这里显式打开终端小键盘 + await settingsProvider.setKeyboardEnabled(KeyboardScope.terminal, true); + + await tester.pumpWidget( + MultiProvider( + providers: [ + ChangeNotifierProvider.value(value: terminalProvider), + ChangeNotifierProvider.value(value: settingsProvider), + ChangeNotifierProvider.value(value: FakeDistroProvider()), + ], + child: MaterialApp( + locale: const Locale('zh'), + localizationsDelegates: AppLocalizations.localizationsDelegates, + supportedLocales: AppLocalizations.supportedLocales, + home: const TerminalView(), + ), + ), + ); + await tester.pumpAndSettle(); + + expect(terminalProvider.sessions, isNotEmpty); + // 终端小键盘已挂载(默认预设:两行特殊键 + 修饰键) + expect(find.byType(VirtualKeyboardWidget), findsOneWidget); + expect(find.text('Esc'), findsOneWidget); + expect(find.text('Ctrl'), findsOneWidget); + + // 接管 onOutput(真实场景下由 TerminalSession 接到 PTY) + final emitted = []; + terminalProvider.activeSession!.terminal.onOutput = emitted.add; + + // 第一行:Esc / ↑ / 回车 / 文本符号(带图标的键在键盘上渲染图标) + await tester.tap(find.text('Esc')); + await tester.pumpAndSettle(); + expect(emitted.last, '\x1b'); + + await tester.tap(find.byIcon(Icons.arrow_upward)); + await tester.pumpAndSettle(); + expect(emitted.last, '\x1b[A'); + + await tester.tap(find.text('-')); + await tester.pumpAndSettle(); + expect(emitted.last, '-'); + + // 默认折叠只显示第一行,上拉展开到第二行(与编辑区行为一致) + await tester.drag(find.byType(VirtualKeyboardWidget), const Offset(0, -60)); + await tester.pumpAndSettle(); + + // 第二行:End / : / 方向键 + await tester.tap(find.text('End')); + await tester.pumpAndSettle(); + expect(emitted.last, '\x1b[F'); + + await tester.tap(find.text(':')); + await tester.pumpAndSettle(); + expect(emitted.last, ':'); + + // 运行时修饰键:一次性 Ctrl 与方向键叠加成 Ctrl+↑(一次性随即被消耗) + await tester.tap(find.text('Ctrl')); + await tester.pumpAndSettle(); + await tester.tap(find.byIcon(Icons.arrow_upward)); + await tester.pumpAndSettle(); + expect(emitted.last, '\x1b[1;5A', reason: '一次性 Ctrl 应与方向键叠加'); + await tester.tap(find.byIcon(Icons.arrow_upward)); + await tester.pumpAndSettle(); + expect(emitted.last, '\x1b[A', reason: '一次性 Ctrl 应已被消耗'); + + // 关闭终端小键盘开关后应卸载 + await settingsProvider.setKeyboardEnabled(KeyboardScope.terminal, false); + await tester.pumpAndSettle(); + expect(find.byType(VirtualKeyboardWidget), findsNothing); + }); }); } diff --git a/test/widget_test.dart b/test/widget_test.dart index 9b3bbaf..ee90f05 100644 --- a/test/widget_test.dart +++ b/test/widget_test.dart @@ -1,5 +1,6 @@ import 'dart:io'; import 'package:re_editor/re_editor.dart'; +import 'package:code_editor/models/app_font.dart'; import 'package:code_editor/models/editor_tab_item.dart'; import 'package:code_editor/models/file_item.dart'; import 'package:code_editor/models/project_history.dart'; @@ -17,13 +18,29 @@ import 'package:flutter/material.dart'; import 'package:flutter_test/flutter_test.dart'; import 'package:path/path.dart' as p; import 'package:provider/provider.dart'; +import 'package:xterm/xterm.dart'; import 'package:code_editor/l10n/app_localizations.dart'; +import 'package:code_editor/l10n/app_localizations_en.dart'; +import 'package:code_editor/l10n/app_localizations_zh.dart'; import 'package:code_editor/main.dart'; import 'package:code_editor/views/settings_view.dart'; import 'package:code_editor/views/main_view.dart'; import 'package:code_editor/views/virtual_keyboard_config_view.dart'; import 'package:code_editor/widgets/virtual_keyboard_key_edit_dialog.dart'; +import 'package:code_editor/widgets/color_palette_dialog.dart'; +import 'package:code_editor/utils/app_theme.dart'; +import 'package:code_editor/utils/terminal_theme_helper.dart'; +import 'package:code_editor/widgets/terminal_keyboard_sink.dart'; +import 'package:code_editor/widgets/terminal_modifier_state.dart'; +import 'package:code_editor/widgets/virtual_keyboard_sink.dart'; +import 'package:code_editor/widgets/virtual_keyboard_page_config_section.dart'; +import 'package:code_editor/widgets/virtual_keyboard_page_drawer.dart'; +import 'package:code_editor/widgets/terminal_session_item_widget.dart'; +import 'package:code_editor/models/terminal_session.dart'; +import 'package:code_editor/providers/terminal_provider.dart'; +import 'package:code_editor/providers/distro_provider.dart'; +import 'package:code_editor/widgets/distro_selector_dialog.dart'; import 'package:code_editor/widgets/code_editor_app_bar.dart'; import 'package:code_editor/widgets/code_editor_drawer.dart'; import 'package:code_editor/utils/dialog_utils.dart'; @@ -31,6 +48,37 @@ import 'package:code_editor/services/file_watcher_service.dart'; import 'package:code_editor/utils/syntax_highlight_helper.dart'; import 'package:shared_preferences/shared_preferences.dart'; +/// 记录调用参数的测试用 sink,用于断言键盘组件把什么语义交给了下方实现 +class _RecordingSink implements VirtualKeyboardSink { + final List<({String text, bool appendEnter})> texts = []; + final List<({String name, KeyboardKeyMods mods})> namedKeys = []; + final List commands = []; + int hideCount = 0; + + @override + void sendText(String text, {bool appendEnter = false}) { + texts.add((text: text, appendEnter: appendEnter)); + } + + @override + void sendPair(String pairText, int cursorOffset) {} + + @override + void sendCommand(String command) { + commands.add(command); + } + + @override + void sendNamedKey(String keyName, {KeyboardKeyMods mods = KeyboardKeyMods.none}) { + namedKeys.add((name: keyName, mods: mods)); + } + + @override + void hideKeyboard() { + hideCount++; + } +} + void main() { setUp(() { SharedPreferences.setMockInitialValues({}); @@ -308,7 +356,8 @@ void main() { await tester.pumpAndSettle(); expect(provider.wordWrap, isTrue); - // Verify indent size tile + // Verify indent size tile(列表变长后需向上滚动重新定位) + await tester.scrollUntilVisible(find.text('缩进大小'), -200); expect(find.text('缩进大小'), findsOneWidget); expect(find.text('4 个空格'), findsOneWidget); @@ -654,9 +703,8 @@ void main() { // Verify tabs rendered expect(find.text('file1.dart'), findsOneWidget); - expect(find.text('file2.dart'), findsOneWidget); - // Tab2 is dirty, so asterisk * is displayed - expect(find.text('*'), findsOneWidget); + // Tab2 is dirty,脏标记 * 与文件名同处一个富文本中 + expect(find.text('*file2.dart'), findsOneWidget); // Click close on tab2 (dirty) final closeIcons = find.byIcon(Icons.close); @@ -700,6 +748,210 @@ void main() { expect(settings.locale, equals(const Locale('en'))); }); + test('SettingsProvider persists theme color and terminal background color', () async { + SharedPreferences.setMockInitialValues({}); + final settings = SettingsProvider(); + await settings.init(); + + // 默认值:主题色为蓝色,终端背景为 xterm 默认深色 + expect(settings.appThemeColor.toARGB32(), Colors.blue.toARGB32()); + expect(settings.terminalBackgroundColor.toARGB32(), const Color(0xFF1E1E1E).toARGB32()); + + await settings.setAppThemeColor(const Color(0xFFFF5722)); + await settings.setTerminalBackgroundColor(const Color(0xFF002B36)); + expect(settings.appThemeColor.toARGB32(), 0xFFFF5722); + expect(settings.terminalBackgroundColor.toARGB32(), 0xFF002B36); + + // 落盘后能读回 + final reloaded = SettingsProvider(); + await reloaded.init(); + expect(reloaded.appThemeColor.toARGB32(), 0xFFFF5722); + expect(reloaded.terminalBackgroundColor.toARGB32(), 0xFF002B36); + }); + + test('buildAppTheme derives the color scheme from the seed color', () { + final blue = buildAppTheme(seedColor: Colors.blue, brightness: Brightness.light); + final orange = buildAppTheme(seedColor: Colors.deepOrange, brightness: Brightness.light); + + expect(blue.colorScheme.primary, isNot(orange.colorScheme.primary)); + expect(blue.colorScheme.primary, ColorScheme.fromSeed(seedColor: Colors.blue).primary); + expect( + buildAppTheme(seedColor: Colors.blue, brightness: Brightness.dark).brightness, + Brightness.dark, + ); + }); + + test('terminalThemeWithBackground switches foreground on light backgrounds', () { + final dark = terminalThemeWithBackground(const Color(0xFF1E1E1E)); + expect(dark.background.toARGB32(), 0xFF1E1E1E); + expect(dark.foreground.toARGB32(), TerminalThemes.defaultTheme.foreground.toARGB32()); + + final light = terminalThemeWithBackground(const Color(0xFFFFFFFF)); + expect(light.background.toARGB32(), 0xFFFFFFFF); + expect(light.foreground.computeLuminance(), lessThan(0.5)); + expect(light.cursor.computeLuminance(), lessThan(0.5)); + }); + + testWidgets('color palette dialog returns the tapped swatch', (tester) async { + Color? picked; + + await tester.pumpWidget( + MaterialApp( + localizationsDelegates: AppLocalizations.localizationsDelegates, + supportedLocales: AppLocalizations.supportedLocales, + locale: const Locale('zh'), + home: Builder( + builder: (context) => Scaffold( + body: Center( + child: ElevatedButton( + onPressed: () async { + picked = await ColorPaletteDialog.show( + context, + title: '选择主题颜色', + current: Colors.blue, + palette: ColorPaletteDialog.uiPalette, + ); + }, + child: const Text('open'), + ), + ), + ), + ), + ), + ); + + await tester.tap(find.text('open')); + await tester.pumpAndSettle(); + + // 当前颜色带对勾 + expect(find.byIcon(Icons.check), findsOneWidget); + + final swatch = find.byKey(ValueKey(const Color(0xFF009688).toARGB32())); + await tester.ensureVisible(swatch); + await tester.pumpAndSettle(); + await tester.tap(swatch); + await tester.pumpAndSettle(); + await tester.tap(find.text('确定')); + await tester.pumpAndSettle(); + expect(picked?.toARGB32(), 0xFF009688); + }); + + testWidgets('SettingsView color tiles open the palette and apply the choice', (tester) async { + final provider = SettingsProvider(); + await provider.init(); + + await tester.pumpWidget( + ChangeNotifierProvider.value( + value: provider, + child: const MaterialApp( + localizationsDelegates: AppLocalizations.localizationsDelegates, + supportedLocales: AppLocalizations.supportedLocales, + locale: Locale('zh'), + home: SettingsView(), + ), + ), + ); + await tester.pumpAndSettle(); + + // 主题颜色 + await tester.tap(find.text('主题颜色')); + await tester.pumpAndSettle(); + expect(find.text('选择主题颜色'), findsOneWidget); + final themeSwatch = find.byKey(ValueKey(const Color(0xFF4CAF50).toARGB32())); + await tester.ensureVisible(themeSwatch); + await tester.pumpAndSettle(); + await tester.tap(themeSwatch); + await tester.pumpAndSettle(); + await tester.tap(find.text('确定')); + await tester.pumpAndSettle(); + expect(provider.appThemeColor.toARGB32(), 0xFF4CAF50); + expect(find.text('#4CAF50'), findsWidgets); + + // 终端背景颜色(位于终端分组,需先滚动使其构建、再滚入可视区域) + await tester.scrollUntilVisible(find.text('终端背景颜色'), 200); + await tester.ensureVisible(find.text('终端背景颜色')); + await tester.pumpAndSettle(); + await tester.tap(find.text('终端背景颜色')); + await tester.pumpAndSettle(); + expect(find.text('选择终端背景颜色'), findsOneWidget); + final termSwatch = find.byKey(ValueKey(const Color(0xFF263238).toARGB32())); + await tester.ensureVisible(termSwatch); + await tester.pumpAndSettle(); + await tester.tap(termSwatch); + await tester.pumpAndSettle(); + await tester.tap(find.text('确定')); + await tester.pumpAndSettle(); + expect(provider.terminalBackgroundColor.toARGB32(), 0xFF263238); + expect(find.text('#263238'), findsWidgets); + }); + + test('SettingsProvider keeps editor and terminal keyboard configs independent', () async { + SharedPreferences.setMockInitialValues({}); + final settings = SettingsProvider(); + await settings.init(); + + // 默认预设不同:编辑区是代码符号,终端是两行特殊键 + 修饰键 + expect(settings.keyboardConfigFor(KeyboardScope.editor).pages.first.keys.first.first.value, 'tab'); + final terminalPage = settings.keyboardConfigFor(KeyboardScope.terminal).pages.first; + expect(terminalPage.keys.first.first.value, 'escape'); + expect(terminalPage.keys.length, equals(2)); + expect(terminalPage.keys[0].any((k) => k.action == 'modifier'), isTrue); + expect(terminalPage.keys[1].any((k) => k.action == 'modifier'), isTrue); + + // 写入终端配置不影响编辑区 + final editorJsonBefore = settings.keyboardConfigJsonFor(KeyboardScope.editor); + const terminalJson = '{"pages":[{"count":7,"keys":[[{"label":"^C","action":"key","value":"keyC",' + '"mods":{"ctrl":true}}]]}]}'; + expect(await settings.setKeyboardConfig(KeyboardScope.terminal, terminalJson), isTrue); + expect(settings.keyboardConfigJsonFor(KeyboardScope.editor), editorJsonBefore); + expect( + settings.keyboardConfigFor(KeyboardScope.terminal).pages.first.keys.first.first.value, + 'keyC', + ); + + // 作用域校验生效:编辑区动作写进终端配置应被拒绝,且不产生副作用 + const editorOnlyJson = '{"pages":[{"count":7,"keys":[[{"label":"()","action":"pair","value":"()"}]]}]}'; + expect(await settings.setKeyboardConfig(KeyboardScope.terminal, editorOnlyJson), isFalse); + expect(settings.keyboardConfigFor(KeyboardScope.terminal).pages.first.keys.first.first.value, 'keyC'); + + // 两个开关相互独立 + await settings.setKeyboardEnabled(KeyboardScope.terminal, false); + expect(settings.keyboardEnabledFor(KeyboardScope.terminal), isFalse); + expect(settings.keyboardEnabledFor(KeyboardScope.editor), isTrue); + + // 恢复默认只影响对应作用域 + await settings.resetKeyboardConfig(KeyboardScope.terminal); + expect(settings.keyboardConfigFor(KeyboardScope.terminal).pages.first.keys.first.first.value, 'escape'); + expect(settings.keyboardConfigJsonFor(KeyboardScope.editor), editorJsonBefore); + }); + + test('SettingsProvider loads both keyboard configs from storage', () async { + const terminalJson = '{"pages":[{"count":6,"keys":[[{"label":"Tab","action":"key","value":"tab"}]]}]}'; + SharedPreferences.setMockInitialValues({ + 'virtual_keyboard_config': VirtualKeyboardConfig.defaultJsonPretty(), + 'terminal_virtual_keyboard_config': terminalJson, + 'enable_terminal_virtual_keyboard': false, + }); + + final settings = SettingsProvider(); + await settings.init(); + + expect(settings.keyboardConfigFor(KeyboardScope.terminal).pages.first.count, 6); + expect(settings.keyboardConfigFor(KeyboardScope.terminal).pages.first.keys.first.first.value, 'tab'); + expect(settings.keyboardEnabledFor(KeyboardScope.terminal), isFalse); + // 编辑区配置仍是自己的那份 + expect(settings.keyboardConfigFor(KeyboardScope.editor).pages.first.count, 7); + + // 终端配置非法(用了编辑区动作)时应被丢弃并回退到终端默认预设 + SharedPreferences.setMockInitialValues({ + 'terminal_virtual_keyboard_config': + '{"pages":[{"count":6,"keys":[[{"label":"x","action":"command","value":"undo"}]]}]}', + }); + final fallback = SettingsProvider(); + await fallback.init(); + expect(fallback.keyboardConfigFor(KeyboardScope.terminal).pages.first.keys.first.first.value, 'escape'); + }); + test('ProjectProvider manages cut/copy/paste and tree state', () { final project = ProjectProvider(); final itemA = FileItem(name: 'a.dart', path: '/test/a.dart', isDirectory: false); @@ -1074,7 +1326,7 @@ void main() { await tester.pump(const Duration(milliseconds: 100)); // Verify main view is rendered with modified file1 - expect(find.text('file1.dart'), findsWidgets); + expect(find.textContaining('file1.dart'), findsWidgets); expect(tabProvider.isModified, isTrue); // Open file2 via openFile (with content specified, or selectFile) @@ -1409,6 +1661,553 @@ void main() { expect(VirtualKeyboardConfig.validateJson(shorthandJson), isNull); }); + test('terminal scope validation accepts the three terminal actions and rejects the rest', () { + String? check(String keyJson) => + VirtualKeyboardConfig.validateJson('{"pages":[{"count":6,"keys":[[$keyJson]]}]}', KeyboardScope.terminal); + + // input(指令快捷键)+ autoEnter + expect(check('{"label":"cd ..","action":"input","value":"cd ..","autoEnter":true}'), isNull); + expect(check('{"label":"cd","action":"input"}'), contains('缺少文本内容')); + + // key(特殊键):31 个命名键任意修饰组合都合法 + expect(check('{"label":"Esc","action":"key","value":"escape"}'), isNull); + expect(check('{"label":"↑","action":"key","value":"arrowUp","mods":{"ctrl":true}}'), isNull); + expect(check('{"label":"⇤","action":"key","value":"backtab","mods":{"shift":true}}'), isNull); + + // key + 字母键:不受修饰符约束,单独成格就是该字母 + expect(check('{"label":"^C","action":"key","value":"keyC","mods":{"ctrl":true}}'), isNull); + expect(check('{"label":"Alt+.","action":"key","value":"keyZ","mods":{"alt":true}}'), isNull); + expect(check('{"label":"c","action":"key","value":"keyC"}'), isNull); + expect(check('{"label":"^C","action":"key","value":"keyC","mods":{"ctrl":true,"shift":true}}'), isNull); + + // key:默认 keytab 里没有的键必须被拦下(否则运行时静默无输出) + expect(check('{"label":"1","action":"key","value":"digit1"}'), contains('不会产生任何输出')); + expect(check('{"label":"Home","action":"key","value":"homeKey"}'), contains('不会产生任何输出')); + expect(check('{"label":"Esc","action":"key"}'), contains('缺少特殊键值')); + + // modifier:只能 ctrl / alt / shift,且不允许再挂 mods + expect(check('{"label":"Ctrl","action":"modifier","value":"ctrl"}'), isNull); + expect(check('{"label":"Shift","action":"modifier","value":"shift"}'), isNull); + expect(check('{"label":"Meta","action":"modifier","value":"meta"}'), contains('修饰键取值')); + expect(check('{"label":"Ctrl","action":"modifier","value":"ctrl","mods":{"alt":true}}'), contains('不应再附带')); + + // 文本通道附加 mods 不会生效 → 直接拦下 + expect(check('{"label":"x","action":"input","value":"ls","mods":{"ctrl":true}}'), contains('"mods" 不会生效')); + + // 编辑区动作在终端里非法 + expect(check('{"label":"()","action":"pair","value":"()"}'), contains('不适用于终端')); + expect(check('{"label":"Tab","action":"command","value":"tab"}'), contains('不适用于终端')); + + // 默认终端预设自身必须能通过终端作用域校验(否则写入存储后会被 init 丢弃) + expect( + VirtualKeyboardConfig.validateJson( + VirtualKeyboardConfig.defaultTerminalJsonPretty(), + KeyboardScope.terminal, + ), + isNull, + ); + }); + + test('editor scope validation rejects terminal-only actions', () { + String? check(String keyJson) => + VirtualKeyboardConfig.validateJson('{"pages":[{"count":6,"keys":[[$keyJson]]}]}'); + + expect(check('{"label":"()","action":"pair","value":"()","cursorOffset":-1}'), isNull); + expect(check('{"label":"Tab","action":"command","value":"tab"}'), isNull); + expect(check('{"label":"Esc","action":"key","value":"escape"}'), contains('不适用于编辑区')); + expect(check('{"label":"Ctrl","action":"modifier","value":"ctrl"}'), contains('不适用于编辑区')); + }); + + test('KeyboardKeyItem round-trips mods / autoEnter and omits empty values', () { + final item = KeyboardKeyItem.fromJson({ + 'label': '^C', + 'action': 'key', + 'value': 'keyC', + 'mods': {'ctrl': true, 'alt': false}, + 'autoEnter': true, + }); + expect(item.mods.ctrl, isTrue); + expect(item.mods.alt, isFalse); + expect(item.mods.shift, isFalse); + expect(item.autoEnter, isTrue); + expect(item.toJson()['mods'], {'ctrl': true}); + expect(item.toJson()['autoEnter'], true); + + // 无修饰、非自动回车时,两个字段都不出现在 JSON 中(编辑区配置保持零变化) + const plain = KeyboardKeyItem(label: ';', value: ';'); + expect(plain.toJson().containsKey('mods'), isFalse); + expect(plain.toJson().containsKey('autoEnter'), isFalse); + expect(plain.mods.isEmpty, isTrue); + + // 非法 mods 输入一律视为无修饰,不抛异常 + expect(KeyboardKeyMods.fromJson('not-a-map').isEmpty, isTrue); + expect(KeyboardKeyMods.fromJson(null).isEmpty, isTrue); + }); + + test('terminal named key table matches xterm TerminalKey exactly', () { + // 白名单必须全部是真实存在的 TerminalKey 枚举名,反之运行时才能解析 + final available = TerminalKey.values.map((k) => k.name).toSet(); + for (final key in KeyboardScopeHelper.terminalNamedKeys) { + expect(available, contains(key.value), reason: 'xterm 中不存在 TerminalKey.${key.value}'); + } + expect(KeyboardScopeHelper.terminalNamedKeys.length, equals(31)); + // 下拉可选集合 = 31 命名键 + 26 字母键 + expect(KeyboardScopeHelper.terminalSelectableKeys.length, equals(31 + 26)); + + // 字母键不再受修饰符约束:单独就是该字母 + expect(KeyboardScopeHelper.isSupportedTerminalKey('keyC'), isTrue); + expect(KeyboardScopeHelper.isSupportedTerminalKey('escape'), isTrue); + expect(KeyboardScopeHelper.isSupportedTerminalKey('digit1'), isFalse); + expect(KeyboardScopeHelper.isSupportedTerminalKey('keyAB'), isFalse); + + // 支持集合 = 31 命名键 + 26 字母键 + expect(KeyboardScopeHelper.terminalSupportedKeyNames.length, equals(31 + 26)); + }); + + test('every selectable terminal key carries a valid icon', () { + for (final option in KeyboardScopeHelper.terminalSelectableKeys) { + expect(option.icon, isNotNull, reason: '缺少图标: ${option.value}'); + expect( + KeyboardIconHelper.getIcon(option.icon), + isNotNull, + reason: '图标常量不存在: ${option.icon} (${option.value})', + ); + } + }); + + test('every named terminal key has a localized name in zh and en', () { + final zh = AppLocalizationsZh(); + final en = AppLocalizationsEn(); + for (final key in KeyboardScopeHelper.terminalNamedKeys) { + expect(zh.keyboardKeyName(key.value), isNot(key.value), reason: 'zh 缺少特殊键名称: ${key.value}'); + expect(en.keyboardKeyName(key.value), isNot(key.value), reason: 'en 缺少特殊键名称: ${key.value}'); + } + // 动作改名后(terminal_key → key)三个终端动作都要有名字 + for (final option in KeyboardScopeHelper.terminalActions) { + expect(zh.keyboardActionName(option.action), isNot(option.action)); + expect(en.keyboardActionName(option.action), isNot(option.action)); + } + expect(zh.keyboardActionInputTerminal, '指令快捷键'); + expect(en.keyboardActionInputTerminal, 'Command Shortcut'); + }); + + test('TerminalKeyboardSink emits real escape sequences through onOutput', () { + final terminal = Terminal(); + final emitted = []; + terminal.onOutput = emitted.add; + final sink = TerminalKeyboardSink(terminal: terminal); + + // 文本指令:无回车 / 自动回车 / 已含回车不重复补 + sink.sendText('cd ..'); + expect(emitted.last, 'cd ..'); + sink.sendText('cd ..', appendEnter: true); + expect(emitted.last, 'cd ..\r'); + sink.sendText('ls\r', appendEnter: true); + expect(emitted.last, 'ls\r'); + + // 命名特殊键:keytab 中的真实序列 + sink.sendNamedKey('escape'); + expect(emitted.last, '\x1b'); + sink.sendNamedKey('arrowUp'); + expect(emitted.last, '\x1b[A'); + sink.sendNamedKey('tab', mods: const KeyboardKeyMods(shift: true)); + expect(emitted.last, '\x1b[Z'); + + // 字母键 + 单独 Ctrl / Alt + sink.sendNamedKey('keyC', mods: const KeyboardKeyMods(ctrl: true)); + expect(emitted.last, '\x03'); + sink.sendNamedKey('keyD', mods: const KeyboardKeyMods(ctrl: true)); + expect(emitted.last, '\x04'); + sink.sendNamedKey('keyZ', mods: const KeyboardKeyMods(alt: true)); + // 注意:xterm 的 AltInputHandler 输出的是大写字母(ESC + 'Z') + expect(emitted.last, '\x1bZ'); + + // 无修饰的字母键会发送该字母本身;keytab 之外的键仍必须无输出 + sink.sendNamedKey('keyC'); + expect(emitted.last, 'c'); + final countBefore = emitted.length; + sink.sendNamedKey('digit1'); + sink.sendNamedKey('not_a_key'); + expect(emitted.length, countBefore); + }); + + testWidgets('VirtualKeyboardWidget applies one-shot and locked modifiers', (tester) async { + // 注入假时钟:确定性地控制"单击"与"双击",不依赖真实时间 + var fakeNow = DateTime(2024, 1, 1); + final modifierState = TerminalModifierState(clock: () => fakeNow); + + final sink = _RecordingSink(); + final config = VirtualKeyboardConfig(pages: [ + KeyboardPageItem(count: 4, keys: [ + [ + const KeyboardKeyItem(label: 'Ctrl', action: 'modifier', value: 'ctrl'), + const KeyboardKeyItem(label: 'C', action: 'key', value: 'keyC'), + const KeyboardKeyItem(label: 'x', action: 'input', value: 'x'), + const KeyboardKeyItem(label: '^', action: 'key', value: 'keyC', mods: KeyboardKeyMods(ctrl: true)), + ], + ]), + ]); + + await tester.pumpWidget( + MaterialApp( + home: Scaffold( + body: VirtualKeyboardWidget( + controller: null, + sink: sink, + modifierState: modifierState, + config: config, + ), + ), + ), + ); + await tester.pumpAndSettle(); + + // 一次性:点 Ctrl 后下一次按键带 ctrl,之后自动清除 + await tester.tap(find.text('Ctrl')); + await tester.pumpAndSettle(); + // 状态写在共享对象上(终端据此改写软键盘输入) + expect(modifierState.mods.ctrl, isTrue); + await tester.tap(find.text('C')); + await tester.pumpAndSettle(); + expect(sink.namedKeys.last.name, 'keyC'); + expect(sink.namedKeys.last.mods.ctrl, isTrue); + expect(modifierState.mods.isEmpty, isTrue, reason: '一次性状态应被下一次按键消耗'); + + await tester.tap(find.text('C')); + await tester.pumpAndSettle(); + expect(sink.namedKeys.last.mods.ctrl, isFalse); + + // 一次性状态也会被"不产生字符"的其它按键消耗:点 Ctrl 后按文本键 x + fakeNow = fakeNow.add(const Duration(seconds: 1)); + await tester.tap(find.text('Ctrl')); + await tester.pumpAndSettle(); + await tester.tap(find.text('x')); + await tester.pumpAndSettle(); + expect(sink.texts.last.text, 'x'); + await tester.tap(find.text('C')); + await tester.pumpAndSettle(); + expect(sink.namedKeys.last.mods.ctrl, isFalse, reason: '一次性 Ctrl 应已被文本键消耗'); + + // 双击锁定:连续两次按键都带 ctrl,再点 Ctrl 解除 + fakeNow = fakeNow.add(const Duration(seconds: 1)); + await tester.tap(find.text('Ctrl')); + await tester.pump(const Duration(milliseconds: 50)); + fakeNow = fakeNow.add(const Duration(milliseconds: 50)); + await tester.tap(find.text('Ctrl')); + await tester.pumpAndSettle(); + await tester.tap(find.text('C')); + await tester.pumpAndSettle(); + expect(sink.namedKeys.last.mods.ctrl, isTrue); + await tester.tap(find.text('C')); + await tester.pumpAndSettle(); + expect(sink.namedKeys.last.mods.ctrl, isTrue, reason: '锁定状态应持续生效'); + + fakeNow = fakeNow.add(const Duration(seconds: 1)); + await tester.tap(find.text('Ctrl')); + await tester.pumpAndSettle(); + await tester.tap(find.text('C')); + await tester.pumpAndSettle(); + expect(sink.namedKeys.last.mods.ctrl, isFalse, reason: '再次点击应解除锁定'); + }); + + testWidgets('VirtualKeyboardWidget merges per-key mods with active modifiers', (tester) async { + final sink = _RecordingSink(); + final config = VirtualKeyboardConfig(pages: [ + KeyboardPageItem(count: 2, keys: [ + [ + const KeyboardKeyItem(label: 'Alt', action: 'modifier', value: 'alt'), + const KeyboardKeyItem(label: '^', action: 'key', value: 'keyC', mods: KeyboardKeyMods(ctrl: true)), + ], + ]), + ]); + + await tester.pumpWidget( + MaterialApp( + home: Scaffold( + body: VirtualKeyboardWidget( + controller: null, + sink: sink, + modifierState: TerminalModifierState(), + config: config, + ), + ), + ), + ); + await tester.pumpAndSettle(); + + await tester.tap(find.text('Alt')); + await tester.pumpAndSettle(); + await tester.tap(find.text('^')); + await tester.pumpAndSettle(); + + // 按键自带 ctrl 与运行时激活的 alt 叠加 + expect(sink.namedKeys.last.mods.ctrl, isTrue); + expect(sink.namedKeys.last.mods.alt, isTrue); + }); + + testWidgets('letter keys show a keyboard icon inside the special-key dropdown', (tester) async { + await tester.pumpWidget( + MaterialApp( + localizationsDelegates: AppLocalizations.localizationsDelegates, + supportedLocales: AppLocalizations.supportedLocales, + locale: const Locale('zh'), + home: const Scaffold( + body: KeyEditDialog( + scope: KeyboardScope.terminal, + initialKey: KeyboardKeyItem(label: 'C', action: 'key', value: 'keyC'), + ), + ), + ), + ); + await tester.pumpAndSettle(); + + // 打开特殊键下拉(会自动滚动到当前选中的 keyC,字母键分组随之可见) + await tester.tap(find.byType(DropdownButtonFormField).last); + await tester.pumpAndSettle(); + expect(find.text('字母键'), findsWidgets); + + final aItem = find.ancestor( + of: find.text('A').last, + matching: find.byType(DropdownMenuItem), + ); + expect( + find.descendant(of: aItem, matching: find.byIcon(Icons.keyboard_outlined)), + findsWidgets, + reason: '字母键 A 在下拉里应带键盘图标', + ); + // F 键的图标数据由 'every selectable terminal key carries a valid icon' 覆盖 + // (F1 不在当前滚动位置,菜单只渲染可见项) + }); + + testWidgets('KeyEditDialog terminal form builds command shortcut / special key / modifier keys', (tester) async { + KeyboardKeyItem? saved; + KeyboardKeyItem? initialKey; + + await tester.pumpWidget( + MaterialApp( + localizationsDelegates: AppLocalizations.localizationsDelegates, + supportedLocales: AppLocalizations.supportedLocales, + locale: const Locale('zh'), + home: Builder( + builder: (context) => Scaffold( + body: Center( + child: ElevatedButton( + onPressed: () async { + saved = await showDialog( + context: context, + builder: (ctx) => KeyEditDialog(scope: KeyboardScope.terminal, initialKey: initialKey), + ); + }, + child: const Text('open'), + ), + ), + ), + ), + ), + ); + + // ① 指令快捷键 + 自动回车 + await tester.tap(find.text('open')); + await tester.pumpAndSettle(); + + // 终端作用域的 input 显示为“指令快捷键” + expect(find.text('指令快捷键'), findsWidgets); + + await tester.enterText(find.widgetWithText(TextFormField, '输入文本内容'), 'git status'); + await tester.tap(find.text('发送后自动回车')); + await tester.pumpAndSettle(); + await tester.tap(find.text('确定')); + await tester.pumpAndSettle(); + + expect(saved!.action, 'input'); + expect(saved!.value, 'git status'); + expect(saved!.autoEnter, isTrue); + // 标签留空时回退为文本本身 + expect(saved!.label, 'git status'); + + // ② 编辑已有特殊键 Ctrl+C(下拉选字母键 + 下方修饰键控件叠加) + initialKey = const KeyboardKeyItem( + label: 'Ctrl+C', + action: 'key', + value: 'keyC', + mods: KeyboardKeyMods(ctrl: true), + ); + await tester.tap(find.text('open')); + await tester.pumpAndSettle(); + + expect(find.text('特殊键'), findsWidgets); + // 下拉按钮显示当前选中的键名,修饰键控件状态与配置一致 + expect(find.text('C'), findsWidgets); + expect(tester.widget(find.widgetWithText(FilterChip, 'Ctrl 键')).selected, isTrue); + expect(tester.widget(find.widgetWithText(FilterChip, 'Shift 键')).selected, isFalse); + + // 下拉会自动滚动到当前选中项,字母键分组标题随之可见 + await tester.tap(find.byType(DropdownButtonFormField).last); + await tester.pumpAndSettle(); + expect(find.text('字母键'), findsWidgets); + // 改选另一个字母键 keyD + await tester.tap(find.text('D').last); + await tester.pumpAndSettle(); + expect(find.text('D'), findsWidgets); + + // 取消 Ctrl 后就是一枚普通字母键(不再被拦截),标签留空则用紧凑键名 + await tester.tap(find.text('Ctrl 键')); + await tester.pumpAndSettle(); + await tester.enterText(find.widgetWithText(TextFormField, '显示文本'), ''); + await tester.tap(find.text('确定')); + await tester.pumpAndSettle(); + + expect(saved!.action, 'key'); + expect(saved!.value, 'keyD'); + expect(saved!.mods.isEmpty, isTrue); + expect(saved!.label, 'D'); + + // ④ 修饰键动作(Ctrl / Alt / Shift 三选一) + initialKey = null; + await tester.tap(find.text('open')); + await tester.pumpAndSettle(); + await tester.tap(find.byType(DropdownButtonFormField).first); + await tester.pumpAndSettle(); + await tester.tap(find.text('修饰键').last); + await tester.pumpAndSettle(); + await tester.tap(find.byType(DropdownButtonFormField).last); + await tester.pumpAndSettle(); + await tester.tap(find.text('Shift 键').last); + await tester.pumpAndSettle(); + await tester.tap(find.text('确定')); + await tester.pumpAndSettle(); + + expect(saved!.action, 'modifier'); + expect(saved!.value, 'shift'); + expect(saved!.mods.isEmpty, isTrue); + }); + + testWidgets('SettingsView terminal keyboard entry edits the terminal config only', (tester) async { + final settingsProvider = SettingsProvider(); + await settingsProvider.init(); + + await tester.pumpWidget( + ChangeNotifierProvider.value( + value: settingsProvider, + child: const MaterialApp( + localizationsDelegates: AppLocalizations.localizationsDelegates, + supportedLocales: AppLocalizations.supportedLocales, + locale: Locale('zh'), + home: SettingsView(), + ), + ), + ); + await tester.pumpAndSettle(); + + // 终端分组有独立开关,默认与编辑区开关互不影响 + await tester.scrollUntilVisible(find.text('终端小键盘'), 200); + expect(find.text('终端小键盘'), findsOneWidget); + + await tester.scrollUntilVisible(find.text('编辑终端键盘配置'), 200); + expect(find.text('编辑终端键盘配置'), findsOneWidget); + + // 关闭终端小键盘后,配置入口被禁用但编辑区的仍可用 + final terminalSwitch = find.descendant( + of: find.widgetWithText(SwitchListTile, '终端小键盘'), + matching: find.byType(Switch), + ); + await tester.tap(terminalSwitch); + await tester.pumpAndSettle(); + expect(settingsProvider.keyboardEnabledFor(KeyboardScope.terminal), isFalse); + expect(settingsProvider.keyboardEnabledFor(KeyboardScope.editor), isTrue); + await tester.tap(terminalSwitch); + await tester.pumpAndSettle(); + expect(settingsProvider.keyboardEnabledFor(KeyboardScope.terminal), isTrue); + + // 进入终端键盘配置页:副标题显示“终端” + final editorJsonBefore = settingsProvider.keyboardConfigJsonFor(KeyboardScope.editor); + await tester.tap(find.text('编辑终端键盘配置')); + await tester.pumpAndSettle(); + + expect(find.byType(VirtualKeyboardConfigView), findsOneWidget); + expect(find.text('终端:(第 1 页)'), findsOneWidget); + + // 改一行按钮数 → 只写终端那份 JSON + await tester.tap(find.byTooltip('增加每行按键数')); + await tester.pumpAndSettle(); + expect(settingsProvider.keyboardConfigFor(KeyboardScope.terminal).pages[0].count, 8); + expect(settingsProvider.keyboardConfigJsonFor(KeyboardScope.editor), editorJsonBefore); + + // 恢复默认只作用于终端那份(回到 escape 开头的终端预设) + await tester.tap(find.byTooltip('恢复默认预设')); + await tester.pumpAndSettle(); + await tester.tap(find.text('恢复默认')); + await tester.pumpAndSettle(); + expect(settingsProvider.keyboardConfigFor(KeyboardScope.terminal).pages[0].count, 7); + expect(settingsProvider.keyboardConfigJsonFor(KeyboardScope.editor), editorJsonBefore); + + // 等 toast 定时器结束,避免测试结束时仍有 pending timer + await tester.pump(const Duration(seconds: 3)); + }); + + test('TerminalKeyboardSink sends bare letters and modifier combos', () { + final terminal = Terminal(); + final emitted = []; + terminal.onOutput = emitted.add; + final sink = TerminalKeyboardSink(terminal: terminal); + + // 字母键不再要求修饰符:单独成格时就是该字母 + sink.sendNamedKey('keyC'); + expect(emitted.last, 'c'); + sink.sendNamedKey('keyC', mods: const KeyboardKeyMods(shift: true)); + expect(emitted.last, 'C'); + sink.sendNamedKey('keyC', mods: const KeyboardKeyMods(ctrl: true)); + expect(emitted.last, '\x03'); + sink.sendNamedKey('keyZ', mods: const KeyboardKeyMods(ctrl: true)); + expect(emitted.last, '\x1a'); + sink.sendNamedKey('keyC', mods: const KeyboardKeyMods(alt: true)); + expect(emitted.last, '\x1bC'); + }); + + test('applyModifierToTypedText mirrors charInput rules for soft-keyboard input', () { + const none = KeyboardKeyMods(); + const ctrl = KeyboardKeyMods(ctrl: true); + const alt = KeyboardKeyMods(alt: true); + const shift = KeyboardKeyMods(shift: true); + + // 无修饰 → 不需要改写 + expect(applyModifierToTypedText('c', none), isNull); + // Ctrl + expect(applyModifierToTypedText('c', ctrl), '\x03'); + expect(applyModifierToTypedText('C', ctrl), '\x03'); + expect(applyModifierToTypedText('[', ctrl), '\x1b'); + // Alt / Shift + expect(applyModifierToTypedText('c', alt), '\x1bC'); + expect(applyModifierToTypedText('c', shift), 'C'); + // 多字符(粘贴 / 指令快捷键)与不可改写的字符原样放过 + expect(applyModifierToTypedText('cd ..', ctrl), isNull); + expect(applyModifierToTypedText('1', ctrl), isNull); + expect(applyModifierToTypedText('中', ctrl), isNull); + expect(applyModifierToTypedText('', ctrl), isNull); + }); + + test('TerminalModifierState implements one-shot / lock / consume', () { + var now = DateTime(2024, 1, 1); + final state = TerminalModifierState(clock: () => now); + + state.toggle('ctrl'); + expect(state.mods.ctrl, isTrue); + state.consume(); + expect(state.mods.isEmpty, isTrue); + + // 双击锁定:消耗后仍生效 + now = now.add(const Duration(seconds: 1)); + state.toggle('ctrl'); + now = now.add(const Duration(milliseconds: 50)); + state.toggle('ctrl'); + state.consume(); + expect(state.mods.ctrl, isTrue, reason: '锁定状态不应被消耗'); + + state.toggle('ctrl'); + expect(state.mods.isEmpty, isTrue, reason: '再次点击解除锁定'); + expect(state.isEmpty, isTrue); + }); + testWidgets('VirtualKeyboardWidget renders keys according to count and handles input/commands', (tester) async { final controller = CodeLineEditingController.fromText('hello'); controller.selection = const CodeLineSelection.collapsed(index: 0, offset: 5); @@ -1505,6 +2304,202 @@ void main() { expect(collapsedSize.height, closeTo(30.0, 1.0)); }); + testWidgets('KeyEditDialog pair action takes free-form pair text with validation', (tester) async { + KeyboardKeyItem? saved; + + await tester.pumpWidget( + MaterialApp( + localizationsDelegates: AppLocalizations.localizationsDelegates, + supportedLocales: AppLocalizations.supportedLocales, + locale: const Locale('zh'), + home: Builder( + builder: (context) => Scaffold( + body: Center( + child: ElevatedButton( + onPressed: () async { + saved = await showDialog( + context: context, + builder: (ctx) => const KeyEditDialog(scope: KeyboardScope.editor), + ); + }, + child: const Text('open'), + ), + ), + ), + ), + ), + ); + + await tester.tap(find.text('open')); + await tester.pumpAndSettle(); + expect(find.byType(KeyEditDialog), findsOneWidget); + + // 动作类型下拉中不再有“成对符号预设”列表,只有动作本身 + await tester.tap(find.byType(DropdownButtonFormField)); + await tester.pumpAndSettle(); + await tester.tap(find.text('成对符号').last); + await tester.pumpAndSettle(); + + // 成对符号为自由输入框,默认填入 (),且不再显示光标偏移的辅助说明文本 + final pairField = find.widgetWithText(TextFormField, '成对符号'); + expect(pairField, findsOneWidget); + expect(find.text('()'), findsOneWidget); + expect(find.textContaining('插入后光标'), findsNothing); + + // 左右完全相同的符号应被拦截 + await tester.enterText(pairField, '<<'); + await tester.tap(find.text('确定')); + await tester.pumpAndSettle(); + expect(find.byType(KeyEditDialog), findsOneWidget); + expect(find.textContaining('左右不同'), findsOneWidget); + + // 旧预设列表之外的任意成对符号均可保存 + await tester.enterText(pairField, '/**/'); + await tester.tap(find.text('确定')); + await tester.pumpAndSettle(); + + expect(find.byType(KeyEditDialog), findsNothing); + expect(saved, isNotNull); + expect(saved!.action, 'pair'); + expect(saved!.value, '/**/'); + expect(saved!.cursorOffset, -1); + // 标签留空时回退为成对符号内容 + expect(saved!.label, '/**/'); + }); + + testWidgets('KeyEditDialog icon dropdown shows localized icon names', (tester) async { + await tester.pumpWidget( + const MaterialApp( + localizationsDelegates: AppLocalizations.localizationsDelegates, + supportedLocales: AppLocalizations.supportedLocales, + locale: Locale('zh'), + home: Scaffold(body: KeyEditDialog(scope: KeyboardScope.editor)), + ), + ); + await tester.pumpAndSettle(); + + // 展开图标下拉 + await tester.tap(find.byType(DropdownButtonFormField)); + await tester.pumpAndSettle(); + + // 图标名称已本地化,不再直接展示内部英文 key + expect(find.text('撤销'), findsWidgets); // undo + expect(find.text('重做'), findsWidgets); // redo + expect(find.text('向右缩进'), findsWidgets); // tab + expect(find.text('undo'), findsNothing); + expect(find.text('redo'), findsNothing); + }); + + test('every supported icon key has a localized name in zh and en', () { + final zh = AppLocalizationsZh(); + final en = AppLocalizationsEn(); + for (final iconKey in KeyboardIconHelper.supportedIconKeys) { + // 未在 ARB 的 select 中登记时会回退成原始 key,这里据此兜底校验 + expect(zh.keyboardIconName(iconKey), isNot(iconKey), reason: 'zh 缺少图标名称: $iconKey'); + expect(en.keyboardIconName(iconKey), isNot(iconKey), reason: 'en 缺少图标名称: $iconKey'); + } + }); + + testWidgets('KeyEditDialog command dropdown prefixes an icon for each option', (tester) async { + await tester.pumpWidget( + const MaterialApp( + localizationsDelegates: AppLocalizations.localizationsDelegates, + supportedLocales: AppLocalizations.supportedLocales, + locale: Locale('zh'), + home: Scaffold(body: KeyEditDialog(scope: KeyboardScope.editor)), + ), + ); + await tester.pumpAndSettle(); + + // 动作类型切换为“编辑器命令” + await tester.tap(find.byType(DropdownButtonFormField).first); + await tester.pumpAndSettle(); + await tester.tap(find.text('编辑器命令').last); + await tester.pumpAndSettle(); + + // 字段文案已去掉“预设”,当前选中项(向右缩进)带图标 + expect(find.text('预设编辑器命令'), findsNothing); + expect(find.byIcon(Icons.keyboard_tab), findsWidgets); + expect(find.text('向右缩进'), findsWidgets); + + // 展开命令下拉,各项前均有图标 + await tester.tap(find.byType(DropdownButtonFormField).last); + await tester.pumpAndSettle(); + expect(find.byIcon(Icons.undo), findsWidgets); + expect(find.text('撤销'), findsWidgets); + }); + + test('every action / command / modifier / terminal key value has a localized name', () { + final zh = AppLocalizationsZh(); + final en = AppLocalizationsEn(); + + for (final option in [...KeyboardScopeHelper.editorActions, ...KeyboardScopeHelper.terminalActions]) { + expect(zh.keyboardActionName(option.action), isNot(option.action), reason: 'zh 缺少动作名称: ${option.action}'); + expect(en.keyboardActionName(option.action), isNot(option.action), reason: 'en 缺少动作名称: ${option.action}'); + } + for (final cmd in KeyboardScopeHelper.editorCommands) { + expect(zh.keyboardCommandName(cmd.value), isNot(cmd.value), reason: 'zh 缺少命令名称: ${cmd.value}'); + expect(en.keyboardCommandName(cmd.value), isNot(cmd.value), reason: 'en 缺少命令名称: ${cmd.value}'); + } + for (final modifier in KeyboardScopeHelper.terminalModifierValues) { + expect(zh.keyboardModifierName(modifier), isNot(modifier), reason: 'zh 缺少修饰键名称: $modifier'); + expect(en.keyboardModifierName(modifier), isNot(modifier), reason: 'en 缺少修饰键名称: $modifier'); + } + }); + + testWidgets('KeyEditDialog action and command dropdowns follow the locale', (tester) async { + await tester.pumpWidget( + const MaterialApp( + localizationsDelegates: AppLocalizations.localizationsDelegates, + supportedLocales: AppLocalizations.supportedLocales, + locale: Locale('en'), + home: Scaffold(body: KeyEditDialog(scope: KeyboardScope.editor)), + ), + ); + await tester.pumpAndSettle(); + + // 动作下拉为英文,不再回落到硬编码中文 + await tester.tap(find.byType(DropdownButtonFormField).first); + await tester.pumpAndSettle(); + expect(find.text('Plain Text'), findsWidgets); + expect(find.text('Pair Symbols'), findsWidgets); + expect(find.text('Editor Command'), findsWidgets); + expect(find.text('普通文本'), findsNothing); + + await tester.tap(find.text('Editor Command').last); + await tester.pumpAndSettle(); + + // 命令下拉同样为英文 + await tester.tap(find.byType(DropdownButtonFormField).last); + await tester.pumpAndSettle(); + expect(find.text('Indent'), findsWidgets); + expect(find.text('Undo'), findsWidgets); + expect(find.text('向右缩进'), findsNothing); + }); + + testWidgets('VirtualKeyboardPageConfigSection does not overflow on narrow layouts', (tester) async { + tester.view.physicalSize = const Size(240, 480); + tester.view.devicePixelRatio = 1.0; + addTearDown(tester.view.reset); + + await tester.pumpWidget( + MaterialApp( + localizationsDelegates: AppLocalizations.localizationsDelegates, + supportedLocales: AppLocalizations.supportedLocales, + locale: const Locale('zh'), + home: Scaffold( + body: VirtualKeyboardPageConfigSection(count: 7, onCountChanged: (_) {}), + ), + ), + ); + await tester.pumpAndSettle(); + + // 行按钮数一行曾把定宽控件挤出右边界,此处断言不再发生 RenderFlex 溢出 + expect(tester.takeException(), isNull); + expect(find.text('行按钮数'), findsOneWidget); + expect(find.text('7'), findsOneWidget); + }); + testWidgets('SettingsView navigates to VirtualKeyboardConfigView with full visual config controls', (tester) async { final settingsProvider = SettingsProvider(); await settingsProvider.init(); @@ -1580,7 +2575,15 @@ void main() { expect(find.text('编辑区:(第 3 页)'), findsOneWidget); expect(find.text('页面配置'), findsOneWidget); - // Page 3 has 1 row with 1 key ("New"). Test adding keys up to count limit (Requirement 8) + // 新建页面时不再自动新增按键行,页面初始为空 + expect(settingsProvider.virtualKeyboardConfig.pages[2].keys, isEmpty); + expect(find.text('当前页面暂无按键行'), findsOneWidget); + + // 手动添加一行(Requirement 1: 空页面由用户自行添加行) + await tester.tap(find.text('添加新行').first); + await tester.pumpAndSettle(); + expect(settingsProvider.virtualKeyboardConfig.pages[2].keys.length, equals(1)); + // Add a key in row 1 final addKeyButton = find.byTooltip('添加按键').first; await tester.tap(addKeyButton); @@ -1591,8 +2594,8 @@ void main() { expect(find.text('添加按键'), findsOneWidget); // Enter label & value - await tester.enterText(find.widgetWithText(TextFormField, '显示文本 (Label)'), 'TestKey'); - await tester.enterText(find.widgetWithText(TextFormField, '输入文本内容 (Value)'), 'test_val'); + await tester.enterText(find.widgetWithText(TextFormField, '显示文本'), 'TestKey'); + await tester.enterText(find.widgetWithText(TextFormField, '输入文本内容'), 'test_val'); await tester.pumpAndSettle(); // Tap '确定' to save key @@ -1604,7 +2607,7 @@ void main() { expect(settingsProvider.virtualKeyboardConfig.pages[2].keys[0].any((k) => k.label == 'TestKey'), isTrue); // Expand the row ExpansionTile and verify TestKey widget is rendered - await tester.tap(find.text('2 个按键')); + await tester.tap(find.text('1 个按键')); await tester.pumpAndSettle(); expect(find.text('TestKey'), findsWidgets); @@ -1764,6 +2767,453 @@ void main() { } catch (_) {} }); }); + + // ============================================================ + // 溢出审计:在窄屏 + 大字体下渲染各主要界面,断言没有 RenderFlex 溢出 + // ============================================================ + group('Narrow layout overflow audit (320x640 @ 1.3x text)', () { + Future pumpNarrow(WidgetTester tester, Widget app, + {bool settle = true, double textScale = 1.3}) async { + tester.view.physicalSize = const Size(320, 640); + tester.view.devicePixelRatio = 1.0; + tester.platformDispatcher.textScaleFactorTestValue = textScale; + addTearDown(tester.view.reset); + addTearDown(tester.platformDispatcher.clearTextScaleFactorTestValue); + + await tester.pumpWidget(app); + if (settle) { + await tester.pumpAndSettle(); + } else { + await tester.pump(); + await tester.pump(const Duration(milliseconds: 100)); + } + expect(tester.takeException(), isNull, reason: '窄屏 + ${textScale}x 字体下不应发生布局溢出'); + } + + /// 列表类界面需要滚动到底,才能让懒加载的子项全部参与布局 + Future scrollAll(WidgetTester tester) async { + for (int i = 0; i < 12; i++) { + final scrollable = find.byType(Scrollable); + if (scrollable.evaluate().isEmpty) break; + await tester.drag(scrollable.first, const Offset(0, -280), warnIfMissed: false); + await tester.pumpAndSettle(); + } + expect(tester.takeException(), isNull, reason: '滚动构建列表项时不应发生布局溢出'); + } + + Widget localizedApp(Widget home, {Locale locale = const Locale('zh')}) => MaterialApp( + localizationsDelegates: AppLocalizations.localizationsDelegates, + supportedLocales: AppLocalizations.supportedLocales, + locale: locale, + home: home, + ); + + testWidgets('MainView with a long file name', (tester) async { + final tabProvider = TabProvider(); + await tabProvider.openFile( + p.normalize('/workspace/a_very_long_file_name_that_stresses_the_layout.dart'), + content: 'void main() {}', + ); + + await pumpNarrow( + tester, + MultiProvider( + providers: [ + ChangeNotifierProvider.value(value: SettingsProvider()), + ChangeNotifierProvider.value(value: ProjectProvider()), + ChangeNotifierProvider.value(value: tabProvider), + ], + child: localizedApp(const MainView()), + ), + settle: false, + ); + + // 卸载以取消光标闪烁定时器 + await tester.pumpWidget(const SizedBox()); + }); + + testWidgets('SettingsView (zh)', (tester) async { + await pumpNarrow( + tester, + ChangeNotifierProvider.value( + value: SettingsProvider(), + child: localizedApp(const SettingsView()), + ), + ); + await scrollAll(tester); + }); + + testWidgets('SettingsView (en)', (tester) async { + await pumpNarrow( + tester, + ChangeNotifierProvider.value( + value: SettingsProvider(), + child: localizedApp(const SettingsView(), locale: const Locale('en')), + ), + ); + await scrollAll(tester); + }); + + testWidgets('CodeEditorAppBar with a long path', (tester) async { + await pumpNarrow( + tester, + localizedApp( + Scaffold( + appBar: CodeEditorAppBar( + filePath: '/workspace/deeply/nested/directory/structure/with/a/very_long_file_name.dart', + onSettings: () {}, + ), + ), + ), + ); + }); + + testWidgets('VirtualKeyboardConfigView', (tester) async { + await pumpNarrow( + tester, + ChangeNotifierProvider.value( + value: SettingsProvider(), + child: localizedApp(const VirtualKeyboardConfigView(scope: KeyboardScope.editor)), + ), + ); + await scrollAll(tester); + }); + + testWidgets('KeyEditDialog (editor + terminal scope)', (tester) async { + await pumpNarrow( + tester, + localizedApp(const Scaffold(body: KeyEditDialog(scope: KeyboardScope.editor))), + ); + await pumpNarrow( + tester, + localizedApp(const Scaffold(body: KeyEditDialog(scope: KeyboardScope.terminal))), + ); + }); + + testWidgets('VirtualKeyboardPageDrawer', (tester) async { + await pumpNarrow( + tester, + localizedApp( + Scaffold( + body: VirtualKeyboardPageDrawer( + pages: const [ + KeyboardPageItem(count: 7, keys: []), + KeyboardPageItem(count: 12, keys: []), + ], + currentPageIndex: 0, + onAddNewPage: () {}, + onSelectPage: (_) {}, + onDeletePage: (_) {}, + onReorderPages: (_, _) {}, + ), + ), + ), + ); + }); + + testWidgets('CodeEditorDrawer with a long project path', (tester) async { + final projectProvider = ProjectProvider(); + projectProvider.setHistoryForTesting(const ProjectHistory( + rootPath: '/workspace/a_very_long_project_directory_name_for_layout_stress', + lastOpenedFilePath: null, + )); + + await pumpNarrow( + tester, + MultiProvider( + providers: [ + ChangeNotifierProvider.value(value: projectProvider), + ChangeNotifierProvider.value(value: TabProvider()), + ], + child: localizedApp( + const Scaffold( + drawer: CodeEditorDrawer(), + body: Center(child: Text('Home')), + ), + ), + ), + ); + + tester.state(find.byType(Scaffold)).openDrawer(); + await tester.pumpAndSettle(); + expect(tester.takeException(), isNull, reason: '抽屉展开后不应溢出'); + }); + + testWidgets('FileItemWidget with a very long file name', (tester) async { + final fileItem = FileItem( + path: '/workspace/this_is_an_extremely_long_file_name_that_would_never_fit_on_screen.dart', + name: 'this_is_an_extremely_long_file_name_that_would_never_fit_on_screen.dart', + isDirectory: false, + ); + + await pumpNarrow( + tester, + MultiProvider( + providers: [ + ChangeNotifierProvider.value(value: ProjectProvider()), + ChangeNotifierProvider.value(value: TabProvider()), + ], + child: localizedApp(Scaffold(body: FileItemWidget(fileItem: fileItem))), + ), + ); + }); + + testWidgets('TerminalSessionItemWidget with a long custom system name', (tester) async { + final session = TerminalSession( + id: 'session-1', + name: 'a_very_long_session_name_that_could_overflow_the_row', + distroId: 'a_very_long_custom_system_name_imported_by_the_user', + ); + + await pumpNarrow( + tester, + ChangeNotifierProvider.value( + value: TerminalProvider(), + child: localizedApp( + Scaffold( + body: TerminalSessionItemWidget(session: session, index: 0, isSelected: false), + ), + ), + ), + ); + }); + + testWidgets('VirtualKeyboardConfigView (en, 1.5x)', (tester) async { + await pumpNarrow( + tester, + ChangeNotifierProvider.value( + value: SettingsProvider(), + child: localizedApp(const VirtualKeyboardConfigView(scope: KeyboardScope.editor), locale: const Locale('en')), + ), + textScale: 1.5, + ); + await scrollAll(tester); + }); + + testWidgets('MainView overflow menu (en)', (tester) async { + final tabProvider = TabProvider(); + await tabProvider.openFile(p.normalize('/ws/a.dart'), content: 'void main() {}'); + + await pumpNarrow( + tester, + MultiProvider( + providers: [ + ChangeNotifierProvider.value(value: SettingsProvider()), + ChangeNotifierProvider.value(value: ProjectProvider()), + ChangeNotifierProvider.value(value: tabProvider), + ], + child: localizedApp(const MainView(), locale: const Locale('en')), + ), + settle: false, + ); + + // 展开右上角“更多”菜单(此前未被任何窄屏测试覆盖) + await tester.tap(find.byIcon(Icons.more_vert)); + await tester.pumpAndSettle(); + expect(tester.takeException(), isNull, reason: '更多菜单展开后不应溢出'); + + await tester.pumpWidget(const SizedBox()); + }); + + testWidgets('DistroSelectorDialog import popup (en)', (tester) async { + await pumpNarrow( + tester, + MultiProvider( + providers: [ + ChangeNotifierProvider.value(value: DistroProvider()), + ChangeNotifierProvider.value(value: TerminalProvider()), + ], + child: localizedApp( + const Scaffold(body: DistroSelectorDialog()), + locale: const Locale('en'), + ), + ), + ); + + // 展开“导入系统”弹出菜单 + await tester.tap(find.byIcon(Icons.add_circle_outline)); + await tester.pumpAndSettle(); + expect(tester.takeException(), isNull, reason: '导入菜单展开后不应溢出'); + }); + + testWidgets('CodeEditorTabBar with many modified tabs', (tester) async { + final tabProvider = TabProvider(); + for (int i = 0; i < 12; i++) { + await tabProvider.openFile(p.normalize('/ws/some_long_file_name_$i.dart'), content: 'x'); + tabProvider.updateActiveTabContent('modified_$i', isModified: true); + } + + await pumpNarrow( + tester, + MultiProvider( + providers: [ + ChangeNotifierProvider.value(value: ProjectProvider()), + ChangeNotifierProvider.value(value: tabProvider), + ], + child: localizedApp(const Scaffold(body: CodeEditorTabBar())), + ), + ); + }); + + testWidgets('CodeEditorDrawer header at 2x text', (tester) async { + final projectProvider = ProjectProvider(); + projectProvider.setHistoryForTesting(const ProjectHistory( + rootPath: '/workspace/demo_app', + lastOpenedFilePath: null, + )); + + await pumpNarrow( + tester, + MultiProvider( + providers: [ + ChangeNotifierProvider.value(value: projectProvider), + ChangeNotifierProvider.value(value: TabProvider()), + ], + child: localizedApp( + const Scaffold( + drawer: CodeEditorDrawer(), + body: Center(child: Text('Home')), + ), + ), + ), + textScale: 2.0, + ); + + tester.state(find.byType(Scaffold)).openDrawer(); + await tester.pumpAndSettle(); + expect(tester.takeException(), isNull, reason: '抽屉展开后不应溢出'); + }); + + testWidgets('VirtualKeyboardConfigView (terminal, en, 1.5x)', (tester) async { + await pumpNarrow( + tester, + ChangeNotifierProvider.value( + value: SettingsProvider(), + child: localizedApp( + const VirtualKeyboardConfigView(scope: KeyboardScope.terminal), + locale: const Locale('en'), + ), + ), + textScale: 1.5, + ); + await scrollAll(tester); + }); + + testWidgets('KeyEditDialog (terminal) with special key dropdown and modifier controls', (tester) async { + await pumpNarrow( + tester, + localizedApp( + const Scaffold(body: KeyEditDialog(scope: KeyboardScope.terminal)), + locale: const Locale('en'), + ), + ); + + // 切到“特殊键”动作:下拉 + 下方三个修饰键控件 + await tester.tap(find.byType(DropdownButtonFormField).first); + await tester.pumpAndSettle(); + await tester.tap(find.text('Special Key').last); + await tester.pumpAndSettle(); + expect(tester.takeException(), isNull, reason: '特殊键表单不应溢出'); + expect(find.widgetWithText(FilterChip, 'Ctrl Key'), findsOneWidget); + expect(find.widgetWithText(FilterChip, 'Alt Key'), findsOneWidget); + expect(find.widgetWithText(FilterChip, 'Shift Key'), findsOneWidget); + + // 展开分组键下拉(分组标题 + 字母键) + await tester.tap(find.byType(DropdownButtonFormField).last); + await tester.pumpAndSettle(); + expect(tester.takeException(), isNull, reason: '特殊键下拉不应溢出'); + await tester.tapAt(const Offset(5, 5)); + await tester.pumpAndSettle(); + + // 切回“指令快捷键”:出现自动回车开关 + await tester.tap(find.byType(DropdownButtonFormField).first); + await tester.pumpAndSettle(); + await tester.tap(find.text('Command Shortcut').last); + await tester.pumpAndSettle(); + expect(find.text('Send Enter after'), findsOneWidget); + expect(tester.takeException(), isNull, reason: '指令快捷键表单不应溢出'); + }); + + testWidgets('ProjectHistoryWidget with a long path', (tester) async { + final projectProvider = ProjectProvider(); + projectProvider.setHistoryForTesting(const ProjectHistory( + rootPath: '/workspace/a_very_long_project_directory_name_for_layout_stress', + lastOpenedFilePath: null, + )); + + await pumpNarrow( + tester, + MultiProvider( + providers: [ + ChangeNotifierProvider.value(value: projectProvider), + ChangeNotifierProvider.value(value: TabProvider()), + ], + child: localizedApp(const Scaffold(body: ProjectHistoryWidget())), + ), + ); + await scrollAll(tester); + }); + }); + + // ============================================================ + // 字体选择弹窗的 l10n:字体显示名不应硬编码在 models 里 + // ============================================================ + group('Font selector l10n', () { + test('every font id has a localized display name', () { + final zh = AppLocalizationsZh(); + final en = AppLocalizationsEn(); + final allFonts = { + ...AppFonts.uiFonts, + ...AppFonts.editorFonts, + ...AppFonts.terminalFonts, + }; + + for (final font in allFonts) { + // 未在 ARB 的 select 中登记时会回退成原始 id,这里据此兜底校验 + expect(zh.fontName(font.id), isNot(font.id), reason: 'zh 缺少字体名称: ${font.id}'); + expect(en.fontName(font.id), isNot(font.id), reason: 'en 缺少字体名称: ${font.id}'); + } + }); + + testWidgets('font selector sheet follows the locale', (tester) async { + await tester.pumpWidget( + ChangeNotifierProvider.value( + value: SettingsProvider(), + child: const MaterialApp( + localizationsDelegates: AppLocalizations.localizationsDelegates, + supportedLocales: AppLocalizations.supportedLocales, + locale: Locale('en'), + home: SettingsView(), + ), + ), + ); + await tester.pumpAndSettle(); + + // 界面字体选择弹窗 + await tester.scrollUntilVisible(find.text('Interface Font'), 200); + await tester.tap(find.text('Interface Font')); + await tester.pumpAndSettle(); + + expect(find.text('System Default'), findsWidgets); + expect(find.text('Sans-Serif'), findsWidgets); + expect(find.text('Serif (Songti)'), findsWidgets); + expect(find.text('JetBrains Mono'), findsWidgets); + // 不再出现硬编码中文 + expect(find.textContaining('系统'), findsNothing); + expect(find.textContaining('推荐'), findsNothing); + expect(find.textContaining('宋体'), findsNothing); + + // 关闭弹窗后打开代码字体选择弹窗 + await tester.tapAt(const Offset(10, 10)); + await tester.pumpAndSettle(); + await tester.scrollUntilVisible(find.text('Code Font'), 200); + await tester.tap(find.text('Code Font')); + await tester.pumpAndSettle(); + + expect(find.text('System Monospace'), findsWidgets); + expect(find.text('JetBrains Mono (Recommended)'), findsWidgets); + }); + }); }

4x#AAMRT}mC0 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 aamQ!Tazs~2sAnTXlOCG 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%0D8HZ`eE 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%0A6ky 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