外接条码扫描器输出能否接入Django项目？求相关技术文章

Absolutely feasible! Integrating an external barcode scanner with a Django project is totally doable, and most scanners use simple, easy-to-work-with mechanisms. Let me walk you through the most common approaches and how to implement them:

Most consumer-grade barcode scanners act as a "keyboard wedge"—they mimic keyboard input, typing out the barcode value and automatically sending an Enter key press once scanning is done. This makes integration super straightforward with Django's web interface.

Frontend Setup #

Create a hidden (or visible) input field that captures the scanned data, then use JavaScript to send it to your Django backend when the Enter key is triggered:

<!-- In your template -->
<input type="text" id="barcode-input" style="position: absolute; left: -9999px;" autofocus>

<script>
// Listen for Enter key to trigger submission
document.getElementById('barcode-input').addEventListener('keydown', function(e) {
  if (e.key === 'Enter') {
    const barcode = this.value.trim();
    if (!barcode) return;

    // Send data to Django API
    fetch('/api/process-barcode/', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'X-CSRFToken': getCsrfToken()
      },
      body: JSON.stringify({ barcode: barcode })
    })
    .then(response => response.json())
    .then(data => {
      // Handle success (e.g., show product details, update UI)
      console.log('Scanned successfully:', data);
      this.value = ''; // Reset input for next scan
    })
    .catch(error => {
      console.error('Error processing barcode:', error);
      // Show error message to user
    });
  }
});

// Helper function to get Django's CSRF token from cookies
function getCsrfToken() {
  let token = null;
  const cookies = document.cookie.split(';');
  for (const cookie of cookies) {
    const [name, value] = cookie.trim().split('=');
    if (name === 'csrftoken') {
      token = decodeURIComponent(value);
      break;
    }
  }
  return token;
}
</script>

Backend Django View #

Create an API view to process the scanned barcode and handle your business logic (e.g., look up a product, log the scan):

# In your views.py
import json
from django.http import JsonResponse
from django.views.decorators.http import require_POST
from django.views.decorators.csrf import csrf_exempt # Or use CSRF tokens as above
from .models import Product # Replace with your model

@require_POST
@csrf_exempt
def process_barcode(request):
    try:
        data = json.loads(request.body)
        barcode = data.get('barcode')
        
        if not barcode:
            return JsonResponse({'status': 'error', 'message': 'Empty barcode'})
        
        # Example: Look up a product by barcode
        product = Product.objects.get(barcode=barcode)
        return JsonResponse({
            'status': 'success',
            'product_name': product.name,
            'product_price': str(product.price)
        })
    
    except Product.DoesNotExist:
        return JsonResponse({'status': 'error', 'message': 'Product not found'})
    except json.JSONDecodeError:
        return JsonResponse({'status': 'error', 'message': 'Invalid request data'})

Add the Route #

Don't forget to map the view in your urls.py:

# In urls.py
from django.urls import path
from . import views

urlpatterns = [
    # ... other routes
    path('api/process-barcode/', views.process_barcode, name='process_barcode'),
]

If your scanner supports direct HID (Human Interface Device) communication, you can use Python libraries like pyusb to read data directly from the device. This is useful if you're running Django as a desktop application or if the scanner is physically connected to your Django server.

Note: This approach is less common for web-based Django projects since most users won't have the scanner connected to the server. But for use cases like in-house inventory systems, it's viable.

These work exactly like keyboard wedge scanners once paired with the device—they still simulate keyboard input. The integration logic is identical to the first method; you just need to ensure the scanner is paired and the input field has focus when scanning.

• CSRF Protection: Always handle Django's CSRF token (as shown in the frontend code) to avoid blocked POST requests.
• Input Focus: Ensure the barcode input field is focused when scanning—you can add autofocus to the input or use a button to trigger focus.
• Validation: Validate the barcode format and data in both frontend and backend to prevent invalid entries.
• Testing: Manually type a barcode followed by Enter to simulate scanner behavior during development.

内容的提问来源于stack exchange，提问作者InjectorX